@nocobase/app-plugin-projects 0.0.0-stage → 0.1.0-beta.2

package/dist/server/access/request.js

@@ -0,0 +1,62 @@
+import { conflict, DomainError } from '../kernel/errors.js';
+const VIEWER = 'pmViewer';
+const DELEGATED = 'pmDelegatedWrites';
+/** The header the CLI's user mode sends: `nocoproject-cli/<version>`. */
+const CLIENT_HEADER = 'x-pm-client';
+const CLI_PREFIX = 'nocoproject-cli/';
+/** How an API-key request arrived (browsers never send a key). */
+function requestVia(context) {
+    if (!context.req.header('x-api-key'))
+        return undefined;
+    return (context.req.header(CLIENT_HEADER) ?? '').startsWith(CLI_PREFIX)
+        ? 'cli'
+        : 'api_key';
+}
+/** Builds the request's `Viewer`; install after `auth.required()` and `authz.middleware()`. */
+export function viewerMiddleware(access, hooks = {}) {
+    return async (context, next) => {
+        const auth = context.get('auth');
+        if (!auth)
+            throw new DomainError('unauthorized', 'UNAUTHORIZED', 'Sign in first.');
+        const userId = auth.user.id;
+        const via = requestVia(context);
+        const identity = context.get('authz').identity;
+        const projects = identity.keyScope?.objects('pm.projects') ?? 'all';
+        const acting = await hooks.actorOf?.()?.(context);
+        const delegated = hooks.delegated?.();
+        if (delegated)
+            context.set(DELEGATED, delegated);
+        context.set(VIEWER, {
+            userId,
+            actor: acting ?? { type: 'user', id: userId, ...(via ? { via } : {}) },
+            permissions: await access.permissionsOf(identity),
+            ...(projects === 'all' ? {} : { projectIds: projects }),
+        });
+        await next();
+    };
+}
+export function viewerOf(context) {
+    const viewer = context.get(VIEWER);
+    if (!viewer)
+        throw new DomainError('unauthorized', 'UNAUTHORIZED', 'Sign in first.');
+    return viewer;
+}
+/**
+ * Hands a write to the application's delegated writes when the request's viewer acts for someone else
+ * (`DelegatedWrites`); undefined when it does not, and the route then writes through the services itself.
+ */
+export async function delegatedWrite(context, request) {
+    const writes = context.get(DELEGATED);
+    const viewer = viewerOf(context);
+    return writes?.covers(viewer) ? writes.write(viewer, request) : undefined;
+}
+/**
+ * Refuses a change made for someone else (a conversation's run acting for its asker) that the delegated writes do not
+ * cover, such as deleting an issue: 409 `PLAN_REQUIRED`, so it goes through a plan the person confirms.
+ */
+export function refuseDelegated(context) {
+    const writes = context.get(DELEGATED);
+    if (writes?.covers(viewerOf(context)))
+        throw conflict('PLAN_REQUIRED', 'A conversation makes this change through a plan the person confirms; propose one.');
+}
+//# sourceMappingURL=request.js.map

package/dist/server/access/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../server/access/request.ts"],"names":[],"mappings":"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"}

