@columnus/shared 0.1.47

package/dist/inferIdentifier.d.ts

@@ -0,0 +1,18 @@
+/** Whether `name` is a valid manifest table/field identifier. */
+export declare function isValidIdentifier(name: string): boolean;
+/**
+ * Infer a camelCase identifier from human display text.
+ * Does not pluralize/singularize — splits on non-alphanumeric runs only.
+ */
+export declare function inferIdentifier(displayName: string): string;
+/** True when `name` appears in `siblings` (exact match). */
+export declare function hasIdentifierCollision(name: string, siblings: Iterable<string>): boolean;
+/**
+ * Return `base` or `base2`, `base3`, … when `base` is already taken.
+ * Empty `base` is returned unchanged.
+ */
+export declare function uniqueIdentifier(base: string, reservedNames?: Iterable<string>): string;
+/** Infer an identifier from display text, bumping with a numeric suffix when taken. */
+export declare function inferUniqueIdentifier(displayName: string, reservedNames?: Iterable<string>): string;
+/** First duplicate identifier in a list, if any. */
+export declare function findDuplicateIdentifier(names: readonly string[]): string | null;

package/dist/inferIdentifier.js

@@ -0,0 +1,49 @@
+// packages/@columnus/shared/src/inferIdentifier.ts
+var IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function isValidIdentifier(name) {
+  return IDENT.test(name);
+}
+function inferIdentifier(displayName) {
+  const segments = displayName.trim().split(/[^A-Za-z0-9]+/).filter(Boolean);
+  if (segments.length === 0) return "";
+  const parts = segments.map((segment, index) => {
+    if (index === 0) return segment.toLowerCase();
+    return segment.charAt(0).toUpperCase() + segment.slice(1).toLowerCase();
+  });
+  let result = parts.join("").replace(/[^A-Za-z0-9_]/g, "");
+  if (!result) return "";
+  if (/^[0-9]/.test(result)) result = `n${result}`;
+  if (!IDENT.test(result)) return "";
+  return result;
+}
+function hasIdentifierCollision(name, siblings) {
+  for (const sibling of siblings) {
+    if (sibling === name) return true;
+  }
+  return false;
+}
+function uniqueIdentifier(base, reservedNames = []) {
+  if (!base) return base;
+  const used = new Set(reservedNames);
+  if (!used.has(base)) return base;
+  let n = 2;
+  while (used.has(`${base}${n}`)) n++;
+  return `${base}${n}`;
+}
+function inferUniqueIdentifier(displayName, reservedNames = []) {
+  const base = inferIdentifier(displayName);
+  if (!base) return "";
+  return uniqueIdentifier(base, reservedNames);
+}
+function findDuplicateIdentifier(names) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const name of names) {
+    if (seen.has(name)) return name;
+    seen.add(name);
+  }
+  return null;
+}
+
+export { findDuplicateIdentifier, hasIdentifierCollision, inferIdentifier, inferUniqueIdentifier, isValidIdentifier, uniqueIdentifier };
+//# sourceMappingURL=inferIdentifier.js.map
+//# sourceMappingURL=inferIdentifier.js.map

package/dist/inferIdentifier.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/inferIdentifier.ts"],"names":[],"mappings":";AAAA,IAAM,KAAA,GAAQ,0BAAA;AAGP,SAAS,kBAAkB,IAAA,EAAuB;AACvD,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;AAMO,SAAS,gBAAgB,WAAA,EAA6B;AAC3D,EAAA,MAAM,QAAA,GAAW,YACd,IAAA,EAAK,CACL,MAAM,eAAe,CAAA,CACrB,OAAO,OAAO,CAAA;AACjB,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAElC,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,GAAA,CAAI,CAAC,SAAS,KAAA,KAAU;AAC7C,IAAA,IAAI,KAAA,KAAU,CAAA,EAAG,OAAO,OAAA,CAAQ,WAAA,EAAY;AAC5C,IAAA,OAAO,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,CAAE,WAAA,KAAgB,OAAA,CAAQ,KAAA,CAAM,CAAC,CAAA,CAAE,WAAA,EAAY;AAAA,EACxE,CAAC,CAAA;AAED,EAAA,IAAI,SAAS,KAAA,CAAM,IAAA,CAAK,EAAE,CAAA,CAAE,OAAA,CAAQ,kBAAkB,EAAE,CAAA;AACxD,EAAA,IAAI,CAAC,QAAQ,OAAO,EAAA;AACpB,EAAA,IAAI,SAAS,IAAA,CAAK,MAAM,CAAA,EAAG,MAAA,GAAS,IAAI,MAAM,CAAA,CAAA;AAC9C,EAAA,IAAI,CAAC,KAAA,CAAM,IAAA,CAAK,MAAM,GAAG,OAAO,EAAA;AAChC,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,sBAAA,CAAuB,MAAc,QAAA,EAAqC;AACxF,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,IAAI,OAAA,KAAY,MAAM,OAAO,IAAA;AAAA,EAC/B;AACA,EAAA,OAAO,KAAA;AACT;AAMO,SAAS,gBAAA,CAAiB,IAAA,EAAc,aAAA,GAAkC,EAAC,EAAW;AAC3F,EAAA,IAAI,CAAC,MAAM,OAAO,IAAA;AAClB,EAAA,MAAM,IAAA,GAAO,IAAI,GAAA,CAAI,aAAa,CAAA;AAClC,EAAA,IAAI,CAAC,IAAA,CAAK,GAAA,CAAI,IAAI,GAAG,OAAO,IAAA;AAC5B,EAAA,IAAI,CAAA,GAAI,CAAA;AACR,EAAA,OAAO,KAAK,GAAA,CAAI,CAAA,EAAG,IAAI,CAAA,EAAG,CAAC,EAAE,CAAA,EAAG,CAAA,EAAA;AAChC,EAAA,OAAO,CAAA,EAAG,IAAI,CAAA,EAAG,CAAC,CAAA,CAAA;AACpB;AAGO,SAAS,qBAAA,CACd,WAAA,EACA,aAAA,GAAkC,EAAC,EAC3B;AACR,EAAA,MAAM,IAAA,GAAO,gBAAgB,WAAW,CAAA;AACxC,EAAA,IAAI,CAAC,MAAM,OAAO,EAAA;AAClB,EAAA,OAAO,gBAAA,CAAiB,MAAM,aAAa,CAAA;AAC7C;AAGO,SAAS,wBAAwB,KAAA,EAAyC;AAC/E,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA,EAAG,OAAO,IAAA;AAC3B,IAAA,IAAA,CAAK,IAAI,IAAI,CAAA;AAAA,EACf;AACA,EAAA,OAAO,IAAA;AACT","file":"inferIdentifier.js","sourcesContent":["const IDENT = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Whether `name` is a valid manifest table/field identifier. */\nexport function isValidIdentifier(name: string): boolean {\n  return IDENT.test(name);\n}\n\n/**\n * Infer a camelCase identifier from human display text.\n * Does not pluralize/singularize — splits on non-alphanumeric runs only.\n */\nexport function inferIdentifier(displayName: string): string {\n  const segments = displayName\n    .trim()\n    .split(/[^A-Za-z0-9]+/)\n    .filter(Boolean);\n  if (segments.length === 0) return \"\";\n\n  const parts = segments.map((segment, index) => {\n    if (index === 0) return segment.toLowerCase();\n    return segment.charAt(0).toUpperCase() + segment.slice(1).toLowerCase();\n  });\n\n  let result = parts.join(\"\").replace(/[^A-Za-z0-9_]/g, \"\");\n  if (!result) return \"\";\n  if (/^[0-9]/.test(result)) result = `n${result}`;\n  if (!IDENT.test(result)) return \"\";\n  return result;\n}\n\n/** True when `name` appears in `siblings` (exact match). */\nexport function hasIdentifierCollision(name: string, siblings: Iterable<string>): boolean {\n  for (const sibling of siblings) {\n    if (sibling === name) return true;\n  }\n  return false;\n}\n\n/**\n * Return `base` or `base2`, `base3`, … when `base` is already taken.\n * Empty `base` is returned unchanged.\n */\nexport function uniqueIdentifier(base: string, reservedNames: Iterable<string> = []): string {\n  if (!base) return base;\n  const used = new Set(reservedNames);\n  if (!used.has(base)) return base;\n  let n = 2;\n  while (used.has(`${base}${n}`)) n++;\n  return `${base}${n}`;\n}\n\n/** Infer an identifier from display text, bumping with a numeric suffix when taken. */\nexport function inferUniqueIdentifier(\n  displayName: string,\n  reservedNames: Iterable<string> = [],\n): string {\n  const base = inferIdentifier(displayName);\n  if (!base) return \"\";\n  return uniqueIdentifier(base, reservedNames);\n}\n\n/** First duplicate identifier in a list, if any. */\nexport function findDuplicateIdentifier(names: readonly string[]): string | null {\n  const seen = new Set<string>();\n  for (const name of names) {\n    if (seen.has(name)) return name;\n    seen.add(name);\n  }\n  return null;\n}\n"]}

