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

package/dist/server/domains/settings/settings.store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Workspace settings and the issue counter. `pmSettings` is created by the seed
+ * `202609300005_pm_default_settings`; a missing settings row reads as the defaults and is recreated by the first write.
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+export declare const SETTINGS = "pmSettings";
+export declare const DEFAULT_PREFIX = "PM";
+export interface SettingsRow {
+    readonly id: string;
+    readonly issuePrefix: string;
+    readonly issueCounter: number;
+    readonly values: Readonly<Record<string, unknown>> | null;
+    readonly createdAt: Date | string;
+    readonly updatedAt: Date | string;
+}
+export declare function readSettings(conn: DatabaseConnection): Promise<SettingsRow | undefined>;
+export declare function writeSettings(conn: DatabaseConnection, values: Partial<Pick<SettingsRow, 'issuePrefix' | 'values'>>): Promise<void>;
+/**
+ * The next issue number and the current prefix, allocated atomically in the caller's transaction.
+ * A rolled-back create releases its number.
+ */
+export declare function nextIssueNumber(conn: DatabaseConnection): Promise<{
+    readonly number: number;
+    readonly prefix: string;
+}>;
+//# sourceMappingURL=settings.store.d.ts.map

package/dist/server/domains/settings/settings.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.store.d.ts","sourceRoot":"","sources":["../../../../server/domains/settings/settings.store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;CACnC;AAoBD,wBAAsB,YAAY,CAChC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAElC;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,QAAQ,CAAC,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ/D"}

package/dist/server/domains/settings/settings.store.js

@@ -0,0 +1,43 @@
+export const SETTINGS = 'pmSettings';
+const ROW_ID = 'default';
+export const DEFAULT_PREFIX = 'PM';
+const settings = (conn) => conn.repository(SETTINGS);
+async function ensureRow(conn) {
+    if (await settings(conn).exists({ filter: { id: ROW_ID } }))
+        return;
+    const now = new Date();
+    await settings(conn).createOne({
+        values: {
+            id: ROW_ID,
+            issuePrefix: DEFAULT_PREFIX,
+            issueCounter: 0,
+            values: {},
+            createdAt: now,
+            updatedAt: now,
+        },
+    });
+}
+export async function readSettings(conn) {
+    return settings(conn).findOne({ filter: { id: ROW_ID } });
+}
+export async function writeSettings(conn, values) {
+    await ensureRow(conn);
+    await settings(conn).updateOne({
+        filter: { id: ROW_ID },
+        values: { ...values, updatedAt: new Date() },
+    });
+}
+/**
+ * The next issue number and the current prefix, allocated atomically in the caller's transaction.
+ * A rolled-back create releases its number.
+ */
+export async function nextIssueNumber(conn) {
+    await ensureRow(conn);
+    const { record } = await settings(conn).updateOne({
+        filter: { id: ROW_ID },
+        values: { issueCounter: { increment: 1 }, updatedAt: new Date() },
+        select: (select) => select.fields('issueCounter', 'issuePrefix'),
+    });
+    return { number: record.issueCounter, prefix: record.issuePrefix };
+}
+//# sourceMappingURL=settings.store.js.map

package/dist/server/domains/settings/settings.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.store.js","sourceRoot":"","sources":["../../../../server/domains/settings/settings.store.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AACrC,MAAM,MAAM,GAAG,SAAS,CAAC;AACzB,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAWnC,MAAM,QAAQ,GAAG,CAAC,IAAwB,EAAE,EAAE,CAC5C,IAAI,CAAC,UAAU,CAAc,QAAQ,CAAC,CAAC;AAEzC,KAAK,UAAU,SAAS,CAAC,IAAwB;IAC/C,IAAI,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;QAAE,OAAO;IACpE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;QAC7B,MAAM,EAAE;YACN,EAAE,EAAE,MAAM;YACV,WAAW,EAAE,cAAc;YAC3B,YAAY,EAAE,CAAC;YACf,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAwB;IAExB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAwB,EACxB,MAA4D;IAE5D,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;QAC7B,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;QACtB,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE;KAC7C,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAwB;IAExB,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;QAChD,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;QACtB,MAAM,EAAE,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE;QACjE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC;KACjE,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;AACrE,CAAC"}