package/dist/server/access/viewer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A signed-in user acting through the browser API, with what they may do. Every user-facing service method takes one;
+ * the domain rules (who may see a project, who may close an issue) live with their domains and read it through the
+ * helpers below.
+ */
+import { type Business, type BusinessAction, type Permissions, type Scope, type SettingsAction, type SettingsItem } from '../../shared/access.js';
+import type { Actor } from '../kernel/actor.js';
+export interface Viewer {
+    readonly userId: string;
+    /** The same user as an actor, for the activity log and events. */
+    readonly actor: Actor;
+    readonly permissions: Permissions;
+    /**
+     * The projects a scoped API key is limited to (`keyScope.objects('pm.projects')`); undefined when every project is in
+     * reach. A limited viewer sees no other project, no issue outside these projects and none without a project.
+     */
+    readonly projectIds?: readonly string[];
+}
+/** Whether a project, or no project (null), is within the viewer's key scope. */
+export declare function inProjectScope(viewer: Pick<Viewer, 'projectIds'>, projectId: string | null): boolean;
+export declare function scopeOf<B extends Business>(viewer: Viewer, business: B, action: BusinessAction<B>): Scope;
+/** 403 unless the viewer holds the action at some scope. */
+export declare function requireAction<B extends Business>(viewer: Viewer, business: B, action: BusinessAction<B>, message: string): void;
+export declare function canUseSetting<S extends SettingsItem>(viewer: Viewer, item: S, action: SettingsAction<S>): boolean;
+/** 403 unless the viewer holds the settings capability. */
+export declare function requireSetting<S extends SettingsItem>(viewer: Viewer, item: S, action: SettingsAction<S>, message: string): void;
+//# sourceMappingURL=viewer.d.ts.map

package/dist/server/access/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../../server/access/viewer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAClC,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAGT;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,QAAQ,EACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,KAAK,CAEP;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,CAAC,SAAS,QAAQ,EAC9C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAClD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,OAAO,CAET;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,CAAC,SAAS,YAAY,EACnD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN"}

package/dist/server/access/viewer.js

@@ -0,0 +1,30 @@
+/**
+ * A signed-in user acting through the browser API, with what they may do. Every user-facing service method takes one;
+ * the domain rules (who may see a project, who may close an issue) live with their domains and read it through the
+ * helpers below.
+ */
+import { businessKey, settingsKey, } from '../../shared/access.js';
+import { forbidden } from '../kernel/errors.js';
+/** Whether a project, or no project (null), is within the viewer's key scope. */
+export function inProjectScope(viewer, projectId) {
+    if (!viewer.projectIds)
+        return true;
+    return projectId !== null && viewer.projectIds.includes(projectId);
+}
+export function scopeOf(viewer, business, action) {
+    return viewer.permissions.scopes[businessKey(business, action)];
+}
+/** 403 unless the viewer holds the action at some scope. */
+export function requireAction(viewer, business, action, message) {
+    if (scopeOf(viewer, business, action) === 'none')
+        throw forbidden(message);
+}
+export function canUseSetting(viewer, item, action) {
+    return viewer.permissions.settings[settingsKey(item, action)];
+}
+/** 403 unless the viewer holds the settings capability. */
+export function requireSetting(viewer, item, action, message) {
+    if (!canUseSetting(viewer, item, action))
+        throw forbidden(message);
+}
+//# sourceMappingURL=viewer.js.map

package/dist/server/access/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.js","sourceRoot":"","sources":["../../../server/access/viewer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,WAAW,EACX,WAAW,GAOZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAchD,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAC5B,MAAkC,EAClC,SAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,MAAc,EACd,QAAW,EACX,MAAyB;IAEzB,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,QAAW,EACX,MAAyB,EACzB,OAAe;IAEf,IAAI,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,MAAM;QAAE,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,IAAO,EACP,MAAyB;IAEzB,OAAO,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,IAAO,EACP,MAAyB,EACzB,OAAe;IAEf,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;QAAE,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC"}

package/dist/server/composition.d.ts