package/dist/keyboard.d.ts

@@ -0,0 +1,16 @@
+export type UndoRedoKind = "undo" | "redo" | null;
+export declare function modKeyLabel(): string;
+/** e.g. "⌘S" on Mac, "Ctrl+S" elsewhere */
+export declare function formatModShortcut(key: string, shift?: boolean): string;
+export declare function matchModShortcut(e: KeyboardEvent, key: string): boolean;
+export declare function matchModShiftShortcut(e: KeyboardEvent, key: string): boolean;
+export declare function matchModEnter(e: KeyboardEvent): boolean;
+export declare function matchEscape(e: KeyboardEvent): boolean;
+export declare function formatModEnterShortcut(): string;
+export declare function formatEscapeShortcut(): string;
+export declare function matchSave(e: KeyboardEvent): boolean;
+export declare function matchToggleEditMode(e: KeyboardEvent): boolean;
+export declare function matchUndoRedo(e: KeyboardEvent): UndoRedoKind;
+export declare function isTypingInEditor(): boolean;
+/** True when a Radix popover/select layer is open — Escape should close it first. */
+export declare function isRadixOverlayOpen(): boolean;

package/dist/keyboard.js

@@ -0,0 +1,71 @@
+// packages/@columnus/shared/src/keyboard.ts
+function modKeyLabel() {
+  return /Mac|iPhone|iPad|iPod/.test(navigator.platform) ? "\u2318" : "Ctrl";
+}
+function formatModShortcut(key, shift = false) {
+  const mod = modKeyLabel();
+  const k = shift ? `Shift+${key.toUpperCase()}` : key.toUpperCase();
+  return mod === "\u2318" ? `${mod}${shift ? "\u21E7" : ""}${key.toUpperCase()}` : `${mod}+${k}`;
+}
+function matchModShortcut(e, key) {
+  if (!(e.metaKey || e.ctrlKey) || e.altKey) return false;
+  return e.key.toLowerCase() === key.toLowerCase();
+}
+function matchModShiftShortcut(e, key) {
+  if (!(e.metaKey || e.ctrlKey) || e.altKey || !e.shiftKey) return false;
+  return e.key.toLowerCase() === key.toLowerCase();
+}
+function matchModEnter(e) {
+  if (!(e.metaKey || e.ctrlKey) || e.altKey || e.shiftKey) return false;
+  return e.key === "Enter";
+}
+function matchEscape(e) {
+  return e.key === "Escape" && !e.metaKey && !e.ctrlKey && !e.altKey && !e.shiftKey;
+}
+function formatModEnterShortcut() {
+  const mod = modKeyLabel();
+  return mod === "\u2318" ? "\u2318\u21B5" : "Ctrl+Enter";
+}
+function formatEscapeShortcut() {
+  return "Esc";
+}
+function matchSave(e) {
+  return matchModShortcut(e, "s");
+}
+function matchToggleEditMode(e) {
+  return matchModShortcut(e, "e");
+}
+function matchUndoRedo(e) {
+  if (!(e.metaKey || e.ctrlKey)) return null;
+  const key = e.key.toLowerCase();
+  if (key === "z" && !e.shiftKey) return "undo";
+  if (key === "z" && e.shiftKey || key === "y") return "redo";
+  return null;
+}
+function isIdPickerPassThrough(el) {
+  if (el.tagName !== "INPUT") return false;
+  const input = el;
+  if (!input.hasAttribute("data-id-picker-input")) return false;
+  return input.getAttribute("aria-expanded") !== "true";
+}
+function isTypingInEditor() {
+  const ae = document.activeElement;
+  if (!ae) return false;
+  if (ae.closest(
+    ".monaco-editor, .native-edit-context, [data-markdown-editor], [data-rich-text-editor]"
+  )) {
+    return true;
+  }
+  if (isIdPickerPassThrough(ae)) return false;
+  const tag = ae.tagName;
+  return tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT" || ae.isContentEditable;
+}
+function isRadixOverlayOpen() {
+  const ae = document.activeElement;
+  if (ae?.getAttribute("aria-expanded") === "true") return true;
+  return Boolean(ae?.closest("[data-radix-popper-content-wrapper]"));
+}
+
+export { formatEscapeShortcut, formatModEnterShortcut, formatModShortcut, isRadixOverlayOpen, isTypingInEditor, matchEscape, matchModEnter, matchModShiftShortcut, matchModShortcut, matchSave, matchToggleEditMode, matchUndoRedo, modKeyLabel };
+//# sourceMappingURL=keyboard.js.map
+//# sourceMappingURL=keyboard.js.map

