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

package/dist/server/domains/issues/issue.context.d.ts

@@ -0,0 +1,136 @@
+/**
+ * What an executor of another kind needs to know about an issue to work on it: the issue, its workflow and where the
+ * kind may move it, its owner, project and repositories, parent and sub-issues, the current checklist, a status change
+ * waiting for approval, and the newest comments. Plain data, read on the caller's connection (a claim's transaction,
+ * say), with no permission of a person applied: the plugin that asks decides who may see it.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import type { IssueComment } from '../../../shared/comments.js';
+import type { StatusCategory } from '../../../shared/issues.js';
+import type { ProjectResourceBinding } from '../../../shared/projects.js';
+import type { KindRegistry } from '../../kernel/kinds.js';
+import type { IssueExtras, StatusCatalogs } from './ports.js';
+/** The newest comments an issue context carries. */
+export declare const CONTEXT_COMMENT_LIMIT = 20;
+export interface IssueContextStatus {
+    readonly key: string;
+    readonly name: string;
+    readonly category: StatusCategory;
+}
+export interface IssueContextIssueRef {
+    readonly id: string;
+    readonly identifier: string;
+    readonly title: string;
+    readonly status: string;
+}
+/** A working directory of the issue's project (a `ProjectResource`). */
+export interface IssueContextDirectory {
+    /** The project resource id. */
+    readonly id: string;
+    readonly type: 'gitRepo' | 'directory';
+    /** `gitRepo`. */
+    readonly url: string | null;
+    readonly defaultRef: string | null;
+    /** `gitRepo`: the repository on its host, when it was linked through one. */
+    readonly binding: ProjectResourceBinding | null;
+    /** `directory`: the runner that holds it and its absolute path there. */
+    readonly runnerId: string | null;
+    readonly path: string | null;
+    readonly label: string | null;
+    readonly initPrompt: string | null;
+}
+/** A file on the issue or one of its comments, as an executor reads about it (it downloads the bytes on its own). */
+export interface IssueContextFile {
+    readonly id: string;
+    readonly filename: string;
+    readonly mimeType: string;
+    readonly size: number;
+}
+export interface IssueContext {
+    readonly id: string;
+    readonly identifier: string;
+    readonly title: string;
+    /** Markdown. */
+    readonly description: string;
+    readonly status: IssueContextStatus;
+    /** The statuses of the issue's workflow, in order. */
+    readonly statuses: readonly IssueContextStatus[];
+    /** The statuses the kind asked for may move the issue to from where it is. */
+    readonly allowedTransitions: readonly string[];
+    readonly priority: string;
+    readonly labels: readonly string[];
+    readonly owner: {
+        readonly id: string;
+        readonly name: string;
+    };
+    readonly executor: {
+        readonly type: string;
+        readonly id: string;
+        readonly name: string | null;
+    } | null;
+    readonly project: {
+        readonly id: string;
+        readonly name: string;
+        readonly description: string | null;
+        /** The project's working directories, in order: the first is the primary one. */
+        readonly repos: readonly IssueContextDirectory[];
+    } | null;
+    readonly parent: IssueContextIssueRef | null;
+    readonly children: readonly IssueContextIssueRef[];
+    readonly checklist: {
+        readonly statusKey: string;
+        readonly complete: boolean;
+        readonly items: readonly {
+            readonly key: string;
+            readonly label: string;
+            readonly required: boolean;
+            readonly checked: boolean;
+        }[];
+    } | null;
+    readonly pendingApproval: {
+        readonly id: string;
+        readonly toStatus: string;
+        readonly requestedBy: string | null;
+    } | null;
+    /** The issue's own files, oldest first. */
+    readonly attachments: readonly IssueContextFile[];
+    /** The newest comments, oldest first; deleted ones left out. */
+    readonly comments: readonly {
+        readonly id: string;
+        readonly parentId: string | null;
+        readonly author: {
+            readonly type: string;
+            readonly id: string | null;
+            readonly name: string | null;
+        };
+        readonly content: string;
+        readonly createdAt: string;
+        /** The files sent with it. */
+        readonly attachments: readonly IssueContextFile[];
+    }[];
+    readonly dueDate: string | null;
+    readonly url: string;
+}
+export interface IssueContextProvider {
+    /**
+     * The issue's context on `conn`, with the transitions `kind` may make; undefined when the issue does not exist or was
+     * deleted.
+     */
+    contextFor(conn: DatabaseConnection, idOrKey: string, options?: {
+        readonly kind?: string;
+    }): Promise<IssueContext | undefined>;
+    /** The identifier and the app route of an issue, for naming branches and linking back. */
+    describe(conn: DatabaseConnection, idOrKey: string): Promise<{
+        readonly key: string;
+        readonly url: string;
+    } | undefined>;
+}
+export interface IssueContextDeps {
+    readonly kinds: KindRegistry;
+    readonly statuses: StatusCatalogs;
+    readonly extras: () => Pick<IssueExtras, 'checklist' | 'pendingApproval' | 'attachments'>;
+    readonly comments: (conn: DatabaseConnection, issueId: string) => Promise<IssueComment[]>;
+}
+export declare function issuePath(identifier: string): string;
+export declare function createIssueContextProvider(deps: IssueContextDeps): IssueContextProvider;
+//# sourceMappingURL=issue.context.d.ts.map