@@ -0,0 +1,104 @@
+/**
+ * The one place the plugin's services are assembled from their dependencies. The provider binds the result to
+ * `projectsToken`; tests call it directly against a real database.
+ *
+ * What a change or a comment starts (triggers) comes from `deps.triggers` when a plugin binds them, otherwise from the
+ * work handlers of the registered kinds (`kernel/work.ts`). Notices are planned in each transaction (`domains/notices`).
+ * The kinds of principal (`kernel/kinds.ts`) come from `projectsKindsToken`, where other plugins register theirs.
+ */
+import type { DatabaseManager } from '@nocobase/db';
+import type { ProjectsAccess } from './tokens.js';
+import { type KindRegistry } from './kernel/kinds.js';
+import { type DomainEventBus } from './kernel/events.js';
+import { type TxRunner } from './kernel/tx.js';
+import { type ApprovalService } from './domains/approvals/index.js';
+import { type IssueContextProvider, type IssueQueries, type IssueService, type IssueTriggers } from './domains/issues/index.js';
+import { type CommentQueries, type CommentService } from './domains/comments/index.js';
+import { type NoticeRules } from './domains/notices/index.js';
+import { type SubscriptionService } from './domains/subscriptions/index.js';
+import { type InvitationService, type UserInvitations } from './domains/invitations/index.js';
+import { type LabelService } from './domains/labels/index.js';
+import { type MemberService } from './domains/members/index.js';
+import { type ProjectService } from './domains/projects/index.js';
+import { type SettingsService } from './domains/settings/index.js';
+import { type ChecklistService } from './domains/checklists/index.js';
+import { type StatusRuleTypes, type WorkflowEventService, type WorkflowEventTypes, type WorkflowService, type WorkflowTemplates } from './domains/workflows/index.js';
+import { type IssueReports } from './domains/reports/index.js';
+import { type SubtaskService } from './domains/subtasks/index.js';
+import { type PlanHooks, type PlanService } from './domains/plans/index.js';
+import { type IntakeAiService, type IntakeOrganizer, type IntakeService } from './domains/plans/intake/index.js';
+import { type AttachmentService, type AttachmentStorage } from './domains/attachments/index.js';
+export interface ProjectsDeps {
+    readonly database: Pick<DatabaseManager, 'transaction' | 'connection'>;
+    readonly idGenerator: {
+        generateString(): string;
+    };
+    /** The roles, kept by the application (`projectsAccessToken`). */
+    readonly access: ProjectsAccess;
+    /** The user management plugin's invitations. */
+    readonly invitations: UserInvitations;
+    /** The kinds of principal; built-in kinds only when left out. */
+    readonly kinds?: KindRegistry;
+    /** Status rule types other plugins contribute (`projectsStatusRulesToken`); none when left out. */
+    readonly statusRules?: StatusRuleTypes;
+    /** Workflow events other plugins contribute (`projectsWorkflowEventsToken`); none when left out. */
+    readonly workflowEvents?: WorkflowEventTypes;
+    /** Workflow templates other plugins contribute (`projectsWorkflowTemplatesToken`); none when left out. */
+    readonly templates?: WorkflowTemplates;
+    /**
+     * What a change or a comment starts, asked on each use; when left out or when it answers undefined, the work handlers
+     * of the registered kinds.
+     */
+    readonly triggers?: () => IssueTriggers | undefined;
+    /** What hears plans being decided (`projectsPlanHooksToken`), asked on each use. */
+    readonly planHooks?: () => PlanHooks | undefined;
+    /** Who organises intake with AI (`projectsIntakeOrganizerToken`), asked on each use; none when left out. */
+    readonly intakeOrganizer?: () => IntakeOrganizer | undefined;
+    /** Where files' bytes go (the file plugin and Drive); without it nothing can be uploaded. */
+    readonly storage?: AttachmentStorage;
+    /** The application's public base path, for the files' content URLs; empty when left out. */
+    readonly basePath?: () => string;
+    readonly onListenerError?: (error: unknown) => void;
+}
+export interface Projects {
+    readonly events: DomainEventBus;
+    readonly tx: TxRunner;
+    readonly members: MemberService;
+    readonly invitations: InvitationService;
+    readonly settings: SettingsService;
+    readonly labels: LabelService;
+    readonly workflows: WorkflowService;
+    readonly projects: ProjectService;
+    readonly issues: IssueService;
+    readonly issueQueries: IssueQueries;
+    /** An issue as an executor of another kind needs it, read on the caller's connection. */
+    readonly issueContext: IssueContextProvider;
+    readonly checklists: ChecklistService;
+    readonly approvals: ApprovalService;
+    readonly comments: CommentService;
+    readonly commentQueries: CommentQueries;
+    readonly subscriptions: SubscriptionService;
+    /** Files on issues and comments (`shared/attachments.ts`). */
+    readonly attachments: AttachmentService;
+    /** Where files' bytes go; the intake stores its files through it too. */
+    readonly storage: AttachmentStorage;
+    /** Where other plugins add notice rules (`projectsNoticeRulesToken`). */
+    readonly noticeRules: NoticeRules;
+    readonly subtasks: SubtaskService;
+    /** Operation plans (`shared/plans.ts`). */
+    readonly plans: PlanService;
+    /** Requirement intake: files, their text and the rule split (`shared/intake.ts`). */
+    readonly intake: IntakeService;
+    /** Requirement intake with AI, through the bound organiser (`shared/intake-ai.ts`). */
+    readonly intakeAi: IntakeAiService;
+    readonly kinds: KindRegistry;
+    /** Every status rule type, this plugin's own first; `add` contributes one (`projectsStatusRulesToken`). */
+    readonly statusRules: StatusRuleTypes;
+    /** Contributed workflow events: their registry, and firing one for a batch of issues. */
+    readonly workflowEvents: WorkflowEventService;
+    readonly templates: WorkflowTemplates;
+    /** The issue side of the reports: counts over a date range, limited to what a viewer sees. */
+    readonly reports: IssueReports;
+}
+export declare function createProjects(deps: ProjectsDeps): Projects;
+//# sourceMappingURL=composition.d.ts.map

