@sixb/core 0.1.7 → 0.1.9

package/dist/{chunk-tn7xcs2n.js → chunk-860dwwy0.js}

@@ -1,20 +1,68 @@
 // @bun
 import {
-  isDecimalString
-} from "./chunk-04b07a9q.js";
+  isDecimalString2
+} from "./chunk-3bh94gbw.js";
 import {
-  isFileRef
-} from "./chunk-08m3b6w8.js";
+  isFileRef2
+} from "./chunk-h3v76ams.js";
 import {
-  isJsonValue,
+  isJsonValue2,
   isPlainRecord
-} from "./chunk-n6jxh8sw.js";
+} from "./chunk-wy0qdqfm.js";
 
 // src/datasets/errors.ts
-class DatasetValidationError extends Error {
+class DatasetValidationError2 extends Error {
   name = "DatasetValidationError";
 }
 
+// src/datasets/sequence.ts
+var MIN_INT64 = -(1n << 63n);
+var MAX_INT64 = (1n << 63n) - 1n;
+function datasetSequenceValue(dataset, value) {
+  const column = dataset.schema.columns.find((column) => column.name === dataset.sequenceBy);
+  if (column?.type === "int64") {
+    if (typeof value === "number" && Number.isSafeInteger(value) || typeof value === "string" && /^-?\d+$/.test(value)) {
+      const integer = BigInt(value);
+      if (integer >= MIN_INT64 && integer <= MAX_INT64)
+        return integer;
+    }
+    throw new Error(`Dataset '${dataset.id}' sequence must be a signed int64; use a string outside the safe integer range.`);
+  }
+  if (column?.type === "timestamp") {
+    const millis = parseDatasetTimestamp(value);
+    if (millis !== null)
+      return BigInt(millis);
+    throw new Error(`Dataset '${dataset.id}' sequence must be a valid Date or ISO timestamp with an explicit timezone and at most millisecond precision.`);
+  }
+  throw new Error(`Dataset '${dataset.id}' sequenceBy must reference a non-nullable timestamp or int64 column.`);
+}
+function parseDatasetTimestamp(value) {
+  if (value instanceof Date && Number.isFinite(value.getTime()))
+    return value.getTime();
+  if (typeof value === "string") {
+    const match = /^([+-]\d{6}|\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,3}))?(Z|[+-]\d{2}:\d{2})$/.exec(value);
+    if (match) {
+      const [, year, month, day, hour, minute, second, , zone] = match;
+      const numericYear = Number(year);
+      const leapYear = numericYear % 4 === 0 && (numericYear % 100 !== 0 || numericYear % 400 === 0);
+      const days = Number(month) === 2 ? leapYear ? 29 : 28 : [4, 6, 9, 11].includes(Number(month)) ? 30 : 31;
+      const validZone = zone === "Z" || Number(zone?.slice(1, 3)) <= 23 && Number(zone?.slice(4)) <= 59;
+      const millis = Date.parse(value);
+      if (Number(month) >= 1 && Number(month) <= 12 && Number(day) >= 1 && Number(day) <= days && Number(hour) < 24 && Number(minute) < 60 && Number(second) < 60 && validZone && Number.isFinite(millis))
+        return millis;
+    }
+  }
+  return null;
+}
+function getDatasetSequenceValidationError(dataset, value) {
+  try {
+    datasetSequenceValue(dataset, value);
+    return null;
+  } catch (error) {
+    return error instanceof Error ? error.message : String(error);
+  }
+}
+
 // src/datasets/validation.ts
 var datasetColumnTypes = new Set([
   "string",
@@ -50,15 +98,15 @@ function matchesColumnType(value, type) {
     case "float64":
       return typeof value === "number" && Number.isFinite(value);
     case "decimal":
-      return isDecimalString(value);
+      return isDecimalString2(value);
     case "date":
       return isValidDateValue(value) || isDateString(value);
     case "timestamp":
       return isValidDateValue(value) || isTimestampString(value);
     case "json":
-      return isJsonValue(value);
+      return isJsonValue2(value);
     case "fileRef":
-      return isFileRef(value);
+      return isFileRef2(value);
   }
 }
 function assertNonEmptyString(value, field, createError) {
@@ -125,7 +173,7 @@ function assertDatasetPrimaryKey(primaryKey, schema, createError) {
     }
   }
 }