package/dist/server/domains/statuses/event-types.d.ts

@@ -0,0 +1,16 @@
+export interface StatusEventType {
+    /** Dotted, the plugin's prefix first, such as `acme.merged`. */
+    readonly key: string;
+    /** The statuses the event moves an issue out of. */
+    readonly from: readonly string[];
+    /** The status it moves the issue to. */
+    readonly to: string;
+}
+export interface StatusEventTypes {
+    /** Adds an event; returns what removes it. Throws when the key is taken or malformed, or a status is unknown. */
+    add(type: StatusEventType): () => void;
+    get(key: string): StatusEventType | undefined;
+    list(): readonly StatusEventType[];
+}
+export declare function createStatusEventTypes(): StatusEventTypes;
+//# sourceMappingURL=event-types.d.ts.map

package/dist/server/domains/statuses/event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../../../server/domains/statuses/event-types.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iHAAiH;IACjH,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,IAAI,CAAC;IACvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAC9C,IAAI,IAAI,SAAS,eAAe,EAAE,CAAC;CACpC;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAuBzD"}

package/dist/server/domains/statuses/event-types.js

@@ -0,0 +1,31 @@
+/**
+ * Status events other plugins contribute (`projectsStatusEventsToken`): a key such as `acme.merged`, the statuses an
+ * issue may be in when it happens (`from`) and the status it then moves to (`to`). This plugin never knows what an
+ * event means; its plugin fires it for the issues it concerns (`Projects.statusEvents.fire`), and each issue in one of
+ * the `from` statuses moves to `to` as the system.
+ *
+ * A type is looked up on each use, so a plugin may add it after this plugin's services are created.
+ */
+import { isFixedStatus, STATUS_EVENT_PATTERN, } from '../../../shared/statuses.js';
+export function createStatusEventTypes() {
+    const types = new Map();
+    return {
+        add(type) {
+            if (!STATUS_EVENT_PATTERN.test(type.key))
+                throw new TypeError(`Status event ${type.key} must match ${String(STATUS_EVENT_PATTERN)}.`);
+            if (types.has(type.key))
+                throw new TypeError(`Status event ${type.key} is registered already.`);
+            for (const key of [...type.from, type.to])
+                if (!isFixedStatus(key))
+                    throw new TypeError(`Status event ${type.key} names the unknown status ${key}.`);
+            types.set(type.key, type);
+            return () => {
+                if (types.get(type.key) === type)
+                    types.delete(type.key);
+            };
+        },
+        get: (key) => types.get(key),
+        list: () => [...types.values()],
+    };
+}
+//# sourceMappingURL=event-types.js.map

package/dist/server/domains/statuses/event-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.js","sourceRoot":"","sources":["../../../../server/domains/statuses/event-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,aAAa,EACb,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAkBrC,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IACjD,OAAO;QACL,GAAG,CAAC,IAAI;YACN,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;gBACtC,MAAM,IAAI,SAAS,CACjB,gBAAgB,IAAI,CAAC,GAAG,eAAe,MAAM,CAAC,oBAAoB,CAAC,GAAG,CACvE,CAAC;YACJ,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;gBACrB,MAAM,IAAI,SAAS,CAAC,gBAAgB,IAAI,CAAC,GAAG,yBAAyB,CAAC,CAAC;YACzE,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBACvC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;oBACrB,MAAM,IAAI,SAAS,CACjB,gBAAgB,IAAI,CAAC,GAAG,6BAA6B,GAAG,GAAG,CAC5D,CAAC;YACN,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO,GAAG,EAAE;gBACV,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI;oBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3D,CAAC,CAAC;QACJ,CAAC;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+export { createStatusService, KIND_MAY_MOVE_RULE, NOTIFY_OWNER_RULE, } from './status.catalog.js';
+export { createStatusEventTypes, type StatusEventType, type StatusEventTypes, } from './event-types.js';
+export { createStatusEventService, EVENT_BATCH_MAX, EVENT_NOTE_MAX, type StatusEventFiring, type StatusEventMove, type StatusEventService, type StatusEventTarget, } from './status.fire.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/domains/statuses/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,4 @@
+export { createStatusService, KIND_MAY_MOVE_RULE, NOTIFY_OWNER_RULE, } from './status.catalog.js';
+export { createStatusEventTypes, } from './event-types.js';
+export { createStatusEventService, EVENT_BATCH_MAX, EVENT_NOTE_MAX, } from './status.fire.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/domains/statuses/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,GAGvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,cAAc,GAKf,MAAM,kBAAkB,CAAC"}