package/dist/server/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../server/composition.ts"],"names":[],"mappings":"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"}

package/dist/server/composition.js

@@ -0,0 +1,266 @@
+import { createActivityRecorder } from './kernel/activity.js';
+import { createKindRegistry } from './kernel/kinds.js';
+import { createDomainEventBus } from './kernel/events.js';
+import { createIdSource } from './kernel/ids.js';
+import { createTxRunner } from './kernel/tx.js';
+import { createUserDirectory } from './kernel/users.js';
+import { kindTriggers } from './kernel/work.js';
+import { createApprovalService, } from './domains/approvals/index.js';
+import { createIssueContextProvider, createIssueQueries, createIssueService, createProjectIssues, findIssue, } from './domains/issues/index.js';
+import { createCommentQueries, createCommentService, threadPage, } from './domains/comments/index.js';
+import { builtInRules, createNoticePlanner, } from './domains/notices/index.js';
+import { createSubscriptionService, } from './domains/subscriptions/index.js';
+import { createInvitationService, } from './domains/invitations/index.js';
+import { createLabelService, } from './domains/labels/index.js';
+import { createMemberService, } from './domains/members/index.js';
+import { createProjectService, findProject, } from './domains/projects/index.js';
+import { createSettingsService, } from './domains/settings/index.js';
+import { createChecklistService, } from './domains/checklists/index.js';
+import { builtInStatusRuleTypes, createIssueRegistry, createStatusRuleTypes, withBuiltInTypes, createWorkflowEventService, createWorkflowEventTypes, createWorkflowService, createWorkflowTemplates, } from './domains/workflows/index.js';
+import { createIssueReports, } from './domains/reports/index.js';
+import { createSubtaskService, } from './domains/subtasks/index.js';
+import { createPlanEngine, createPlanService, } from './domains/plans/index.js';
+import { createIntakeAiService, createIntakeFileStore, createIntakeService, intakeFilesHook, intakeFilesToKeep, } from './domains/plans/intake/index.js';
+import { noAbilities, noSettings } from '../shared/access.js';
+import { createAttachmentService, createAttachmentStorage, } from './domains/attachments/index.js';
+export function createProjects(deps) {
+    const events = createDomainEventBus({
+        onListenerError: (error) => deps.onListenerError?.(error),
+    });
+    const tx = createTxRunner(deps.database, events);
+    const ids = createIdSource(deps.idGenerator);
+    const users = createUserDirectory();
+    const activity = createActivityRecorder(ids);
+    const kinds = deps.kinds ?? createKindRegistry(users);
+    // This plugin's own rule types in front of the contributed ones: every rule is looked up in one place.
+    const statusRules = withBuiltInTypes(deps.statusRules ?? createStatusRuleTypes(), builtInStatusRuleTypes({
+        ids,
+        activity,
+        relations: () => subtasks.checks,
+    }));
+    const templates = deps.templates ?? createWorkflowTemplates();
+    const eventTypes = deps.workflowEvents ?? createWorkflowEventTypes();
+    const settings = createSettingsService({ tx });
+    const labels = createLabelService({ tx, ids });
+    const workflows = createWorkflowService({
+        tx,
+        ids,
+        kinds,
+        ruleTypes: statusRules,
+        events: eventTypes,
+        templates,
+        registry: createIssueRegistry({
+            activity,
+            approvers: {
+                projectLead: async (conn, projectId) => (await findProject(conn, projectId))?.leadUserId ?? null,
+                admins: async (conn) => [...(await deps.access.administrators(conn))],
+            },
+            types: statusRules,
+        }),
+    });
+    const statuses = workflows.catalogs;
+    const defaultTriggers = kindTriggers(kinds, {
+        activity,
+        blockers: (conn, issue) => subtasks.blockersOf(conn, issue),
+    });
+    const triggers = () => deps.triggers?.() ?? defaultTriggers;
+    const subscriptions = createSubscriptionService({ tx, ids, users });
+    const storage = deps.storage ??
+        createAttachmentStorage({
+            uploader: () => null,
+            disks: () => null,
+            disk: () => 'local',
+        });
+    const attachments = createAttachmentService({
+        tx,
+        activity,
+        kinds,
+        storage,
+        basePath: deps.basePath ?? (() => ''),
+        keep: intakeFilesToKeep,
+    });
+    const comments = createCommentService({
+        tx,
+        ids,
+        activity,
+        kinds,
+        triggers,
+        attachments: () => attachments.links,
+    });
+    const commentQueries = createCommentQueries({
+        tx,
+        kinds,
+        attachments: () => attachments.links,
+    });
+    const issueContext = createIssueContextProvider({
+        kinds,
+        statuses,
+        extras: () => ({
+            checklist: (conn, issue) => checklists.current(conn, issue),
+            pendingApproval: (conn, issue) => approvals.pendingFor(conn, issue.id),
+            attachments: (conn, viewer, issue) => attachments.links.ofIssue(conn, viewer, issue),
+        }),
+        comments: (conn, issueId) => commentQueries.list(conn, issueId),
+    });
+    const notices = createNoticePlanner({
+        subscriptions,
+        kinds,
+        rules: [builtInRules({ statuses })],
+    });
+    tx.beforeCommit((unit, events) => notices.plan(unit, events));
+    const checklists = createChecklistService({ tx, kinds, activity });
+    const issues = createIssueService({
+        tx,
+        ids,
+        activity,
+        settings,
+        users,
+        kinds,
+        labels,
+        statuses,
+        triggers,
+        approvals: () => approvals,
+        relations: () => subtasks.relations,
+    });
+    const subtasks = createSubtaskService({
+        tx,
+        ids,
+        activity,
+        kinds,
+        statuses,
+        triggers,
+        issues: () => issues,
+    });
+    const approvals = createApprovalService({
+        tx,
+        ids,
+        users,
+        kinds,
+        activity,
+        moves: () => ({
+            apply: (inner, request, approver) => issues.applyApproved(inner, request, approver),
+            find: findIssue,
+            statusName: async (conn, issue, key) => (await statuses.forProject(conn, issue.projectId)).statuses.find((status) => status.key === key)?.name ?? key,
+        }),
+    });
+    const projectIssues = createProjectIssues({ activity, statuses });
+    const projects = createProjectService({
+        tx,
+        ids,
+        users,
+        issues: () => projectIssues,
+        workflows: () => workflows.projects,
+    });
+    const plans = createPlanService({
+        tx,
+        ids,
+        kinds,
+        users,
+        engine: createPlanEngine({
+            tx,
+            kinds,
+            services: { issues, comments, subtasks, projects, statuses },
+            onError: (error) => console.error('A plan row failed.', error),
+        }),
+        hooks: () => deps.planHooks?.(),
+        onExecuted: {
+            intake: intakeFilesHook({ links: attachments.links, activity }),
+        },
+        ...(deps.access.permissionsOfUser
+            ? {
+                permissionsOfUser: (userId) => deps.access.permissionsOfUser(userId),
+            }
+            : {}),
+    });
+    const issueQueries = createIssueQueries({
+        tx,
+        users,
+        kinds,
+        statuses,
+        extras: () => ({
+            checklist: (conn, issue) => checklists.current(conn, issue),
+            pendingApproval: (conn, issue) => approvals.pendingFor(conn, issue.id),
+            recentApprovals: (conn, issue) => approvals.decidedFor(conn, issue.id),
+            threads: (conn, issue) => threadPage(conn, kinds, issue.id, {}, attachments.links),
+            attachments: (conn, viewer, issue) => attachments.links.ofIssue(conn, viewer, issue),
+            subscribers: (conn, issue) => subscriptions.subscribers(conn, issue.id),
+            relations: (conn, viewer, issue) => subtasks.extras.relations(conn, viewer, issue),
+            listCounts: (conn, issues) => subtasks.extras.listCounts(conn, issues),
+        }),
+    });
+    const intakeFiles = createIntakeFileStore({
+        conn: () => tx.read(),
+        storage,
+    });
+    const intake = createIntakeService({
+        plans,
+        labels: () => labels.list(),
+        files: intakeFiles,
+    });
+    const intakeAi = createIntakeAiService({
+        tx,
+        ids,
+        kinds,
+        plans,
+        projects,
+        issueQueries,
+        labels: () => labels.list(),
+        files: intakeFiles,
+        viewerOf: async (userId) => ({
+            userId,
+            actor: { type: 'user', id: userId },
+            permissions: (await deps.access.permissionsOfUser?.(userId)) ?? {
+                scopes: noAbilities(),
+                settings: noSettings(),
+            },
+        }),
+        organizer: () => deps.intakeOrganizer?.(),
+    });
+    const members = createMemberService({
+        tx,
+        ids,
+        users,
+        roles: deps.access,
+        kinds,
+    });
+    return {
+        events,
+        tx,
+        settings,
+        labels,
+        workflows,
+        members,
+        invitations: createInvitationService({
+            tx,
+            ids,
+            members,
+            invitations: deps.invitations,
+        }),
+        projects,
+        issues,
+        issueQueries,
+        issueContext,
+        checklists,
+        approvals,
+        comments,
+        commentQueries,
+        subscriptions,
+        attachments: attachments.service,
+        storage,
+        noticeRules: { add: (rule) => notices.add(rule) },
+        subtasks,
+        plans,
+        intake,
+        intakeAi,
+        kinds,
+        statusRules,
+        workflowEvents: createWorkflowEventService({
+            tx,
+            types: eventTypes,
+            issues: () => issues,
+        }),
+        templates,
+        reports: createIssueReports({ tx }),
+    };
+}
+//# sourceMappingURL=composition.js.map

