@columnus/shared 0.1.47

package/dist/fieldValueEqual.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fieldValueEqual.ts"],"names":[],"mappings":"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","file":"fieldValueEqual.js","sourcesContent":["// Compare Convex field values for pending-edit diffing. Uses the same\n// JSON normalization as csv export so bigint/bytes compare consistently.\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n  let s = \"\";\n  for (const b of bytes) s += String.fromCharCode(b);\n  return btoa(s);\n}\n\nfunction jsonReplacer(_key: string, value: unknown): unknown {\n  if (typeof value === \"bigint\") return `${value.toString()}n`;\n  if (value instanceof Uint8Array) return { __bytes__: bytesToBase64(value) };\n  return value;\n}\n\nfunction normalizeForCompare(value: unknown): unknown {\n  if (value === undefined || value === null) return undefined;\n  return value;\n}\n\nfunction stableJsonEqual(a: unknown, b: unknown): boolean {\n  try {\n    return JSON.stringify(a, jsonReplacer) === JSON.stringify(b, jsonReplacer);\n  } catch {\n    return false;\n  }\n}\n\n/** True when two stored field values are equivalent (missing ≡ undefined). */\nexport function fieldValuesEqual(a: unknown, b: unknown): boolean {\n  const na = normalizeForCompare(a);\n  const nb = normalizeForCompare(b);\n  if (Object.is(na, nb)) return true;\n  if (na === undefined && nb === undefined) return true;\n\n  const ta = typeof na;\n  const tb = typeof nb;\n  if (ta !== tb) {\n    // bigint stored as string in some editors vs bigint on server\n    if (ta === \"bigint\" && tb === \"string\") {\n      const naBig = na as bigint;\n      const nbStr = nb as string;\n      return `${naBig.toString()}n` === nbStr || naBig.toString() === nbStr.replace(/n$/, \"\");\n    }\n    if (ta === \"string\" && tb === \"bigint\") {\n      const naStr = na as string;\n      const nbBig = nb as bigint;\n      return `${nbBig.toString()}n` === naStr || nbBig.toString() === naStr.replace(/n$/, \"\");\n    }\n    return false;\n  }\n\n  if (ta === \"object\" && na !== null && nb !== null) {\n    return stableJsonEqual(na, nb);\n  }\n\n  return false;\n}\n\n/** Drop patch keys whose values match the server row baseline. */\nexport function filterChangedPatchFields(\n  patch: Record<string, unknown>,\n  baseline: Record<string, unknown> | undefined,\n): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(patch)) {\n    if (!fieldValuesEqual(value, baseline?.[key])) out[key] = value;\n  }\n  return out;\n}\n"]}

package/dist/importMatch.d.ts

@@ -0,0 +1,80 @@
+import type { DisplayIdLookup } from "./csv.ts";
+import { type ImportRow, type ParseResult } from "./csv.ts";
+import type { FieldType, Table } from "./schemaTypes.ts";
+export type ImportMatchKey = {
+    kind: "_id";
+    tableName: string;
+} | {
+    kind: "scalar";
+    fieldName: string;
+    fieldType: FieldType;
+} | {
+    kind: "id";
+    fieldName: string;
+    refTable: string;
+} | {
+    kind: "idArray";
+    fieldName: string;
+    refTable: string;
+};
+export type ImportStagingRow = ImportRow & {
+    /** Synthetic grid row id (`import-row-{rowNum}`). */
+    stagingId: string;
+};
+declare const MATCH_ERROR_KEY = "_match";
+export declare function importStagingId(rowNum: number): string;
+export declare function csvHasIdColumn(parsed: ParseResult): boolean;
+export declare function matchColumnsForTable(table: Table): ImportMatchColumn[];
+export type ImportMatchColumn = {
+    kind: "scalar";
+    fieldName: string;
+    fieldType: FieldType;
+    label: string;
+} | {
+    kind: "id";
+    fieldName: string;
+    refTable: string;
+    label: string;
+} | {
+    kind: "idArray";
+    fieldName: string;
+    refTable: string;
+    label: string;
+};
+export declare function defaultMatchColumn(table: Table): ImportMatchColumn | null;
+export declare function matchKeyFromColumn(col: ImportMatchColumn, _tableName: string): ImportMatchKey;
+export declare function patchMergeImportRow(existing: Record<string, unknown>, csvDoc: Record<string, unknown>, table: Table): Record<string, unknown>;
+export declare function normalizeMatchKeyFromValue(value: unknown, matchKey: ImportMatchKey, displayLookup: DisplayIdLookup): string;
+export declare function normalizeMatchKeyFromCsvRow(rawRow: Record<string, string>, matchKey: ImportMatchKey, displayLookup: DisplayIdLookup): string | null;
+export declare function collectMatchDisplayIdRefs(_table: Table, existingRows: Record<string, unknown>[], csvRows: Record<string, string>[], matchKey: ImportMatchKey): Map<string, Set<string>>;
+export declare function resolveImportMatches(args: {
+    table: Table;
+    parsed: ParseResult;
+    existingRows: Record<string, unknown>[];
+    matchKey: ImportMatchKey;
+    displayLookup: DisplayIdLookup;
+}): ImportStagingRow[];
+export declare function stagingRowsToGridRows(staging: ImportStagingRow[]): Record<string, unknown>[];
+export declare function mergeStagingPendingEdits(staging: ImportStagingRow[], pendingEdits: Map<string, Record<string, unknown>>): ImportStagingRow[];
+/** Recompute insert/replace mode and match errors after grid edits to match fields. */
+export declare function reconcileStagingMatchState(args: {
+    staging: ImportStagingRow[];
+    existingRows: Record<string, unknown>[];
+    matchKey: ImportMatchKey;
+    displayLookup: DisplayIdLookup;
+    parsed: ParseResult;
+    table: Table;
+}): ImportStagingRow[];
+/** Merge staging + pending edits, reconcile match mode, and revalidate for commit. */
+export declare function buildImportCommitRows(args: {
+    stagingRows: ImportStagingRow[];
+    pendingEdits: Map<string, Record<string, unknown>>;
+    table: Table;
+    parsed: ParseResult | null;
+    matchKey: ImportMatchKey | null;
+    existingRows: Record<string, unknown>[] | null;
+    displayLookup: DisplayIdLookup;
+}): ImportStagingRow[];
+export declare function revalidateStagingRow(row: ImportStagingRow, table: Table): ImportStagingRow;
+export declare function stagingRowToImportRow(row: ImportStagingRow): ImportRow;
+export { MATCH_ERROR_KEY };