@ketvietlab/ketsuite 0.1.29 → 0.1.31

package/dist/modules/flow/functions/board.js

@@ -0,0 +1,59 @@
+import { canReadProject, readableProject } from '../membership.js';
+import { invalid, issue } from '../domain/command.js';
+import { defineFn } from '@ketvietlab/ketjs';
+import { membershipEffects } from './effects.js';
+export async function boardScopeHandler(ctx) {
+    if (!ctx.actor)
+        return { projectId: null };
+    const held = (await ctx.db.select('flow.BoardScope', { userId: ctx.actor }))[0];
+    if (!held)
+        return { projectId: null };
+    // Where they were last is not where they may still go: somebody taken off
+    // a project keeps the row that remembers it, and answering with it would
+    // send the screen to a board that is no longer theirs — and would name a
+    // project they can no longer be told exists.
+    return (await canReadProject(ctx, held.projectId)) ? { projectId: held.projectId } : { projectId: null };
+}
+export async function boardRememberHandler(ctx, args) {
+    if (!ctx.actor)
+        return invalid(issue('actor', 'flow.error.actorRequired'));
+    const project = await readableProject(ctx, args.projectId);
+    if (!project || project.active !== true)
+        return invalid(issue('projectId', 'flow.error.notFound'));
+    // One row per reader **per company**. The id used to be the user id
+    // alone, which read as "one row per reader" and was not: the primary key
+    // is not company-scoped, so somebody who works in two companies got one
+    // row in whichever they opened first, and every later company answered
+    // `ok: true` and remembered nothing. Silent, and only visible as a board
+    // that would not stay where you left it (FLW-023).
+    const id = `${String(ctx.scope.company)}:${String(ctx.actor)}`;
+    const row = { id, userId: ctx.actor, projectId: args.projectId, updatedAt: new Date().toISOString() };
+    await ctx.db.insertIfAbsent('flow.BoardScope', row);
+    await ctx.db.update('flow.BoardScope', { id }, row);
+    return { ok: true };
+}
+export const boardFunctions = {
+    /**
+     * The project this reader's board last showed, if any.
+     *
+     * Answers null rather than guessing a project: the board asks them to pick
+     * once, and a wrong guess would show one team's work to somebody who wanted
+     * another's.
+     */
+    'board.scope': defineFn({
+        input: {},
+        output: { projectId: 'id?' },
+        effects: ['read:flow.BoardScope', ...membershipEffects],
+        agent: true,
+        handler: boardScopeHandler,
+    }),
+    'board.remember': defineFn({
+        input: { projectId: 'id' },
+        output: { ok: 'bool', errors: 'json?' },
+        effects: ['read:flow.BoardScope', 'write:flow.BoardScope', 'read:flow.Project', ...membershipEffects],
+        idempotent: true,
+        agent: true,
+        handler: boardRememberHandler,
+    }),
+};
+//# sourceMappingURL=board.js.map

package/dist/modules/flow/functions/board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/functions/board.ts"],"names":[],"mappings":"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"}

package/dist/modules/flow/functions/column.d.ts

@@ -0,0 +1,8 @@
+import type { Ctx, FnSpec } from '@ketvietlab/ketjs';
+export declare function columnListHandler(ctx: Ctx, args: Record<string, unknown>): Promise<import("@ketvietlab/ketjs").Row[]>;
+export declare function columnArchiveHandler(ctx: Ctx, args: Record<string, unknown>): Promise<import("../domain/command.ts").FlowResult | {
+    ok: boolean;
+    id: unknown;
+}>;
+export declare const columnFunctions: Record<string, FnSpec>;
+//# sourceMappingURL=column.d.ts.map

package/dist/modules/flow/functions/column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/functions/column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAOpD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,8CAW9E;AAED,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;GAOjF;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0ClD,CAAA"}

package/dist/modules/flow/functions/column.js