package/dist/server/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","sourceRoot":"","sources":["../../server/composition.ts"],"names":[],"mappings":"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"}

package/dist/server/domains/approvals/approval.events.d.ts

@@ -0,0 +1,47 @@
+declare module '../../kernel/events.js' {
+    interface DomainEventMap {
+        /** A status change waits for one of `approverUserIds`. */
+        'approval.requested': {
+            readonly requestId: string;
+            readonly issueId: string;
+            readonly identifier: string;
+            readonly title: string;
+            readonly fromStatus: string;
+            readonly toStatus: string;
+            readonly toStatusName: string;
+            readonly approverUserIds: readonly string[];
+        };
+        /** A request was approved, rejected, withdrawn or went stale. */
+        'approval.decided': {
+            readonly requestId: string;
+            readonly issueId: string;
+            readonly identifier: string;
+            readonly title: string;
+            readonly status: 'approved' | 'rejected' | 'withdrawn' | 'stale';
+            readonly toStatus: string;
+            readonly toStatusName: string;
+            readonly requestedBy: {
+                readonly type: string;
+                readonly id: string;
+            };
+            /** The issue's owner, told the outcome of a request another kind (an agent) made. */
+            readonly ownerUserId: string | null;
+            /** Who the request waited for. */
+            readonly approverUserIds: readonly string[];
+            readonly decidedById: string | null;
+            /**
+             * Why an approved request went stale instead of moving the issue (its conditions no longer hold), and who
+             * approved it; null for a request that went stale because the issue left the status, and for other outcomes.
+             */
+            readonly staleReason: {
+                readonly code: string;
+                readonly message: string | null;
+                readonly attemptedById: string | null;
+            } | null;
+            /** What the approver wrote, if anything. */
+            readonly comment: string | null;
+        };
+    }
+}
+export {};
+//# sourceMappingURL=approval.events.d.ts.map