package/dist/server/domains/issues/issue.context.d.ts.map

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

package/dist/server/domains/issues/issue.context.js

@@ -0,0 +1,133 @@
+import { findProject, projectResources } from '../projects/index.js';
+import { findIssue, findIssueRow, liveChildren } from './issue.store.js';
+/** The newest comments an issue context carries. */
+export const CONTEXT_COMMENT_LIMIT = 20;
+const fileOf = (file) => ({
+    id: file.id,
+    filename: file.filename,
+    mimeType: file.mimeType,
+    size: file.size,
+});
+export function issuePath(identifier) {
+    return `/issues/${encodeURIComponent(identifier)}`;
+}
+export function createIssueContextProvider(deps) {
+    return {
+        async contextFor(conn, idOrKey, options = {}) {
+            const issue = await findIssue(conn, idOrKey);
+            if (!issue || issue.deletedAt)
+                return undefined;
+            const row = await findIssueRow(conn, issue.id);
+            const catalog = await deps.statuses.forProject(conn, issue.projectId);
+            const statusOf = (key) => {
+                const found = catalog.statuses.find((status) => status.key === key);
+                return {
+                    key,
+                    name: found?.name ?? key,
+                    category: found?.category ?? 'unstarted',
+                };
+            };
+            const project = issue.projectId
+                ? await findProject(conn, issue.projectId)
+                : undefined;
+            const parent = issue.parentIssueId
+                ? await findIssue(conn, issue.parentIssueId)
+                : undefined;
+            const children = await liveChildren(conn, [issue.id]);
+            const executorName = issue.executor
+                ? ((await deps.kinds.names(conn, issue.executor.type, [
+                    issue.executor.id,
+                ])).get(issue.executor.id) ?? null)
+                : null;
+            const checklist = await deps.extras().checklist(conn, issue);
+            const pending = await deps.extras().pendingApproval(conn, issue);
+            const comments = (await deps.comments(conn, issue.id))
+                .filter((comment) => !comment.deleted)
+                .slice(-CONTEXT_COMMENT_LIMIT);
+            const ref = (other) => ({
+                id: other.id,
+                identifier: other.identifier,
+                title: other.title,
+                status: other.statusKey,
+            });
+            return {
+                id: issue.id,
+                identifier: issue.identifier,
+                title: issue.title,
+                description: issue.description,
+                status: statusOf(issue.statusKey),
+                statuses: catalog.statuses.map((status) => statusOf(status.key)),
+                allowedTransitions: options.kind
+                    ? [...catalog.machine.allowedMoves(issue.statusKey, options.kind)]
+                    : [],
+                priority: issue.priority,
+                labels: (row?.labels ?? []).map((label) => label.name),
+                owner: { id: issue.ownerUserId, name: row?.ownerName ?? '' },
+                executor: issue.executor
+                    ? { ...issue.executor, name: executorName }
+                    : null,
+                project: project
+                    ? {
+                        id: project.id,
+                        name: project.name,
+                        description: project.description,
+                        repos: (await projectResources(conn, project.id)).map((resource) => ({
+                            id: resource.id,
+                            type: resource.type,
+                            url: resource.url,
+                            defaultRef: resource.defaultRef,
+                            binding: resource.binding,
+                            runnerId: resource.runnerId,
+                            path: resource.path,
+                            label: resource.label,
+                            initPrompt: resource.initPrompt,
+                        })),
+                    }
+                    : null,
+                parent: parent && !parent.deletedAt ? ref(parent) : null,
+                children: children.map(ref),
+                checklist: checklist
+                    ? {
+                        statusKey: checklist.statusKey,
+                        complete: checklist.complete,
+                        items: checklist.items.map((item) => ({
+                            key: item.itemKey,
+                            label: item.label,
+                            required: item.required,
+                            checked: item.checked,
+                        })),
+                    }
+                    : null,
+                pendingApproval: pending
+                    ? {
+                        id: pending.id,
+                        toStatus: pending.toStatus,
+                        requestedBy: pending.requestedByName,
+                    }
+                    : null,
+                attachments: (await deps.extras().attachments(conn, null, issue)).map(fileOf),
+                comments: comments.map((comment) => ({
+                    id: comment.id,
+                    parentId: comment.parentId,
+                    author: {
+                        type: comment.authorType,
+                        id: comment.authorId,
+                        name: comment.authorName,
+                    },
+                    content: comment.content,
+                    createdAt: comment.createdAt,
+                    attachments: comment.attachments.map(fileOf),
+                })),
+                dueDate: issue.dueDate,
+                url: issuePath(issue.identifier),
+            };
+        },
+        async describe(conn, idOrKey) {
+            const issue = await findIssue(conn, idOrKey);
+            if (!issue || issue.deletedAt)
+                return undefined;
+            return { key: issue.identifier, url: issuePath(issue.identifier) };
+        },
+    };
+}
+//# sourceMappingURL=issue.context.js.map

