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

package/dist/server/domains/plans/plan.engine.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Rehearsing and executing a plan's rows through the operation catalogue (`plan.ops.ts`).
+ *
+ * - `rehearse` runs every row in a unit that always rolls back (`TxRunner.unit` with `rehearse`): each row in its own
+ *   savepoint, so a failing row leaves the next ones checkable (a row naming a failed row's `ref` then fails with
+ *   `INVALID_REF`). Triggers only report whom they would wake; nothing is announced. Each row gets its check: the
+ *   error, the wakes, the risk flags, the target and its baseline.
+ * - `execute` runs the rows in the caller's unit, in order. Before each row its target is compared with the baseline
+ *   the last rehearsal recorded; a difference throws `RowFailure` with `stale`, and a service's refusal throws it with
+ *   the error, so the caller rolls the whole unit back. After the last row, every row records the state the whole plan
+ *   left its target in (`after`, `revision`), which is what undo compares later.
+ */
+import type { ApiErrorBody } from '../../../shared/common.js';
+import type { PlanBaseline, PlanRowCheck, PlanRowOp, PlanRowResult } from '../../../shared/plans.js';
+import type { Viewer } from '../../access/viewer.js';
+import { DomainError } from '../../kernel/errors.js';
+import type { KindRegistry } from '../../kernel/kinds.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+import { type OpServices } from './plan.ops.js';
+export interface EngineDeps {
+    readonly tx: TxRunner;
+    readonly kinds: KindRegistry;
+    readonly services: OpServices;
+    readonly onError?: (error: unknown) => void;
+}
+/** A row as the engine runs it. */
+export interface EngineRow {
+    readonly op: PlanRowOp;
+    readonly params: unknown;
+    readonly ref: string | null;
+    /** The baseline of the last rehearsal; execution compares it. */
+    readonly baseline?: PlanBaseline | null;
+}
+/** A row stopped the execution; the caller rolls back. */
+export declare class RowFailure extends Error {
+    readonly index: number;
+    readonly error: ApiErrorBody;
+    readonly stale: boolean;
+    constructor(index: number, error: ApiErrorBody, stale: boolean);
+}
+export declare function createPlanEngine(deps: EngineDeps): {
+    /** Rehearses `rows` as `viewer`; rolls everything back. */
+    rehearse(viewer: Viewer, rows: readonly EngineRow[]): Promise<PlanRowCheck[]>;
+    /** Executes `rows` in `tx` as `viewer`; throws `RowFailure` at the first row that cannot run. */
+    execute(tx: Tx, viewer: Viewer, rows: readonly EngineRow[]): Promise<PlanRowResult[]>;
+};
+export type PlanEngine = ReturnType<typeof createPlanEngine>;
+/** 400 `PLAN_INVALID` with every row's check. */
+export declare function planInvalid(checks: readonly PlanRowCheck[]): DomainError;
+//# sourceMappingURL=plan.engine.d.ts.map

package/dist/server/domains/plans/plan.engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.engine.d.ts","sourceRoot":"","sources":["../../../../server/domains/plans/plan.engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EACV,YAAY,EAGZ,YAAY,EACZ,SAAS,EACT,aAAa,EAEd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAW,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAIvD,OAAO,EAML,KAAK,UAAU,EAEhB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAED,0DAA0D;AAC1D,qBAAa,UAAW,SAAQ,KAAK;aAEjB,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,YAAY;aACnB,KAAK,EAAE,OAAO;gBAFd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,OAAO;CAKjC;AAgDD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU;IAwE7C,2DAA2D;qBAEjD,MAAM,QACR,SAAS,SAAS,EAAE,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC;IAyD1B,iGAAiG;gBAE3F,EAAE,UACE,MAAM,QACR,SAAS,SAAS,EAAE,GACzB,OAAO,CAAC,aAAa,EAAE,CAAC;EAuE9B;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,WAAW,CASxE"}

package/dist/server/domains/plans/plan.engine.js

