@columnus/shared 0.1.47

package/dist/refGraph.d.ts

@@ -0,0 +1,23 @@
+import type { FieldType, Manifest, Table } from "./schemaTypes.ts";
+export type RefFieldEdge = {
+    field: string;
+    targetTable: string;
+    array: boolean;
+};
+export declare function collectReferencedIds(table: Table, rows: Record<string, unknown>[]): Map<string, Set<string>>;
+export declare function collectIdsFromField(rows: Record<string, unknown>[], fieldName: string, type: FieldType, refs: Map<string, Set<string>>): void;
+/** Collect referenced document ids from raw field values (selection chips, formula bar). */
+export declare function collectIdsFromValues(values: readonly unknown[], type: FieldType, refs: Map<string, Set<string>>): void;
+export declare function addRef(refs: Map<string, Set<string>>, table: string, id: string): void;
+/** Manifest `id` / `id[]` ref topology for one table (field names + targets). */
+export declare function refFieldsForTable(table: Table): RefFieldEdge[];
+/** Tables that have at least one outgoing `id` / `id[]` field. */
+export declare function tablesWithOutgoingRefs(manifest: Manifest): string[];
+/** Stable fingerprint of manifest ref topology (ignores labels, indexes, display templates). */
+export declare function computeRefGraphFingerprint(manifest: Manifest): string;
+/** Tables whose ref-field topology changed between two manifests. */
+export declare function listTablesWithRefGraphChanges(before: Manifest, after: Manifest): string[];
+/** Whether a field type can hold outgoing `id` / `id[]` references. */
+export declare function fieldTypeHasOutgoingRefs(type: FieldType): boolean;
+/** Flatten `collectReferencedIds` output to unique target document ids. */
+export declare function referencedTargetIds(refs: Map<string, Set<string>>): Set<string>;

package/dist/refGraph.js

@@ -0,0 +1,102 @@
+// packages/@columnus/shared/src/refGraph.ts
+function refEdgesForType(type) {
+  switch (type.kind) {
+    case "id":
+      return [{ field: "", targetTable: type.table, array: false }];
+    case "array":
+      if (type.element.kind === "id") {
+        return [{ field: "", targetTable: type.element.table, array: true }];
+      }
+      return [];
+    default:
+      return [];
+  }
+}
+function collectTargetIdsFromValue(value, edge, refs) {
+  if (edge.array) {
+    if (!Array.isArray(value)) return;
+    for (const item of value) {
+      if (typeof item === "string" && item.length > 0) addRef(refs, edge.targetTable, item);
+    }
+    return;
+  }
+  if (typeof value === "string" && value.length > 0) addRef(refs, edge.targetTable, value);
+}
+function collectReferencedIds(table, rows) {
+  const refs = /* @__PURE__ */ new Map();
+  for (const edge of refFieldsForTable(table)) {
+    for (const row of rows) {
+      collectTargetIdsFromValue(row[edge.field], edge, refs);
+    }
+  }
+  return refs;
+}
+function collectIdsFromField(rows, fieldName, type, refs) {
+  for (const template of refEdgesForType(type)) {
+    const edge = { ...template};
+    for (const row of rows) {
+      collectTargetIdsFromValue(row[fieldName], edge, refs);
+    }
+  }
+}
+function collectIdsFromValues(values, type, refs) {
+  for (const template of refEdgesForType(type)) {
+    for (const value of values) {
+      collectTargetIdsFromValue(value, template, refs);
+    }
+  }
+}
+function addRef(refs, table, id) {
+  const set = refs.get(table) ?? /* @__PURE__ */ new Set();
+  set.add(id);
+  refs.set(table, set);
+}
+function refFieldsForTable(table) {
+  const edges = [];
+  for (const field of table.fields) {
+    for (const template of refEdgesForType(field.type)) {
+      edges.push({ ...template, field: field.name });
+    }
+  }
+  return edges.sort(
+    (a, b) => a.field.localeCompare(b.field) || a.targetTable.localeCompare(b.targetTable)
+  );
+}
+function tablesWithOutgoingRefs(manifest) {
+  return manifest.tables.filter((table) => refFieldsForTable(table).length > 0).map((table) => table.name).sort((a, b) => a.localeCompare(b));
+}
+function tableRefFingerprint(table) {
+  return JSON.stringify(refFieldsForTable(table));
+}
+function computeRefGraphFingerprint(manifest) {
+  const tables = [...manifest.tables].sort((a, b) => a.name.localeCompare(b.name)).map((table) => ({ name: table.name, refs: refFieldsForTable(table) }));
+  return JSON.stringify(tables);
+}
+function listTablesWithRefGraphChanges(before, after) {
+  const beforeMap = new Map(before.tables.map((t) => [t.name, tableRefFingerprint(t)]));
+  const afterMap = new Map(after.tables.map((t) => [t.name, tableRefFingerprint(t)]));
+  const changed = /* @__PURE__ */ new Set();
+  for (const [name, fp] of afterMap) {
+    if (beforeMap.get(name) !== fp) changed.add(name);
+  }
+  for (const table of before.tables) {
+    if (!afterMap.has(table.name) && refFieldsForTable(table).length > 0) {
+      changed.add(table.name);
+    }
+  }
+  return [...changed].sort((a, b) => a.localeCompare(b));
+}
+function fieldTypeHasOutgoingRefs(type) {
+  return refEdgesForType(type).length > 0;
+}
+function referencedTargetIds(refs) {
+  const out = /* @__PURE__ */ new Set();
+  for (const ids of refs.values()) {
+    for (const id of ids) out.add(id);
+  }
+  return out;
+}
+
+export { addRef, collectIdsFromField, collectIdsFromValues, collectReferencedIds, computeRefGraphFingerprint, fieldTypeHasOutgoingRefs, listTablesWithRefGraphChanges, refFieldsForTable, referencedTargetIds, tablesWithOutgoingRefs };
+//# sourceMappingURL=refGraph.js.map
+//# sourceMappingURL=refGraph.js.map

