@pattern-stack/codegen 0.26.0 → 0.27.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.26.1] — 2026-06-07
+
+### Fixed
+
+- **Sink-seam emitter (#491 Shape C): generated `*.sink.generated.ts` bases now
+  compile for the relative-path (swe-brain) layout.** Two defects made every
+  emitted base non-compiling when no tsconfig alias covers the module dir
+  (#528):
+  - **Repo import one level too deep.** The sink base lives at
+    `integrations/<surface>/sinks/` (3 deep under `src/`) but reused the
+    *assembly*-relative `repoImportSpecifier` (computed for
+    `integrations/<surface>/modules/<provider>/`, 4 deep), emitting
+    `../../../../modules/…` — which lands at the repo root, not `src/` (TS2307).
+    The caller now recomputes the specifier relative to the SINK dir from the
+    resolved repo file path (alias-aware via the same `toImportSpecifier`
+    helper, now exported; `EntityModuleLocation` carries `repoFileAbs` /
+    `moduleFileAbs`). Correct prefix: `../../../modules/…`. The assembly import
+    depth is unchanged.
+  - **Bare `userId,` shorthand (TS18004).** `default<E>BuildWrite(record)` is a
+    standalone function with only `record` in scope, but a declared `user_id`
+    field was special-cased as a bare `userId,` shorthand referencing no
+    binding. `userId` is a plain projection field — now emitted as
+    `userId: record.userId`, like every other copy-through field.
+  - Validation: a new compile-level gate
+    (`sink-swe-brain-layout.compile.test.ts`) runs the real emitter into a
+    swe-brain-shaped tree (`integrations/<surface>/sinks/` +
+    `modules/<plural>/<entity>.repository.ts`, no alias) and `tsc --noEmit`s the
+    emitted base — the prior §3b gate missed both (it stubbed the repo import
+    same-dir and used no `user_id` field). Found consuming 0.26.0 in swe-brain
+    (6 bases, 12 errors).
+
 ## [0.26.0] — 2026-06-07
 
 ### Added

package/dist/{chunk-LLDJS7PJ.js → chunk-IASPGFFK.js}

@@ -1,12 +1,12 @@
-import {
-  integrationSubscriptions
-} from "./chunk-HNWZFNKP.js";
 import {
   INTEGRATION_MULTI_TENANT
 } from "./chunk-S5G3HO7N.js";
 import {
   assertTenantId
 } from "./chunk-MZ6GV4YF.js";
+import {
+  integrationSubscriptions
+} from "./chunk-HNWZFNKP.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -97,4 +97,4 @@ PostgresCursorStore = __decorateClass([
 export {
   PostgresCursorStore
 };
-//# sourceMappingURL=chunk-LLDJS7PJ.js.map
+//# sourceMappingURL=chunk-IASPGFFK.js.map

package/dist/{chunk-N43D57AP.js → chunk-VCXOPBYY.js}

@@ -1,18 +1,12 @@
 import {
   DrizzleIntegrationRunRecorder
-} from "./chunk-VI2VNA6Y.js";
+} from "./chunk-W4JYZSQK.js";
 import {
   MemoryRunRecorder
 } from "./chunk-EO2QPOKH.js";
 import {
   PostgresCursorStore
-} from "./chunk-LLDJS7PJ.js";
-import {
-  MemoryCursorStore
-} from "./chunk-AHV4GDYM.js";
-import {
-  DeepEqualDiffer
-} from "./chunk-JEINYUJH.js";
+} from "./chunk-IASPGFFK.js";
 import {
   INTEGRATION_CURSOR_STORE,
   INTEGRATION_FIELD_DIFFER,
@@ -20,6 +14,12 @@ import {
   INTEGRATION_MULTI_TENANT,
   INTEGRATION_RUN_RECORDER
 } from "./chunk-S5G3HO7N.js";
+import {
+  MemoryCursorStore
+} from "./chunk-AHV4GDYM.js";
+import {
+  DeepEqualDiffer
+} from "./chunk-JEINYUJH.js";
 import {
   __decorateClass
 } from "./chunk-2E224ZSN.js";
@@ -84,4 +84,4 @@ IntegrationModule = __decorateClass([
 export {
   IntegrationModule
 };
-//# sourceMappingURL=chunk-N43D57AP.js.map
+//# sourceMappingURL=chunk-VCXOPBYY.js.map

package/dist/{chunk-6M6LZEP6.js → chunk-VDVEGTSW.js}

@@ -1,6 +1,9 @@
 import {
   TypedEventBus
 } from "./chunk-PBENHIN2.js";
+import {
+  MemoryEventBus
+} from "./chunk-GOO5ZMYO.js";
 import {
   EventScheduler,
   scheduledEventsFromRegistry
@@ -8,9 +11,6 @@ import {
 import {
   DrizzleEventBus
 } from "./chunk-PNCOUFFI.js";
-import {
-  MemoryEventBus
-} from "./chunk-GOO5ZMYO.js";
 import {
   EVENTS_MODULE_OPTIONS,
   EVENTS_MULTI_TENANT,
@@ -200,4 +200,4 @@ export {
   EventSchedulerLifecycle,
   EventsModule
 };
-//# sourceMappingURL=chunk-6M6LZEP6.js.map
+//# sourceMappingURL=chunk-VDVEGTSW.js.map

package/dist/{chunk-VI2VNA6Y.js → chunk-W4JYZSQK.js}

@@ -1,17 +1,17 @@
 import {
   FieldDiffSchema
 } from "./chunk-SQDOBLBP.js";
-import {
-  integrationRunItems,
-  integrationRuns,
-  integrationSubscriptions
-} from "./chunk-HNWZFNKP.js";
 import {
   INTEGRATION_MULTI_TENANT
 } from "./chunk-S5G3HO7N.js";
 import {
   assertTenantId
 } from "./chunk-MZ6GV4YF.js";
+import {
+  integrationRunItems,
+  integrationRuns,
+  integrationSubscriptions
+} from "./chunk-HNWZFNKP.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -127,4 +127,4 @@ DrizzleIntegrationRunRecorder = __decorateClass([
 export {
   DrizzleIntegrationRunRecorder
 };
-//# sourceMappingURL=chunk-VI2VNA6Y.js.map
+//# sourceMappingURL=chunk-W4JYZSQK.js.map

package/dist/runtime/base-classes/index.js

@@ -1,8 +1,3 @@
-import {
-  JunctionIntegrationRepository,
-  buildCompositeExternalId,
-  parseCompositeExternalId
-} from "../../chunk-2FTZLDBP.js";
 import {
   KnowledgeEntityRepository
 } from "../../chunk-NN7XZEGF.js";
@@ -18,9 +13,6 @@ import {
 import {
   WithAnalytics
 } from "../../chunk-IBGER4YK.js";
-import {
-  ActivityEntityService
-} from "../../chunk-SJGEBMJT.js";
 import {
   BaseFindByIdUseCase,
   BaseListUseCase
@@ -32,15 +24,10 @@ import {
   IntegratedEntityService
 } from "../../chunk-5AAA4LTE.js";
 import {
-  BaseService
-} from "../../chunk-BPYZCEHS.js";
-import {
-  buildChangeEvents,
-  buildLifecycleEvent,
-  diffSnapshots,
-  emitSafely,
-  entitySnapshot
-} from "../../chunk-DAHWN63L.js";
+  JunctionIntegrationRepository,
+  buildCompositeExternalId,
+  parseCompositeExternalId
+} from "../../chunk-2FTZLDBP.js";
 import {
   ActivityEntityRepository
 } from "../../chunk-MKWQKKK7.js";
@@ -56,6 +43,19 @@ import {
   withSuperuserScope,
   withUserScope
 } from "../../chunk-ZUKFQL6E.js";
+import {
+  ActivityEntityService
+} from "../../chunk-SJGEBMJT.js";
+import {
+  BaseService
+} from "../../chunk-BPYZCEHS.js";
+import {
+  buildChangeEvents,
+  buildLifecycleEvent,
+  diffSnapshots,
+  emitSafely,
+  entitySnapshot
+} from "../../chunk-DAHWN63L.js";
 import "../../chunk-2E224ZSN.js";
 export {
   ActivityEntityRepository,

package/dist/runtime/http/pagination.d.ts

@@ -0,0 +1,151 @@
+import { z } from 'zod';
+
+/**
+ * Pagination envelope + ListQuery contract for generated entity list endpoints
+ * (pagination-by-default).
+ *
+ * Every generated `GET /<entities>` returns a {@link Page} envelope instead of
+ * a bare `T[]`. The request shape is {@link ListQuery} (page/cursor/pageSize +
+ * default sort) merged with arbitrary where-filters at the controller.
+ *
+ * Mirrors the in-repo precedent: the jobs subsystem's `JobRunPage`
+ * (`{ items, nextCursor }`) and its opaque keyset cursor codec
+ * (`runtime/subsystems/jobs/job-run-keyset-cursor.ts`). The entity envelope
+ * EXTENDS that minimal shape with `page/pageCount/total/pageSize` so a numbered
+ * UI (jump-to-page) works while `nextCursor` stays contract-stable for the
+ * later keyset upgrade.
+ *
+ * ENGINE NOTE (v1): the list use-case fetches by OFFSET (page-based). The
+ * `nextCursor` is computed from the last row and emitted from day one so the
+ * contract never changes, but cursor-REQUEST honoring (keyset seek) is a
+ * DEFERRED seam — see the TODO in the generated list use-case / the repository
+ * query branch. `ListQuery.cursor` is ACCEPTED (no validation error) even
+ * though v1 ignores it for fetching.
+ */
+
+/** Default page size when `pageSize` is omitted. */
+declare const DEFAULT_PAGE_SIZE = 50;
+/** Hard upper bound on page size to keep a single read bounded. */
+declare const MAX_PAGE_SIZE = 200;
+/** Default page (1-based) when `page` is omitted. */
+declare const DEFAULT_PAGE = 1;
+/** Default sort column. */
+declare const DEFAULT_SORT_BY = "created_at";
+/** Default sort direction. */
+declare const DEFAULT_SORT_ORDER: "desc";
+/** Clamp a caller-supplied `pageSize` into `[1, MAX_PAGE_SIZE]`. */
+declare function clampPageSize(pageSize: number | undefined): number;
+/** Clamp a caller-supplied `page` to a 1-based integer (floor 1). */
+declare function clampPage(page: number | undefined): number;
+/**
+ * Zod schema for the universal list query string. All keys optional —
+ * pagination works fully UNFILTERED (the default mode). `pageSize` is clamped
+ * (default 50, max 200) and `sort_order` defaults to `desc`. Arbitrary where
+ * filters are NOT modeled here (they're parsed/passed through at the controller
+ * via `.passthrough()`); this schema owns ONLY the pagination + sort knobs so
+ * the defaults + clamp land in one place.
+ *
+ * `cursor` is accepted but v1 ignores it for fetching (offset engine) — the
+ * keyset seek is the deferred seam. Passing a `nextCursor` back never errors.
+ */
+declare const ListQuerySchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodString>;
+    sort_order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    page: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodString>;
+    sort_order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    page: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodString>;
+    sort_order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Parsed list query (pre-clamp). Use {@link resolveListQuery} to normalize. */
+type ListQuery = z.infer<typeof ListQuerySchema>;
+/**
+ * Normalized pagination options resolved from a raw {@link ListQuery}: clamped
+ * `page`/`pageSize`, computed `offset`, and a defaulted sort. The generated
+ * list use-case feeds these straight into `service.list({ limit, offset, ... })`.
+ */
+interface ResolvedListQuery {
+    page: number;
+    pageSize: number;
+    /** `(page - 1) * pageSize`. */
+    offset: number;
+    sortBy: string;
+    sortOrder: 'asc' | 'desc';
+    /** Opaque cursor as passed by the caller (v1: not honored — deferred seam). */
+    cursor?: string;
+}
+/**
+ * Resolve a raw list query into normalized, clamped pagination options.
+ * Defaults: page 1, pageSize 50 (max 200), sort `created_at desc`.
+ */
+declare function resolveListQuery(query: ListQuery | undefined): ResolvedListQuery;
+/**
+ * One page of a paginated list response. EXTENDS the jobs subsystem's minimal
+ * `{ items, nextCursor }` shape with the numbered-UI fields:
+ *
+ *   - `page`       — 1-based page number of THIS page.
+ *   - `pageCount`  — total number of pages (`ceil(total / pageSize)`, min 1).
+ *   - `total`      — total matching rows (reflects any where-filter).
+ *   - `pageSize`   — the (clamped) page size used.
+ *   - `nextCursor` — opaque keyset cursor of the LAST row, or `null` on the
+ *                    last page / empty result. Contract-stable from day one;
+ *                    v1 emits it but fetches by offset.
+ */
+interface Page<T> {
+    items: T[];
+    page: number;
+    pageCount: number;
+    total: number;
+    pageSize: number;
+    nextCursor: string | null;
+}
+/** Keyset tuple a {@link Page.nextCursor} encodes. */
+interface PageKeyset {
+    /** `created_at` of the last row on this page. */
+    createdAt: Date;
+    /** `id` (UUID) tie-break of the last row on this page. */
+    id: string;
+}
+/**
+ * Encode a `(createdAt, id)` keyset into an opaque, base64url cursor. The shape
+ * (a JSON tuple) is an implementation detail — never parse it outside this
+ * module. Mirrors `encodeKeysetCursor` in the jobs subsystem.
+ */
+declare function encodeCursor(keyset: PageKeyset): string;
+/**
+ * Decode an opaque cursor back into its `(createdAt, id)` keyset. Returns
+ * `null` for a malformed cursor so a caller can treat garbage as "start from
+ * the beginning" rather than throw on user-supplied data.
+ */
+declare function decodeCursor(cursor: string): PageKeyset | null;
+/**
+ * Compute the `nextCursor` for a page of rows: the opaque cursor of the LAST
+ * row when more pages remain, else `null`. A row is expected to carry
+ * `createdAt: Date` and `id: string` (the default-sort keyset). Rows missing
+ * either field yield `null` (cursor not derivable — caller falls back to offset
+ * paging, which is the v1 engine anyway).
+ *
+ * @param rows      the items on this page (already fetched, in sort order)
+ * @param hasMore   whether more rows exist beyond this page
+ *                  (`offset + rows.length < total`)
+ */
+declare function computeNextCursor(rows: ReadonlyArray<unknown>, hasMore: boolean): string | null;
+/**
+ * Assemble a {@link Page} envelope from a fetched page of rows + the total
+ * matching count + the resolved query. Computes `pageCount` and `nextCursor`.
+ * The single place the envelope shape is constructed, so the generated list
+ * use-case stays a thin call.
+ */
+declare function buildPage<T>(items: T[], total: number, resolved: Pick<ResolvedListQuery, 'page' | 'pageSize' | 'offset'>): Page<T>;
+
+export { DEFAULT_PAGE, DEFAULT_PAGE_SIZE, DEFAULT_SORT_BY, DEFAULT_SORT_ORDER, type ListQuery, ListQuerySchema, MAX_PAGE_SIZE, type Page, type PageKeyset, type ResolvedListQuery, buildPage, clampPage, clampPageSize, computeNextCursor, decodeCursor, encodeCursor, resolveListQuery };

package/dist/runtime/http/pagination.js

@@ -0,0 +1,98 @@
+import "../../chunk-2E224ZSN.js";
+
+// runtime/http/pagination.ts
+import { z } from "zod";
+var DEFAULT_PAGE_SIZE = 50;
+var MAX_PAGE_SIZE = 200;
+var DEFAULT_PAGE = 1;
+var DEFAULT_SORT_BY = "created_at";
+var DEFAULT_SORT_ORDER = "desc";
+function clampPageSize(pageSize) {
+  if (typeof pageSize !== "number" || !Number.isFinite(pageSize)) {
+    return DEFAULT_PAGE_SIZE;
+  }
+  const floored = Math.floor(pageSize);
+  if (floored < 1) return 1;
+  if (floored > MAX_PAGE_SIZE) return MAX_PAGE_SIZE;
+  return floored;
+}
+function clampPage(page) {
+  if (typeof page !== "number" || !Number.isFinite(page)) {
+    return DEFAULT_PAGE;
+  }
+  const floored = Math.floor(page);
+  return floored < 1 ? 1 : floored;
+}
+var ListQuerySchema = z.object({
+  page: z.coerce.number().int().optional(),
+  cursor: z.string().optional(),
+  pageSize: z.coerce.number().int().optional(),
+  sort_by: z.string().optional(),
+  sort_order: z.enum(["asc", "desc"]).optional()
+}).passthrough();
+function resolveListQuery(query) {
+  const page = clampPage(query?.page);
+  const pageSize = clampPageSize(query?.pageSize);
+  return {
+    page,
+    pageSize,
+    offset: (page - 1) * pageSize,
+    sortBy: query?.sort_by ?? DEFAULT_SORT_BY,
+    sortOrder: query?.sort_order ?? DEFAULT_SORT_ORDER,
+    cursor: query?.cursor
+  };
+}
+function encodeCursor(keyset) {
+  const tuple = [keyset.createdAt.toISOString(), keyset.id];
+  return Buffer.from(JSON.stringify(tuple), "utf8").toString("base64url");
+}
+function decodeCursor(cursor) {
+  try {
+    const json = Buffer.from(cursor, "base64url").toString("utf8");
+    const parsed = JSON.parse(json);
+    if (!Array.isArray(parsed) || parsed.length !== 2) return null;
+    const [iso, id] = parsed;
+    if (typeof iso !== "string" || typeof id !== "string") return null;
+    const createdAt = new Date(iso);
+    if (Number.isNaN(createdAt.getTime())) return null;
+    return { createdAt, id };
+  } catch {
+    return null;
+  }
+}
+function computeNextCursor(rows, hasMore) {
+  if (!hasMore || rows.length === 0) return null;
+  const last = rows[rows.length - 1];
+  const createdAt = last?.createdAt;
+  const id = last?.id;
+  if (!(createdAt instanceof Date) || typeof id !== "string") return null;
+  return encodeCursor({ createdAt, id });
+}
+function buildPage(items, total, resolved) {
+  const pageCount = total === 0 ? 1 : Math.ceil(total / resolved.pageSize);
+  const hasMore = resolved.offset + items.length < total;
+  return {
+    items,
+    page: resolved.page,
+    pageCount,
+    total,
+    pageSize: resolved.pageSize,
+    nextCursor: computeNextCursor(items, hasMore)
+  };
+}
+export {
+  DEFAULT_PAGE,
+  DEFAULT_PAGE_SIZE,
+  DEFAULT_SORT_BY,
+  DEFAULT_SORT_ORDER,
+  ListQuerySchema,
+  MAX_PAGE_SIZE,
+  buildPage,
+  clampPage,
+  clampPageSize,
+  computeNextCursor,
+  decodeCursor,
+  encodeCursor,
+  resolveListQuery
+};
+//# sourceMappingURL=pagination.js.map

package/dist/runtime/http/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../runtime/http/pagination.ts"],"sourcesContent":["/**\n * Pagination envelope + ListQuery contract for generated entity list endpoints\n * (pagination-by-default).\n *\n * Every generated `GET /<entities>` returns a {@link Page} envelope instead of\n * a bare `T[]`. The request shape is {@link ListQuery} (page/cursor/pageSize +\n * default sort) merged with arbitrary where-filters at the controller.\n *\n * Mirrors the in-repo precedent: the jobs subsystem's `JobRunPage`\n * (`{ items, nextCursor }`) and its opaque keyset cursor codec\n * (`runtime/subsystems/jobs/job-run-keyset-cursor.ts`). The entity envelope\n * EXTENDS that minimal shape with `page/pageCount/total/pageSize` so a numbered\n * UI (jump-to-page) works while `nextCursor` stays contract-stable for the\n * later keyset upgrade.\n *\n * ENGINE NOTE (v1): the list use-case fetches by OFFSET (page-based). The\n * `nextCursor` is computed from the last row and emitted from day one so the\n * contract never changes, but cursor-REQUEST honoring (keyset seek) is a\n * DEFERRED seam — see the TODO in the generated list use-case / the repository\n * query branch. `ListQuery.cursor` is ACCEPTED (no validation error) even\n * though v1 ignores it for fetching.\n */\n\nimport { z } from 'zod';\n\n// ============================================================================\n// Defaults + clamp\n// ============================================================================\n\n/** Default page size when `pageSize` is omitted. */\nexport const DEFAULT_PAGE_SIZE = 50;\n/** Hard upper bound on page size to keep a single read bounded. */\nexport const MAX_PAGE_SIZE = 200;\n/** Default page (1-based) when `page` is omitted. */\nexport const DEFAULT_PAGE = 1;\n/** Default sort column. */\nexport const DEFAULT_SORT_BY = 'created_at';\n/** Default sort direction. */\nexport const DEFAULT_SORT_ORDER = 'desc' as const;\n\n/** Clamp a caller-supplied `pageSize` into `[1, MAX_PAGE_SIZE]`. */\nexport function clampPageSize(pageSize: number | undefined): number {\n  if (typeof pageSize !== 'number' || !Number.isFinite(pageSize)) {\n    return DEFAULT_PAGE_SIZE;\n  }\n  const floored = Math.floor(pageSize);\n  if (floored < 1) return 1;\n  if (floored > MAX_PAGE_SIZE) return MAX_PAGE_SIZE;\n  return floored;\n}\n\n/** Clamp a caller-supplied `page` to a 1-based integer (floor 1). */\nexport function clampPage(page: number | undefined): number {\n  if (typeof page !== 'number' || !Number.isFinite(page)) {\n    return DEFAULT_PAGE;\n  }\n  const floored = Math.floor(page);\n  return floored < 1 ? 1 : floored;\n}\n\n// ============================================================================\n// ListQuery schema (request)\n// ============================================================================\n\n/**\n * Zod schema for the universal list query string. All keys optional —\n * pagination works fully UNFILTERED (the default mode). `pageSize` is clamped\n * (default 50, max 200) and `sort_order` defaults to `desc`. Arbitrary where\n * filters are NOT modeled here (they're parsed/passed through at the controller\n * via `.passthrough()`); this schema owns ONLY the pagination + sort knobs so\n * the defaults + clamp land in one place.\n *\n * `cursor` is accepted but v1 ignores it for fetching (offset engine) — the\n * keyset seek is the deferred seam. Passing a `nextCursor` back never errors.\n */\nexport const ListQuerySchema = z\n  .object({\n    page: z.coerce.number().int().optional(),\n    cursor: z.string().optional(),\n    pageSize: z.coerce.number().int().optional(),\n    sort_by: z.string().optional(),\n    sort_order: z.enum(['asc', 'desc']).optional(),\n  })\n  .passthrough();\n\n/** Parsed list query (pre-clamp). Use {@link resolveListQuery} to normalize. */\nexport type ListQuery = z.infer<typeof ListQuerySchema>;\n\n/**\n * Normalized pagination options resolved from a raw {@link ListQuery}: clamped\n * `page`/`pageSize`, computed `offset`, and a defaulted sort. The generated\n * list use-case feeds these straight into `service.list({ limit, offset, ... })`.\n */\nexport interface ResolvedListQuery {\n  page: number;\n  pageSize: number;\n  /** `(page - 1) * pageSize`. */\n  offset: number;\n  sortBy: string;\n  sortOrder: 'asc' | 'desc';\n  /** Opaque cursor as passed by the caller (v1: not honored — deferred seam). */\n  cursor?: string;\n}\n\n/**\n * Resolve a raw list query into normalized, clamped pagination options.\n * Defaults: page 1, pageSize 50 (max 200), sort `created_at desc`.\n */\nexport function resolveListQuery(query: ListQuery | undefined): ResolvedListQuery {\n  const page = clampPage(query?.page);\n  const pageSize = clampPageSize(query?.pageSize);\n  return {\n    page,\n    pageSize,\n    offset: (page - 1) * pageSize,\n    sortBy: query?.sort_by ?? DEFAULT_SORT_BY,\n    sortOrder: query?.sort_order ?? DEFAULT_SORT_ORDER,\n    cursor: query?.cursor,\n  };\n}\n\n// ============================================================================\n// Page envelope (response)\n// ============================================================================\n\n/**\n * One page of a paginated list response. EXTENDS the jobs subsystem's minimal\n * `{ items, nextCursor }` shape with the numbered-UI fields:\n *\n *   - `page`       — 1-based page number of THIS page.\n *   - `pageCount`  — total number of pages (`ceil(total / pageSize)`, min 1).\n *   - `total`      — total matching rows (reflects any where-filter).\n *   - `pageSize`   — the (clamped) page size used.\n *   - `nextCursor` — opaque keyset cursor of the LAST row, or `null` on the\n *                    last page / empty result. Contract-stable from day one;\n *                    v1 emits it but fetches by offset.\n */\nexport interface Page<T> {\n  items: T[];\n  page: number;\n  pageCount: number;\n  total: number;\n  pageSize: number;\n  nextCursor: string | null;\n}\n\n// ============================================================================\n// Opaque cursor codec (encodes (createdAt, id))\n// ============================================================================\n\n/** Keyset tuple a {@link Page.nextCursor} encodes. */\nexport interface PageKeyset {\n  /** `created_at` of the last row on this page. */\n  createdAt: Date;\n  /** `id` (UUID) tie-break of the last row on this page. */\n  id: string;\n}\n\n/**\n * Encode a `(createdAt, id)` keyset into an opaque, base64url cursor. The shape\n * (a JSON tuple) is an implementation detail — never parse it outside this\n * module. Mirrors `encodeKeysetCursor` in the jobs subsystem.\n */\nexport function encodeCursor(keyset: PageKeyset): string {\n  const tuple = [keyset.createdAt.toISOString(), keyset.id];\n  return Buffer.from(JSON.stringify(tuple), 'utf8').toString('base64url');\n}\n\n/**\n * Decode an opaque cursor back into its `(createdAt, id)` keyset. Returns\n * `null` for a malformed cursor so a caller can treat garbage as \"start from\n * the beginning\" rather than throw on user-supplied data.\n */\nexport function decodeCursor(cursor: string): PageKeyset | null {\n  try {\n    const json = Buffer.from(cursor, 'base64url').toString('utf8');\n    const parsed = JSON.parse(json) as unknown;\n    if (!Array.isArray(parsed) || parsed.length !== 2) return null;\n    const [iso, id] = parsed;\n    if (typeof iso !== 'string' || typeof id !== 'string') return null;\n    const createdAt = new Date(iso);\n    if (Number.isNaN(createdAt.getTime())) return null;\n    return { createdAt, id };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Compute the `nextCursor` for a page of rows: the opaque cursor of the LAST\n * row when more pages remain, else `null`. A row is expected to carry\n * `createdAt: Date` and `id: string` (the default-sort keyset). Rows missing\n * either field yield `null` (cursor not derivable — caller falls back to offset\n * paging, which is the v1 engine anyway).\n *\n * @param rows      the items on this page (already fetched, in sort order)\n * @param hasMore   whether more rows exist beyond this page\n *                  (`offset + rows.length < total`)\n */\nexport function computeNextCursor(\n  rows: ReadonlyArray<unknown>,\n  hasMore: boolean,\n): string | null {\n  if (!hasMore || rows.length === 0) return null;\n  const last = rows[rows.length - 1] as { createdAt?: unknown; id?: unknown };\n  const createdAt = last?.createdAt;\n  const id = last?.id;\n  if (!(createdAt instanceof Date) || typeof id !== 'string') return null;\n  return encodeCursor({ createdAt, id });\n}\n\n/**\n * Assemble a {@link Page} envelope from a fetched page of rows + the total\n * matching count + the resolved query. Computes `pageCount` and `nextCursor`.\n * The single place the envelope shape is constructed, so the generated list\n * use-case stays a thin call.\n */\nexport function buildPage<T>(\n  items: T[],\n  total: number,\n  resolved: Pick<ResolvedListQuery, 'page' | 'pageSize' | 'offset'>,\n): Page<T> {\n  const pageCount = total === 0 ? 1 : Math.ceil(total / resolved.pageSize);\n  const hasMore = resolved.offset + items.length < total;\n  return {\n    items,\n    page: resolved.page,\n    pageCount,\n    total,\n    pageSize: resolved.pageSize,\n    nextCursor: computeNextCursor(items as ReadonlyArray<unknown>, hasMore),\n  };\n}\n"],"mappings":";;;AAuBA,SAAS,SAAS;AAOX,IAAM,oBAAoB;AAE1B,IAAM,gBAAgB;AAEtB,IAAM,eAAe;AAErB,IAAM,kBAAkB;AAExB,IAAM,qBAAqB;AAG3B,SAAS,cAAc,UAAsC;AAClE,MAAI,OAAO,aAAa,YAAY,CAAC,OAAO,SAAS,QAAQ,GAAG;AAC9D,WAAO;AAAA,EACT;AACA,QAAM,UAAU,KAAK,MAAM,QAAQ;AACnC,MAAI,UAAU,EAAG,QAAO;AACxB,MAAI,UAAU,cAAe,QAAO;AACpC,SAAO;AACT;AAGO,SAAS,UAAU,MAAkC;AAC1D,MAAI,OAAO,SAAS,YAAY,CAAC,OAAO,SAAS,IAAI,GAAG;AACtD,WAAO;AAAA,EACT;AACA,QAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,SAAO,UAAU,IAAI,IAAI;AAC3B;AAiBO,IAAM,kBAAkB,EAC5B,OAAO;AAAA,EACN,MAAM,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACvC,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,UAAU,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EAC3C,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,YAAY,EAAE,KAAK,CAAC,OAAO,MAAM,CAAC,EAAE,SAAS;AAC/C,CAAC,EACA,YAAY;AAyBR,SAAS,iBAAiB,OAAiD;AAChF,QAAM,OAAO,UAAU,OAAO,IAAI;AAClC,QAAM,WAAW,cAAc,OAAO,QAAQ;AAC9C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,SAAS,OAAO,KAAK;AAAA,IACrB,QAAQ,OAAO,WAAW;AAAA,IAC1B,WAAW,OAAO,cAAc;AAAA,IAChC,QAAQ,OAAO;AAAA,EACjB;AACF;AA4CO,SAAS,aAAa,QAA4B;AACvD,QAAM,QAAQ,CAAC,OAAO,UAAU,YAAY,GAAG,OAAO,EAAE;AACxD,SAAO,OAAO,KAAK,KAAK,UAAU,KAAK,GAAG,MAAM,EAAE,SAAS,WAAW;AACxE;AAOO,SAAS,aAAa,QAAmC;AAC9D,MAAI;AACF,UAAM,OAAO,OAAO,KAAK,QAAQ,WAAW,EAAE,SAAS,MAAM;AAC7D,UAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,QAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,EAAG,QAAO;AAC1D,UAAM,CAAC,KAAK,EAAE,IAAI;AAClB,QAAI,OAAO,QAAQ,YAAY,OAAO,OAAO,SAAU,QAAO;AAC9D,UAAM,YAAY,IAAI,KAAK,GAAG;AAC9B,QAAI,OAAO,MAAM,UAAU,QAAQ,CAAC,EAAG,QAAO;AAC9C,WAAO,EAAE,WAAW,GAAG;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAaO,SAAS,kBACd,MACA,SACe;AACf,MAAI,CAAC,WAAW,KAAK,WAAW,EAAG,QAAO;AAC1C,QAAM,OAAO,KAAK,KAAK,SAAS,CAAC;AACjC,QAAM,YAAY,MAAM;AACxB,QAAM,KAAK,MAAM;AACjB,MAAI,EAAE,qBAAqB,SAAS,OAAO,OAAO,SAAU,QAAO;AACnE,SAAO,aAAa,EAAE,WAAW,GAAG,CAAC;AACvC;AAQO,SAAS,UACd,OACA,OACA,UACS;AACT,QAAM,YAAY,UAAU,IAAI,IAAI,KAAK,KAAK,QAAQ,SAAS,QAAQ;AACvE,QAAM,UAAU,SAAS,SAAS,MAAM,SAAS;AACjD,SAAO;AAAA,IACL;AAAA,IACA,MAAM,SAAS;AAAA,IACf;AAAA,IACA;AAAA,IACA,UAAU,SAAS;AAAA,IACnB,YAAY,kBAAkB,OAAiC,OAAO;AAAA,EACxE;AACF;","names":[]}

package/dist/runtime/subsystems/auth/auth.module.js

@@ -6,8 +6,8 @@ import "../../../chunk-N5OTOWTP.js";
 import "../../../chunk-QLTJSCE6.js";
 import "../../../chunk-BPARRK6F.js";
 import "../../../chunk-SZVPIHWE.js";
-import "../../../chunk-NPFPZ2HO.js";
 import "../../../chunk-6XY6ZMMD.js";
+import "../../../chunk-NPFPZ2HO.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/auth/index.js

@@ -1,13 +1,13 @@
 import "../../../chunk-7C3FOSDI.js";
+import {
+  withAuthRetry
+} from "../../../chunk-WL67FZGF.js";
 import {
   OAuth2RefreshStrategy
 } from "../../../chunk-M6QLSLPO.js";
 import {
   ConnectionBrokenError
 } from "../../../chunk-2N4UG4VD.js";
-import {
-  withAuthRetry
-} from "../../../chunk-WL67FZGF.js";
 import {
   SessionExpiredError,
   isSessionExpiredError
@@ -35,9 +35,6 @@ import {
 import {
   AuthController
 } from "../../../chunk-SZVPIHWE.js";
-import {
-  authOAuthState
-} from "../../../chunk-NPFPZ2HO.js";
 import {
   AUTH_CONNECTION_GRANT_SINK,
   AUTH_CONNECTION_READER,
@@ -48,6 +45,9 @@ import {
   OAUTH_STATE_STORE,
   STRATEGY_REGISTRY
 } from "../../../chunk-6XY6ZMMD.js";
+import {
+  authOAuthState
+} from "../../../chunk-NPFPZ2HO.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-ZUKFQL6E.js";

package/dist/runtime/subsystems/cache/cache.module.js

@@ -2,8 +2,8 @@ import {
   CacheModule
 } from "../../../chunk-COGHTKXY.js";
 import "../../../chunk-T6C4LFLC.js";
-import "../../../chunk-FASRXRX5.js";
 import "../../../chunk-IF5I3DAA.js";
+import "../../../chunk-FASRXRX5.js";
 import "../../../chunk-L6FTY45T.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";

package/dist/runtime/subsystems/cache/index.js

@@ -5,12 +5,12 @@ import {
 import {
   DrizzleCacheService
 } from "../../../chunk-T6C4LFLC.js";
-import {
-  cacheEntries
-} from "../../../chunk-FASRXRX5.js";
 import {
   MemoryCacheService
 } from "../../../chunk-IF5I3DAA.js";
+import {
+  cacheEntries
+} from "../../../chunk-FASRXRX5.js";
 import {
   CACHE,
   CACHE_DEFAULT_TTL

package/dist/runtime/subsystems/events/events.module.js

@@ -1,14 +1,14 @@
 import {
   EventSchedulerLifecycle,
   EventsModule
-} from "../../../chunk-6M6LZEP6.js";
+} from "../../../chunk-VDVEGTSW.js";
 import "../../../chunk-PBENHIN2.js";
 import "../../../chunk-LQZESSM3.js";
 import "../../../chunk-MU54DZCC.js";
+import "../../../chunk-GOO5ZMYO.js";
 import "../../../chunk-DUUCU77W.js";
 import "../../../chunk-DUBZOXJC.js";
 import "../../../chunk-PNCOUFFI.js";
-import "../../../chunk-GOO5ZMYO.js";
 import "../../../chunk-UQ5EHOH2.js";
 import "../../../chunk-Q6LRJ4VI.js";
 import "../../../chunk-H5NH7KPE.js";

package/dist/runtime/subsystems/events/index.js

@@ -2,12 +2,15 @@ import "../../../chunk-SYVZ4MD2.js";
 import {
   EventSchedulerLifecycle,
   EventsModule
-} from "../../../chunk-6M6LZEP6.js";
+} from "../../../chunk-VDVEGTSW.js";
 import {
   TypedEventBus
 } from "../../../chunk-PBENHIN2.js";
 import "../../../chunk-LQZESSM3.js";
 import "../../../chunk-MU54DZCC.js";
+import {
+  MemoryEventBus
+} from "../../../chunk-GOO5ZMYO.js";
 import {
   EventScheduler,
   SCHEDULE_FLOOR_MS,
@@ -26,9 +29,6 @@ import {
 import {
   DrizzleEventBus
 } from "../../../chunk-PNCOUFFI.js";
-import {
-  MemoryEventBus
-} from "../../../chunk-GOO5ZMYO.js";
 import "../../../chunk-UQ5EHOH2.js";
 import "../../../chunk-Q6LRJ4VI.js";
 import {