package/dist/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/keyboard.ts"],"names":[],"mappings":"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","file":"keyboard.js","sourcesContent":["/// <reference lib=\"dom\" />\n\nexport type UndoRedoKind = \"undo\" | \"redo\" | null;\n\nexport function modKeyLabel(): string {\n  return /Mac|iPhone|iPad|iPod/.test(navigator.platform) ? \"⌘\" : \"Ctrl\";\n}\n\n/** e.g. \"⌘S\" on Mac, \"Ctrl+S\" elsewhere */\nexport function formatModShortcut(key: string, shift = false): string {\n  const mod = modKeyLabel();\n  const k = shift ? `Shift+${key.toUpperCase()}` : key.toUpperCase();\n  return mod === \"⌘\" ? `${mod}${shift ? \"⇧\" : \"\"}${key.toUpperCase()}` : `${mod}+${k}`;\n}\n\nexport function matchModShortcut(e: KeyboardEvent, key: string): boolean {\n  if (!(e.metaKey || e.ctrlKey) || e.altKey) return false;\n  return e.key.toLowerCase() === key.toLowerCase();\n}\n\nexport function matchModShiftShortcut(e: KeyboardEvent, key: string): boolean {\n  if (!(e.metaKey || e.ctrlKey) || e.altKey || !e.shiftKey) return false;\n  return e.key.toLowerCase() === key.toLowerCase();\n}\n\nexport function matchModEnter(e: KeyboardEvent): boolean {\n  if (!(e.metaKey || e.ctrlKey) || e.altKey || e.shiftKey) return false;\n  return e.key === \"Enter\";\n}\n\nexport function matchEscape(e: KeyboardEvent): boolean {\n  return e.key === \"Escape\" && !e.metaKey && !e.ctrlKey && !e.altKey && !e.shiftKey;\n}\n\nexport function formatModEnterShortcut(): string {\n  const mod = modKeyLabel();\n  return mod === \"⌘\" ? \"⌘↵\" : \"Ctrl+Enter\";\n}\n\nexport function formatEscapeShortcut(): string {\n  return \"Esc\";\n}\n\nexport function matchSave(e: KeyboardEvent): boolean {\n  return matchModShortcut(e, \"s\");\n}\n\nexport function matchToggleEditMode(e: KeyboardEvent): boolean {\n  return matchModShortcut(e, \"e\");\n}\n\nexport function matchUndoRedo(e: KeyboardEvent): UndoRedoKind {\n  if (!(e.metaKey || e.ctrlKey)) return null;\n  const key = e.key.toLowerCase();\n  if (key === \"z\" && !e.shiftKey) return \"undo\";\n  if ((key === \"z\" && e.shiftKey) || key === \"y\") return \"redo\";\n  return null;\n}\n\n// Id pickers use a combobox input; when the menu is closed, arrow keys should\n// move cell focus instead of being trapped in the field.\nfunction isIdPickerPassThrough(el: HTMLElement): boolean {\n  if (el.tagName !== \"INPUT\") return false;\n  const input = el as HTMLInputElement;\n  if (!input.hasAttribute(\"data-id-picker-input\")) return false;\n  return input.getAttribute(\"aria-expanded\") !== \"true\";\n}\n\n// Native browsers handle text undo for typed input; never hijack while a\n// caret-bearing element is focused.\nexport function isTypingInEditor(): boolean {\n  const ae = document.activeElement as HTMLElement | null;\n  if (!ae) return false;\n  if (\n    ae.closest(\n      \".monaco-editor, .native-edit-context, [data-markdown-editor], [data-rich-text-editor]\",\n    )\n  ) {\n    return true;\n  }\n  if (isIdPickerPassThrough(ae)) return false;\n  const tag = ae.tagName;\n  return tag === \"INPUT\" || tag === \"TEXTAREA\" || tag === \"SELECT\" || ae.isContentEditable;\n}\n\n/** True when a Radix popover/select layer is open — Escape should close it first. */\nexport function isRadixOverlayOpen(): boolean {\n  const ae = document.activeElement as HTMLElement | null;\n  if (ae?.getAttribute(\"aria-expanded\") === \"true\") return true;\n  return Boolean(ae?.closest(\"[data-radix-popper-content-wrapper]\"));\n}\n"]}

package/dist/manifestDeploy.d.ts

@@ -0,0 +1,27 @@
+export declare const MANIFEST_DEPLOY_STATUSES: readonly ["idle", "cleaning", "ready", "deploying", "deployed", "failed"];
+/** Status persisted in the singleton Columnus manifest row. */
+export type ManifestDeployStatus = (typeof MANIFEST_DEPLOY_STATUSES)[number];
+export declare function isManifestDeployStatus(value: unknown): value is ManifestDeployStatus;
+/** Manifest row fields shared by the component, host, read API, CLI, and UI boundaries. */
+export type ManifestDeploySnapshot = {
+    manifestJson: string;
+    draftManifestJson?: string;
+    draftUpdatedAt?: number;
+    erdLayoutJson?: string;
+    draftErdLayoutJson?: string;
+    lastSaveAt: number;
+    deployStatus: ManifestDeployStatus;
+    deployError?: string;
+    deployLogTail?: string;
+    deployedAt?: number;
+    deployOperationId?: string;
+    desiredManifestHash?: string;
+    deployedManifestHash?: string;
+    deployStartedAt?: number;
+    deployCompletedAt?: number;
+    refsSchemaHash?: string;
+    refsIndexedAt?: number;
+    refsRecomputeTargetHash?: string;
+    refsRecomputeHeartbeatAt?: number;
+    pendingRefsRecomputeBeforeJson?: string;
+};

package/dist/manifestDeploy.js

@@ -0,0 +1,16 @@
+// packages/@columnus/shared/src/manifestDeploy.ts
+var MANIFEST_DEPLOY_STATUSES = [
+  "idle",
+  "cleaning",
+  "ready",
+  "deploying",
+  "deployed",
+  "failed"
+];
+function isManifestDeployStatus(value) {
+  return MANIFEST_DEPLOY_STATUSES.some((status) => status === value);
+}
+
+export { MANIFEST_DEPLOY_STATUSES, isManifestDeployStatus };
+//# sourceMappingURL=manifestDeploy.js.map
+//# sourceMappingURL=manifestDeploy.js.map

package/dist/manifestDeploy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifestDeploy.ts"],"names":[],"mappings":";AAAO,IAAM,wBAAA,GAA2B;AAAA,EACtC,MAAA;AAAA,EACA,UAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAKO,SAAS,uBAAuB,KAAA,EAA+C;AACpF,EAAA,OAAO,wBAAA,CAAyB,IAAA,CAAK,CAAC,MAAA,KAAW,WAAW,KAAK,CAAA;AACnE","file":"manifestDeploy.js","sourcesContent":["export const MANIFEST_DEPLOY_STATUSES = [\n  \"idle\",\n  \"cleaning\",\n  \"ready\",\n  \"deploying\",\n  \"deployed\",\n  \"failed\",\n] as const;\n\n/** Status persisted in the singleton Columnus manifest row. */\nexport type ManifestDeployStatus = (typeof MANIFEST_DEPLOY_STATUSES)[number];\n\nexport function isManifestDeployStatus(value: unknown): value is ManifestDeployStatus {\n  return MANIFEST_DEPLOY_STATUSES.some((status) => status === value);\n}\n\n/** Manifest row fields shared by the component, host, read API, CLI, and UI boundaries. */\nexport type ManifestDeploySnapshot = {\n  manifestJson: string;\n  draftManifestJson?: string;\n  draftUpdatedAt?: number;\n  erdLayoutJson?: string;\n  draftErdLayoutJson?: string;\n  lastSaveAt: number;\n  deployStatus: ManifestDeployStatus;\n  deployError?: string;\n  deployLogTail?: string;\n  deployedAt?: number;\n  deployOperationId?: string;\n  desiredManifestHash?: string;\n  deployedManifestHash?: string;\n  deployStartedAt?: number;\n  deployCompletedAt?: number;\n  refsSchemaHash?: string;\n  refsIndexedAt?: number;\n  refsRecomputeTargetHash?: string;\n  refsRecomputeHeartbeatAt?: number;\n  pendingRefsRecomputeBeforeJson?: string;\n};\n"]}

package/dist/manifestHash.d.ts

@@ -0,0 +1,11 @@
+import type { Manifest } from "./schemaTypes.ts";
+import type { ApiTableAccess } from "./apiProfile.ts";
+/** Stable JSON for `{ tables }` filtered to an allowlist (sorted by table name). */
+export declare function canonicalManifestTablesJson(manifest: Manifest, allowedTableNames?: readonly string[]): string;
+/** SHA-256 hex of canonical filtered manifest tables (server source of truth for pull sync). */
+export declare function computeManifestHash(manifest: Manifest, allowedTableNames?: readonly string[]): Promise<string>;
+/**
+ * Pull-sync fingerprint for a manifest plus the profile capabilities that
+ * determine generated client refs and hooks.
+ */
+export declare function computeManifestAccessHash(manifest: Manifest, tableAccess: readonly ApiTableAccess[]): Promise<string>;