-function assertDatasetDefinition(definition, createError = (message) => new DatasetValidationError(message)) {
+function assertDatasetDefinition2(definition, createError = (message) => new DatasetValidationError2(message)) {
   if (!isRecord(definition)) {
     throw createError("Dataset definition must be an object.");
   }
@@ -137,6 +185,12 @@ function assertDatasetDefinition(definition, createError = (message) => new Data
   if (definition.primaryKey !== undefined) {
     assertDatasetPrimaryKey(definition.primaryKey, definition.schema, createError);
   }
+  if (definition.sequenceBy !== undefined) {
+    const column = definition.schema.columns.find((column) => column.name === definition.sequenceBy);
+    if (definition.primaryKey === undefined || !column || column.nullable || !["timestamp", "int64"].includes(column.type)) {
+      throw createError("Dataset sequenceBy requires a primaryKey and a non-nullable timestamp or int64 column.");
+    }
+  }
   if (definition.partitionBy !== undefined) {
     if (!Array.isArray(definition.partitionBy)) {
       throw createError("Dataset partitionBy must be an array of column names.");
@@ -153,15 +207,15 @@ function assertDatasetDefinition(definition, createError = (message) => new Data
     throw createError("Dataset description must be a string.");
   }
 }
-function isDatasetDefinition(value) {
+function isDatasetDefinition2(value) {
   try {
-    assertDatasetDefinition(value, (message) => new Error(message));
+    assertDatasetDefinition2(value, (message) => new Error(message));
     return true;
   } catch {
     return false;
   }
 }
-function getDatasetRowValidationError(row, dataset, options) {
+function getDatasetRowValidationError2(row, dataset, options) {
   if (!isPlainRecord(row)) {
     return `Dataset '${dataset.id}' rows must be plain objects.`;
   }
@@ -195,6 +249,9 @@ function getDatasetRowValidationError(row, dataset, options) {
 function getColumnValidationError(row, column, dataset) {
   const hasValue = Object.hasOwn(row, column.name);
   const value = row[column.name];
+  if (column.name === dataset.sequenceBy) {
+    return getDatasetSequenceValidationError(dataset, value);
+  }
   if (!hasValue || value === undefined) {
     if (!column.nullable) {
       return `Dataset '${dataset.id}' row is missing required column '${column.name}'.`;
@@ -207,6 +264,9 @@ function getColumnValidationError(row, column, dataset) {
     }
     return null;
   }
+  if (dataset.sequenceBy !== undefined && column.type === "timestamp") {
+    return parseDatasetTimestamp(value) === null ? `Dataset '${dataset.id}' column '${column.name}' must be a valid Date or ISO timestamp with an explicit timezone and at most millisecond precision.` : null;
+  }
   if (!matchesColumnType(value, column.type)) {
     return `Dataset '${dataset.id}' column '${column.name}' must match type '${column.type}'.`;
   }
@@ -214,18 +274,18 @@ function getColumnValidationError(row, column, dataset) {
 }
 
 // src/datasets/builders.ts
-function col(name, type, options) {
+function col2(name, type, options) {
   const column = {
     name,
     type,
     ...options?.nullable !== undefined ? { nullable: options.nullable } : {}
   };
-  assertDatasetColumnDefinition(column, (message) => new DatasetValidationError(message));
+  assertDatasetColumnDefinition(column, (message) => new DatasetValidationError2(message));
   return column;
 }
 function assertDatasetId(id) {
   if (!id.trim()) {
-    throw new DatasetValidationError("Dataset id must not be empty.");
+    throw new DatasetValidationError2("Dataset id must not be empty.");
   }
 }
 function createDatasetDefinition(id, options) {
@@ -239,40 +299,42 @@ function createDatasetDefinition(id, options) {
       primaryKey: Array.isArray(options.primaryKey) ? [...options.primaryKey] : options.primaryKey
     } : {},
     ...options.partitionBy !== undefined ? { partitionBy: [...options.partitionBy] } : {},
+    ...options.sequenceBy !== undefined ? { sequenceBy: options.sequenceBy } : {},
     ...options.description !== undefined ? { description: options.description } : {}
   };
-  assertDatasetDefinition(definition, (message) => new DatasetValidationError(message));
+  assertDatasetDefinition2(definition, (message) => new DatasetValidationError2(message));
   return definition;
 }
 function assertStringArray(value, field) {
   if (!Array.isArray(value)) {
-    throw new DatasetValidationError(`${field} must be an array of column names.`);
+    throw new DatasetValidationError2(`${field} must be an array of column names.`);
   }
   for (const item of value) {
     if (typeof item !== "string" || !item.trim()) {
-      throw new DatasetValidationError(`${field} must contain only non-empty column names.`);
+      throw new DatasetValidationError2(`${field} must contain only non-empty column names.`);
     }
   }
 }
 function deriveDatasetDefinition(id, parent, options = {}) {
-  assertDatasetDefinition(parent, (message) => new DatasetValidationError(message));
+  assertDatasetDefinition2(parent, (message) => new DatasetValidationError2(message));
   if (options.pick !== undefined) {
     assertStringArray(options.pick, "Dataset derive pick");
   }
   if (options.add !== undefined && !Array.isArray(options.add)) {
-    throw new DatasetValidationError("Dataset derive add must be an array of columns.");
+    throw new DatasetValidationError2("Dataset derive add must be an array of columns.");
   }
   const parentColumnsByName = new Map(parent.schema.columns.map((column) => [column.name, column]));
   const pickedColumns = options.pick === undefined ? parent.schema.columns : options.pick.map((columnName) => {
     const column = parentColumnsByName.get(columnName);
     if (column === undefined) {
-      throw new DatasetValidationError(`Dataset derive pick column '${columnName}' is not declared on parent dataset '${parent.id}'.`);
+      throw new DatasetValidationError2(`Dataset derive pick column '${columnName}' is not declared on parent dataset '${parent.id}'.`);
     }
     return column;
   });
   return createDatasetDefinition(id, {
     schema: [...pickedColumns, ...options.add ?? []],
     ...options.primaryKey !== undefined ? { primaryKey: options.primaryKey } : {},
+    ...options.sequenceBy !== undefined ? { sequenceBy: options.sequenceBy } : {},
     ...options.partitionBy !== undefined ? { partitionBy: options.partitionBy } : {},
     ...options.description !== undefined ? { description: options.description } : {}
   });
@@ -284,7 +346,7 @@ function createDatasetDeriveBuilder(id) {
   }
   return { derive };
 }
-function defineDataset(id, options) {
+function defineDataset2(id, options) {
   if (options === undefined) {
     return createDatasetDeriveBuilder(id);
   }
@@ -292,14 +354,15 @@ function defineDataset(id, options) {
 }
 
 // src/datasets/changes.ts
-var change = {
+var change2 = {
   upsert(row) {
     return { kind: "upsert", row };
   },
-  delete(key) {
-    return { kind: "delete", key };
-  }
+  delete: deleteChange
 };
-export { DatasetValidationError, assertDatasetDefinition, isDatasetDefinition, getDatasetRowValidationError, col, defineDataset, change };
+function deleteChange(key, options) {
+  return { kind: "delete", key, ...options ? { sequence: options.sequence } : {} };
+}
+export { DatasetValidationError2, datasetSequenceValue, getDatasetSequenceValidationError, assertDatasetDefinition2, isDatasetDefinition2, getDatasetRowValidationError2, col2, defineDataset2, change2 };
 
-//# debugId=5BD3A97C32D4B31E64756E2164756E21
+//# debugId=BCF2A8CF0204048364756E2164756E21

package/dist/chunk-860dwwy0.js.map

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/datasets/errors.ts", "../src/datasets/sequence.ts", "../src/datasets/validation.ts", "../src/datasets/builders.ts", "../src/datasets/changes.ts"],
+  "sourcesContent": [
+    "export class DatasetValidationError extends Error {\n  readonly name = \"DatasetValidationError\"\n}\n",
+    "import type { DatasetDefinition } from \"./types\"\n\nconst MIN_INT64 = -(1n << 63n)\nconst MAX_INT64 = (1n << 63n) - 1n\n\n/** Normalize source ordering to an exact integer (timestamp milliseconds or signed int64). */\nexport function datasetSequenceValue(dataset: DatasetDefinition, value: unknown): bigint {\n  const column = dataset.schema.columns.find((column) => column.name === dataset.sequenceBy)\n  if (column?.type === \"int64\") {\n    if (\n      (typeof value === \"number\" && Number.isSafeInteger(value)) ||\n      (typeof value === \"string\" && /^-?\\d+$/.test(value))\n    ) {\n      const integer = BigInt(value)\n      if (integer >= MIN_INT64 && integer <= MAX_INT64) return integer\n    }\n    throw new Error(\n      `Dataset '${dataset.id}' sequence must be a signed int64; use a string outside the safe integer range.`\n    )\n  }\n  if (column?.type === \"timestamp\") {\n    const millis = parseDatasetTimestamp(value)\n    if (millis !== null) return BigInt(millis)\n    throw new Error(\n      `Dataset '${dataset.id}' sequence must be a valid Date or ISO timestamp with an explicit timezone and at most millisecond precision.`\n    )\n  }\n  throw new Error(\n    `Dataset '${dataset.id}' sequenceBy must reference a non-nullable timestamp or int64 column.`\n  )\n}\n\n/** Date.parse alone normalizes impossible calendar dates instead of rejecting them. */\nexport function parseDatasetTimestamp(value: unknown): number | null {\n  if (value instanceof Date && Number.isFinite(value.getTime())) return value.getTime()\n  if (typeof value === \"string\") {\n    const match =\n      /^([+-]\\d{6}|\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,3}))?(Z|[+-]\\d{2}:\\d{2})$/.exec(\n        value\n      )\n    if (match) {\n      const [, year, month, day, hour, minute, second, , zone] = match\n      const numericYear = Number(year)\n      const leapYear = numericYear % 4 === 0 && (numericYear % 100 !== 0 || numericYear % 400 === 0)\n      const days =\n        Number(month) === 2 ? (leapYear ? 29 : 28) : [4, 6, 9, 11].includes(Number(month)) ? 30 : 31\n      const validZone =\n        zone === \"Z\" || (Number(zone?.slice(1, 3)) <= 23 && Number(zone?.slice(4)) <= 59)\n      const millis = Date.parse(value)\n      if (\n        Number(month) >= 1 &&\n        Number(month) <= 12 &&\n        Number(day) >= 1 &&\n        Number(day) <= days &&\n        Number(hour) < 24 &&\n        Number(minute) < 60 &&\n        Number(second) < 60 &&\n        validZone &&\n        Number.isFinite(millis)\n      )\n        return millis\n    }\n  }\n  return null\n}\n\nexport function getDatasetSequenceValidationError(\n  dataset: DatasetDefinition,\n  value: unknown\n): string | null {\n  try {\n    datasetSequenceValue(dataset, value)\n    return null\n  } catch (error) {\n    return error instanceof Error ? error.message : String(error)\n  }\n}\n",
+    "import { isFileRef } from \"../blob-storage\"\nimport { isJsonValue, isPlainRecord } from \"../json\"\nimport { isDecimalString } from \"../ontology/decimal\"\nimport { DatasetValidationError } from \"./errors\"\nimport { getDatasetSequenceValidationError, parseDatasetTimestamp } from \"./sequence\"\nimport type {\n  DatasetColumnDefinition,\n  DatasetColumnType,\n  DatasetDefinition,\n  DatasetSchema,\n} from \"./types\"\n\nconst datasetColumnTypes = new Set<DatasetColumnType>([\n  \"string\",\n  \"boolean\",\n  \"int64\",\n  \"float64\",\n  \"decimal\",\n  \"date\",\n  \"timestamp\",\n  \"json\",\n  \"fileRef\",\n])\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n\nfunction isValidDateValue(value: unknown): boolean {\n  return value instanceof Date && !Number.isNaN(value.getTime())\n}\n\nfunction isDateString(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    /^\\d{4}-\\d{2}-\\d{2}$/.test(value) &&\n    !Number.isNaN(Date.parse(value))\n  )\n}\n\nfunction isTimestampString(value: unknown): value is string {\n  return typeof value === \"string\" && !Number.isNaN(Date.parse(value))\n}\n\nfunction matchesColumnType(value: unknown, type: DatasetColumnType): boolean {\n  switch (type) {\n    case \"string\":\n      return typeof value === \"string\"\n    case \"boolean\":\n      return typeof value === \"boolean\"\n    case \"int64\":\n      return (\n        (typeof value === \"number\" && Number.isInteger(value)) ||\n        (typeof value === \"string\" && /^-?\\d+$/.test(value))\n      )\n    case \"float64\":\n      return typeof value === \"number\" && Number.isFinite(value)\n    case \"decimal\":\n      return isDecimalString(value)\n    case \"date\":\n      return isValidDateValue(value) || isDateString(value)\n    case \"timestamp\":\n      return isValidDateValue(value) || isTimestampString(value)\n    case \"json\":\n      return isJsonValue(value)\n    case \"fileRef\":\n      return isFileRef(value)\n  }\n}\n\nfunction assertNonEmptyString(\n  value: unknown,\n  field: string,\n  createError: (message: string) => Error\n): asserts value is string {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw createError(`${field} must not be empty.`)\n  }\n}\n\nexport function assertDatasetColumnDefinition(\n  column: unknown,\n  createError: (message: string) => Error,\n  fieldPrefix = \"Dataset column\"\n): asserts column is DatasetColumnDefinition {\n  if (!isRecord(column)) {\n    throw createError(`${fieldPrefix} must be an object.`)\n  }\n\n  assertNonEmptyString(column.name, `${fieldPrefix} name`, createError)\n\n  if (!datasetColumnTypes.has(column.type as DatasetColumnType)) {\n    throw createError(\n      `${fieldPrefix} '${column.name}' has an invalid type '${String(column.type)}'.`\n    )\n  }\n\n  if (column.nullable !== undefined && typeof column.nullable !== \"boolean\") {\n    throw createError(`${fieldPrefix} '${column.name}' nullable must be a boolean.`)\n  }\n}\n\nfunction assertDatasetSchema(\n  schema: unknown,\n  createError: (message: string) => Error\n): asserts schema is DatasetSchema {\n  if (!isRecord(schema) || !Array.isArray(schema.columns)) {\n    throw createError(\"Dataset definitions must declare a schema.\")\n  }\n\n  const seenColumnNames = new Set<string>()\n  for (const column of schema.columns) {\n    assertDatasetColumnDefinition(column, createError)\n\n    if (seenColumnNames.has(column.name)) {\n      throw createError(`Dataset schema contains a duplicate column '${column.name}'.`)\n    }\n\n    seenColumnNames.add(column.name)\n  }\n}\n\nfunction assertDatasetPrimaryKey(\n  primaryKey: unknown,\n  schema: DatasetSchema,\n  createError: (message: string) => Error\n): void {\n  let keyColumns: readonly unknown[]\n  if (typeof primaryKey === \"string\") {\n    keyColumns = [primaryKey]\n  } else if (Array.isArray(primaryKey)) {\n    if (primaryKey.length < 2) {\n      throw createError(\n        \"Dataset primaryKey arrays must contain at least two column names. Use a string for a single-column key.\"\n      )\n    }\n    keyColumns = primaryKey\n  } else {\n    throw createError(\n      \"Dataset primaryKey must be a column name or an array of at least two column names.\"\n    )\n  }\n\n  const columnsByName = new Map(schema.columns.map((column) => [column.name, column] as const))\n  const seenColumnNames = new Set<string>()\n\n  for (const columnName of keyColumns) {\n    if (typeof columnName !== \"string\" || columnName.trim().length === 0) {\n      throw createError(\"Dataset primaryKey columns must be non-empty strings.\")\n    }\n\n    if (seenColumnNames.has(columnName)) {\n      throw createError(`Dataset primaryKey contains duplicate column '${columnName}'.`)\n    }\n    seenColumnNames.add(columnName)\n\n    const column = columnsByName.get(columnName)\n    if (column === undefined) {\n      throw createError(`Dataset primaryKey column '${columnName}' is not declared in the schema.`)\n    }\n    if (column.type !== \"string\") {\n      throw createError(`Dataset primaryKey column '${columnName}' must have type 'string'.`)\n    }\n    if (column.nullable === true) {\n      throw createError(`Dataset primaryKey column '${columnName}' must not be nullable.`)\n    }\n  }\n}\n\nexport function assertDatasetDefinition(\n  definition: unknown,\n  createError: (message: string) => Error = (message) => new DatasetValidationError(message)\n): asserts definition is DatasetDefinition {\n  if (!isRecord(definition)) {\n    throw createError(\"Dataset definition must be an object.\")\n  }\n\n  if (definition.kind !== \"dataset\") {\n    throw createError(\"Dataset definition kind must be 'dataset'.\")\n  }\n\n  assertNonEmptyString(definition.id, \"Dataset id\", createError)\n  assertDatasetSchema(definition.schema, createError)\n\n  if (definition.primaryKey !== undefined) {\n    assertDatasetPrimaryKey(definition.primaryKey, definition.schema, createError)\n  }\n\n  if (definition.sequenceBy !== undefined) {\n    const column = definition.schema.columns.find((column) => column.name === definition.sequenceBy)\n    if (\n      definition.primaryKey === undefined ||\n      !column ||\n      column.nullable ||\n      ![\"timestamp\", \"int64\"].includes(column.type)\n    ) {\n      throw createError(\n        \"Dataset sequenceBy requires a primaryKey and a non-nullable timestamp or int64 column.\"\n      )\n    }\n  }\n\n  if (definition.partitionBy !== undefined) {\n    if (!Array.isArray(definition.partitionBy)) {\n      throw createError(\"Dataset partitionBy must be an array of column names.\")\n    }\n\n    const columnNames = new Set(definition.schema.columns.map((column) => column.name))\n    for (const columnName of definition.partitionBy) {\n      assertNonEmptyString(columnName, \"Dataset partition column\", createError)\n      if (!columnNames.has(columnName)) {\n        throw createError(`Dataset partition column '${columnName}' is not declared in the schema.`)\n      }\n    }\n  }\n\n  if (definition.description !== undefined && typeof definition.description !== \"string\") {\n    throw createError(\"Dataset description must be a string.\")\n  }\n}\n\nexport function isDatasetDefinition(value: unknown): value is DatasetDefinition {\n  try {\n    assertDatasetDefinition(value, (message) => new Error(message))\n    return true\n  } catch {\n    return false\n  }\n}\n\nexport function getDatasetRowValidationError(\n  row: unknown,\n  dataset: DatasetDefinition,\n  options?: { readonly columns?: Iterable<string> }\n): string | null {\n  if (!isPlainRecord(row)) {\n    return `Dataset '${dataset.id}' rows must be plain objects.`\n  }\n\n  const columnsByName = new Map(\n    dataset.schema.columns.map((column) => [column.name, column] as const)\n  )\n\n  // When `columns` is provided, validate only that subset (e.g. the columns a\n  // projection actually maps). Projection reads are column-pruned, so the row\n  // never carries unmapped columns and must not be checked against them.\n  if (options?.columns !== undefined) {\n    const columnsToValidate = new Set(options.columns)\n    for (const column of dataset.schema.columns) {\n      if (!columnsToValidate.has(column.name)) {\n        continue\n      }\n\n      const error = getColumnValidationError(row, column, dataset)\n      if (error) {\n        return error\n      }\n    }\n\n    return null\n  }\n\n  for (const columnName of Object.keys(row)) {\n    if (!columnsByName.has(columnName)) {\n      return `Dataset '${dataset.id}' row contains unknown column '${columnName}'.`\n    }\n  }\n\n  for (const column of dataset.schema.columns) {\n    const error = getColumnValidationError(row, column, dataset)\n    if (error) {\n      return error\n    }\n  }\n\n  return null\n}\n\nfunction getColumnValidationError(\n  row: Record<string, unknown>,\n  column: DatasetColumnDefinition,\n  dataset: DatasetDefinition\n): string | null {\n  const hasValue = Object.hasOwn(row, column.name)\n  const value = row[column.name]\n  if (column.name === dataset.sequenceBy) {\n    return getDatasetSequenceValidationError(dataset, value)\n  }\n\n  // Treat `undefined` the same as an omitted field so callers either send a real\n  // value or use `null` explicitly on nullable columns.\n  if (!hasValue || value === undefined) {\n    if (!column.nullable) {\n      return `Dataset '${dataset.id}' row is missing required column '${column.name}'.`\n    }\n    return null\n  }\n\n  if (value === null) {\n    if (!column.nullable) {\n      return `Dataset '${dataset.id}' column '${column.name}' does not allow null values.`\n    }\n    return null\n  }\n\n  // Every timestamp contributes to a sequenced row's millisecond-precision content digest.\n  // Reject ambiguous or lossy values before staging, even when another column orders the row.\n  if (dataset.sequenceBy !== undefined && column.type === \"timestamp\") {\n    return parseDatasetTimestamp(value) === null\n      ? `Dataset '${dataset.id}' column '${column.name}' must be a valid Date or ISO timestamp with an explicit timezone and at most millisecond precision.`\n      : null\n  }\n\n  if (!matchesColumnType(value, column.type)) {\n    return `Dataset '${dataset.id}' column '${column.name}' must match type '${column.type}'.`\n  }\n\n  return null\n}\n",
+    "import { DatasetValidationError } from \"./errors\"\nimport type {\n  DatasetColumnDefinition,\n  DatasetColumnNameOf,\n  DatasetColumnType,\n  DatasetDefinition,\n  DatasetPrimaryKey,\n} from \"./types\"\nimport { assertDatasetColumnDefinition, assertDatasetDefinition } from \"./validation\"\n\ntype DatasetColumnOptions = {\n  readonly nullable?: boolean\n}\n\ntype DefineDatasetOptions = {\n  readonly schema: readonly DatasetColumnDefinition[]\n  readonly primaryKey?: DatasetPrimaryKey\n  readonly sequenceBy?: string\n  readonly partitionBy?: readonly string[]\n  readonly description?: string\n}\n\ntype DeriveDatasetOptions<TParent extends DatasetDefinition> = {\n  readonly pick?: readonly DatasetColumnNameOf<TParent>[]\n  readonly add?: readonly DatasetColumnDefinition[]\n  readonly primaryKey?: DatasetPrimaryKey\n  readonly sequenceBy?: string\n  readonly partitionBy?: readonly string[]\n  readonly description?: string\n}\n\ntype FieldFromOptions<TOptions, TKey extends string, TFallback> = TOptions extends {\n  readonly [K in TKey]: infer TValue\n}\n  ? TValue extends TFallback\n    ? { readonly [K in TKey]: TValue }\n    : { readonly [K in TKey]?: TFallback }\n  : { readonly [K in TKey]?: TFallback }\n\ntype ColumnNameOf<TColumns extends readonly DatasetColumnDefinition[]> = TColumns[number][\"name\"]\n\ntype ColumnDefinitionOf<\n  TColumns extends readonly DatasetColumnDefinition[],\n  TName extends ColumnNameOf<TColumns>,\n> = Extract<TColumns[number], { readonly name: TName }>\n\ntype PrimaryKeyColumnNameOf<TColumns extends readonly DatasetColumnDefinition[]> =\n  string extends ColumnNameOf<TColumns>\n    ? string\n    : {\n        [TName in ColumnNameOf<TColumns>]: ColumnDefinitionOf<\n          TColumns,\n          TName\n        >[\"type\"] extends \"string\"\n          ? ColumnDefinitionOf<TColumns, TName> extends { readonly nullable: true }\n            ? never\n            : TName\n          : never\n      }[ColumnNameOf<TColumns>]\n\ntype CheckedDefineDatasetOptions<TOptions extends DefineDatasetOptions> = TOptions & {\n  readonly primaryKey?: DatasetPrimaryKey<PrimaryKeyColumnNameOf<TOptions[\"schema\"]>>\n  readonly sequenceBy?: SequenceColumnNameOf<TOptions[\"schema\"]>\n}\n\ntype SequenceColumnNameOf<TColumns extends readonly DatasetColumnDefinition[]> =\n  string extends ColumnNameOf<TColumns>\n    ? string\n    : {\n        [TName in ColumnNameOf<TColumns>]: ColumnDefinitionOf<TColumns, TName>[\"type\"] extends\n          | \"timestamp\"\n          | \"int64\"\n          ? ColumnDefinitionOf<TColumns, TName> extends { readonly nullable: true }\n            ? never\n            : TName\n          : never\n      }[ColumnNameOf<TColumns>]\n\ntype PickColumns<\n  TColumns extends readonly DatasetColumnDefinition[],\n  TNames extends readonly ColumnNameOf<TColumns>[],\n> = TNames extends readonly [infer THead, ...infer TTail]\n  ? THead extends ColumnNameOf<TColumns>\n    ? TTail extends readonly ColumnNameOf<TColumns>[]\n      ? readonly [ColumnDefinitionOf<TColumns, THead>, ...PickColumns<TColumns, TTail>]\n      : never\n    : never\n  : TNames extends readonly []\n    ? readonly []\n    : readonly ColumnDefinitionOf<TColumns, TNames[number]>[]\n\ntype AddColumns<\n  TColumns extends readonly DatasetColumnDefinition[],\n  TAdd extends readonly DatasetColumnDefinition[],\n> = readonly [...TColumns, ...TAdd]\n\ntype DerivedBaseColumns<\n  TParent extends DatasetDefinition,\n  TOptions extends DeriveDatasetOptions<TParent> | undefined,\n> = TOptions extends { readonly pick: infer TPick }\n  ? TPick extends readonly DatasetColumnNameOf<TParent>[]\n    ? PickColumns<TParent[\"schema\"][\"columns\"], TPick>\n    : TParent[\"schema\"][\"columns\"]\n  : TParent[\"schema\"][\"columns\"]\n\ntype DerivedColumns<\n  TParent extends DatasetDefinition,\n  TOptions extends DeriveDatasetOptions<TParent> | undefined,\n> = TOptions extends { readonly add: infer TAdd }\n  ? TAdd extends readonly DatasetColumnDefinition[]\n    ? AddColumns<DerivedBaseColumns<TParent, TOptions>, TAdd>\n    : DerivedBaseColumns<TParent, TOptions>\n  : DerivedBaseColumns<TParent, TOptions>\n\ntype DatasetColumnResult<\n  TName extends string,\n  TType extends DatasetColumnType,\n  TOptions extends DatasetColumnOptions | undefined,\n> = {\n  readonly name: TName\n  readonly type: TType\n} & FieldFromOptions<TOptions, \"nullable\", boolean>\n\ntype DatasetDefinitionResult<TId extends string, TOptions extends DefineDatasetOptions> = Omit<\n  DatasetDefinition<TId, TOptions[\"schema\"]>,\n  \"primaryKey\" | \"sequenceBy\" | \"partitionBy\" | \"description\"\n> &\n  FieldFromOptions<TOptions, \"sequenceBy\", string> &\n  FieldFromOptions<TOptions, \"primaryKey\", DatasetPrimaryKey> &\n  FieldFromOptions<TOptions, \"partitionBy\", readonly string[]> &\n  FieldFromOptions<TOptions, \"description\", string>\n\ntype DerivedDatasetDefinitionResult<\n  TId extends string,\n  TParent extends DatasetDefinition,\n  TOptions extends DeriveDatasetOptions<TParent> | undefined,\n> = Omit<\n  DatasetDefinition<TId, DerivedColumns<TParent, TOptions>>,\n  \"primaryKey\" | \"sequenceBy\" | \"partitionBy\" | \"description\"\n> &\n  FieldFromOptions<TOptions, \"sequenceBy\", string> &\n  FieldFromOptions<TOptions, \"primaryKey\", DatasetPrimaryKey> &\n  FieldFromOptions<TOptions, \"partitionBy\", readonly string[]> &\n  FieldFromOptions<TOptions, \"description\", string>\n\ntype CheckedDeriveDatasetOptions<\n  TParent extends DatasetDefinition,\n  TOptions extends DeriveDatasetOptions<TParent>,\n> = TOptions & {\n  readonly primaryKey?: DatasetPrimaryKey<PrimaryKeyColumnNameOf<DerivedColumns<TParent, TOptions>>>\n  readonly sequenceBy?: SequenceColumnNameOf<DerivedColumns<TParent, TOptions>>\n}\n\nexport function col<const TName extends string, const TType extends DatasetColumnType>(\n  name: TName,\n  type: TType\n): DatasetColumnResult<TName, TType, undefined>\nexport function col<\n  const TName extends string,\n  const TType extends DatasetColumnType,\n  const TOptions extends DatasetColumnOptions,\n>(name: TName, type: TType, options: TOptions): DatasetColumnResult<TName, TType, TOptions>\nexport function col(\n  name: string,\n  type: DatasetColumnType,\n  options?: DatasetColumnOptions\n): DatasetColumnDefinition {\n  const column: DatasetColumnDefinition = {\n    name,\n    type,\n    ...(options?.nullable !== undefined ? { nullable: options.nullable } : {}),\n  }\n\n  assertDatasetColumnDefinition(column, (message) => new DatasetValidationError(message))\n  return column\n}\n\nfunction assertDatasetId(id: string): void {\n  if (!id.trim()) {\n    throw new DatasetValidationError(\"Dataset id must not be empty.\")\n  }\n}\n\nfunction createDatasetDefinition(id: string, options: DefineDatasetOptions): DatasetDefinition {\n  const definition: unknown = {\n    kind: \"dataset\",\n    id,\n    schema: {\n      columns: [...options.schema],\n    },\n    ...(options.primaryKey !== undefined\n      ? {\n          primaryKey: Array.isArray(options.primaryKey)\n            ? [...options.primaryKey]\n            : options.primaryKey,\n        }\n      : {}),\n    ...(options.partitionBy !== undefined ? { partitionBy: [...options.partitionBy] } : {}),\n    ...(options.sequenceBy !== undefined ? { sequenceBy: options.sequenceBy } : {}),\n    ...(options.description !== undefined ? { description: options.description } : {}),\n  }\n\n  assertDatasetDefinition(definition, (message) => new DatasetValidationError(message))\n  return definition\n}\n\nfunction assertStringArray(value: unknown, field: string): asserts value is readonly string[] {\n  if (!Array.isArray(value)) {\n    throw new DatasetValidationError(`${field} must be an array of column names.`)\n  }\n\n  for (const item of value) {\n    if (typeof item !== \"string\" || !item.trim()) {\n      throw new DatasetValidationError(`${field} must contain only non-empty column names.`)\n    }\n  }\n}\n\nfunction deriveDatasetDefinition(\n  id: string,\n  parent: DatasetDefinition,\n  options: DeriveDatasetOptions<DatasetDefinition> = {}\n): DatasetDefinition {\n  assertDatasetDefinition(parent, (message) => new DatasetValidationError(message))\n\n  if (options.pick !== undefined) {\n    assertStringArray(options.pick, \"Dataset derive pick\")\n  }\n\n  if (options.add !== undefined && !Array.isArray(options.add)) {\n    throw new DatasetValidationError(\"Dataset derive add must be an array of columns.\")\n  }\n\n  const parentColumnsByName = new Map(\n    parent.schema.columns.map((column) => [column.name, column] as const)\n  )\n  const pickedColumns =\n    options.pick === undefined\n      ? parent.schema.columns\n      : options.pick.map((columnName) => {\n          const column = parentColumnsByName.get(columnName)\n          if (column === undefined) {\n            throw new DatasetValidationError(\n              `Dataset derive pick column '${columnName}' is not declared on parent dataset '${parent.id}'.`\n            )\n          }\n          return column\n        })\n\n  return createDatasetDefinition(id, {\n    schema: [...pickedColumns, ...(options.add ?? [])],\n    ...(options.primaryKey !== undefined ? { primaryKey: options.primaryKey } : {}),\n    ...(options.sequenceBy !== undefined ? { sequenceBy: options.sequenceBy } : {}),\n    ...(options.partitionBy !== undefined ? { partitionBy: options.partitionBy } : {}),\n    ...(options.description !== undefined ? { description: options.description } : {}),\n  })\n}\n\nfunction createDatasetDeriveBuilder<TId extends string>(id: TId) {\n  assertDatasetId(id)\n\n  function derive<const TParent extends DatasetDefinition>(\n    parent: TParent\n  ): DerivedDatasetDefinitionResult<TId, TParent, undefined>\n  function derive<\n    const TParent extends DatasetDefinition,\n    const TOptions extends DeriveDatasetOptions<TParent>,\n  >(\n    parent: TParent,\n    options: CheckedDeriveDatasetOptions<TParent, TOptions>\n  ): DerivedDatasetDefinitionResult<TId, TParent, TOptions>\n  function derive(\n    parent: DatasetDefinition,\n    options?: DeriveDatasetOptions<DatasetDefinition>\n  ): DatasetDefinition {\n    return deriveDatasetDefinition(id, parent, options)\n  }\n\n  return { derive }\n}\n\nexport function defineDataset<const TId extends string>(\n  id: TId\n): ReturnType<typeof createDatasetDeriveBuilder<TId>>\nexport function defineDataset<\n  const TId extends string,\n  const TOptions extends DefineDatasetOptions,\n>(id: TId, options: CheckedDefineDatasetOptions<TOptions>): DatasetDefinitionResult<TId, TOptions>\nexport function defineDataset(\n  id: string,\n  options?: DefineDatasetOptions\n): DatasetDefinition | ReturnType<typeof createDatasetDeriveBuilder<string>> {\n  if (options === undefined) {\n    return createDatasetDeriveBuilder(id)\n  }\n\n  return createDatasetDefinition(id, options)\n}\n",
+    "export type MergeChange<Row, Key> =\n  | { readonly kind: \"upsert\"; readonly row: Row }\n  | { readonly kind: \"delete\"; readonly key: Key; readonly sequence?: string | number | Date }\n\nexport const change = {\n  upsert<const Row extends object>(row: Row): { readonly kind: \"upsert\"; readonly row: Row } {\n    return { kind: \"upsert\", row }\n  },\n\n  delete: deleteChange,\n}\n\nfunction deleteChange<const Key extends object>(\n  key: Key\n): { readonly kind: \"delete\"; readonly key: Key }\nfunction deleteChange<const Key extends object, const Sequence extends string | number | Date>(\n  key: Key,\n  options: { readonly sequence: Sequence }\n): { readonly kind: \"delete\"; readonly key: Key; readonly sequence: Sequence }\nfunction deleteChange<Key extends object>(\n  key: Key,\n  options?: { readonly sequence: string | number | Date }\n): { readonly kind: \"delete\"; readonly key: Key; readonly sequence?: string | number | Date } {\n  return { kind: \"delete\", key, ...(options ? { sequence: options.sequence } : {}) }\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;AAAO,MAAM,gCAA+B,MAAM;AAAA,EACvC,OAAO;AAClB;;;ACAA,IAAM,YAAY,EAAE,MAAM;AAC1B,IAAM,aAAa,MAAM,OAAO;AAGzB,SAAS,oBAAoB,CAAC,SAA4B,OAAwB;AAAA,EACvF,MAAM,SAAS,QAAQ,OAAO,QAAQ,KAAK,CAAC,WAAW,OAAO,SAAS,QAAQ,UAAU;AAAA,EACzF,IAAI,QAAQ,SAAS,SAAS;AAAA,IAC5B,IACG,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KACvD,OAAO,UAAU,YAAY,UAAU,KAAK,KAAK,GAClD;AAAA,MACA,MAAM,UAAU,OAAO,KAAK;AAAA,MAC5B,IAAI,WAAW,aAAa,WAAW;AAAA,QAAW,OAAO;AAAA,IAC3D;AAAA,IACA,MAAM,IAAI,MACR,YAAY,QAAQ,mFACtB;AAAA,EACF;AAAA,EACA,IAAI,QAAQ,SAAS,aAAa;AAAA,IAChC,MAAM,SAAS,sBAAsB,KAAK;AAAA,IAC1C,IAAI,WAAW;AAAA,MAAM,OAAO,OAAO,MAAM;AAAA,IACzC,MAAM,IAAI,MACR,YAAY,QAAQ,iHACtB;AAAA,EACF;AAAA,EACA,MAAM,IAAI,MACR,YAAY,QAAQ,yEACtB;AAAA;AAIK,SAAS,qBAAqB,CAAC,OAA+B;AAAA,EACnE,IAAI,iBAAiB,QAAQ,OAAO,SAAS,MAAM,QAAQ,CAAC;AAAA,IAAG,OAAO,MAAM,QAAQ;AAAA,EACpF,IAAI,OAAO,UAAU,UAAU;AAAA,IAC7B,MAAM,QACJ,iGAAiG,KAC/F,KACF;AAAA,IACF,IAAI,OAAO;AAAA,MACT,SAAS,MAAM,OAAO,KAAK,MAAM,QAAQ,UAAU,QAAQ;AAAA,MAC3D,MAAM,cAAc,OAAO,IAAI;AAAA,MAC/B,MAAM,WAAW,cAAc,MAAM,MAAM,cAAc,QAAQ,KAAK,cAAc,QAAQ;AAAA,MAC5F,MAAM,OACJ,OAAO,KAAK,MAAM,IAAK,WAAW,KAAK,KAAM,CAAC,GAAG,GAAG,GAAG,EAAE,EAAE,SAAS,OAAO,KAAK,CAAC,IAAI,KAAK;AAAA,MAC5F,MAAM,YACJ,SAAS,OAAQ,OAAO,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,MAAM,OAAO,MAAM,MAAM,CAAC,CAAC,KAAK;AAAA,MAChF,MAAM,SAAS,KAAK,MAAM,KAAK;AAAA,MAC/B,IACE,OAAO,KAAK,KAAK,KACjB,OAAO,KAAK,KAAK,MACjB,OAAO,GAAG,KAAK,KACf,OAAO,GAAG,KAAK,QACf,OAAO,IAAI,IAAI,MACf,OAAO,MAAM,IAAI,MACjB,OAAO,MAAM,IAAI,MACjB,aACA,OAAO,SAAS,MAAM;AAAA,QAEtB,OAAO;AAAA,IACX;AAAA,EACF;AAAA,EACA,OAAO;AAAA;AAGF,SAAS,iCAAiC,CAC/C,SACA,OACe;AAAA,EACf,IAAI;AAAA,IACF,qBAAqB,SAAS,KAAK;AAAA,IACnC,OAAO;AAAA,IACP,OAAO,OAAO;AAAA,IACd,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA;AAAA;;;AC9DhE,IAAM,qBAAqB,IAAI,IAAuB;AAAA,EACpD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,OAAkD;AAAA,EAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAAA;AAG5E,SAAS,gBAAgB,CAAC,OAAyB;AAAA,EACjD,OAAO,iBAAiB,QAAQ,CAAC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAAA;AAG/D,SAAS,YAAY,CAAC,OAAiC;AAAA,EACrD,OACE,OAAO,UAAU,YACjB,sBAAsB,KAAK,KAAK,KAChC,CAAC,OAAO,MAAM,KAAK,MAAM,KAAK,CAAC;AAAA;AAInC,SAAS,iBAAiB,CAAC,OAAiC;AAAA,EAC1D,OAAO,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,KAAK,MAAM,KAAK,CAAC;AAAA;AAGrE,SAAS,iBAAiB,CAAC,OAAgB,MAAkC;AAAA,EAC3E,QAAQ;AAAA,SACD;AAAA,MACH,OAAO,OAAO,UAAU;AAAA,SACrB;AAAA,MACH,OAAO,OAAO,UAAU;AAAA,SACrB;AAAA,MACH,OACG,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KACnD,OAAO,UAAU,YAAY,UAAU,KAAK,KAAK;AAAA,SAEjD;AAAA,MACH,OAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAAA,SACtD;AAAA,MACH,OAAO,iBAAgB,KAAK;AAAA,SACzB;AAAA,MACH,OAAO,iBAAiB,KAAK,KAAK,aAAa,KAAK;AAAA,SACjD;AAAA,MACH,OAAO,iBAAiB,KAAK,KAAK,kBAAkB,KAAK;AAAA,SACtD;AAAA,MACH,OAAO,aAAY,KAAK;AAAA,SACrB;AAAA,MACH,OAAO,WAAU,KAAK;AAAA;AAAA;AAI5B,SAAS,oBAAoB,CAC3B,OACA,OACA,aACyB;AAAA,EACzB,IAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GAAG;AAAA,IAC1D,MAAM,YAAY,GAAG,0BAA0B;AAAA,EACjD;AAAA;AAGK,SAAS,6BAA6B,CAC3C,QACA,aACA,cAAc,kBAC6B;AAAA,EAC3C,IAAI,CAAC,SAAS,MAAM,GAAG;AAAA,IACrB,MAAM,YAAY,GAAG,gCAAgC;AAAA,EACvD;AAAA,EAEA,qBAAqB,OAAO,MAAM,GAAG,oBAAoB,WAAW;AAAA,EAEpE,IAAI,CAAC,mBAAmB,IAAI,OAAO,IAAyB,GAAG;AAAA,IAC7D,MAAM,YACJ,GAAG,gBAAgB,OAAO,8BAA8B,OAAO,OAAO,IAAI,KAC5E;AAAA,EACF;AAAA,EAEA,IAAI,OAAO,aAAa,aAAa,OAAO,OAAO,aAAa,WAAW;AAAA,IACzE,MAAM,YAAY,GAAG,gBAAgB,OAAO,mCAAmC;AAAA,EACjF;AAAA;AAGF,SAAS,mBAAmB,CAC1B,QACA,aACiC;AAAA,EACjC,IAAI,CAAC,SAAS,MAAM,KAAK,CAAC,MAAM,QAAQ,OAAO,OAAO,GAAG;AAAA,IACvD,MAAM,YAAY,4CAA4C;AAAA,EAChE;AAAA,EAEA,MAAM,kBAAkB,IAAI;AAAA,EAC5B,WAAW,UAAU,OAAO,SAAS;AAAA,IACnC,8BAA8B,QAAQ,WAAW;AAAA,IAEjD,IAAI,gBAAgB,IAAI,OAAO,IAAI,GAAG;AAAA,MACpC,MAAM,YAAY,+CAA+C,OAAO,QAAQ;AAAA,IAClF;AAAA,IAEA,gBAAgB,IAAI,OAAO,IAAI;AAAA,EACjC;AAAA;AAGF,SAAS,uBAAuB,CAC9B,YACA,QACA,aACM;AAAA,EACN,IAAI;AAAA,EACJ,IAAI,OAAO,eAAe,UAAU;AAAA,IAClC,aAAa,CAAC,UAAU;AAAA,EAC1B,EAAO,SAAI,MAAM,QAAQ,UAAU,GAAG;AAAA,IACpC,IAAI,WAAW,SAAS,GAAG;AAAA,MACzB,MAAM,YACJ,yGACF;AAAA,IACF;AAAA,IACA,aAAa;AAAA,EACf,EAAO;AAAA,IACL,MAAM,YACJ,oFACF;AAAA;AAAA,EAGF,MAAM,gBAAgB,IAAI,IAAI,OAAO,QAAQ,IAAI,CAAC,WAAW,CAAC,OAAO,MAAM,MAAM,CAAU,CAAC;AAAA,EAC5F,MAAM,kBAAkB,IAAI;AAAA,EAE5B,WAAW,cAAc,YAAY;AAAA,IACnC,IAAI,OAAO,eAAe,YAAY,WAAW,KAAK,EAAE,WAAW,GAAG;AAAA,MACpE,MAAM,YAAY,uDAAuD;AAAA,IAC3E;AAAA,IAEA,IAAI,gBAAgB,IAAI,UAAU,GAAG;AAAA,MACnC,MAAM,YAAY,iDAAiD,cAAc;AAAA,IACnF;AAAA,IACA,gBAAgB,IAAI,UAAU;AAAA,IAE9B,MAAM,SAAS,cAAc,IAAI,UAAU;AAAA,IAC3C,IAAI,WAAW,WAAW;AAAA,MACxB,MAAM,YAAY,8BAA8B,4CAA4C;AAAA,IAC9F;AAAA,IACA,IAAI,OAAO,SAAS,UAAU;AAAA,MAC5B,MAAM,YAAY,8BAA8B,sCAAsC;AAAA,IACxF;AAAA,IACA,IAAI,OAAO,aAAa,MAAM;AAAA,MAC5B,MAAM,YAAY,8BAA8B,mCAAmC;AAAA,IACrF;AAAA,EACF;AAAA;AAGK,SAAS,wBAAuB,CACrC,YACA,cAA0C,CAAC,YAAY,IAAI,wBAAuB,OAAO,GAChD;AAAA,EACzC,IAAI,CAAC,SAAS,UAAU,GAAG;AAAA,IACzB,MAAM,YAAY,uCAAuC;AAAA,EAC3D;AAAA,EAEA,IAAI,WAAW,SAAS,WAAW;AAAA,IACjC,MAAM,YAAY,4CAA4C;AAAA,EAChE;AAAA,EAEA,qBAAqB,WAAW,IAAI,cAAc,WAAW;AAAA,EAC7D,oBAAoB,WAAW,QAAQ,WAAW;AAAA,EAElD,IAAI,WAAW,eAAe,WAAW;AAAA,IACvC,wBAAwB,WAAW,YAAY,WAAW,QAAQ,WAAW;AAAA,EAC/E;AAAA,EAEA,IAAI,WAAW,eAAe,WAAW;AAAA,IACvC,MAAM,SAAS,WAAW,OAAO,QAAQ,KAAK,CAAC,WAAW,OAAO,SAAS,WAAW,UAAU;AAAA,IAC/F,IACE,WAAW,eAAe,aAC1B,CAAC,UACD,OAAO,YACP,CAAC,CAAC,aAAa,OAAO,EAAE,SAAS,OAAO,IAAI,GAC5C;AAAA,MACA,MAAM,YACJ,wFACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,IAAI,WAAW,gBAAgB,WAAW;AAAA,IACxC,IAAI,CAAC,MAAM,QAAQ,WAAW,WAAW,GAAG;AAAA,MAC1C,MAAM,YAAY,uDAAuD;AAAA,IAC3E;AAAA,IAEA,MAAM,cAAc,IAAI,IAAI,WAAW,OAAO,QAAQ,IAAI,CAAC,WAAW,OAAO,IAAI,CAAC;AAAA,IAClF,WAAW,cAAc,WAAW,aAAa;AAAA,MAC/C,qBAAqB,YAAY,4BAA4B,WAAW;AAAA,MACxE,IAAI,CAAC,YAAY,IAAI,UAAU,GAAG;AAAA,QAChC,MAAM,YAAY,6BAA6B,4CAA4C;AAAA,MAC7F;AAAA,IACF;AAAA,EACF;AAAA,EAEA,IAAI,WAAW,gBAAgB,aAAa,OAAO,WAAW,gBAAgB,UAAU;AAAA,IACtF,MAAM,YAAY,uCAAuC;AAAA,EAC3D;AAAA;AAGK,SAAS,oBAAmB,CAAC,OAA4C;AAAA,EAC9E,IAAI;AAAA,IACF,yBAAwB,OAAO,CAAC,YAAY,IAAI,MAAM,OAAO,CAAC;AAAA,IAC9D,OAAO;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA;AAAA;AAIJ,SAAS,6BAA4B,CAC1C,KACA,SACA,SACe;AAAA,EACf,IAAI,CAAC,cAAc,GAAG,GAAG;AAAA,IACvB,OAAO,YAAY,QAAQ;AAAA,EAC7B;AAAA,EAEA,MAAM,gBAAgB,IAAI,IACxB,QAAQ,OAAO,QAAQ,IAAI,CAAC,WAAW,CAAC,OAAO,MAAM,MAAM,CAAU,CACvE;AAAA,EAKA,IAAI,SAAS,YAAY,WAAW;AAAA,IAClC,MAAM,oBAAoB,IAAI,IAAI,QAAQ,OAAO;AAAA,IACjD,WAAW,UAAU,QAAQ,OAAO,SAAS;AAAA,MAC3C,IAAI,CAAC,kBAAkB,IAAI,OAAO,IAAI,GAAG;AAAA,QACvC;AAAA,MACF;AAAA,MAEA,MAAM,QAAQ,yBAAyB,KAAK,QAAQ,OAAO;AAAA,MAC3D,IAAI,OAAO;AAAA,QACT,OAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,OAAO;AAAA,EACT;AAAA,EAEA,WAAW,cAAc,OAAO,KAAK,GAAG,GAAG;AAAA,IACzC,IAAI,CAAC,cAAc,IAAI,UAAU,GAAG;AAAA,MAClC,OAAO,YAAY,QAAQ,oCAAoC;AAAA,IACjE;AAAA,EACF;AAAA,EAEA,WAAW,UAAU,QAAQ,OAAO,SAAS;AAAA,IAC3C,MAAM,QAAQ,yBAAyB,KAAK,QAAQ,OAAO;AAAA,IAC3D,IAAI,OAAO;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAGT,SAAS,wBAAwB,CAC/B,KACA,QACA,SACe;AAAA,EACf,MAAM,WAAW,OAAO,OAAO,KAAK,OAAO,IAAI;AAAA,EAC/C,MAAM,QAAQ,IAAI,OAAO;AAAA,EACzB,IAAI,OAAO,SAAS,QAAQ,YAAY;AAAA,IACtC,OAAO,kCAAkC,SAAS,KAAK;AAAA,EACzD;AAAA,EAIA,IAAI,CAAC,YAAY,UAAU,WAAW;AAAA,IACpC,IAAI,CAAC,OAAO,UAAU;AAAA,MACpB,OAAO,YAAY,QAAQ,uCAAuC,OAAO;AAAA,IAC3E;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,UAAU,MAAM;AAAA,IAClB,IAAI,CAAC,OAAO,UAAU;AAAA,MACpB,OAAO,YAAY,QAAQ,eAAe,OAAO;AAAA,IACnD;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EAIA,IAAI,QAAQ,eAAe,aAAa,OAAO,SAAS,aAAa;AAAA,IACnE,OAAO,sBAAsB,KAAK,MAAM,OACpC,YAAY,QAAQ,eAAe,OAAO,6GAC1C;AAAA,EACN;AAAA,EAEA,IAAI,CAAC,kBAAkB,OAAO,OAAO,IAAI,GAAG;AAAA,IAC1C,OAAO,YAAY,QAAQ,eAAe,OAAO,0BAA0B,OAAO;AAAA,EACpF;AAAA,EAEA,OAAO;AAAA;;;AC3JF,SAAS,IAAG,CACjB,MACA,MACA,SACyB;AAAA,EACzB,MAAM,SAAkC;AAAA,IACtC;AAAA,IACA;AAAA,OACI,SAAS,aAAa,YAAY,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,EAC1E;AAAA,EAEA,8BAA8B,QAAQ,CAAC,YAAY,IAAI,wBAAuB,OAAO,CAAC;AAAA,EACtF,OAAO;AAAA;AAGT,SAAS,eAAe,CAAC,IAAkB;AAAA,EACzC,IAAI,CAAC,GAAG,KAAK,GAAG;AAAA,IACd,MAAM,IAAI,wBAAuB,+BAA+B;AAAA,EAClE;AAAA;AAGF,SAAS,uBAAuB,CAAC,IAAY,SAAkD;AAAA,EAC7F,MAAM,aAAsB;AAAA,IAC1B,MAAM;AAAA,IACN;AAAA,IACA,QAAQ;AAAA,MACN,SAAS,CAAC,GAAG,QAAQ,MAAM;AAAA,IAC7B;AAAA,OACI,QAAQ,eAAe,YACvB;AAAA,MACE,YAAY,MAAM,QAAQ,QAAQ,UAAU,IACxC,CAAC,GAAG,QAAQ,UAAU,IACtB,QAAQ;AAAA,IACd,IACA,CAAC;AAAA,OACD,QAAQ,gBAAgB,YAAY,EAAE,aAAa,CAAC,GAAG,QAAQ,WAAW,EAAE,IAAI,CAAC;AAAA,OACjF,QAAQ,eAAe,YAAY,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;AAAA,OACzE,QAAQ,gBAAgB,YAAY,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;AAAA,EAClF;AAAA,EAEA,yBAAwB,YAAY,CAAC,YAAY,IAAI,wBAAuB,OAAO,CAAC;AAAA,EACpF,OAAO;AAAA;AAGT,SAAS,iBAAiB,CAAC,OAAgB,OAAmD;AAAA,EAC5F,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AAAA,IACzB,MAAM,IAAI,wBAAuB,GAAG,yCAAyC;AAAA,EAC/E;AAAA,EAEA,WAAW,QAAQ,OAAO;AAAA,IACxB,IAAI,OAAO,SAAS,YAAY,CAAC,KAAK,KAAK,GAAG;AAAA,MAC5C,MAAM,IAAI,wBAAuB,GAAG,iDAAiD;AAAA,IACvF;AAAA,EACF;AAAA;AAGF,SAAS,uBAAuB,CAC9B,IACA,QACA,UAAmD,CAAC,GACjC;AAAA,EACnB,yBAAwB,QAAQ,CAAC,YAAY,IAAI,wBAAuB,OAAO,CAAC;AAAA,EAEhF,IAAI,QAAQ,SAAS,WAAW;AAAA,IAC9B,kBAAkB,QAAQ,MAAM,qBAAqB;AAAA,EACvD;AAAA,EAEA,IAAI,QAAQ,QAAQ,aAAa,CAAC,MAAM,QAAQ,QAAQ,GAAG,GAAG;AAAA,IAC5D,MAAM,IAAI,wBAAuB,iDAAiD;AAAA,EACpF;AAAA,EAEA,MAAM,sBAAsB,IAAI,IAC9B,OAAO,OAAO,QAAQ,IAAI,CAAC,WAAW,CAAC,OAAO,MAAM,MAAM,CAAU,CACtE;AAAA,EACA,MAAM,gBACJ,QAAQ,SAAS,YACb,OAAO,OAAO,UACd,QAAQ,KAAK,IAAI,CAAC,eAAe;AAAA,IAC/B,MAAM,SAAS,oBAAoB,IAAI,UAAU;AAAA,IACjD,IAAI,WAAW,WAAW;AAAA,MACxB,MAAM,IAAI,wBACR,+BAA+B,kDAAkD,OAAO,MAC1F;AAAA,IACF;AAAA,IACA,OAAO;AAAA,GACR;AAAA,EAEP,OAAO,wBAAwB,IAAI;AAAA,IACjC,QAAQ,CAAC,GAAG,eAAe,GAAI,QAAQ,OAAO,CAAC,CAAE;AAAA,OAC7C,QAAQ,eAAe,YAAY,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;AAAA,OACzE,QAAQ,eAAe,YAAY,EAAE,YAAY,QAAQ,WAAW,IAAI,CAAC;AAAA,OACzE,QAAQ,gBAAgB,YAAY,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;AAAA,OAC5E,QAAQ,gBAAgB,YAAY,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;AAAA,EAClF,CAAC;AAAA;AAGH,SAAS,0BAA8C,CAAC,IAAS;AAAA,EAC/D,gBAAgB,EAAE;AAAA,EAYlB,SAAS,MAAM,CACb,QACA,SACmB;AAAA,IACnB,OAAO,wBAAwB,IAAI,QAAQ,OAAO;AAAA;AAAA,EAGpD,OAAO,EAAE,OAAO;AAAA;AAUX,SAAS,cAAa,CAC3B,IACA,SAC2E;AAAA,EAC3E,IAAI,YAAY,WAAW;AAAA,IACzB,OAAO,2BAA2B,EAAE;AAAA,EACtC;AAAA,EAEA,OAAO,wBAAwB,IAAI,OAAO;AAAA;;;ACpSrC,IAAM,UAAS;AAAA,EACpB,MAAgC,CAAC,KAA0D;AAAA,IACzF,OAAO,EAAE,MAAM,UAAU,IAAI;AAAA;AAAA,EAG/B,QAAQ;AACV;AASA,SAAS,YAAgC,CACvC,KACA,SAC4F;AAAA,EAC5F,OAAO,EAAE,MAAM,UAAU,QAAS,UAAU,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC,EAAG;AAAA;",
+  "debugId": "BCF2A8CF0204048364756E2164756E21",
+  "names": []
+}

package/dist/chunk-8vj0rjgs.js

@@ -0,0 +1,165 @@
+// @bun
+import {
+  createObjectOperationScope2
+} from "./chunk-z30bv4ga.js";
+import {
+  stableJsonStringify2
+} from "./chunk-wy0qdqfm.js";
+
+// src/storage/action-runs/idempotency.ts
+function actionSubjectsEqual2(left, right) {
+  if (left.kind !== right.kind)
+    return false;
+  if (left.kind === "none")
+    return true;
+  if (right.kind === "none")
+    return false;
+  return left.objectTypeId === right.objectTypeId && left.primaryId === right.primaryId;
+}
+function actionRunParamsEqual2(left, right) {
+  return stableJsonStringify2(left) === stableJsonStringify2(right);
+}
+function actionRunPhaseRecordsEqual2(left, right) {
+  return actionRunParamsEqual2(stripPhaseRecordCompletedAt(left), stripPhaseRecordCompletedAt(right));
+}
+function finishActionRunPhase2(input, current) {
+  if (input.status === "succeeded") {
+    return input.phase ?? current ?? "validation";
+  }
+  return input.error.details.phase;
+}
+function canRequeueActionRunAfterEnqueueFailure2(existing, input) {
+  return existing.status === "failed" && existing.phase === "enqueue" && existing.executionId === input.executionId && existing.error?.retryable === true && existing.actionId === input.actionId && existing.idempotencyKey === input.idempotencyKey && actionSubjectsEqual2(existing.subject, input.subject) && actionRunParamsEqual2(existing.params, input.params);
+}
+function isTerminalActionRun2(record) {
+  return record.status === "succeeded" || record.status === "failed" || record.status === "cancelled";
+}
+function stripPhaseRecordCompletedAt(record) {
+  const { completedAt: _completedAt, ...stableRecord } = record;
+  return stableRecord;
+}
+
+// src/storage/errors.ts
+class ObjectNotFoundError2 extends Error {
+  objectTypeId;
+  primaryId;
+  context;
+  name = "ObjectNotFoundError";
+  constructor(objectTypeId, primaryId, context) {
+    super(`[Sixb] ${context}: ${objectTypeId}:${primaryId}`);
+    this.objectTypeId = objectTypeId;
+    this.primaryId = primaryId;
+    this.context = context;
+  }
+}
+
+class ObjectStorageError2 extends Error {
+  name = "ObjectStorageError";
+}
+
+class StorageTransactionError2 extends Error {
+  name = "StorageTransactionError";
+  code;
+  cause;
+  constructor(message, options = {}) {
+    super(message);
+    this.code = options.code;
+    this.cause = options.cause;
+  }
+}
+function isStorageSerializationFailure2(error) {
+  return error instanceof StorageTransactionError2 && error.code === "serialization_failure";
+}
+
+// src/storage/file-upload-sessions/utils.ts
+import { randomUUID } from "crypto";
+var DEFAULT_FILE_UPLOAD_SESSION_TTL_MS2 = 60 * 60 * 1000;
+var DEFAULT_FILE_UPLOAD_TERMINAL_SESSION_TTL_MS2 = 15 * 60 * 1000;
+function createUploadExpiresAt2(now = Date.now()) {
+  return new Date(now + DEFAULT_FILE_UPLOAD_SESSION_TTL_MS2);
+}
+function createFileUploadId2() {
+  return `upload_${randomUUID().replaceAll("-", "")}`;
+}
+function principalKey(principal) {
+  return `${principal.type}:${principal.id}`;
+}
+function isFileUploadSessionExpired(session, nowMs = Date.now()) {
+  return session.status === "pending" && session.expiresAt.getTime() <= nowMs;
+}
+function shouldDeleteFileUploadSession(session, nowMs) {
+  if (isFileUploadSessionExpired(session, nowMs)) {
+    return true;
+  }
+  return isTerminalFileUploadSessionExpired(session, nowMs);
+}
+function isTerminalFileUploadSessionExpired(session, nowMs) {
+  if (session.status === "pending") {
+    return false;
+  }
+  const terminalAt = session.completedAt ?? session.abortedAt;
+  if (!terminalAt) {
+    return false;
+  }
+  return terminalAt.getTime() + DEFAULT_FILE_UPLOAD_TERMINAL_SESSION_TTL_MS2 <= nowMs;
+}
+
+// src/storage/pipeline-runs/idempotency.ts
+function canRequeuePipelineRunAfterEnqueueFailure2(existing, input) {
+  return existing.status === "failed" && existing.error?.code === "queue.enqueue_failed" && existing.error.retryable && existing.executionId === input.executionId && existing.pipelineId === input.pipelineId;
+}
+
+// src/storage/sync-runs/idempotency.ts
+function canRequeueSyncRunAfterEnqueueFailure2(existing, input) {
+  return existing.status === "failed" && existing.error?.code === "queue.enqueue_failed" && existing.error.retryable && existing.executionId === input.executionId && existing.syncId === input.syncId && existing.datasetId === input.datasetId && existing.mode === input.mode && existing.expectedLatestVersionId === input.expectedLatestVersionId && existing.commitMessage === input.commitMessage;
+}
+
+// src/storage/transaction.ts
+function createTransactionStorageProxy2(target, isActive) {
+  const proxies = new WeakMap;
+  const objectStorage = createObjectOperationScope2(target.objects, {
+    assertAvailable: () => assertTransactionActive2(isActive),
+    run: async (operation) => {
+      assertTransactionActive2(isActive);
+      return operation();
+    }
+  });
+  const wrap = (value) => {
+    const existing = proxies.get(value);
+    if (existing)
+      return existing;
+    const proxy = new Proxy(value, {
+      get(current, property, receiver) {
+        assertTransactionActive2(isActive);
+        const result = current === target && property === "objects" ? objectStorage : Reflect.get(current, property, receiver);
+        if (typeof result === "function") {
+          return (...args) => {
+            assertTransactionActive2(isActive);
+            return result.apply(current, args);
+          };
+        }
+        if (result && typeof result === "object") {
+          return wrap(result);
+        }
+        return result;
+      }
+    });
+    proxies.set(value, proxy);
+    return proxy;
+  };
+  return wrap(target);
+}
+function assertTransactionActive2(isActive) {
+  if (!isActive()) {
+    throw new StorageTransactionError2("[Sixb] Transaction storage cannot be used after transaction completion.", { code: "transaction_inactive" });
+  }
+}
+function throwNestedStorageTransaction2() {
+  throw new StorageTransactionError2("[Sixb] Nested storage transactions are not supported yet.", {
+    code: "nested_transaction"
+  });
+}
+
+export { actionSubjectsEqual2, actionRunParamsEqual2, actionRunPhaseRecordsEqual2, finishActionRunPhase2, canRequeueActionRunAfterEnqueueFailure2, isTerminalActionRun2, ObjectNotFoundError2, ObjectStorageError2, StorageTransactionError2, isStorageSerializationFailure2, DEFAULT_FILE_UPLOAD_SESSION_TTL_MS2, DEFAULT_FILE_UPLOAD_TERMINAL_SESSION_TTL_MS2, createUploadExpiresAt2, createFileUploadId2, principalKey, isFileUploadSessionExpired, shouldDeleteFileUploadSession, isTerminalFileUploadSessionExpired, canRequeuePipelineRunAfterEnqueueFailure2, canRequeueSyncRunAfterEnqueueFailure2, createTransactionStorageProxy2, assertTransactionActive2, throwNestedStorageTransaction2 };
+
+//# debugId=12590D3F659B1BAC64756E2164756E21

package/dist/chunk-8vj0rjgs.js.map

@@ -0,0 +1,15 @@
+{
+  "version": 3,
+  "sources": ["../src/storage/action-runs/idempotency.ts", "../src/storage/errors.ts", "../src/storage/file-upload-sessions/utils.ts", "../src/storage/pipeline-runs/idempotency.ts", "../src/storage/sync-runs/idempotency.ts", "../src/storage/transaction.ts"],
+  "sourcesContent": [
+    "import type { ActionSubject } from \"../../actions\"\nimport { stableJsonStringify } from \"../../json\"\nimport type {\n  ActionRunEffectsRecord,\n  ActionRunPhase,\n  ActionRunRecord,\n  ActionRunWritebackRecord,\n  FinishActionRunInput,\n  QueueActionRunInput,\n} from \"./types\"\n\nexport function actionSubjectsEqual(left: ActionSubject, right: ActionSubject): boolean {\n  if (left.kind !== right.kind) return false\n  if (left.kind === \"none\") return true\n  if (right.kind === \"none\") return false\n  return left.objectTypeId === right.objectTypeId && left.primaryId === right.primaryId\n}\n\nexport function actionRunParamsEqual(left: unknown, right: unknown): boolean {\n  return stableJsonStringify(left) === stableJsonStringify(right)\n}\n\nexport type ActionRunPhaseRecord = ActionRunWritebackRecord | ActionRunEffectsRecord\n\nexport function actionRunPhaseRecordsEqual(\n  left: ActionRunPhaseRecord,\n  right: ActionRunPhaseRecord\n): boolean {\n  return actionRunParamsEqual(stripPhaseRecordCompletedAt(left), stripPhaseRecordCompletedAt(right))\n}\n\nexport function finishActionRunPhase(\n  input: FinishActionRunInput,\n  current: ActionRunPhase | null | undefined\n): ActionRunPhase {\n  if (input.status === \"succeeded\") {\n    return input.phase ?? current ?? \"validation\"\n  }\n\n  return input.error.details.phase\n}\n\nexport function canRequeueActionRunAfterEnqueueFailure(\n  existing: ActionRunRecord,\n  input: QueueActionRunInput\n): boolean {\n  return (\n    existing.status === \"failed\" &&\n    existing.phase === \"enqueue\" &&\n    existing.executionId === input.executionId &&\n    existing.error?.retryable === true &&\n    existing.actionId === input.actionId &&\n    existing.idempotencyKey === input.idempotencyKey &&\n    actionSubjectsEqual(existing.subject, input.subject) &&\n    actionRunParamsEqual(existing.params, input.params)\n  )\n}\n\nexport function isTerminalActionRun(record: Pick<ActionRunRecord, \"status\">): boolean {\n  return (\n    record.status === \"succeeded\" || record.status === \"failed\" || record.status === \"cancelled\"\n  )\n}\n\nfunction stripPhaseRecordCompletedAt(\n  record: ActionRunPhaseRecord\n): Omit<ActionRunPhaseRecord, \"completedAt\"> {\n  const { completedAt: _completedAt, ...stableRecord } = record\n  return stableRecord\n}\n",
+    "/**\n * Thrown when a storage lookup by primary ID finds no matching object.\n * Carries structured context so callers can discriminate without string parsing.\n */\nexport class ObjectNotFoundError extends Error {\n  readonly name = \"ObjectNotFoundError\"\n\n  constructor(\n    readonly objectTypeId: string,\n    readonly primaryId: string,\n    readonly context: string\n  ) {\n    super(`[Sixb] ${context}: ${objectTypeId}:${primaryId}`)\n  }\n}\n\nexport class ObjectStorageError extends Error {\n  readonly name = \"ObjectStorageError\"\n}\n\nexport type StorageTransactionErrorCode =\n  | \"nested_transaction\"\n  | \"serialization_failure\"\n  | \"transaction_inactive\"\n\nexport interface StorageTransactionErrorOptions {\n  readonly cause?: unknown\n  readonly code?: StorageTransactionErrorCode\n}\n\nexport class StorageTransactionError extends Error {\n  readonly name = \"StorageTransactionError\"\n  readonly code?: StorageTransactionErrorCode\n  override readonly cause?: unknown\n\n  constructor(message: string, options: StorageTransactionErrorOptions = {}) {\n    super(message)\n    this.code = options.code\n    this.cause = options.cause\n  }\n}\n\nexport function isStorageSerializationFailure(error: unknown): boolean {\n  return error instanceof StorageTransactionError && error.code === \"serialization_failure\"\n}\n",
+    "import { randomUUID } from \"node:crypto\"\nimport type { Principal } from \"../../auth\"\nimport type { FileUploadSession } from \"./types\"\n\nexport const DEFAULT_FILE_UPLOAD_SESSION_TTL_MS = 60 * 60 * 1000\nexport const DEFAULT_FILE_UPLOAD_TERMINAL_SESSION_TTL_MS = 15 * 60 * 1000\n\nexport function createUploadExpiresAt(now = Date.now()): Date {\n  return new Date(now + DEFAULT_FILE_UPLOAD_SESSION_TTL_MS)\n}\n\nexport function createFileUploadId(): string {\n  return `upload_${randomUUID().replaceAll(\"-\", \"\")}`\n}\n\nexport function principalKey(principal: Principal): string {\n  return `${principal.type}:${principal.id}`\n}\n\nexport function isFileUploadSessionExpired(\n  session: FileUploadSession,\n  nowMs = Date.now()\n): boolean {\n  return session.status === \"pending\" && session.expiresAt.getTime() <= nowMs\n}\n\nexport function shouldDeleteFileUploadSession(session: FileUploadSession, nowMs: number): boolean {\n  if (isFileUploadSessionExpired(session, nowMs)) {\n    return true\n  }\n\n  return isTerminalFileUploadSessionExpired(session, nowMs)\n}\n\nexport function isTerminalFileUploadSessionExpired(\n  session: FileUploadSession,\n  nowMs: number\n): boolean {\n  if (session.status === \"pending\") {\n    return false\n  }\n\n  const terminalAt = session.completedAt ?? session.abortedAt\n  if (!terminalAt) {\n    return false\n  }\n\n  return terminalAt.getTime() + DEFAULT_FILE_UPLOAD_TERMINAL_SESSION_TTL_MS <= nowMs\n}\n",
+    "import type { PipelineRunRecord, QueuePipelineRunInput } from \"./types\"\n\nexport function canRequeuePipelineRunAfterEnqueueFailure(\n  existing: PipelineRunRecord,\n  input: QueuePipelineRunInput\n): boolean {\n  return (\n    existing.status === \"failed\" &&\n    existing.error?.code === \"queue.enqueue_failed\" &&\n    existing.error.retryable &&\n    existing.executionId === input.executionId &&\n    existing.pipelineId === input.pipelineId\n  )\n}\n",
+    "import type { QueueSyncRunInput, SyncRunRecord } from \"./types\"\n\nexport function canRequeueSyncRunAfterEnqueueFailure(\n  existing: SyncRunRecord,\n  input: QueueSyncRunInput\n): boolean {\n  return (\n    existing.status === \"failed\" &&\n    existing.error?.code === \"queue.enqueue_failed\" &&\n    existing.error.retryable &&\n    existing.executionId === input.executionId &&\n    existing.syncId === input.syncId &&\n    existing.datasetId === input.datasetId &&\n    existing.mode === input.mode &&\n    existing.expectedLatestVersionId === input.expectedLatestVersionId &&\n    existing.commitMessage === input.commitMessage\n  )\n}\n",
+    "import { StorageTransactionError } from \"./errors\"\nimport { createObjectOperationScope } from \"./operation-scope\"\nimport type { Storage } from \"./types\"\n\ntype ObjectLike = Record<PropertyKey, unknown>\n\nexport function createTransactionStorageProxy<T extends Storage>(\n  target: T,\n  isActive: () => boolean\n): T {\n  const proxies = new WeakMap<object, object>()\n  const objectStorage = createObjectOperationScope(target.objects, {\n    assertAvailable: () => assertTransactionActive(isActive),\n    run: async <TResult>(operation: () => Promise<TResult> | TResult): Promise<TResult> => {\n      assertTransactionActive(isActive)\n      return operation()\n    },\n  })\n\n  const wrap = <TValue extends object>(value: TValue): TValue => {\n    const existing = proxies.get(value)\n    if (existing) return existing as TValue\n\n    const proxy = new Proxy(value as ObjectLike, {\n      // The guard runs on property access and on call. Its purpose is to fail fast when a\n      // transaction handle (`tx`) leaks past the transaction's lifetime — using it afterward is a\n      // bug, not a recoverable state. Overhead is bounded: only the storage namespaces reachable\n      // from `tx` are wrapped (a handful), not the row/link data graph, and never per-record.\n      get(current, property, receiver) {\n        assertTransactionActive(isActive)\n        const result =\n          current === target && property === \"objects\"\n            ? objectStorage\n            : Reflect.get(current, property, receiver)\n        if (typeof result === \"function\") {\n          return (...args: unknown[]) => {\n            assertTransactionActive(isActive)\n            return result.apply(current, args)\n          }\n        }\n        if (result && typeof result === \"object\") {\n          return wrap(result)\n        }\n        return result\n      },\n    })\n\n    proxies.set(value, proxy)\n    return proxy as TValue\n  }\n\n  return wrap(target)\n}\n\nexport function assertTransactionActive(isActive: () => boolean): void {\n  if (!isActive()) {\n    throw new StorageTransactionError(\n      \"[Sixb] Transaction storage cannot be used after transaction completion.\",\n      { code: \"transaction_inactive\" }\n    )\n  }\n}\n\nexport function throwNestedStorageTransaction(): never {\n  throw new StorageTransactionError(\"[Sixb] Nested storage transactions are not supported yet.\", {\n    code: \"nested_transaction\",\n  })\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "12590D3F659B1BAC64756E2164756E21",
+  "names": []
+}