@@ -0,0 +1,64 @@
+import { canReadProject, readableRow } from '../membership.js';
+import { invalid, issue, n } from '../domain/command.js';
+import { defineFn } from '@ketvietlab/ketjs';
+import { membershipEffects } from './effects.js';
+import { saveEntity } from './entity-save.js';
+export async function columnListHandler(ctx, args) {
+    // A project's configuration is the project. Answering with its columns
+    // for somebody who cannot see the project describes it to them.
+    if (!(await canReadProject(ctx, args.projectId)))
+        return [];
+    const rows = await ctx.db.select('flow.Column', args.includeArchived === true
+        ? { projectId: args.projectId }
+        : { projectId: args.projectId, active: true });
+    return rows.sort((a, b) => n(a.sequence) - n(b.sequence) || String(a.id).localeCompare(String(b.id)));
+}
+export async function columnArchiveHandler(ctx, args) {
+    const existing = await readableRow(ctx, 'flow.Column', args.id);
+    if (!existing)
+        return invalid(issue('id', 'flow.error.notFound'));
+    const held = await ctx.db.select('flow.Issue', { columnId: args.id, active: true });
+    if (held.length)
+        return invalid(issue('id', 'flow.error.columnHasIssues'));
+    await ctx.db.update('flow.Column', { id: args.id }, { active: false });
+    return { ok: true, id: args.id };
+}
+export const columnFunctions = {
+    'column.list': defineFn({
+        input: { projectId: 'id', includeArchived: 'bool?' },
+        output: {
+            id: 'id',
+            projectId: 'id',
+            code: 'text',
+            name: 'text',
+            sequence: 'int',
+            terminalState: 'bool',
+            active: 'bool',
+        },
+        effects: [
+            'read:flow.Column',
+            'read:flow.Project',
+            'read:flow.ProjectMember',
+            'read:flow.ProjectAccessGrant',
+            'read:user.User',
+            ...membershipEffects,
+        ],
+        agent: true,
+        handler: columnListHandler,
+    }),
+    'column.save': saveEntity('flow.Column', ['id', 'projectId', 'code', 'name', 'sequence', 'terminalState', 'active'], ['projectId', 'code', 'name'], (args, existing) => ({
+        sequence: existing?.sequence ?? 10,
+        terminalState: existing?.terminalState ?? false,
+        active: existing?.active ?? true,
+        ...args,
+    })),
+    'column.archive': defineFn({
+        input: { id: 'id' },
+        output: { ok: 'bool', id: 'id?', errors: 'json?' },
+        effects: ['read:flow.Column', 'write:flow.Column', 'read:flow.Issue', ...membershipEffects],
+        idempotent: true,
+        agent: true,
+        handler: columnArchiveHandler,
+    }),
+};
+//# sourceMappingURL=column.js.map

package/dist/modules/flow/functions/column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/functions/column.ts"],"names":[],"mappings":"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"}

package/dist/modules/flow/functions/effects.d.ts