package/dist/server/domains/issues/issue.context.js.map

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

package/dist/server/domains/issues/issue.events.d.ts

@@ -0,0 +1,54 @@
+import type { MentionRef } from '../../../shared/comments.js';
+import type { Executor } from '../../../shared/issues.js';
+import type { ActorType } from '../../kernel/actor.js';
+export interface EventActor {
+    readonly type: ActorType;
+    readonly id: string | null;
+}
+/** What an update changed that someone may need to be told about. */
+export interface IssueChangeSet {
+    readonly status?: {
+        readonly from: string;
+        readonly to: string;
+    };
+    readonly owner?: {
+        readonly from: string;
+        readonly to: string;
+    };
+    readonly executor?: {
+        readonly from: Executor | null;
+        readonly to: Executor | null;
+    };
+    /** Principals of any kind newly mentioned in the description. */
+    readonly mentions?: readonly MentionRef[];
+}
+declare module '../../kernel/events.js' {
+    interface DomainEventMap {
+        /** Anything about the issue changed; the browser refetches it. */
+        'issue.changed': {
+            readonly issueId: string;
+        };
+        'issue.created': {
+            readonly issueId: string;
+            readonly actor: EventActor;
+            /** Principals of any kind mentioned in the description. */
+            readonly mentions: readonly MentionRef[];
+        };
+        'issue.updated': {
+            readonly issueId: string;
+            readonly actor: EventActor;
+            readonly changes: IssueChangeSet;
+            /** The issue's revision after the change, to tell one change from another. */
+            readonly revision: number;
+        };
+        'issue.deleted': {
+            readonly issueId: string;
+            readonly actor: EventActor;
+        };
+        'issue.restored': {
+            readonly issueId: string;
+            readonly actor: EventActor;
+        };
+    }
+}
+//# sourceMappingURL=issue.events.d.ts.map

