Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

feat(projects): create projects with their properties in one request (#7183)

teo91cdc08dab94
diff --git a/.github/workspace-dep-closures.json b/.github/workspace-dep-closures.json
index 8775709d84..8c0b413d84 100644
--- a/.github/workspace-dep-closures.json
+++ b/.github/workspace-dep-closures.json
@@ -6143,6 +6143,7 @@
"crates/graphql_email",
"crates/graphql_initiative",
"crates/graphql_permission",
+ "crates/graphql_properties",
"crates/graphql_soup",
"crates/graphql_soup_filter_input",
"crates/harness_id",
diff --git a/Cargo.lock b/Cargo.lock
index 606bb7d630..d6ea28e19c 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -8169,6 +8169,7 @@ dependencies = [
"futures",
"graphql_common",
"graphql_permission",
+ "graphql_properties",
"graphql_soup",
"initiative",
"macro_user_id",
diff --git a/apps/web/src/features/projects/context/projects-context.tsx b/apps/web/src/features/projects/context/projects-context.tsx
index 5e7f1d66f3..dac67a4eec 100644
--- a/apps/web/src/features/projects/context/projects-context.tsx
+++ b/apps/web/src/features/projects/context/projects-context.tsx
@@ -38,6 +38,12 @@ export type ProjectPropertyDraft = {
value: PropertyApiValues;
};
+export type ProjectCreationInput = {
+ name: string;
+ shareWithTeam: boolean;
+ properties: readonly ProjectPropertyDraft[];
+};
+
/** Capabilities supplied by the production entry point or by a test. */
export type ProjectsContext = {
userId: Accessor<string | undefined>;
@@ -62,10 +68,8 @@ export type ProjectsContext = {
...args: Parameters<typeof createTaskWithProperties>
): ReturnType<typeof createTaskWithProperties>;
pending: Accessor<boolean>;
- create(input: {
- name: string;
- shareWithTeam: boolean;
- }): Promise<ProjectDetail>;
+ /** One request creates the project with its property values. */
+ create(input: ProjectCreationInput): Promise<ProjectDetail>;
rename(id: string, name: string): Promise<void>;
setMembers(id: string, memberIds: string[]): Promise<void>;
assignTasks(
diff --git a/apps/web/src/features/projects/primitives/create-project.test.ts b/apps/web/src/features/projects/primitives/create-project.test.ts
index 9d077f4727..f9d85b59c4 100644
--- a/apps/web/src/features/projects/primitives/create-project.test.ts
+++ b/apps/web/src/features/projects/primitives/create-project.test.ts
@@ -1,8 +1,9 @@
+import type { Property } from '@property/types';
import { createRoot } from 'solid-js';
import { describe, expect, it, vi } from 'vitest';
import type { ProjectsContext } from '../context/projects-context';
import type { ProjectDetail } from '../core/project';
-import { createProjectComposer } from './create-project';
+import { createProjectComposer, failedProjectDraft } from './create-project';
const project: ProjectDetail = {
id: 'project-id',
@@ -30,70 +31,69 @@ function commands() {
} satisfies ReturnType<ProjectsContext['createCommands']>;
}
+const dueDate = {
+ propertyId: 'due',
+ propertyDefinitionId: 'due',
+ displayName: 'Due date',
+ valueType: 'DATE',
+ value: null,
+ isMultiSelect: false,
+ isMetadata: false,
+ isSystemProperty: true,
+ owner: { scope: 'system' },
+ createdAt: '',
+ updatedAt: '',
+} satisfies Property;
+const dueValue = {
+ valueType: 'DATE' as const,
+ value: new Date('2026-10-01T00:00:00Z'),
+};
+
describe('project creation', () => {
- it('defaults team sharing and leaves unset properties to canonical server defaults', async () => {
- await new Promise<void>((resolve, reject) =>
- createRoot((dispose) => {
- const service = commands();
- const complete = vi.fn();
- const composer = createProjectComposer(service, complete);
- composer.setName(' Release ');
- composer
- .submit()
- .then(() => {
- expect(service.create).toHaveBeenCalledWith({
- name: 'Release',
- shareWithTeam: true,
- });
- expect(service.saveProperty).not.toHaveBeenCalled();
- expect(complete).toHaveBeenCalledWith('project-id');
- dispose();
- resolve();
- })
- .catch(reject);
- })
- );
- });
+ it('submits once with its values, defaulting team sharing and leaving unset properties to the server', () =>
+ createRoot(async (dispose) => {
+ const service = commands();
+ const composer = createProjectComposer(service);
+ composer.setName(' Release ');
+ composer.saveDraft(dueDate, dueValue);
+ const submission = composer.submit();
+ expect(composer.pending()).toBe(true);
+ expect(composer.submit()).toBeUndefined();
+ expect(service.create).toHaveBeenCalledOnce();
+ expect(service.create).toHaveBeenCalledWith({
+ name: 'Release',
+ shareWithTeam: true,
+ properties: [{ property: dueDate, value: dueValue }],
+ });
+ expect(service.saveProperty).not.toHaveBeenCalled();
+ expect(await submission?.result).toBe(project);
+ dispose();
+ }));
+
+ it('does not submit an unnamed project', () =>
+ createRoot((dispose) => {
+ const service = commands();
+ const composer = createProjectComposer(service);
+ composer.setName(' ');
+ expect(composer.submit()).toBeUndefined();
+ expect(composer.pending()).toBe(false);
+ expect(service.create).not.toHaveBeenCalled();
+ dispose();
+ }));
- it('retries a failed property write on the existing project without duplicating creation', async () => {
- await new Promise<void>((resolve, reject) =>
- createRoot((dispose) => {
- const service = commands();
- service.saveProperty.mockRejectedValueOnce(new Error('offline'));
- const complete = vi.fn();
- const composer = createProjectComposer(service, complete);
- composer.setName('Release');
- composer.saveDraft(
- {
- propertyId: 'due',
- propertyDefinitionId: 'due',
- displayName: 'Due date',
- valueType: 'DATE',
- value: null,
- isMultiSelect: false,
- isMetadata: false,
- isSystemProperty: true,
- owner: { scope: 'system' },
- createdAt: '',
- updatedAt: '',
- },
- { valueType: 'DATE', value: new Date('2026-10-01T00:00:00Z') }
- );
- composer
- .submit()
- .then(async () => {
- expect(composer.createdId()).toBe('project-id');
- expect(composer.error()).toContain('Retry');
- expect(complete).not.toHaveBeenCalled();
- await composer.submit();
- expect(service.create).toHaveBeenCalledTimes(1);
- expect(service.saveProperty).toHaveBeenCalledTimes(2);
- expect(complete).toHaveBeenCalledWith('project-id');
- dispose();
- resolve();
- })
- .catch(reject);
- })
- );
+ it("reopens a failure with its draft and the server's reason", () => {
+ const draft = {
+ name: 'Release',
+ shareWithTeam: true,
+ properties: [{ property: dueDate, value: dueValue }],
+ };
+ expect(failedProjectDraft(draft, new Error('Name is too long'))).toEqual({
+ ...draft,
+ error: 'Name is too long',
+ });
+ expect(failedProjectDraft(draft, 'offline')).toEqual({
+ ...draft,
+ error: 'Could not create project.',
+ });
});
});
diff --git a/apps/web/src/features/projects/primitives/create-project.ts b/apps/web/src/features/projects/primitives/create-project.ts
index 68c6744f15..007bf8d539 100644
--- a/apps/web/src/features/projects/primitives/create-project.ts
+++ b/apps/web/src/features/projects/primitives/create-project.ts
@@ -1,22 +1,36 @@
import type { Property, PropertyApiValues } from '@property/types';
import { createSignal } from 'solid-js';
import type {
+ ProjectCreationInput,
ProjectPropertyDraft,
ProjectsContext,
} from '../context/projects-context';
+import type { ProjectDetail } from '../core/project';
-export type ProjectComposerDraft = {
- name: string;
- shareWithTeam: boolean;
- properties: ProjectPropertyDraft[];
- createdId?: string;
- error?: string;
+export type ProjectComposerDraft = ProjectCreationInput & { error?: string };
+
+/** What the composer hands its host: it closes, and the host owns the outcome. */
+export type ProjectComposerSubmission = {
+ draft: ProjectComposerDraft;
+ result: Promise<ProjectDetail>;
};
-/** Retain the created identity if a property save fails so retry cannot duplicate it. */
+/** Reopens a failed submission with its draft and the server's reason. */
+export function failedProjectDraft(
+ draft: ProjectComposerDraft,
+ error: unknown
+): ProjectComposerDraft {
+ return {
+ ...draft,
+ error:
+ error instanceof Error && error.message
+ ? error.message
+ : 'Could not create project.',
+ };
+}
+
export function createProjectComposer(
commands: ReturnType<ProjectsContext['createCommands']>,
- onCreated: (id: string) => void,
initial?: ProjectComposerDraft
) {
const [name, setName] = createSignal(initial?.name ?? '');
@@ -31,9 +45,15 @@ export function createProjectComposer(
])
)
);
- const [createdId, setCreatedId] = createSignal(initial?.createdId);
+ // A submitted composer is finished; its host closes it.
const [pending, setPending] = createSignal(false);
const [error, setError] = createSignal(initial?.error);
+ const snapshot = (): ProjectComposerDraft => ({
+ name: name(),
+ shareWithTeam: shareWithTeam(),
+ properties: [...drafts().values()],
+ error: error(),
+ });
return {
name,
setName,
@@ -42,16 +62,9 @@ export function createProjectComposer(
drafts,
pending,
error,
- createdId,
- snapshot: (): ProjectComposerDraft => ({
- name: name(),
- shareWithTeam: shareWithTeam(),
- properties: [...drafts().values()],
- createdId: createdId(),
- error: error(),
- }),
+ snapshot,
clear() {
- if (pending() || createdId()) return;
+ if (pending()) return;
setName('');
setShareWithTeam(true);
setDrafts(new Map());
@@ -64,36 +77,15 @@ export function createProjectComposer(
value,
})
),
- async submit(): Promise<'created' | 'failed' | undefined> {
+ /** Starts creation once, or returns nothing when there is nothing to submit. */
+ submit(): ProjectComposerSubmission | undefined {
if (pending() || !name().trim()) return;
setPending(true);
- setError(undefined);
- try {
- const id =
- createdId() ??
- (
- await commands.create({
- name: name().trim(),
- shareWithTeam: shareWithTeam(),
- })
- ).id;
- setCreatedId(id);
- for (const { property, value } of drafts().values())
- await commands.saveProperty(id, property, value);
- onCreated(id);
- return 'created';
- } catch (error) {
- setError(
- createdId()
- ? 'Your project was created, but some properties could not be saved. Retry to finish saving it.'
- : error instanceof Error
- ? error.message
- : 'Could not create project.'
- );
- return 'failed';
- } finally {
- setPending(false);
- }
+ const { error: _stale, ...draft } = snapshot();
+ return {
+ draft,
+ result: commands.create({ ...draft, name: draft.name.trim() }),
+ };
},
};
}
diff --git a/apps/web/src/features/projects/project-view.test.tsx b/apps/web/src/features/projects/project-view.test.tsx
index f80cba5e15..f3517345b3 100644
--- a/apps/web/src/features/projects/project-view.test.tsx
+++ b/apps/web/src/features/projects/project-view.test.tsx
@@ -1,14 +1,34 @@
import { cleanup, fireEvent, render } from '@solidjs/testing-library';
import { type Accessor, createSignal, type ParentProps } from 'solid-js';
import { afterEach, expect, it, vi } from 'vitest';
+import type { ProjectDetail } from './core/project';
+import {
+ failedProjectDraft,
+ type ProjectComposerSubmission,
+} from './primitives/create-project';
const fixtures = vi.hoisted(() => ({
popover: false,
+ touch: false,
close: vi.fn(),
- open: vi.fn(),
- replace: vi.fn(),
navigate: vi.fn(),
routed: (() => true) as Accessor<boolean>,
+ submission: undefined as ProjectComposerSubmission | undefined,
+ manager: {
+ openWithSplit: vi.fn(() => ({ status: 'unavailable' })),
+ createPopoverSplit: vi.fn(),
+ },
+ toast: vi.fn(),
+}));
+// The real useSplitLayout runs, so its touch-device rule is exercised.
+vi.mock('@app/signal/splitLayout', () => ({
+ globalSplitManager: () => fixtures.manager,
+}));
+vi.mock('@core/mobile/isTouchDevice', () => ({
+ isTouchDevice: () => fixtures.touch,
+}));
+vi.mock('@core/component/Toast/Toast', () => ({
+ toast: { success: fixtures.toast },
}));
vi.mock('@app/features/tasks-view/route', () => ({
projectDetailRoute: {},
@@ -18,12 +38,6 @@ vi.mock('@app/lib/split-router', () => ({
useNavigate: () => fixtures.navigate,
useSplitHistory: () => () => (fixtures.routed() ? { index: 0 } : undefined),
}));
-vi.mock('@components/app/split-layout/layout', () => ({
- useSplitLayout: () => ({
- openWithSplit: fixtures.open,
- replaceSplit: fixtures.replace,
- }),
-}));
vi.mock('@components/app/split-layout/layoutUtils', () => ({
useSplitPanelOrThrow: () => ({
handle: {
@@ -43,12 +57,10 @@ vi.mock('./projects', () => ({
Projects: (props: ParentProps) => props.children,
}));
vi.mock('./views/create-project', () => ({
- CreateProject: (props: { onCreated(id: string): void }) => (
- <button
- onClick={() => props.onCreated('01992d2f-8444-7000-8000-000000000001')}
- >
- Create
- </button>
+ CreateProject: (props: {
+ onSubmit(submission: ProjectComposerSubmission): void;
+ }) => (
+ <button onClick={() => props.onSubmit(fixtures.submission!)}>Create</button>
),
}));
@@ -57,30 +69,95 @@ import { CreateProjectView, ProjectView } from './project-view';
afterEach(() => {
cleanup();
vi.clearAllMocks();
+ fixtures.touch = false;
});
+const projectId = '01992d2f-8444-7000-8000-000000000001';
+const draft = { name: 'Launch', shareWithTeam: true, properties: [] };
+const project = { id: projectId } as ProjectDetail;
+function submit(popover: boolean) {
+ fixtures.popover = popover;
+ const result = Promise.withResolvers<ProjectDetail>();
+ fixtures.submission = { draft, result: result.promise };
+ const view = render(() => <CreateProjectView />);
+ fireEvent.click(view.getByRole('button'));
+ return { ...view, resolve: result.resolve, reject: result.reject };
+}
+
+const projectContent = {
+ type: 'component',
+ id: `initiative-view~${projectId}~overview`,
+};
+async function toastActions() {
+ await vi.waitFor(() => expect(fixtures.toast).toHaveBeenCalledOnce());
+ const [message, { actions }] = fixtures.toast.mock.calls[0];
+ expect(message).toBe('Project created');
+ return actions as { label: string; onClick(): void }[];
+}
+
it.each([true, false])(
- 'opens the created project while respecting popover=%s',
- (popover) => {
- fixtures.popover = popover;
- const view = render(() => <CreateProjectView />);
- fireEvent.click(view.getByRole('button'));
- const content = {
- type: 'component',
- id: 'initiative-view~01992d2f-8444-7000-8000-000000000001~overview',
- };
+ 'closes on submit and offers the created project without navigating, popover=%s',
+ async (popover) => {
+ const { resolve, unmount } = submit(popover);
if (popover) {
expect(fixtures.close).toHaveBeenCalledOnce();
- expect(fixtures.open).toHaveBeenCalledWith(content, {
- preferNewSplit: true,
- });
- expect(fixtures.replace).not.toHaveBeenCalled();
+ expect(fixtures.manager.openWithSplit).not.toHaveBeenCalled();
} else {
- expect(fixtures.replace).toHaveBeenCalledWith({ content });
- expect(fixtures.open).not.toHaveBeenCalled();
+ // Back must not return to the submitted composer.
+ expect(fixtures.manager.openWithSplit).toHaveBeenCalledWith(
+ { type: 'component', id: 'tasks-projects' },
+ expect.objectContaining({ mergeHistory: true, preferNewSplit: false })
+ );
}
+ fixtures.manager.openWithSplit.mockClear();
+ // The server answers after the composer, and its panel, are gone.
+ unmount();
+ resolve(project);
+ const [open, openInNewSplit] = await toastActions();
+ expect(fixtures.manager.openWithSplit).not.toHaveBeenCalled();
+ open.onClick();
+ expect(fixtures.manager.openWithSplit).toHaveBeenLastCalledWith(
+ projectContent,
+ expect.objectContaining({ referredFrom: null, preferNewSplit: false })
+ );
+ openInNewSplit.onClick();
+ expect(fixtures.manager.openWithSplit).toHaveBeenLastCalledWith(
+ projectContent,
+ expect.objectContaining({ referredFrom: null, preferNewSplit: true })
+ );
}
);
+it('never opens a new split from the toast on a touch device', async () => {
+ fixtures.touch = true;
+ const { resolve, unmount } = submit(true);
+ unmount();
+ resolve(project);
+ const [, openInNewSplit] = await toastActions();
+ openInNewSplit.onClick();
+ expect(fixtures.manager.openWithSplit).toHaveBeenLastCalledWith(
+ projectContent,
+ expect.objectContaining({ preferNewSplit: false })
+ );
+});
+
+it('reopens the composer with the draft and the reason after a failure', async () => {
+ const { reject, unmount } = submit(true);
+ unmount();
+ const error = new Error('offline');
+ reject(error);
+ await vi.waitFor(() =>
+ expect(fixtures.manager.createPopoverSplit).toHaveBeenCalledOnce()
+ );
+ expect(fixtures.manager.createPopoverSplit).toHaveBeenCalledWith({
+ content: {
+ type: 'component',
+ id: 'project-compose',
+ params: { initialDraft: failedProjectDraft(draft, error) },
+ },
+ });
+ expect(fixtures.toast).not.toHaveBeenCalled();
+});
+
it('redirects a project link once the router tracks its newly opened split', () => {
const [routed, setRouted] = createSignal(false);
fixtures.routed = routed;
diff --git a/apps/web/src/features/projects/project-view.tsx b/apps/web/src/features/projects/project-view.tsx
index 9a2dc51e9f..035aab2cfd 100644
--- a/apps/web/src/features/projects/project-view.tsx
+++ b/apps/web/src/features/projects/project-view.tsx
@@ -6,9 +6,17 @@ import { useNavigate, useSplitHistory } from '@app/lib/split-router';
import { useSplitLayout } from '@components/app/split-layout/layout';
import { useSplitPanelOrThrow } from '@components/app/split-layout/layoutUtils';
import { SplitPanel } from '@components/app/split-panel';
-import { createEffect, onCleanup, onMount } from 'solid-js';
+import { toast } from '@core/component/Toast/Toast';
+import ArrowSquareOutIcon from '@phosphor/arrow-square-out.svg';
+import SplitIcon from '@phosphor/square-half.svg';
+import { createEffect, onMount } from 'solid-js';
+import type { ProjectDetail } from './core/project';
import { type ProjectRoute, projectRouteId } from './core/route';
-import type { ProjectComposerDraft } from './primitives/create-project';
+import {
+ failedProjectDraft,
+ type ProjectComposerDraft,
+ type ProjectComposerSubmission,
+} from './primitives/create-project';
import { Projects } from './projects';
import { CreateProject } from './views/create-project';
@@ -57,32 +65,74 @@ export function ProjectView(props: { route: ProjectRoute }) {
return null;
}
+/**
+ * The composer is gone before the server answers, so the outcome touches
+ * none of its panel state. Like task creation, success offers to open the
+ * project through the layout's guarded open rather than navigating away
+ * from wherever the user has gone since.
+ */
+async function settleProjectSubmission(
+ { draft, result }: ProjectComposerSubmission,
+ layout: Pick<
+ ReturnType<typeof useSplitLayout>,
+ 'openWithSplit' | 'popoverSplit'
+ >
+) {
+ let project: ProjectDetail;
+ try {
+ project = await result;
+ } catch (error) {
+ layout.popoverSplit({
+ type: 'component',
+ id: 'project-compose',
+ params: { initialDraft: failedProjectDraft(draft, error) },
+ });
+ return;
+ }
+ const open = (preferNewSplit: boolean) =>
+ layout.openWithSplit(
+ {
+ type: 'component',
+ id: projectRouteId({ id: project.id, section: 'overview' }),
+ },
+ { referredFrom: null, preferNewSplit }
+ );
+ toast.success('Project created', {
+ actions: [
+ { label: 'Open', icon: ArrowSquareOutIcon, onClick: () => open(false) },
+ {
+ label: 'Open (New Split)',
+ icon: SplitIcon,
+ onClick: () => open(true),
+ },
+ ],
+ });
+}
+
export function CreateProjectView(props: {
initialDraft?: ProjectComposerDraft;
}) {
const layout = useSplitLayout();
const panel = useSplitPanelOrThrow();
- let disposed = false;
- onCleanup(() => {
- disposed = true;
- });
onMount(() => panel.handle.setDisplayName('New project'));
+ // A full composer returns its split to Projects; a submitted one also
+ // leaves history, so Back does not reopen an empty composer.
+ const close = (mergeHistory?: boolean) => {
+ if (panel.handle.isPopover()) {
+ panel.handle.close();
+ return;
+ }
+ layout.replaceSplit({
+ content: { type: 'component', id: 'tasks-projects' },
+ mergeHistory,
+ });
+ };
return (
<Projects>
<SplitPanel.Root class="bg-transparent">
<SplitPanel.Body>
<CreateProject
initialDraft={props.initialDraft}
- onFailure={(initialDraft) => {
- // A native popover can close while a request is in flight.
- // Restore its failed draft just like the task composer does.
- if (disposed)
- layout.popoverSplit({
- type: 'component',
- id: 'project-compose',
- params: { initialDraft },
- });
- }}
onContinueInSplit={
panel.handle.isPopover()
? (initialDraft) => {
@@ -98,26 +148,10 @@ export function CreateProjectView(props: {
}
: undefined
}
- onClose={() => {
- if (panel.handle.isPopover()) {
- panel.handle.close();
- return;
- }
- layout.replaceSplit({
- content: { type: 'component', id: 'tasks-projects' },
- });
- }}
- onCreated={(id) => {
- const content = {
- type: 'component' as const,
- id: projectRouteId({ id, section: 'overview' }),
- };
- if (panel.handle.isPopover()) {
- panel.handle.close();
- layout.openWithSplit(content, { preferNewSplit: true });
- return;
- }
- layout.replaceSplit({ content });
+ onClose={() => close()}
+ onSubmit={(submission) => {
+ close(true);
+ void settleProjectSubmission(submission, layout);
}}
/>
</SplitPanel.Body>
diff --git a/apps/web/src/features/projects/queries/create-project.test.ts b/apps/web/src/features/projects/queries/create-project.test.ts
new file mode 100644
index 0000000000..599b7be11f
--- /dev/null
+++ b/apps/web/src/features/projects/queries/create-project.test.ts
@@ -0,0 +1,154 @@
+import type { Property } from '@property/types';
+import { QueryClient } from '@tanstack/solid-query';
+import { err, ok } from 'neverthrow';
+import { createRoot } from 'solid-js';
+import { afterEach, expect, it, onTestFinished, vi } from 'vitest';
+import { createInitiativeInput, createProjectMutation } from './create-project';
+import { projectKeys } from './keys';
+
+const mock = vi.hoisted(() => ({ refetch: vi.fn() }));
+vi.mock('@queries/soup/cache', () => ({ refetchSoupEntity: mock.refetch }));
+afterEach(() => vi.clearAllMocks());
+
+const status = {
+ propertyId: 'status',
+ propertyDefinitionId: 'status',
+ displayName: 'Status',
+ valueType: 'SELECT_STRING',
+ value: null,
+ isMultiSelect: false,
+ owner: { scope: 'system' },
+ createdAt: '',
+ updatedAt: '',
+} satisfies Property;
+const assignees = {
+ ...status,
+ propertyId: 'assignees',
+ propertyDefinitionId: 'assignees',
+ displayName: 'Assignees',
+ valueType: 'ENTITY',
+ isMultiSelect: true,
+} satisfies Property;
+const due = {
+ ...status,
+ propertyId: 'due',
+ propertyDefinitionId: 'due',
+ displayName: 'Due date',
+ valueType: 'DATE',
+} satisfies Property;
+
+const detail = {
+ id: 'project',
+ name: 'Launch',
+ descriptionDocumentId: 'description',
+ updatedAt: '2026-09-30T12:00:00Z',
+ userAccessLevel: 'owner' as const,
+ taskCount: 0,
+ completedTaskCount: 0,
+ properties: [],
+ ownerId: 'viewer',
+ memberIds: [],
+ taskIds: [],
+ createdAt: '2026-09-30T12:00:00Z',
+ sharePermission: {} as never,
+};
+
+it('sends drafted values with the create and leaves unset ones to the server', () => {
+ expect(
+ createInitiativeInput({
+ name: 'Launch',
+ shareWithTeam: false,
+ properties: [
+ {
+ property: status,
+ value: { valueType: 'SELECT_STRING', values: ['in-progress'] },
+ },
+ {
+ property: assignees,
+ value: {
+ valueType: 'ENTITY',
+ refs: [{ entity_type: 'USER', entity_id: 'macro|[email protected]' }],
+ },
+ },
+ { property: due, value: { valueType: 'DATE', value: null } },
+ ],
+ })
+ ).toEqual({
+ name: 'Launch',
+ shareWithTeam: false,
+ propertyValues: [
+ {
+ propertyDefinitionId: 'status',
+ value: { selectOption: 'in-progress' },
+ },
+ {
+ propertyDefinitionId: 'assignees',
+ value: {
+ multiEntityReference: [
+ {
+ entityType: 'USER',
+ entityId: 'macro|[email protected]',
+ specificMessageId: null,
+ },
+ ],
+ },
+ },
+ ],
+ });
+});
+
+it('resolves as soon as the server answers, seeding the detail and refreshing lists in the background', async () => {
+ const cache = new QueryClient();
+ const create = vi.fn(async () => ok(detail));
+ // A list refresh that never settles must not hold the create.
+ mock.refetch.mockReturnValue(new Promise(() => {}));
+ const mutation = createRoot((dispose) => {
+ onTestFinished(dispose);
+ return createProjectMutation({ create }, cache, () => 'viewer');
+ });
+
+ const project = await mutation.mutateAsync({
+ name: 'Launch',
+ shareWithTeam: true,
+ properties: [],
+ });
+
+ expect(create).toHaveBeenCalledOnce();
+ expect(create).toHaveBeenCalledWith({
+ name: 'Launch',
+ shareWithTeam: true,
+ propertyValues: [],
+ });
+ expect(project).toMatchObject({ id: 'project', name: 'Launch' });
+ expect(mock.refetch).toHaveBeenCalledWith('project', 'initiative', {
+ ownTouch: true,
+ refreshGraphql: true,
+ });
+ // Opening the new project reads the seeded detail instead of the network.
+ expect(
+ cache.getQueryData(projectKeys.detail('viewer', 'project').queryKey)
+ ).toMatchObject({
+ project: { id: 'project', access: 'owner' },
+ properties: [],
+ });
+});
+
+it('rejects without refreshing when the server refuses the create', async () => {
+ const cache = new QueryClient();
+ const create = vi.fn(async () =>
+ err([{ code: 'BAD_REQUEST', message: 'option not found' }])
+ );
+ const mutation = createRoot((dispose) => {
+ onTestFinished(dispose);
+ return createProjectMutation({ create }, cache, () => 'viewer');
+ });
+
+ await expect(
+ mutation.mutateAsync({
+ name: 'Launch',
+ shareWithTeam: true,
+ properties: [],
+ })
+ ).rejects.toThrow();
+ expect(mock.refetch).not.toHaveBeenCalled();
+});
diff --git a/apps/web/src/features/projects/queries/create-project.ts b/apps/web/src/features/projects/queries/create-project.ts
new file mode 100644
index 0000000000..b9b35b6595
--- /dev/null
+++ b/apps/web/src/features/projects/queries/create-project.ts
@@ -0,0 +1,65 @@
+import { throwOnErr } from '@core/util/result';
+import { propertyValueToApi } from '@property/api/converters';
+import { toGraphqlSetPropertyValue } from '@queries/properties/graphql/entity';
+import { refetchSoupEntity } from '@queries/soup/cache';
+import type { CreateInitiativeInput } from '@service-storage/graphql/generated/graphql';
+import type { initiativeClient } from '@service-storage/initiative';
+import { type QueryClient, useMutation } from '@tanstack/solid-query';
+import type { Accessor } from 'solid-js';
+import type { ProjectCreationInput } from '../context/projects-context';
+import { seedProjectDetail } from './project-identity';
+import { toProjectDetail } from './project-model';
+
+/** The drafted values travel with the create, as a task's do. */
+export function createInitiativeInput(
+ input: ProjectCreationInput
+): CreateInitiativeInput {
+ return {
+ name: input.name,
+ shareWithTeam: input.shareWithTeam,
+ propertyValues: input.properties.flatMap(({ property, value }) => {
+ const graphqlValue = toGraphqlSetPropertyValue(
+ propertyValueToApi(value, property.isMultiSelect)
+ );
+ // An unset value is already the server's default.
+ return graphqlValue
+ ? [
+ {
+ propertyDefinitionId: property.propertyDefinitionId,
+ value: graphqlValue,
+ },
+ ]
+ : [];
+ }),
+ };
+}
+
+/**
+ * One request creates the project with its values. Like task creation, it
+ * resolves as soon as the server answers: the response seeds the project's
+ * detail, and the lists catch up in the background.
+ */
+export function createProjectMutation(
+ client: Pick<typeof initiativeClient, 'create'>,
+ cache: QueryClient,
+ userId: Accessor<string | undefined>
+) {
+ return useMutation(
+ () => ({
+ mutationFn: async (input: ProjectCreationInput) => {
+ const project = await throwOnErr(() =>
+ client.create(createInitiativeInput(input))
+ );
+ seedProjectDetail(cache, userId(), project);
+ return toProjectDetail(project);
+ },
+ onSuccess: (project) => {
+ void refetchSoupEntity(project.id, 'initiative', {
+ ownTouch: true,
+ refreshGraphql: true,
+ });
+ },
+ }),
+ () => cache
+ );
+}
diff --git a/apps/web/src/features/projects/queries/project-identity.ts b/apps/web/src/features/projects/queries/project-identity.ts
index a2518c0d74..2109fcbd5b 100644
--- a/apps/web/src/features/projects/queries/project-identity.ts
+++ b/apps/web/src/features/projects/queries/project-identity.ts
@@ -1,12 +1,34 @@
import { throwOnErr } from '@core/util/result';
import { queryClient } from '@queries/client';
-import { initiativeClient } from '@service-storage/initiative';
-import { useQuery } from '@tanstack/solid-query';
+import {
+ initiativeClient,
+ type mapInitiativeDetail,
+} from '@service-storage/initiative';
+import { type QueryClient, useQuery } from '@tanstack/solid-query';
import type { Accessor } from 'solid-js';
import { projectKeys } from './keys';
import { toProjectDetail } from './project-model';
import { projectProperties } from './project-properties';
+type InitiativeDetail = ReturnType<typeof mapInitiativeDetail>;
+
+const projectDetailData = (project: InitiativeDetail) => ({
+ project: toProjectDetail(project),
+ properties: projectProperties(project.properties),
+});
+
+/** Seeds the detail read from a create response, so opening it needs no request. */
+export function seedProjectDetail(
+ cache: QueryClient,
+ userId: string | undefined,
+ project: InitiativeDetail
+) {
+ cache.setQueryData(
+ projectKeys.detail(userId, project.id).queryKey,
+ projectDetailData(project)
+ );
+}
+
/** One authorized read backs the project view and its chips and previews. */
export function projectDetailQueryOptions(
client: Pick<typeof initiativeClient, 'get'>,
@@ -15,13 +37,8 @@ export function projectDetailQueryOptions(
) {
return {
queryKey: projectKeys.detail(userId, projectId).queryKey,
- queryFn: async ({ signal }: { signal: AbortSignal }) => {
- const project = await throwOnErr(() => client.get(projectId, signal));
- return {
- project: toProjectDetail(project),
- properties: projectProperties(project.properties),
- };
- },
+ queryFn: async ({ signal }: { signal: AbortSignal }) =>
+ projectDetailData(await throwOnErr(() => client.get(projectId, signal))),
staleTime: 30_000,
refetchInterval: 30_000,
refetchOnWindowFocus: true,
diff --git a/apps/web/src/features/projects/queries/project-sources.ts b/apps/web/src/features/projects/queries/project-sources.ts
index 26fdffe219..df19dc8b35 100644
--- a/apps/web/src/features/projects/queries/project-sources.ts
+++ b/apps/web/src/features/projects/queries/project-sources.ts
@@ -20,10 +20,10 @@ import type { Accessor } from 'solid-js';
import type { ProjectsContext } from '../context/projects-context';
import { assignProjectTasks } from '../core/assignment';
import type { ProjectDetail, TaskProjectReference } from '../core/project';
+import { createProjectMutation } from './create-project';
import { createProjectTaskMutation } from './create-project-task';
import { projectKeys } from './keys';
import { projectDetailQueryOptions } from './project-identity';
-import { toProjectDetail } from './project-model';
import { projectDefinitionProperties } from './project-properties';
import { createProjectSoupSource } from './project-soup';
@@ -200,14 +200,7 @@ export function createProjectSources(
]);
}
);
- const create = useMutation(
- () => ({
- mutationFn: async (input: { name: string; shareWithTeam: boolean }) =>
- toProjectDetail(await throwOnErr(() => client.create(input))),
- onSuccess: refresh,
- }),
- () => cache
- );
+ const create = createProjectMutation(client, cache, userId);
const update = useMutation(
() => ({
mutationFn: ({
diff --git a/apps/web/src/features/projects/views/create-project.test.tsx b/apps/web/src/features/projects/views/create-project.test.tsx
index 2a0355851d..ea06b67880 100644
--- a/apps/web/src/features/projects/views/create-project.test.tsx
+++ b/apps/web/src/features/projects/views/create-project.test.tsx
@@ -1,13 +1,7 @@
import { Dialog } from '@app/components/ui/components/Dialog';
import { focusPopoverInput } from '@components/app/split-layout/utils/focusPopoverInput';
import type { Property } from '@property/types';
-import {
- cleanup,
- fireEvent,
- render,
- screen,
- waitFor,
-} from '@solidjs/testing-library';
+import { cleanup, fireEvent, render, screen } from '@solidjs/testing-library';
import { type ComponentProps, type ParentProps, Show } from 'solid-js';
import { afterEach, beforeEach, expect, it, vi } from 'vitest';
import {
@@ -15,7 +9,10 @@ import {
ProjectsProvider,
} from '../context/projects-context';
import type { ProjectDetail } from '../core/project';
-import type { ProjectComposerDraft } from '../primitives/create-project';
+import type {
+ ProjectComposerDraft,
+ ProjectComposerSubmission,
+} from '../primitives/create-project';
import { CreateProject } from './create-project';
vi.mock('@ui', async () => ({
@@ -112,18 +109,16 @@ function setup(
}),
createCommands: () => service,
};
- const onCreated = vi.fn();
+ const onSubmit = vi.fn((_submission: ProjectComposerSubmission) => {});
const onClose = vi.fn();
const onContinueInSplit = vi.fn();
- const onFailure = vi.fn();
const content = () => (
<ProjectsProvider context={context}>
<CreateProject
initialDraft={initialDraft}
- onCreated={onCreated}
+ onSubmit={onSubmit}
onClose={onClose}
onContinueInSplit={onContinueInSplit}
- onFailure={onFailure}
/>
</ProjectsProvider>
);
@@ -142,11 +137,16 @@ function setup(
</Dialog>
</Show>
));
- return { ...view, service, onCreated, onClose, onContinueInSplit, onFailure };
+ return { ...view, service, onSubmit, onClose, onContinueInSplit };
}
-it('uses the native composer and submits edited property values and team-sharing choice', async () => {
- const { service, onCreated } = setup();
+const dueValue = {
+ valueType: 'DATE' as const,
+ value: new Date('2026-10-01T00:00:00Z'),
+};
+
+it('hands its draft and one create with the drafted values to the host the moment it submits', async () => {
+ const { service, onSubmit, onClose } = setup();
expect(screen.queryByRole('dialog')).toBeNull();
const title = screen.getByRole('textbox', { name: 'Project name' });
expect(document.activeElement).toBe(title);
@@ -161,96 +161,61 @@ it('uses the native composer and submits edited property values and team-sharing
fireEvent.click(screen.getByRole('button', { name: 'Set due date' }));
fireEvent.click(screen.getByRole('checkbox', { name: 'Share with my team' }));
fireEvent.click(screen.getByRole('button', { name: /Create Project/ }));
- await waitFor(() => expect(onCreated).toHaveBeenCalledWith('project'));
+ expect(service.create).toHaveBeenCalledOnce();
expect(service.create).toHaveBeenCalledWith({
name: 'Launch',
shareWithTeam: false,
+ properties: [{ property: dueDate, value: dueValue }],
});
- expect(service.saveProperty).toHaveBeenCalledWith('project', dueDate, {
- valueType: 'DATE',
- value: new Date('2026-10-01T00:00:00Z'),
+ expect(service.saveProperty).not.toHaveBeenCalled();
+ expect(onSubmit).toHaveBeenCalledOnce();
+ const [submission] = onSubmit.mock.calls[0];
+ expect(submission.draft).toEqual({
+ name: ' Launch ',
+ shareWithTeam: false,
+ properties: [{ property: dueDate, value: dueValue }],
});
+ // The host closes the composer; the view never waits for the server.
+ expect(onClose).not.toHaveBeenCalled();
+ expect(await submission.result).toBe(project);
});
-it('continues a failed property save in a split without losing the draft or creating a duplicate', async () => {
+it('shows a reopened creation failure and resubmits the same draft', () => {
const service = commands();
- service.saveProperty.mockRejectedValueOnce(new Error('offline'));
- const view = setup(service);
- fireEvent.input(screen.getByRole('textbox', { name: 'Project name' }), {
- target: { value: 'Launch' },
+ const { onSubmit } = setup(service, {
+ name: 'Launch',
+ shareWithTeam: true,
+ properties: [{ property: dueDate, value: dueValue }],
+ error: 'offline',
});
- fireEvent.click(screen.getByRole('button', { name: 'Set due date' }));
- fireEvent.click(screen.getByRole('button', { name: /Create Project/ }));
- expect(await screen.findByRole('alert')).toHaveProperty(
- 'textContent',
- expect.stringContaining('Retry')
- );
- expect(screen.getByRole('textbox', { name: 'Project name' })).toHaveProperty(
- 'disabled',
- true
- );
- expect(
- screen.getByRole('checkbox', { name: 'Share with my team' })
- ).toHaveProperty('disabled', true);
- expect(view.onCreated).not.toHaveBeenCalled();
- fireEvent.click(
- screen.getByRole('button', { name: 'Continue editing in split' })
- );
- const draft = view.onContinueInSplit.mock.calls[0][0] as ProjectComposerDraft;
- expect(draft.properties[0].value).toEqual({
- valueType: 'DATE',
- value: new Date('2026-10-01T00:00:00Z'),
+ expect(screen.getByRole('alert')).toHaveProperty('textContent', 'offline');
+ const title = screen.getByRole('textbox', { name: 'Project name' });
+ expect(title).toHaveProperty('value', 'Launch');
+ fireEvent.keyDown(title, { key: 'Enter', ctrlKey: true });
+ expect(onSubmit).toHaveBeenCalledOnce();
+ expect(service.create).toHaveBeenCalledWith({
+ name: 'Launch',
+ shareWithTeam: true,
+ properties: [{ property: dueDate, value: dueValue }],
});
- cleanup();
- const continued = setup(service, draft);
- expect(screen.getByRole('textbox', { name: 'Project name' })).toHaveProperty(
- 'value',
- 'Launch'
- );
- expect(screen.getByRole('textbox', { name: 'Project name' })).toHaveProperty(
- 'disabled',
- true
- );
- fireEvent.click(
- screen.getByRole('button', { name: /Retry saving properties/ })
- );
- await waitFor(() =>
- expect(continued.onCreated).toHaveBeenCalledWith('project')
- );
- expect(service.create).toHaveBeenCalledTimes(1);
- expect(service.saveProperty).toHaveBeenCalledTimes(2);
+ expect(onSubmit.mock.calls[0][0].draft).not.toHaveProperty('error');
});
-it('retains the draft after creation fails, blocks duplicate keyboard submits, and clears intentionally', async () => {
+it('blocks empty and duplicate keyboard submits, and clears intentionally', () => {
const service = commands();
- let rejectCreation!: (error: Error) => void;
- service.create.mockImplementationOnce(
- () =>
- new Promise((_, reject) => {
- rejectCreation = reject;
- })
- );
- const { onCreated } = setup(service);
+ const { onSubmit } = setup(service);
const title = screen.getByRole('textbox', { name: 'Project name' });
fireEvent.keyDown(title, { key: 'Enter', metaKey: true });
expect(service.create).not.toHaveBeenCalled();
fireEvent.input(title, { target: { value: 'Launch' } });
fireEvent.keyDown(title, { key: 'Enter', metaKey: true });
fireEvent.keyDown(title, { key: 'Enter', metaKey: true });
- expect(service.create).toHaveBeenCalledTimes(1);
+ expect(service.create).toHaveBeenCalledOnce();
+ expect(onSubmit).toHaveBeenCalledOnce();
expect(screen.getByRole('button', { name: 'Close' })).toHaveProperty(
'disabled',
true
);
- rejectCreation(new Error('offline'));
- expect(await screen.findByRole('alert')).toHaveProperty(
- 'textContent',
- 'offline'
- );
- expect(title).toHaveProperty('value', 'Launch');
- fireEvent.keyDown(title, { key: 'Enter', ctrlKey: true });
- await waitFor(() => expect(onCreated).toHaveBeenCalledWith('project'));
- expect(service.create).toHaveBeenCalledTimes(2);
cleanup();
const fresh = setup();
fireEvent.input(screen.getByRole('textbox', { name: 'Project name' }), {
@@ -269,46 +234,10 @@ it('retains the draft after creation fails, blocks duplicate keyboard submits, a
name: '',
shareWithTeam: true,
properties: [],
- createdId: undefined,
error: undefined,
});
});
-it('returns the created identity and property draft for recovery if the composer closes during a failed save', async () => {
- const service = commands();
- let rejectSave!: (error: Error) => void;
- service.saveProperty.mockImplementationOnce(
- () =>
- new Promise((_, reject) => {
- rejectSave = reject;
- })
- );
- const view = setup(service);
- fireEvent.input(screen.getByRole('textbox', { name: 'Project name' }), {
- target: { value: 'Launch' },
- });
- fireEvent.click(screen.getByRole('button', { name: 'Set due date' }));
- fireEvent.click(screen.getByRole('button', { name: /Create Project/ }));
- await waitFor(() => expect(service.saveProperty).toHaveBeenCalledOnce());
- cleanup();
- rejectSave(new Error('offline'));
- await waitFor(() => expect(view.onFailure).toHaveBeenCalledOnce());
- expect(view.onCreated).not.toHaveBeenCalled();
- expect(view.onFailure).toHaveBeenCalledWith(
- expect.objectContaining({
- name: 'Launch',
- createdId: 'project',
- shareWithTeam: true,
- properties: [
- {
- property: dueDate,
- value: { valueType: 'DATE', value: new Date('2026-10-01T00:00:00Z') },
- },
- ],
- })
- );
-});
-
it('keeps the project name focused after the popover applies initial focus', async () => {
setup(commands(), undefined, true);
await screen.findByRole('dialog');
diff --git a/apps/web/src/features/projects/views/create-project.tsx b/apps/web/src/features/projects/views/create-project.tsx
index 0cef2fdea3..0cdc63b860 100644
--- a/apps/web/src/features/projects/views/create-project.tsx
+++ b/apps/web/src/features/projects/views/create-project.tsx
@@ -7,29 +7,28 @@ import { useProjectsContext } from '../context/projects-context';
import {
createProjectComposer,
type ProjectComposerDraft,
+ type ProjectComposerSubmission,
} from '../primitives/create-project';
import { withProjectPropertyValue } from '../primitives/property-draft';
export function CreateProject(props: {
initialDraft?: ProjectComposerDraft;
onClose(): void;
- onCreated(id: string): void;
+ /** The server creates the project after the host has closed the composer. */
+ onSubmit(submission: ProjectComposerSubmission): void;
onContinueInSplit?(draft: ProjectComposerDraft): void;
- onFailure?(draft: ProjectComposerDraft): void;
}) {
const context = useProjectsContext();
const definitions = context.createPropertyDefinitionsSource();
const composer = createProjectComposer(
context.createCommands(),
- props.onCreated,
props.initialDraft
);
let titleInput: HTMLInputElement | undefined;
onMount(() => titleInput?.focus());
- const submit = async () => {
- if ((await composer.submit()) === 'failed') {
- props.onFailure?.(composer.snapshot());
- }
+ const submit = () => {
+ const submission = composer.submit();
+ if (submission) props.onSubmit(submission);
};
return (
@@ -38,7 +37,7 @@ export function CreateProject(props: {
aria-label="New project"
onSubmit={(event) => {
event.preventDefault();
- void submit();
+ submit();
}}
onKeyDown={(event) => {
if (
@@ -48,7 +47,7 @@ export function CreateProject(props: {
) {
event.preventDefault();
event.stopPropagation();
- void submit();
+ submit();
}
}}
>
@@ -68,12 +67,7 @@ export function CreateProject(props: {
</Button>
</Show>
</div>
- <Show
- when={
- !composer.createdId() &&
- (composer.name() || composer.drafts().size > 0)
- }
- >
+ <Show when={composer.name() || composer.drafts().size > 0}>
<Button
tabIndex={-1}
size="sm"
@@ -110,7 +104,7 @@ export function CreateProject(props: {
class="ph-no-capture w-full min-w-0 text-xl/7 font-medium outline-none bg-transparent placeholder:text-ink-placeholder"
value={composer.name()}
required
- disabled={composer.pending() || Boolean(composer.createdId())}
+ disabled={composer.pending()}
onInput={(event) => composer.setName(event.currentTarget.value)}
/>
</EntityComposer.Title>
@@ -125,10 +119,7 @@ export function CreateProject(props: {
?.value
)}
canEdit={!composer.pending()}
- entitySelfFilter={{
- entityType: 'INITIATIVE',
- blockId: composer.createdId(),
- }}
+ entitySelfFilter={{ entityType: 'INITIATIVE' }}
onSave={async (_, value) => {
composer.saveDraft(property, value);
}}
@@ -162,7 +153,7 @@ export function CreateProject(props: {
<EntityComposer.Footer class="items-center flex-wrap">
<Checkbox
checked={composer.shareWithTeam()}
- disabled={composer.pending() || Boolean(composer.createdId())}
+ disabled={composer.pending()}
onChange={composer.setShareWithTeam}
>
<Checkbox.Control />
@@ -176,11 +167,7 @@ export function CreateProject(props: {
hasContent={Boolean(composer.name().trim())}
disabled={composer.pending() || !composer.name().trim()}
>
- {composer.pending()
- ? 'Saving…'
- : composer.createdId()
- ? 'Retry saving properties'
- : 'Create Project'}
+ Create Project
</EntityComposer.Submit>
</EntityComposer.Footer>
</EntityComposer.Root>
diff --git a/apps/web/src/lib/queries/properties/graphql/entity.ts b/apps/web/src/lib/queries/properties/graphql/entity.ts
index 0e66b89c73..35c798b134 100644
--- a/apps/web/src/lib/queries/properties/graphql/entity.ts
+++ b/apps/web/src/lib/queries/properties/graphql/entity.ts
@@ -175,7 +175,7 @@ function toGraphqlEntityReference(
};
}
-function toGraphqlSetPropertyValue(
+export function toGraphqlSetPropertyValue(
value: SetPropertyValue | null
): GraphqlSetPropertyValue | null {
if (value === null) return null;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/createInitiativeRequest.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/createInitiativeRequest.ts
index 53430e8460..97f25bbc4e 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/createInitiativeRequest.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/createInitiativeRequest.ts
@@ -7,6 +7,7 @@
import type { CreateInitiativeRequestDescription } from './createInitiativeRequestDescription';
import type { CreateInitiativeRequestMemberIds } from './createInitiativeRequestMemberIds';
import type { CreateInitiativeRequestShareWithTeam } from './createInitiativeRequestShareWithTeam';
+import type { InitialPropertyValue } from './initialPropertyValue';
/**
* Create-initiative HTTP body.
@@ -19,6 +20,9 @@ edits happen in the document editor. */
memberIds?: CreateInitiativeRequestMemberIds;
/** Display name. */
name: string;
+ /** Property values set as the owner within the create. A value the properties
+service rejects fails the whole create; no initiative is left behind. */
+ propertyValues?: InitialPropertyValue[];
/** Share with the owner's team at create time. Defaults to true; users without
a team create an unshared initiative. Explicit false skips the team grant. */
shareWithTeam?: CreateInitiativeRequestShareWithTeam;
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
index 30512b5811..0e773fcbb1 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/index.ts
@@ -819,6 +819,7 @@ export * from './importedAuthor';
export * from './inFlightTurnSummary';
export * from './inFlightTurnSummaryActor';
export * from './inFlightTurnSummaryAnnouncementMessageId';
+export * from './initialPropertyValue';
export * from './initiativeDetail';
export * from './initiativeFilters';
export * from './initiativeFiltersDueAfter';
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/schemas/initialPropertyValue.ts b/apps/web/src/lib/service-clients/service-storage/generated/schemas/initialPropertyValue.ts
new file mode 100644
index 0000000000..b4954ef1f3
--- /dev/null
+++ b/apps/web/src/lib/service-clients/service-storage/generated/schemas/initialPropertyValue.ts
@@ -0,0 +1,17 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * document_storage_service
+ * OpenAPI spec version: 0.1.0
+ */
+import type { SetPropertyValue } from './setPropertyValue';
+
+/**
+ * A property value set on a new initiative as part of its create.
+ */
+export interface InitialPropertyValue {
+ /** Property definition to set. */
+ propertyDefinitionId: string;
+ /** Value, validated by the properties service like any other property write. */
+ value: SetPropertyValue;
+}
diff --git a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
index bdd2a8c0c6..2c36301b8a 100644
--- a/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
+++ b/apps/web/src/lib/service-clients/service-storage/generated/zod.ts
@@ -8685,6 +8685,154 @@ export const createInitiativeBody = zod
'Optional member user ids. Invalid ids fail at the service boundary.'
),
name: zod.string().describe('Display name.'),
+ propertyValues: zod
+ .array(
+ zod
+ .object({
+ propertyDefinitionId: zod
+ .uuid()
+ .describe('Property definition to set.'),
+ value: zod
+ .union([
+ zod
+ .object({
+ type: zod.enum(['boolean']),
+ value: zod.boolean(),
+ })
+ .describe('Boolean true\/false value'),
+ zod
+ .object({
+ type: zod.enum(['date']),
+ value: zod.iso.datetime({}),
+ })
+ .describe('Date and time value'),
+ zod
+ .object({
+ type: zod.enum(['number']),
+ value: zod.number(),
+ })
+ .describe('Numeric value'),
+ zod
+ .object({
+ type: zod.enum(['string']),
+ value: zod.string(),
+ })
+ .describe('String\/text value'),
+ zod
+ .object({
+ option_id: zod.uuid(),
+ type: zod.enum(['select_option']),
+ })
+ .describe('Select option by ID (for select-type properties)'),
+ zod
+ .object({
+ option_ids: zod.array(zod.uuid()),
+ type: zod.enum(['multi_select_option']),
+ })
+ .describe(
+ 'Multiple select options by ID (for multi-select properties)'
+ ),
+ zod
+ .object({
+ reference: zod
+ .object({
+ entity_id: zod.string(),
+ entity_type: zod
+ .enum([
+ 'CALENDAR_EVENT',
+ 'CALL_RECORD',
+ 'CHANNEL',
+ 'CHAT',
+ 'COMPANY',
+ 'DOCUMENT',
+ 'INITIATIVE',
+ 'PROJECT',
+ 'TASK',
+ 'THREAD',
+ 'USER',
+ ])
+ .describe(
+ 'Type of entity that can be referenced by entity properties.'
+ ),
+ specific_message_id: zod
+ .uuid()
+ .nullish()
+ .describe(
+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'
+ ),
+ })
+ .describe(
+ 'Entity reference for entity-type property values.'
+ ),
+ type: zod.enum(['entity_reference']),
+ })
+ .describe('Entity reference'),
+ zod
+ .object({
+ references: zod.array(
+ zod
+ .object({
+ entity_id: zod.string(),
+ entity_type: zod
+ .enum([
+ 'CALENDAR_EVENT',
+ 'CALL_RECORD',
+ 'CHANNEL',
+ 'CHAT',
+ 'COMPANY',
+ 'DOCUMENT',
+ 'INITIATIVE',
+ 'PROJECT',
+ 'TASK',
+ 'THREAD',
+ 'USER',
+ ])
+ .describe(
+ 'Type of entity that can be referenced by entity properties.'
+ ),
+ specific_message_id: zod
+ .uuid()
+ .nullish()
+ .describe(
+ 'For CHANNEL, CHAT, THREAD entity types - optional specific message ID.\nThis allows referencing a specific message within a thread\/channel\/chat.'
+ ),
+ })
+ .describe(
+ 'Entity reference for entity-type property values.'
+ )
+ ),
+ type: zod.enum(['multi_entity_reference']),
+ })
+ .describe(
+ 'Multiple entity references (for multi-select entity properties)'
+ ),
+ zod
+ .object({
+ type: zod.enum(['link']),
+ url: zod.string(),
+ })
+ .describe('Link value'),
+ zod
+ .object({
+ type: zod.enum(['multi_link']),
+ urls: zod.array(zod.string()),
+ })
+ .describe(
+ 'Multiple link values (for multi-select link properties)'
+ ),
+ ])
+ .describe(
+ 'Type-safe enum for setting entity property values - provides compile-time validation.'
+ ),
+ })
+ .describe(
+ 'A property value set on a new initiative as part of its create.'
+ )
+ )
+ .optional()
+ .describe(
+ 'Property values set as the owner within the create. A value the properties\nservice rejects fails the whole create; no initiative is left behind.'
+ ),
shareWithTeam: zod
.boolean()
.nullish()
diff --git a/apps/web/src/lib/service-clients/service-storage/graphql/generated/graphql.ts b/apps/web/src/lib/service-clients/service-storage/graphql/generated/graphql.ts
index 11d5551103..4723a44e6a 100644
--- a/apps/web/src/lib/service-clients/service-storage/graphql/generated/graphql.ts
+++ b/apps/web/src/lib/service-clients/service-storage/graphql/generated/graphql.ts
@@ -45,6 +45,8 @@ export type CreateInitiativeInput = {
memberIds?: Array<string> | null | undefined;
/** Initial name. */
name: string;
+ /** Initial property values, set in the same create; a rejected value fails it. */
+ propertyValues?: Array<InitialPropertyValueInput> | null | undefined;
/** Whether to share with the owner's team, defaulting to true. */
shareWithTeam?: boolean | null | undefined;
};
@@ -1179,6 +1181,14 @@ export type GroupedSoupInput =
| { continuation?: never; /** Start a new grouped Soup query. */
initial: GroupedSoupInitialInput; };
+/** One property value set when an initiative is created. */
+export type InitialPropertyValueInput = {
+ /** Property definition to set. */
+ propertyDefinitionId: string | number;
+ /** Value, in the same shape `setEntityProperty` accepts. */
+ value: GraphqlSetPropertyValue;
+};
+
/** A channel sharing patch. */
export type InitiativeChannelShareInput = {
/** Grant level for add or replace. */
diff --git a/apps/web/src/lib/service-clients/service-storage/openapi.json b/apps/web/src/lib/service-clients/service-storage/openapi.json
index fd57657ee8..d68cdf2c39 100644
--- a/apps/web/src/lib/service-clients/service-storage/openapi.json
+++ b/apps/web/src/lib/service-clients/service-storage/openapi.json
@@ -18528,6 +18528,13 @@
"type": "string",
"description": "Display name."
},
+ "propertyValues": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/InitialPropertyValue"
+ },
+ "description": "Property values set as the owner within the create. A value the properties\nservice rejects fails the whole create; no initiative is left behind."
+ },
"shareWithTeam": {
"type": ["boolean", "null"],
"description": "Share with the owner's team at create time. Defaults to true; users without\na team create an unshared initiative. Explicit false skips the team grant."
@@ -23366,6 +23373,22 @@
}
}
},
+ "InitialPropertyValue": {
+ "type": "object",
+ "description": "A property value set on a new initiative as part of its create.",
+ "required": ["propertyDefinitionId", "value"],
+ "properties": {
+ "propertyDefinitionId": {
+ "type": "string",
+ "format": "uuid",
+ "description": "Property definition to set."
+ },
+ "value": {
+ "$ref": "#/components/schemas/SetPropertyValue",
+ "description": "Value, validated by the properties service like any other property write."
+ }
+ }
+ },
"InitiativeDetail": {
"type": "object",
"description": "Full initiative returned to a caller, including members, tasks, and share state.",
diff --git a/crates/graphql_initiative/Cargo.toml b/crates/graphql_initiative/Cargo.toml
index 92ba399299..a22747de45 100644
--- a/crates/graphql_initiative/Cargo.toml
+++ b/crates/graphql_initiative/Cargo.toml
@@ -10,6 +10,7 @@ entity_access = { path = "../entity_access", default-features = false, features
futures = { workspace = true }
graphql_common = { path = "../graphql_common" }
graphql_permission = { path = "../graphql_permission" }
+graphql_properties = { path = "../graphql_properties" }
graphql_soup = { path = "../graphql_soup" }
initiative = { path = "../initiative", default-features = false, features = ["ports"] }
macro_user_id = { path = "../macro_user_id" }
diff --git a/crates/graphql_initiative/src/inputs.rs b/crates/graphql_initiative/src/inputs.rs
index 914ba29832..49ed253046 100644
--- a/crates/graphql_initiative/src/inputs.rs
+++ b/crates/graphql_initiative/src/inputs.rs
@@ -1,9 +1,11 @@
//! Typed input objects and lossless transport-to-domain conversion.
use async_graphql::{Enum, ID, InputObject, MaybeUndefined};
+use graphql_common::parse_id;
use graphql_permission::GraphqlEntityAccessLevel;
+use graphql_properties::GraphqlSetPropertyValue;
use initiative::domain::{
- models::{CreateInitiativeRequest, UpdateInitiativeRequest},
+ models::{CreateInitiativeRequest, InitialPropertyValue, UpdateInitiativeRequest},
reads::InitiativeTasksRequest,
};
use models_permissions::share_permission::{
@@ -40,16 +42,43 @@ pub struct CreateInitiativeInput {
pub member_ids: Option<Vec<String>>,
/// Whether to share with the owner's team, defaulting to true.
pub share_with_team: Option<bool>,
+ /// Initial property values, set in the same create; a rejected value fails it.
+ pub property_values: Option<Vec<InitialPropertyValueInput>>,
}
-impl From<CreateInitiativeInput> for CreateInitiativeRequest {
- fn from(value: CreateInitiativeInput) -> Self {
- Self {
+/// One property value set when an initiative is created.
+#[derive(InputObject)]
+pub struct InitialPropertyValueInput {
+ /// Property definition to set.
+ pub property_definition_id: ID,
+ /// Value, in the same shape `setEntityProperty` accepts.
+ pub value: GraphqlSetPropertyValue,
+}
+
+impl TryFrom<CreateInitiativeInput> for CreateInitiativeRequest {
+ type Error = async_graphql::Error;
+
+ fn try_from(value: CreateInitiativeInput) -> async_graphql::Result<Self> {
+ Ok(Self {
name: value.name,
description: value.description,
member_ids: value.member_ids,
share_with_team: value.share_with_team,
- }
+ property_values: value
+ .property_values
+ .unwrap_or_default()
+ .into_iter()
+ .map(|input| {
+ Ok(InitialPropertyValue {
+ property_definition_id: parse_id(
+ input.property_definition_id,
+ "propertyDefinitionId",
+ )?,
+ value: input.value.try_into_model()?,
+ })
+ })
+ .collect::<async_graphql::Result<_>>()?,
+ })
}
}
@@ -180,3 +209,6 @@ impl From<UpdateInitiativeInput> for UpdateInitiativeRequest {
}
}
}
+
+#[cfg(test)]
+mod test;
diff --git a/crates/graphql_initiative/src/inputs/test.rs b/crates/graphql_initiative/src/inputs/test.rs
new file mode 100644
index 0000000000..b1de453075
--- /dev/null
+++ b/crates/graphql_initiative/src/inputs/test.rs
@@ -0,0 +1,70 @@
+use async_graphql::ID;
+use graphql_properties::GraphqlSetPropertyValue;
+use initiative::domain::models::{CreateInitiativeRequest, InitialPropertyValue};
+use models_properties::api::requests::SetPropertyValue;
+use uuid::Uuid;
+
+use super::{CreateInitiativeInput, InitialPropertyValueInput};
+
+fn input(property_values: Vec<InitialPropertyValueInput>) -> CreateInitiativeInput {
+ CreateInitiativeInput {
+ name: "Launch".into(),
+ description: None,
+ member_ids: None,
+ share_with_team: Some(false),
+ property_values: Some(property_values),
+ }
+}
+
+#[test]
+fn initial_values_convert_to_the_domain_request() {
+ let status = Uuid::from_u128(1);
+ let in_progress = Uuid::from_u128(2);
+ let due = Uuid::from_u128(3);
+ let request = CreateInitiativeRequest::try_from(input(vec![
+ InitialPropertyValueInput {
+ property_definition_id: ID(status.to_string()),
+ value: GraphqlSetPropertyValue::SelectOption(ID(in_progress.to_string())),
+ },
+ InitialPropertyValueInput {
+ property_definition_id: ID(due.to_string()),
+ value: GraphqlSetPropertyValue::Date("2026-10-01T00:00:00Z".into()),
+ },
+ ]))
+ .expect("valid input");
+
+ assert_eq!(request.share_with_team, Some(false));
+ assert_eq!(
+ request.property_values,
+ vec![
+ InitialPropertyValue {
+ property_definition_id: status,
+ value: SetPropertyValue::SelectOption {
+ option_id: in_progress,
+ },
+ },
+ InitialPropertyValue {
+ property_definition_id: due,
+ value: SetPropertyValue::Date {
+ value: "2026-10-01T00:00:00Z".parse().unwrap(),
+ },
+ },
+ ]
+ );
+}
+
+#[test]
+fn malformed_initial_values_fail_before_the_service_is_called() {
+ for value in [
+ InitialPropertyValueInput {
+ property_definition_id: ID("not-a-uuid".into()),
+ value: GraphqlSetPropertyValue::Boolean(true),
+ },
+ InitialPropertyValueInput {
+ property_definition_id: ID(Uuid::from_u128(1).to_string()),
+ value: GraphqlSetPropertyValue::Date("yesterday".into()),
+ },
+ ] {
+ assert!(CreateInitiativeRequest::try_from(input(vec![value])).is_err());
+ }
+}
diff --git a/crates/graphql_initiative/src/mutation.rs b/crates/graphql_initiative/src/mutation.rs
index c0833357aa..9d22fc3235 100644
--- a/crates/graphql_initiative/src/mutation.rs
+++ b/crates/graphql_initiative/src/mutation.rs
@@ -40,7 +40,7 @@ impl<E: SoupEntityEdges> InitiativeMutationRoot<E> {
let detail = ctx
.data::<InitiativeGraphqlContext>()?
.0
- .create(user.clone(), input.into())
+ .create(user.clone(), input.try_into()?)
.await
.map_err(graphql_error)?;
load_from_soup(
diff --git a/crates/graphql_properties/src/lib.rs b/crates/graphql_properties/src/lib.rs
index 6864177e90..b584e6cc57 100644
--- a/crates/graphql_properties/src/lib.rs
+++ b/crates/graphql_properties/src/lib.rs
@@ -26,8 +26,9 @@ pub use loaders::{
PropertiesEntityPropertyReader, entity_properties_loader,
};
pub use mutations::{
- EntityPropertyOptionDelta, EntityPropertyWriter, GraphqlPropertyTargetEntityType,
- NoOpEntityPropertyWriter, PropertiesEntityPropertyWriter, PropertiesMutationRoot,
+ EntityPropertyOptionDelta, EntityPropertyWriter, GraphqlEntityReferenceInput,
+ GraphqlPropertyTargetEntityType, GraphqlSetPropertyValue, NoOpEntityPropertyWriter,
+ PropertiesEntityPropertyWriter, PropertiesMutationRoot,
};
pub use objects::{
GraphqlBooleanPropertyValue, GraphqlDatePropertyValue, GraphqlEntityReferencePropertyValue,
diff --git a/crates/graphql_properties/src/mutations.rs b/crates/graphql_properties/src/mutations.rs
index 329ce6787c..cd5e6694bb 100644
--- a/crates/graphql_properties/src/mutations.rs
+++ b/crates/graphql_properties/src/mutations.rs
@@ -336,7 +336,7 @@ impl EntityPropertyOptionDeltaInput {
/// Input identifying an entity referenced by a property value.
#[derive(async_graphql::InputObject)]
-struct GraphqlEntityReferenceInput {
+pub struct GraphqlEntityReferenceInput {
/// Type of the referenced entity.
entity_type: GraphqlPropertyEntityType,
/// Identifier of the referenced entity.
@@ -361,7 +361,7 @@ impl GraphqlEntityReferenceInput {
/// A typed value accepted when setting an entity property.
#[derive(async_graphql::OneofObject)]
-enum GraphqlSetPropertyValue {
+pub enum GraphqlSetPropertyValue {
/// A Boolean value.
Boolean(bool),
/// An RFC 3339 date-time value.
@@ -386,7 +386,7 @@ enum GraphqlSetPropertyValue {
impl GraphqlSetPropertyValue {
/// Convert the GraphQL value into its properties-domain request model.
- fn try_into_model(self) -> async_graphql::Result<SetPropertyValue> {
+ pub fn try_into_model(self) -> async_graphql::Result<SetPropertyValue> {
Ok(match self {
Self::Boolean(value) => SetPropertyValue::Boolean { value },
Self::Date(value) => SetPropertyValue::Date {
diff --git a/crates/initiative/Cargo.toml b/crates/initiative/Cargo.toml
index 6212426a76..24aa41c762 100644
--- a/crates/initiative/Cargo.toml
+++ b/crates/initiative/Cargo.toml
@@ -16,7 +16,7 @@ inbound = [
"ports",
]
outbound = ["ports"]
-resources = ["outbound", "dep:properties", "dep:system_properties", "dep:models_properties"]
+resources = ["outbound", "dep:properties", "dep:system_properties"]
ports = ["dep:entity_access", "dep:tracing"]
postgres = [
"dep:sqlx",
@@ -35,7 +35,7 @@ bot_id = { path = "../bot_id", optional = true }
schemars = { workspace = true, optional = true }
properties = { path = "../properties", optional = true, default-features = false }
system_properties = { path = "../system_properties", optional = true }
-models_properties = { path = "../models_properties", optional = true }
+models_properties = { path = "../models_properties" }
activity = { path = "../activity", default-features = false }
axum = { workspace = true, optional = true }
chrono = { workspace = true, features = ["serde"] }
@@ -69,6 +69,8 @@ anyhow = { workspace = true }
http-body-util = { workspace = true }
macro_db_migrator = { path = "../macro_db_migrator" }
model_user = { path = "../model_user" }
+properties = { path = "../properties", default-features = false, features = ["outbound"] }
serde_json = { workspace = true }
+system_properties = { path = "../system_properties" }
tokio = { workspace = true, features = ["macros", "rt-multi-thread"] }
tower = { workspace = true }
diff --git a/crates/initiative/src/domain/models.rs b/crates/initiative/src/domain/models.rs
index f1a95e2a65..415b28694b 100644
--- a/crates/initiative/src/domain/models.rs
+++ b/crates/initiative/src/domain/models.rs
@@ -169,8 +169,19 @@ pub struct InitiativeDetail {
pub updated_at: DateTime<Utc>,
}
+/// A property value set on a new initiative as part of its create.
+#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
+#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
+#[serde(rename_all = "camelCase")]
+pub struct InitialPropertyValue {
+ /// Property definition to set.
+ pub property_definition_id: Uuid,
+ /// Value, validated by the properties service like any other property write.
+ pub value: models_properties::api::requests::SetPropertyValue,
+}
+
/// Create-initiative HTTP body.
-#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
+#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
#[cfg_attr(feature = "inbound", derive(utoipa::ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct CreateInitiativeRequest {
@@ -187,6 +198,10 @@ pub struct CreateInitiativeRequest {
/// a team create an unshared initiative. Explicit false skips the team grant.
#[serde(skip_serializing_if = "Option::is_none")]
pub share_with_team: Option<bool>,
+ /// Property values set as the owner within the create. A value the properties
+ /// service rejects fails the whole create; no initiative is left behind.
+ #[serde(default, skip_serializing_if = "Vec::is_empty")]
+ pub property_values: Vec<InitialPropertyValue>,
}
/// Update-initiative HTTP body. Absent fields are left unchanged. `member_ids`
diff --git a/crates/initiative/src/domain/resources.rs b/crates/initiative/src/domain/resources.rs
index 9f64152337..3c66b8b739 100644
--- a/crates/initiative/src/domain/resources.rs
+++ b/crates/initiative/src/domain/resources.rs
@@ -2,12 +2,14 @@
use std::{collections::HashMap, future::Future, pin::Pin};
+use macro_user_id::user_id::MacroUserIdStr;
+
use entity_access::domain::models::{
EditAccessLevel, Entity, EntityAccessAuth, EntityAccessReceipt, ViewAccessLevel,
};
use super::{
- models::{InitiativeError, InitiativeId},
+ models::{InitialPropertyValue, InitiativeError, InitiativeId},
reads::InitiativePropertySnapshot,
};
@@ -20,6 +22,14 @@ pub type ResourceFuture<'a, T> =
pub trait InitiativeResources: std::fmt::Debug + Send + Sync + 'static {
/// Initialize the four canonical task-style properties without clearing existing values.
fn initialize(&self, id: InitiativeId) -> ResourceFuture<'_, ()>;
+ /// Set a new initiative's first property values as its owner, validated by the
+ /// properties service. All or nothing: if any value is rejected, none remain.
+ fn set_initial_properties(
+ &self,
+ owner: MacroUserIdStr<'static>,
+ id: InitiativeId,
+ values: Vec<InitialPropertyValue>,
+ ) -> ResourceFuture<'_, ()>;
/// Clean up properties after the initiative is deleted using its already-verified capability.
fn purge(&self, receipt: EntityAccessReceipt<EditAccessLevel>) -> ResourceFuture<'_, ()>;
/// Return a view capability for a related entity under the same user/bot scope.
diff --git a/crates/initiative/src/domain/service.rs b/crates/initiative/src/domain/service.rs
index 7560ef0198..b2badf77e0 100644
--- a/crates/initiative/src/domain/service.rs
+++ b/crates/initiative/src/domain/service.rs
@@ -203,6 +203,7 @@ where
let prefill_markdown = normalize_description(request.description)?;
let owner_id = user_id.clone().into_owned();
let member_ids = parse_member_ids(request.member_ids.unwrap_or_default(), &owner_id)?;
+ let property_values = validate_initial_properties(request.property_values)?;
let team_default = self
.repo
.get_team_default_link_share(&owner_id)
@@ -242,7 +243,14 @@ where
.await;
match created {
Ok(mut detail) => {
- if let Err(error) = self.resources.initialize(id).await {
+ if let Err(error) = initialize_properties(
+ self.resources.as_ref(),
+ user_id.clone().into_owned(),
+ id,
+ property_values,
+ )
+ .await
+ {
if self.repo.delete(id).await.inspect_err(|cleanup| {
tracing::error!(error=?cleanup, %id, "failed to compensate initiative initialization");
}).is_ok() {
@@ -652,6 +660,43 @@ fn parse_member_ids(
Ok(parsed)
}
+/// More than any project form sends; bounds the writes one create can fan out to.
+const MAX_INITIAL_PROPERTY_VALUES: usize = 32;
+
+/// Rejected before anything is created, so a bad request never needs compensation.
+fn validate_initial_properties(
+ values: Vec<crate::domain::models::InitialPropertyValue>,
+) -> Result<Vec<crate::domain::models::InitialPropertyValue>, InitiativeError> {
+ if values.len() > MAX_INITIAL_PROPERTY_VALUES {
+ return Err(InitiativeError::BadRequest(format!(
+ "at most {MAX_INITIAL_PROPERTY_VALUES} initial property values are allowed"
+ )));
+ }
+ let mut seen = HashSet::new();
+ if let Some(duplicate) = values
+ .iter()
+ .find(|value| !seen.insert(value.property_definition_id))
+ {
+ return Err(InitiativeError::BadRequest(format!(
+ "property {} is set more than once",
+ duplicate.property_definition_id
+ )));
+ }
+ Ok(values)
+}
+
+/// Attach the canonical properties, then set the owner's first values. Either
+/// failing fails the create, which then deletes the initiative.
+async fn initialize_properties(
+ resources: &dyn InitiativeResources,
+ owner: MacroUserIdStr<'static>,
+ id: InitiativeId,
+ values: Vec<crate::domain::models::InitialPropertyValue>,
+) -> Result<(), InitiativeError> {
+ resources.initialize(id).await?;
+ resources.set_initial_properties(owner, id, values).await
+}
+
fn member_diff(
current: &[MacroUserIdStr<'static>],
requested: &[MacroUserIdStr<'static>],
diff --git a/crates/initiative/src/domain/service/test.rs b/crates/initiative/src/domain/service/test.rs
index 32f292edc3..6fe609bfb2 100644
--- a/crates/initiative/src/domain/service/test.rs
+++ b/crates/initiative/src/domain/service/test.rs
@@ -2,6 +2,7 @@ use chrono::{TimeZone, Utc};
mod access;
mod events;
+mod initial_properties;
mod reads;
use entity_access::domain::models::{
AccessLevel, EditAccessLevel, Entity, EntityAccessReceipt, EntityPermission, EntityType,
diff --git a/crates/initiative/src/domain/service/test/initial_properties.rs b/crates/initiative/src/domain/service/test/initial_properties.rs
new file mode 100644
index 0000000000..1d42aca990
--- /dev/null
+++ b/crates/initiative/src/domain/service/test/initial_properties.rs
@@ -0,0 +1,184 @@
+use super::*;
+use crate::domain::{
+ models::InitialPropertyValue,
+ reads::InitiativePropertySnapshot,
+ resources::{InitiativeResources, ResourceFuture},
+};
+use entity_access::domain::models::{Entity, EntityAccessAuth};
+use models_properties::api::requests::SetPropertyValue;
+use std::{
+ collections::HashMap,
+ sync::{Arc, Mutex},
+};
+
+type Recorded = (
+ MacroUserIdStr<'static>,
+ InitiativeId,
+ Vec<InitialPropertyValue>,
+);
+
+/// Records the property steps a create takes, and can reject its values.
+#[derive(Debug, Default)]
+struct RecordingResources {
+ steps: Mutex<Vec<&'static str>>,
+ values: Mutex<Vec<Recorded>>,
+ reject_values: bool,
+}
+
+impl InitiativeResources for RecordingResources {
+ fn initialize(&self, _id: InitiativeId) -> ResourceFuture<'_, ()> {
+ self.steps.lock().unwrap().push("initialize");
+ Box::pin(async { Ok(()) })
+ }
+ fn set_initial_properties(
+ &self,
+ owner: MacroUserIdStr<'static>,
+ id: InitiativeId,
+ values: Vec<InitialPropertyValue>,
+ ) -> ResourceFuture<'_, ()> {
+ self.steps.lock().unwrap().push("set_initial_properties");
+ self.values.lock().unwrap().push((owner, id, values));
+ Box::pin(async move {
+ if self.reject_values {
+ Err(InitiativeError::BadRequest("option not found".into()))
+ } else {
+ Ok(())
+ }
+ })
+ }
+ fn purge(&self, _receipt: EntityAccessReceipt<EditAccessLevel>) -> ResourceFuture<'_, ()> {
+ panic!("a create never purges through a receipt")
+ }
+ fn view(
+ &self,
+ _auth: EntityAccessAuth,
+ _entity: Entity,
+ ) -> ResourceFuture<'_, Option<EntityAccessReceipt<ViewAccessLevel>>> {
+ panic!("a create reads no related entities")
+ }
+ fn properties(
+ &self,
+ _receipts: Vec<EntityAccessReceipt<ViewAccessLevel>>,
+ ) -> ResourceFuture<'_, HashMap<String, InitiativePropertySnapshot>> {
+ panic!("a create reads no property snapshots")
+ }
+}
+
+fn status(option: u128) -> InitialPropertyValue {
+ InitialPropertyValue {
+ property_definition_id: uuid::Uuid::from_u128(0xabc),
+ value: SetPropertyValue::SelectOption {
+ option_id: uuid::Uuid::from_u128(option),
+ },
+ }
+}
+
+fn request(property_values: Vec<InitialPropertyValue>) -> CreateInitiativeRequest {
+ CreateInitiativeRequest {
+ name: "Launch".into(),
+ property_values,
+ ..Default::default()
+ }
+}
+
+/// Repo and description ports for a create that reaches the property steps.
+fn created_ports() -> (MockInitiativeRepo, MockInitiativeDescriptionDocuments) {
+ let mut repo = MockInitiativeRepo::new();
+ repo.expect_get_team_default_link_share()
+ .return_once(|_| Box::pin(async { Ok(None) }));
+ repo.expect_create().return_once(|args, _, _| {
+ let id = args.id;
+ Box::pin(async move {
+ Ok(InitiativeDetail {
+ id,
+ ..detail(Vec::new())
+ })
+ })
+ });
+ let mut documents = MockInitiativeDescriptionDocuments::new();
+ documents
+ .expect_create()
+ .return_once(|_| Box::pin(async { Ok(description_document_id()) }));
+ (repo, documents)
+}
+
+#[tokio::test]
+async fn create_sets_initial_values_as_the_owner_once_properties_are_attached() {
+ let (repo, documents) = created_ports();
+ let resources = Arc::new(RecordingResources::default());
+ let created = InitiativeServiceImpl::new(repo, documents, resources.clone())
+ .create(&user(OWNER), request(vec![status(1)]))
+ .await
+ .expect("created");
+
+ assert_eq!(
+ *resources.steps.lock().unwrap(),
+ ["initialize", "set_initial_properties"]
+ );
+ assert_eq!(
+ *resources.values.lock().unwrap(),
+ [(user(OWNER), created.id, vec![status(1)])]
+ );
+}
+
+#[tokio::test]
+async fn rejected_initial_values_delete_the_new_project_and_its_description() {
+ let (mut repo, mut documents) = created_ports();
+ repo.expect_delete()
+ .times(1)
+ .return_once(|_| Box::pin(async { Ok(description_document_id()) }));
+ documents
+ .expect_purge()
+ .withf(|id| *id == description_document_id())
+ .times(1)
+ .return_once(|_| Box::pin(async { Ok(()) }));
+ let events = Arc::new(super::events::Events::default());
+ let svc = InitiativeServiceImpl::new(
+ repo,
+ documents,
+ Arc::new(RecordingResources {
+ reject_values: true,
+ ..Default::default()
+ }),
+ )
+ .with_event_publisher(events.clone());
+
+ let result = svc.create(&user(OWNER), request(vec![status(1)])).await;
+
+ assert!(matches!(result, Err(InitiativeError::BadRequest(_))));
+ // Consumers learn the project is gone; it is never announced as created.
+ assert!(matches!(
+ events.0.lock().unwrap().as_slice(),
+ [crate::domain::events::InitiativeTopicEvent::Purged { .. }]
+ ));
+}
+
+#[tokio::test]
+async fn invalid_initial_values_are_rejected_before_anything_is_created() {
+ // No expectations: any repo, document, or property call fails the test.
+ let svc = InitiativeServiceImpl::new(
+ MockInitiativeRepo::new(),
+ MockInitiativeDescriptionDocuments::new(),
+ Arc::new(RecordingResources::default()),
+ );
+
+ let duplicate = svc
+ .create(&user(OWNER), request(vec![status(1), status(2)]))
+ .await;
+ assert!(matches!(duplicate, Err(InitiativeError::BadRequest(_))));
+
+ let excessive = svc
+ .create(
+ &user(OWNER),
+ request(
+ (0..=32)
+ .map(|index| InitialPropertyValue {
+ property_definition_id: uuid::Uuid::from_u128(index),
+ ..status(1)
+ })
+ .collect(),
+ ),
+ )
+ .await;
+ assert!(matches!(excessive, Err(InitiativeError::BadRequest(_))));
+}
diff --git a/crates/initiative/src/domain/service/test/reads.rs b/crates/initiative/src/domain/service/test/reads.rs
index ca192789ea..baff117d0a 100644
--- a/crates/initiative/src/domain/service/test/reads.rs
+++ b/crates/initiative/src/domain/service/test/reads.rs
@@ -28,6 +28,14 @@ impl InitiativeResources for FakeResources {
}
})
}
+ fn set_initial_properties(
+ &self,
+ _owner: MacroUserIdStr<'static>,
+ _id: InitiativeId,
+ _values: Vec<crate::domain::models::InitialPropertyValue>,
+ ) -> ResourceFuture<'_, ()> {
+ Box::pin(async { Ok(()) })
+ }
fn purge(&self, _receipt: EntityAccessReceipt<EditAccessLevel>) -> ResourceFuture<'_, ()> {
Box::pin(async { Ok(()) })
}
diff --git a/crates/initiative/src/inbound/toolset/lifecycle.rs b/crates/initiative/src/inbound/toolset/lifecycle.rs
index 3f475f4ed7..cd97d9891f 100644
--- a/crates/initiative/src/inbound/toolset/lifecycle.rs
+++ b/crates/initiative/src/inbound/toolset/lifecycle.rs
@@ -56,6 +56,8 @@ impl<S: InitiativeService, A: EntityAccessService, R: EntityActivityReads>
description: self.description.clone(),
member_ids: self.member_ids.clone(),
share_with_team: self.share_with_team,
+ // Properties are set with SetEntityProperty after the create.
+ property_values: Vec::new(),
},
activity::Attribution::delegated(
activity::Actor::new_from_bot(context.actor),
diff --git a/crates/initiative/src/outbound/event_publisher.rs b/crates/initiative/src/outbound/event_publisher.rs
index fbe6170af9..850ca589e9 100644
--- a/crates/initiative/src/outbound/event_publisher.rs
+++ b/crates/initiative/src/outbound/event_publisher.rs
@@ -21,17 +21,21 @@ impl<B> BrokerInitiativeEventPublisher<B> {
}
impl<B: MacroEventBroker + 'static> InitiativeEventPublisher for BrokerInitiativeEventPublisher<B> {
+ /// Resolves once the broker has the event. Like document, chat and team events,
+ /// delivery continues in the broker's own task, which logs failures, so a slow
+ /// broker (bounded only by its publish timeout) never delays the mutation.
fn publish(
&self,
event: InitiativeMacroEvent,
) -> Pin<Box<dyn Future<Output = Result<(), InitiativeError>> + Send + '_>> {
- Box::pin(async move {
- self.broker
- .send_event(&event)
- .map_err(|error| InitiativeError::Internal(rootcause::report!(error).into()))?
- .await
- .map_err(|error| InitiativeError::Internal(rootcause::report!(error).into()))?
- .map_err(|error| InitiativeError::Internal(rootcause::report!(error).into()))
- })
+ let scheduled = self
+ .broker
+ .send_event(&event)
+ .map(drop)
+ .map_err(|error| InitiativeError::Internal(rootcause::report!(error).into()));
+ Box::pin(async move { scheduled })
}
}
+
+#[cfg(test)]
+mod test;
diff --git a/crates/initiative/src/outbound/event_publisher/test.rs b/crates/initiative/src/outbound/event_publisher/test.rs
new file mode 100644
index 0000000000..b5db23e6eb
--- /dev/null
+++ b/crates/initiative/src/outbound/event_publisher/test.rs
@@ -0,0 +1,48 @@
+use std::sync::{Arc, Mutex};
+use std::time::Duration;
+
+use chrono::Utc;
+use macro_event_broker::{EventBrokerError, MacroEvent, MacroEventBroker};
+
+use super::BrokerInitiativeEventPublisher;
+use crate::domain::events::{
+ InitiativeChange, InitiativeEventPublisher, InitiativeMacroEvent, InitiativeTopicEvent,
+};
+use crate::domain::models::InitiativeId;
+
+/// Accepts every event but never finishes delivering one, like a broker stuck
+/// until its publish timeout.
+#[derive(Clone, Default)]
+struct StalledBroker(Arc<Mutex<Vec<String>>>);
+
+impl MacroEventBroker for StalledBroker {
+ fn send_event<E: MacroEvent + ?Sized>(
+ &self,
+ event: &E,
+ ) -> Result<tokio::task::JoinHandle<Result<(), EventBrokerError>>, EventBrokerError> {
+ self.0.lock().unwrap().push(event.key().to_owned());
+ Ok(tokio::spawn(std::future::pending()))
+ }
+}
+
+#[tokio::test]
+async fn publish_returns_once_the_broker_has_the_event() {
+ let broker = StalledBroker::default();
+ let publisher = BrokerInitiativeEventPublisher::new(broker.clone());
+ let id = InitiativeId::generate();
+ let event = InitiativeMacroEvent::new(
+ id,
+ InitiativeTopicEvent::Created(InitiativeChange {
+ initiative_id: id,
+ attribution: None,
+ occurred_at: Utc::now(),
+ }),
+ );
+
+ tokio::time::timeout(Duration::from_secs(1), publisher.publish(event))
+ .await
+ .expect("a stalled delivery must not delay the committed mutation")
+ .expect("scheduling succeeds");
+
+ assert_eq!(broker.0.lock().unwrap().len(), 1);
+}
diff --git a/crates/initiative/src/outbound/pg_initiative_repo/test.rs b/crates/initiative/src/outbound/pg_initiative_repo/test.rs
index e4032530c9..9702d34c7c 100644
--- a/crates/initiative/src/outbound/pg_initiative_repo/test.rs
+++ b/crates/initiative/src/outbound/pg_initiative_repo/test.rs
@@ -2,6 +2,8 @@ use entity_access_db_utils::AccessLevel;
mod access;
mod history;
+#[cfg(feature = "resources")]
+mod initial_properties;
#[cfg(feature = "toolset")]
mod toolset;
use macro_db_migrator::MACRO_DB_MIGRATIONS;
diff --git a/crates/initiative/src/outbound/pg_initiative_repo/test/initial_properties.rs b/crates/initiative/src/outbound/pg_initiative_repo/test/initial_properties.rs
new file mode 100644
index 0000000000..3ab2876ae9
--- /dev/null
+++ b/crates/initiative/src/outbound/pg_initiative_repo/test/initial_properties.rs
@@ -0,0 +1,165 @@
+//! Initial property values through the real properties, system-properties and
+//! access services, the way the document storage service composes them.
+
+use super::*;
+use crate::domain::{
+ models::{CreateInitiativeRequest, InitialPropertyValue, InitiativeError},
+ ports::{InitiativeService, MockInitiativeDescriptionDocuments},
+ resources::InitiativeResources,
+ service::InitiativeServiceImpl,
+};
+use crate::outbound::resources::ProjectResources;
+use entity_access::{
+ domain::{
+ models::{EntityAccessReceipt, EntityType, ViewAccessLevel},
+ ports::EntityAccessService,
+ service::EntityAccessServiceImpl,
+ },
+ outbound::PgAccessRepository,
+};
+use models_properties::{api::requests::SetPropertyValue, service::property_value::PropertyValue};
+use properties::{
+ PermissionServiceImpl, PropertiesPgRepo, PropertiesService, PropertiesServiceImpl,
+ domain::model::TaskAssignedNotification,
+};
+use std::sync::Arc;
+use system_properties::{
+ PgSystemPropertiesRepository, StatusOption, SystemPropertiesServiceImpl, SystemPropertyKey,
+};
+
+/// Initial values do not assign anyone here, so nothing is ever notified.
+struct NoNotifications;
+
+impl properties::NotificationService for NoNotifications {
+ type Err = anyhow::Error;
+
+ async fn send_task_assigned<'a>(&self, _: TaskAssignedNotification<'a>) -> anyhow::Result<()> {
+ Ok(())
+ }
+}
+
+type Access = EntityAccessServiceImpl<PgAccessRepository>;
+type Properties =
+ PropertiesServiceImpl<PropertiesPgRepo, PermissionServiceImpl<Access>, NoNotifications>;
+
+struct Harness {
+ access: Arc<Access>,
+ properties: Arc<Properties>,
+ resources: Arc<
+ ProjectResources<
+ Properties,
+ SystemPropertiesServiceImpl<PgSystemPropertiesRepository>,
+ Access,
+ >,
+ >,
+}
+
+fn harness(pool: &PgPool) -> Harness {
+ let access = Arc::new(EntityAccessServiceImpl::new(PgAccessRepository::new(
+ pool.clone(),
+ )));
+ let properties = Arc::new(PropertiesServiceImpl::new(
+ PropertiesPgRepo::new(pool.clone()),
+ Some(PermissionServiceImpl::new(pool.clone(), access.clone())),
+ Some(NoNotifications),
+ ));
+ let resources = Arc::new(ProjectResources::new(
+ properties.clone(),
+ Arc::new(SystemPropertiesServiceImpl::new(
+ PgSystemPropertiesRepository::new(pool.clone()),
+ )),
+ access.clone(),
+ ));
+ Harness {
+ access,
+ properties,
+ resources,
+ }
+}
+
+fn status(option_id: Uuid) -> InitialPropertyValue {
+ InitialPropertyValue {
+ property_definition_id: SystemPropertyKey::STATUS_UUID,
+ value: SetPropertyValue::SelectOption { option_id },
+ }
+}
+
+async fn status_of(harness: &Harness, id: InitiativeId) -> anyhow::Result<Option<PropertyValue>> {
+ let receipt: EntityAccessReceipt<ViewAccessLevel> = harness
+ .access
+ .generate_entity_access_receipt(&user(OWNER), None, &id.to_string(), EntityType::Initiative)
+ .await?;
+ Ok(harness
+ .properties
+ .get_property_value(&receipt, SystemPropertyKey::STATUS_UUID)
+ .await?)
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn create_persists_initial_values_in_the_same_request(pool: PgPool) -> anyhow::Result<()> {
+ insert_user(&pool, OWNER).await?;
+ let description = seed_description_document(&pool, OWNER).await?;
+ let mut documents = MockInitiativeDescriptionDocuments::new();
+ documents
+ .expect_create()
+ .return_once(move |_| Box::pin(async move { Ok(description) }));
+ let harness = harness(&pool);
+ let service =
+ InitiativeServiceImpl::new(repo(pool.clone()), documents, harness.resources.clone());
+
+ let created = service
+ .create(
+ &user(OWNER),
+ CreateInitiativeRequest {
+ name: "Launch".into(),
+ share_with_team: Some(false),
+ property_values: vec![status(StatusOption::IN_PROGRESS_UUID)],
+ ..Default::default()
+ },
+ )
+ .await?;
+
+ assert_eq!(
+ status_of(&harness, created.id).await?,
+ Some(PropertyValue::SelectOption(vec![
+ StatusOption::IN_PROGRESS_UUID
+ ]))
+ );
+ Ok(())
+}
+
+#[sqlx::test(migrator = "MACRO_DB_MIGRATIONS")]
+async fn a_rejected_value_leaves_no_initial_values_behind(pool: PgPool) -> anyhow::Result<()> {
+ insert_user(&pool, OWNER).await?;
+ let project = repo(pool.clone())
+ .create(
+ create_args(&pool, OWNER, "Launch", &[]).await?,
+ share_off(),
+ TeamShareCreation::Unshared,
+ )
+ .await?;
+ let harness = harness(&pool);
+ harness.resources.initialize(project.id).await?;
+
+ // The first value is valid and written before the second is rejected.
+ let result = harness
+ .resources
+ .set_initial_properties(
+ user(OWNER),
+ project.id,
+ vec![
+ status(StatusOption::IN_PROGRESS_UUID),
+ InitialPropertyValue {
+ property_definition_id: SystemPropertyKey::PRIORITY_UUID,
+ value: SetPropertyValue::SelectOption {
+ option_id: Uuid::now_v7(),
+ },
+ },
+ ],
+ )
+ .await;
+
+ assert!(matches!(result, Err(InitiativeError::BadRequest(_))));
+ assert_eq!(status_of(&harness, project.id).await?, None);
+ Ok(())
+}
diff --git a/crates/initiative/src/outbound/pg_initiative_repo/test/toolset.rs b/crates/initiative/src/outbound/pg_initiative_repo/test/toolset.rs
index 109e5414d4..cbf9fe0e29 100644
--- a/crates/initiative/src/outbound/pg_initiative_repo/test/toolset.rs
+++ b/crates/initiative/src/outbound/pg_initiative_repo/test/toolset.rs
@@ -32,6 +32,14 @@ impl InitiativeResources for UnusedProperties {
fn initialize(&self, _: InitiativeId) -> ResourceFuture<'_, ()> {
panic!("unexpected property initialization")
}
+ fn set_initial_properties(
+ &self,
+ _: MacroUserIdStr<'static>,
+ _: InitiativeId,
+ _: Vec<crate::domain::models::InitialPropertyValue>,
+ ) -> ResourceFuture<'_, ()> {
+ panic!("unexpected initial properties")
+ }
fn purge(&self, _: EntityAccessReceipt<EditAccessLevel>) -> ResourceFuture<'_, ()> {
panic!("unexpected property deletion")
}
diff --git a/crates/initiative/src/outbound/pg_initiative_repo/test/toolset/reads.rs b/crates/initiative/src/outbound/pg_initiative_repo/test/toolset/reads.rs
index 7e04b1cd1d..4fb461ea82 100644
--- a/crates/initiative/src/outbound/pg_initiative_repo/test/toolset/reads.rs
+++ b/crates/initiative/src/outbound/pg_initiative_repo/test/toolset/reads.rs
@@ -12,6 +12,14 @@ impl InitiativeResources for VisibleResources {
fn initialize(&self, _: InitiativeId) -> ResourceFuture<'_, ()> {
panic!("read-only fixture")
}
+ fn set_initial_properties(
+ &self,
+ _: MacroUserIdStr<'static>,
+ _: InitiativeId,
+ _: Vec<crate::domain::models::InitialPropertyValue>,
+ ) -> ResourceFuture<'_, ()> {
+ panic!("read-only fixture")
+ }
fn purge(&self, _: EntityAccessReceipt<EditAccessLevel>) -> ResourceFuture<'_, ()> {
panic!("read-only fixture")
}
diff --git a/crates/initiative/src/outbound/resources.rs b/crates/initiative/src/outbound/resources.rs
index 8736ab72e0..51cb04d920 100644
--- a/crates/initiative/src/outbound/resources.rs
+++ b/crates/initiative/src/outbound/resources.rs
@@ -3,17 +3,18 @@
use entity_access::domain::{
models::{
AccessError, AccessLevel, BotAccessScope, BotReceiptScope, EditAccessLevel, Entity,
- EntityAccessAuth, EntityAccessReceipt, EntityPermission, ViewAccessLevel,
+ EntityAccessAuth, EntityAccessReceipt, EntityPermission, EntityType, ViewAccessLevel,
},
ports::EntityAccessService,
};
+use macro_user_id::user_id::MacroUserIdStr;
use models_properties::service::property_value::PropertyValue;
-use properties::PropertiesService;
+use properties::{PropertiesErr, PropertiesService};
use std::{collections::HashMap, sync::Arc};
use system_properties::{StatusOption, SystemPropertiesService, SystemPropertyKey};
use crate::domain::{
- models::{InitiativeError, InitiativeId},
+ models::{InitialPropertyValue, InitiativeError, InitiativeId},
reads::InitiativePropertySnapshot,
resources::{InitiativeResources, ResourceFuture},
};
@@ -53,6 +54,66 @@ impl<P: PropertiesService, S: SystemPropertiesService, A: EntityAccessService> I
.map_err(|error| InitiativeError::Internal(rootcause::report!(error).into()))
})
}
+ fn set_initial_properties(
+ &self,
+ owner: MacroUserIdStr<'static>,
+ id: InitiativeId,
+ values: Vec<InitialPropertyValue>,
+ ) -> ResourceFuture<'_, ()> {
+ Box::pin(async move {
+ if values.is_empty() {
+ return Ok(());
+ }
+ // The same edit capability the owner's own property writes carry, so
+ // validation, side effects and attribution match a later edit.
+ let receipt = self
+ .access
+ .generate_entity_access_receipt::<EditAccessLevel>(
+ &owner,
+ None,
+ &id.to_string(),
+ EntityType::Initiative,
+ )
+ .await
+ .map_err(|error| InitiativeError::Internal(rootcause::report!(error).into()))?;
+ for InitialPropertyValue {
+ property_definition_id,
+ value,
+ } in values
+ {
+ if let Err(error) = self
+ .properties
+ .set_entity_property(&receipt, property_definition_id, Some(value))
+ .await
+ {
+ // The caller deletes the initiative; values already written go with it.
+ // Like the delete path, the cleanup is internal rather than an owner
+ // edit, so a rejected create records no activity.
+ let cleanup = EntityAccessReceipt::<EditAccessLevel>::try_new(
+ EntityAccessAuth::Internal,
+ receipt.entity().clone(),
+ EntityPermission::AccessLevel {
+ access_level: AccessLevel::Owner,
+ },
+ );
+ match cleanup {
+ Ok(cleanup) => {
+ if let Err(cleanup) =
+ self.properties.delete_entity_properties(&cleanup).await
+ {
+ tracing::error!(error = ?cleanup, %id, "failed to remove initial properties");
+ }
+ }
+ Err(cleanup) => {
+ tracing::error!(error = ?cleanup, %id, "failed to remove initial properties");
+ }
+ }
+ return Err(initial_property_error(error));
+ }
+ }
+ Ok(())
+ })
+ }
fn purge(&self, receipt: EntityAccessReceipt<EditAccessLevel>) -> ResourceFuture<'_, ()> {
Box::pin(async move {
self.properties
@@ -190,3 +251,17 @@ impl<P: PropertiesService, S: SystemPropertiesService, A: EntityAccessService> I
})
}
}
+
+/// Rejected values are the caller's to fix; anything else is an internal failure.
+fn initial_property_error(error: PropertiesErr) -> InitiativeError {
+ match error {
+ PropertiesErr::Validation(_)
+ | PropertiesErr::NotFound
+ | PropertiesErr::OptionNotFound
+ | PropertiesErr::PermissionDenied
+ | PropertiesErr::SystemPropertyNotModifiable
+ | PropertiesErr::TeamMembershipRequired
+ | PropertiesErr::ManagedDefinition => InitiativeError::BadRequest(error.to_string()),
+ error => InitiativeError::Internal(rootcause::report!(error).into()),
+ }
+}
diff --git a/docs/AGENT_GUIDE/tasks.md b/docs/AGENT_GUIDE/tasks.md
index 239c10cccc..2e395de960 100644
--- a/docs/AGENT_GUIDE/tasks.md
+++ b/docs/AGENT_GUIDE/tasks.md
@@ -158,12 +158,16 @@ previous status catalog remain visible until an editor changes them.
Submit with
`Create Project` or Cmd/Ctrl+Enter. `Continue editing in split` preserves the
name, properties, and sharing choice; `Clear Draft` resets an uncreated draft.
-Leaving a property unset keeps its normal server default. If creation succeeds
-but a property write fails, `Retry saving properties` finishes the existing
-project, including after continuing in a split, without creating a duplicate.
-Closing the popover keeps the underlying view open. Creating from the popover
-opens the project in another split; creating from a full composer replaces that
-composer with the project.
+Leaving a property unset keeps its normal server default.
+Submitting closes the composer at once; a full composer returns its split to
+Projects, and Back skips the submitted composer. One request creates the project
+together with its selected properties: a value the server rejects fails the whole
+create, so no half-configured project is left behind. When the server answers, a
+`Project created` toast offers `Open` and `Open (New Split)` (on touch devices
+both open in place); nothing navigates on its own. The Projects list then
+refreshes in the background to include the new row. If creation fails, the
+composer reopens as a popover with the draft and the error.
+Closing the popover without submitting keeps the underlying view open.
Opening a project keeps the Tasks workspace and its navigation. The top bar
shows the Projects return breadcrumb and the project name, with the same Share
diff --git a/packages/sdk/generated/storage/index.ts b/packages/sdk/generated/storage/index.ts
index ce94599767..d761e564a1 100644
--- a/packages/sdk/generated/storage/index.ts
+++ b/packages/sdk/generated/storage/index.ts
@@ -1,4 +1,4 @@
// This file is auto-generated by @hey-api/openapi-ts
export { type Options, Sdk } from './sdk.gen';
-export type { AccessLevel, ActiveCallsResponse, ActiveCallSummary, ActiveMeeting, ActiveMeetingsResponse, ActivityType, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentMcpServer, AgentMcpServers, AgentPullRequestState, AgentSessionFilters, AgentSessionLifecycleEvent, Anchor, AnchorId, AnchorResponse, AnnotationIncrementalUpdate, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelParticipant, ApiChannelWithLatest, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AssignInitiativeTasksData, AssignInitiativeTasksError, AssignInitiativeTasksErrors, AssignInitiativeTasksResponse, AssignInitiativeTasksResponses, AssignTasksRequest, AssignTasksResponse, AssignTasksResult, AssignTaskStatus, AttachmentChange, AttendeeResponseStatus, BasicDocument, BasicDocumentSubType, BomPart, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotOwnerProfile, BotSenderProfile, BotToken, BranchNameResponse, BTreeMap, BulkWakeupRequest, BulkWakeupResponse, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponse, BulkWakeupSyncServiceDocumentsResponses, CalendarAttendee, CalendarEvent, CalendarEventFilters, CalendarEventSourceContent, CalendarMentionEvent, CalendarMentionPreviewItem, CalendarMentionPreviewKind, CalendarMentionPreviewRequest, CalendarMentionPreviewRequestItem, CalendarMentionPreviewResponse, CalendarOccurrence, CalendarOccurrenceItem, CalendarOccurrenceResponse, CalendarSyncStatus, CallActiveResponse, CallFilters, CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelsList, ChannelMessage, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollabSurfaceResponse, CollabSurfaceTokenResponse, CommandFailure, CommandRejectedMetadata, ConferenceProvider, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CountedReaction, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotRequest, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelError, CreateChannelLabelErrors, CreateChannelLabelRequest, CreateChannelLabelResponse, CreateChannelLabelResponses, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateInitiativeData, CreateInitiativeError, CreateInitiativeErrors, CreateInitiativeRequest, CreateInitiativeResponse, CreateInitiativeResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreateMeetingRequest, CreatePairingRequest, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateReminderData, CreateReminderError, CreateReminderErrors, CreateReminderRequest, CreateReminderResponse, CreateReminderResponses, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CustomSpeakerAssignment, DataType, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeError, DeleteInitiativeErrors, DeleteInitiativeResponse, DeleteInitiativeResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderError, DeleteReminderErrors, DeleteReminderResponse, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DescriptionDocumentId, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentId, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentSyncEditor, DocumentTeamShareResponse, DocumentTopicEvent, DocumentUpdatedMetadata, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmailFollowup, EmailFollowupCommand, EmailFollowupResponse, EmailReminderCondition, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EntityFilters, EntityMessageCreateData, EntityMessageCreateResponse, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponse, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponse, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponse, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponse, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponse, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponse, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponse, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponse, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponse, EntityMessageTypingResponses, EntityPermission, EntityPermissionResponse, EntityReference, EntityType, ErrorResponse, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, Favorite, FavoriteEntityRef, FavoritesList, FileSystemNodeWithIds, FileType, FileTypeUpdate, FolderItem, FollowupState, ForeignEntity, ForeignEntityFilters, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetBotOwnerProfilesData, GetBotOwnerProfilesError, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponse, GetBotOwnerProfilesResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEmailFollowupData, GetEmailFollowupError, GetEmailFollowupErrors, GetEmailFollowupResponse, GetEmailFollowupResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceError, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponse, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeError, GetInitiativeErrors, GetInitiativeResponse, GetInitiativeResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetReminderData, GetReminderError, GetReminderErrors, GetReminderResponse, GetReminderResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubPullRequest, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestsResponse, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, GuestId, GuestJoinRequest, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, ImportedAuthor, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, LatestMessage, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListChannelLabelsData, ListChannelLabelsError, ListChannelLabelsErrors, ListChannelLabelsResponse, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesError, ListInitiativesErrors, ListInitiativesResponse, ListInitiativesResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListRemindersData, ListRemindersError, ListRemindersErrors, ListRemindersResponse, ListRemindersResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, Meeting, MeetingCancelData, MeetingCancelError, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationError, MeetingCancelPreparationErrors, MeetingCancelPreparationResponse, MeetingCancelPreparationResponses, MeetingCancelResponse, MeetingCancelResponses, MeetingCreateData, MeetingCreateError, MeetingCreateErrors, MeetingCreateResponse, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinError, MeetingGuestJoinErrors, MeetingGuestJoinResponse, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsError, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponse, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteError, MeetingInviteErrors, MeetingInvitePermissions, MeetingInvitePermissionsData, MeetingInvitePermissionsError, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponse, MeetingInvitePermissionsResponses, MeetingInviteResponse, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersError, MeetingInviteUsersErrors, MeetingInviteUsersResponse, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinError, MeetingJoinErrors, MeetingJoinResponse, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveError, MeetingLeaveErrors, MeetingLeaveResponse, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveError, MeetingListActiveErrors, MeetingListActiveResponse, MeetingListActiveResponses, MeetingListData, MeetingListError, MeetingListErrors, MeetingListResponse, MeetingListResponses, MeetingLookupData, MeetingLookupError, MeetingLookupErrors, MeetingLookupResponse, MeetingLookupResponses, MeetingParticipant, MeetingParticipants, MeetingParticipantsData, MeetingParticipantsError, MeetingParticipantsErrors, MeetingParticipantsResponse, MeetingParticipantsResponses, MeetingPreparation, MeetingPrepareData, MeetingPrepareError, MeetingPrepareErrors, MeetingPrepareResponse, MeetingPrepareResponses, MeetingShareData, MeetingShareError, MeetingShareErrors, MeetingShareResponse, MeetingShareResponses, MeetingsResponse, MeetingToken, MeetingUpdateData, MeetingUpdateError, MeetingUpdateErrors, MeetingUpdateResponse, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Message, MessageAttachment, MessageAttachmentCreatedMetadata, MessageAttachmentRemovedMetadata, MessageChange, MessageCursor, MessageDeletedMetadata, MessageDirection, MessageEvent, MessageEventAttachment, MessageListItem, MessageMentionedMetadata, MessagePage, MessageParent, MessagePatch, MessagePatchedMetadata, MessagePostedMetadata, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, MessageTopicEvent, NewAttachment, NewThreadAnchor, NotificationFilters, NotificationState, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageNotificationPolicy, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageNotificationPolicy, PostSoupAstRequest, PostSoupRequest, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyDefinition, PropertyFilter, PropertyInput, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, Reminder, ReminderFilters, ReminderSchedule, RemindersList, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelError, RenameChannelLabelErrors, RenameChannelLabelRequest, RenameChannelLabelResponse, RenameChannelLabelResponses, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestedHarnessScope, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, S3ObjectInfo, SaveBomPart, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SessionDeletedMetadata, SessionIdentity, SessionMentionedMetadata, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionStoppedMetadata, SetChannelLabelData, SetChannelLabelError, SetChannelLabelErrors, SetChannelLabelRequest, SetChannelLabelResponse, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureError, SetChannelPictureErrors, SetChannelPictureRequest, SetChannelPictureResponse, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupError, SetEmailFollowupErrors, SetEmailFollowupResponse, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetPropertyValue, SharedEmailFilter, SharePermissionV2, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SmartTagChannelMatch, SmartTagPreview, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmDomain, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupReminderReference, SoupReminderSchedule, SoupReminderSoupPropertiesField, SoupThreadInfo, SoupThreadReply, StarterDocumentsResponse, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, TagFilterMode, TaskFilters, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadState, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingInput, UnassignInitiativeTaskData, UnassignInitiativeTaskError, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponse, UnassignInitiativeTaskResponses, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmTeamSettingsRequest, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateReminderData, UpdateReminderError, UpdateReminderErrors, UpdateReminderRequest, UpdateReminderResponse, UpdateReminderResponses, UpdateSharePermissionRequestV2, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, View, ViewPatch, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';
+export type { AccessLevel, ActiveCallsResponse, ActiveCallSummary, ActiveMeeting, ActiveMeetingsResponse, ActivityType, AddFavoriteData, AddFavoriteError, AddFavoriteErrors, AddFavoriteRequest, AddFavoriteResponse, AddFavoriteResponses, AddParticipantsData, AddParticipantsError, AddParticipantsErrors, AddParticipantsRequest, AddParticipantsResponses, AddPinHandlerData, AddPinHandlerError, AddPinHandlerErrors, AddPinHandlerResponse, AddPinHandlerResponses, AddPinRequest, Agent, AgentActionId, AgentChannelScope, AgentMcpServer, AgentMcpServers, AgentPullRequestState, AgentSessionFilters, AgentSessionLifecycleEvent, Anchor, AnchorId, AnchorResponse, AnnotationIncrementalUpdate, ApiActivity, ApiAttachmentChannelReference, ApiAttachmentEntityReference, ApiAttachmentGenericReference, ApiChannelAttachment, ApiChannelAttachmentsPage, ApiChannelDetail, ApiChannelListMessage, ApiChannelListPage, ApiChannelListParticipant, ApiChannelListType, ApiChannelParticipant, ApiChannelWithLatest, ApiEntityFilterAst, ApiGroupByField, ApiGroupMeta, ApiParticipantListRole, ApiParticipantRole, ApiPropertyEntityType, ApproveHarnessPairingData, ApproveHarnessPairingError, ApproveHarnessPairingErrors, ApproveHarnessPairingResponse, ApproveHarnessPairingResponses, ApprovePairingRequest, AssignInitiativeTasksData, AssignInitiativeTasksError, AssignInitiativeTasksErrors, AssignInitiativeTasksResponse, AssignInitiativeTasksResponses, AssignTasksRequest, AssignTasksResponse, AssignTasksResult, AssignTaskStatus, AttachmentChange, AttendeeResponseStatus, BasicDocument, BasicDocumentSubType, BomPart, Bot, BotChannel, BotChannelType, BotId, BotKind, BotOwner, BotOwnerProfile, BotSenderProfile, BotToken, BranchNameResponse, BTreeMap, BulkWakeupRequest, BulkWakeupResponse, BulkWakeupSyncServiceDocumentsData, BulkWakeupSyncServiceDocumentsErrors, BulkWakeupSyncServiceDocumentsResponse, BulkWakeupSyncServiceDocumentsResponses, CalendarAttendee, CalendarEvent, CalendarEventFilters, CalendarEventSourceContent, CalendarMentionEvent, CalendarMentionPreviewItem, CalendarMentionPreviewKind, CalendarMentionPreviewRequest, CalendarMentionPreviewRequestItem, CalendarMentionPreviewResponse, CalendarOccurrence, CalendarOccurrenceItem, CalendarOccurrenceResponse, CalendarSyncStatus, CallActiveResponse, CallFilters, CallRecord, CallRecordGuest, CallRecordParticipant, CallRecordPreview, CallRecordPreviewData, CallRecordTranscriptSegment, CallStatus, CallTokenResponse, CallWebhookData, CallWebhookError, CallWebhookErrors, CallWebhookResponses, Channel, ChannelCreatedMetadata, ChannelDeletedMetadata, ChannelFilters, ChannelJoinCodeResponse, ChannelLabel, ChannelLabelRule, ChannelLabelsList, ChannelMessage, ChannelParticipant, ChannelParticipantAddedMetadata, ChannelParticipantRemovedMetadata, ChannelPreview, ChannelPreviewData, ChannelSender, ChannelSharePermission, ChannelThreadFilters, ChannelTopicEvent, ChannelType, ChannelUpdatedMetadata, ChannelWebhookRequest, ChannelWebhookResponse, ChannelWithParticipants, Chat, ChatFilters, CheckActiveCallData, CheckActiveCallError, CheckActiveCallErrors, CheckActiveCallResponse, CheckActiveCallResponses, ClaimedPairing, ClaimHarnessPairingData, ClaimHarnessPairingError, ClaimHarnessPairingErrors, ClaimHarnessPairingResponse, ClaimHarnessPairingResponses, ClaimPairingRequest, ClientOptions, CloudStorageItemType, CollabSurfaceResponse, CollabSurfaceTokenResponse, CommandFailure, CommandRejectedMetadata, ConferenceProvider, CopyDocumentData, CopyDocumentError, CopyDocumentErrors, CopyDocumentQueryParams, CopyDocumentRequest, CopyDocumentResponse, CopyDocumentResponse2, CopyDocumentResponses, CountedReaction, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentRequest, CreateAgentResponse, CreateAgentResponses, CreateAnchorData, CreateAnchorError, CreateAnchorErrors, CreateAnchorResponse, CreateAnchorResponses, CreateBotRequest, CreateBulkDocumentResponse, CreateBulkDocumentResponseData, CreateChannelData, CreateChannelError, CreateChannelErrors, CreateChannelLabelData, CreateChannelLabelError, CreateChannelLabelErrors, CreateChannelLabelRequest, CreateChannelLabelResponse, CreateChannelLabelResponses, CreateChannelRequest, CreateChannelResponse, CreateChannelResponse2, CreateChannelResponses, CreateChannelScopedBotData, CreateChannelScopedBotError, CreateChannelScopedBotErrors, CreateChannelScopedBotRequest, CreateChannelScopedBotResponse, CreateChannelScopedBotResponse2, CreateChannelScopedBotResponses, CreateCollabSurfaceTokenData, CreateCollabSurfaceTokenError, CreateCollabSurfaceTokenErrors, CreateCollabSurfaceTokenResponse, CreateCollabSurfaceTokenResponses, CreateCrmCompanyData, CreateCrmCompanyError, CreateCrmCompanyErrors, CreateCrmCompanyRequest, CreateCrmCompanyResponse, CreateCrmCompanyResponses, CreateCrmContactData, CreateCrmContactError, CreateCrmContactErrors, CreateCrmContactRequest, CreateCrmContactResponse, CreateCrmContactResponses, CreateDocumentData, CreateDocumentError, CreateDocumentErrors, CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData, CreateDocumentResponses, CreatedPairing, CreatedUserApiKey, CreateEntityMentionData, CreateEntityMentionError, CreateEntityMentionErrors, CreateEntityMentionRequest, CreateEntityMentionResponse, CreateEntityMentionResponse2, CreateEntityMentionResponses, CreateHarnessPairingData, CreateHarnessPairingError, CreateHarnessPairingErrors, CreateHarnessPairingResponse, CreateHarnessPairingResponses, CreateInitiativeData, CreateInitiativeError, CreateInitiativeErrors, CreateInitiativeRequest, CreateInitiativeResponse, CreateInitiativeResponses, CreateInstructionsDocumentResponse, CreateInstructionsHandlerData, CreateInstructionsHandlerError, CreateInstructionsHandlerErrors, CreateInstructionsHandlerResponse, CreateInstructionsHandlerResponses, CreateMarkdownDocumentRequest, CreateMarkdownDocumentResponse, CreateMarkdownHandlerData, CreateMarkdownHandlerError, CreateMarkdownHandlerErrors, CreateMarkdownHandlerResponse, CreateMarkdownHandlerResponses, CreateMeetingRequest, CreatePairingRequest, CreateProjectHandlerData, CreateProjectHandlerError, CreateProjectHandlerErrors, CreateProjectHandlerResponse, CreateProjectHandlerResponses, CreateProjectRequest, CreateProjectResponse, CreateReminderData, CreateReminderError, CreateReminderErrors, CreateReminderRequest, CreateReminderResponse, CreateReminderResponses, CreateSkillHandlerData, CreateSkillHandlerError, CreateSkillHandlerErrors, CreateSkillHandlerResponse, CreateSkillHandlerResponses, CreateSkillRequest, CreateSkillResponse, CreateSnippetHandlerData, CreateSnippetHandlerError, CreateSnippetHandlerErrors, CreateSnippetHandlerResponse, CreateSnippetHandlerResponses, CreateSnippetRequest, CreateSnippetResponse, CreateTaskHandlerData, CreateTaskHandlerError, CreateTaskHandlerErrors, CreateTaskHandlerResponse, CreateTaskHandlerResponses, CreateTaskRequest, CreateTaskResponse, CreateUnthreadedAnchorRequest, CreateUnthreadedAnchorResponse, CreateUnthreadedPdfAnchorRequest, CreateUserApiKeyData, CreateUserApiKeyError, CreateUserApiKeyErrors, CreateUserApiKeyRequest, CreateUserApiKeyResponse, CreateUserApiKeyResponses, CreateViewHandlerData, CreateViewHandlerError, CreateViewHandlerErrors, CreateViewHandlerResponse, CreateViewHandlerResponses, CreateViewRequest, CreateWebhookData, CreateWebhookError, CreateWebhookErrors, CreateWebhookRequest, CreateWebhookResponse, CreateWebhookResponse2, CreateWebhookResponses, CrmCompanyFilters, CrmCompanyResponse, CrmContactResponse, CrmDomainResponse, CrmPermissionRole, CrmStageInput, CrmStageResponse, CrmStagesResponse, CrmTeamSettingsResponse, CustomSpeakerAssignment, DataType, DeleteAnchorData, DeleteAnchorError, DeleteAnchorErrors, DeleteAnchorResponse, DeleteAnchorResponses, DeleteCallRecordData, DeleteCallRecordError, DeleteCallRecordErrors, DeleteCallRecordResponse, DeleteCallRecordResponses, DeleteChannelData, DeleteChannelError, DeleteChannelErrors, DeleteChannelLabelData, DeleteChannelLabelError, DeleteChannelLabelErrors, DeleteChannelLabelResponse, DeleteChannelLabelResponses, DeleteChannelResponse, DeleteChannelResponses, DeleteCollabSurfaceData, DeleteCollabSurfaceError, DeleteCollabSurfaceErrors, DeleteCollabSurfaceResponse, DeleteCollabSurfaceResponses, DeleteDocumentData, DeleteDocumentError, DeleteDocumentErrors, DeleteDocumentResponse, DeleteDocumentResponses, DeleteEntityMentionData, DeleteEntityMentionError, DeleteEntityMentionErrors, DeleteEntityMentionResponse, DeleteEntityMentionResponse2, DeleteEntityMentionResponses, DeleteHarnessData, DeleteHarnessError, DeleteHarnessErrors, DeleteHarnessResponse, DeleteHarnessResponses, DeleteHistoryHandlerData, DeleteHistoryHandlerError, DeleteHistoryHandlerErrors, DeleteHistoryHandlerResponse, DeleteHistoryHandlerResponses, DeleteInitiativeData, DeleteInitiativeError, DeleteInitiativeErrors, DeleteInitiativeResponse, DeleteInitiativeResponses, DeleteProjectHandlerData, DeleteProjectHandlerError, DeleteProjectHandlerErrors, DeleteProjectHandlerResponse, DeleteProjectHandlerResponses, DeleteReminderData, DeleteReminderError, DeleteReminderErrors, DeleteReminderResponse, DeleteReminderResponses, DeleteSelfHarnessData, DeleteSelfHarnessError, DeleteSelfHarnessErrors, DeleteSelfHarnessResponse, DeleteSelfHarnessResponses, DeleteUnthreadedAnchorRequest, DeleteUnthreadedAnchorResponse, DeleteUnthreadedPdfAnchorRequest, DeleteUserApiKeyData, DeleteUserApiKeyError, DeleteUserApiKeyErrors, DeleteUserApiKeyResponse, DeleteUserApiKeyResponses, DeleteUserDocumentViewLocationData, DeleteUserDocumentViewLocationError, DeleteUserDocumentViewLocationErrors, DeleteUserDocumentViewLocationResponse, DeleteUserDocumentViewLocationResponses, DeleteViewHandlerData, DeleteViewHandlerError, DeleteViewHandlerErrors, DeleteViewHandlerResponses, DeleteWebhookData, DeleteWebhookError, DeleteWebhookErrors, DeleteWebhookResponse, DeleteWebhookResponses, DescriptionDocumentId, DocumentBasic, DocumentContent, DocumentContentLocation, DocumentContentState, DocumentContentUploadedMetadata, DocumentCopiedMetadata, DocumentCreatedMetadata, DocumentDeletedMetadata, DocumentFilters, DocumentId, DocumentInteractionMetadata, DocumentMetadata, DocumentMetadataWithContent, DocumentPermissionsToken, DocumentPermissionsTokenRequest, DocumentPermissionsTokenResponse, DocumentPreview, DocumentPreviewData, DocumentPreviewDataSubType, DocumentPurgedMetadata, DocumentResponse, DocumentResponseMetadata, DocumentResponseMetadataWithContent, DocumentStorageServiceApiVersion, DocumentSubType, DocumentSyncContentUpdatedMetadata, DocumentSyncEditor, DocumentTeamShareResponse, DocumentTopicEvent, DocumentUpdatedMetadata, EditAnchorData, EditAnchorError, EditAnchorErrors, EditAnchorRequest, EditAnchorResponse, EditAnchorResponse2, EditAnchorResponses, EditCallRecordData, EditCallRecordError, EditCallRecordErrors, EditCallRecordRequest, EditCallRecordResponse, EditCallRecordResponses, EditCallTranscriptData, EditCallTranscriptError, EditCallTranscriptErrors, EditCallTranscriptRequest, EditCallTranscriptResponse, EditCallTranscriptResponses, EditDocumentData, EditDocumentError, EditDocumentErrors, EditDocumentResponse, EditDocumentResponse2, EditDocumentResponses, EditDocumentServiceArgs, EditPdfAnchorRequest, EditPdfPlaceableCommentAnchorRequest, EditProjectV2Data, EditProjectV2Error, EditProjectV2Errors, EditProjectV2Response, EditProjectV2Responses, EditThreadV2Data, EditThreadV2Error, EditThreadV2Errors, EditThreadV2Response, EditThreadV2Responses, EmailFilters, EmailFollowup, EmailFollowupCommand, EmailFollowupResponse, EmailReminderCondition, EmptyResponse, EnsureCollabSurfaceData, EnsureCollabSurfaceError, EnsureCollabSurfaceErrors, EnsureCollabSurfaceRequest, EnsureCollabSurfaceResponse, EnsureCollabSurfaceResponses, EntityFilters, EntityMessageCreateData, EntityMessageCreateResponse, EntityMessageCreateResponses, EntityMessageDeleteMessageData, EntityMessageDeleteMessageResponse, EntityMessageDeleteMessageResponses, EntityMessageDeleteThreadData, EntityMessageDeleteThreadResponse, EntityMessageDeleteThreadResponses, EntityMessageEditData, EntityMessageEditResponse, EntityMessageEditResponses, EntityMessageGetMessageData, EntityMessageGetMessageResponse, EntityMessageGetMessageResponses, EntityMessageGetThreadData, EntityMessageGetThreadResponse, EntityMessageGetThreadResponses, EntityMessageLegacyData, EntityMessageLegacyResponse, EntityMessageLegacyResponses, EntityMessagePatchThreadData, EntityMessagePatchThreadResponse, EntityMessagePatchThreadResponses, EntityMessageReactData, EntityMessageReactResponse, EntityMessageReactResponses, EntityMessageTypingData, EntityMessageTypingResponse, EntityMessageTypingResponses, EntityPermission, EntityPermissionResponse, EntityReference, EntityType, ErrorResponse, EventReminderOverride, EventReminders, EventStatus, EventTime, EventTransparency, EventType, EventVisibility, ExcludedDefaultView, ExcludeDefaultViewHandlerData, ExcludeDefaultViewHandlerError, ExcludeDefaultViewHandlerErrors, ExcludeDefaultViewHandlerResponses, ExcludeDefaultViewRequest, ExportDocumentData, ExportDocumentError, ExportDocumentErrors, ExportDocumentResponse, ExportDocumentResponse2, ExportDocumentResponses, Favorite, FavoriteEntityRef, FavoritesList, FileSystemNodeWithIds, FileType, FileTypeUpdate, FolderItem, FollowupState, ForeignEntity, ForeignEntityFilters, GenericErrorResponse, GenericResponse, GenericSuccessResponse, GetActiveCallsData, GetActiveCallsError, GetActiveCallsErrors, GetActiveCallsResponse, GetActiveCallsResponses, GetActivityData, GetActivityError, GetActivityErrors, GetActivityResponse, GetActivityResponses, GetAttachmentReferencesData, GetAttachmentReferencesError, GetAttachmentReferencesErrors, GetAttachmentReferencesResponse, GetAttachmentReferencesResponse2, GetAttachmentReferencesResponses, GetBatchCallRecordPreviewData, GetBatchCallRecordPreviewError, GetBatchCallRecordPreviewErrors, GetBatchCallRecordPreviewRequest, GetBatchCallRecordPreviewResponse, GetBatchCallRecordPreviewResponse2, GetBatchCallRecordPreviewResponses, GetBatchChannelPreviewData, GetBatchChannelPreviewError, GetBatchChannelPreviewErrors, GetBatchChannelPreviewRequest, GetBatchChannelPreviewResponse, GetBatchChannelPreviewResponse2, GetBatchChannelPreviewResponses, GetBatchPreviewHandlerData, GetBatchPreviewHandlerError, GetBatchPreviewHandlerErrors, GetBatchPreviewHandlerResponse, GetBatchPreviewHandlerResponses, GetBatchPreviewRequest, GetBatchPreviewResponse, GetBatchProjectPreviewData, GetBatchProjectPreviewError, GetBatchProjectPreviewErrors, GetBatchProjectPreviewRequest, GetBatchProjectPreviewResponse, GetBatchProjectPreviewResponse2, GetBatchProjectPreviewResponses, GetBotOwnerProfilesData, GetBotOwnerProfilesError, GetBotOwnerProfilesErrors, GetBotOwnerProfilesResponse, GetBotOwnerProfilesResponses, GetCallRecordData, GetCallRecordError, GetCallRecordErrors, GetCallRecordResponse, GetCallRecordResponses, GetChannelAttachmentsData, GetChannelAttachmentsError, GetChannelAttachmentsErrors, GetChannelAttachmentsResponse, GetChannelAttachmentsResponses, GetChannelData, GetChannelError, GetChannelErrors, GetChannelJoinLinkData, GetChannelJoinLinkError, GetChannelJoinLinkErrors, GetChannelJoinLinkResponse, GetChannelJoinLinkResponses, GetChannelParticipantsData, GetChannelParticipantsError, GetChannelParticipantsErrors, GetChannelParticipantsResponse, GetChannelParticipantsResponses, GetChannelResponse, GetChannelResponses, GetChannelsData, GetChannelsError, GetChannelsErrors, GetChannelsResponse, GetChannelsResponses, GetCollabSurfaceData, GetCollabSurfaceError, GetCollabSurfaceErrors, GetCollabSurfaceResponse, GetCollabSurfaceResponses, GetCompanyData, GetCompanyError, GetCompanyErrors, GetCompanyResponse, GetCompanyResponses, GetContactByEmailData, GetContactByEmailError, GetContactByEmailErrors, GetContactByEmailResponse, GetContactByEmailResponse2, GetContactByEmailResponses, GetContactData, GetContactError, GetContactErrors, GetContactResponse, GetContactResponses, GetCrmTeamSettingsData, GetCrmTeamSettingsError, GetCrmTeamSettingsErrors, GetCrmTeamSettingsResponse, GetCrmTeamSettingsResponses, GetDocumentAnchorsData, GetDocumentAnchorsError, GetDocumentAnchorsErrors, GetDocumentAnchorsResponse, GetDocumentAnchorsResponses, GetDocumentBranchNameData, GetDocumentBranchNameError, GetDocumentBranchNameErrors, GetDocumentBranchNameResponse, GetDocumentBranchNameResponses, GetDocumentByTeamSlugData, GetDocumentByTeamSlugError, GetDocumentByTeamSlugErrors, GetDocumentByTeamSlugResponse, GetDocumentByTeamSlugResponses, GetDocumentData, GetDocumentError, GetDocumentErrors, GetDocumentGithubPullRequestsData, GetDocumentGithubPullRequestsError, GetDocumentGithubPullRequestsErrors, GetDocumentGithubPullRequestsResponse, GetDocumentGithubPullRequestsResponses, GetDocumentKeyResponse, GetDocumentKeyResponseData, GetDocumentListHandlerData, GetDocumentListHandlerError, GetDocumentListHandlerErrors, GetDocumentListHandlerResponse, GetDocumentListHandlerResponses, GetDocumentListResult, GetDocumentLocationV3Data, GetDocumentLocationV3Error, GetDocumentLocationV3Errors, GetDocumentLocationV3Response, GetDocumentLocationV3Responses, GetDocumentPermissionsResponseDataV2, GetDocumentPermissionsTokenData, GetDocumentPermissionsTokenError, GetDocumentPermissionsTokenErrors, GetDocumentPermissionsTokenResponse, GetDocumentPermissionsTokenResponses, GetDocumentPermissionsV2Data, GetDocumentPermissionsV2Error, GetDocumentPermissionsV2Errors, GetDocumentPermissionsV2Response, GetDocumentPermissionsV2Responses, GetDocumentProcessingResult, GetDocumentProcessingResultData, GetDocumentProcessingResultError, GetDocumentProcessingResultErrors, GetDocumentProcessingResultResponse, GetDocumentProcessingResultResponse2, GetDocumentProcessingResultResponses, GetDocumentResponse, GetDocumentResponse2, GetDocumentResponseData, GetDocumentResponses, GetDocumentSearchResponse, GetDocumentShortIdData, GetDocumentShortIdError, GetDocumentShortIdErrors, GetDocumentShortIdResponse, GetDocumentShortIdResponses, GetDocumentsResponse, GetDocumentTeamShareData, GetDocumentTeamShareError, GetDocumentTeamShareErrors, GetDocumentTeamShareResponse, GetDocumentTeamShareResponses, GetDocumentUserAccessLevelResponse, GetDocumentVersionData, GetDocumentVersionError, GetDocumentVersionErrors, GetDocumentVersionResponse, GetDocumentVersionResponses, GetDocumentViewsHandlerData, GetDocumentViewsHandlerError, GetDocumentViewsHandlerErrors, GetDocumentViewsHandlerResponse, GetDocumentViewsHandlerResponses, GetEmailFollowupData, GetEmailFollowupError, GetEmailFollowupErrors, GetEmailFollowupResponse, GetEmailFollowupResponses, GetEntityPermissionData, GetEntityPermissionErrors, GetEntityPermissionResponse, GetEntityPermissionResponses, GetForeignEntityBySourceData, GetForeignEntityBySourceError, GetForeignEntityBySourceErrors, GetForeignEntityBySourceResponse, GetForeignEntityBySourceResponses, GetForeignEntityData, GetForeignEntityError, GetForeignEntityErrors, GetForeignEntityResponse, GetForeignEntityResponses, GetHarnessPairingData, GetHarnessPairingError, GetHarnessPairingErrors, GetHarnessPairingResponse, GetHarnessPairingResponses, GetHistoryHandlerData, GetHistoryHandlerError, GetHistoryHandlerErrors, GetHistoryHandlerResponse, GetHistoryHandlerResponses, GetInitiativeData, GetInitiativeError, GetInitiativeErrors, GetInitiativeResponse, GetInitiativeResponses, GetInstructionsDocumentResponse, GetInstructionsHandlerData, GetInstructionsHandlerError, GetInstructionsHandlerErrors, GetInstructionsHandlerResponse, GetInstructionsHandlerResponses, GetItemsSoupData, GetItemsSoupError, GetItemsSoupErrors, GetItemsSoupResponse, GetItemsSoupResponses, GetLocationHandlerData, GetLocationHandlerError, GetLocationHandlerErrors, GetLocationHandlerResponse, GetLocationHandlerResponses, GetOrCreateAction, GetOrCreateCallData, GetOrCreateCallError, GetOrCreateCallErrors, GetOrCreateCallResponse, GetOrCreateCallResponses, GetOrCreateChannelResponse, GetOrCreateDmData, GetOrCreateDmError, GetOrCreateDmErrors, GetOrCreateDmRequest, GetOrCreateDmResponse, GetOrCreateDmResponses, GetOrCreatePrivateData, GetOrCreatePrivateError, GetOrCreatePrivateErrors, GetOrCreatePrivateRequest, GetOrCreatePrivateResponse, GetOrCreatePrivateResponses, GetPendingProjectsHandlerData, GetPendingProjectsHandlerError, GetPendingProjectsHandlerErrors, GetPendingProjectsHandlerResponse, GetPendingProjectsHandlerResponses, GetPinsHandlerData, GetPinsHandlerError, GetPinsHandlerErrors, GetPinsHandlerResponse, GetPinsHandlerResponses, GetPinsResponse, GetProjectContentHandlerData, GetProjectContentHandlerError, GetProjectContentHandlerErrors, GetProjectContentHandlerResponse, GetProjectContentHandlerResponses, GetProjectContentResponse, GetProjectHandlerData, GetProjectHandlerError, GetProjectHandlerErrors, GetProjectHandlerResponse, GetProjectHandlerResponses, GetProjectPermissionsV2Data, GetProjectPermissionsV2Error, GetProjectPermissionsV2Errors, GetProjectPermissionsV2Response, GetProjectPermissionsV2Responses, GetProjectResponse, GetProjectResponseData, GetProjectsHandlerData, GetProjectsHandlerError, GetProjectsHandlerErrors, GetProjectsHandlerResponse, GetProjectsHandlerResponses, GetProjectsResponse, GetProjectUserAccessLevelData, GetProjectUserAccessLevelError, GetProjectUserAccessLevelErrors, GetProjectUserAccessLevelResponse, GetProjectUserAccessLevelResponses, GetReminderData, GetReminderError, GetReminderErrors, GetReminderResponse, GetReminderResponses, GetRingStatusData, GetRingStatusError, GetRingStatusErrors, GetRingStatusResponse, GetRingStatusResponses, GetSelfBotData, GetSelfBotError, GetSelfBotErrors, GetSelfBotResponse, GetSelfBotResponses, GetSelfHarnessData, GetSelfHarnessError, GetSelfHarnessErrors, GetSelfHarnessResponse, GetSelfHarnessResponses, GetSystemSkillsHandlerData, GetSystemSkillsHandlerError, GetSystemSkillsHandlerErrors, GetSystemSkillsHandlerResponse, GetSystemSkillsHandlerResponses, GetUserDocumentsHandlerData, GetUserDocumentsHandlerError, GetUserDocumentsHandlerErrors, GetUserDocumentsHandlerResponse, GetUserDocumentsHandlerResponses, GetUserDocumentViewLocationData, GetUserDocumentViewLocationError, GetUserDocumentViewLocationErrors, GetUserDocumentViewLocationResponse, GetUserDocumentViewLocationResponses, GetUserHistoryResponse, GetViewsHandlerData, GetViewsHandlerError, GetViewsHandlerErrors, GetViewsHandlerResponse, GetViewsHandlerResponses, GetWebhookData, GetWebhookError, GetWebhookErrors, GetWebhookResponse, GetWebhookResponses, GithubPullRequest, GithubPullRequestCheckRun, GithubPullRequestComment, GithubPullRequestsResponse, GroupedInitialParams, GroupedPageParams, GroupedSoupGroupPage, GroupedSoupInitialPage, GroupedSoupPage, GroupedSoupSort, GuestId, GuestJoinRequest, HandlerData, HandlerError, HandlerErrors, HandlerResponse, HandlerResponses, Harness, HarnessAgent, HarnessId, HarnessOwner, HarnessSession, HashMap, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, HighlightType, ImportedAuthor, InFlightTurnSummary, IngestTranscriptData, IngestTranscriptError, IngestTranscriptErrors, IngestTranscriptResponses, InitializeUserDocumentsData, InitializeUserDocumentsError, InitializeUserDocumentsErrors, InitializeUserDocumentsResponse, InitializeUserDocumentsResponses, InitialPropertyValue, InitiativeDetail, InitiativeFilters, InitiativeId, InitiativeList, InitiativeSummary, InputReceivedMetadata, InstallSyncData, InstallSyncErrors, InteractionReason, InviteMeetingRequest, InviteMeetingUsersRequest, Item, ItemWithUserAccessLevel, JobProcessingResultHandlerData, JobProcessingResultHandlerError, JobProcessingResultHandlerErrors, JobProcessingResultHandlerResponse, JobProcessingResultHandlerResponses, JoinChannelByCodeData, JoinChannelByCodeError, JoinChannelByCodeErrors, JoinChannelByCodeResponses, JoinChannelData, JoinChannelError, JoinChannelErrors, JoinChannelResponses, LatestMessage, LeaveCallResponse, LeaveChannelData, LeaveChannelError, LeaveChannelErrors, LeaveChannelResponses, LeaveOrEndCallData, LeaveOrEndCallError, LeaveOrEndCallErrors, LeaveOrEndCallResponse, LeaveOrEndCallResponses, LinkShare, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListBotChannelsData, ListBotChannelsError, ListBotChannelsErrors, ListBotChannelsResponse, ListBotChannelsResponses, ListChannelLabelsData, ListChannelLabelsError, ListChannelLabelsErrors, ListChannelLabelsResponse, ListChannelLabelsResponses, ListCompanyContactsData, ListCompanyContactsError, ListCompanyContactsErrors, ListCompanyContactsResponse, ListCompanyContactsResponses, ListFavoritesData, ListFavoritesError, ListFavoritesErrors, ListFavoritesResponse, ListFavoritesResponses, ListHarnessAgentsData, ListHarnessAgentsError, ListHarnessAgentsErrors, ListHarnessAgentsResponse, ListHarnessAgentsResponses, ListHarnessesData, ListHarnessesError, ListHarnessesErrors, ListHarnessesResponse, ListHarnessesResponses, ListHarnessSessionsData, ListHarnessSessionsError, ListHarnessSessionsErrors, ListHarnessSessionsResponse, ListHarnessSessionsResponses, ListInitiativesData, ListInitiativesError, ListInitiativesErrors, ListInitiativesResponse, ListInitiativesResponses, ListOccurrencesData, ListOccurrencesErrors, ListOccurrencesResponse, ListOccurrencesResponses, ListRemindersData, ListRemindersError, ListRemindersErrors, ListRemindersResponse, ListRemindersResponses, ListTeamOutOfOfficeData, ListTeamOutOfOfficeErrors, ListTeamOutOfOfficeResponse, ListTeamOutOfOfficeResponses, ListUserApiKeysData, ListUserApiKeysError, ListUserApiKeysErrors, ListUserApiKeysResponse, ListUserApiKeysResponses, ListWebhooksData, ListWebhooksError, ListWebhooksErrors, ListWebhooksResponse, ListWebhooksResponse2, ListWebhooksResponses, LocationResponseData, LocationResponseV3, MacroUserIdStr, Meeting, MeetingCancelData, MeetingCancelError, MeetingCancelErrors, MeetingCancelPreparationData, MeetingCancelPreparationError, MeetingCancelPreparationErrors, MeetingCancelPreparationResponse, MeetingCancelPreparationResponses, MeetingCancelResponse, MeetingCancelResponses, MeetingCreateData, MeetingCreateError, MeetingCreateErrors, MeetingCreateResponse, MeetingCreateResponses, MeetingGuestJoinData, MeetingGuestJoinError, MeetingGuestJoinErrors, MeetingGuestJoinResponse, MeetingGuestJoinResponses, MeetingGuestParticipantsData, MeetingGuestParticipantsError, MeetingGuestParticipantsErrors, MeetingGuestParticipantsResponse, MeetingGuestParticipantsResponses, MeetingInviteData, MeetingInviteError, MeetingInviteErrors, MeetingInvitePermissions, MeetingInvitePermissionsData, MeetingInvitePermissionsError, MeetingInvitePermissionsErrors, MeetingInvitePermissionsResponse, MeetingInvitePermissionsResponses, MeetingInviteResponse, MeetingInviteResponses, MeetingInviteUsersData, MeetingInviteUsersError, MeetingInviteUsersErrors, MeetingInviteUsersResponse, MeetingInviteUsersResponses, MeetingJoinData, MeetingJoinError, MeetingJoinErrors, MeetingJoinResponse, MeetingJoinResponses, MeetingLeaveData, MeetingLeaveError, MeetingLeaveErrors, MeetingLeaveResponse, MeetingLeaveResponses, MeetingListActiveData, MeetingListActiveError, MeetingListActiveErrors, MeetingListActiveResponse, MeetingListActiveResponses, MeetingListData, MeetingListError, MeetingListErrors, MeetingListResponse, MeetingListResponses, MeetingLookupData, MeetingLookupError, MeetingLookupErrors, MeetingLookupResponse, MeetingLookupResponses, MeetingParticipant, MeetingParticipants, MeetingParticipantsData, MeetingParticipantsError, MeetingParticipantsErrors, MeetingParticipantsResponse, MeetingParticipantsResponses, MeetingPreparation, MeetingPrepareData, MeetingPrepareError, MeetingPrepareErrors, MeetingPrepareResponse, MeetingPrepareResponses, MeetingShareData, MeetingShareError, MeetingShareErrors, MeetingShareResponse, MeetingShareResponses, MeetingsResponse, MeetingToken, MeetingUpdateData, MeetingUpdateError, MeetingUpdateErrors, MeetingUpdateResponse, MeetingUpdateResponses, MentionPreviewsData, MentionPreviewsErrors, MentionPreviewsResponse, MentionPreviewsResponses, Message, MessageAttachment, MessageAttachmentCreatedMetadata, MessageAttachmentRemovedMetadata, MessageChange, MessageCursor, MessageDeletedMetadata, MessageDirection, MessageEvent, MessageEventAttachment, MessageListItem, MessageMentionedMetadata, MessagePage, MessageParent, MessagePatch, MessagePatchedMetadata, MessagePostedMetadata, MessageThread, MessageThreadPreview, MessageTimelineData, MessageTimelineQuery, MessageTimelineResponse, MessageTimelineResponses, MessageTopicEvent, NewAttachment, NewThreadAnchor, NotificationFilters, NotificationState, PairingDetails, Params, ParticipantRole, PatchBotRequest, PatchChannelData, PatchChannelError, PatchChannelErrors, PatchChannelRequest, PatchChannelResponse, PatchChannelResponses, PatchMessageNotificationPolicy, PatchProjectRequestV2, PatchThreadRequestV2, PatchViewHandlerData, PatchViewHandlerError, PatchViewHandlerErrors, PatchViewHandlerResponses, PatchWebhookData, PatchWebhookError, PatchWebhookErrors, PatchWebhookRequest, PatchWebhookResponse, PatchWebhookResponses, PdfAnchor, PdfAnchorId, PdfHighlightAnchor, PdfHighlightAnchorRequest, PdfHighlightRect, PdfHighlightRectAnchorRequest, PdfPlaceableCommentAnchor, PendingClaimResponse, PermanentlyDeleteDocumentData, PermanentlyDeleteDocumentError, PermanentlyDeleteDocumentErrors, PermanentlyDeleteDocumentResponse, PermanentlyDeleteDocumentResponses, PermanentlyDeleteProjectData, PermanentlyDeleteProjectError, PermanentlyDeleteProjectErrors, PermanentlyDeleteProjectResponse, PermanentlyDeleteProjectResponses, PinnedItem, PinRequest, PostActivityData, PostActivityError, PostActivityErrors, PostActivityRequest, PostActivityResponse, PostActivityResponses, PostChannelBotWebhookData, PostChannelBotWebhookError, PostChannelBotWebhookErrors, PostChannelBotWebhookResponse, PostChannelBotWebhookResponses, PostGroupedSoupAstGroupPageRequest, PostGroupedSoupAstInitialRequest, PostGroupedSoupAstRequest, PostItemsSoupAstData, PostItemsSoupAstError, PostItemsSoupAstErrors, PostItemsSoupAstGroupedData, PostItemsSoupAstGroupedError, PostItemsSoupAstGroupedErrors, PostItemsSoupAstGroupedResponse, PostItemsSoupAstGroupedResponses, PostItemsSoupAstResponse, PostItemsSoupAstResponses, PostItemsSoupData, PostItemsSoupError, PostItemsSoupErrors, PostItemsSoupResponse, PostItemsSoupResponses, PostMessage, PostMessageNotificationPolicy, PostSoupAstRequest, PostSoupRequest, PresaveDocumentHandlerData, PresaveDocumentHandlerError, PresaveDocumentHandlerErrors, PresaveDocumentHandlerResponse, PresaveDocumentHandlerResponses, PreSaveDocumentRequest, PreSaveDocumentResponse, PreSaveDocumentResponseData, PresignedUrl, PreviewSmartTagData, PreviewSmartTagError, PreviewSmartTagErrors, PreviewSmartTagResponse, PreviewSmartTagResponses, Project, ProjectDeleteResponseData, ProjectDocumentStatus, ProjectFilters, ProjectPreview, ProjectPreviewData, PropertyDefinition, PropertyFilter, PropertyInput, PropertyOwner, PropertyValue, PutCrmTeamSettingsData, PutCrmTeamSettingsError, PutCrmTeamSettingsErrors, PutCrmTeamSettingsResponse, PutCrmTeamSettingsResponses, PutCrmTeamStagesData, PutCrmTeamStagesError, PutCrmTeamStagesErrors, PutCrmTeamStagesResponse, PutCrmTeamStagesResponses, ReactionInput, RecentlyDeletedData, RecentlyDeletedError, RecentlyDeletedErrors, RecentlyDeletedResponse, RecentlyDeletedResponseData, RecentlyDeletedResponses, Reminder, ReminderFilters, ReminderSchedule, RemindersList, RemoveBotFromChannelByBotData, RemoveBotFromChannelByBotError, RemoveBotFromChannelByBotErrors, RemoveBotFromChannelByBotResponse, RemoveBotFromChannelByBotResponses, RemoveFavoriteByEntityData, RemoveFavoriteByEntityError, RemoveFavoriteByEntityErrors, RemoveFavoriteByEntityResponses, RemoveParticipantsData, RemoveParticipantsError, RemoveParticipantsErrors, RemoveParticipantsRequest, RemoveParticipantsResponses, RemovePinHandlerData, RemovePinHandlerError, RemovePinHandlerErrors, RemovePinHandlerResponse, RemovePinHandlerResponses, RenameChannelLabelData, RenameChannelLabelError, RenameChannelLabelErrors, RenameChannelLabelRequest, RenameChannelLabelResponse, RenameChannelLabelResponses, ReorderFavoritesData, ReorderFavoritesError, ReorderFavoritesErrors, ReorderFavoritesRequest, ReorderFavoritesResponses, ReorderPinRequest, ReorderPinsHandlerData, ReorderPinsHandlerError, ReorderPinsHandlerErrors, ReorderPinsHandlerResponse, ReorderPinsHandlerResponses, ReplaceCrmStagesRequest, RequestedHarnessScope, ResetCrmTeamStagesData, ResetCrmTeamStagesError, ResetCrmTeamStagesErrors, ResetCrmTeamStagesResponse, ResetCrmTeamStagesResponses, RevertDeleteDocumentData, RevertDeleteDocumentError, RevertDeleteDocumentErrors, RevertDeleteDocumentResponse, RevertDeleteDocumentResponses, RevertDeleteProjectData, RevertDeleteProjectError, RevertDeleteProjectErrors, RevertDeleteProjectResponse, RevertDeleteProjectResponses, RingStatus, RingStatusResponse, S3ObjectInfo, SaveBomPart, SaveDocumentHandlerData, SaveDocumentHandlerError, SaveDocumentHandlerErrors, SaveDocumentHandlerResponse, SaveDocumentHandlerResponses, SaveDocumentRequest, SaveDocumentResponse, SaveDocumentResponseData, SessionDeletedMetadata, SessionIdentity, SessionMentionedMetadata, SessionOpenedMetadata, SessionRenamedMetadata, SessionSettledMetadata, SessionStoppedMetadata, SetChannelLabelData, SetChannelLabelError, SetChannelLabelErrors, SetChannelLabelRequest, SetChannelLabelResponse, SetChannelLabelResponses, SetChannelPictureData, SetChannelPictureError, SetChannelPictureErrors, SetChannelPictureRequest, SetChannelPictureResponse, SetChannelPictureResponses, SetCompanyHiddenData, SetCompanyHiddenError, SetCompanyHiddenErrors, SetCompanyHiddenRequest, SetCompanyHiddenResponse, SetCompanyHiddenResponses, SetCompanyNameRequest, SetContactHiddenData, SetContactHiddenError, SetContactHiddenErrors, SetContactHiddenRequest, SetContactHiddenResponse, SetContactHiddenResponses, SetContactNameRequest, SetCrmCompanyNameData, SetCrmCompanyNameError, SetCrmCompanyNameErrors, SetCrmCompanyNameResponse, SetCrmCompanyNameResponses, SetCrmContactNameData, SetCrmContactNameError, SetCrmContactNameErrors, SetCrmContactNameResponse, SetCrmContactNameResponses, SetDocumentTeamShareData, SetDocumentTeamShareError, SetDocumentTeamShareErrors, SetDocumentTeamShareRequest, SetDocumentTeamShareResponse, SetDocumentTeamShareResponses, SetEmailFollowupData, SetEmailFollowupError, SetEmailFollowupErrors, SetEmailFollowupResponse, SetEmailFollowupResponses, SetEmailSyncData, SetEmailSyncError, SetEmailSyncErrors, SetEmailSyncRequest, SetEmailSyncResponse, SetEmailSyncResponses, SetPropertyValue, SharedEmailFilter, SharePermissionV2, ShortIdResponse, SimpleMention, SimpleSaveData, SimpleSaveError, SimpleSaveErrors, SimpleSaveResponse, SimpleSaveResponses, SmartTagChannelMatch, SmartTagPreview, SoupAgentSessionSoupPropertiesField, SoupApiItem, SoupApiSort, SoupApiSortDirection, SoupAttachment, SoupCalendarEventSoupPropertiesField, SoupCalendarEventTime, SoupCallRecordGuest, SoupCallRecordParticipant, SoupCallRecordSoupPropertiesField, SoupChannel, SoupChannelThread, SoupChatSoupPropertiesField, SoupContact, SoupCountedReaction, SoupCrmCompanySoupPropertiesField, SoupCrmDomain, SoupDocumentSoupPropertiesField, SoupDocumentSubType, SoupEmailThreadPreview, SoupEnrichedEmailThreadPreviewSoupPropertiesField, SoupForeignEntity, SoupInitiativeSoupPropertiesField, SoupItem, SoupLabel, SoupLabelListVisibility, SoupLabelType, SoupMessageAttachment, SoupMessageListVisibility, SoupMessageSender, SoupMessageSenderType, SoupPage, SoupProjectSoupPropertiesField, SoupPropertiesField, SoupProperty, SoupReminderReference, SoupReminderSchedule, SoupReminderSoupPropertiesField, SoupThreadInfo, SoupThreadReply, StarterDocumentsResponse, StreamEventsData, StreamEventsError, StreamEventsErrors, StreamEventsResponse, StreamEventsResponses, String, SuccessResponse, SurfaceState, SyncServiceVersionId, SystemSkillSummary, TagFilterMode, TaskFilters, TeamOutOfOfficeItem, TeamOutOfOfficeResponse, TeamRole, ThreadAnchor, ThreadOrigin, ThreadPatch, ThreadState, ToggleShareWithTeamData, ToggleShareWithTeamError, ToggleShareWithTeamErrors, ToggleShareWithTeamResponse, ToggleShareWithTeamResponses, TranscribeDictationData, TranscribeDictationError, TranscribeDictationErrors, TranscribeDictationResponse, TranscribeDictationResponses, TranscribeResponse, TranscriptSegmentRequest, TurnEndedMetadata, TurnStartedMetadata, TurnSummary, TypedSuccessResponse, TypedSuccessResponseGetDocumentResponseData, TypingInput, UnassignInitiativeTaskData, UnassignInitiativeTaskError, UnassignInitiativeTaskErrors, UnassignInitiativeTaskResponse, UnassignInitiativeTaskResponses, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentRequest, UpdateAgentResponse, UpdateAgentResponses, UpdateChannelSharePermission, UpdateCrmTeamSettingsRequest, UpdateInitiativeData, UpdateInitiativeError, UpdateInitiativeErrors, UpdateInitiativeRequest, UpdateInitiativeResponse, UpdateInitiativeResponses, UpdateMeetingRequest, UpdateOperation, UpdateReminderData, UpdateReminderError, UpdateReminderErrors, UpdateReminderRequest, UpdateReminderResponse, UpdateReminderResponses, UpdateSharePermissionRequestV2, UploadDocumentStatus, UploadExtractFolderHandlerData, UploadExtractFolderHandlerError, UploadExtractFolderHandlerErrors, UploadExtractFolderHandlerResponse, UploadExtractFolderHandlerResponses, UploadExtractFolderRequest, UploadFolderHandlerData, UploadFolderHandlerError, UploadFolderHandlerErrors, UploadFolderHandlerResponse, UploadFolderHandlerResponses, UploadFolderRequest, UpsertHistoryHandlerData, UpsertHistoryHandlerError, UpsertHistoryHandlerErrors, UpsertHistoryHandlerResponse, UpsertHistoryHandlerResponses, UpsertUserDocumentViewLocationData, UpsertUserDocumentViewLocationError, UpsertUserDocumentViewLocationErrors, UpsertUserDocumentViewLocationRequest, UpsertUserDocumentViewLocationResponse, UpsertUserDocumentViewLocationResponses, UserApiKeyId, UserApiKeyInfo, UserApiKeysList, UserDocumentsResponse, UserDocumentViewLocation, UserDocumentViewLocationResponse, UserPinsResponse, UserViewsResponse, ValidateDocumentPermissionsTokenData, ValidateDocumentPermissionsTokenError, ValidateDocumentPermissionsTokenErrors, ValidateDocumentPermissionsTokenResponse, ValidateDocumentPermissionsTokenResponses, ValidateWebhookData, ValidateWebhookError, ValidateWebhookErrors, ValidateWebhookResponse, ValidateWebhookResponse2, ValidateWebhookResponses, Vec, View, ViewPatch, ViewsResponse, WaitingForInputMetadata, Webhook, WebhookEvent, WebhookFilter, WebhookScope, WebhookStatus, WebhookValidationTestEvent, WithCallId, WithChannelId, WithDocumentId, WithProjectId } from './types.gen';
diff --git a/packages/sdk/generated/storage/types.gen.ts b/packages/sdk/generated/storage/types.gen.ts
index 9a536ee8bd..9284515de3 100644
--- a/packages/sdk/generated/storage/types.gen.ts
+++ b/packages/sdk/generated/storage/types.gen.ts
@@ -3083,6 +3083,11 @@ export type CreateInitiativeRequest = {
* Display name.
*/
name: string;
+ /**
+ * Property values set as the owner within the create. A value the properties
+ * service rejects fails the whole create; no initiative is left behind.
+ */
+ propertyValues?: Array<InitialPropertyValue>;
/**
* Share with the owner's team at create time. Defaults to true; users without
* a team create an unshared initiative. Explicit false skips the team grant.
@@ -6008,6 +6013,20 @@ export type InFlightTurnSummary = {
turn: number;
};
+/**
+ * A property value set on a new initiative as part of its create.
+ */
+export type InitialPropertyValue = {
+ /**
+ * Property definition to set.
+ */
+ propertyDefinitionId: string;
+ /**
+ * Value, validated by the properties service like any other property write.
+ */
+ value: SetPropertyValue;
+};
+
/**
* Full initiative returned to a caller, including members, tasks, and share state.
*/
diff --git a/packages/sdk/specs/storage.json b/packages/sdk/specs/storage.json
index fd57657ee8..d68cdf2c39 100644
--- a/packages/sdk/specs/storage.json
+++ b/packages/sdk/specs/storage.json
@@ -18528,6 +18528,13 @@
"type": "string",
"description": "Display name."
},
+ "propertyValues": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/InitialPropertyValue"
+ },
+ "description": "Property values set as the owner within the create. A value the properties\nservice rejects fails the whole create; no initiative is left behind."
+ },
"shareWithTeam": {
"type": ["boolean", "null"],
"description": "Share with the owner's team at create time. Defaults to true; users without\na team create an unshared initiative. Explicit false skips the team grant."
@@ -23366,6 +23373,22 @@
}
}
},
+ "InitialPropertyValue": {
+ "type": "object",
+ "description": "A property value set on a new initiative as part of its create.",
+ "required": ["propertyDefinitionId", "value"],
+ "properties": {
+ "propertyDefinitionId": {
+ "type": "string",
+ "format": "uuid",
+ "description": "Property definition to set."
+ },
+ "value": {
+ "$ref": "#/components/schemas/SetPropertyValue",
+ "description": "Value, validated by the properties service like any other property write."
+ }
+ }
+ },
"InitiativeDetail": {
"type": "object",
"description": "Full initiative returned to a caller, including members, tasks, and share state.",
diff --git a/services/document_storage_service/src/api/swagger.rs b/services/document_storage_service/src/api/swagger.rs
index 217948dcbb..07748c7a3d 100644
--- a/services/document_storage_service/src/api/swagger.rs
+++ b/services/document_storage_service/src/api/swagger.rs
@@ -86,8 +86,8 @@ use favorites::inbound::axum_router::{
use foreign_entity::domain::models::ForeignEntity;
use initiative::domain::models::{
AssignTaskStatus, AssignTasksRequest, AssignTasksResponse, AssignTasksResult,
- CreateInitiativeRequest, InitiativeDetail, InitiativeId, InitiativeList, InitiativeSummary,
- UpdateInitiativeRequest,
+ CreateInitiativeRequest, InitialPropertyValue, InitiativeDetail, InitiativeId, InitiativeList,
+ InitiativeSummary, UpdateInitiativeRequest,
};
use model::document::response::{
CreateDocumentRequest, CreateDocumentResponse, CreateDocumentResponseData,
@@ -550,6 +550,7 @@ use utoipa::OpenApi;
InitiativeDetail,
InitiativeList,
CreateInitiativeRequest,
+ InitialPropertyValue,
UpdateInitiativeRequest,
AssignTasksRequest,
AssignTasksResult,
diff --git a/static_assets/schema.graphql b/static_assets/schema.graphql
index 8fb70a2c96..8c21a3bd74 100644
--- a/static_assets/schema.graphql
+++ b/static_assets/schema.graphql
@@ -219,6 +219,10 @@ input CreateInitiativeInput {
Whether to share with the owner's team, defaulting to true.
"""
shareWithTeam: Boolean
+ """
+ Initial property values, set in the same create; a rejected value fails it.
+ """
+ propertyValues: [InitialPropertyValueInput!]
}
"""
@@ -6897,6 +6901,20 @@ input GroupedSoupInput @oneOf {
continuation: GroupedSoupContinuationInput
}
+"""
+One property value set when an initiative is created.
+"""
+input InitialPropertyValueInput {
+ """
+ Property definition to set.
+ """
+ propertyDefinitionId: ID!
+ """
+ Value, in the same shape `setEntityProperty` accepts.
+ """
+ value: GraphqlSetPropertyValue!
+}
+
"""
Grant to a shared channel.
"""