@@ -0,0 +1,21 @@
+/**
+ * What passing the membership gate costs in effects.
+ *
+ * Spread into every command that touches a project's data. Named because it is
+ * not a capability one function happens to need — it is the condition all of
+ * them read under, and a list copied at thirty call sites is a list that will
+ * disagree with itself.
+ */
+export declare const membershipEffects: readonly ['read:flow.Project', 'read:flow.ProjectMember', 'read:flow.ProjectAccessGrant', 'read:user.User'];
+export declare const flowReadEffects: readonly ['read:flow.Project', 'read:flow.ProjectMember', 'read:flow.ProjectAccessGrant', 'read:flow.Column', 'read:flow.IssueType', 'read:flow.FieldDef', 'read:mail.Follower', 'read:flow.IssueFieldValue', 'read:flow.Epic', 'read:flow.Sprint', 'read:flow.Issue', 'read:flow.IssueDependency', 'read:flow.Tag', 'read:flow.IssueTag', 'read:user.User', 'read:mail.Thread', 'read:mail.Message'];
+/**
+ * What writing one system entry to an issue's thread costs in effects.
+ *
+ * `postMessage` resolves the author, addresses the followers and writes the
+ * notification, so a command that leaves a timeline entry touches the same mail
+ * tables a comment does. Named here because three commands now do it.
+ */
+export declare const timelineEntryEffects: readonly ['read:mail.Thread', 'read:mail.Follower', 'write:mail.Follower', 'read:mail.FollowerSubtype', 'write:mail.FollowerSubtype', 'read:mail.Subtype', 'write:mail.Message', 'write:mail.TrackingValue', 'write:mail.Notification', 'read:user.User', 'read:partner.Partner'];
+export declare const issueWriteEffects: readonly ["read:flow.Project", "read:flow.ProjectMember", "read:flow.ProjectAccessGrant", "read:flow.Column", "read:flow.IssueType", "read:flow.FieldDef", "read:mail.Follower", "read:flow.IssueFieldValue", "read:flow.Epic", "read:flow.Sprint", "read:flow.Issue", "read:flow.IssueDependency", "read:flow.Tag", "read:flow.IssueTag", "read:user.User", "read:mail.Thread", "read:mail.Message", "write:flow.Issue", "write:flow.IssueTag", "write:flow.IssueFieldValue", "write:mail.Thread", "read:mail.Follower", "write:mail.Follower", "read:mail.FollowerSubtype", "write:mail.FollowerSubtype", "read:mail.Subtype", "write:mail.Message", "write:mail.Mention", "write:mail.MessageAttachment", "write:mail.TrackingValue", "write:mail.Notification", "read:partner.Partner"];
+export declare const commentEffects: readonly ['read:flow.Issue', 'read:mail.Thread', 'write:mail.Thread', 'read:mail.Message', 'write:mail.Message', 'read:mail.Follower', 'read:mail.FollowerSubtype', 'read:mail.Subtype', 'write:mail.Mention', 'write:mail.MessageAttachment', 'write:mail.TrackingValue', 'write:mail.Notification', 'write:mail.Follower', 'write:mail.FollowerSubtype', 'read:user.User', 'read:partner.Partner'];
+//# sourceMappingURL=effects.d.ts.map

package/dist/modules/flow/functions/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/functions/effects.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,YAC5B,mBAAmB,EACnB,yBAAyB,EACzB,8BAA8B,EAC9B,gBAAgB,CACR,CAAA;AAEV,eAAO,MAAM,eAAe,YAC1B,mBAAmB,EAInB,yBAAyB,EACzB,8BAA8B,EAC9B,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,CACX,CAAA;AAEV;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,YAC/B,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,4BAA4B,EAC5B,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,CACd,CAAA;AAEV,eAAO,MAAM,iBAAiB,6vBAoBpB,CAAA;AAEV,eAAO,MAAM,cAAc,YACzB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,CACd,CAAA"}

package/dist/modules/flow/functions/effects.js

@@ -0,0 +1,96 @@
+/**
+ * What passing the membership gate costs in effects.
+ *
+ * Spread into every command that touches a project's data. Named because it is
+ * not a capability one function happens to need — it is the condition all of
+ * them read under, and a list copied at thirty call sites is a list that will
+ * disagree with itself.
+ */
+export const membershipEffects = [
+    'read:flow.Project',
+    'read:flow.ProjectMember',
+    'read:flow.ProjectAccessGrant',
+    'read:user.User',
+];
+export const flowReadEffects = [
+    'read:flow.Project',
+    // The membership gate every Flow read now passes through — see membership.ts.
+    // Named here rather than at each call site because it is not a capability one
+    // function happens to need; it is the condition all of them read under.
+    'read:flow.ProjectMember',
+    'read:flow.ProjectAccessGrant',
+    'read:flow.Column',
+    'read:flow.IssueType',
+    'read:flow.FieldDef',
+    'read:mail.Follower',
+    'read:flow.IssueFieldValue',
+    'read:flow.Epic',
+    'read:flow.Sprint',
+    'read:flow.Issue',
+    'read:flow.IssueDependency',
+    'read:flow.Tag',
+    'read:flow.IssueTag',
+    'read:user.User',
+    'read:mail.Thread',
+    'read:mail.Message',
+];
+/**
+ * What writing one system entry to an issue's thread costs in effects.
+ *
+ * `postMessage` resolves the author, addresses the followers and writes the
+ * notification, so a command that leaves a timeline entry touches the same mail
+ * tables a comment does. Named here because three commands now do it.
+ */
+export const timelineEntryEffects = [
+    'read:mail.Thread',
+    'read:mail.Follower',
+    'write:mail.Follower',
+    'read:mail.FollowerSubtype',
+    'write:mail.FollowerSubtype',
+    'read:mail.Subtype',
+    'write:mail.Message',
+    'write:mail.TrackingValue',
+    'write:mail.Notification',
+    'read:user.User',
+    'read:partner.Partner',
+];
+export const issueWriteEffects = [
+    ...flowReadEffects,
+    'write:flow.Issue',
+    'write:flow.IssueTag',
+    'write:flow.IssueFieldValue',
+    'write:mail.Thread',
+    // Saving an issue now subscribes its author and its assignee to the thread,
+    // and writes a system entry when it changes hands — so it touches the same
+    // mail tables a comment does.
+    'read:mail.Follower',
+    'write:mail.Follower',
+    'read:mail.FollowerSubtype',
+    'write:mail.FollowerSubtype',
+    'read:mail.Subtype',
+    'write:mail.Message',
+    'write:mail.Mention',
+    'write:mail.MessageAttachment',
+    'write:mail.TrackingValue',
+    'write:mail.Notification',
+    'read:partner.Partner',
+];
+export const commentEffects = [
+    'read:flow.Issue',
+    'read:mail.Thread',
+    'write:mail.Thread',
+    'read:mail.Message',
+    'write:mail.Message',
+    'read:mail.Follower',
+    'read:mail.FollowerSubtype',
+    'read:mail.Subtype',
+    'write:mail.Mention',
+    'write:mail.MessageAttachment',
+    'write:mail.TrackingValue',
+    'write:mail.Notification',
+    'write:mail.Follower',
+    'write:mail.FollowerSubtype',
+    'read:user.User',
+    'read:partner.Partner',
+];
+//# sourceMappingURL=effects.js.map