package/dist/refGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/refGraph.ts"],"names":[],"mappings":"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","file":"refGraph.js","sourcesContent":["import type { FieldType, Manifest, Table } from \"./schemaTypes.ts\";\n\nexport type RefFieldEdge = {\n  field: string;\n  targetTable: string;\n  array: boolean;\n};\n\nfunction refEdgesForType(type: FieldType): RefFieldEdge[] {\n  switch (type.kind) {\n    case \"id\":\n      return [{ field: \"\", targetTable: type.table, array: false }];\n    case \"array\":\n      if (type.element.kind === \"id\") {\n        return [{ field: \"\", targetTable: type.element.table, array: true }];\n      }\n      return [];\n    default:\n      return [];\n  }\n}\n\nfunction collectTargetIdsFromValue(\n  value: unknown,\n  edge: RefFieldEdge,\n  refs: Map<string, Set<string>>,\n): void {\n  if (edge.array) {\n    if (!Array.isArray(value)) return;\n    for (const item of value) {\n      if (typeof item === \"string\" && item.length > 0) addRef(refs, edge.targetTable, item);\n    }\n    return;\n  }\n  if (typeof value === \"string\" && value.length > 0) addRef(refs, edge.targetTable, value);\n}\n\nexport function collectReferencedIds(\n  table: Table,\n  rows: Record<string, unknown>[],\n): Map<string, Set<string>> {\n  const refs = new Map<string, Set<string>>();\n  for (const edge of refFieldsForTable(table)) {\n    for (const row of rows) {\n      collectTargetIdsFromValue(row[edge.field], edge, refs);\n    }\n  }\n  return refs;\n}\n\nexport function collectIdsFromField(\n  rows: Record<string, unknown>[],\n  fieldName: string,\n  type: FieldType,\n  refs: Map<string, Set<string>>,\n): void {\n  for (const template of refEdgesForType(type)) {\n    const edge: RefFieldEdge = { ...template, field: fieldName };\n    for (const row of rows) {\n      collectTargetIdsFromValue(row[fieldName], edge, refs);\n    }\n  }\n}\n\n/** Collect referenced document ids from raw field values (selection chips, formula bar). */\nexport function collectIdsFromValues(\n  values: readonly unknown[],\n  type: FieldType,\n  refs: Map<string, Set<string>>,\n): void {\n  for (const template of refEdgesForType(type)) {\n    for (const value of values) {\n      collectTargetIdsFromValue(value, template, refs);\n    }\n  }\n}\n\nexport function addRef(refs: Map<string, Set<string>>, table: string, id: string): void {\n  const set = refs.get(table) ?? new Set<string>();\n  set.add(id);\n  refs.set(table, set);\n}\n\n/** Manifest `id` / `id[]` ref topology for one table (field names + targets). */\nexport function refFieldsForTable(table: Table): RefFieldEdge[] {\n  const edges: RefFieldEdge[] = [];\n  for (const field of table.fields) {\n    for (const template of refEdgesForType(field.type)) {\n      edges.push({ ...template, field: field.name });\n    }\n  }\n  return edges.sort(\n    (a, b) => a.field.localeCompare(b.field) || a.targetTable.localeCompare(b.targetTable),\n  );\n}\n\n/** Tables that have at least one outgoing `id` / `id[]` field. */\nexport function tablesWithOutgoingRefs(manifest: Manifest): string[] {\n  return manifest.tables\n    .filter((table) => refFieldsForTable(table).length > 0)\n    .map((table) => table.name)\n    .sort((a, b) => a.localeCompare(b));\n}\n\nfunction tableRefFingerprint(table: Table): string {\n  return JSON.stringify(refFieldsForTable(table));\n}\n\n/** Stable fingerprint of manifest ref topology (ignores labels, indexes, display templates). */\nexport function computeRefGraphFingerprint(manifest: Manifest): string {\n  const tables = [...manifest.tables]\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .map((table) => ({ name: table.name, refs: refFieldsForTable(table) }));\n  return JSON.stringify(tables);\n}\n\n/** Tables whose ref-field topology changed between two manifests. */\nexport function listTablesWithRefGraphChanges(before: Manifest, after: Manifest): string[] {\n  const beforeMap = new Map(before.tables.map((t) => [t.name, tableRefFingerprint(t)]));\n  const afterMap = new Map(after.tables.map((t) => [t.name, tableRefFingerprint(t)]));\n  const changed = new Set<string>();\n  for (const [name, fp] of afterMap) {\n    if (beforeMap.get(name) !== fp) changed.add(name);\n  }\n  for (const table of before.tables) {\n    if (!afterMap.has(table.name) && refFieldsForTable(table).length > 0) {\n      changed.add(table.name);\n    }\n  }\n  return [...changed].sort((a, b) => a.localeCompare(b));\n}\n\n/** Whether a field type can hold outgoing `id` / `id[]` references. */\nexport function fieldTypeHasOutgoingRefs(type: FieldType): boolean {\n  return refEdgesForType(type).length > 0;\n}\n\n/** Flatten `collectReferencedIds` output to unique target document ids. */\nexport function referencedTargetIds(refs: Map<string, Set<string>>): Set<string> {\n  const out = new Set<string>();\n  for (const ids of refs.values()) {\n    for (const id of ids) out.add(id);\n  }\n  return out;\n}\n"]}