package/dist/server/domains/statuses/status.catalog.d.ts

@@ -0,0 +1,15 @@
+import type { ActivityRecorder } from '../../kernel/activity.js';
+import type { KindRegistry } from '../../kernel/kinds.js';
+import type { StatusService } from '../issues/ports.js';
+import type { StatusEventTypes } from './event-types.js';
+import './status.events.js';
+/** The entry action of the statuses whose owner is told. */
+export declare const NOTIFY_OWNER_RULE = "notifyOwner";
+/** The "who may" rule a kind's `mayMove` answers through. */
+export declare const KIND_MAY_MOVE_RULE = "kindMayMove";
+export declare function createStatusService(deps: {
+    readonly kinds: KindRegistry;
+    readonly events: StatusEventTypes;
+    readonly activity: ActivityRecorder;
+}): StatusService;
+//# sourceMappingURL=status.catalog.d.ts.map

package/dist/server/domains/statuses/status.catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.catalog.d.ts","sourceRoot":"","sources":["../../../../server/domains/statuses/status.catalog.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AASzE,OAAO,KAAK,EAGV,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,oBAAoB,CAAC;AAE5B,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AA8EhD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC,GAAG,aAAa,CAkDhB"}

package/dist/server/domains/statuses/status.catalog.js

@@ -0,0 +1,119 @@
+import { FIXED_STATUSES, OWNER_NOTIFIED_STATUSES, statusCategory, } from '../../../shared/statuses.js';
+import { SYSTEM_KIND, USER_KIND } from '../../../shared/kinds.js';
+import { ANY_STATE, compile, createLifecycleRegistry, } from '../../lifecycle/index.js';
+import { findIssue } from '../issues/issue.store.js';
+import './status.events.js';
+/** The entry action of the statuses whose owner is told. */
+export const NOTIFY_OWNER_RULE = 'notifyOwner';
+/** The "who may" rule a kind's `mayMove` answers through. */
+export const KIND_MAY_MOVE_RULE = 'kindMayMove';
+function rulesOf(deps) {
+    return createLifecycleRegistry()
+        .stateRule(NOTIFY_OWNER_RULE, {
+        async entered(ctx) {
+            const tx = ctx.context;
+            const actor = ctx.sourceActor ?? ctx.actor;
+            const issue = (await findIssue(tx.conn, ctx.subject.id)) ?? ctx.subject;
+            if (actor.type === USER_KIND && actor.id === issue.ownerUserId)
+                return { status: 'skipped', reason: 'ownerMovedIt' };
+            const status = FIXED_STATUSES.find((item) => item.key === ctx.to);
+            await deps.activity.record(tx.conn, {
+                issueId: issue.id,
+                actor,
+                action: 'owner_notified',
+                details: { statusKey: ctx.to, ownerUserId: issue.ownerUserId },
+            });
+            tx.emit({
+                type: 'status.ownerNotified',
+                issueId: issue.id,
+                identifier: issue.identifier,
+                title: issue.title,
+                ownerUserId: issue.ownerUserId,
+                statusKey: ctx.to,
+                statusName: status?.name ?? ctx.to,
+            });
+            return undefined;
+        },
+    })
+        .whoRule(KIND_MAY_MOVE_RULE, {
+        async allows(ctx) {
+            const kind = deps.kinds.get(ctx.actor.type);
+            if (!kind?.mayMove)
+                return true;
+            return kind.mayMove(ctx.context.conn, ctx.actor, {
+                issue: ctx.subject,
+                from: ctx.from,
+                to: ctx.to,
+            });
+        },
+    });
+}
+function transitionsOf(kinds, events) {
+    const transitions = [
+        { from: ANY_STATE, to: ANY_STATE, actors: [USER_KIND] },
+    ];
+    for (const kind of kinds) {
+        if (kind.key === USER_KIND || kind.key === SYSTEM_KIND)
+            continue;
+        for (const move of kind.moves ?? [])
+            transitions.push({
+                from: move.from,
+                to: move.to,
+                actors: [kind.key],
+                ...(kind.mayMove ? { who: { type: KIND_MAY_MOVE_RULE } } : {}),
+            });
+    }
+    for (const event of events)
+        for (const from of event.from)
+            if (from !== event.to)
+                transitions.push({
+                    from,
+                    to: event.to,
+                    actors: [SYSTEM_KIND],
+                    on: event.key,
+                });
+    return transitions;
+}
+const sameItems = (a, b) => a.length === b.length && a.every((item, index) => item === b[index]);
+export function createStatusService(deps) {
+    const rules = rulesOf(deps);
+    let built;
+    function catalog() {
+        const kinds = deps.kinds.list();
+        const events = deps.events.list();
+        if (built &&
+            sameItems(built.kinds, kinds) &&
+            sameItems(built.events, events))
+            return built.catalog;
+        const machine = compile({
+            states: FIXED_STATUSES.map((status) => ({
+                ...status,
+                builtIn: true,
+                ...(OWNER_NOTIFIED_STATUSES.includes(status.key)
+                    ? { rules: [{ type: NOTIFY_OWNER_RULE }] }
+                    : {}),
+            })),
+            transitions: transitionsOf(kinds, events),
+        });
+        built = {
+            kinds,
+            events,
+            catalog: {
+                statuses: FIXED_STATUSES,
+                category: statusCategory,
+                machine,
+                rules,
+            },
+        };
+        return built.catalog;
+    }
+    return {
+        list: () => FIXED_STATUSES,
+        category: statusCategory,
+        allowedMoves: (kind, from) => [
+            ...catalog().machine.allowedMoves(from, kind),
+        ],
+        catalog,
+    };
+}
+//# sourceMappingURL=status.catalog.js.map