@@ -0,0 +1,224 @@
+import { DomainError, invalid } from '../../kernel/errors.js';
+import { collectRunAttempts } from '../../kernel/work.js';
+import { findIssue } from '../issues/index.js';
+import { lockIssueGraph } from '../subtasks/index.js';
+import { dependencyExists, issueFields, OPERATIONS, } from './plan.ops.js';
+/** A row stopped the execution; the caller rolls back. */
+export class RowFailure extends Error {
+    index;
+    error;
+    stale;
+    constructor(index, error, stale) {
+        super(error.message);
+        this.index = index;
+        this.error = error;
+        this.stale = stale;
+        this.name = 'RowFailure';
+    }
+}
+function errorBody(error, onError) {
+    if (error instanceof DomainError)
+        return {
+            code: error.code,
+            message: error.message,
+            ...(error.details ? { details: error.details } : {}),
+        };
+    onError?.(error);
+    return { code: 'INTERNAL_ERROR', message: 'The operation failed.' };
+}
+/** Same JSON, ignoring key order. */
+function same(a, b) {
+    const canonical = (value) => {
+        if (Array.isArray(value))
+            return value.map(canonical);
+        if (value && typeof value === 'object')
+            return Object.fromEntries(Object.keys(value)
+                .sort()
+                .map((key) => [
+                key,
+                canonical(value[key]),
+            ]));
+        return value ?? null;
+    };
+    return JSON.stringify(canonical(a)) === JSON.stringify(canonical(b));
+}
+/** The row's shape problems as an error, or null. */
+function shapeError(op, params) {
+    const definition = OPERATIONS[op];
+    if (!definition)
+        return invalid('UNSUPPORTED_OPERATION', `${String(op)} is not an operation.`);
+    const problems = definition.problems(params);
+    if (problems.length === 0)
+        return null;
+    return invalid('INVALID_PARAMS', `${op}: ${problems.map((problem) => problem.message).join(' ')}`, { errors: problems });
+}
+export function createPlanEngine(deps) {
+    async function wakesOf(tx, attempts) {
+        const name = await deps.kinds.nameAll(tx.conn, attempts.map((attempt) => ({
+            type: attempt.kind,
+            id: attempt.principalId,
+        })));
+        return attempts.map((attempt) => ({
+            kind: attempt.kind,
+            principalId: attempt.principalId,
+            name: name(attempt.kind, attempt.principalId),
+            subjectId: attempt.subjectId,
+            triggerType: attempt.triggerType,
+            started: attempt.started,
+            ...(attempt.skipped ? { skipped: attempt.skipped } : {}),
+            ...(attempt.runId ? { runId: attempt.runId } : {}),
+        }));
+    }
+    function flagsOf(outcome, wakes) {
+        const flags = new Set(outcome.flags);
+        if (wakes.some((wake) => wake.started))
+            flags.add('startsRun');
+        return [...flags];
+    }
+    /** Runs one row; records its ref. */
+    async function perform(ctx, row) {
+        const problem = shapeError(row.op, row.params);
+        if (problem)
+            throw problem;
+        const { value: outcome, attempts } = await collectRunAttempts(() => OPERATIONS[row.op].run(ctx, row.params));
+        if (row.ref && outcome.created?.id) {
+            if (outcome.created.type !== 'issue' &&
+                outcome.created.type !== 'project')
+                throw invalid('INVALID_REF', `ref ${row.ref} names nothing this row creates.`);
+            ctx.refs.set(row.ref, {
+                type: outcome.created.type,
+                id: outcome.created.id,
+            });
+        }
+        return { outcome, attempts };
+    }
+    /** The current state of the row's baseline target, as its baseline would record it. */
+    async function current(ctx, row) {
+        return OPERATIONS[row.op].baseline(ctx, row.params);
+    }
+    return {
+        /** Rehearses `rows` as `viewer`; rolls everything back. */
+        async rehearse(viewer, rows) {
+            return deps.tx.unit(async (tx) => {
+                // A later row may write the graph after earlier rows lock issues or counters. Keep this outer guard across
+                // every row's savepoint, including failures, without advancing the revision for a rehearsal or plain edits.
+                await lockIssueGraph(tx.conn, false);
+                const refs = new Map();
+                // What the rehearsal created; it is rolled back, so the card shows no id for it.
+                const transient = new Set();
+                const hide = (ref) => ref?.id && transient.has(ref.id)
+                    ? { ...ref, id: null, identifier: null }
+                    : ref;
+                const checks = [];
+                for (const row of rows) {
+                    const ctx = {
+                        tx,
+                        viewer,
+                        services: deps.services,
+                        refs,
+                    };
+                    let baseline = null;
+                    try {
+                        const problem = shapeError(row.op, row.params);
+                        if (problem)
+                            throw problem;
+                        baseline = await current(ctx, row);
+                        const { outcome, attempts } = await deps.tx.savepoint(tx, (inner) => perform({ ...ctx, tx: inner }, row));
+                        if (outcome.created?.id)
+                            transient.add(outcome.created.id);
+                        const wakes = await wakesOf(tx, attempts);
+                        checks.push({
+                            ok: true,
+                            error: null,
+                            target: hide(outcome.target),
+                            wakes,
+                            flags: flagsOf(outcome, wakes),
+                            baseline,
+                        });
+                    }
+                    catch (error) {
+                        checks.push({
+                            ok: false,
+                            error: errorBody(error, deps.onError),
+                            target: baseline?.target ?? null,
+                            wakes: [],
+                            flags: [],
+                            baseline,
+                        });
+                    }
+                }
+                return checks;
+            }, { rehearse: true });
+        },
+        /** Executes `rows` in `tx` as `viewer`; throws `RowFailure` at the first row that cannot run. */
+        async execute(tx, viewer, rows) {
+            // Execution and undo share this entry: take the graph before any row can lock an issue or the issue counter.
+            await lockIssueGraph(tx.conn, false);
+            const refs = new Map();
+            const ctx = { tx, viewer, services: deps.services, refs };
+            const outcomes = [];
+            for (const [index, row] of rows.entries()) {
+                try {
+                    if (row.baseline) {
+                        const now = await current(ctx, row);
+                        if (!now ||
+                            now.target.id !== row.baseline.target.id ||
+                            !same(now.fields, row.baseline.fields))
+                            throw new RowFailure(index, {
+                                code: 'PLAN_STALE',
+                                message: 'Something this row changes was changed after the plan was checked; check the plan again.',
+                                details: {
+                                    target: row.baseline.target,
+                                    expected: row.baseline.fields,
+                                    actual: now?.fields ?? null,
+                                },
+                            }, true);
+                    }
+                    const { outcome, attempts } = await perform(ctx, row);
+                    outcomes.push({ outcome, wakes: await wakesOf(tx, attempts) });
+                }
+                catch (error) {
+                    if (error instanceof RowFailure)
+                        throw error;
+                    throw new RowFailure(index, errorBody(error, deps.onError), false);
+                }
+            }
+            // What the whole plan left each target as, for undo.
+            const results = [];
+            for (const [index, { outcome, wakes }] of outcomes.entries()) {
+                const row = rows[index];
+                const issueId = OPERATIONS[row.op].issueOf?.(outcome) ?? null;
+                const issue = issueId ? await findIssue(tx.conn, issueId) : undefined;
+                let after = outcome.after;
+                if (row.op === 'issue.update' && issue && after)
+                    after = await issueFields(ctx, issue, Object.keys(after));
+                if (row.op === 'dependency' && after) {
+                    const link = after;
+                    after = {
+                        ...after,
+                        exists: await dependencyExists(tx, {
+                            id: outcome.created?.id ?? null,
+                            ...link,
+                        }),
+                    };
+                }
+                results.push({
+                    target: outcome.target,
+                    created: outcome.created,
+                    after,
+                    revision: issue?.revision ?? null,
+                    wakes,
+                });
+            }
+            return results;
+        },
+    };
+}
+/** 400 `PLAN_INVALID` with every row's check. */
+export function planInvalid(checks) {
+    const failing = checks.findIndex((check) => !check.ok);
+    return invalid('PLAN_INVALID', failing < 0
+        ? 'The plan is not valid.'
+        : `Row ${failing + 1} cannot run: ${checks[failing]?.error?.message ?? ''}`, { rows: checks });
+}
+//# sourceMappingURL=plan.engine.js.map

