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

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

@@ -0,0 +1,54 @@
+import { SYSTEM_KIND } from '../../../shared/kinds.js';
+import { compile, createLifecycleRegistry, } from '../../lifecycle/index.js';
+import { listOf } from './approval.store.js';
+const state = (key, category) => ({
+    key,
+    name: key,
+    category,
+});
+/** The lifecycle for the registered `kinds` (their keys). */
+export function approvalLifecycle(kinds) {
+    return {
+        states: [
+            state('pending', 'open'),
+            state('approved', 'closed'),
+            state('rejected', 'closed'),
+            state('withdrawn', 'closed'),
+            state('stale', 'closed'),
+        ],
+        transitions: [
+            {
+                from: 'pending',
+                to: 'approved',
+                actors: ['user'],
+                who: { type: 'approver' },
+            },
+            {
+                from: 'pending',
+                to: 'rejected',
+                actors: ['user'],
+                who: { type: 'approver' },
+            },
+            {
+                from: 'pending',
+                to: 'withdrawn',
+                actors: kinds.filter((kind) => kind !== SYSTEM_KIND),
+                who: { type: 'requester' },
+            },
+            { from: 'pending', to: 'stale', actors: [SYSTEM_KIND] },
+        ],
+    };
+}
+export function approvalMachine(kinds) {
+    return compile(approvalLifecycle(kinds));
+}
+export const approvalRules = createLifecycleRegistry()
+    .whoRule('approver', {
+    allows: (ctx) => Promise.resolve(ctx.actor.id !== null &&
+        listOf(ctx.subject.approverUserIds).includes(ctx.actor.id)),
+})
+    .whoRule('requester', {
+    allows: (ctx) => Promise.resolve(ctx.actor.type === ctx.subject.requestedByType &&
+        ctx.actor.id === ctx.subject.requestedById),
+});
+//# sourceMappingURL=approval.lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approval.lifecycle.js","sourceRoot":"","sources":["../../../../server/domains/approvals/approval.lifecycle.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EACL,OAAO,EACP,uBAAuB,GAIxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,MAAM,EAAuB,MAAM,qBAAqB,CAAC;AAElE,MAAM,KAAK,GAAG,CAAC,GAAmB,EAAE,QAA2B,EAAE,EAAE,CAAC,CAAC;IACnE,GAAG;IACH,IAAI,EAAE,GAAG;IACT,QAAQ;CACT,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,UAAU,iBAAiB,CAC/B,KAAwB;IAExB,OAAO;QACL,MAAM,EAAE;YACN,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC;YACxB,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC;YAC3B,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC;YAC3B,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC;YAC5B,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;SACzB;QACD,WAAW,EAAE;YACX;gBACE,IAAI,EAAE,SAAS;gBACf,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE,CAAC,MAAM,CAAC;gBAChB,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;aAC1B;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE,CAAC,MAAM,CAAC;gBAChB,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;aAC1B;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,EAAE,EAAE,WAAW;gBACf,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC;gBACpD,GAAG,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;aAC3B;YACD,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE;SACxD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,OAAO,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GACxB,uBAAuB,EAAsB;KAC1C,OAAO,CAAC,UAAU,EAAE;IACnB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CACd,OAAO,CAAC,OAAO,CACb,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI;QACnB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAC7D;CACJ,CAAC;KACD,OAAO,CAAC,WAAW,EAAE;IACpB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CACd,OAAO,CAAC,OAAO,CACb,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,eAAe;QAC5C,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,CAAC,OAAO,CAAC,aAAa,CAC7C;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { Hono } from 'hono';
+import { type ViewerEnv } from '../../access/request.js';
+import type { ApprovalService } from './approval.service.js';
+/**
+ * `/api/projects/approvals`: `GET /` the requests waiting for the caller; `POST /{approvalId}/approve` and `/reject`
+ * (body `{ comment? }`) by one of its approvers; `POST /{approvalId}/withdraw` by whoever asked. Each answers the
+ * request.
+ */
+export declare function createApprovalRoutes(approvals: ApprovalService): Hono<ViewerEnv>;
+//# sourceMappingURL=approval.routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approval.routes.d.ts","sourceRoot":"","sources":["../../../../server/domains/approvals/approval.routes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAQnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,GACzB,IAAI,CAAC,SAAS,CAAC,CAoGjB"}

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