package/dist/server/domains/statuses/status.catalog.js.map

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

package/dist/server/domains/statuses/status.events.d.ts

@@ -0,0 +1,15 @@
+declare module '../../kernel/events.js' {
+    interface DomainEventMap {
+        /** An issue entered a status whose owner is told (`blocked`, `in_review`), moved by someone else. */
+        'status.ownerNotified': {
+            readonly issueId: string;
+            readonly identifier: string;
+            readonly title: string;
+            readonly ownerUserId: string;
+            readonly statusKey: string;
+            readonly statusName: string;
+        };
+    }
+}
+export {};
+//# sourceMappingURL=status.events.d.ts.map

package/dist/server/domains/statuses/status.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.events.d.ts","sourceRoot":"","sources":["../../../../server/domains/statuses/status.events.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,cAAc;QACtB,qGAAqG;QACrG,sBAAsB,EAAE;YACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;YAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;YAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;YAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;SAC7B,CAAC;KACH;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/server/domains/statuses/status.events.js

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

package/dist/server/domains/statuses/status.events.js.map

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

package/dist/server/domains/statuses/status.fire.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Firing a status event (`event-types.ts`) for a batch of issues: the plugin that registered the event says it
+ * happened, and each issue in one of the event's `from` statuses moves to its `to` status. This plugin never knows what
+ * the event means.
+ *
+ * - The move is the system's: nobody approves it, and the issue's triggers and notices see the system. The activity
+ *   names `actor`, the person (or principal) whose action the event reports, with `note` and `details`.
+ * - Everything runs in one transaction: the caller's `tx` when given (so its own writes commit with the moves), else
+ *   a new one.
+ * - Only a registered event may be fired; an event nobody registered is a programming error (`TypeError`).
+ */
+import type { Actor } from '../../kernel/actor.js';
+import type { Tx, TxRunner } from '../../kernel/tx.js';
+import type { EventMove, EventTarget, IssueService } from '../issues/issue.service.js';
+import type { StatusEventTypes } from './event-types.js';
+export declare const EVENT_NOTE_MAX = 200;
+export declare const EVENT_BATCH_MAX = 500;
+export interface StatusEventFiring {
+    /** A registered event's key. */
+    readonly event: string;
+    /** The issues it happened to, by id or identifier, each once; at most `EVENT_BATCH_MAX`. */
+    readonly issueIds: readonly string[];
+    /** Whose action the event reports (the person who merged, say), named by the activity; the system when left out. */
+    readonly actor?: Actor;
+    /** A short phrase shown with the move, as it is, at most `EVENT_NOTE_MAX` characters. */
+    readonly note?: string;
+    /** Kept with each activity, opaque to this plugin. */
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+export type StatusEventMove = EventMove;
+export type StatusEventTarget = EventTarget;
+export interface StatusEventService {
+    /** Where other plugins register their events (`projectsStatusEventsToken`). */
+    readonly types: StatusEventTypes;
+    /** One result per issue, in the order given. 400 `INVALID_EVENT_FIRING` for a bad batch or note. */
+    fire(firing: StatusEventFiring, tx?: Tx): Promise<StatusEventMove[]>;
+    /**
+     * Where firing the event would take one issue (by id or identifier), without moving it: for a confirmation that
+     * says what an action will do. Read on `conn` when given, else outside any transaction.
+     */
+    target(event: string, issueId: string, conn?: Tx['conn']): Promise<StatusEventTarget>;
+}
+export declare function createStatusEventService(deps: {
+    readonly tx: TxRunner;
+    readonly types: StatusEventTypes;
+    readonly issues: () => Pick<IssueService, 'fireEvent' | 'eventTarget'>;
+}): StatusEventService;
+//# sourceMappingURL=status.fire.d.ts.map

package/dist/server/domains/statuses/status.fire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.fire.d.ts","sourceRoot":"","sources":["../../../../server/domains/statuses/status.fire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,oHAAoH;IACpH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC;AACxC,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,oGAAoG;IACpG,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACrE;;;OAGG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC;CACxE,GAAG,kBAAkB,CAyCrB"}

package/dist/server/domains/statuses/status.fire.js

@@ -0,0 +1,38 @@
+import { invalid } from '../../kernel/errors.js';
+export const EVENT_NOTE_MAX = 200;
+export const EVENT_BATCH_MAX = 500;
+export function createStatusEventService(deps) {
+    function registered(event) {
+        if (!deps.types.get(event))
+            throw new TypeError(`No plugin registered the status event ${event}.`);
+    }
+    return {
+        types: deps.types,
+        target(event, issueId, conn) {
+            registered(event);
+            return deps.issues().eventTarget(conn ?? deps.tx.read(), issueId, event);
+        },
+        async fire(firing, outer) {
+            registered(firing.event);
+            const ids = [...new Set(firing.issueIds)];
+            if (ids.length > EVENT_BATCH_MAX)
+                throw invalid('INVALID_EVENT_FIRING', `At most ${EVENT_BATCH_MAX} issues at once.`);
+            const note = firing.note?.trim();
+            if (note && note.length > EVENT_NOTE_MAX)
+                throw invalid('INVALID_EVENT_FIRING', `A note is at most ${EVENT_NOTE_MAX} characters.`);
+            if (ids.length === 0)
+                return [];
+            return deps.tx.run(async (tx) => {
+                const moves = [];
+                for (const id of ids)
+                    moves.push(await deps.issues().fireEvent(tx, id, firing.event, {
+                        ...(firing.actor ? { actor: firing.actor } : {}),
+                        ...(note ? { note } : {}),
+                        ...(firing.details ? { details: firing.details } : {}),
+                    }));
+                return moves;
+            }, outer);
+        },
+    };
+}
+//# sourceMappingURL=status.fire.js.map

package/dist/server/domains/statuses/status.fire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.fire.js","sourceRoot":"","sources":["../../../../server/domains/statuses/status.fire.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AASjD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAkCnC,MAAM,UAAU,wBAAwB,CAAC,IAIxC;IACC,SAAS,UAAU,CAAC,KAAa;QAC/B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC,yCAAyC,KAAK,GAAG,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI;YACzB,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK;YACtB,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzB,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC1C,IAAI,GAAG,CAAC,MAAM,GAAG,eAAe;gBAC9B,MAAM,OAAO,CACX,sBAAsB,EACtB,WAAW,eAAe,kBAAkB,CAC7C,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YACjC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,cAAc;gBACtC,MAAM,OAAO,CACX,sBAAsB,EACtB,qBAAqB,cAAc,cAAc,CAClD,CAAC;YACJ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;gBAC9B,MAAM,KAAK,GAAsB,EAAE,CAAC;gBACpC,KAAK,MAAM,EAAE,IAAI,GAAG;oBAClB,KAAK,CAAC,IAAI,CACR,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE;wBAClD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAChD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACzB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACvD,CAAC,CACH,CAAC;gBACJ,OAAO,KAAK,CAAC;YACf,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+export { createSubscriptionService, type SubscriptionService, } from './subscription.service.js';
+export { createSubscriptionRoutes } from './subscription.routes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../server/domains/subscriptions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,3 @@
+export { createSubscriptionService, } from './subscription.service.js';
+export { createSubscriptionRoutes } from './subscription.routes.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/domains/subscriptions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAE1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/server/domains/subscriptions/subscription.events.d.ts

@@ -0,0 +1,12 @@
+declare module '../../kernel/events.js' {
+    interface DomainEventMap {
+        /** Someone followed or stopped following an issue by hand. */
+        'subscription.changed': {
+            readonly issueId: string;
+            readonly userId: string;
+            readonly subscribed: boolean;
+        };
+    }
+}
+export {};
+//# sourceMappingURL=subscription.events.d.ts.map

package/dist/server/domains/subscriptions/subscription.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.events.d.ts","sourceRoot":"","sources":["../../../../server/domains/subscriptions/subscription.events.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,cAAc;QACtB,8DAA8D;QAC9D,sBAAsB,EAAE;YACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;SAC9B,CAAC;KACH;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/server/domains/subscriptions/subscription.events.js

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

package/dist/server/domains/subscriptions/subscription.events.js.map

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

package/dist/server/domains/subscriptions/subscription.routes.d.ts

@@ -0,0 +1,6 @@
+import type { Hono } from 'hono';
+import { type ViewerEnv } from '../../access/request.js';
+import type { SubscriptionService } from './subscription.service.js';
+/** Under `/api/projects/issues`: `POST /{issueId}/subscribe` and `/unsubscribe`, answering `{ subscribed }`. */
+export declare function createSubscriptionRoutes(subscriptions: SubscriptionService): Hono<ViewerEnv>;
+//# sourceMappingURL=subscription.routes.d.ts.map

package/dist/server/domains/subscriptions/subscription.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.routes.d.ts","sourceRoot":"","sources":["../../../../server/domains/subscriptions/subscription.routes.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,gHAAgH;AAChH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,mBAAmB,GACjC,IAAI,CAAC,SAAS,CAAC,CAwCjB"}

package/dist/server/domains/subscriptions/subscription.routes.js

@@ -0,0 +1,36 @@
+import { apiErrorResponse, apiErrorResponses, apiValidator, cliRoute, dataResponse, describeRoute, } from '@nocobase/app-server/router';
+import { viewerOf } from '../../access/request.js';
+import { domainRouter, tags } from '../../kernel/http.js';
+import { IssueParams, SubscriptionStateSchema } from '../../routes/schemas.js';
+/** Under `/api/projects/issues`: `POST /{issueId}/subscribe` and `/unsubscribe`, answering `{ subscribed }`. */
+export function createSubscriptionRoutes(subscriptions) {
+    const routes = domainRouter();
+    for (const [verb, subscribed] of [
+        ['subscribe', true],
+        ['unsubscribe', false],
+    ])
+        routes.post(`/:issueId/${verb}`, describeRoute({
+            tags,
+            summary: subscribed
+                ? "Subscribe to an issue's notifications"
+                : "Unsubscribe from an issue's notifications",
+            operationId: subscribed
+                ? 'projectsSubscribeIssue'
+                : 'projectsUnsubscribeIssue',
+            ...cliRoute({
+                command: `issue ${verb}`,
+                flags: { issueId: { name: 'issue' } },
+                action: 'pm.issues/view',
+            }),
+            description: 'Subscribing brings the issue’s comments and status changes to the inbox. `issueId` is an id or an identifier.',
+            responses: {
+                200: dataResponse(SubscriptionStateSchema),
+                ...apiErrorResponses,
+                404: apiErrorResponse(404),
+            },
+        }), apiValidator('param', IssueParams), async (context) => context.json({
+            data: await subscriptions.set(viewerOf(context), context.req.valid('param').issueId, subscribed),
+        }));
+    return routes;
+}
+//# sourceMappingURL=subscription.routes.js.map

package/dist/server/domains/subscriptions/subscription.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.routes.js","sourceRoot":"","sources":["../../../../server/domains/subscriptions/subscription.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,QAAQ,EAAkB,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAG/E,gHAAgH;AAChH,MAAM,UAAU,wBAAwB,CACtC,aAAkC;IAElC,MAAM,MAAM,GAAG,YAAY,EAAa,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI;QAC/B,CAAC,WAAW,EAAE,IAAI,CAAC;QACnB,CAAC,aAAa,EAAE,KAAK,CAAC;KACd;QACR,MAAM,CAAC,IAAI,CACT,aAAa,IAAI,EAAE,EACnB,aAAa,CAAC;YACZ,IAAI;YACJ,OAAO,EAAE,UAAU;gBACjB,CAAC,CAAC,uCAAuC;gBACzC,CAAC,CAAC,2CAA2C;YAC/C,WAAW,EAAE,UAAU;gBACrB,CAAC,CAAC,wBAAwB;gBAC1B,CAAC,CAAC,0BAA0B;YAC9B,GAAG,QAAQ,CAAC;gBACV,OAAO,EAAE,SAAS,IAAI,EAAE;gBACxB,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;gBACrC,MAAM,EAAE,gBAAgB;aACzB,CAAC;YACF,WAAW,EACT,+GAA+G;YACjH,SAAS,EAAE;gBACT,GAAG,EAAE,YAAY,CAAC,uBAAuB,CAAC;gBAC1C,GAAG,iBAAiB;gBACpB,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC;aAC3B;SACF,CAAC,EACF,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,EAClC,KAAK,EAAE,OAAO,EAAE,EAAE,CAChB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM,aAAa,CAAC,GAAG,CAC3B,QAAQ,CAAC,OAAO,CAAC,EACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,EAClC,UAAU,CACX;SACF,CAAC,CACL,CAAC;IACJ,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/domains/subscriptions/subscription.service.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Following issues. People follow an issue by hand here (anyone who may see it); the notice planner follows it for
+ * them when they create it, own it, execute it, comment on it or are mentioned in it (`domains/notices`).
+ */
+import type { DatabaseConnection } from '@nocobase/db';
+import type { IssueSubscriber, SubscriptionReason, SubscriptionState } from '../../../shared/subscriptions.js';
+import type { Viewer } from '../../access/viewer.js';
+import type { IdSource } from '../../kernel/ids.js';
+import type { TxRunner } from '../../kernel/tx.js';
+import type { UserDirectory } from '../../kernel/users.js';
+import './subscription.events.js';
+export interface SubscriptionService {
+    set(viewer: Viewer, issueIdOrKey: string, subscribed: boolean): Promise<SubscriptionState>;
+    /** The people following the issue, named, in the order they started. */
+    subscribers(conn: DatabaseConnection, issueId: string): Promise<IssueSubscriber[]>;
+    /** The ids of the people following the issue. */
+    subscriberIds(conn: DatabaseConnection, issueId: string): Promise<string[]>;
+    /** Of `issueIds`, those the person follows, in one read. */
+    followedBy(conn: DatabaseConnection, userId: string, issueIds: readonly string[]): Promise<Set<string>>;
+    /** Follows the issue for active users among `userIds`, in the caller's transaction. */
+    follow(conn: DatabaseConnection, issueId: string, userIds: Iterable<string>, reason: SubscriptionReason): Promise<void>;
+}
+export declare function createSubscriptionService(deps: {
+    readonly tx: TxRunner;
+    readonly ids: IdSource;
+    readonly users: UserDirectory;
+}): SubscriptionService;
+//# sourceMappingURL=subscription.service.d.ts.map

package/dist/server/domains/subscriptions/subscription.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.service.d.ts","sourceRoot":"","sources":["../../../../server/domains/subscriptions/subscription.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,0BAA0B,CAAC;AAQlC,MAAM,WAAW,mBAAmB;IAClC,GAAG,CACD,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,wEAAwE;IACxE,WAAW,CACT,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC9B,iDAAiD;IACjD,aAAa,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5E,4DAA4D;IAC5D,UAAU,CACR,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxB,uFAAuF;IACvF,MAAM,CACJ,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B,GAAG,mBAAmB,CAuDtB"}

package/dist/server/domains/subscriptions/subscription.service.js

@@ -0,0 +1,50 @@
+import { requireVisibleIssue } from '../issues/index.js';
+import './subscription.events.js';
+import { activeSubscriptions, followedAmong, subscribe, unsubscribe, } from './subscription.store.js';
+export function createSubscriptionService(deps) {
+    const nextId = () => deps.ids.next();
+    return {
+        set(viewer, issueIdOrKey, subscribed) {
+            return deps.tx.run(async (tx) => {
+                const issue = await requireVisibleIssue(tx.conn, viewer, issueIdOrKey);
+                const before = (await activeSubscriptions(tx.conn, issue.id)).some((row) => row.userId === viewer.userId);
+                if (subscribed)
+                    await subscribe(tx.conn, nextId, issue.id, viewer.userId, 'manual');
+                else
+                    await unsubscribe(tx.conn, nextId, issue.id, viewer.userId);
+                if (before !== subscribed) {
+                    tx.emit({ type: 'issue.changed', issueId: issue.id });
+                    tx.emit({
+                        type: 'subscription.changed',
+                        issueId: issue.id,
+                        userId: viewer.userId,
+                        subscribed,
+                    });
+                }
+                return { subscribed };
+            });
+        },
+        async subscribers(conn, issueId) {
+            const rows = await activeSubscriptions(conn, issueId);
+            const names = await deps.users.names(conn, rows.map((row) => row.userId));
+            return rows.map((row) => ({
+                userId: row.userId,
+                name: names.get(row.userId) ?? row.userId,
+                reason: row.reason,
+            }));
+        },
+        async subscriberIds(conn, issueId) {
+            return (await activeSubscriptions(conn, issueId)).map((row) => row.userId);
+        },
+        followedBy(conn, userId, issueIds) {
+            return followedAmong(conn, userId, issueIds);
+        },
+        async follow(conn, issueId, userIds, reason) {
+            for (const userId of new Set(userIds))
+                // API key identities act on issues but are never told about them.
+                if (await deps.users.isPerson(conn, userId))
+                    await subscribe(conn, nextId, issueId, userId, reason);
+        },
+    };
+}
+//# sourceMappingURL=subscription.service.js.map