package/dist/server/domains/issues/issue.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.events.d.ts","sourceRoot":"","sources":["../../../../server/domains/issues/issue.events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC/B,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAC3C;AAED,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,cAAc;QACtB,kEAAkE;QAClE,eAAe,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,eAAe,EAAE;YACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;YAC3B,2DAA2D;YAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;SAC1C,CAAC;QACF,eAAe,EAAE;YACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;YAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;YACjC,8EAA8E;YAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC3B,CAAC;QACF,eAAe,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;SAAE,CAAC;QAC1E,gBAAgB,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;SAAE,CAAC;KAC5E;CACF"}

package/dist/server/domains/issues/issue.events.js

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

package/dist/server/domains/issues/issue.events.js.map

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

package/dist/server/domains/issues/issue.fields.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The fields of an issue: validating a create, and turning an update into column values plus one activity per changed
+ * field. The rules that depend on which field changes (who may change the owner or close the issue) are applied here.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import { type Priority } from '../../../shared/common.js';
+import { type CreateIssueRequest, type Executor, type Issue, type UpdateIssueRequest } from '../../../shared/issues.js';
+import { type Viewer } from '../../access/viewer.js';
+import type { UserDirectory } from '../../kernel/users.js';
+import type { LabelService } from '../labels/index.js';
+import type { KindRegistry } from '../../kernel/kinds.js';
+import type { IssueValues } from './issue.store.js';
+import { type StatusCatalog, type StatusCatalogs } from './ports.js';
+export interface FieldDeps {
+    readonly users: UserDirectory;
+    readonly kinds: KindRegistry;
+    readonly labels: Pick<LabelService, 'requireExisting'>;
+    readonly statuses: StatusCatalogs;
+}
+export interface FieldContext extends FieldDeps {
+    readonly conn: DatabaseConnection;
+    readonly viewer: Viewer;
+}
+export interface Activity {
+    readonly action: string;
+    readonly details: Record<string, unknown>;
+}
+/** The values of a new issue. */
+export interface NewIssue {
+    readonly title: string;
+    readonly description: string;
+    readonly statusKey: string;
+    readonly priority: Priority;
+    readonly ownerUserId: string;
+    readonly executor: Executor | null;
+    readonly parentIssueId: string | null;
+    readonly stage: number | null;
+    readonly projectId: string | null;
+    readonly startDate: string | null;
+    readonly dueDate: string | null;
+    readonly labelIds: readonly string[];
+    /** Issues it waits for, by id or identifier, checked when they are linked (`domains/subtasks`). */
+    readonly blockedBy: readonly string[];
+    /** It sets its project up (`Project.setupIssueId`). */
+    readonly projectSetup: boolean;
+}
+export declare function resolveCreate(ctx: FieldContext, input: CreateIssueRequest): Promise<NewIssue>;
+export interface Changes {
+    readonly values: IssueValues;
+    readonly activities: Activity[];
+    /** The new label set, when the request replaces it. */
+    readonly labelIds?: string[];
+    /** A status change: it goes through the workflow (`issue.status.ts`) before anything is written. */
+    readonly status?: {
+        readonly to: string;
+        readonly catalog: StatusCatalog;
+    };
+    /** The parent or the stage changes: once written, the issues waiting for each other are checked again. */
+    readonly placed: boolean;
+}
+/** Column values and activities for an update; enforces the rules of the fields it changes. */
+export declare function resolveUpdate(ctx: FieldContext, before: Issue, patch: UpdateIssueRequest): Promise<Changes>;
+//# sourceMappingURL=issue.fields.d.ts.map

package/dist/server/domains/issues/issue.fields.d.ts.map

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