package/dist/modules/flow/functions/effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/functions/effects.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,mBAAmB;IACnB,yBAAyB;IACzB,8BAA8B;IAC9B,gBAAgB;CACR,CAAA;AAEV,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,mBAAmB;IACnB,8EAA8E;IAC9E,8EAA8E;IAC9E,wEAAwE;IACxE,yBAAyB;IACzB,8BAA8B;IAC9B,kBAAkB;IAClB,qBAAqB;IACrB,oBAAoB;IACpB,oBAAoB;IACpB,2BAA2B;IAC3B,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,2BAA2B;IAC3B,eAAe;IACf,oBAAoB;IACpB,gBAAgB;IAChB,kBAAkB;IAClB,mBAAmB;CACX,CAAA;AAEV;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,kBAAkB;IAClB,oBAAoB;IACpB,qBAAqB;IACrB,2BAA2B;IAC3B,4BAA4B;IAC5B,mBAAmB;IACnB,oBAAoB;IACpB,0BAA0B;IAC1B,yBAAyB;IACzB,gBAAgB;IAChB,sBAAsB;CACd,CAAA;AAEV,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,eAAe;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,4BAA4B;IAC5B,mBAAmB;IACnB,4EAA4E;IAC5E,2EAA2E;IAC3E,8BAA8B;IAC9B,oBAAoB;IACpB,qBAAqB;IACrB,2BAA2B;IAC3B,4BAA4B;IAC5B,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,8BAA8B;IAC9B,0BAA0B;IAC1B,yBAAyB;IACzB,sBAAsB;CACd,CAAA;AAEV,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,iBAAiB;IACjB,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,2BAA2B;IAC3B,mBAAmB;IACnB,oBAAoB;IACpB,8BAA8B;IAC9B,0BAA0B;IAC1B,yBAAyB;IACzB,qBAAqB;IACrB,4BAA4B;IAC5B,gBAAgB;IAChB,sBAAsB;CACd,CAAA"}

package/dist/modules/flow/functions/entity-save.d.ts

@@ -0,0 +1,4 @@
+import type { Row } from '@ketvietlab/ketjs';
+/** Plain upsert for the entities with no CAS field — no concurrent editor to race against. */
+export declare const saveEntity: (model: string, fields: string[], required: string[], defaults: (values: Row, existing: Row | undefined) => Row) => import("@ketvietlab/ketjs").FnSpec;
+//# sourceMappingURL=entity-save.d.ts.map

