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

package/dist/server/domains/attachments/attachment.storage.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Where a file's bytes go: the file plugin's server repository stores them on a Drive disk and inserts the row
+ * (`pmAttachments`, stamped with the uploader and attached to nothing), and the Drive manager reads and deletes them.
+ * Both are asked on each use; without the file plugin (or Drive) every operation is 400 `FILES_UNAVAILABLE`.
+ *
+ * Nothing is served at the repository's access path: the plugin's own content route is public by design, so this
+ * plugin streams the bytes itself, after checking who may read them (`attachment.routes.ts`).
+ */
+import { Readable } from 'node:stream';
+import { DomainError } from '../../kernel/errors.js';
+import { type UploaderRef } from './attachment.store.js';
+/** Required by the file repository; nothing is served there. */
+export declare const ATTACHMENTS_ACCESS_PATH = "/uploads/pm-attachments";
+/** The file plugin's server repository, as far as uploading goes (`ServerFileRepositoryManager`). */
+export interface FileUploader {
+    repository(collection: string, options: {
+        readonly disk: string;
+        readonly accessPath: string;
+        readonly policy: {
+            readonly read: true;
+            readonly create: {
+                readonly scope: true;
+                readonly defaults: Readonly<Record<string, string>>;
+            };
+            readonly update: false;
+            readonly delete: false;
+        };
+    }): {
+        uploadOne(input: {
+            readonly file: File;
+        }): Promise<{
+            readonly record: {
+                readonly id: string;
+            };
+        }>;
+    };
+}
+/** A Drive manager, as far as reading and deleting go. */
+export interface FileDisks {
+    use(disk: string): {
+        getBytes(key: string): Promise<Uint8Array>;
+        getStream(key: string): Promise<Readable>;
+        delete(key: string): Promise<void>;
+    };
+}
+/** Where a stored file's bytes are. */
+export interface StoredObject {
+    readonly disk: string;
+    readonly key: string;
+}
+export interface AttachmentStorage {
+    /** Stores the bytes and inserts the row, attached to nothing; answers its id. */
+    store(file: File, uploader: UploaderRef): Promise<string>;
+    bytes(object: StoredObject): Promise<Uint8Array>;
+    stream(object: StoredObject): Promise<ReadableStream<Uint8Array>>;
+    /** Deletes the bytes; a failure leaves an orphan object, never a broken row, and is only logged. */
+    remove(object: StoredObject): Promise<void>;
+}
+export interface AttachmentStorageDeps {
+    /** Null when the application registers no file plugin. */
+    readonly uploader: () => FileUploader | null;
+    readonly disks: () => FileDisks | null;
+    /** The Drive disk new files go to. */
+    readonly disk: () => string;
+    readonly onError?: (error: unknown) => void;
+}
+export declare function filesUnavailable(): DomainError;
+export declare function createAttachmentStorage(deps: AttachmentStorageDeps): AttachmentStorage;
+//# sourceMappingURL=attachment.storage.d.ts.map

package/dist/server/domains/attachments/attachment.storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.storage.d.ts","sourceRoot":"","sources":["../../../../server/domains/attachments/attachment.storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEtE,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AAEjE,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;QACP,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,EAAE;YACf,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;YACpB,QAAQ,CAAC,MAAM,EAAE;gBACf,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;gBACrB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;aACrD,CAAC;YACF,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;SACxB,CAAC;KACH,GACA;QACD,SAAS,CAAC,KAAK,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;SAAE,GAAG,OAAO,CAAC;YACjD,QAAQ,CAAC,MAAM,EAAE;gBAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC;SAC1C,CAAC,CAAC;KACJ,CAAC;CACH;AAED,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG;QACjB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpC,CAAC;CACH;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IAClE,oGAAoG;IACpG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IACvC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAM9C;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,iBAAiB,CA2CnB"}

package/dist/server/domains/attachments/attachment.storage.js

