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

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,223 @@
+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 { createIssueContextProvider, createIssueQueries, createIssueService, createProjectIssues, } 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, } from './domains/projects/index.js';
+import { createSettingsService, } from './domains/settings/index.js';
+import { createStatusEventService, createStatusEventTypes, createStatusService, } from './domains/statuses/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);
+    const eventTypes = deps.statusEvents ?? createStatusEventTypes();
+    const settings = createSettingsService({ tx });
+    const labels = createLabelService({ tx, ids });
+    const statuses = createStatusService({
+        kinds,
+        events: eventTypes,
+        activity,
+    });
+    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: () => ({
+            attachments: (conn, viewer, issue) => attachments.links.ofIssue(conn, viewer, issue),
+        }),
+        comments: (conn, issueId) => commentQueries.list(conn, issueId),
+    });
+    const notices = createNoticePlanner({
+        subscriptions,
+        kinds,
+        rules: [builtInRules()],
+    });
+    tx.beforeCommit((unit, events) => notices.plan(unit, events));
+    const issues = createIssueService({
+        tx,
+        ids,
+        activity,
+        settings,
+        users,
+        kinds,
+        labels,
+        statuses,
+        triggers,
+        relations: () => subtasks.relations,
+        attachments: () => attachments.links,
+    });
+    const subtasks = createSubtaskService({
+        tx,
+        ids,
+        activity,
+        kinds,
+        statuses,
+        triggers,
+    });
+    const projectIssues = createProjectIssues({ activity, statuses });
+    const projects = createProjectService({
+        tx,
+        ids,
+        users,
+        issues: () => projectIssues,
+    });
+    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: () => ({
+            threads: (conn, issue, viewer) => threadPage(conn, kinds, issue.id, {}, attachments.links, viewer),
+            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, readableIds) => subtasks.extras.listCounts(conn, issues, readableIds),
+            blockedIds: (conn, issues) => subtasks.extras.blockedIds(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 {
+        activity,
+        events,
+        tx,
+        settings,
+        labels,
+        statuses,
+        members,
+        invitations: createInvitationService({
+            tx,
+            ids,
+            members,
+            invitations: deps.invitations,
+        }),
+        projects,
+        issues,
+        issueQueries,
+        issueContext,
+        comments,
+        commentQueries,
+        subscriptions,
+        attachments: attachments.service,
+        storage,
+        noticeRules: { add: (rule) => notices.add(rule) },
+        subtasks,
+        plans,
+        intake,
+        intakeAi,
+        kinds,
+        statusEvents: createStatusEventService({
+            tx,
+            types: eventTypes,
+            issues: () => issues,
+        }),
+        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/attachments/attachment.routes.d.ts

@@ -0,0 +1,13 @@
+import type { Hono } from 'hono';
+import { type Attachment } from '../../../shared/attachments.js';
+import { type ViewerEnv } from '../../access/request.js';
+import type { AttachmentService } from './attachment.service.js';
+/** `filename*` per RFC 5987, so any name survives; the plain `filename` is an ASCII fallback. */
+export declare function contentDisposition(kind: 'inline' | 'attachment', filename: string): string;
+/** The headers a file is served with: inline only for a safe image, unless a download is asked for. */
+export declare function contentHeaders(attachment: Attachment, download: boolean): Record<string, string>;
+/** Under `/api/projects/attachments`. */
+export declare function createAttachmentRoutes(attachments: AttachmentService): Hono<ViewerEnv>;
+/** Under `/api/projects/issues`: `GET /{issueId}/attachments` and `POST /{issueId}/attachments` (one file). */
+export declare function createIssueAttachmentRoutes(attachments: AttachmentService): Hono<ViewerEnv>;
+//# sourceMappingURL=attachment.routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.routes.d.ts","sourceRoot":"","sources":["../../../../server/domains/attachments/attachment.routes.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAkBnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AA8CjE,iGAAiG;AACjG,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,GAAG,YAAY,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAID,uGAAuG;AACvG,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxB;AAED,yCAAyC;AACzC,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,iBAAiB,GAC7B,IAAI,CAAC,SAAS,CAAC,CAiJjB;AAED,+GAA+G;AAC/G,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,iBAAiB,GAC7B,IAAI,CAAC,SAAS,CAAC,CA2EjB"}

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

@@ -0,0 +1,209 @@
+/**
+ * `/api/projects/attachments` and `/api/projects/issues/{issueId}/attachments` (`shared/attachments.ts`). Every path
+ * acts as the signed-in person; the service decides what they may read and change.
+ */
+import { ApiError, apiErrorHandler, apiErrorResponse, apiErrorResponses, apiValidator, cliRoute, dataResponse, describeRoute, emptyResponse, listResponse, } from '@nocobase/app-server/router';
+import { bodyLimit } from 'hono/body-limit';
+import { ATTACHMENT_SIZE_MAX, } from '../../../shared/attachments.js';
+import { viewerOf } from '../../access/request.js';
+import { invalid } from '../../kernel/errors.js';
+import { boundedList, domainRouter, PROJECTS_DOMAIN, tags, personOrRunSecurity, } from '../../kernel/http.js';
+import { AttachmentContentQuery, IssueAttachmentsQuery, AttachmentParams, AttachmentSchema, BoundedListMeta, IssueParams, singleFileBody, } from '../../routes/schemas.js';
+/** Room for the multipart envelope around one file. */
+const ENVELOPE = 64 * 1024;
+const sizeLimit = bodyLimit({
+    maxSize: ATTACHMENT_SIZE_MAX + ENVELOPE,
+    onError: (context) => apiErrorHandler(new ApiError({
+        status: 'INVALID_ARGUMENT',
+        reason: 'FILE_TOO_LARGE',
+        domain: PROJECTS_DOMAIN,
+        message: `A file may have at most ${ATTACHMENT_SIZE_MAX} bytes.`,
+        metadata: { maxBytes: ATTACHMENT_SIZE_MAX },
+        httpStatus: 413,
+    }), context),
+});
+const uploadErrors = {
+    400: apiErrorResponse(400, 'When the body is not multipart with one `file` (`INVALID_FILE`), or the application stores no files (`FAILED_PRECONDITION`, `FILES_UNAVAILABLE`).'),
+    413: apiErrorResponse(413, `When the file is over ${ATTACHMENT_SIZE_MAX} bytes (\`FILE_TOO_LARGE\`).`),
+};
+/** The one `file` of a multipart body; 400 `INVALID_FILE` otherwise. */
+async function fileOf(context) {
+    let body;
+    try {
+        body = await context.req.parseBody();
+    }
+    catch {
+        throw invalid('INVALID_FILE', 'Send one file as multipart form data.');
+    }
+    const file = body.file;
+    if (!(file instanceof File))
+        throw invalid('INVALID_FILE', 'Send one file as `file`.');
+    return file;
+}
+/** `filename*` per RFC 5987, so any name survives; the plain `filename` is an ASCII fallback. */
+export function contentDisposition(kind, filename) {
+    const ascii = filename.replace(/[^\x20-\x7e]|["\\]/gu, '_') || 'file';
+    const encoded = encodeURIComponent(filename).replace(/['()*]/gu, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
+    return `${kind}; filename="${ascii}"; filename*=UTF-8''${encoded}`;
+}
+const MIME = /^[a-z0-9][a-z0-9!#$&^_.+-]*\/[a-z0-9][a-z0-9!#$&^_.+-]*$/iu;
+/** The headers a file is served with: inline only for a safe image, unless a download is asked for. */
+export function contentHeaders(attachment, download) {
+    const inline = attachment.previewable && !download;
+    const type = attachment.mimeType.split(';')[0]?.trim() ?? '';
+    return {
+        'Content-Type': MIME.test(type) ? type : 'application/octet-stream',
+        'Content-Length': String(attachment.size),
+        'Content-Disposition': contentDisposition(inline ? 'inline' : 'attachment', attachment.filename),
+        'X-Content-Type-Options': 'nosniff',
+        'Content-Security-Policy': "sandbox; default-src 'none'",
+        'Cache-Control': 'private, no-store',
+    };
+}
+/** Under `/api/projects/attachments`. */
+export function createAttachmentRoutes(attachments) {
+    const routes = domainRouter();
+    routes.post('/', describeRoute({
+        tags,
+        summary: 'Upload a file',
+        operationId: 'projectsUploadAttachment',
+        security: personOrRunSecurity,
+        ...cliRoute({
+            command: 'attachment upload',
+            action: 'pm.attachments/upload',
+        }),
+        description: `Needs \`upload\` on \`pm.attachments\`. One file as the \`file\` field of a multipart body, at most ${ATTACHMENT_SIZE_MAX} bytes. The upload is attached to nothing until it is sent with a comment (\`attachmentIds\`); one left so for 24 hours is purged.`,
+        requestBody: singleFileBody,
+        responses: {
+            201: dataResponse(AttachmentSchema),
+            ...apiErrorResponses,
+            ...uploadErrors,
+        },
+    }), sizeLimit, async (context) => context.json({
+        data: await attachments.upload(viewerOf(context), await fileOf(context)),
+    }, 201));
+    routes.get('/:attachmentId', describeRoute({
+        tags,
+        summary: 'Get a file',
+        operationId: 'projectsGetAttachment',
+        ...cliRoute({
+            command: 'attachment get',
+            flags: { attachmentId: { name: 'file' } },
+        }),
+        description: 'Readable by whoever sees its issue; an upload attached to nothing by its uploader only.',
+        responses: {
+            200: dataResponse(AttachmentSchema),
+            ...apiErrorResponses,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', AttachmentParams), async (context) => context.json({
+        data: await attachments.get(viewerOf(context), context.req.valid('param').attachmentId),
+    }));
+    routes.get('/:attachmentId/content', describeRoute({
+        tags,
+        summary: 'Download a file',
+        operationId: 'projectsDownloadAttachment',
+        security: personOrRunSecurity,
+        ...cliRoute({
+            command: 'issue attachment download',
+            flags: {
+                attachmentId: {
+                    name: 'file',
+                    description: 'The file id; `issue attachment list` gives them.',
+                },
+                download: { hidden: true },
+            },
+            action: 'pm.issues/view',
+        }),
+        description: 'The file’s bytes. A safe raster image is served inline unless `download=true`; anything else, SVG and HTML included, as a download. Always with `X-Content-Type-Options: nosniff`, `Content-Security-Policy: sandbox` and `Cache-Control: private, no-store`.',
+        responses: {
+            200: {
+                description: 'The bytes, with the type the uploader declared (`application/octet-stream` when it is not a valid media type) and a `Content-Disposition` naming the file.',
+                content: {
+                    'application/octet-stream': {
+                        schema: { type: 'string', format: 'binary' },
+                    },
+                },
+            },
+            ...apiErrorResponses,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', AttachmentParams), apiValidator('query', AttachmentContentQuery), async (context) => {
+        const { attachment, body } = await attachments.content(viewerOf(context), context.req.valid('param').attachmentId);
+        return new Response(body, {
+            status: 200,
+            headers: contentHeaders(attachment, context.req.valid('query').download),
+        });
+    });
+    routes.delete('/:attachmentId', describeRoute({
+        tags,
+        summary: 'Delete a file',
+        operationId: 'projectsDeleteAttachment',
+        security: personOrRunSecurity,
+        ...cliRoute({
+            command: 'attachment delete',
+            flags: { attachmentId: { name: 'file' } },
+            action: 'pm.attachments/upload',
+            confirm: 'Delete this file?',
+        }),
+        description: 'An issue’s own file, by its uploader or by whoever may moderate comments on the issue; a comment’s files go with the comment.',
+        responses: {
+            204: emptyResponse(),
+            ...apiErrorResponses,
+            400: apiErrorResponse(400, 'When the file was sent with a comment (`COMMENT_ATTACHMENT`).'),
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', AttachmentParams), async (context) => {
+        await attachments.remove(viewerOf(context), context.req.valid('param').attachmentId);
+        return context.body(null, 204);
+    });
+    return routes;
+}
+/** Under `/api/projects/issues`: `GET /{issueId}/attachments` and `POST /{issueId}/attachments` (one file). */
+export function createIssueAttachmentRoutes(attachments) {
+    const routes = domainRouter();
+    routes.get('/:issueId/attachments', describeRoute({
+        tags,
+        summary: 'List an issue’s files',
+        operationId: 'projectsListIssueAttachments',
+        security: personOrRunSecurity,
+        ...cliRoute({
+            command: 'issue attachment list',
+            flags: {
+                issueId: { name: 'issue' },
+                comments: { description: 'Its comments’ files too.' },
+            },
+            columns: ['id', 'filename', 'size', 'mimeType', 'commentId'],
+            action: 'pm.issues/view',
+        }),
+        description: 'The issue’s own files, oldest first; with `comments=true`, then the files of its comments that are not deleted (each with its `commentId`). `issueId` is an id or an identifier.',
+        responses: {
+            200: listResponse(AttachmentSchema, BoundedListMeta),
+            ...apiErrorResponses,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', IssueParams), apiValidator('query', IssueAttachmentsQuery), async (context) => context.json(boundedList(await attachments.list(viewerOf(context), context.req.valid('param').issueId, { comments: context.req.valid('query').comments === 'true' }))));
+    routes.post('/:issueId/attachments', describeRoute({
+        tags,
+        summary: 'Attach a file to an issue',
+        operationId: 'projectsUploadIssueAttachment',
+        ...cliRoute({
+            command: 'issue attachment add',
+            flags: { issueId: { name: 'issue' } },
+            action: 'pm.attachments/upload',
+            examples: ['issue attachment add PM-12 --file design.png'],
+        }),
+        description: `Needs \`upload\` on \`pm.attachments\` and \`edit\` on the issue. One file as the \`file\` field of a multipart body, at most ${ATTACHMENT_SIZE_MAX} bytes.`,
+        requestBody: singleFileBody,
+        responses: {
+            201: dataResponse(AttachmentSchema),
+            ...apiErrorResponses,
+            ...uploadErrors,
+            404: apiErrorResponse(404),
+        },
+    }), apiValidator('param', IssueParams), sizeLimit, async (context) => context.json({
+        data: await attachments.uploadToIssue(viewerOf(context), context.req.valid('param').issueId, await fileOf(context)),
+    }, 201));
+    return routes;
+}
+//# sourceMappingURL=attachment.routes.js.map

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

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

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

@@ -0,0 +1,85 @@
+/**
+ * Files on issues and comments (`shared/attachments.ts`): uploading, attaching, listing, reading, removing, and
+ * purging what nothing holds any longer. The bytes go through `AttachmentStorage` (the file plugin and Drive); the
+ * rows are `pmAttachments`.
+ *
+ * An upload is the uploader's: a person's (`user` and their id) or, for an agent working on an issue, the agent's own
+ * principal. Only the uploader may read an upload attached to nothing, attach it, or discard it. Attaching happens in
+ * the caller's transaction: the comment service sends a comment's files with it (`attach`), the plan service gives an
+ * intake's files to the issues it created. Attaching to an issue records `attachment_added`; a comment's files are
+ * counted on its `comment_added` instead. Removing an issue's file records `attachment_removed`.
+ *
+ * A comment's files are not removed with its row (a deletion may be part of a plan that rolls back): once the comment
+ * is deleted they are no longer listed or served, and the purge deletes them with the uploads attached to nothing for
+ * `ORPHAN_HOURS`.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import { type Attachment } from '../../../shared/attachments.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 { KindRegistry } from '../../kernel/kinds.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+import type { AttachmentStorage } from './attachment.storage.js';
+import { type AttachmentRecord, type UploaderRef } from './attachment.store.js';
+export interface AttachmentContent {
+    readonly attachment: Attachment;
+    readonly body: ReadableStream<Uint8Array>;
+}
+export interface AttachmentService {
+    /** An upload of the viewer's, attached to nothing yet. */
+    upload(viewer: Viewer, file: File): Promise<Attachment>;
+    /** Uploads a file straight onto the issue (its own files). */
+    uploadToIssue(viewer: Viewer, issueIdOrKey: string, file: File): Promise<Attachment>;
+    /** The issue's own files, oldest first; with `comments`, then its live comments' files. */
+    list(viewer: Viewer, issueIdOrKey: string, options?: {
+        readonly comments?: boolean;
+    }): Promise<Attachment[]>;
+    /** One file the viewer may read, by id; 404 otherwise. */
+    get(viewer: Viewer, id: string): Promise<Attachment>;
+    /** A file's bytes; 404 unless the viewer may read it. */
+    content(viewer: Viewer, id: string): Promise<AttachmentContent>;
+    remove(viewer: Viewer, id: string): Promise<void>;
+    /** Deletes the viewer's own uploads attached to nothing (a comment that failed); others are left alone. */
+    discard(viewer: Viewer, ids: readonly string[]): Promise<void>;
+    /** Deletes uploads attached to nothing for `ORPHAN_HOURS`, and deleted comments' files; answers how many. */
+    purge(at?: Date): Promise<number>;
+}
+/** What the comment and plan services use, inside their transactions. */
+export interface AttachmentLinks {
+    /**
+     * Attaches `ids` (checked: 1 to `ATTACHMENTS_PER_REQUEST_MAX` distinct ids of `uploader`'s uploads attached to
+     * nothing) to the issue, or to one of its comments. Answers the rows, in the order named. 400 `INVALID_FIELD` or
+     * `INVALID_ATTACHMENT` otherwise, and nothing is attached.
+     */
+    attach(tx: Tx, uploader: UploaderRef, target: {
+        readonly issueId: string;
+        readonly commentId: string | null;
+    }, ids: unknown): Promise<AttachmentRecord[]>;
+    /** The files of these comments, by comment id; a deleted comment's are left out by the caller. */
+    ofComments(conn: DatabaseConnection, commentIds: readonly string[]): Promise<ReadonlyMap<string, readonly Attachment[]>>;
+    /** The issue's own files as `viewer` sees them (who may remove which). */
+    ofIssue(conn: DatabaseConnection, viewer: Viewer | null, issue: Issue): Promise<Attachment[]>;
+}
+export interface AttachmentDeps {
+    readonly tx: TxRunner;
+    readonly activity: ActivityRecorder;
+    readonly kinds: KindRegistry;
+    readonly storage: AttachmentStorage;
+    /** The application's public base path (`/app`, or empty), for the content URLs. */
+    readonly basePath: () => string;
+    /** File ids an open plan still needs (an intake's files), kept by the purge. */
+    readonly keep?: (conn: DatabaseConnection) => Promise<ReadonlySet<string>>;
+    readonly now?: () => Date;
+}
+/** Who uploads as the viewer: the actor they act as (an agent working on an issue uploads as itself). */
+export declare function uploaderOf(actor: Actor, userId: string): UploaderRef;
+export declare function requireUploader(viewer: Viewer): void;
+/** The `attachmentIds` of a request: absent or empty is none; otherwise 1 to the maximum distinct strings. */
+export declare function readAttachmentIds(value: unknown): string[];
+export declare function createAttachmentService(deps: AttachmentDeps): {
+    readonly service: AttachmentService;
+    readonly links: AttachmentLinks;
+};
+//# sourceMappingURL=attachment.service.d.ts.map

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

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