package/dist/refsRecompute.d.ts

@@ -0,0 +1,8 @@
+/** No page progress for this long means a backfill chain is probably stuck. */
+export declare const REFS_RECOMPUTE_STALE_MS: number;
+export type RefsRecomputeManifestState = {
+    refsRecomputeTargetHash?: string;
+    refsRecomputeHeartbeatAt?: number;
+};
+/** True when a target-matching backfill was started recently and is still making progress. */
+export declare function isRefsRecomputeInFlight(row: RefsRecomputeManifestState | null | undefined, targetFingerprint: string, nowMs: number): boolean;

package/dist/refsRecompute.js

@@ -0,0 +1,12 @@
+// packages/@columnus/shared/src/refsRecompute.ts
+var REFS_RECOMPUTE_STALE_MS = 10 * 60 * 1e3;
+function isRefsRecomputeInFlight(row, targetFingerprint, nowMs) {
+  if (!row || row.refsRecomputeTargetHash !== targetFingerprint) return false;
+  const heartbeat = row.refsRecomputeHeartbeatAt;
+  if (heartbeat == null) return false;
+  return nowMs - heartbeat < REFS_RECOMPUTE_STALE_MS;
+}
+
+export { REFS_RECOMPUTE_STALE_MS, isRefsRecomputeInFlight };
+//# sourceMappingURL=refsRecompute.js.map
+//# sourceMappingURL=refsRecompute.js.map

package/dist/refsRecompute.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/refsRecompute.ts"],"names":[],"mappings":";AACO,IAAM,uBAAA,GAA0B,KAAK,EAAA,GAAK;AAQ1C,SAAS,uBAAA,CACd,GAAA,EACA,iBAAA,EACA,KAAA,EACS;AACT,EAAA,IAAI,CAAC,GAAA,IAAO,GAAA,CAAI,uBAAA,KAA4B,mBAAmB,OAAO,KAAA;AACtE,EAAA,MAAM,YAAY,GAAA,CAAI,wBAAA;AACtB,EAAA,IAAI,SAAA,IAAa,MAAM,OAAO,KAAA;AAC9B,EAAA,OAAO,QAAQ,SAAA,GAAY,uBAAA;AAC7B","file":"refsRecompute.js","sourcesContent":["/** No page progress for this long means a backfill chain is probably stuck. */\nexport const REFS_RECOMPUTE_STALE_MS = 10 * 60 * 1000;\n\nexport type RefsRecomputeManifestState = {\n  refsRecomputeTargetHash?: string;\n  refsRecomputeHeartbeatAt?: number;\n};\n\n/** True when a target-matching backfill was started recently and is still making progress. */\nexport function isRefsRecomputeInFlight(\n  row: RefsRecomputeManifestState | null | undefined,\n  targetFingerprint: string,\n  nowMs: number,\n): boolean {\n  if (!row || row.refsRecomputeTargetHash !== targetFingerprint) return false;\n  const heartbeat = row.refsRecomputeHeartbeatAt;\n  if (heartbeat == null) return false;\n  return nowMs - heartbeat < REFS_RECOMPUTE_STALE_MS;\n}\n"]}

