@ketvietlab/ketsuite 0.1.25 → 0.1.30

package/dist/modules/flow/queries/issue-dependencies.js

@@ -0,0 +1,46 @@
+import { restrictToVisible, visibleProjects } from '../membership.js';
+import { eq, from, inArray } from '@ketvietlab/ketjs';
+/**
+ * Blocking dependencies leading into a given set of issues, batched — the map
+ * view (flow_backend's dependency atlas, one epic at a time) needs the edges
+ * among its own node set, not the per-issue read `issueDetail` already does.
+ * No JOIN in this query builder by design, so this is one query against
+ * `IssueDependency` alone.
+ *
+ * Both ends are matched by default: an edge pointing out of the set is not an
+ * edge of the set. The map opts into outgoing edges so it can page a large
+ * source set in bounded chunks, then filters both ends against the complete
+ * epic after aggregation. The id list remains capped because it arrives over
+ * HTTP.
+ */
+export const DEPENDENCY_BATCH = 200;
+export async function dependenciesFor(ctx, issueIds, includeExternalTargets = false) {
+    const asked = [...new Set(issueIds.map(String))].slice(0, DEPENDENCY_BATCH);
+    if (!asked.length)
+        return [];
+    // The ids arrive from the caller, not from a query this function ran, so the
+    // membership rule has to be applied to them here. Without it, naming an issue
+    // in somebody else's project answered whether it had blockers — a small
+    // answer, and still an answer about a project that is supposed to be
+    // invisible (FLW-018).
+    const I = ctx.table('flow.Issue');
+    const visible = await visibleProjects(ctx);
+    const readable = await ctx.db.all(restrictToVisible(from(I).select(I.id).where(inArray(I.id, asked)), I.projectId, visible));
+    const ids = readable.map((row) => String(row.id));
+    if (!ids.length)
+        return [];
+    const D = ctx.table('flow.IssueDependency');
+    const held = new Set(ids);
+    const rows = await ctx.db.all(from(D).where(inArray(D.issueId, ids), eq(D.relation, 'blocks')));
+    // An external target is an issue outside the set that was asked about, which
+    // the map draws an arrow to. It may still be one the caller cannot read, so
+    // the far end is filtered the same way the near end was.
+    if (!includeExternalTargets)
+        return rows.filter((row) => held.has(String(row.dependsOnIssueId)));
+    const targets = [...new Set(rows.map((row) => String(row.dependsOnIssueId)))].filter((id) => !held.has(id));
+    if (!targets.length)
+        return rows;
+    const reachable = new Set((await ctx.db.all(restrictToVisible(from(I).select(I.id).where(inArray(I.id, targets)), I.projectId, visible))).map((row) => String(row.id)));
+    return rows.filter((row) => held.has(String(row.dependsOnIssueId)) || reachable.has(String(row.dependsOnIssueId)));
+}
+//# sourceMappingURL=issue-dependencies.js.map

package/dist/modules/flow/queries/issue-dependencies.js.map

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

package/dist/modules/flow/queries/issue-followers.d.ts

@@ -0,0 +1,6 @@
+import type { Ctx } from '@ketvietlab/ketjs';
+/**
+ * Whether the reader follows this issue, so a screen can offer the right verb.
+ */
+export declare function following(ctx: Ctx, issueId: string): Promise<boolean>;
+//# sourceMappingURL=issue-followers.d.ts.map

package/dist/modules/flow/queries/issue-followers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-followers.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/queries/issue-followers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAG5C;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3E"}

package/dist/modules/flow/queries/issue-followers.js

@@ -0,0 +1,18 @@
+import { readableRow } from '../membership.js';
+/**
+ * Whether the reader follows this issue, so a screen can offer the right verb.
+ */
+export async function following(ctx, issueId) {
+    const held = await readableRow(ctx, 'flow.Issue', issueId);
+    if (!held || !ctx.actor)
+        return false;
+    const user = (await ctx.db.select('user.User', { id: ctx.actor }))[0];
+    if (!user?.partnerId)
+        return false;
+    const rows = await ctx.db.select('mail.Follower', {
+        threadId: held.threadId,
+        partnerId: user.partnerId,
+    });
+    return rows.length > 0;
+}
+//# sourceMappingURL=issue-followers.js.map