package/dist/manifestHash.js

@@ -0,0 +1,35 @@
+// packages/@columnus/shared/src/manifestHash.ts
+function canonicalManifestTablesJson(manifest, allowedTableNames) {
+  let tables = manifest.tables;
+  if (allowedTableNames !== void 0) {
+    const allowed = new Set(allowedTableNames);
+    tables = tables.filter((table) => allowed.has(table.name));
+  }
+  const sorted = [...tables].sort((a, b) => a.name.localeCompare(b.name));
+  return JSON.stringify({ tables: sorted });
+}
+async function sha256Hex(input) {
+  const data = new TextEncoder().encode(input);
+  const digest = await crypto.subtle.digest("SHA-256", data);
+  return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+async function computeManifestHash(manifest, allowedTableNames) {
+  return sha256Hex(canonicalManifestTablesJson(manifest, allowedTableNames));
+}
+async function computeManifestAccessHash(manifest, tableAccess) {
+  return sha256Hex(
+    JSON.stringify({
+      manifest: JSON.parse(
+        canonicalManifestTablesJson(
+          manifest,
+          tableAccess.map((access) => access.table)
+        )
+      ),
+      tableAccess
+    })
+  );
+}
+
+export { canonicalManifestTablesJson, computeManifestAccessHash, computeManifestHash };
+//# sourceMappingURL=manifestHash.js.map
+//# sourceMappingURL=manifestHash.js.map

package/dist/manifestHash.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifestHash.ts"],"names":[],"mappings":";AAIO,SAAS,2BAAA,CACd,UACA,iBAAA,EACQ;AACR,EAAA,IAAI,SAAkB,QAAA,CAAS,MAAA;AAC/B,EAAA,IAAI,sBAAsB,MAAA,EAAW;AACnC,IAAA,MAAM,OAAA,GAAU,IAAI,GAAA,CAAI,iBAAiB,CAAA;AACzC,IAAA,MAAA,GAAS,MAAA,CAAO,OAAO,CAAC,KAAA,KAAU,QAAQ,GAAA,CAAI,KAAA,CAAM,IAAI,CAAC,CAAA;AAAA,EAC3D;AACA,EAAA,MAAM,MAAA,GAAS,CAAC,GAAG,MAAM,EAAE,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,IAAA,CAAK,aAAA,CAAc,CAAA,CAAE,IAAI,CAAC,CAAA;AACtE,EAAA,OAAO,IAAA,CAAK,SAAA,CAAU,EAAE,MAAA,EAAQ,QAAQ,CAAA;AAC1C;AAEA,eAAe,UAAU,KAAA,EAAgC;AACvD,EAAA,MAAM,IAAA,GAAO,IAAI,WAAA,EAAY,CAAE,OAAO,KAAK,CAAA;AAC3C,EAAA,MAAM,SAAS,MAAM,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,WAAW,IAAI,CAAA;AACzD,EAAA,OAAO,CAAC,GAAG,IAAI,UAAA,CAAW,MAAM,CAAC,CAAA,CAAE,IAAI,CAAC,IAAA,KAAS,KAAK,QAAA,CAAS,EAAE,EAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAC,CAAA,CAAE,KAAK,EAAE,CAAA;AAC9F;AAGA,eAAsB,mBAAA,CACpB,UACA,iBAAA,EACiB;AACjB,EAAA,OAAO,SAAA,CAAU,2BAAA,CAA4B,QAAA,EAAU,iBAAiB,CAAC,CAAA;AAC3E;AAMA,eAAsB,yBAAA,CACpB,UACA,WAAA,EACiB;AACjB,EAAA,OAAO,SAAA;AAAA,IACL,KAAK,SAAA,CAAU;AAAA,MACb,UAAU,IAAA,CAAK,KAAA;AAAA,QACb,2BAAA;AAAA,UACE,QAAA;AAAA,UACA,WAAA,CAAY,GAAA,CAAI,CAAC,MAAA,KAAW,OAAO,KAAK;AAAA;AAC1C,OACF;AAAA,MACA;AAAA,KACD;AAAA,GACH;AACF","file":"manifestHash.js","sourcesContent":["import type { Manifest, Table } from \"./schemaTypes.ts\";\nimport type { ApiTableAccess } from \"./apiProfile.ts\";\n\n/** Stable JSON for `{ tables }` filtered to an allowlist (sorted by table name). */\nexport function canonicalManifestTablesJson(\n  manifest: Manifest,\n  allowedTableNames?: readonly string[],\n): string {\n  let tables: Table[] = manifest.tables;\n  if (allowedTableNames !== undefined) {\n    const allowed = new Set(allowedTableNames);\n    tables = tables.filter((table) => allowed.has(table.name));\n  }\n  const sorted = [...tables].sort((a, b) => a.name.localeCompare(b.name));\n  return JSON.stringify({ tables: sorted });\n}\n\nasync function sha256Hex(input: string): Promise<string> {\n  const data = new TextEncoder().encode(input);\n  const digest = await crypto.subtle.digest(\"SHA-256\", data);\n  return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\n/** SHA-256 hex of canonical filtered manifest tables (server source of truth for pull sync). */\nexport async function computeManifestHash(\n  manifest: Manifest,\n  allowedTableNames?: readonly string[],\n): Promise<string> {\n  return sha256Hex(canonicalManifestTablesJson(manifest, allowedTableNames));\n}\n\n/**\n * Pull-sync fingerprint for a manifest plus the profile capabilities that\n * determine generated client refs and hooks.\n */\nexport async function computeManifestAccessHash(\n  manifest: Manifest,\n  tableAccess: readonly ApiTableAccess[],\n): Promise<string> {\n  return sha256Hex(\n    JSON.stringify({\n      manifest: JSON.parse(\n        canonicalManifestTablesJson(\n          manifest,\n          tableAccess.map((access) => access.table),\n        ),\n      ),\n      tableAccess,\n    }),\n  );\n}\n"]}

package/dist/previewDeployName.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Sanitized Convex preview deployment name for CI / Coolify preview builds.
+ * "/" breaks preview/<name> lookups in Convex deployment references.
+ *
+ * Coolify preview env vars: COOLIFY_BRANCH, COOLIFY_IS_PREVIEW, COOLIFY_FQDN,
+ * COOLIFY_URL (BuildKit build secrets).
+ */
+export declare function coolifyHostnameFromEnv(env?: NodeJS.ProcessEnv): string | null;
+/** True when Coolify (or CI_PREVIEW) indicates a PR preview Docker build. */
+export declare function isCiPreviewBuild(env?: NodeJS.ProcessEnv): boolean;
+/** PR id from `preview-<n>.<domain>` / `manage-preview-<n>` hostname or `pull/<n>/head` branch. */
+export declare function resolvePreviewPrId(env?: NodeJS.ProcessEnv): string | null;
+/**
+ * Resolve the git branch used for Convex `--preview-name`.
+ * Coolify often sets COOLIFY_BRANCH to `pull/<n>/head` at runtime (see coollabsio/coolify#9572).
+ */
+export declare function resolvePreviewBranch(env?: NodeJS.ProcessEnv): string | null;
+export declare function sanitizePreviewDeployName(branch: string): string;
+/** Normalize a preview name from Convex env before `convex deploy --preview-name`. */
+export declare function normalizePreviewDeployName(name: string): string;
+export declare function ciPreviewDeployName(env?: NodeJS.ProcessEnv): string | null;
+/** Stale failures from broken preview deploy before the bridge was live. */
+export declare const STALE_ENDPOINT_DEPLOY_ERROR: RegExp;
+export declare function isStaleEndpointDeployError(error: string | undefined): boolean;
+/** Infra failures from a prior broken deploy that a fresh save can retry. */
+export declare function isRecoverableDeployError(error: string | undefined): boolean;