@@ -0,0 +1,64 @@
+/**
+ * Where a file's bytes go: the file plugin's server repository stores them on a Drive disk and inserts the row
+ * (`pmAttachments`, stamped with the uploader and attached to nothing), and the Drive manager reads and deletes them.
+ * Both are asked on each use; without the file plugin (or Drive) every operation is 400 `FILES_UNAVAILABLE`.
+ *
+ * Nothing is served at the repository's access path: the plugin's own content route is public by design, so this
+ * plugin streams the bytes itself, after checking who may read them (`attachment.routes.ts`).
+ */
+import { Readable } from 'node:stream';
+import { DomainError } from '../../kernel/errors.js';
+import { ATTACHMENTS } from './attachment.store.js';
+/** Required by the file repository; nothing is served there. */
+export const ATTACHMENTS_ACCESS_PATH = '/uploads/pm-attachments';
+export function filesUnavailable() {
+    return new DomainError('invalid', 'FILES_UNAVAILABLE', 'This application stores no files.');
+}
+export function createAttachmentStorage(deps) {
+    const disks = () => {
+        const found = deps.disks();
+        if (!found)
+            throw filesUnavailable();
+        return found;
+    };
+    return {
+        async store(file, uploader) {
+            const repository = deps.uploader();
+            if (!repository)
+                throw filesUnavailable();
+            const { record } = await repository
+                .repository(ATTACHMENTS, {
+                disk: deps.disk(),
+                accessPath: ATTACHMENTS_ACCESS_PATH,
+                policy: {
+                    read: true,
+                    create: {
+                        scope: true,
+                        defaults: {
+                            uploaderType: uploader.type,
+                            uploaderId: uploader.id,
+                        },
+                    },
+                    update: false,
+                    delete: false,
+                },
+            })
+                .uploadOne({ file });
+            return String(record.id);
+        },
+        bytes: (object) => disks().use(object.disk).getBytes(object.key),
+        async stream(object) {
+            const stream = await disks().use(object.disk).getStream(object.key);
+            return Readable.toWeb(stream);
+        },
+        async remove(object) {
+            try {
+                await deps.disks()?.use(object.disk).delete(object.key);
+            }
+            catch (error) {
+                deps.onError?.(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=attachment.storage.js.map

package/dist/server/domains/attachments/attachment.storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.storage.js","sourceRoot":"","sources":["../../../../server/domains/attachments/attachment.storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAoB,MAAM,uBAAuB,CAAC;AAEtE,gEAAgE;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AA2DjE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,WAAW,CACpB,SAAS,EACT,mBAAmB,EACnB,mCAAmC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAA2B;IAE3B,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,MAAM,gBAAgB,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ;YACxB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,UAAU;gBAAE,MAAM,gBAAgB,EAAE,CAAC;YAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU;iBAChC,UAAU,CAAC,WAAW,EAAE;gBACvB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;gBACjB,UAAU,EAAE,uBAAuB;gBACnC,MAAM,EAAE;oBACN,IAAI,EAAE,IAAI;oBACV,MAAM,EAAE;wBACN,KAAK,EAAE,IAAI;wBACX,QAAQ,EAAE;4BACR,YAAY,EAAE,QAAQ,CAAC,IAAI;4BAC3B,UAAU,EAAE,QAAQ,CAAC,EAAE;yBACxB;qBACF;oBACD,MAAM,EAAE,KAAK;oBACb,MAAM,EAAE,KAAK;iBACd;aACF,CAAC;iBACD,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACvB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;QAChE,KAAK,CAAC,MAAM,CAAC,MAAM;YACjB,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpE,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAA+B,CAAC;QAC9D,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,MAAM;YACjB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/domains/attachments/attachment.store.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `pmAttachments`. Only this file reads or writes it; the file plugin's repository inserts the rows (`storage.ts`).
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+export declare const ATTACHMENTS = "pmAttachments";
+export interface AttachmentRecord {
+    readonly id: string;
+    readonly disk: string;
+    readonly key: string;
+    readonly filename: string;
+    readonly ext: string;
+    readonly mimeType: string;
+    readonly size: string | number;
+    readonly uploaderType: string;
+    readonly uploaderId: string;
+    readonly issueId: string | null;
+    readonly commentId: string | null;
+    readonly createdAt: Date | string;
+    readonly updatedAt: Date | string;
+}
+/** Who uploaded a file, as stored. */
+export interface UploaderRef {
+    readonly type: string;
+    readonly id: string;
+}
+export declare function findAttachment(conn: DatabaseConnection, id: string): Promise<AttachmentRecord | undefined>;
+/** The rows named, in no particular order; ids that are not uuids match nothing. */
+export declare function findAttachments(conn: DatabaseConnection, ids: readonly string[]): Promise<AttachmentRecord[]>;
+/** An issue's own files (not its comments'), oldest first. */
+export declare function issueAttachments(conn: DatabaseConnection, issueId: string): Promise<AttachmentRecord[]>;
+/** The files of an issue's comments that are not deleted, oldest first. */
+export declare function liveCommentAttachments(conn: DatabaseConnection, issueId: string): Promise<AttachmentRecord[]>;
+/** The files of the comments named, oldest first. */
+export declare function commentAttachments(conn: DatabaseConnection, commentIds: readonly string[]): Promise<AttachmentRecord[]>;
+/** Attaches the rows to an issue, and to one of its comments when `commentId` is set. */
+export declare function attachRows(conn: DatabaseConnection, ids: readonly string[], target: {
+    readonly issueId: string;
+    readonly commentId: string | null;
+}): Promise<void>;
+export declare function deleteAttachment(conn: DatabaseConnection, id: string): Promise<void>;
+/** Uploads attached to nothing, oldest first, at most `limit`. */
+export declare function unattached(conn: DatabaseConnection, limit: number): Promise<AttachmentRecord[]>;
+/** Files of comments that were deleted, at most `limit`. */
+export declare function ofDeletedComments(conn: DatabaseConnection, limit: number): Promise<AttachmentRecord[]>;
+/** Deletes the row only while it is still attached to nothing; answers whether it did. */
+export declare function deleteIfUnattached(conn: DatabaseConnection, id: string): Promise<boolean>;
+/** File ids are the file plugin's uuids; anything else names no file (and must not reach a uuid column). */
+export declare function isUuid(value: string): boolean;
+//# sourceMappingURL=attachment.store.d.ts.map

package/dist/server/domains/attachments/attachment.store.d.ts.map

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

package/dist/server/domains/attachments/attachment.store.js

@@ -0,0 +1,95 @@
+import { oneOf } from '../../kernel/db.js';
+export const ATTACHMENTS = 'pmAttachments';
+const files = (conn) => conn.repository(ATTACHMENTS);
+export async function findAttachment(conn, id) {
+    if (!isUuid(id))
+        return undefined;
+    return (await files(conn).findOne({ filter: { id } })) ?? undefined;
+}
+/** The rows named, in no particular order; ids that are not uuids match nothing. */
+export async function findAttachments(conn, ids) {
+    const wanted = ids.filter(isUuid);
+    if (wanted.length === 0)
+        return [];
+    return files(conn).findMany({ filter: (f) => oneOf(f, 'id', wanted) });
+}
+/** An issue's own files (not its comments'), oldest first. */
+export async function issueAttachments(conn, issueId) {
+    return files(conn).findMany({
+        filter: (f) => f.and([f.string('issueId').eq(issueId), f.string('commentId').eq(null)]),
+        sort: (sort) => [sort.field('createdAt').asc(), sort.field('id').asc()],
+    });
+}
+/** The files of an issue's comments that are not deleted, oldest first. */
+export async function liveCommentAttachments(conn, issueId) {
+    const rows = await files(conn).findMany({
+        filter: (f) => f.and([f.string('issueId').eq(issueId), f.string('commentId').ne(null)]),
+        sort: (sort) => [sort.field('createdAt').asc(), sort.field('id').asc()],
+    });
+    const commentIds = [
+        ...new Set(rows.map((row) => row.commentId).filter((id) => id !== null)),
+    ];
+    if (commentIds.length === 0)
+        return [];
+    const live = new Set((await conn
+        .repository('pmComments')
+        .findMany({
+        filter: (f) => f.and([oneOf(f, 'id', commentIds), f.date('deletedAt').empty()]),
+        select: (select) => select.fields('id'),
+    })).map((comment) => comment.id));
+    return rows.filter((row) => row.commentId !== null && live.has(row.commentId));
+}
+/** The files of the comments named, oldest first. */
+export async function commentAttachments(conn, commentIds) {
+    if (commentIds.length === 0)
+        return [];
+    return files(conn).findMany({
+        filter: (f) => oneOf(f, 'commentId', commentIds),
+        sort: (sort) => [sort.field('createdAt').asc(), sort.field('id').asc()],
+    });
+}
+/** Attaches the rows to an issue, and to one of its comments when `commentId` is set. */
+export async function attachRows(conn, ids, target) {
+    if (ids.length === 0)
+        return;
+    await files(conn).updateMany({
+        filter: (f) => f.and([oneOf(f, 'id', ids), f.string('issueId').eq(null)]),
+        values: { ...target, updatedAt: new Date() },
+    });
+}
+export async function deleteAttachment(conn, id) {
+    await files(conn).deleteMany({ filter: { id } });
+}
+/** Uploads attached to nothing, oldest first, at most `limit`. */
+export async function unattached(conn, limit) {
+    return files(conn).findMany({
+        filter: (f) => f.string('issueId').eq(null),
+        sort: (sort) => [sort.field('createdAt').asc(), sort.field('id').asc()],
+        limit,
+    });
+}
+/** Files of comments that were deleted, at most `limit`. */
+export async function ofDeletedComments(conn, limit) {
+    return files(conn).findMany({
+        filter: (f) => f.and([
+            f.string('commentId').ne(null),
+            f
+                .relation('comment')
+                .some((comment) => comment.date('deletedAt').notEmpty()),
+        ]),
+        limit,
+    });
+}
+/** Deletes the row only while it is still attached to nothing; answers whether it did. */
+export async function deleteIfUnattached(conn, id) {
+    await files(conn).deleteMany({
+        filter: (f) => f.and([f.string('id').eq(id), f.string('issueId').eq(null)]),
+    });
+    return !(await files(conn).findOne({ filter: { id } }));
+}
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
+/** File ids are the file plugin's uuids; anything else names no file (and must not reach a uuid column). */
+export function isUuid(value) {
+    return UUID.test(value);
+}
+//# sourceMappingURL=attachment.store.js.map

package/dist/server/domains/attachments/attachment.store.js.map

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

package/dist/server/domains/attachments/index.d.ts

@@ -0,0 +1,5 @@
+export { createAttachmentService, readAttachmentIds, requireUploader, uploaderOf, type AttachmentContent, type AttachmentDeps, type AttachmentLinks, type AttachmentService, } from './attachment.service.js';
+export { ATTACHMENTS_ACCESS_PATH, createAttachmentStorage, filesUnavailable, type AttachmentStorage, type AttachmentStorageDeps, type FileDisks, type FileUploader, type StoredObject, } from './attachment.storage.js';
+export { ATTACHMENTS, findAttachment, findAttachments, type AttachmentRecord, type UploaderRef, } from './attachment.store.js';
+export { contentDisposition, contentHeaders, createAttachmentRoutes, createIssueAttachmentRoutes, } from './attachment.routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/domains/attachments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/domains/attachments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC"}

package/dist/server/domains/attachments/index.js

@@ -0,0 +1,5 @@
+export { createAttachmentService, readAttachmentIds, requireUploader, uploaderOf, } from './attachment.service.js';
+export { ATTACHMENTS_ACCESS_PATH, createAttachmentStorage, filesUnavailable, } from './attachment.storage.js';
+export { ATTACHMENTS, findAttachment, findAttachments, } from './attachment.store.js';
+export { contentDisposition, contentHeaders, createAttachmentRoutes, createIssueAttachmentRoutes, } from './attachment.routes.js';
+//# sourceMappingURL=index.js.map

package/dist/server/domains/attachments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/domains/attachments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,UAAU,GAKX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,GAMjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,GAGhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC"}

package/dist/server/domains/checklists/checklist.routes.d.ts

@@ -0,0 +1,9 @@
+import type { Hono } from 'hono';
+import { type ViewerEnv } from '../../access/request.js';
+import type { ChecklistService } from './checklist.service.js';
+/**
+ * Under `/api/projects/issues`: `GET /{issueId}/checklists` (every checklist the issue has had) and
+ * `PATCH /{issueId}/checklists/{statusKey}/items/{itemKey} { checked }` (the checklist after the change).
+ */
+export declare function createChecklistRoutes(checklists: ChecklistService): Hono<ViewerEnv>;
+//# sourceMappingURL=checklist.routes.d.ts.map

package/dist/server/domains/checklists/checklist.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist.routes.d.ts","sourceRoot":"","sources":["../../../../server/domains/checklists/checklist.routes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AASnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CAAC,SAAS,CAAC,CAgFjB"}

package/dist/server/domains/checklists/checklist.routes.js

@@ -0,0 +1,62 @@
+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 { BoundedListMeta, ChecklistItemParams, IssueChecklistSchema, IssueParams, UpdateChecklistItemBody, } from '../../routes/schemas.js';
+/**
+ * Under `/api/projects/issues`: `GET /{issueId}/checklists` (every checklist the issue has had) and
+ * `PATCH /{issueId}/checklists/{statusKey}/items/{itemKey} { checked }` (the checklist after the change).
+ */
+export function createChecklistRoutes(checklists) {
+    const routes = domainRouter();
+    routes.get('/:issueId/checklists', describeRoute({
+        tags,
+        summary: 'List an issue’s checklists',
+        operationId: 'projectsListIssueChecklists',
+        ...cliRoute({
+            command: 'issue checklist list',
+            flags: { issueId: { name: 'issue' } },
+            columns: ['statusKey', 'current', 'complete', 'items.length'],
+            action: 'pm.issues/view',
+        }),
+        description: 'Every checklist the issue has had, one per status, the current status’s first. `issueId` is an id or an identifier.',
+        responses: {
+            200: listResponse(IssueChecklistSchema, BoundedListMeta),
+            ...apiErrorResponses,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', IssueParams), async (context) => context.json(boundedList(await checklists.list(viewerOf(context), context.req.valid('param').issueId))));
+    routes.patch('/:issueId/checklists/:statusKey/items/:itemKey', describeRoute({
+        tags,
+        summary: 'Check or uncheck a checklist item',
+        operationId: 'projectsUpdateChecklistItem',
+        ...cliRoute({
+            command: 'issue checklist mark',
+            flags: {
+                issueId: { name: 'issue' },
+                statusKey: { name: 'status' },
+                itemKey: { name: 'item' },
+                checked: {
+                    description: '`--checked` ticks the item, `--no-checked` clears it.',
+                },
+            },
+            action: 'pm.issues/edit',
+            examples: [
+                'issue checklist mark PM-12 in_review tests-pass --checked',
+                'issue checklist mark PM-12 in_review tests-pass --no-checked',
+            ],
+        }),
+        description: 'Needs `edit` on the issue. Answers the checklist after the change.',
+        responses: {
+            200: dataResponse(IssueChecklistSchema),
+            ...apiErrorResponses,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', ChecklistItemParams), apiValidator('json', UpdateChecklistItemBody), async (context) => {
+        const { issueId, statusKey, itemKey } = context.req.valid('param');
+        return context.json({
+            data: await checklists.set(viewerOf(context), issueId, statusKey, itemKey, context.req.valid('json')),
+        });
+    });
+    return routes;
+}
+//# sourceMappingURL=checklist.routes.js.map

package/dist/server/domains/checklists/checklist.routes.js.map

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

package/dist/server/domains/checklists/checklist.service.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Issue checklists. The workflow's `checklist` rule (`domains/workflows/workflow.registry.ts`) copies a status's items
+ * to an issue when it enters the status, and refuses to let it leave (except to a closed status) while required items
+ * are unchecked. Here people see the copies and check them: anyone who may see and edit the issue. Each change is an
+ * activity (`checklist_item_checked` / `_unchecked`).
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import type { IssueChecklist, UpdateChecklistItemRequest } from '../../../shared/checklists.js';
+import type { Issue } from '../../../shared/issues.js';
+import type { Viewer } from '../../access/viewer.js';
+import type { ActivityRecorder } from '../../kernel/activity.js';
+import type { TxRunner } from '../../kernel/tx.js';
+import type { KindRegistry } from '../../kernel/kinds.js';
+export interface ChecklistService {
+    /** Every checklist the issue has had, the current status's first. */
+    list(viewer: Viewer, idOrKey: string): Promise<IssueChecklist[]>;
+    set(viewer: Viewer, idOrKey: string, statusKey: string, itemKey: string, input: UpdateChecklistItemRequest): Promise<IssueChecklist>;
+    /** The checklist of the issue's current status, or null; for the issue page. */
+    current(conn: DatabaseConnection, issue: Pick<Issue, 'id' | 'statusKey'>): Promise<IssueChecklist | null>;
+}
+export declare function createChecklistService(deps: {
+    readonly tx: TxRunner;
+    readonly kinds: KindRegistry;
+    readonly activity: ActivityRecorder;
+}): ChecklistService;
+//# sourceMappingURL=checklist.service.d.ts.map

package/dist/server/domains/checklists/checklist.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist.service.d.ts","sourceRoot":"","sources":["../../../../server/domains/checklists/checklist.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAEV,cAAc,EACd,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQ1D,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACjE,GAAG,CACD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,gFAAgF;IAChF,OAAO,CACL,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,CAAC,GACrC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACnC;AAKD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC,GAAG,gBAAgB,CAyFnB"}

package/dist/server/domains/checklists/checklist.service.js

@@ -0,0 +1,80 @@
+import { invalid, notFound } from '../../kernel/errors.js';
+import { requireEditor, requireVisible } from '../issues/issue.access.js';
+import { findItems, setChecked, } from './checklist.store.js';
+const iso = (value) => value instanceof Date ? value.toISOString() : new Date(value).toISOString();
+export function createChecklistService(deps) {
+    async function checklists(conn, issue, statusKey) {
+        const rows = await findItems(conn, issue.id, statusKey);
+        const name = await deps.kinds.nameAll(conn, rows.map((row) => ({ type: row.checkedByType, id: row.checkedById })));
+        const item = (row) => ({
+            itemKey: row.itemKey,
+            label: row.label,
+            required: Boolean(row.required),
+            checked: row.checkedAt !== null,
+            checkedByType: row.checkedByType,
+            checkedById: row.checkedById,
+            checkedByName: name(row.checkedByType, row.checkedById),
+            checkedAt: row.checkedAt === null ? null : iso(row.checkedAt),
+        });
+        const groups = new Map();
+        for (const row of rows)
+            groups.set(row.statusKey, [
+                ...(groups.get(row.statusKey) ?? []),
+                item(row),
+            ]);
+        const lists = [...groups].map(([key, items]) => ({
+            statusKey: key,
+            current: key === issue.statusKey,
+            complete: items.every((entry) => !entry.required || entry.checked),
+            items,
+        }));
+        return [
+            ...lists.filter((list) => list.current),
+            ...lists.filter((list) => !list.current),
+        ];
+    }
+    return {
+        async list(viewer, idOrKey) {
+            const conn = deps.tx.read();
+            return checklists(conn, await requireVisible(conn, viewer, idOrKey));
+        },
+        set(viewer, idOrKey, statusKey, itemKey, input) {
+            if (typeof input?.checked !== 'boolean')
+                throw invalid('INVALID_FIELD', 'checked must be true or false.');
+            const checked = input.checked;
+            return deps.tx.run(async (tx) => {
+                const issue = await requireVisible(tx.conn, viewer, idOrKey);
+                requireEditor(viewer);
+                const row = (await findItems(tx.conn, issue.id, statusKey)).find((entry) => entry.itemKey === itemKey);
+                if (!row)
+                    throw notFound('Checklist item');
+                if ((row.checkedAt !== null) !== checked) {
+                    await setChecked(tx.conn, row.id, checked && viewer.actor.id
+                        ? { type: viewer.actor.type, id: viewer.actor.id }
+                        : null);
+                    await deps.activity.record(tx.conn, {
+                        issueId: issue.id,
+                        actor: viewer.actor,
+                        action: checked
+                            ? 'checklist_item_checked'
+                            : 'checklist_item_unchecked',
+                        details: {
+                            statusKey,
+                            itemKey,
+                            label: row.label,
+                            required: Boolean(row.required),
+                        },
+                    });
+                    tx.emit({ type: 'issue.changed', issueId: issue.id });
+                }
+                const [list] = await checklists(tx.conn, issue, statusKey);
+                return list;
+            });
+        },
+        async current(conn, issue) {
+            const [list] = await checklists(conn, issue, issue.statusKey);
+            return list ?? null;
+        },
+    };
+}
+//# sourceMappingURL=checklist.service.js.map

package/dist/server/domains/checklists/checklist.service.js.map

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

package/dist/server/domains/checklists/checklist.store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `pmIssueChecklistItems`: each issue's copy of the checklist of a status it entered, one row per item.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import type { ChecklistItemDefinition } from '../../../shared/workflows.js';
+export declare const CHECKLIST_ITEMS = "pmIssueChecklistItems";
+export interface ChecklistItemRecord {
+    readonly id: string;
+    readonly issueId: string;
+    readonly statusKey: string;
+    readonly itemKey: string;
+    readonly label: string;
+    readonly required: boolean | number;
+    readonly position: number;
+    /** A kind's key (`shared/kinds.ts`). */
+    readonly checkedByType: string | null;
+    readonly checkedById: string | null;
+    readonly checkedAt: Date | string | null;
+    readonly createdAt: Date | string;
+    readonly updatedAt: Date | string;
+}
+/** The issue's items, of one status or of all, in the order they were added and then by position. */
+export declare function findItems(conn: DatabaseConnection, issueId: string, statusKey?: string): Promise<ChecklistItemRecord[]>;
+/** Adds the items the issue's copy of `statusKey` lacks; returns how many. */
+export declare function addMissingItems(conn: DatabaseConnection, nextId: () => string, issueId: string, statusKey: string, definitions: readonly ChecklistItemDefinition[]): Promise<number>;
+/** The labels of the required items of `statusKey` nobody checked yet. */
+export declare function uncheckedRequired(conn: DatabaseConnection, issueId: string, statusKey: string): Promise<string[]>;
+export declare function setChecked(conn: DatabaseConnection, id: string, checkedBy: {
+    readonly type: string;
+    readonly id: string;
+} | null): Promise<void>;
+//# sourceMappingURL=checklist.store.d.ts.map

package/dist/server/domains/checklists/checklist.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist.store.d.ts","sourceRoot":"","sources":["../../../../server/domains/checklists/checklist.store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;CACnC;AAKD,qGAAqG;AACrG,wBAAsB,SAAS,CAC7B,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAQhC;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CACnC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,MAAM,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,SAAS,uBAAuB,EAAE,GAC9C,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED,0EAA0E;AAC1E,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC/D,OAAO,CAAC,IAAI,CAAC,CAUf"}