package/dist/modules/flow/queries/issue-followers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-followers.js","sourceRoot":"","sources":["../../../../../../../../packages/ketsuite/src/modules/flow/queries/issue-followers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAQ,EAAE,OAAe;IACvD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;IAC1D,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACrC,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACrE,IAAI,CAAC,IAAI,EAAE,SAAS;QAAE,OAAO,KAAK,CAAA;IAClC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE;QAChD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAA;IACF,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;AACxB,CAAC"}

package/dist/modules/flow/queries/issue-list.d.ts

@@ -0,0 +1,153 @@
+import type { Ctx, ListState, Row } from '@ketvietlab/ketjs';
+/**
+ * How far along each issue is, counted from its sub-tasks.
+ *
+ * "Done" is a sub-task sitting in a column with `terminalState` — the concept
+ * models.ts introduced for exactly this kind of question, so that a team whose
+ * workflow is five columns wide gets the same answer as one running three, and
+ * neither has to be called "Done".
+ *
+ * Sub-tasks are the checklist. The description can hold one too, and does, but
+ * that one is prose: nobody can be given an item in it, nothing can be counted
+ * from outside the document, and it is not what this reads.
+ *
+ * Unlimited on purpose, unlike `dependenciesFor` below. The query is already
+ * bounded twice over — by one page of parents, and by sub-tasks being a
+ * relation a person types out by hand — and a cap on a *count* is worse than a
+ * cap on a list: a truncated list looks truncated, while 3/5 that should read
+ * 3/9 just looks wrong.
+ */
+export declare function progressOf(ctx: Ctx, issueIds: string[]): Promise<Map<string, {
+    done: number;
+    total: number;
+}>>;
+export declare function serializeIssueList(ctx: Ctx, rows: Row[]): Promise<Row[]>;
+/**
+ * How many issues one custom-field filter may match.
+ *
+ * The value lives in another table and this query builder has no JOIN, so the
+ * rule is answered by collecting ids and handing them to `IN (...)`. That list
+ * becomes SQL parameters, and every database has a ceiling on those — SQLite's
+ * has historically been 999.
+ *
+ * Capped rather than left to fail at the driver, and reported rather than
+ * trimmed quietly: a truncated *list* looks truncated, while a truncated
+ * *filter* looks like an answer. `listIssues` passes `fieldFilterTruncated`
+ * back so a screen can say so.
+ */
+export declare const FIELD_FILTER_MATCHES = 900;
+export type FieldFilterOutcome = {
+    state: ListState;
+    ids: string[] | null;
+    truncated: boolean;
+};
+/**
+ * Answers every `field:<code>` rule as a set of issue ids, and takes the rules
+ * out of the state on the way.
+ *
+ * The value lives in another table, so the rule cannot compile against a column
+ * of `flow.Issue`. Rewriting it in place does not work either — the spec
+ * declares a select field's `choices`, and a list of ids is not among them, so
+ * validation refuses the rewritten rule. So the rules leave, and what they
+ * selected is applied to the query directly.
+ *
+ * Only the top level is read, which is the only shape the filter UI builds
+ * (facets and the custom-filter row are both flat, and flat means AND). A rule
+ * nested inside an `or` group is left where it is rather than quietly hoisted
+ * out of it: removing one from an `or` widens the group, and answering a
+ * narrower question than was asked is the failure that looks like success.
+ */
+export declare function resolveFieldFilters(ctx: Ctx, state: ListState, projectId: unknown): Promise<FieldFilterOutcome>;
+export declare const listStateOf: (value: unknown) => ListState | null;
+/**
+ * The columns a board treats as finished, and the one it starts from.
+ *
+ * Read once and shared, because "late" and "not started" both need them and
+ * two readings could disagree. A finished issue is never late, however long
+ * ago its date was — the work is done, and a red date on it would be asking
+ * for something that has already happened.
+ */
+export declare const boardEdges: (ctx: Ctx) => Promise<{
+    terminal: string[];
+    first: string[];
+}>;
+export declare const issueQuery: (ctx: Ctx, args: Record<string, unknown>) => Promise<{
+    query: import("@ketvietlab/ketjs").Query;
+    state: ListState;
+    spec: {
+        key: string;
+        searchable: {
+            key: string;
+            col: import("@ketvietlab/ketjs").Col;
+        }[];
+        filterable: import("@ketvietlab/ketjs").FilterFieldSpec[];
+        groupable: ({
+            intervals?: undefined;
+            key: string;
+            label: string;
+            col: import("@ketvietlab/ketjs").Col;
+        } | {
+            key: string;
+            label: string;
+            col: import("@ketvietlab/ketjs").Col;
+            intervals: ("day" | "month" | "quarter" | "week" | "year")[];
+        })[];
+        sortable: {
+            key: string;
+            label: string;
+            col: import("@ketvietlab/ketjs").Col;
+        }[];
+        presets: {
+            key: string;
+            label: string;
+            group: string;
+            expr: import("@ketvietlab/ketjs").Expr;
+        }[];
+        defaultSort: {
+            key: string;
+            dir: "desc";
+        }[];
+    };
+    timezone: string;
+    truncated: boolean;
+}>;
+export declare function listIssues(ctx: Ctx, args: Record<string, unknown>): Promise<{
+    rows: Row[];
+    total: number;
+    nextCursor: string | null;
+    fieldFilterTruncated?: boolean;
+}>;
+export declare function groupIssues(ctx: Ctx, args: Record<string, unknown>): Promise<import("@ketvietlab/ketjs").GroupRow[]>;
+/**
+ * How the issues in view divide up: finished, late, not started, under way.
+ *
+ * Counted, not listed. Each figure is a `count` over the same query the list
+ * itself runs, so a board of a thousand issues costs four counts rather than a
+ * thousand rows — and every bucket answers the question the list is already
+ * filtered by, instead of describing something wider than what is on screen.
+ *
+ * The four are disjoint and add up to the total, which is the only way a row of
+ * figures beside a list is readable at all:
+ *
+ *   done      the issue sits in a column marked `terminalState`
+ *   overdue   not done, has a due date, and that date has passed
+ *   waiting   not done, not overdue, in the first column of its board
+ *   working   everything else that is not done
+ *
+ * "First column" is what stands in for "not started". A project has no such
+ * flag, but a board is ordered and its first column is where work lands before
+ * anyone picks it up — see `Column.sequence`. It is a reading of real rows
+ * rather than a status nobody sets.
+ */
+export type IssueBuckets = {
+    total: number;
+    done: number;
+    overdue: number;
+    waiting: number;
+    working: number;
+    /** The civil date these counts were taken against, for the screen to reuse. */
+    today: string;
+};
+export declare function issueBuckets(ctx: Ctx, args: Record<string, unknown>, today?: string): Promise<IssueBuckets>;
+export declare function issueDetail(ctx: Ctx, id: string): Promise<Row | null>;
+//# sourceMappingURL=issue-list.d.ts.map

package/dist/modules/flow/queries/issue-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-list.d.ts","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/flow/queries/issue-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAuB5D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAsBvD;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAqG9E;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAA;AAE/F;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA0C7B;AAED,eAAO,MAAM,WAAW,UAAW,OAAO,KAAG,SAAS,GAAG,IACS,CAAA;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,QAAe,GAAG,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAe1F,CAAA;AAED,eAAO,MAAM,UAAU,QAAe,GAAG,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmEvE,CAAA;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IACT,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAC,CAgBD;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,mDAYxE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,CA4BvB;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CA8D3E"}