package/dist/richDoc.d.ts

@@ -0,0 +1,67 @@
+/** Shared rich-text / markdown field storage (BlockNote envelope). */
+import { type Query } from "./queryTypes.ts";
+export type RecordLinkAttrs = {
+    table: string;
+    id: string;
+};
+export type RecordTableAttrs = {
+    table: string;
+    /** Stored as JSON in block `filterJson` — Query AST. */
+    query: Query | null;
+};
+/** BlockNote block array stored in the envelope (opaque JSON). */
+export type RichDocBlock = {
+    id: string;
+    type: string;
+    props?: Record<string, unknown>;
+    content?: unknown;
+    children?: RichDocBlock[];
+};
+export type StudioRichDocV1 = {
+    format: "blocknote";
+    version: 1;
+    blocks: RichDocBlock[];
+};
+export declare const RICH_DOC_FORMAT: "blocknote";
+export declare const RICH_DOC_VERSION: 1;
+export declare const EMPTY_BLOCK_ID = "00000000-0000-4000-8000-000000000001";
+export declare function emptyParagraphBlock(): RichDocBlock;
+export declare function parseRecordTableQueryJson(filterJson: string): Query | null;
+export declare function stringifyRecordTableQuery(query: Query | null): string;
+export declare function isBlockNoteEnvelope(parsed: unknown): parsed is StudioRichDocV1;
+/** Canonical empty rich document (BlockNote envelope). */
+export declare const EMPTY_RICH_DOC: string;
+/** @deprecated Alias for EMPTY_RICH_DOC — markdown fields use BlockNote storage. */
+export declare const EMPTY_MARKDOWN_DOC: string;
+export declare function isValidRichFieldJson(value: string): boolean;
+/** @deprecated Alias */
+export declare const isValidMarkdownDocJson: typeof isValidRichFieldJson;
+/**
+ * Placeholder URL scheme BlockNote accepts for inline links. Stored JSON uses `doc:slug`;
+ * the editor/preview need a normal https href so BlockNote does not strip the attribute.
+ */
+export declare const COLUMNUS_DOC_LINK_MARKER = "https://__columnus_doc__/";
+/** @deprecated Use COLUMNUS_DOC_LINK_MARKER */
+export declare const STUDIO_DOC_LINK_MARKER = "https://__columnus_doc__/";
+/** BlockNote markdown only accepts known URL schemes; rewrite doc: links before parse. */
+export declare function preprocessDocLinksInMarkdown(markdown: string): string;
+/** Rewrite `doc:` hrefs for BlockNote display (editor/preview). */
+export declare function preprocessDocLinksInBlocks(blocks: RichDocBlock[]): RichDocBlock[];
+/** Restore `doc:` hrefs when serializing from BlockNote back to storage. */
+export declare function postprocessDocLinksInBlocks(blocks: RichDocBlock[]): RichDocBlock[];
+/** Clone stored blocks and rewrite doc links for BlockNote. */
+export declare function blocksForBlockNoteDisplay(blocks: RichDocBlock[]): RichDocBlock[];
+/** Canonical stored JSON for a field value. */
+export declare function canonicalRichFieldJson(value: unknown): string;
+export declare function parseRichDocBlocks(value: unknown): RichDocBlock[];
+export declare function stringifyRichDoc(blocks: RichDocBlock[]): string;
+export declare function normalizeRichField(value: unknown): string;
+/** Wrap plain text as a single BlockNote paragraph (CSV import / paste). */
+export declare function wrapPlainTextAsRichDoc(text: string): string;
+/** @deprecated Alias */
+export declare const normalizeMarkdownField: typeof normalizeRichField;
+export declare function extractPlainText(value: unknown, maxLength?: number): string;
+export declare function collectRecordLinkIdsFromBlocks(blocks: RichDocBlock[]): Map<string, Set<string>>;
+export declare function collectRecordLinkIds(value: unknown): Map<string, Set<string>>;
+/** Parse doc cross-links from markdown hrefs. Supports `doc:slug` and relative `.md` paths. */
+export declare function parseDocLinkHref(href: string): string | null;