@oddington/sdk 0.1.9 → 0.1.11

package/README.md

@@ -299,9 +299,37 @@ Each graph selection sends one request and returns only selected canonical
 values, expanded forward links and exact opaque public versions. Cursors
 continue the exact retained artifact and collection selection, even after
 replacement; repeat its options and links while omitting unrelated collections.
-There is no automatic retry or separate version fetch. History is not included.
+There is no automatic retry or separate version fetch.
 Collection schemas omit Markdown storage hints.
 
+Read published History through the same inert repository handle:
+
+```ts
+const versions = await general.history.list({ limit: 50 });
+const older = versions.length
+  ? await general.history.list({ before: versions.at(-1)!.version }) : [];
+const close = await general.history.at('2026-10-09T16:30:00Z');
+```
+
+List returns an entry array in descending published sequence, with an exclusive
+visible `before` and a default limit of 50 (integer 1–100). Cutoff accepts a real
+RFC 3339 instant with an explicit offset and returns the greatest visible sequence
+published at or before it, or null. Entries contain exactly `version`, `publishedAt`,
+`author`, `authoredAt`, `committer`, `committedAt`, `message`, `created`, `updated`,
+and `deleted`. Git identities and complete messages are repository facts; changed
+refs are lexical. Versions are opaque published identities, never Git expressions.
+Each operation captures input before resolving authority and makes one request.
+Incomplete selected metadata fails the whole result retryably with `unavailable`;
+current Records remain independent. Hosted routines retain their captured ceiling
+until their own authoritative publication advances it. History is served through
+the member/run Data transport. Local apps and local routines use the same calls;
+their OS parent may acquire one bounded page or cutoff result, retain it against
+the exact repository target and published ceiling, and serve an identical warm
+request without another hosted call. Authority loss, expiry, target replacement
+or published-version replacement invalidates that retained result. Prepared local
+changes do not appear in published History.
+Historical Record selection and `history.changes` are not exposed by this slice.
+
 Use bounded plain-text lookup to find full Records and guards:
 
 ```ts

package/dist/browser.js

@@ -717,31 +717,84 @@ var DataOperationError = class extends Error {
 
 var invalid = () => {
   throw new DataOperationError("invalid_query");
-}, scalarText = (value) => typeof value == "string" && !/[\u0000\uD800-\uDFFF]/u.test(value);
+}, historyText = (value) => typeof value == "string" && !/[\u0000\uD800-\uDFFF]/u.test(value);
+function historyVersion(value) {
+  return historyText(value) && value.length > 0 && new TextEncoder().encode(value).length <= 1024 && !/[\u0000-\u001f\u007f-\u009f]/.test(value) && !/^[0-9a-f]{40}$/i.test(value);
+}
+function historyProperties(value) {
+  if (!value || typeof value != "object" || Array.isArray(value) || ![Object.prototype, null].includes(Object.getPrototypeOf(value))) return invalid();
+  let descriptors = Object.getOwnPropertyDescriptors(value);
+  return Reflect.ownKeys(value).some((key) => typeof key != "string" || !descriptors[key]?.enumerable || !Object.hasOwn(descriptors[key], "value")) ? invalid() : descriptors;
+}
+var historyCollection = (value) => typeof value == "string" && value.length <= 512 && /^[_a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(value), historyCursor = (value) => typeof value == "string" && value.length <= 128 * 1024 && /^history-cursor-v1\.[A-Za-z0-9_-]{1,64}\.[A-Za-z0-9_-]{16}\.[A-Za-z0-9_-]+$/.test(value);
+function historyArray(value) {
+  if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype) return invalid();
+  let descriptors = Object.getOwnPropertyDescriptors(value);
+  if (Reflect.ownKeys(value).length !== value.length + 1) return invalid();
+  let result2 = [];
+  for (let i = 0; i < value.length; i++) {
+    let descriptor2 = descriptors[i];
+    if (!descriptor2?.enumerable || !Object.hasOwn(descriptor2, "value")) return invalid();
+    result2.push(descriptor2.value);
+  }
+  return result2;
+}
+function captureOptions(value, changes) {
+  if (value === void 0) return {};
+  let descriptors = historyProperties(value), result2 = {}, allowed = changes ? ["collections", "refs", "from", "through", "limit", "after"] : ["limit", "before"];
+  if (Object.keys(descriptors).some((key) => !allowed.includes(key))) return invalid();
+  for (let key of allowed) {
+    if (!Object.hasOwn(descriptors, key)) continue;
+    let scalar = descriptors[key].value;
+    if (key === "collections" || key === "refs") {
+      let values = historyArray(scalar);
+      if (!values.length || values.length > (key === "collections" ? 16 : 100) || !values.every(key === "collections" ? historyCollection : validRecordRef) || new Set(values).size !== values.length) return invalid();
+      result2[key] = values;
+    } else if (key === "limit") {
+      if (!Number.isInteger(scalar) || scalar < 1 || scalar > (changes ? 500 : 100)) return invalid();
+      result2.limit = scalar;
+    } else {
+      if (!(key === "after" ? historyCursor(scalar) : historyVersion(scalar))) return invalid();
+      result2[key] = scalar;
+    }
+  }
+  return result2;
+}
+var captureHistoryListOptions = (value) => captureOptions(value, !1), captureHistoryChangesOptions = (value) => captureOptions(value, !0);
+function captureHistoryInstant(value) {
+  if (!historyText(value) || value.length > 1024) return invalid();
+  let match = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2}):(\d{2})(?:\.\d+)?([Zz]|([+-])(\d{2}):(\d{2}))$/.exec(value);
+  if (!match) return invalid();
+  let [year, month, day, hour, minute, second] = match.slice(1, 7).map(Number), days = new Date(Date.UTC(year, month, 0));
+  return days.setUTCFullYear(year), year < 1 || month < 1 || month > 12 || day < 1 || day > days.getUTCDate() || hour > 23 || minute > 59 || second > 59 || Number(match[9] ?? 0) > 23 || Number(match[10] ?? 0) > 59 ? invalid() : value;
+}
+
+var invalid2 = () => {
+  throw new DataOperationError("invalid_query");
+};
 function captureRecordsSearchInput(query, options) {
-  if (!scalarText(query)) return invalid();
+  if (!historyText(query)) return invalid2();
   let length = [...query.trim()].length;
-  if (length < 1 || length > 256) return invalid();
+  if (length < 1 || length > 256) return invalid2();
   if (options === void 0) return { query };
-  if (!options || typeof options != "object" || Array.isArray(options) || ![Object.prototype, null].includes(Object.getPrototypeOf(options))) return invalid();
-  let descriptors = Object.getOwnPropertyDescriptors(options);
-  if (Reflect.ownKeys(options).some((key) => typeof key != "string" || !["collections", "limit"].includes(key) || !descriptors[key]?.enumerable || !Object.hasOwn(descriptors[key], "value"))) return invalid();
+  let descriptors = historyProperties(options);
+  if (Object.keys(descriptors).some((key) => !["collections", "limit"].includes(key))) return invalid2();
   let captured = {};
   if (Object.hasOwn(descriptors, "collections")) {
     let supplied = descriptors.collections.value;
-    if (!Array.isArray(supplied) || supplied.length < 1 || supplied.length > 16 || Reflect.ownKeys(supplied).length !== supplied.length + 1) return invalid();
+    if (!Array.isArray(supplied) || supplied.length < 1 || supplied.length > 16 || Reflect.ownKeys(supplied).length !== supplied.length + 1) return invalid2();
     let collections = [];
     for (let index = 0; index < supplied.length; index++) {
       let descriptor2 = Object.getOwnPropertyDescriptor(supplied, String(index));
-      if (!descriptor2?.enumerable || !Object.hasOwn(descriptor2, "value") || !scalarText(descriptor2.value)) return invalid();
+      if (!descriptor2?.enumerable || !Object.hasOwn(descriptor2, "value") || !historyText(descriptor2.value)) return invalid2();
       collections.push(descriptor2.value);
     }
-    if (new Set(collections).size !== collections.length) return invalid();
+    if (new Set(collections).size !== collections.length) return invalid2();
     captured.collections = collections;
   }
   if (Object.hasOwn(descriptors, "limit")) {
     let supplied = descriptors.limit.value;
-    if (!Number.isInteger(supplied) || supplied < 1 || supplied > 100) return invalid();
+    if (!Number.isInteger(supplied) || supplied < 1 || supplied > 100) return invalid2();
     captured.limit = supplied;
   }
   return { query, options: captured };
@@ -751,7 +804,11 @@ var DATA_REQUEST_LIMIT = 256 * 1024, invalidChange = () => {
   throw new DataOperationError("invalid_change", !1, "unapplied");
 };
 function mapping(value) {
-  return !value || typeof value != "object" || Array.isArray(value) || ![Object.prototype, null].includes(Object.getPrototypeOf(value)) || Reflect.ownKeys(value).some((key) => typeof key != "string" || !Object.getOwnPropertyDescriptor(value, key)?.enumerable || !Object.hasOwn(Object.getOwnPropertyDescriptor(value, key), "value")) ? invalidChange() : value;
+  try {
+    return historyProperties(value), value;
+  } catch {
+    return invalidChange();
+  }
 }
 function captureValue(value, ancestors = /* @__PURE__ */ new Set(), depth = 0) {
   if (value === null || typeof value == "string" || typeof value == "boolean" || typeof value == "number" && Number.isFinite(value)) return value;
@@ -771,13 +828,18 @@ function captureDataUpdate(record2, set) {
   let identity = captureDataDelete(record2), fields3 = mapping(set);
   return !Object.keys(fields3).length || Object.keys(fields3).some((key) => key.startsWith("$") || ["id", "type"].includes(key)) ? invalidChange() : { ...identity, set: captureValue(fields3) };
 }
-function captureDataUpdates(value, allowEmpty = !1) {
+function captureIdentities(value, update, allowEmpty = !0) {
   if (!Array.isArray(value) || !allowEmpty && !value.length || value.length > 1e4) return invalidChange();
-  let updates = value.map((item) => {
+  let captured = value.map((item) => {
     let row = mapping(item);
-    return Object.keys(row).sort().join(",") !== "expectedVersion,ref,set" ? invalidChange() : captureDataUpdate({ $ref: row.ref, $version: row.expectedVersion }, row.set);
+    if (Object.keys(row).sort().join(",") !== (update ? "expectedVersion,ref,set" : "expectedVersion,ref")) return invalidChange();
+    let identity = { $ref: row.ref, $version: row.expectedVersion };
+    return update ? captureDataUpdate(identity, row.set) : captureDataDelete(identity);
   });
-  return new Set(updates.map((update) => update.ref)).size !== updates.length ? invalidChange() : updates;
+  return new Set(captured.map((item) => item.ref)).size !== captured.length ? invalidChange() : captured;
+}
+function captureDataUpdates(value, allowEmpty = !1) {
+  return captureIdentities(value, !0, allowEmpty);
 }
 function captureDataCreate(value) {
   let row = mapping(value);
@@ -800,12 +862,7 @@ function captureDataChanges(updatesValue, createsValue = [], deletesValue = [])
     if (Object.keys(row).some((key) => !["ref", "fields", "filing"].includes(key)) || !Object.hasOwn(row, "ref") || !Object.hasOwn(row, "fields")) return invalidChange();
     let fields3 = mapping(row.fields);
     return Object.keys(fields3).some((key) => key.startsWith("$")) ? invalidChange() : captureDataCreate({ ...fields3, $ref: row.ref, ...Object.hasOwn(row, "filing") ? { $filing: row.filing } : {} });
-  });
-  if (!Array.isArray(deletesValue) || deletesValue.length > 1e4) return invalidChange();
-  let deletes = deletesValue.map((item) => {
-    let row = mapping(item);
-    return Object.keys(row).sort().join(",") !== "expectedVersion,ref" ? invalidChange() : captureDataDelete({ $ref: row.ref, $version: row.expectedVersion });
-  }), refs = [...updates, ...creates, ...deletes].map((item) => item.ref);
+  }), deletes = captureIdentities(deletesValue, !1), refs = [...updates, ...creates, ...deletes].map((item) => item.ref);
   return !refs.length || refs.length > 1e4 || new Set(refs).size !== refs.length ? invalidChange() : { updates, creates, deletes };
 }
 function checkDataRequestSize(input) {
@@ -842,42 +899,42 @@ var FileOperationError = class extends Error {
   retryable;
 }, FILE_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/, FILE_ORIGINAL_MAX_BYTES = 5 * 1024 ** 3;
 function parseFileDescriptor(value) {
-  let invalid3 = () => {
+  let invalid4 = () => {
     throw new FileOperationError("unavailable", 503, !0);
   };
-  if (!value || typeof value != "object" || Array.isArray(value)) return invalid3();
+  if (!value || typeof value != "object" || Array.isArray(value)) return invalid4();
   let f = value;
-  if (Object.keys(f).sort().join(",") !== "details,enrichments,id,mediaType,name,path,sha256,size" || typeof f.id != "string" || !FILE_ID_PATTERN.test(f.id) || !safeFileName(f.name) || !safeFilePath(f.path) || !Number.isSafeInteger(f.size) || f.size < 0 || f.size > FILE_ORIGINAL_MAX_BYTES || typeof f.sha256 != "string" || !/^[0-9a-f]{64}$/.test(f.sha256) || !f.enrichments || typeof f.enrichments != "object" || Array.isArray(f.enrichments) || !f.details || typeof f.details != "object" || Array.isArray(f.details)) return invalid3();
+  if (Object.keys(f).sort().join(",") !== "details,enrichments,id,mediaType,name,path,sha256,size" || typeof f.id != "string" || !FILE_ID_PATTERN.test(f.id) || !safeFileName(f.name) || !safeFilePath(f.path) || !Number.isSafeInteger(f.size) || f.size < 0 || f.size > FILE_ORIGINAL_MAX_BYTES || typeof f.sha256 != "string" || !/^[0-9a-f]{64}$/.test(f.sha256) || !f.enrichments || typeof f.enrichments != "object" || Array.isArray(f.enrichments) || !f.details || typeof f.details != "object" || Array.isArray(f.details)) return invalid4();
   let d = f.details;
   if (d.kind === "other") {
-    if (Object.keys(d).length !== 1 || f.mediaType !== "application/octet-stream") return invalid3();
+    if (Object.keys(d).length !== 1 || f.mediaType !== "application/octet-stream") return invalid4();
   } else if (d.kind === "csv") {
-    if (Object.keys(d).sort().join(",") !== "dataRows,delimiter,encoding,headerRow,kind" || f.mediaType !== "text/csv" || !["utf-8", "windows-1252"].includes(d.encoding) || ![",", ";", "	"].includes(d.delimiter) || !Number.isSafeInteger(d.headerRow) || d.headerRow < 1 || !Number.isSafeInteger(d.dataRows) || d.dataRows < 0) return invalid3();
-  } else return invalid3();
+    if (Object.keys(d).sort().join(",") !== "dataRows,delimiter,encoding,headerRow,kind" || f.mediaType !== "text/csv" || !["utf-8", "windows-1252"].includes(d.encoding) || ![",", ";", "	"].includes(d.delimiter) || !Number.isSafeInteger(d.headerRow) || d.headerRow < 1 || !Number.isSafeInteger(d.dataRows) || d.dataRows < 0) return invalid4();
+  } else return invalid4();
   for (let [name, descriptor2] of Object.entries(f.enrichments)) {
-    if (!safeEnrichmentName(name)) return invalid3();
+    if (!safeEnrichmentName(name)) return invalid4();
     parseEnrichmentDescriptor(descriptor2);
   }
-  return new TextEncoder().encode(JSON.stringify(f)).byteLength > 16 * 1024 ? invalid3() : f;
+  return new TextEncoder().encode(JSON.stringify(f)).byteLength > 16 * 1024 ? invalid4() : f;
 }
 function parseEnrichmentDescriptor(value) {
-  let invalid3 = () => {
+  let invalid4 = () => {
     throw new FileOperationError("unavailable", 503, !0);
   };
-  if (!value || typeof value != "object" || Array.isArray(value)) return invalid3();
+  if (!value || typeof value != "object" || Array.isArray(value)) return invalid4();
   let d = value;
-  return Object.keys(d).sort().join(",") !== "mediaType,sha256,size" || !["application/octet-stream", "text/plain", "text/markdown", "application/json"].includes(d.mediaType) || !Number.isSafeInteger(d.size) || d.size < 0 || d.size > 16 * 1024 * 1024 || typeof d.sha256 != "string" || !/^[0-9a-f]{64}$/.test(d.sha256) ? invalid3() : d;
+  return Object.keys(d).sort().join(",") !== "mediaType,sha256,size" || !["application/octet-stream", "text/plain", "text/markdown", "application/json"].includes(d.mediaType) || !Number.isSafeInteger(d.size) || d.size < 0 || d.size > 16 * 1024 * 1024 || typeof d.sha256 != "string" || !/^[0-9a-f]{64}$/.test(d.sha256) ? invalid4() : d;
 }
 function safeEnrichmentName(value) {
   return safeFileName(value) && !/^original(?:\.|$)/i.test(value);
 }
 function parseFileEnrichMetadata(value, maxBytes) {
-  let invalid3 = () => {
+  let invalid4 = () => {
     throw new FileOperationError("invalid_input", 400);
   };
-  if (!value || typeof value != "object" || Array.isArray(value)) return invalid3();
+  if (!value || typeof value != "object" || Array.isArray(value)) return invalid4();
   let d = value;
-  if (Object.keys(d).some((key) => !["name", "size", "mediaType", "replace"].includes(key)) || !safeEnrichmentName(d.name) || !Number.isSafeInteger(d.size) || d.size < 0 || d.mediaType !== void 0 && (typeof d.mediaType != "string" || d.mediaType.length > 255 || /[\u0000-\u001f\u007f]/.test(d.mediaType)) || d.replace !== void 0 && (typeof d.replace != "string" || !/^[0-9a-f]{64}$/.test(d.replace))) return invalid3();
+  if (Object.keys(d).some((key) => !["name", "size", "mediaType", "replace"].includes(key)) || !safeEnrichmentName(d.name) || !Number.isSafeInteger(d.size) || d.size < 0 || d.mediaType !== void 0 && (typeof d.mediaType != "string" || d.mediaType.length > 255 || /[\u0000-\u001f\u007f]/.test(d.mediaType)) || d.replace !== void 0 && (typeof d.replace != "string" || !/^[0-9a-f]{64}$/.test(d.replace))) return invalid4();
   if (d.size > maxBytes) throw new FileOperationError("request_too_large", 413);
   return d;
 }
@@ -888,23 +945,23 @@ function safeFilePath(value) {
   return typeof value == "string" && value.length <= 1024 && value.split("/").every(safeFileName);
 }
 function parseFileCreateMetadata(value, maxBytes) {
-  let invalid3 = () => {
+  let invalid4 = () => {
     throw new FileOperationError("invalid_input", 400);
   };
-  if (!value || typeof value != "object" || Array.isArray(value)) return invalid3();
+  if (!value || typeof value != "object" || Array.isArray(value)) return invalid4();
   let input = value;
-  if (Object.keys(input).some((key) => !["name", "path", "storage", "csv", "size", "requestKey"].includes(key))) return invalid3();
+  if (Object.keys(input).some((key) => !["name", "path", "storage", "csv", "size", "requestKey"].includes(key))) return invalid4();
   let path = input.path === void 0 ? "Files" : input.path;
-  if (!safeFileName(input.name) || !safeFilePath(path) || input.storage !== void 0 && input.storage !== "remote" && input.storage !== "local" || !Number.isSafeInteger(input.size) || input.size < 0) return invalid3();
+  if (!safeFileName(input.name) || !safeFilePath(path) || input.storage !== void 0 && input.storage !== "remote" && input.storage !== "local" || !Number.isSafeInteger(input.size) || input.size < 0) return invalid4();
   if (input.size > maxBytes) throw new FileOperationError("request_too_large", 413);
-  if (typeof input.requestKey != "string" || input.requestKey.length < 1 || input.requestKey.length > 256 || input.requestKey !== input.requestKey.trim() || /[\u0000-\u001f\u007f]/.test(input.requestKey)) return invalid3();
+  if (typeof input.requestKey != "string" || input.requestKey.length < 1 || input.requestKey.length > 256 || input.requestKey !== input.requestKey.trim() || /[\u0000-\u001f\u007f]/.test(input.requestKey)) return invalid4();
   let csv;
   if (input.csv !== void 0) {
-    if (!input.csv || typeof input.csv != "object" || Array.isArray(input.csv)) return invalid3();
+    if (!input.csv || typeof input.csv != "object" || Array.isArray(input.csv)) return invalid4();
     let hints = input.csv;
-    if (Object.keys(hints).some((key) => !["encoding", "delimiter", "headerRow"].includes(key))) return invalid3();
+    if (Object.keys(hints).some((key) => !["encoding", "delimiter", "headerRow"].includes(key))) return invalid4();
     let encoding = hints.encoding === void 0 ? "utf-8" : hints.encoding, delimiter = hints.delimiter === void 0 ? "," : hints.delimiter, headerRow = hints.headerRow === void 0 ? 1 : hints.headerRow;
-    if (encoding !== "utf-8" && encoding !== "windows-1252" || ![",", ";", "	"].includes(delimiter) || !Number.isSafeInteger(headerRow) || headerRow < 1 || headerRow > 1e5) return invalid3();
+    if (encoding !== "utf-8" && encoding !== "windows-1252" || ![",", ";", "	"].includes(delimiter) || !Number.isSafeInteger(headerRow) || headerRow < 1 || headerRow > 1e5) return invalid4();
     csv = { encoding, delimiter, headerRow };
   }
   return {
@@ -992,13 +1049,14 @@ var data = {
     async function send2(input) {
       let context2 = await resolveDataContext();
       try {
-        if (checkDataRequestSize({ repository, ...input }), "local" in context2) return await context2.local("data/query", { repository, ...input });
+        let envelope = { repository, ...input };
+        if (checkDataRequestSize(envelope), "local" in context2) return await context2.local("data/query", envelope);
         let response = await fetch(context2.url, {
           method: "POST",
           redirect: "error",
           cache: "no-store",
           headers: { "content-type": "application/json", ...context2.headers },
-          body: JSON.stringify({ repository, ...input })
+          body: JSON.stringify(envelope)
         }), result2 = await response.json();
         if (!response.ok)
           throw dataTransportError(response.status, result2);
@@ -1014,21 +1072,18 @@ var data = {
       },
       records: {
         select: (query) => send2({ operation: "records.select", query }),
-        search: (query, options) => {
-          try {
-            return send2({ operation: "records.search", ...captureRecordsSearchInput(query, options) });
-          } catch (error) {
-            return Promise.reject(error);
-          }
-        }
+        search: async (query, options) => send2({ operation: "records.search", ...captureRecordsSearchInput(query, options) })
+      },
+      history: {
+        list: async (options) => send2({ operation: "history.list", options: captureHistoryListOptions(options) }),
+        at: async (instant) => send2({ operation: "history.at", instant: captureHistoryInstant(instant) }),
+        changes: async (options) => send2({ operation: "history.changes", options: captureHistoryChangesOptions(options) })
       },
       changes() {
-        let updates = [], creates = [], deletes = [], publicationId, pending, confirmed, snapshot = () => {
-          let captured = captureDataChanges(updates, creates, deletes), input = {
-            updates: captured.updates,
-            ...captured.creates.length ? { creates: captured.creates } : {},
-            ...captured.deletes.length ? { deletes: captured.deletes } : {}
-          };
+        let updates = [], creates = [], deletes = [], publicationId, pending, confirmed, assertMutable = () => {
+          if (publicationId) throw new DataOperationError("invalid_change", !1, "unapplied");
+        }, snapshot = (nextUpdates = updates, nextCreates = creates, nextDeletes = deletes) => {
+          let { updates: updates2, creates: creates2, deletes: deletes2 } = captureDataChanges(nextUpdates, nextCreates, nextDeletes), input = { updates: updates2, ...creates2.length ? { creates: creates2 } : {}, ...deletes2.length ? { deletes: deletes2 } : {} };
           return checkDataRequestSize({
             repository,
             operation: "changes.publish",
@@ -1038,40 +1093,19 @@ var data = {
         };
         return {
           create(record2) {
-            if (publicationId) throw new DataOperationError("invalid_change", !1, "unapplied");
+            assertMutable();
             let next = [...creates, captureDataCreate(record2)];
-            captureDataChanges(updates, next, deletes), checkDataRequestSize({
-              repository,
-              operation: "changes.publish",
-              updates,
-              creates: next,
-              ...deletes.length ? { deletes } : {},
-              publicationId: "00000000-0000-4000-8000-000000000000"
-            }), creates = next;
+            snapshot(updates, next, deletes), creates = next;
           },
           update(record2, set) {
-            if (publicationId) throw new DataOperationError("invalid_change", !1, "unapplied");
+            assertMutable();
             let next = [...updates, captureDataUpdate(record2, set)];
-            captureDataChanges(next, creates, deletes), checkDataRequestSize({
-              repository,
-              operation: "changes.publish",
-              updates: next,
-              ...creates.length ? { creates } : {},
-              ...deletes.length ? { deletes } : {},
-              publicationId: "00000000-0000-4000-8000-000000000000"
-            }), updates = next;
+            snapshot(next, creates, deletes), updates = next;
           },
           delete(record2) {
-            if (publicationId) throw new DataOperationError("invalid_change", !1, "unapplied");
+            assertMutable();
             let next = [...deletes, captureDataDelete(record2)];
-            captureDataChanges(updates, creates, next), checkDataRequestSize({
-              repository,
-              operation: "changes.publish",
-              updates,
-              deletes: next,
-              ...creates.length ? { creates } : {},
-              publicationId: "00000000-0000-4000-8000-000000000000"
-            }), deletes = next;
+            snapshot(updates, creates, next), deletes = next;
           },
           async validate() {
             await send2({ operation: "changes.validate", ...snapshot() });
@@ -1104,7 +1138,7 @@ var data = {
   }
 };
 
-var MAX_BYTES = 16 * 1024 * 1024, PART_BYTES = 8 * 1024 * 1024, METADATA_BYTES = 4096, RESULT_BYTES = 16 * 1024, CONTROL_RESULT_BYTES = 128 * 1024, TIMEOUT_MS = 3e4, MAX_ACTIVE = 4, ATTEMPTS = 2, active = 0, invalid2 = () => new FileOperationError("invalid_input", 400), unavailable = () => new FileOperationError("unavailable", 503, !0), failures = {
+var MAX_BYTES = 16 * 1024 * 1024, PART_BYTES = 8 * 1024 * 1024, METADATA_BYTES = 4096, RESULT_BYTES = 16 * 1024, CONTROL_RESULT_BYTES = 128 * 1024, TIMEOUT_MS = 3e4, MAX_ACTIVE = 4, ATTEMPTS = 2, active = 0, invalid3 = () => new FileOperationError("invalid_input", 400), unavailable = () => new FileOperationError("unavailable", 503, !0), failures = {
   400: ["invalid_input", "unsupported_context"],
   401: ["unauthenticated"],
   403: ["access_denied"],
@@ -1121,7 +1155,7 @@ async function boundedBytes(stream, limit) {
     for (; ; ) {
       let { done, value } = await reader.read();
       if (done) break;
-      if (!(value instanceof Uint8Array)) throw invalid2();
+      if (!(value instanceof Uint8Array)) throw invalid3();
       if (size += value.byteLength, size > limit) throw new FileOperationError("request_too_large", 413);
       bytes.set(value, size - value.byteLength);
     }
@@ -1249,7 +1283,7 @@ async function send(suffix, init2, descriptor2, initial, parent) {
   throw unavailable();
 }
 function idPath(id2) {
-  if (typeof id2 != "string" || !FILE_ID_PATTERN.test(id2)) throw invalid2();
+  if (typeof id2 != "string" || !FILE_ID_PATTERN.test(id2)) throw invalid3();
   return `/${id2}`;
 }
 async function multipartCreate(input, metadata, exchange, release = () => {
@@ -1292,18 +1326,18 @@ async function multipartCreate(input, metadata, exchange, release = () => {
           if (!chunk || offset === chunk.byteLength) {
             chunk = void 0, offset = 0;
             let value2 = await next();
-            if (value2.done || !(value2.value instanceof Uint8Array) || (chunk = value2.value, chunk.byteLength > metadata.size - sent - filled)) throw invalid2();
+            if (value2.done || !(value2.value instanceof Uint8Array) || (chunk = value2.value, chunk.byteLength > metadata.size - sent - filled)) throw invalid3();
           }
           let take = Math.min(length - filled, chunk.byteLength - offset);
           part.set(chunk.subarray(offset, offset + take), filled), filled += take, offset += take, offset === chunk.byteLength && (chunk = void 0, offset = 0);
         }
       }
-      if (part.byteLength !== length) throw invalid2();
+      if (part.byteLength !== length) throw invalid3();
       if (reader && sent + length === metadata.size)
         for (lastProgress = Date.now(); ; ) {
           let value2 = await next();
           if (value2.done) break;
-          if (!(value2.value instanceof Uint8Array) || value2.value.byteLength) throw invalid2();
+          if (!(value2.value instanceof Uint8Array) || value2.value.byteLength) throw invalid3();
         }
       let value = await request((signal) => exchange(`${route}/part`, {
         method: "POST",
@@ -1317,7 +1351,7 @@ async function multipartCreate(input, metadata, exchange, release = () => {
     }
     if (upload) for (let name of Object.keys(upload.file.enrichments)) {
       let bytes = await request(() => upload.enrichment(name));
-      if (bytes.byteLength !== upload.file.enrichments[name].size || bytes.byteLength > MAX_BYTES) throw invalid2();
+      if (bytes.byteLength !== upload.file.enrichments[name].size || bytes.byteLength > MAX_BYTES) throw invalid3();
       await request((signal) => exchange(`${route}/enrichments/${encodeURIComponent(name)}`, {
         method: "POST",
         headers: { "content-type": "application/octet-stream", "x-oddington-transfer": ticket },
@@ -1361,7 +1395,7 @@ async function operation(work, initial, parent) {
 function contentPath(id2, name) {
   let path = idPath(id2);
   if (name === void 0) return `${path}/content`;
-  if (!safeEnrichmentName(name)) throw invalid2();
+  if (!safeEnrichmentName(name)) throw invalid3();
   return `${path}/enrichments/${encodeURIComponent(name)}/content`;
 }
 async function read(id2, names) {
@@ -1370,12 +1404,12 @@ async function read(id2, names) {
     let path = contentPath(id2, names);
     return operation((context3, signal) => send(path, { method: "GET" }, !1, context3, signal), context2);
   }
-  if (!Array.isArray(names)) throw invalid2();
+  if (!Array.isArray(names)) throw invalid3();
   let distinct = [], seen = /* @__PURE__ */ new Set();
   for (let name of names) {
-    if (typeof name != "string" || !safeEnrichmentName(name)) throw invalid2();
+    if (typeof name != "string" || !safeEnrichmentName(name)) throw invalid3();
     if (!seen.has(name)) {
-      if (seen.size === 16) throw invalid2();
+      if (seen.size === 16) throw invalid3();
       seen.add(name), distinct.push(name);
     }
   }
@@ -1407,11 +1441,11 @@ var files = {
   async create(input, options) {
     let context2 = await resolveFilesContext();
     if (!input || typeof input != "object" || Array.isArray(input) || Object.keys(input).some((key) => !["file", "size", "path", "name", "storage", "csv"].includes(key)) || options !== void 0 && (!options || typeof options != "object" || Array.isArray(options) || Object.keys(options).some((key) => key !== "requestKey")))
-      throw invalid2();
+      throw invalid3();
     let blob = input.file instanceof Blob, array2 = input.file instanceof Uint8Array, stream = input.file instanceof ReadableStream;
-    if (!blob && !array2 && !stream) throw invalid2();
+    if (!blob && !array2 && !stream) throw invalid3();
     let intrinsic = blob ? input.file.size : array2 ? input.file.byteLength : void 0;
-    if (intrinsic !== void 0 && input.size !== void 0 && input.size !== intrinsic) throw invalid2();
+    if (intrinsic !== void 0 && input.size !== void 0 && input.size !== intrinsic) throw invalid3();
     let name = input.name;
     name === void 0 && blob && "name" in input.file && typeof input.file.name == "string" && (name = typeof globalThis.File < "u" && input.file instanceof globalThis.File ? input.file.name : input.file.name.split(/[\\/]/).at(-1));
     let metadata = parseFileCreateMetadata({
@@ -1424,7 +1458,7 @@ var files = {
     }, FILE_ORIGINAL_MAX_BYTES);
     if (!context2.local && metadata.storage === "local") throw new FileOperationError("unsupported_context", 400);
     let header = encodeURIComponent(JSON.stringify(metadata));
-    if (new TextEncoder().encode(header).byteLength > METADATA_BYTES) throw invalid2();
+    if (new TextEncoder().encode(header).byteLength > METADATA_BYTES) throw invalid3();
     if (active >= MAX_ACTIVE) throw new FileOperationError("capacity", 429, !0);
     if (active++, context2.localFiles && metadata.size > MAX_BYTES) {
       let controller = new AbortController(), file = input.file, offset = 0, body2 = file instanceof ReadableStream ? file : file instanceof Blob ? file.stream() : new ReadableStream({
@@ -1452,7 +1486,7 @@ var files = {
           blob ? input.file.stream() : input.file,
           metadata.size
         );
-        if (bytes.byteLength !== metadata.size) throw invalid2();
+        if (bytes.byteLength !== metadata.size) throw invalid3();
         if (signal.aborted) throw unavailable();
         return await send("", {
           method: "POST",
@@ -1468,7 +1502,7 @@ var files = {
   },
   async enrich(input) {
     let context2 = await resolveFilesContext();
-    if (!input || typeof input != "object" || Array.isArray(input) || Object.keys(input).some((key) => !["file", "name", "content", "mediaType", "replace"].includes(key)) || typeof input.content != "string" && !(input.content instanceof Uint8Array)) throw invalid2();
+    if (!input || typeof input != "object" || Array.isArray(input) || Object.keys(input).some((key) => !["file", "name", "content", "mediaType", "replace"].includes(key)) || typeof input.content != "string" && !(input.content instanceof Uint8Array)) throw invalid3();
     let path = `${idPath(input.file)}/enrichments`;
     if (typeof input.content == "string" ? input.content.length > MAX_BYTES : input.content.byteLength > MAX_BYTES)
       throw new FileOperationError("request_too_large", 413);
@@ -1485,7 +1519,7 @@ var files = {
         ...input.mediaType === void 0 ? {} : { mediaType: input.mediaType },
         ...input.replace === void 0 ? {} : { replace: input.replace }
       }, MAX_BYTES), header = encodeURIComponent(JSON.stringify(metadata));
-      if (new TextEncoder().encode(header).byteLength > METADATA_BYTES) throw invalid2();
+      if (new TextEncoder().encode(header).byteLength > METADATA_BYTES) throw invalid3();
       let result2 = await send(path, { method: "POST", headers: {
         "content-type": "application/octet-stream",
         "x-oddington-enrichment": header

package/dist/index.js

@@ -21709,44 +21709,118 @@ class DataOperationError extends Error {
   }
 }
 
-// ../../shared/data-search-input.ts
+// ../../shared/data-history-input.ts
 var invalid = () => {
   throw new DataOperationError("invalid_query");
 };
-var scalarText = (value) => typeof value === "string" && !/[\u0000\uD800-\uDFFF]/u.test(value);
-function captureRecordsSearchInput(query, options) {
-  if (!scalarText(query))
+var historyText = (value) => typeof value === "string" && !/[\u0000\uD800-\uDFFF]/u.test(value);
+function historyVersion(value) {
+  return historyText(value) && value.length > 0 && new TextEncoder().encode(value).length <= 1024 && !/[\u0000-\u001f\u007f-\u009f]/.test(value) && !/^[0-9a-f]{40}$/i.test(value);
+}
+function historyProperties(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value) || ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
+    return invalid();
+  const descriptors = Object.getOwnPropertyDescriptors(value);
+  if (Reflect.ownKeys(value).some((key) => typeof key !== "string" || !descriptors[key]?.enumerable || !Object.hasOwn(descriptors[key], "value")))
+    return invalid();
+  return descriptors;
+}
+var historyCollection = (value) => typeof value === "string" && value.length <= 512 && /^[_a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(value);
+var historyCursor = (value) => typeof value === "string" && value.length <= 128 * 1024 && /^history-cursor-v1\.[A-Za-z0-9_-]{1,64}\.[A-Za-z0-9_-]{16}\.[A-Za-z0-9_-]+$/.test(value);
+function historyArray(value) {
+  if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype)
+    return invalid();
+  const descriptors = Object.getOwnPropertyDescriptors(value);
+  if (Reflect.ownKeys(value).length !== value.length + 1)
+    return invalid();
+  const result = [];
+  for (let i = 0;i < value.length; i++) {
+    const descriptor = descriptors[i];
+    if (!descriptor?.enumerable || !Object.hasOwn(descriptor, "value"))
+      return invalid();
+    result.push(descriptor.value);
+  }
+  return result;
+}
+function captureOptions(value, changes) {
+  if (value === undefined)
+    return {};
+  const descriptors = historyProperties(value), result = {};
+  const allowed = changes ? ["collections", "refs", "from", "through", "limit", "after"] : ["limit", "before"];
+  if (Object.keys(descriptors).some((key) => !allowed.includes(key)))
+    return invalid();
+  for (const key of allowed) {
+    if (!Object.hasOwn(descriptors, key))
+      continue;
+    const scalar = descriptors[key].value;
+    if (key === "collections" || key === "refs") {
+      const values = historyArray(scalar);
+      if (!values.length || values.length > (key === "collections" ? 16 : 100) || !values.every(key === "collections" ? historyCollection : validRecordRef) || new Set(values).size !== values.length)
+        return invalid();
+      result[key] = values;
+    } else if (key === "limit") {
+      if (!Number.isInteger(scalar) || scalar < 1 || scalar > (changes ? 500 : 100))
+        return invalid();
+      result.limit = scalar;
+    } else {
+      if (!(key === "after" ? historyCursor(scalar) : historyVersion(scalar)))
+        return invalid();
+      result[key] = scalar;
+    }
+  }
+  return result;
+}
+var captureHistoryListOptions = (value) => captureOptions(value, false);
+var captureHistoryChangesOptions = (value) => captureOptions(value, true);
+function captureHistoryInstant(value) {
+  if (!historyText(value) || value.length > 1024)
+    return invalid();
+  const match = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2}):(\d{2})(?:\.\d+)?([Zz]|([+-])(\d{2}):(\d{2}))$/.exec(value);
+  if (!match)
     return invalid();
+  const [year, month, day, hour, minute, second] = match.slice(1, 7).map(Number);
+  const days = new Date(Date.UTC(year, month, 0));
+  days.setUTCFullYear(year);
+  if (year < 1 || month < 1 || month > 12 || day < 1 || day > days.getUTCDate() || hour > 23 || minute > 59 || second > 59 || Number(match[9] ?? 0) > 23 || Number(match[10] ?? 0) > 59)
+    return invalid();
+  return value;
+}
+
+// ../../shared/data-search-input.ts
+var invalid2 = () => {
+  throw new DataOperationError("invalid_query");
+};
+function captureRecordsSearchInput(query, options) {
+  if (!historyText(query))
+    return invalid2();
   const length = [...query.trim()].length;
   if (length < 1 || length > 256)
-    return invalid();
+    return invalid2();
   if (options === undefined)
     return { query };
-  if (!options || typeof options !== "object" || Array.isArray(options) || ![Object.prototype, null].includes(Object.getPrototypeOf(options)))
-    return invalid();
-  const descriptors = Object.getOwnPropertyDescriptors(options);
-  if (Reflect.ownKeys(options).some((key) => typeof key !== "string" || !["collections", "limit"].includes(key) || !descriptors[key]?.enumerable || !Object.hasOwn(descriptors[key], "value")))
-    return invalid();
+  const descriptors = historyProperties(options);
+  if (Object.keys(descriptors).some((key) => !["collections", "limit"].includes(key)))
+    return invalid2();
   const captured = {};
   if (Object.hasOwn(descriptors, "collections")) {
     const supplied = descriptors.collections.value;
     if (!Array.isArray(supplied) || supplied.length < 1 || supplied.length > 16 || Reflect.ownKeys(supplied).length !== supplied.length + 1)
-      return invalid();
+      return invalid2();
     const collections = [];
     for (let index = 0;index < supplied.length; index++) {
       const descriptor = Object.getOwnPropertyDescriptor(supplied, String(index));
-      if (!descriptor?.enumerable || !Object.hasOwn(descriptor, "value") || !scalarText(descriptor.value))
-        return invalid();
+      if (!descriptor?.enumerable || !Object.hasOwn(descriptor, "value") || !historyText(descriptor.value))
+        return invalid2();
       collections.push(descriptor.value);
     }
     if (new Set(collections).size !== collections.length)
-      return invalid();
+      return invalid2();
     captured.collections = collections;
   }
   if (Object.hasOwn(descriptors, "limit")) {
     const supplied = descriptors.limit.value;
     if (!Number.isInteger(supplied) || supplied < 1 || supplied > 100)
-      return invalid();
+      return invalid2();
     captured.limit = supplied;
   }
   return { query, options: captured };
@@ -21758,11 +21832,12 @@ var invalidChange = () => {
   throw new DataOperationError("invalid_change", false, "unapplied");
 };
 function mapping(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value) || ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
-    return invalidChange();
-  if (Reflect.ownKeys(value).some((key) => typeof key !== "string" || !Object.getOwnPropertyDescriptor(value, key)?.enumerable || !Object.hasOwn(Object.getOwnPropertyDescriptor(value, key), "value")))
+  try {
+    historyProperties(value);
+    return value;
+  } catch {
     return invalidChange();
-  return value;
+  }
 }
 function captureValue(value, ancestors = new Set, depth = 0) {
   if (value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value))
@@ -21797,18 +21872,22 @@ function captureDataUpdate(record2, set) {
     return invalidChange();
   return { ...identity, set: captureValue(fields3) };
 }
-function captureDataUpdates(value, allowEmpty = false) {
+function captureIdentities(value, update, allowEmpty = true) {
   if (!Array.isArray(value) || !allowEmpty && !value.length || value.length > 1e4)
     return invalidChange();
-  const updates = value.map((item) => {
+  const captured = value.map((item) => {
     const row = mapping(item);
-    if (Object.keys(row).sort().join(",") !== "expectedVersion,ref,set")
+    if (Object.keys(row).sort().join(",") !== (update ? "expectedVersion,ref,set" : "expectedVersion,ref"))
       return invalidChange();
-    return captureDataUpdate({ $ref: row.ref, $version: row.expectedVersion }, row.set);
+    const identity = { $ref: row.ref, $version: row.expectedVersion };
+    return update ? captureDataUpdate(identity, row.set) : captureDataDelete(identity);
   });
-  if (new Set(updates.map((update) => update.ref)).size !== updates.length)
+  if (new Set(captured.map((item) => item.ref)).size !== captured.length)
     return invalidChange();
-  return updates;
+  return captured;
+}
+function captureDataUpdates(value, allowEmpty = false) {
+  return captureIdentities(value, true, allowEmpty);
 }
 function captureDataCreate(value) {
   const row = mapping(value);
@@ -21837,14 +21916,7 @@ function captureDataChanges(updatesValue, createsValue = [], deletesValue = [])
       return invalidChange();
     return captureDataCreate({ ...fields3, $ref: row.ref, ...Object.hasOwn(row, "filing") ? { $filing: row.filing } : {} });
   });
-  if (!Array.isArray(deletesValue) || deletesValue.length > 1e4)
-    return invalidChange();
-  const deletes = deletesValue.map((item) => {
-    const row = mapping(item);
-    if (Object.keys(row).sort().join(",") !== "expectedVersion,ref")
-      return invalidChange();
-    return captureDataDelete({ $ref: row.ref, $version: row.expectedVersion });
-  });
+  const deletes = captureIdentities(deletesValue, false);
   const refs = [...updates, ...creates, ...deletes].map((item) => item.ref);
   if (!refs.length || refs.length > 1e4 || new Set(refs).size !== refs.length)
     return invalidChange();
@@ -21886,55 +21958,55 @@ class FileOperationError extends Error {
 var FILE_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
 var FILE_ORIGINAL_MAX_BYTES = 5 * 1024 ** 3;
 function parseFileDescriptor(value) {
-  const invalid2 = () => {
+  const invalid3 = () => {
     throw new FileOperationError("unavailable", 503, true);
   };
   if (!value || typeof value !== "object" || Array.isArray(value))
-    return invalid2();
+    return invalid3();
   const f = value;
   if (Object.keys(f).sort().join(",") !== "details,enrichments,id,mediaType,name,path,sha256,size" || typeof f.id !== "string" || !FILE_ID_PATTERN.test(f.id) || !safeFileName(f.name) || !safeFilePath(f.path) || !Number.isSafeInteger(f.size) || f.size < 0 || f.size > FILE_ORIGINAL_MAX_BYTES || typeof f.sha256 !== "string" || !/^[0-9a-f]{64}$/.test(f.sha256) || !f.enrichments || typeof f.enrichments !== "object" || Array.isArray(f.enrichments) || !f.details || typeof f.details !== "object" || Array.isArray(f.details))
-    return invalid2();
+    return invalid3();
   const d = f.details;
   if (d.kind === "other") {
     if (Object.keys(d).length !== 1 || f.mediaType !== "application/octet-stream")
-      return invalid2();
+      return invalid3();
   } else if (d.kind === "csv") {
     if (Object.keys(d).sort().join(",") !== "dataRows,delimiter,encoding,headerRow,kind" || f.mediaType !== "text/csv" || !["utf-8", "windows-1252"].includes(d.encoding) || ![",", ";", "\t"].includes(d.delimiter) || !Number.isSafeInteger(d.headerRow) || d.headerRow < 1 || !Number.isSafeInteger(d.dataRows) || d.dataRows < 0)
-      return invalid2();
+      return invalid3();
   } else
-    return invalid2();
+    return invalid3();
   for (const [name, descriptor] of Object.entries(f.enrichments)) {
     if (!safeEnrichmentName(name))
-      return invalid2();
+      return invalid3();
     parseEnrichmentDescriptor(descriptor);
   }
   if (new TextEncoder().encode(JSON.stringify(f)).byteLength > 16 * 1024)
-    return invalid2();
+    return invalid3();
   return f;
 }
 function parseEnrichmentDescriptor(value) {
-  const invalid2 = () => {
+  const invalid3 = () => {
     throw new FileOperationError("unavailable", 503, true);
   };
   if (!value || typeof value !== "object" || Array.isArray(value))
-    return invalid2();
+    return invalid3();
   const d = value;
   if (Object.keys(d).sort().join(",") !== "mediaType,sha256,size" || !["application/octet-stream", "text/plain", "text/markdown", "application/json"].includes(d.mediaType) || !Number.isSafeInteger(d.size) || d.size < 0 || d.size > 16 * 1024 * 1024 || typeof d.sha256 !== "string" || !/^[0-9a-f]{64}$/.test(d.sha256))
-    return invalid2();
+    return invalid3();
   return d;
 }
 function safeEnrichmentName(value) {
   return safeFileName(value) && !/^original(?:\.|$)/i.test(value);
 }
 function parseFileEnrichMetadata(value, maxBytes) {
-  const invalid2 = () => {
+  const invalid3 = () => {
     throw new FileOperationError("invalid_input", 400);
   };
   if (!value || typeof value !== "object" || Array.isArray(value))
-    return invalid2();
+    return invalid3();
   const d = value;
   if (Object.keys(d).some((key) => !["name", "size", "mediaType", "replace"].includes(key)) || !safeEnrichmentName(d.name) || !Number.isSafeInteger(d.size) || d.size < 0 || d.mediaType !== undefined && (typeof d.mediaType !== "string" || d.mediaType.length > 255 || /[\u0000-\u001f\u007f]/.test(d.mediaType)) || d.replace !== undefined && (typeof d.replace !== "string" || !/^[0-9a-f]{64}$/.test(d.replace)))
-    return invalid2();
+    return invalid3();
   if (d.size > maxBytes)
     throw new FileOperationError("request_too_large", 413);
   return d;
@@ -21946,37 +22018,37 @@ function safeFilePath(value) {
   return typeof value === "string" && value.length <= 1024 && value.split("/").every(safeFileName);
 }
 function parseFileCreateMetadata(value, maxBytes) {
-  const invalid2 = () => {
+  const invalid3 = () => {
     throw new FileOperationError("invalid_input", 400);
   };
   if (!value || typeof value !== "object" || Array.isArray(value))
-    return invalid2();
+    return invalid3();
   const input = value;
   if (Object.keys(input).some((key) => !["name", "path", "storage", "csv", "size", "requestKey"].includes(key)))
-    return invalid2();
+    return invalid3();
   const path = input.path === undefined ? "Files" : input.path;
   if (!safeFileName(input.name) || !safeFilePath(path))
-    return invalid2();
+    return invalid3();
   if (input.storage !== undefined && input.storage !== "remote" && input.storage !== "local")
-    return invalid2();
+    return invalid3();
   if (!Number.isSafeInteger(input.size) || input.size < 0)
-    return invalid2();
+    return invalid3();
   if (input.size > maxBytes)
     throw new FileOperationError("request_too_large", 413);
   if (typeof input.requestKey !== "string" || input.requestKey.length < 1 || input.requestKey.length > 256 || input.requestKey !== input.requestKey.trim() || /[\u0000-\u001f\u007f]/.test(input.requestKey))
-    return invalid2();
+    return invalid3();
   let csv;
   if (input.csv !== undefined) {
     if (!input.csv || typeof input.csv !== "object" || Array.isArray(input.csv))
-      return invalid2();
+      return invalid3();
     const hints = input.csv;
     if (Object.keys(hints).some((key) => !["encoding", "delimiter", "headerRow"].includes(key)))
-      return invalid2();
+      return invalid3();
     const encoding = hints.encoding === undefined ? "utf-8" : hints.encoding;
     const delimiter = hints.delimiter === undefined ? "," : hints.delimiter;
     const headerRow = hints.headerRow === undefined ? 1 : hints.headerRow;
     if (encoding !== "utf-8" && encoding !== "windows-1252" || ![",", ";", "\t"].includes(delimiter) || !Number.isSafeInteger(headerRow) || headerRow < 1 || headerRow > 1e5)
-      return invalid2();
+      return invalid3();
     csv = { encoding, delimiter, headerRow };
   }
   return {
@@ -22432,15 +22504,16 @@ var data = {
     async function send(input) {
       const context = await resolveDataContext();
       try {
-        checkDataRequestSize({ repository, ...input });
+        const envelope = { repository, ...input };
+        checkDataRequestSize(envelope);
         if ("local" in context)
-          return await context.local("data/query", { repository, ...input });
+          return await context.local("data/query", envelope);
         const response = await fetch(context.url, {
           method: "POST",
           redirect: "error",
           cache: "no-store",
           headers: { "content-type": "application/json", ...context.headers },
-          body: JSON.stringify({ repository, ...input })
+          body: JSON.stringify(envelope)
         });
         const result = await response.json();
         if (!response.ok) {
@@ -22460,24 +22533,23 @@ var data = {
       },
       records: {
         select: (query) => send({ operation: "records.select", query }),
-        search: (query, options) => {
-          try {
-            return send({ operation: "records.search", ...captureRecordsSearchInput(query, options) });
-          } catch (error) {
-            return Promise.reject(error);
-          }
-        }
+        search: async (query, options) => send({ operation: "records.search", ...captureRecordsSearchInput(query, options) })
+      },
+      history: {
+        list: async (options) => send({ operation: "history.list", options: captureHistoryListOptions(options) }),
+        at: async (instant) => send({ operation: "history.at", instant: captureHistoryInstant(instant) }),
+        changes: async (options) => send({ operation: "history.changes", options: captureHistoryChangesOptions(options) })
       },
       changes() {
         let updates = [], creates = [], deletes = [], publicationId;
         let pending, confirmed;
-        const snapshot = () => {
-          const captured = captureDataChanges(updates, creates, deletes);
-          const input = {
-            updates: captured.updates,
-            ...captured.creates.length ? { creates: captured.creates } : {},
-            ...captured.deletes.length ? { deletes: captured.deletes } : {}
-          };
+        const assertMutable = () => {
+          if (publicationId)
+            throw new DataOperationError("invalid_change", false, "unapplied");
+        };
+        const snapshot = (nextUpdates = updates, nextCreates = creates, nextDeletes = deletes) => {
+          const { updates: updates2, creates: creates2, deletes: deletes2 } = captureDataChanges(nextUpdates, nextCreates, nextDeletes);
+          const input = { updates: updates2, ...creates2.length ? { creates: creates2 } : {}, ...deletes2.length ? { deletes: deletes2 } : {} };
           checkDataRequestSize({
             repository,
             operation: "changes.publish",
@@ -22488,48 +22560,21 @@ var data = {
         };
         return {
           create(record2) {
-            if (publicationId)
-              throw new DataOperationError("invalid_change", false, "unapplied");
+            assertMutable();
             const next = [...creates, captureDataCreate(record2)];
-            captureDataChanges(updates, next, deletes);
-            checkDataRequestSize({
-              repository,
-              operation: "changes.publish",
-              updates,
-              creates: next,
-              ...deletes.length ? { deletes } : {},
-              publicationId: "00000000-0000-4000-8000-000000000000"
-            });
+            snapshot(updates, next, deletes);
             creates = next;
           },
           update(record2, set) {
-            if (publicationId)
-              throw new DataOperationError("invalid_change", false, "unapplied");
+            assertMutable();
             const next = [...updates, captureDataUpdate(record2, set)];
-            captureDataChanges(next, creates, deletes);
-            checkDataRequestSize({
-              repository,
-              operation: "changes.publish",
-              updates: next,
-              ...creates.length ? { creates } : {},
-              ...deletes.length ? { deletes } : {},
-              publicationId: "00000000-0000-4000-8000-000000000000"
-            });
+            snapshot(next, creates, deletes);
             updates = next;
           },
           delete(record2) {
-            if (publicationId)
-              throw new DataOperationError("invalid_change", false, "unapplied");
+            assertMutable();
             const next = [...deletes, captureDataDelete(record2)];
-            captureDataChanges(updates, creates, next);
-            checkDataRequestSize({
-              repository,
-              operation: "changes.publish",
-              updates,
-              deletes: next,
-              ...creates.length ? { creates } : {},
-              publicationId: "00000000-0000-4000-8000-000000000000"
-            });
+            snapshot(updates, creates, next);
             deletes = next;
           },
           async validate() {
@@ -22574,7 +22619,7 @@ var TIMEOUT_MS = 30000;
 var MAX_ACTIVE = 4;
 var ATTEMPTS = 2;
 var active = 0;
-var invalid2 = () => new FileOperationError("invalid_input", 400);
+var invalid3 = () => new FileOperationError("invalid_input", 400);
 var unavailable = () => new FileOperationError("unavailable", 503, true);
 var failures = {
   400: ["invalid_input", "unsupported_context"],
@@ -22598,7 +22643,7 @@ async function boundedBytes(stream, limit) {
       if (done)
         break;
       if (!(value instanceof Uint8Array))
-        throw invalid2();
+        throw invalid3();
       size += value.byteLength;
       if (size > limit)
         throw new FileOperationError("request_too_large", 413);
@@ -22780,7 +22825,7 @@ async function send(suffix, init, descriptor, initial, parent) {
 }
 function idPath(id2) {
   if (typeof id2 !== "string" || !FILE_ID_PATTERN.test(id2))
-    throw invalid2();
+    throw invalid3();
   return `/${id2}`;
 }
 async function multipartCreate(input, metadata, exchange, release = () => {
@@ -22844,12 +22889,12 @@ async function multipartCreate(input, metadata, exchange, release = () => {
             offset = 0;
             const value2 = await next();
             if (value2.done)
-              throw invalid2();
+              throw invalid3();
             if (!(value2.value instanceof Uint8Array))
-              throw invalid2();
+              throw invalid3();
             chunk = value2.value;
             if (chunk.byteLength > metadata.size - sent - filled)
-              throw invalid2();
+              throw invalid3();
           }
           const take = Math.min(length - filled, chunk.byteLength - offset);
           part.set(chunk.subarray(offset, offset + take), filled);
@@ -22862,7 +22907,7 @@ async function multipartCreate(input, metadata, exchange, release = () => {
         }
       }
       if (part.byteLength !== length)
-        throw invalid2();
+        throw invalid3();
       if (reader && sent + length === metadata.size) {
         lastProgress = Date.now();
         for (;; ) {
@@ -22870,7 +22915,7 @@ async function multipartCreate(input, metadata, exchange, release = () => {
           if (value2.done)
             break;
           if (!(value2.value instanceof Uint8Array) || value2.value.byteLength)
-            throw invalid2();
+            throw invalid3();
         }
       }
       const value = await request((signal) => exchange(`${route}/part`, {
@@ -22890,7 +22935,7 @@ async function multipartCreate(input, metadata, exchange, release = () => {
       for (const name of Object.keys(upload.file.enrichments)) {
         const bytes = await request(() => upload.enrichment(name));
         if (bytes.byteLength !== upload.file.enrichments[name].size || bytes.byteLength > MAX_BYTES)
-          throw invalid2();
+          throw invalid3();
         await request((signal) => exchange(`${route}/enrichments/${encodeURIComponent(name)}`, {
           method: "POST",
           headers: { "content-type": "application/octet-stream", "x-oddington-transfer": ticket },
@@ -22944,7 +22989,7 @@ function contentPath(id2, name) {
   if (name === undefined)
     return `${path}/content`;
   if (!safeEnrichmentName(name))
-    throw invalid2();
+    throw invalid3();
   return `${path}/enrichments/${encodeURIComponent(name)}/content`;
 }
 async function read(id2, names) {
@@ -22955,16 +23000,16 @@ async function read(id2, names) {
     return operation((context2, signal) => send(path, { method: "GET" }, false, context2, signal), context);
   }
   if (!Array.isArray(names))
-    throw invalid2();
+    throw invalid3();
   const distinct = [];
   const seen = new Set;
   for (const name of names) {
     if (typeof name !== "string" || !safeEnrichmentName(name))
-      throw invalid2();
+      throw invalid3();
     if (seen.has(name))
       continue;
     if (seen.size === 16)
-      throw invalid2();
+      throw invalid3();
     seen.add(name);
     distinct.push(name);
   }
@@ -22998,15 +23043,15 @@ var files = {
   async create(input, options) {
     const context = await resolveFilesContext();
     if (!input || typeof input !== "object" || Array.isArray(input) || Object.keys(input).some((key) => !["file", "size", "path", "name", "storage", "csv"].includes(key)) || options !== undefined && (!options || typeof options !== "object" || Array.isArray(options) || Object.keys(options).some((key) => key !== "requestKey")))
-      throw invalid2();
+      throw invalid3();
     const blob = input.file instanceof Blob;
     const array2 = input.file instanceof Uint8Array;
     const stream = input.file instanceof ReadableStream;
     if (!blob && !array2 && !stream)
-      throw invalid2();
+      throw invalid3();
     const intrinsic = blob ? input.file.size : array2 ? input.file.byteLength : undefined;
     if (intrinsic !== undefined && input.size !== undefined && input.size !== intrinsic)
-      throw invalid2();
+      throw invalid3();
     let name = input.name;
     if (name === undefined && blob && "name" in input.file && typeof input.file.name === "string") {
       name = typeof globalThis.File !== "undefined" && input.file instanceof globalThis.File ? input.file.name : input.file.name.split(/[\\/]/).at(-1);
@@ -23023,7 +23068,7 @@ var files = {
       throw new FileOperationError("unsupported_context", 400);
     const header = encodeURIComponent(JSON.stringify(metadata));
     if (new TextEncoder().encode(header).byteLength > METADATA_BYTES)
-      throw invalid2();
+      throw invalid3();
     if (active >= MAX_ACTIVE)
       throw new FileOperationError("capacity", 429, true);
     active++;
@@ -23057,7 +23102,7 @@ var files = {
       try {
         const bytes = array2 ? input.file.slice() : await boundedBytes(blob ? input.file.stream() : input.file, metadata.size);
         if (bytes.byteLength !== metadata.size)
-          throw invalid2();
+          throw invalid3();
         if (signal.aborted)
           throw unavailable();
         return await send("", {
@@ -23075,7 +23120,7 @@ var files = {
   async enrich(input) {
     const context = await resolveFilesContext();
     if (!input || typeof input !== "object" || Array.isArray(input) || Object.keys(input).some((key) => !["file", "name", "content", "mediaType", "replace"].includes(key)) || typeof input.content !== "string" && !(input.content instanceof Uint8Array))
-      throw invalid2();
+      throw invalid3();
     const path = `${idPath(input.file)}/enrichments`;
     if (typeof input.content === "string" ? input.content.length > MAX_BYTES : input.content.byteLength > MAX_BYTES)
       throw new FileOperationError("request_too_large", 413);
@@ -23097,7 +23142,7 @@ var files = {
       }, MAX_BYTES);
       const header = encodeURIComponent(JSON.stringify(metadata));
       if (new TextEncoder().encode(header).byteLength > METADATA_BYTES)
-        throw invalid2();
+        throw invalid3();
       const result2 = await send(path, { method: "POST", headers: {
         "content-type": "application/octet-stream",
         "x-oddington-enrichment": header

package/dist/types/packages/sdk/src/public.d.ts

@@ -13,7 +13,7 @@ export { AirtableOperationError } from '../../../shared/airtable-contract.js';
 export type { AirtableField, AirtableTable, AirtableRecord, AirtableListInput, AirtableGetInput, AirtableCreateInput, AirtableUpdateInput, AirtableDeleteInput, AirtableReceipt, AirtableWriteResult, AirtableClient, Connections } from '../../../shared/airtable-contract.js';
 export declare const connections: import('../../../shared/airtable-contract.js').Connections;
 export { DataOperationError } from '../../../shared/data-contract.js';
-export type { DataRepository, DataErrorCode, PublicValueDefinition, PublicField, CollectionSummary, CollectionSchema, QueryScalar, SelectionOptions, RecordSelection, RecordsQuery, DataValue, SelectedRecord, SelectionMetadata, RecordsResult, RecordsSearchOptions, RecordsSearchResult, RecordIdentity, RecordCreation, RecordUpdateSet, DataPublication, DataChangeSet, DataEffect } from '../../../shared/data-contract.js';
+export type { DataRepository, DataErrorCode, PublicValueDefinition, PublicField, CollectionSummary, CollectionSchema, QueryScalar, SelectionOptions, RecordSelection, RecordsQuery, DataValue, SelectedRecord, SelectionMetadata, RecordsResult, RecordsSearchOptions, RecordsSearchResult, HistoryListOptions, HistoryEntry, HistoryChangesOptions, HistoryChange, HistoryChangesResult, RecordIdentity, RecordCreation, RecordUpdateSet, DataPublication, DataChangeSet, DataEffect } from '../../../shared/data-contract.js';
 export declare const data: {
     repository(name: string): import('../../../shared/data-contract.js').DataRepository;
 };

package/dist/types/shared/data-contract.d.ts

@@ -134,6 +134,49 @@ export type DataPublication = {
     updated: RecordIdentity[];
     deleted: RecordIdentity[];
 };
+export type HistoryListOptions = {
+    limit?: number;
+    before?: string;
+};
+export type HistoryChangesOptions = {
+    collections?: string[];
+    refs?: string[];
+    from?: string;
+    through?: string;
+    limit?: number;
+    after?: string;
+};
+export type HistoryEntry = {
+    version: string;
+    publishedAt: string;
+    author: {
+        name: string;
+        email: string;
+    };
+    authoredAt: string;
+    committer: {
+        name: string;
+        email: string;
+    };
+    committedAt: string;
+    message: string;
+    created: string[];
+    updated: string[];
+    deleted: string[];
+};
+export type HistoryChange = Omit<HistoryEntry, 'created' | 'updated' | 'deleted'> & {
+    $ref: string;
+    change: 'created' | 'updated' | 'deleted';
+    before: SelectedRecord | null;
+    after: SelectedRecord | null;
+};
+export type HistoryChangesResult = {
+    $meta: {
+        through: string;
+        next?: string;
+    };
+    changes: HistoryChange[];
+};
 export interface DataChangeSet {
     create(record: RecordCreation): void;
     update(record: RecordIdentity, set: RecordUpdateSet): void;
@@ -150,6 +193,11 @@ export interface DataRepository {
         select(query: RecordsQuery): Promise<RecordsResult>;
         search(query: string, options?: RecordsSearchOptions): Promise<RecordsSearchResult>;
     };
+    history: {
+        list(options?: HistoryListOptions): Promise<HistoryEntry[]>;
+        at(instant: string): Promise<HistoryEntry | null>;
+        changes(options?: HistoryChangesOptions): Promise<HistoryChangesResult>;
+    };
     changes(): DataChangeSet;
 }
 export type DataErrorCode = 'context_unavailable' | 'unauthenticated' | 'access_denied' | 'invalid_query' | 'request_too_large' | 'capacity' | 'unavailable' | 'invalid_change' | 'conflict' | 'publication_pending';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddington/sdk",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Oddington routine and response-handler SDK",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",