package/dist/server/domains/plans/plan.engine.js.map

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

package/dist/server/domains/plans/plan.events.d.ts

@@ -0,0 +1,10 @@
+declare module '../../kernel/events.js' {
+    interface DomainEventMap {
+        /** A plan was created, rehearsed again, executed, voided, expired or undone; open cards refetch it. */
+        'plan.changed': {
+            readonly planId: string;
+        };
+    }
+}
+export {};
+//# sourceMappingURL=plan.events.d.ts.map

package/dist/server/domains/plans/plan.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.events.d.ts","sourceRoot":"","sources":["../../../../server/domains/plans/plan.events.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,cAAc;QACtB,uGAAuG;QACvG,cAAc,EAAE;YAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7C;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/server/domains/plans/plan.events.js

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

package/dist/server/domains/plans/plan.events.js.map

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

package/dist/server/domains/plans/plan.ops.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The operation catalogue: each operation a plan row may hold (`shared/plans.ts`), mapped onto the services the browser
+ * uses, so a row is checked by exactly the rules a person's own request would be (who may see, edit, close, change the
+ * owner; where the status may move; the comment and dependency rules).
+ *
+ * Every operation has the same three parts:
+ *
+ * - `problems`: the shape of `params`: required fields, the right types, no unknown field (a guessed `issueId` or
+ *   `assignee` must not leave the proposer believing its change happened). Values stay the services' to judge.
+ * - `baseline`: what the row's target looks like now, for the rows whose target may change between the rehearsal and
+ *   the execution (an existing issue's fields, a dependency to remove). Execution compares it again.
+ * - `run`: performs the row in the caller's unit of work, as the viewer, resolving `{ ref }` targets to what earlier
+ *   rows created; answers what it acted on, what it created, the fields it set and its risk flags.
+ */
+import { type DependencyType } from '../../../shared/subtasks.js';
+import type { Issue } from '../../../shared/issues.js';
+import type { PlanBaseline, PlanObjectRef, PlanRiskFlag, PlanRowOp } from '../../../shared/plans.js';
+import type { Viewer } from '../../access/viewer.js';
+import type { Tx } from '../../kernel/tx.js';
+import { type CommentService } from '../comments/index.js';
+import { type IssueService, type StatusService } from '../issues/index.js';
+import { type ProjectService } from '../projects/index.js';
+import { type SubtaskService } from '../subtasks/index.js';
+export interface OpServices {
+    readonly issues: IssueService;
+    readonly comments: CommentService;
+    readonly subtasks: SubtaskService;
+    readonly projects: ProjectService;
+    readonly statuses: Pick<StatusService, 'catalog'>;
+}
+/** What earlier rows created, by their `ref`. */
+export type Refs = Map<string, {
+    readonly type: 'issue' | 'project';
+    readonly id: string;
+}>;
+export interface OpContext {
+    readonly tx: Tx;
+    readonly viewer: Viewer;
+    readonly services: OpServices;
+    readonly refs: Refs;
+}
+export interface OpOutcome {
+    readonly target: PlanObjectRef | null;
+    readonly created: PlanObjectRef | null;
+    readonly after: Readonly<Record<string, unknown>> | null;
+    readonly flags: readonly PlanRiskFlag[];
+}
+export interface Problem {
+    readonly field: string;
+    readonly message: string;
+}
+export interface OpDefinition {
+    /** A proposer may write it; the undo rows are written by the server only. */
+    readonly proposable: boolean;
+    problems(params: unknown): Problem[];
+    baseline(ctx: OpContext, params: never): Promise<PlanBaseline | null>;
+    run(ctx: OpContext, params: never): Promise<OpOutcome>;
+    /** The issue whose final revision the row records, once run. */
+    issueOf?(outcome: OpOutcome): string | null;
+}
+export declare function issueRef(issue: Issue): PlanObjectRef;
+/** The current value of each of `fields`, as a baseline compares them. */
+export declare function issueFields(ctx: Pick<OpContext, 'tx'>, issue: Issue, fields: readonly string[]): Promise<Record<string, unknown>>;
+export declare const OPERATIONS: Readonly<Record<PlanRowOp, OpDefinition>>;
+/** Whether a dependency still links the two issues as a row left it. */
+export declare function dependencyExists(tx: Tx, link: {
+    readonly id?: string | null;
+    readonly issueId: string;
+    readonly dependsOnIssueId: string;
+    readonly type: DependencyType;
+}): Promise<boolean>;
+//# sourceMappingURL=plan.ops.d.ts.map

package/dist/server/domains/plans/plan.ops.d.ts.map

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