package/dist/modules/flow/functions/entity-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-save.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/functions/entity-save.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAO,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAMjD,8FAA8F;AAC9F,eAAO,MAAM,UAAU,UACd,MAAM,UACL,MAAM,EAAE,YACN,MAAM,EAAE,YACR,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,GAAG,SAAS,KAAK,GAAG,uCAmD1D,CAAA"}

package/dist/modules/flow/functions/entity-save.js

@@ -0,0 +1,60 @@
+import { command } from '../domain/command-check.js';
+import { invalid, issue } from '../domain/command.js';
+import { addMember, canReadProject } from '../membership.js';
+import { defineFn } from '@ketvietlab/ketjs';
+/** Plain upsert for the entities with no CAS field — no concurrent editor to race against. */
+export const saveEntity = (model, fields, required, defaults) => {
+    async function saveEntityHandler(ctx, args) {
+        const error = command(ctx, args.idempotencyKey);
+        if (error)
+            return error;
+        if (!args.values || typeof args.values !== 'object')
+            return invalid(issue('values', 'flow.error.required'));
+        const values = args.values;
+        const id = String(values.id ?? '');
+        if (!id)
+            return invalid(issue('id', 'flow.error.required'));
+        // Two shapes, one rule. A project's own row is named by its id; everything
+        // else this builds — columns, issue types, epics — names its project in a
+        // column. Either way, writing into a project a caller cannot see is the
+        // thing this refuses, and it refuses it as "not found".
+        const target = model === 'flow.Project' ? id : String(values.projectId ?? '');
+        const existing = (await ctx.db.select(model, { id }))[0];
+        const known = model === 'flow.Project' ? Boolean(existing) : true;
+        if (known && target && !(await canReadProject(ctx, target)))
+            return invalid(issue('id', 'flow.error.notFound'));
+        const cs = ctx.change(model, { ...defaults(values, existing), ...values }, existing ?? null).cast(fields);
+        const withRequired = required.length ? cs.required(required) : cs;
+        if (!withRequired.valid)
+            return { ok: false, errors: withRequired.errors };
+        await ctx.db.commit(withRequired, existing ? { id } : undefined);
+        // A project nobody can see is not a project anybody asked for, and there
+        // is no other door: membership is what makes it visible, so the person
+        // who created it has to walk through first.
+        if (model === 'flow.Project' && !existing && ctx.actor)
+            await addMember(ctx, {
+                projectId: id,
+                userId: ctx.actor,
+                addedByUserId: ctx.actor,
+                at: new Date().toISOString(),
+            });
+        return { ok: true, id };
+    }
+    return defineFn({
+        input: { values: 'json', idempotencyKey: 'text' },
+        output: { ok: 'bool', id: 'id?', errors: 'json?' },
+        effects: [
+            `read:${model}`,
+            `write:${model}`,
+            'read:flow.Project',
+            'write:flow.ProjectMember',
+            'read:flow.ProjectMember',
+            'read:flow.ProjectAccessGrant',
+            'read:user.User',
+        ],
+        idempotent: true,
+        agent: true,
+        handler: saveEntityHandler,
+    });
+};
+//# sourceMappingURL=entity-save.js.map

package/dist/modules/flow/functions/entity-save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-save.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/functions/entity-save.ts"],"names":[],"mappings":"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"}

package/dist/modules/flow/functions/epic.d.ts

@@ -0,0 +1,26 @@
+import type { Ctx, FnSpec, Row } from '@ketvietlab/ketjs';
+export declare function epicListHandler(ctx: Ctx, args: Record<string, unknown>): Promise<{
+    total: number;
+    done: number;
+    estimate: number;
+    estimateDone: number;
+}[]>;
+export declare function epicListAllHandler(ctx: Ctx, args: Record<string, unknown>): Promise<{
+    rows: (Row & {
+        projectName: string;
+    })[];
+    total: number;
+}>;
+export declare function epicGetHandler(ctx: Ctx, args: Record<string, unknown>): Promise<{
+    value: Row | null;
+}>;
+export declare function epicEditContentHandler(ctx: Ctx, args: Record<string, unknown>): Promise<{
+    id: unknown;
+    contentAttachmentId: {} | null;
+} | null>;
+export declare function epicArchiveHandler(ctx: Ctx, args: Record<string, unknown>): Promise<import("../domain/command.ts").FlowResult | {
+    ok: boolean;
+    id: unknown;
+}>;
+export declare const epicFunctions: Record<string, FnSpec>;
+//# sourceMappingURL=epic.d.ts.map