package/dist/previewDeployName.js

@@ -0,0 +1,77 @@
+// packages/@columnus/shared/src/previewDeployName.ts
+function coolifyHostnameFromEnv(env = process.env) {
+  const raw = env.COOLIFY_FQDN ?? env.COOLIFY_URL;
+  if (!raw) return null;
+  const host = raw.replace(/^https?:\/\//, "").split("/")[0] ?? "";
+  return host || null;
+}
+function isCiPreviewBuild(env = process.env) {
+  if (env.CI_PREVIEW === "true" || env.COOLIFY_IS_PREVIEW === "true") {
+    return true;
+  }
+  const host = coolifyHostnameFromEnv(env);
+  return Boolean(host && /^(?:manage-|deploy-)?preview-\d+\./.test(host));
+}
+var PULL_HEAD_BRANCH_RE = /^pull\/(\d+)\/head$/i;
+var PREVIEW_HOST_PR_RE = /^(?:manage-|deploy-)?preview-(\d+)\./;
+function resolvePreviewPrId(env = process.env) {
+  const host = coolifyHostnameFromEnv(env);
+  if (host) {
+    const fromHost = PREVIEW_HOST_PR_RE.exec(host)?.[1];
+    if (fromHost) return fromHost;
+  }
+  const branch = env.COOLIFY_BRANCH ?? env.GIT_BRANCH;
+  if (branch) {
+    const fromBranch = PULL_HEAD_BRANCH_RE.exec(stripQualifiedBranch(branch))?.[1];
+    if (fromBranch) return fromBranch;
+  }
+  return null;
+}
+function resolvePreviewBranch(env = process.env) {
+  if (env.GITHUB_HEAD_REF) return stripQualifiedBranch(env.GITHUB_HEAD_REF);
+  const branch = env.COOLIFY_BRANCH ?? env.GIT_BRANCH;
+  const prId = resolvePreviewPrId(env);
+  if (!branch) {
+    return prId ? `preview-${prId}` : null;
+  }
+  const stripped = stripQualifiedBranch(branch);
+  if (PULL_HEAD_BRANCH_RE.test(stripped)) {
+    if (prId) return `preview-${prId}`;
+  }
+  if ((stripped === "main" || stripped === "master") && prId) {
+    return `preview-${prId}`;
+  }
+  return stripped;
+}
+function stripQualifiedBranch(branch) {
+  const colon = branch.indexOf(":");
+  return colon > 0 ? branch.slice(0, colon) : branch;
+}
+function sanitizePreviewDeployName(branch) {
+  return stripQualifiedBranch(branch).replace(/\//g, "-");
+}
+function normalizePreviewDeployName(name) {
+  return sanitizePreviewDeployName(name.trim());
+}
+function ciPreviewDeployName(env = process.env) {
+  if (!isCiPreviewBuild(env)) return null;
+  const branch = resolvePreviewBranch(env);
+  if (!branch) return null;
+  return sanitizePreviewDeployName(branch);
+}
+var STALE_ENDPOINT_DEPLOY_ERROR = /^deploy endpoint returned (?:200(?: OK)?|500(?: Internal Server Error)?)$/;
+function isStaleEndpointDeployError(error) {
+  return error != null && STALE_ENDPOINT_DEPLOY_ERROR.test(error);
+}
+function isRecoverableDeployError(error) {
+  if (error == null) return false;
+  if (isStaleEndpointDeployError(error)) return true;
+  if (error.includes("502 Bad Gateway")) return true;
+  if (error.includes("deploy endpoint unreachable")) return true;
+  if (error.includes("deploy endpoint timed out")) return true;
+  return error.includes("convex/bin/main.js") || error.includes("convex CLI (bin/main.js") || error.includes("convex CLI not available");
+}
+
+export { STALE_ENDPOINT_DEPLOY_ERROR, ciPreviewDeployName, coolifyHostnameFromEnv, isCiPreviewBuild, isRecoverableDeployError, isStaleEndpointDeployError, normalizePreviewDeployName, resolvePreviewBranch, resolvePreviewPrId, sanitizePreviewDeployName };
+//# sourceMappingURL=previewDeployName.js.map
+//# sourceMappingURL=previewDeployName.js.map

package/dist/previewDeployName.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/previewDeployName.ts"],"names":[],"mappings":"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","file":"previewDeployName.js","sourcesContent":["/**\n * Sanitized Convex preview deployment name for CI / Coolify preview builds.\n * \"/\" breaks preview/<name> lookups in Convex deployment references.\n *\n * Coolify preview env vars: COOLIFY_BRANCH, COOLIFY_IS_PREVIEW, COOLIFY_FQDN,\n * COOLIFY_URL (BuildKit build secrets).\n */\nexport function coolifyHostnameFromEnv(env: NodeJS.ProcessEnv = process.env): string | null {\n  const raw = env.COOLIFY_FQDN ?? env.COOLIFY_URL;\n  if (!raw) return null;\n  const host = raw.replace(/^https?:\\/\\//, \"\").split(\"/\")[0] ?? \"\";\n  return host || null;\n}\n\n/** True when Coolify (or CI_PREVIEW) indicates a PR preview Docker build. */\nexport function isCiPreviewBuild(env: NodeJS.ProcessEnv = process.env): boolean {\n  if (env.CI_PREVIEW === \"true\" || env.COOLIFY_IS_PREVIEW === \"true\") {\n    return true;\n  }\n  const host = coolifyHostnameFromEnv(env);\n  // preview-<pr>, manage-preview-<pr>, deploy-preview-<pr>\n  return Boolean(host && /^(?:manage-|deploy-)?preview-\\d+\\./.test(host));\n}\n\nconst PULL_HEAD_BRANCH_RE = /^pull\\/(\\d+)\\/head$/i;\nconst PREVIEW_HOST_PR_RE = /^(?:manage-|deploy-)?preview-(\\d+)\\./;\n\n/** PR id from `preview-<n>.<domain>` / `manage-preview-<n>` hostname or `pull/<n>/head` branch. */\nexport function resolvePreviewPrId(env: NodeJS.ProcessEnv = process.env): string | null {\n  const host = coolifyHostnameFromEnv(env);\n  if (host) {\n    const fromHost = PREVIEW_HOST_PR_RE.exec(host)?.[1];\n    if (fromHost) return fromHost;\n  }\n\n  const branch = env.COOLIFY_BRANCH ?? env.GIT_BRANCH;\n  if (branch) {\n    const fromBranch = PULL_HEAD_BRANCH_RE.exec(stripQualifiedBranch(branch))?.[1];\n    if (fromBranch) return fromBranch;\n  }\n\n  return null;\n}\n\n/**\n * Resolve the git branch used for Convex `--preview-name`.\n * Coolify often sets COOLIFY_BRANCH to `pull/<n>/head` at runtime (see coollabsio/coolify#9572).\n */\nexport function resolvePreviewBranch(env: NodeJS.ProcessEnv = process.env): string | null {\n  if (env.GITHUB_HEAD_REF) return stripQualifiedBranch(env.GITHUB_HEAD_REF);\n\n  const branch = env.COOLIFY_BRANCH ?? env.GIT_BRANCH;\n  const prId = resolvePreviewPrId(env);\n  if (!branch) {\n    return prId ? `preview-${prId}` : null;\n  }\n\n  const stripped = stripQualifiedBranch(branch);\n  if (PULL_HEAD_BRANCH_RE.test(stripped)) {\n    if (prId) return `preview-${prId}`;\n  }\n  // Coolify PR apps often leave COOLIFY_BRANCH=main while FQDN is *-preview-<n>.\n  if ((stripped === \"main\" || stripped === \"master\") && prId) {\n    return `preview-${prId}`;\n  }\n  return stripped;\n}\n\n/** Strip Coolify/Convex qualified suffixes (e.g. `pull-48-head:pr-48-coolify`). */\nfunction stripQualifiedBranch(branch: string): string {\n  const colon = branch.indexOf(\":\");\n  return colon > 0 ? branch.slice(0, colon) : branch;\n}\n\nexport function sanitizePreviewDeployName(branch: string): string {\n  return stripQualifiedBranch(branch).replace(/\\//g, \"-\");\n}\n\n/** Normalize a preview name from Convex env before `convex deploy --preview-name`. */\nexport function normalizePreviewDeployName(name: string): string {\n  return sanitizePreviewDeployName(name.trim());\n}\n\nexport function ciPreviewDeployName(env: NodeJS.ProcessEnv = process.env): string | null {\n  if (!isCiPreviewBuild(env)) return null;\n\n  const branch = resolvePreviewBranch(env);\n  if (!branch) return null;\n  return sanitizePreviewDeployName(branch);\n}\n\n/** Stale failures from broken preview deploy before the bridge was live. */\nexport const STALE_ENDPOINT_DEPLOY_ERROR =\n  /^deploy endpoint returned (?:200(?: OK)?|500(?: Internal Server Error)?)$/;\n\nexport function isStaleEndpointDeployError(error: string | undefined): boolean {\n  return error != null && STALE_ENDPOINT_DEPLOY_ERROR.test(error);\n}\n\n/** Infra failures from a prior broken deploy that a fresh save can retry. */\nexport function isRecoverableDeployError(error: string | undefined): boolean {\n  if (error == null) return false;\n  if (isStaleEndpointDeployError(error)) return true;\n  if (error.includes(\"502 Bad Gateway\")) return true;\n  if (error.includes(\"deploy endpoint unreachable\")) return true;\n  if (error.includes(\"deploy endpoint timed out\")) return true;\n  return (\n    error.includes(\"convex/bin/main.js\") ||\n    error.includes(\"convex CLI (bin/main.js\") ||\n    error.includes(\"convex CLI not available\")\n  );\n}\n"]}

package/dist/proposePolicy.d.ts

@@ -0,0 +1,17 @@
+export type ProposalOperation = "insert" | "update" | "delete";
+export type ProposalAccess = {
+    table: string;
+    ops: Record<ProposalOperation, boolean>;
+    recordIds?: string[];
+    allowedFields?: string[];
+};
+export type ProposalTarget = {
+    table: string;
+    operation: ProposalOperation;
+    rowId?: string;
+    fields?: string[];
+};
+/** Enforce the proposal rules shared by API profiles and share scopes. */
+export declare function assertProposalAccess(accesses: readonly ProposalAccess[], target: ProposalTarget): ProposalAccess;
+/** Strip system and disallowed fields before persisting a proposal patch. */
+export declare function pickProposalFields(fields: Record<string, unknown>, allowedFields?: string[]): Record<string, unknown>;

package/dist/proposePolicy.js

@@ -0,0 +1,33 @@
+// packages/@columnus/shared/src/proposePolicy.ts
+function assertProposalAccess(accesses, target) {
+  const access = accesses.find((candidate) => candidate.table === target.table);
+  if (!access?.ops[target.operation]) {
+    throw new Error(`${target.operation} is not allowed for ${target.table}`);
+  }
+  if (access.recordIds && (!target.rowId || !access.recordIds.includes(target.rowId))) {
+    throw new Error(`Row is outside the allowed scope for ${target.table}`);
+  }
+  if (target.operation === "insert" && access.recordIds) {
+    throw new Error(`Insert is not allowed on a record-restricted ${target.table} scope`);
+  }
+  if (target.fields) {
+    const allowed = access.allowedFields ? new Set(access.allowedFields) : null;
+    const denied = target.fields.find(
+      (field) => field.startsWith("_") || allowed && !allowed.has(field)
+    );
+    if (denied) throw new Error(`Field ${denied} is not allowed for ${target.table}`);
+  }
+  return access;
+}
+function pickProposalFields(fields, allowedFields) {
+  const allowed = allowedFields ? new Set(allowedFields) : null;
+  return Object.fromEntries(
+    Object.entries(fields).filter(
+      ([field]) => !field.startsWith("_") && (!allowed || allowed.has(field))
+    )
+  );
+}
+
+export { assertProposalAccess, pickProposalFields };
+//# sourceMappingURL=proposePolicy.js.map
+//# sourceMappingURL=proposePolicy.js.map

package/dist/proposePolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/proposePolicy.ts"],"names":[],"mappings":";AAiBO,SAAS,oBAAA,CACd,UACA,MAAA,EACgB;AAChB,EAAA,MAAM,MAAA,GAAS,SAAS,IAAA,CAAK,CAAC,cAAc,SAAA,CAAU,KAAA,KAAU,OAAO,KAAK,CAAA;AAC5E,EAAA,IAAI,CAAC,MAAA,EAAQ,GAAA,CAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AAClC,IAAA,MAAM,IAAI,MAAM,CAAA,EAAG,MAAA,CAAO,SAAS,CAAA,oBAAA,EAAuB,MAAA,CAAO,KAAK,CAAA,CAAE,CAAA;AAAA,EAC1E;AACA,EAAA,IAAI,MAAA,CAAO,SAAA,KAAc,CAAC,MAAA,CAAO,KAAA,IAAS,CAAC,MAAA,CAAO,SAAA,CAAU,QAAA,CAAS,MAAA,CAAO,KAAK,CAAA,CAAA,EAAI;AACnF,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qCAAA,EAAwC,MAAA,CAAO,KAAK,CAAA,CAAE,CAAA;AAAA,EACxE;AACA,EAAA,IAAI,MAAA,CAAO,SAAA,KAAc,QAAA,IAAY,MAAA,CAAO,SAAA,EAAW;AACrD,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,6CAAA,EAAgD,MAAA,CAAO,KAAK,CAAA,MAAA,CAAQ,CAAA;AAAA,EACtF;AACA,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,MAAM,UAAU,MAAA,CAAO,aAAA,GAAgB,IAAI,GAAA,CAAI,MAAA,CAAO,aAAa,CAAA,GAAI,IAAA;AACvE,IAAA,MAAM,MAAA,GAAS,OAAO,MAAA,CAAO,IAAA;AAAA,MAC3B,CAAC,KAAA,KAAU,KAAA,CAAM,UAAA,CAAW,GAAG,KAAM,OAAA,IAAW,CAAC,OAAA,CAAQ,GAAA,CAAI,KAAK;AAAA,KACpE;AACA,IAAA,IAAI,MAAA,QAAc,IAAI,KAAA,CAAM,SAAS,MAAM,CAAA,oBAAA,EAAuB,MAAA,CAAO,KAAK,CAAA,CAAE,CAAA;AAAA,EAClF;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,kBAAA,CACd,QACA,aAAA,EACyB;AACzB,EAAA,MAAM,OAAA,GAAU,aAAA,GAAgB,IAAI,GAAA,CAAI,aAAa,CAAA,GAAI,IAAA;AACzD,EAAA,OAAO,MAAA,CAAO,WAAA;AAAA,IACZ,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CAAE,MAAA;AAAA,MACrB,CAAC,CAAC,KAAK,CAAA,KAAM,CAAC,KAAA,CAAM,UAAA,CAAW,GAAG,CAAA,KAAM,CAAC,OAAA,IAAW,OAAA,CAAQ,IAAI,KAAK,CAAA;AAAA;AACvE,GACF;AACF","file":"proposePolicy.js","sourcesContent":["export type ProposalOperation = \"insert\" | \"update\" | \"delete\";\n\nexport type ProposalAccess = {\n  table: string;\n  ops: Record<ProposalOperation, boolean>;\n  recordIds?: string[];\n  allowedFields?: string[];\n};\n\nexport type ProposalTarget = {\n  table: string;\n  operation: ProposalOperation;\n  rowId?: string;\n  fields?: string[];\n};\n\n/** Enforce the proposal rules shared by API profiles and share scopes. */\nexport function assertProposalAccess(\n  accesses: readonly ProposalAccess[],\n  target: ProposalTarget,\n): ProposalAccess {\n  const access = accesses.find((candidate) => candidate.table === target.table);\n  if (!access?.ops[target.operation]) {\n    throw new Error(`${target.operation} is not allowed for ${target.table}`);\n  }\n  if (access.recordIds && (!target.rowId || !access.recordIds.includes(target.rowId))) {\n    throw new Error(`Row is outside the allowed scope for ${target.table}`);\n  }\n  if (target.operation === \"insert\" && access.recordIds) {\n    throw new Error(`Insert is not allowed on a record-restricted ${target.table} scope`);\n  }\n  if (target.fields) {\n    const allowed = access.allowedFields ? new Set(access.allowedFields) : null;\n    const denied = target.fields.find(\n      (field) => field.startsWith(\"_\") || (allowed && !allowed.has(field)),\n    );\n    if (denied) throw new Error(`Field ${denied} is not allowed for ${target.table}`);\n  }\n  return access;\n}\n\n/** Strip system and disallowed fields before persisting a proposal patch. */\nexport function pickProposalFields(\n  fields: Record<string, unknown>,\n  allowedFields?: string[],\n): Record<string, unknown> {\n  const allowed = allowedFields ? new Set(allowedFields) : null;\n  return Object.fromEntries(\n    Object.entries(fields).filter(\n      ([field]) => !field.startsWith(\"_\") && (!allowed || allowed.has(field)),\n    ),\n  );\n}\n"]}

package/dist/queryBetween.d.ts

@@ -0,0 +1,20 @@
+export type BetweenValue = {
+    min: unknown;
+    max: unknown;
+};
+export type BetweenIndexBound = {
+    op: "gte";
+    value: unknown;
+} | {
+    op: "lte";
+    value: unknown;
+} | {
+    op: "between";
+    min: unknown;
+    max: unknown;
+};
+export declare function isCompleteBetween(value: BetweenValue): boolean;
+/** Convert inclusive `between` UI state into the strongest available index range. */
+export declare function betweenToIndexBound(value: BetweenValue): BetweenIndexBound | null;
+export declare function matchesBetween(value: unknown, between: BetweenValue): boolean;
+export declare function compareOrdered(a: unknown, b: unknown): number;

package/dist/queryBetween.js

@@ -0,0 +1,28 @@
+// packages/@columnus/shared/src/queryBetween.ts
+function isCompleteBetween(value) {
+  return value.min != null && value.max != null;
+}
+function betweenToIndexBound(value) {
+  if (isCompleteBetween(value)) {
+    return { op: "between", min: value.min, max: value.max };
+  }
+  if (value.min != null) return { op: "gte", value: value.min };
+  if (value.max != null) return { op: "lte", value: value.max };
+  return null;
+}
+function matchesBetween(value, between) {
+  if (between.min != null && compareOrdered(value, between.min) < 0) return false;
+  if (between.max != null && compareOrdered(value, between.max) > 0) return false;
+  return true;
+}
+function compareOrdered(a, b) {
+  if (typeof a === "number" && typeof b === "number") return a - b;
+  if (typeof a === "string" && typeof b === "string") return a < b ? -1 : a > b ? 1 : 0;
+  if (typeof a === "bigint" && typeof b === "bigint") return a < b ? -1 : a > b ? 1 : 0;
+  if (a === b) return 0;
+  return String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0;
+}
+
+export { betweenToIndexBound, compareOrdered, isCompleteBetween, matchesBetween };
+//# sourceMappingURL=queryBetween.js.map
+//# sourceMappingURL=queryBetween.js.map

package/dist/queryBetween.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queryBetween.ts"],"names":[],"mappings":";AAUO,SAAS,kBAAkB,KAAA,EAA8B;AAC9D,EAAA,OAAO,KAAA,CAAM,GAAA,IAAO,IAAA,IAAQ,KAAA,CAAM,GAAA,IAAO,IAAA;AAC3C;AAGO,SAAS,oBAAoB,KAAA,EAA+C;AACjF,EAAA,IAAI,iBAAA,CAAkB,KAAK,CAAA,EAAG;AAC5B,IAAA,OAAO,EAAE,IAAI,SAAA,EAAW,GAAA,EAAK,MAAM,GAAA,EAAK,GAAA,EAAK,MAAM,GAAA,EAAI;AAAA,EACzD;AACA,EAAA,IAAI,KAAA,CAAM,OAAO,IAAA,EAAM,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,KAAA,CAAM,GAAA,EAAI;AAC5D,EAAA,IAAI,KAAA,CAAM,OAAO,IAAA,EAAM,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,KAAA,CAAM,GAAA,EAAI;AAC5D,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,cAAA,CAAe,OAAgB,OAAA,EAAgC;AAC7E,EAAA,IAAI,OAAA,CAAQ,OAAO,IAAA,IAAQ,cAAA,CAAe,OAAO,OAAA,CAAQ,GAAG,CAAA,GAAI,CAAA,EAAG,OAAO,KAAA;AAC1E,EAAA,IAAI,OAAA,CAAQ,OAAO,IAAA,IAAQ,cAAA,CAAe,OAAO,OAAA,CAAQ,GAAG,CAAA,GAAI,CAAA,EAAG,OAAO,KAAA;AAC1E,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,cAAA,CAAe,GAAY,CAAA,EAAoB;AAC7D,EAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,CAAA,KAAM,QAAA,SAAiB,CAAA,GAAI,CAAA;AAC/D,EAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,CAAA,KAAM,QAAA,EAAU,OAAO,CAAA,GAAI,CAAA,GAAI,EAAA,GAAK,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA;AACpF,EAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,CAAA,KAAM,QAAA,EAAU,OAAO,CAAA,GAAI,CAAA,GAAI,EAAA,GAAK,CAAA,GAAI,CAAA,GAAI,CAAA,GAAI,CAAA;AACpF,EAAA,IAAI,CAAA,KAAM,GAAG,OAAO,CAAA;AACpB,EAAA,OAAO,MAAA,CAAO,CAAC,CAAA,GAAI,MAAA,CAAO,CAAC,CAAA,GAAI,EAAA,GAAK,MAAA,CAAO,CAAC,CAAA,GAAI,MAAA,CAAO,CAAC,IAAI,CAAA,GAAI,CAAA;AAClE","file":"queryBetween.js","sourcesContent":["export type BetweenValue = {\n  min: unknown;\n  max: unknown;\n};\n\nexport type BetweenIndexBound =\n  | { op: \"gte\"; value: unknown }\n  | { op: \"lte\"; value: unknown }\n  | { op: \"between\"; min: unknown; max: unknown };\n\nexport function isCompleteBetween(value: BetweenValue): boolean {\n  return value.min != null && value.max != null;\n}\n\n/** Convert inclusive `between` UI state into the strongest available index range. */\nexport function betweenToIndexBound(value: BetweenValue): BetweenIndexBound | null {\n  if (isCompleteBetween(value)) {\n    return { op: \"between\", min: value.min, max: value.max };\n  }\n  if (value.min != null) return { op: \"gte\", value: value.min };\n  if (value.max != null) return { op: \"lte\", value: value.max };\n  return null;\n}\n\nexport function matchesBetween(value: unknown, between: BetweenValue): boolean {\n  if (between.min != null && compareOrdered(value, between.min) < 0) return false;\n  if (between.max != null && compareOrdered(value, between.max) > 0) return false;\n  return true;\n}\n\nexport function compareOrdered(a: unknown, b: unknown): number {\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"string\" && typeof b === \"string\") return a < b ? -1 : a > b ? 1 : 0;\n  if (typeof a === \"bigint\" && typeof b === \"bigint\") return a < b ? -1 : a > b ? 1 : 0;\n  if (a === b) return 0;\n  return String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0;\n}\n"]}

package/dist/queryExecution.d.ts

@@ -0,0 +1,5 @@
+import type { Predicate, QueryOrder } from "./queryTypes.ts";
+/** Evaluate residual predicates against a document. */
+export declare function documentMatchesPredicates(doc: Record<string, unknown>, predicates: Predicate[]): boolean;
+export declare function documentMatchesPredicate(doc: Record<string, unknown>, predicate: Predicate): boolean;
+export declare function sortDocuments<T extends Record<string, unknown>>(docs: T[], order: QueryOrder): T[];

package/dist/queryExecution.js

@@ -0,0 +1,58 @@
+// packages/@columnus/shared/src/queryBetween.ts
+function matchesBetween(value, between) {
+  if (between.min != null && compareOrdered(value, between.min) < 0) return false;
+  if (between.max != null && compareOrdered(value, between.max) > 0) return false;
+  return true;
+}
+function compareOrdered(a, b) {
+  if (typeof a === "number" && typeof b === "number") return a - b;
+  if (typeof a === "string" && typeof b === "string") return a < b ? -1 : a > b ? 1 : 0;
+  if (typeof a === "bigint" && typeof b === "bigint") return a < b ? -1 : a > b ? 1 : 0;
+  if (a === b) return 0;
+  return String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0;
+}
+
+// packages/@columnus/shared/src/queryExecution.ts
+function documentMatchesPredicates(doc, predicates) {
+  for (const predicate of predicates) {
+    if (!documentMatchesPredicate(doc, predicate)) return false;
+  }
+  return true;
+}
+function documentMatchesPredicate(doc, predicate) {
+  const value = doc[predicate.field];
+  switch (predicate.op) {
+    case "eq":
+      return value === predicate.value;
+    case "neq":
+      return value !== predicate.value;
+    case "in":
+      return predicate.value.some((candidate) => candidate === value);
+    case "gt":
+      return compareOrdered(value, predicate.value) > 0;
+    case "gte":
+      return compareOrdered(value, predicate.value) >= 0;
+    case "lt":
+      return compareOrdered(value, predicate.value) < 0;
+    case "lte":
+      return compareOrdered(value, predicate.value) <= 0;
+    case "between":
+      return matchesBetween(value, predicate.value);
+    case "containsAll":
+      return Array.isArray(value) && predicate.value.every((candidate) => value.includes(candidate));
+    default: {
+      const exhaustive = predicate;
+      return exhaustive;
+    }
+  }
+}
+function sortDocuments(docs, order) {
+  const direction = order.direction === "desc" ? -1 : 1;
+  return [...docs].sort(
+    (left, right) => direction * compareOrdered(left[order.field], right[order.field])
+  );
+}
+
+export { documentMatchesPredicate, documentMatchesPredicates, sortDocuments };
+//# sourceMappingURL=queryExecution.js.map
+//# sourceMappingURL=queryExecution.js.map

package/dist/queryExecution.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queryBetween.ts","../src/queryExecution.ts"],"names":[],"mappings":"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","file":"queryExecution.js","sourcesContent":["export type BetweenValue = {\n  min: unknown;\n  max: unknown;\n};\n\nexport type BetweenIndexBound =\n  | { op: \"gte\"; value: unknown }\n  | { op: \"lte\"; value: unknown }\n  | { op: \"between\"; min: unknown; max: unknown };\n\nexport function isCompleteBetween(value: BetweenValue): boolean {\n  return value.min != null && value.max != null;\n}\n\n/** Convert inclusive `between` UI state into the strongest available index range. */\nexport function betweenToIndexBound(value: BetweenValue): BetweenIndexBound | null {\n  if (isCompleteBetween(value)) {\n    return { op: \"between\", min: value.min, max: value.max };\n  }\n  if (value.min != null) return { op: \"gte\", value: value.min };\n  if (value.max != null) return { op: \"lte\", value: value.max };\n  return null;\n}\n\nexport function matchesBetween(value: unknown, between: BetweenValue): boolean {\n  if (between.min != null && compareOrdered(value, between.min) < 0) return false;\n  if (between.max != null && compareOrdered(value, between.max) > 0) return false;\n  return true;\n}\n\nexport function compareOrdered(a: unknown, b: unknown): number {\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"string\" && typeof b === \"string\") return a < b ? -1 : a > b ? 1 : 0;\n  if (typeof a === \"bigint\" && typeof b === \"bigint\") return a < b ? -1 : a > b ? 1 : 0;\n  if (a === b) return 0;\n  return String(a) < String(b) ? -1 : String(a) > String(b) ? 1 : 0;\n}\n","import { compareOrdered, matchesBetween } from \"./queryBetween.ts\";\nimport type { Predicate, QueryOrder } from \"./queryTypes.ts\";\n\n/** Evaluate residual predicates against a document. */\nexport function documentMatchesPredicates(\n  doc: Record<string, unknown>,\n  predicates: Predicate[],\n): boolean {\n  for (const predicate of predicates) {\n    if (!documentMatchesPredicate(doc, predicate)) return false;\n  }\n  return true;\n}\n\nexport function documentMatchesPredicate(\n  doc: Record<string, unknown>,\n  predicate: Predicate,\n): boolean {\n  const value = doc[predicate.field];\n  switch (predicate.op) {\n    case \"eq\":\n      return value === predicate.value;\n    case \"neq\":\n      return value !== predicate.value;\n    case \"in\":\n      return predicate.value.some((candidate) => candidate === value);\n    case \"gt\":\n      return compareOrdered(value, predicate.value) > 0;\n    case \"gte\":\n      return compareOrdered(value, predicate.value) >= 0;\n    case \"lt\":\n      return compareOrdered(value, predicate.value) < 0;\n    case \"lte\":\n      return compareOrdered(value, predicate.value) <= 0;\n    case \"between\":\n      return matchesBetween(value, predicate.value);\n    case \"containsAll\":\n      return (\n        Array.isArray(value) && predicate.value.every((candidate) => value.includes(candidate))\n      );\n    default: {\n      const exhaustive: never = predicate;\n      return exhaustive;\n    }\n  }\n}\n\nexport function sortDocuments<T extends Record<string, unknown>>(\n  docs: T[],\n  order: QueryOrder,\n): T[] {\n  const direction = order.direction === \"desc\" ? -1 : 1;\n  return [...docs].sort(\n    (left, right) => direction * compareOrdered(left[order.field], right[order.field]),\n  );\n}\n"]}