@@ -0,0 +1,86 @@
+import { apiErrorResponse, apiErrorResponses, apiValidator, cliRoute, dataResponse, describeRoute, listResponse, } from '@nocobase/app-server/router';
+import { viewerOf } from '../../access/request.js';
+import { boundedList, domainRouter, tags } from '../../kernel/http.js';
+import { ApprovalParams, ApprovalRequestSchema, BoundedListMeta, DecideApprovalBody, } from '../../routes/schemas.js';
+const decided = apiErrorResponse(400, 'When the request is no longer pending (`APPROVAL_DECIDED`).');
+/**
+ * `/api/projects/approvals`: `GET /` the requests waiting for the caller; `POST /{approvalId}/approve` and `/reject`
+ * (body `{ comment? }`) by one of its approvers; `POST /{approvalId}/withdraw` by whoever asked. Each answers the
+ * request.
+ */
+export function createApprovalRoutes(approvals) {
+    const routes = domainRouter();
+    routes.get('/', describeRoute({
+        tags,
+        summary: 'List the approval requests waiting for the caller',
+        operationId: 'projectsListApprovals',
+        ...cliRoute({
+            command: 'approval list',
+            columns: [
+                'id',
+                'issueIdentifier',
+                'fromStatus',
+                'toStatus',
+                'requestedByName',
+                'createdAt',
+            ],
+        }),
+        responses: {
+            200: listResponse(ApprovalRequestSchema, BoundedListMeta),
+            ...apiErrorResponses,
+        },
+    }), async (context) => context.json(boundedList(await approvals.mine(viewerOf(context)))));
+    for (const [verb, summary, description] of [
+        [
+            'approve',
+            'Approve a status change',
+            'By one of the request’s approvers; the issue moves, unless the move’s conditions no longer hold (the request is then `stale`).',
+        ],
+        [
+            'reject',
+            'Reject a status change',
+            'By one of the request’s approvers; the issue stays.',
+        ],
+    ])
+        routes.post(`/:approvalId/${verb}`, describeRoute({
+            tags,
+            summary,
+            operationId: verb === 'approve'
+                ? 'projectsApproveApproval'
+                : 'projectsRejectApproval',
+            ...cliRoute({
+                command: `approval ${verb}`,
+                flags: { approvalId: { name: 'approval' } },
+                examples: [`approval ${verb} <approval> --comment "…"`],
+            }),
+            description,
+            responses: {
+                200: dataResponse(ApprovalRequestSchema),
+                ...apiErrorResponses,
+                400: decided,
+                404: apiErrorResponse(404),
+            },
+        }), apiValidator('param', ApprovalParams), apiValidator('json', DecideApprovalBody), async (context) => context.json({
+            data: await approvals[verb](viewerOf(context), context.req.valid('param').approvalId, context.req.valid('json')),
+        }));
+    routes.post('/:approvalId/withdraw', describeRoute({
+        tags,
+        summary: 'Withdraw an approval request',
+        operationId: 'projectsWithdrawApproval',
+        ...cliRoute({
+            command: 'approval withdraw',
+            flags: { approvalId: { name: 'approval' } },
+        }),
+        description: 'By whoever asked for the status change.',
+        responses: {
+            200: dataResponse(ApprovalRequestSchema),
+            ...apiErrorResponses,
+            400: decided,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', ApprovalParams), async (context) => context.json({
+        data: await approvals.withdraw(viewerOf(context), context.req.valid('param').approvalId),
+    }));
+    return routes;
+}
+//# sourceMappingURL=approval.routes.js.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * Approval requests. A status change whose transition needs an approval does not happen: the issues domain asks for
+ * a request here instead (one pending per issue, 400 `APPROVAL_PENDING`). Then:
+ *
+ * - an approver approves: the issue moves as the request asked, checked again as the requester's move; when it no
+ *   longer passes (the issue left the status, a guard refuses, the workflow changed) the request goes stale instead;
+ * - an approver rejects, or the requester withdraws: the issue stays;
+ * - the issue leaves the status some other way: its pending requests go stale.
+ *
+ * Only a listed approver decides (403 `NOT_APPROVER`) and only the requester withdraws (403 `NOT_REQUESTER`); a
+ * request no longer pending is 400 `APPROVAL_DECIDED`. Each step is an activity (`approval_*`) and an event.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import { type ApprovalRequest, type DecideApprovalRequest } from '../../../shared/approvals.js';
+import type { Issue } from '../../../shared/issues.js';
+import type { Viewer } from '../../access/viewer.js';
+import type { ActivityRecorder } from '../../kernel/activity.js';
+import { type Actor } from '../../kernel/actor.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+import type { KindRegistry } from '../../kernel/kinds.js';
+import type { UserDirectory } from '../../kernel/users.js';
+import './approval.events.js';
+import { type ApprovalRecord } from './approval.store.js';
+/** What approving needs from the issues domain: the move the request asked for, or why it cannot happen now. */
+export interface ApprovedMoves {
+    /** Moves the issue; null when it moved, else why not (the request then goes stale). */
+    apply(tx: Tx, request: ApprovalRecord, approver: Actor): Promise<{
+        readonly code: string;
+        readonly message: string;
+    } | null>;
+    /** The issue, deleted or not; undefined when it is gone. */
+    find(conn: DatabaseConnection, id: string): Promise<Issue | undefined>;
+    /** A status of the issue's workflow by name, as the workflow names it (built-in names untranslated). */
+    statusName(conn: DatabaseConnection, issue: Issue, key: string): Promise<string>;
+}
+export interface NewApprovalRequest {
+    readonly issue: Issue;
+    readonly toStatus: string;
+    readonly actor: Actor;
+    readonly approvers: readonly string[];
+    readonly approverIds: readonly string[];
+}
+export interface ApprovalService {
+    /** The requests waiting for the viewer, newest first. */
+    mine(viewer: Viewer): Promise<ApprovalRequest[]>;
+    approve(viewer: Viewer, id: string, input: DecideApprovalRequest): Promise<ApprovalRequest>;
+    reject(viewer: Viewer, id: string, input: DecideApprovalRequest): Promise<ApprovalRequest>;
+    withdraw(viewer: Viewer, id: string): Promise<ApprovalRequest>;
+    /** For the issues domain, in its transaction: holds a status change for approval. */
+    request(tx: Tx, input: NewApprovalRequest): Promise<ApprovalRequest>;
+    /** For the issues domain: the issue is in `statusKey` now, so requests to leave another status go stale. */
+    supersede(tx: Tx, issueId: string, statusKey: string, except?: string): Promise<void>;
+    /** The issue's pending request, for the issue page. */
+    pendingFor(conn: DatabaseConnection, issueId: string): Promise<ApprovalRequest | null>;
+    /** The issue's last `RECENT_DECIDED_APPROVALS` decided requests, the most recently decided first. */
+    decidedFor(conn: DatabaseConnection, issueId: string): Promise<ApprovalRequest[]>;
+    /**
+     * The pending requests on any of `issueIds`, oldest first, in one read; for a caller that has already limited the
+     * issues to what its viewer sees (a board of work, say).
+     */
+    pendingOn(issueIds: readonly string[]): Promise<ApprovalRequest[]>;
+}
+export declare function createApprovalService(deps: {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly users: UserDirectory;
+    readonly kinds: KindRegistry;
+    readonly activity: ActivityRecorder;
+    readonly moves: () => ApprovedMoves;
+}): ApprovalService;
+//# sourceMappingURL=approval.service.d.ts.map

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

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

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

@@ -0,0 +1,261 @@
+import { APPROVAL_COMMENT_MAX, RECENT_DECIDED_APPROVALS, } from '../../../shared/approvals.js';
+import { SYSTEM_ACTOR } from '../../kernel/actor.js';
+import { conflict, forbidden, invalid, notFound } from '../../kernel/errors.js';
+import { canMove, LifecycleError, move } from '../../lifecycle/index.js';
+import './approval.events.js';
+import { approvalMachine, approvalRules } from './approval.lifecycle.js';
+import { allPending, decidedOf, decideRequest, findRequest, insertRequest, listOf, pendingOf, pendingOfEach, } from './approval.store.js';
+const PENDING_LIMIT = 500;
+const iso = (value) => value instanceof Date ? value.toISOString() : new Date(value).toISOString();
+function commentOf(input) {
+    const comment = input?.comment;
+    if (comment === undefined || comment === null)
+        return null;
+    if (typeof comment !== 'string' || comment.length > APPROVAL_COMMENT_MAX)
+        throw invalid('INVALID_COMMENT', `A comment is at most ${APPROVAL_COMMENT_MAX} characters.`);
+    return comment.trim() || null;
+}
+export function createApprovalService(deps) {
+    const machine = () => approvalMachine(deps.kinds.list().map((kind) => kind.key));
+    async function view(conn, rows) {
+        const people = await deps.users.names(conn, [
+            ...rows.flatMap((row) => listOf(row.approverUserIds)),
+            ...rows.map((row) => row.decidedById),
+        ]);
+        const requester = await deps.kinds.nameAll(conn, rows.map((row) => ({ type: row.requestedByType, id: row.requestedById })));
+        const issues = new Map();
+        for (const row of rows)
+            if (!issues.has(row.issueId))
+                issues.set(row.issueId, await deps.moves().find(conn, row.issueId));
+        return rows.map((row) => {
+            const issue = issues.get(row.issueId);
+            const approverUserIds = listOf(row.approverUserIds);
+            return {
+                id: row.id,
+                issueId: row.issueId,
+                issueIdentifier: issue?.identifier ?? null,
+                issueTitle: issue?.title ?? null,
+                fromStatus: row.fromStatus,
+                toStatus: row.toStatus,
+                requestedByType: row.requestedByType,
+                requestedById: row.requestedById,
+                requestedByName: requester(row.requestedByType, row.requestedById),
+                approvers: [...listOf(row.approvers)],
+                approverUserIds: [...approverUserIds],
+                approverNames: approverUserIds.map((id) => people.get(id) ?? id),
+                status: row.status,
+                decidedById: row.decidedById,
+                decidedByName: row.decidedById
+                    ? (people.get(row.decidedById) ?? null)
+                    : null,
+                decidedAt: row.decidedAt === null ? null : iso(row.decidedAt),
+                comment: row.comment,
+                createdAt: iso(row.createdAt),
+                updatedAt: iso(row.updatedAt),
+            };
+        });
+    }
+    async function viewOne(conn, id) {
+        const row = await findRequest(conn, id);
+        if (!row)
+            throw notFound('Approval request');
+        const [request] = await view(conn, [row]);
+        return request;
+    }
+    /** Takes a pending request to `status` through its lifecycle, with its activity and event. */
+    async function close(tx, row, status, actor, details = {}) {
+        try {
+            await move(machine(), approvalRules, {
+                from: row.status,
+                to: status,
+                actor: { type: actor.type, id: actor.id },
+                subject: row,
+                context: tx,
+            }, async () => {
+                const decided = await decideRequest(tx.conn, row.id, {
+                    status,
+                    decidedById: status === 'stale' ? null : actor.id,
+                    ...(details.comment === undefined
+                        ? {}
+                        : { comment: details.comment }),
+                });
+                if (!decided)
+                    throw conflict('APPROVAL_DECIDED', 'This request was decided meanwhile.');
+            });
+        }
+        catch (error) {
+            if (error instanceof LifecycleError &&
+                error.code === 'TRANSITION_NOT_ALLOWED')
+                throw status === 'withdrawn'
+                    ? forbidden('Only whoever asked may withdraw this request.', 'NOT_REQUESTER')
+                    : forbidden('Only an approver of this request may decide it.', 'NOT_APPROVER');
+            throw error;
+        }
+        await deps.activity.record(tx.conn, {
+            issueId: row.issueId,
+            actor,
+            action: `approval_${status}`,
+            details: {
+                requestId: row.id,
+                from: row.fromStatus,
+                to: row.toStatus,
+                ...details,
+            },
+        });
+        const issue = await deps.moves().find(tx.conn, row.issueId);
+        tx.emit({
+            type: 'approval.decided',
+            requestId: row.id,
+            issueId: row.issueId,
+            identifier: issue?.identifier ?? '',
+            title: issue?.title ?? '',
+            status,
+            toStatus: row.toStatus,
+            toStatusName: issue
+                ? await deps.moves().statusName(tx.conn, issue, row.toStatus)
+                : row.toStatus,
+            requestedBy: { type: row.requestedByType, id: row.requestedById },
+            ownerUserId: issue?.ownerUserId ?? null,
+            approverUserIds: listOf(row.approverUserIds),
+            decidedById: status === 'stale' ? null : actor.id,
+            staleReason: status === 'stale' && typeof details.code === 'string'
+                ? {
+                    code: details.code,
+                    message: typeof details.message === 'string' ? details.message : null,
+                    attemptedById: typeof details.attemptedById === 'string'
+                        ? details.attemptedById
+                        : null,
+                }
+                : null,
+            comment: typeof details.comment === 'string' && details.comment
+                ? details.comment
+                : null,
+        });
+        tx.emit({ type: 'issue.changed', issueId: row.issueId });
+    }
+    async function pending(tx, id) {
+        const row = await findRequest(tx.conn, id);
+        if (!row)
+            throw notFound('Approval request');
+        if (row.status !== 'pending')
+            throw conflict('APPROVAL_DECIDED', `This request is ${row.status}.`);
+        return row;
+    }
+    return {
+        async mine(viewer) {
+            const conn = deps.tx.read();
+            const rows = (await allPending(conn, PENDING_LIMIT)).filter((row) => listOf(row.approverUserIds).includes(viewer.userId));
+            return view(conn, rows);
+        },
+        approve(viewer, id, input) {
+            const comment = commentOf(input);
+            return deps.tx.run(async (tx) => {
+                const row = await pending(tx, id);
+                const allowed = await canMove(machine(), approvalRules, {
+                    from: 'pending',
+                    to: 'approved',
+                    actor: { type: viewer.actor.type, id: viewer.actor.id },
+                    subject: row,
+                    context: tx,
+                });
+                if (!allowed.ok)
+                    throw forbidden('Only an approver of this request may decide it.', 'NOT_APPROVER');
+                const failure = await deps.moves().apply(tx, row, viewer.actor);
+                if (failure)
+                    await close(tx, row, 'stale', SYSTEM_ACTOR, {
+                        code: failure.code,
+                        message: failure.message,
+                        attemptedById: viewer.actor.id,
+                    });
+                else
+                    await close(tx, row, 'approved', viewer.actor, { comment });
+                return viewOne(tx.conn, id);
+            });
+        },
+        reject(viewer, id, input) {
+            const comment = commentOf(input);
+            return deps.tx.run(async (tx) => {
+                await close(tx, await pending(tx, id), 'rejected', viewer.actor, {
+                    comment,
+                });
+                return viewOne(tx.conn, id);
+            });
+        },
+        withdraw(viewer, id) {
+            return deps.tx.run(async (tx) => {
+                await close(tx, await pending(tx, id), 'withdrawn', viewer.actor);
+                return viewOne(tx.conn, id);
+            });
+        },
+        async request(tx, input) {
+            const { issue, actor } = input;
+            if ((await pendingOf(tx.conn, issue.id)).length > 0)
+                throw conflict('APPROVAL_PENDING', `A status change of ${issue.identifier} is already waiting for approval.`);
+            if (actor.type === 'system' || actor.id === null)
+                throw invalid('APPROVAL_REQUESTER', 'Only a person or another registered kind asks for an approval.');
+            const id = deps.ids.next();
+            await insertRequest(tx.conn, {
+                id,
+                issueId: issue.id,
+                fromStatus: issue.statusKey,
+                toStatus: input.toStatus,
+                requestedByType: actor.type,
+                requestedById: actor.id,
+                approvers: input.approvers,
+                approverUserIds: input.approverIds,
+                status: 'pending',
+                decidedById: null,
+                decidedAt: null,
+                comment: null,
+            });
+            await deps.activity.record(tx.conn, {
+                issueId: issue.id,
+                actor,
+                action: 'approval_requested',
+                details: {
+                    requestId: id,
+                    from: issue.statusKey,
+                    to: input.toStatus,
+                    approverUserIds: input.approverIds,
+                },
+            });
+            tx.emit({
+                type: 'approval.requested',
+                requestId: id,
+                issueId: issue.id,
+                identifier: issue.identifier,
+                title: issue.title,
+                fromStatus: issue.statusKey,
+                toStatus: input.toStatus,
+                toStatusName: await deps
+                    .moves()
+                    .statusName(tx.conn, issue, input.toStatus),
+                approverUserIds: input.approverIds,
+            });
+            tx.emit({ type: 'issue.changed', issueId: issue.id });
+            return viewOne(tx.conn, id);
+        },
+        async supersede(tx, issueId, statusKey, except) {
+            for (const row of await pendingOf(tx.conn, issueId))
+                if (row.fromStatus !== statusKey && row.id !== except)
+                    await close(tx, row, 'stale', SYSTEM_ACTOR, {
+                        code: 'STATUS_CHANGED',
+                    });
+        },
+        async pendingOn(issueIds) {
+            const conn = deps.tx.read();
+            return view(conn, await pendingOfEach(conn, [...new Set(issueIds)]));
+        },
+        async decidedFor(conn, issueId) {
+            return view(conn, await decidedOf(conn, issueId, RECENT_DECIDED_APPROVALS));
+        },
+        async pendingFor(conn, issueId) {
+            const [row] = await pendingOf(conn, issueId);
+            if (!row)
+                return null;
+            const [request] = await view(conn, [row]);
+            return request ?? null;
+        },
+    };
+}
+//# sourceMappingURL=approval.service.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * `pmApprovalRequests`: status changes waiting for, or decided by, an approver.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import type { ApprovalStatus } from '../../../shared/approvals.js';
+import type { ApproverRole } from '../../../shared/workflows.js';
+export declare const APPROVAL_REQUESTS = "pmApprovalRequests";
+export interface ApprovalRecord {
+    readonly id: string;
+    readonly issueId: string;
+    readonly fromStatus: string;
+    readonly toStatus: string;
+    /** A kind's key (`shared/kinds.ts`). */
+    readonly requestedByType: string;
+    readonly requestedById: string;
+    readonly approvers: readonly ApproverRole[] | string;
+    readonly approverUserIds: readonly string[] | string;
+    readonly status: ApprovalStatus;
+    readonly decidedById: string | null;
+    readonly decidedAt: Date | string | null;
+    readonly comment: string | null;
+    readonly createdAt: Date | string;
+    readonly updatedAt: Date | string;
+}
+export declare const listOf: <T>(value: readonly T[] | string) => readonly T[];
+export declare function findRequest(conn: DatabaseConnection, id: string): Promise<ApprovalRecord | undefined>;
+/** The issue's pending requests, oldest first (there is at most one). */
+export declare function pendingOf(conn: DatabaseConnection, issueId: string): Promise<ApprovalRecord[]>;
+/** The pending requests on any of `issueIds`, oldest first. */
+export declare function pendingOfEach(conn: DatabaseConnection, issueIds: readonly string[]): Promise<ApprovalRecord[]>;
+/** The issue's decided requests (any status but pending), the most recently decided first, up to `limit`. */
+export declare function decidedOf(conn: DatabaseConnection, issueId: string, limit: number): Promise<ApprovalRecord[]>;
+/** Every pending request, newest first, up to `limit`. */
+export declare function allPending(conn: DatabaseConnection, limit: number): Promise<ApprovalRecord[]>;
+export declare function insertRequest(conn: DatabaseConnection, row: Omit<ApprovalRecord, 'createdAt' | 'updatedAt'>): Promise<void>;
+/** Moves a pending request on; false when it was no longer pending. */
+export declare function decideRequest(conn: DatabaseConnection, id: string, values: {
+    readonly status: Exclude<ApprovalStatus, 'pending'>;
+    readonly decidedById: string | null;
+    readonly comment?: string | null;
+}): Promise<boolean>;
+//# sourceMappingURL=approval.store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approval.store.d.ts","sourceRoot":"","sources":["../../../../server/domains/approvals/approval.store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;CACnC;AAKD,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,OAAO,SAAS,CAAC,EAAE,GAAG,MAAM,KAAG,SAAS,CAAC,EACH,CAAC;AAEjE,wBAAgB,WAAW,CACzB,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAErC;AAED,yEAAyE;AACzE,wBAAsB,SAAS,CAC7B,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,EAAE,CAAC,CAK3B;AAED,+DAA+D;AAC/D,wBAAsB,aAAa,CACjC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAU3B;AAED,6GAA6G;AAC7G,wBAAsB,SAAS,CAC7B,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC,CAU3B;AAED,0DAA0D;AAC1D,wBAAsB,UAAU,CAC9B,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC,CAM3B;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,uEAAuE;AACvE,wBAAsB,aAAa,CACjC,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IACN,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GACA,OAAO,CAAC,OAAO,CAAC,CAOlB"}

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

@@ -0,0 +1,66 @@
+export const APPROVAL_REQUESTS = 'pmApprovalRequests';
+const requests = (conn) => conn.repository(APPROVAL_REQUESTS);
+export const listOf = (value) => typeof value === 'string' ? JSON.parse(value) : value;
+export function findRequest(conn, id) {
+    return requests(conn).findOne({ filter: { id } });
+}
+/** The issue's pending requests, oldest first (there is at most one). */
+export async function pendingOf(conn, issueId) {
+    return await requests(conn).findMany({
+        filter: { issueId, status: 'pending' },
+        sort: (sort) => sort.field('createdAt').asc(),
+    });
+}
+/** The pending requests on any of `issueIds`, oldest first. */
+export async function pendingOfEach(conn, issueIds) {
+    if (issueIds.length === 0)
+        return [];
+    return await requests(conn).findMany({
+        filter: (f) => f.and([
+            f.string('status').eq('pending'),
+            f.or(issueIds.map((id) => f.string('issueId').eq(id))),
+        ]),
+        sort: (sort) => sort.field('createdAt').asc(),
+    });
+}
+/** The issue's decided requests (any status but pending), the most recently decided first, up to `limit`. */
+export async function decidedOf(conn, issueId, limit) {
+    return await requests(conn).findMany({
+        filter: (f) => f.and([
+            f.string('issueId').eq(issueId),
+            f.string('status').ne('pending'),
+        ]),
+        sort: (sort) => sort.field('updatedAt').desc(),
+        limit,
+    });
+}
+/** Every pending request, newest first, up to `limit`. */
+export async function allPending(conn, limit) {
+    return await requests(conn).findMany({
+        filter: { status: 'pending' },
+        sort: (sort) => sort.field('createdAt').desc(),
+        limit,
+    });
+}
+export async function insertRequest(conn, row) {
+    const now = new Date();
+    await requests(conn).createOne({
+        values: {
+            ...row,
+            approvers: [...listOf(row.approvers)],
+            approverUserIds: [...listOf(row.approverUserIds)],
+            createdAt: now,
+            updatedAt: now,
+        },
+    });
+}
+/** Moves a pending request on; false when it was no longer pending. */
+export async function decideRequest(conn, id, values) {
+    const now = new Date();
+    const result = await requests(conn).updateMany({
+        filter: { id, status: 'pending' },
+        values: { ...values, decidedAt: now, updatedAt: now },
+    });
+    return result.updatedCount > 0;
+}
+//# sourceMappingURL=approval.store.js.map