package/dist/server/domains/approvals/approval.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.events.d.ts","sourceRoot":"","sources":["../../../../server/domains/approvals/approval.events.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,cAAc;QACtB,0DAA0D;QAC1D,oBAAoB,EAAE;YACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;YAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;YAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;YAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;YAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;YAC9B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;SAC7C,CAAC;QACF,iEAAiE;QACjE,kBAAkB,EAAE;YAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;YAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;YAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;YACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;YAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;YAC9B,QAAQ,CAAC,WAAW,EAAE;gBACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;aACrB,CAAC;YACF,qFAAqF;YACrF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;YACpC,kCAAkC;YAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;YAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;YACpC;;;eAGG;YACH,QAAQ,CAAC,WAAW,EAAE;gBACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;gBAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;aACvC,GAAG,IAAI,CAAC;YACT,4CAA4C;YAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;SACjC,CAAC;KACH;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/server/domains/approvals/approval.events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=approval.events.js.map

package/dist/server/domains/approvals/approval.events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.events.js","sourceRoot":"","sources":["../../../../server/domains/approvals/approval.events.ts"],"names":[],"mappings":""}

package/dist/server/domains/approvals/approval.lifecycle.d.ts

@@ -0,0 +1,8 @@
+import type { Tx } from '../../kernel/tx.js';
+import { type LifecycleDefinition, type LifecycleMachine, type LifecycleRegistry } from '../../lifecycle/index.js';
+import { type ApprovalRecord } from './approval.store.js';
+/** The lifecycle for the registered `kinds` (their keys). */
+export declare function approvalLifecycle(kinds: readonly string[]): LifecycleDefinition;
+export declare function approvalMachine(kinds: readonly string[]): LifecycleMachine;
+export declare const approvalRules: LifecycleRegistry<ApprovalRecord, Tx>;
+//# sourceMappingURL=approval.lifecycle.d.ts.map

package/dist/server/domains/approvals/approval.lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.lifecycle.d.ts","sourceRoot":"","sources":["../../../../server/domains/approvals/approval.lifecycle.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQlE,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,mBAAmB,CA+BrB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAE1E;AAED,eAAO,MAAM,aAAa,EAAE,iBAAiB,CAAC,cAAc,EAAE,EAAE,CAe1D,CAAC"}