package/dist/modules/flow/functions/epic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/functions/epic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAQzD,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;KAiB5E;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;qBAa1C,MAAM;;;GAa3C;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;GAG3E;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;UAGnF;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;GAK/E;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0FhD,CAAA"}

package/dist/modules/flow/functions/epic.js

@@ -0,0 +1,151 @@
+import { canReadProject, readableRow, visibleRows } from '../membership.js';
+import { epicTotals } from '../queries/progress.js';
+import { invalid, issue, n, normalized } from '../domain/command.js';
+import { defineFn } from '@ketvietlab/ketjs';
+import { membershipEffects } from './effects.js';
+import { saveEntity } from './entity-save.js';
+export async function epicListHandler(ctx, args) {
+    if (!(await canReadProject(ctx, args.projectId)))
+        return [];
+    const where = { projectId: args.projectId };
+    if (args.id)
+        where.id = args.id;
+    if (args.includeArchived !== true)
+        where.active = true;
+    const [rows, totals] = await Promise.all([
+        ctx.db.select('flow.Epic', where),
+        epicTotals(ctx, String(args.projectId)),
+    ]);
+    const needle = normalized(args.search);
+    const filtered = rows
+        .filter((row) => !needle || normalized(row.title).includes(needle))
+        .map((row) => ({
+        ...row,
+        ...(totals.get(String(row.id)) ?? { total: 0, done: 0, estimate: 0, estimateDone: 0 }),
+    }));
+    return args.id ? filtered : filtered.slice(0, Math.max(1, Math.min(200, n(args.limit ?? 80))));
+}
+export async function epicListAllHandler(ctx, args) {
+    // Every project's epics means every project this caller may see. The
+    // screen behind it is the cross-project one, so nothing else narrows it.
+    const [epics, projects] = await Promise.all([
+        visibleRows(ctx, 'flow.Epic', { active: true }),
+        ctx.db.select('flow.Project', { active: true }),
+    ]);
+    const named = new Map(projects.map((project) => [String(project.id), String(project.name ?? '')]));
+    const needle = normalized(args.search);
+    const rows = epics
+        .filter((epic) => named.has(String(epic.projectId)) && (!needle || normalized(epic.title).includes(needle)))
+        .map((epic) => ({
+        ...epic,
+        projectName: named.get(String(epic.projectId)) ?? '',
+    }))
+        .sort((a, b) => String(a.projectName).localeCompare(String(b.projectName)) ||
+        String(a.title ?? '').localeCompare(String(b.title ?? '')) ||
+        String(a.id).localeCompare(String(b.id)));
+    const cursor = Math.max(0, n(args.cursor ?? 0));
+    const limit = Math.max(1, Math.min(200, n(args.limit ?? 50)));
+    return { rows: rows.slice(cursor, cursor + limit), total: rows.length };
+}
+export async function epicGetHandler(ctx, args) {
+    const held = (await ctx.db.select('flow.Epic', { id: args.id }))[0] ?? null;
+    return { value: held && (await canReadProject(ctx, held.projectId)) ? held : null };
+}
+export async function epicEditContentHandler(ctx, args) {
+    const row = await readableRow(ctx, 'flow.Epic', args.id);
+    return row ? { id: row.id, contentAttachmentId: row.contentAttachmentId ?? null } : null;
+}
+export async function epicArchiveHandler(ctx, args) {
+    const existing = await readableRow(ctx, 'flow.Epic', args.id);
+    if (!existing)
+        return invalid(issue('id', 'flow.error.notFound'));
+    await ctx.db.update('flow.Epic', { id: args.id }, { active: false });
+    return { ok: true, id: args.id };
+}
+export const epicFunctions = {
+    'epic.list': defineFn({
+        input: { projectId: 'id', id: 'id?', search: 'text?', limit: 'int?', includeArchived: 'bool?' },
+        output: {
+            id: 'id',
+            projectId: 'id',
+            title: 'text',
+            color: 'text?',
+            previewText: 'text?',
+            contentAttachmentId: 'id?',
+            active: 'bool',
+            total: 'int',
+            done: 'int',
+            estimate: 'decimal',
+            estimateDone: 'decimal',
+        },
+        effects: ['read:flow.Epic', 'read:flow.Issue', 'read:flow.Column', ...membershipEffects],
+        agent: true,
+        handler: epicListHandler,
+    }),
+    /**
+     * The menu-level epic collection, paged after one company-scoped read.
+     *
+     * `epic.list` remains project-scoped for relation controls and project
+     * screens. Folding those calls together in the backend inherited both its
+     * 80-row default and `project.list`'s 200-row cap, so an "all" screen could
+     * silently omit valid records.
+     */
+    'epic.listAll': defineFn({
+        input: { search: 'text?', cursor: 'int?', limit: 'int?' },
+        output: { rows: 'json', total: 'int' },
+        effects: [
+            'read:flow.Epic',
+            'read:flow.Project',
+            'read:flow.ProjectMember',
+            'read:flow.ProjectAccessGrant',
+            'read:user.User',
+        ],
+        agent: true,
+        handler: epicListAllHandler,
+    }),
+    /**
+     * One epic by id — what Live Doc reads to find its stored document, and what
+     * the epic's own screen is built from.
+     */
+    'epic.get': defineFn({
+        input: { id: 'id' },
+        output: { value: 'json?' },
+        effects: [
+            'read:flow.Epic',
+            'read:flow.Project',
+            'read:flow.ProjectMember',
+            'read:flow.ProjectAccessGrant',
+            'read:user.User',
+        ],
+        agent: true,
+        handler: epicGetHandler,
+    }),
+    /**
+     * Rewriting an epic's document, as a permission key of its own — the same
+     * split `page.editContent` makes, and for the same reason.
+     */
+    'epic.editContent': defineFn({
+        input: { id: 'id' },
+        // The fields as they are actually returned, not a `value` wrapper the
+        // handler never builds: output is projected against these keys, so
+        // declaring `value` and answering `{ id, contentAttachmentId }` threw both
+        // away and handed the caller `{}`. Live Doc reads `contentAttachmentId`
+        // off this to find the stored snapshot, so an empty answer read as "never
+        // written" — and the next push started from a blank document and flattened
+        // it over the real one.
+        output: { id: 'id?', contentAttachmentId: 'id?' },
+        effects: ['read:flow.Epic', ...membershipEffects],
+        agent: true,
+        handler: epicEditContentHandler,
+    }),
+    'epic.save': saveEntity('flow.Epic', ['id', 'projectId', 'title', 'color', 'active'], ['projectId', 'title'], (args, existing) => ({ active: existing?.active ?? true, ...args })),
+    'epic.archive': defineFn({
+        input: { id: 'id' },
+        output: { ok: 'bool', id: 'id?', errors: 'json?' },
+        effects: ['read:flow.Epic', 'write:flow.Epic', ...membershipEffects],
+        idempotent: true,
+        agent: true,
+        handler: epicArchiveHandler,
+    }),
+};
+//# sourceMappingURL=epic.js.map

package/dist/modules/flow/functions/epic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/functions/epic.ts"],"names":[],"mappings":"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"}

package/dist/modules/flow/functions/field.d.ts

@@ -0,0 +1,9 @@
+import type { Ctx, FnSpec } from '@ketvietlab/ketjs';
+export declare function fieldListHandler(ctx: Ctx, args: Record<string, unknown>): Promise<import("@ketvietlab/ketjs").Row[]>;
+export declare function fieldSaveHandler(ctx: Ctx, args: Record<string, unknown>): Promise<import("../domain/command.ts").FlowResult>;
+export declare function fieldArchiveHandler(ctx: Ctx, args: Record<string, unknown>): Promise<import("../domain/command.ts").FlowResult | {
+    ok: boolean;
+    id: unknown;
+}>;
+export declare const fieldFunctions: Record<string, FnSpec>;
+//# sourceMappingURL=field.d.ts.map

package/dist/modules/flow/functions/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/functions/field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAQpD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,8CAS7E;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,sDA6B7E;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;GAKhF;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8DjD,CAAA"}