@oddington/sdk 0.1.32 → 0.1.34

package/README.md

@@ -452,6 +452,38 @@ is read independently with fresh authority; there is no cross-name revision snap
 Names cannot contain separators or use the reserved `original` basename with
 or without an extension. Enrichments share their parent File's access and retention.
 
+Compose retained Files and ordinary Data changes with the pure `source` helpers:
+
+```ts
+import { data, files, source } from '@oddington/sdk';
+
+const file = await files.create({ file: statementCsv, name: 'October statement.csv',
+  path: 'Statements', storage: 'remote' });
+const statement = source.file({ $ref: '_sources/statement_october', file,
+  locations: [source.location.os(file)] });
+const changes = data.repository('general').changes();
+changes.create({ ...statement, added: '2026-10-20' });
+changes.create({ $ref: 'transactions/one',
+  sources: [source.csv.row(statement.$ref, parsedTransaction.recordPosition)] });
+await changes.publish();
+```
+
+The caller's CSV parser supplies `recordPosition` from the retained statement:
+positions count CSV records from 1, including the header when present. Expanded
+Source occurrences expose `sourceRecord.$fragment` (for example `row=41`),
+while their `$ref` remains the base Record ref. Exact Source reads and unexpanded
+links retain their ordinary Data shapes.
+
+`source.location.gmail({ connection, message, attachment, url? })` and
+`source.location.dropbox({ connection, file, revision?, path?, url? })` build flat
+Locations from successful provider responses. Use
+`source.locations.merge(existingLocations, incomingLocations)` in an ordinary
+guarded Data update. Known objects match by OS File ID, Gmail connection/message/
+attachment, or Dropbox connection/File ID; newer Locations replace old path,
+revision and URL facts. Distinct objects and custom provider values remain.
+Helpers need no initialization and perform no I/O, choose no ref, and add no
+changes. File retention and Data validation/publication remain explicit.
+
 Read a named repository through the authenticated host context:
 
 ```ts

package/dist/browser.js

@@ -140,8 +140,8 @@ function serializable(value, ancestors = /* @__PURE__ */ new Set()) {
   try {
     if (Array.isArray(value))
       return array(value, "JSON array"), value.map((entry) => serializable(entry, ancestors));
-    let source = object(value, "JSON input");
-    return keys(source, Object.keys(source), "JSON input"), Object.fromEntries(Object.entries(source).map(([key, entry]) => [key, serializable(entry, ancestors)]));
+    let source2 = object(value, "JSON input");
+    return keys(source2, Object.keys(source2), "JSON input"), Object.fromEntries(Object.entries(source2).map(([key, entry]) => [key, serializable(entry, ancestors)]));
   } finally {
     ancestors.delete(value);
   }
@@ -235,9 +235,9 @@ function selection(value) {
   return keys(input, ["source"], "selection"), validateResponseDefinition({ type: "selection", source: input.source });
 }
 function validateAuthoredSource(value) {
-  let source = object(value, "response definition");
-  keys(source, ["type", "options", "suggestions", "search"], "response definition"), source.type !== "authored" && fail("Expected authored options");
-  let options = array(source.options, "options").map((entry) => {
+  let source2 = object(value, "response definition");
+  keys(source2, ["type", "options", "suggestions", "search"], "response definition"), source2.type !== "authored" && fail("Expected authored options");
+  let options = array(source2.options, "options").map((entry) => {
     let option = object(entry, "choice");
     keys(option, ["value", "label", "description", "note"], "choice");
     let note;
@@ -252,14 +252,14 @@ function validateAuthoredSource(value) {
       ...note ? { note } : {}
     };
   });
-  if (options.length || fail("Choices require at least one option"), new Set(options.map((option) => option.value)).size !== options.length && fail("Duplicate choice value"), Object.hasOwn(source, "search") || Object.hasOwn(source, "suggestions")) {
-    let labels = object(source.search, "choice search");
+  if (options.length || fail("Choices require at least one option"), new Set(options.map((option) => option.value)).size !== options.length && fail("Duplicate choice value"), Object.hasOwn(source2, "search") || Object.hasOwn(source2, "suggestions")) {
+    let labels = object(source2.search, "choice search");
     keys(labels, ["triggerLabel", "placeholder", "emptyLabel"], "choice search");
     let search = {
       triggerLabel: text(labels.triggerLabel, "search trigger label"),
       placeholder: text(labels.placeholder, "search placeholder"),
       emptyLabel: text(labels.emptyLabel, "search empty label")
-    }, suggestions = array(source.suggestions, "suggestions").map((value2) => id(value2, "suggestion value"));
+    }, suggestions = array(source2.suggestions, "suggestions").map((value2) => id(value2, "suggestion value"));
     return (suggestions.length > 8 || new Set(suggestions).size !== suggestions.length || suggestions.some((value2) => !options.some((option) => option.value === value2))) && fail("Search permits at most eight unique published suggestions"), { type: "authored", options, suggestions, search };
   }
   return options.length > 9 && fail("Choices require one to nine options"), { type: "authored", options };
@@ -271,22 +271,22 @@ function validateRecordReference(value) {
   return (!/^[a-z0-9][a-z0-9._/-]{0,127}$/.test(repository) || /\.\.|\/\//.test(repository) || ref.length > 512 || !/^[_a-zA-Z0-9][a-zA-Z0-9_-]*(\/[_a-zA-Z0-9][a-zA-Z0-9_-]*)+$/.test(ref)) && fail("Invalid Record identity"), { repository, ref };
 }
 function validateRecordSource(value) {
-  let source = object(value, "Record selection");
-  keys(source, ["type", "collection", "refPrefix", "where", "display", "suggestions"], "Record selection"), source.type !== "records" && fail("Expected Record options");
-  let collection = object(source.collection, "collection");
+  let source2 = object(value, "Record selection");
+  keys(source2, ["type", "collection", "refPrefix", "where", "display", "suggestions"], "Record selection"), source2.type !== "records" && fail("Expected Record options");
+  let collection = object(source2.collection, "collection");
   keys(collection, ["repository", "name"], "collection");
   let repository = validateRecordReference({ repository: collection.repository, ref: "records/example" }).repository, name2 = id(collection.name, "collection name");
   /^[a-zA-Z0-9_-]+(?:\/[a-zA-Z0-9_-]+)*$/.test(name2) || fail("Invalid collection name");
-  let refPrefix = source.refPrefix === void 0 ? void 0 : id(source.refPrefix, "Record reference prefix");
+  let refPrefix = source2.refPrefix === void 0 ? void 0 : id(source2.refPrefix, "Record reference prefix");
   refPrefix !== void 0 && (!refPrefix.endsWith("/") || refPrefix.length > 512 || !/^[_a-zA-Z0-9][a-zA-Z0-9_-]*(\/[_a-zA-Z0-9][a-zA-Z0-9_-]*)*\/$/.test(refPrefix)) && fail("Invalid Record reference prefix");
-  let where = object(source.where ?? {}, "Record filter"), fieldName = (name3) => /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name3) && !["constructor", "prototype"].includes(name3);
+  let where = object(source2.where ?? {}, "Record filter"), fieldName = (name3) => /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name3) && !["constructor", "prototype"].includes(name3);
   for (let [name3, value2] of Object.entries(where))
     (!fieldName(name3) || !(value2 === null || ["string", "number", "boolean"].includes(typeof value2)) || typeof value2 == "number" && !Number.isFinite(value2)) && fail("Record filters require scalar equality");
-  let display = object(source.display, "Record display");
+  let display = object(source2.display, "Record display");
   keys(display, ["labelFields"], "Record display");
   let labelFields = distinctIds(display.labelFields, "label fields");
   (labelFields.length > 2 || labelFields.some((name3) => !fieldName(name3))) && fail("Select one or two scalar label fields");
-  let suggestions = array(source.suggestions ?? [], "suggestions").map((value2) => {
+  let suggestions = array(source2.suggestions ?? [], "suggestions").map((value2) => {
     let entry = object(value2, "suggestion");
     keys(entry, ["record", "reason"], "suggestion");
     let record4 = validateRecordReference(entry.record);
@@ -304,61 +304,61 @@ function validateRecordSource(value) {
 function validateResponseDefinition(value) {
   let definition = object(value, "response definition");
   keys(definition, ["type", "source"], "response definition"), definition.type !== "selection" && fail("Expected a selection definition");
-  let source = object(definition.source, "option source");
-  switch (source.type) {
+  let source2 = object(definition.source, "option source");
+  switch (source2.type) {
     case "authored":
-      return { type: "selection", source: validateAuthoredSource(source) };
+      return { type: "selection", source: validateAuthoredSource(source2) };
     case "records":
-      return { type: "selection", source: validateRecordSource(source) };
+      return { type: "selection", source: validateRecordSource(source2) };
     default:
       return fail("Unsupported option source");
   }
 }
 function handlerReference(value) {
-  let source = object(value, "handler reference");
-  return keys(source, ["id", "input"], "handler reference"), { id: id(source.id, "handler ID"), input: serializable(source.input) };
+  let source2 = object(value, "handler reference");
+  return keys(source2, ["id", "input"], "handler reference"), { id: id(source2.id, "handler ID"), input: serializable(source2.input) };
 }
 function defineHandler(value) {
-  let source = object(value, "handler");
-  keys(source, ["id", "results", "run"], "handler");
+  let source2 = object(value, "handler");
+  keys(source2, ["id", "results", "run"], "handler");
   let stable = (value2) => typeof value2 == "string" && /^[a-zA-Z0-9][a-zA-Z0-9_./-]{0,127}$/.test(value2);
-  stable(source.id) || fail("Handler ID must be stable");
-  let results = source.results === void 0 ? void 0 : distinctIds(source.results, "handler results", !1);
-  return results && (results.length > 64 || results.some((result2) => !stable(result2))) && fail("Handler results must be stable IDs"), typeof source.run != "function" && fail("Handler requires a run function"), Object.freeze({ id: value.id, ...results === void 0 ? {} : { results: Object.freeze(results.sort()) }, run: value.run });
+  stable(source2.id) || fail("Handler ID must be stable");
+  let results = source2.results === void 0 ? void 0 : distinctIds(source2.results, "handler results", !1);
+  return results && (results.length > 64 || results.some((result2) => !stable(result2))) && fail("Handler results must be stable IDs"), typeof source2.run != "function" && fail("Handler requires a run function"), Object.freeze({ id: value.id, ...results === void 0 ? {} : { results: Object.freeze(results.sort()) }, run: value.run });
 }
 function respond(handler, input) {
   return defineHandler(handler), handlerReference({ id: handler.id, input });
 }
 function question(value) {
-  let source = object(value, "question");
-  keys(source, ["id", "to", "allowedResponders", "prompt", "instructions", "response", "handler"], "question");
-  let to = personReference(source.to, "question assignee"), allowedResponders = source.allowedResponders === void 0 ? [to] : distinctPeople(source.allowedResponders, "allowed responders");
+  let source2 = object(value, "question");
+  keys(source2, ["id", "to", "allowedResponders", "prompt", "instructions", "response", "handler"], "question");
+  let to = personReference(source2.to, "question assignee"), allowedResponders = source2.allowedResponders === void 0 ? [to] : distinctPeople(source2.allowedResponders, "allowed responders");
   return allowedResponders.includes(to) || fail("Allowed responders must include the assignee"), {
-    id: id(source.id, "question ID"),
+    id: id(source2.id, "question ID"),
     to,
     allowedResponders,
-    prompt: text(source.prompt, "question prompt"),
-    ...source.instructions === void 0 ? {} : { instructions: text(source.instructions, "instructions") },
-    response: validateResponseDefinition(source.response),
-    ...Object.hasOwn(source, "handler") ? { handler: handlerReference(source.handler) } : {}
+    prompt: text(source2.prompt, "question prompt"),
+    ...source2.instructions === void 0 ? {} : { instructions: text(source2.instructions, "instructions") },
+    response: validateResponseDefinition(source2.response),
+    ...Object.hasOwn(source2, "handler") ? { handler: handlerReference(source2.handler) } : {}
   };
 }
-function presentation(source) {
-  let views = source.views === void 0 ? [] : array(source.views, "views").map((entry) => {
+function presentation(source2) {
+  let views = source2.views === void 0 ? [] : array(source2.views, "views").map((entry) => {
     let view = object(entry, "view");
     return keys(view, ["id", "view", "input"], "view"), { id: id(view.id, "view ID"), view: id(view.view, "view name"), input: serializable(view.input) };
   });
   new Set(views.map((view) => view.id)).size !== views.length && fail("Duplicate view ID");
-  let body = source.body === void 0 ? [] : array(source.body, "body").map(validateBlock);
+  let body = source2.body === void 0 ? [] : array(source2.body, "body").map(validateBlock);
   for (let block2 of body) {
     let targets = block2.kind === "record" ? [block2.view] : block2.kind === "records" ? [block2.view, ...block2.records.map((record4) => record4.view)] : [];
     for (let target of targets) target !== void 0 && !views.some((view) => view.id === target) && fail(`Unknown Block View target: ${target}`);
   }
-  return { title: text(source.title, "title"), description: text(source.description, "description"), views, body };
+  return { title: text(source2.title, "title"), description: text(source2.description, "description"), views, body };
 }
 function validatePublication(value) {
-  let source = object(value, "publication");
-  source.kind !== "ask" && source.kind !== "digest" && fail("Publication requires an explicit kind"), keys(source, [
+  let source2 = object(value, "publication");
+  source2.kind !== "ask" && source2.kind !== "digest" && fail("Publication requires an explicit kind"), keys(source2, [
     "kind",
     "title",
     "description",
@@ -366,25 +366,25 @@ function validatePublication(value) {
     "views",
     "body",
     "notifyImmediately",
-    ...source.kind === "ask" ? ["questions", "tags", "recordRefs"] : []
-  ], "publication"), source.notifyImmediately !== void 0 && typeof source.notifyImmediately != "boolean" && fail("notifyImmediately must be a boolean");
-  let itemPresentation = { ...presentation(source), ...source.notifyImmediately === void 0 ? {} : { notifyImmediately: source.notifyImmediately } }, linkedAsks = (itemPresentation.body ?? []).flatMap((block2) => block2.kind === "asks" ? block2.asks : []);
-  if (new Set(linkedAsks).size !== linkedAsks.length && fail("Ask belongs to more than one problem"), source.kind === "digest") return {
+    ...source2.kind === "ask" ? ["questions", "tags", "recordRefs"] : []
+  ], "publication"), source2.notifyImmediately !== void 0 && typeof source2.notifyImmediately != "boolean" && fail("notifyImmediately must be a boolean");
+  let itemPresentation = { ...presentation(source2), ...source2.notifyImmediately === void 0 ? {} : { notifyImmediately: source2.notifyImmediately } }, linkedAsks = (itemPresentation.body ?? []).flatMap((block2) => block2.kind === "asks" ? block2.asks : []);
+  if (new Set(linkedAsks).size !== linkedAsks.length && fail("Ask belongs to more than one problem"), source2.kind === "digest") return {
     kind: "digest",
     ...itemPresentation,
-    recipients: distinctPeople(source.recipients, "digest recipients")
+    recipients: distinctPeople(source2.recipients, "digest recipients")
   };
   itemPresentation.body?.some((block2) => block2.kind === "asks") && fail("Asks Blocks belong to Digests");
-  let questions = array(source.questions === void 0 ? [] : source.questions, "questions").map((value2) => question(value2));
+  let questions = array(source2.questions === void 0 ? [] : source2.questions, "questions").map((value2) => question(value2));
   new Set(questions.map((entry) => entry.id)).size !== questions.length && fail("Duplicate question ID");
-  let extra = source.recipients === void 0 ? [] : distinctPeople(source.recipients, "recipients", !1);
+  let extra = source2.recipients === void 0 ? [] : distinctPeople(source2.recipients, "recipients", !1);
   !questions.length && !extra.length && fail("Ask requires at least one recipient");
-  let tags = array(source.tags === void 0 ? [] : source.tags, "Ask tags").map((value2) => {
+  let tags = array(source2.tags === void 0 ? [] : source2.tags, "Ask tags").map((value2) => {
     let tag = text(value2, "Ask tag");
     return new TextEncoder().encode(tag).byteLength > 64 && fail("Ask tag exceeds 64 UTF-8 bytes"), tag;
   });
   (tags.length > 32 || new Set(tags).size !== tags.length) && fail("Ask tags exceed bounds or contain duplicates");
-  let recordRefs = array(source.recordRefs === void 0 ? [] : source.recordRefs, "Ask Record references").map((value2) => {
+  let recordRefs = array(source2.recordRefs === void 0 ? [] : source2.recordRefs, "Ask Record references").map((value2) => {
     let row = object(value2, "Ask Record reference");
     keys(row, ["repository", "id"], "Ask Record reference");
     let { repository, ref } = validateRecordReference({ repository: row.repository, ref: row.id });
@@ -400,25 +400,25 @@ function validatePublication(value) {
   };
 }
 function continueAsk(value) {
-  let source = object(value, "continueAsk");
-  return keys(source, [], "continueAsk"), { type: "continue" };
+  let source2 = object(value, "continueAsk");
+  return keys(source2, [], "continueAsk"), { type: "continue" };
 }
 function resolution(value) {
-  let source = object(value, "resolution");
-  return keys(source, ["outcome", "evidence"], "resolution"), { outcome: text(source.outcome, "outcome"), ...source.evidence === void 0 ? {} : {
-    evidence: array(source.evidence, "evidence").map((entry) => serializable(entry))
+  let source2 = object(value, "resolution");
+  return keys(source2, ["outcome", "evidence"], "resolution"), { outcome: text(source2.outcome, "outcome"), ...source2.evidence === void 0 ? {} : {
+    evidence: array(source2.evidence, "evidence").map((entry) => serializable(entry))
   } };
 }
 function resolveAsk(value) {
   return { type: "resolve", ...resolution(value) };
 }
 function validateResolution(value) {
-  let source = object(value, "published resolution");
-  return keys(source, ["expectedRevision", "outcome", "evidence"], "published resolution"), (!Number.isSafeInteger(source.expectedRevision) || source.expectedRevision < 1) && fail("Expected revision must be a positive integer"), {
-    expectedRevision: source.expectedRevision,
+  let source2 = object(value, "published resolution");
+  return keys(source2, ["expectedRevision", "outcome", "evidence"], "published resolution"), (!Number.isSafeInteger(source2.expectedRevision) || source2.expectedRevision < 1) && fail("Expected revision must be a positive integer"), {
+    expectedRevision: source2.expectedRevision,
     ...resolution({
-      outcome: source.outcome,
-      ...source.evidence === void 0 ? {} : { evidence: source.evidence }
+      outcome: source2.outcome,
+      ...source2.evidence === void 0 ? {} : { evidence: source2.evidence }
     })
   };
 }
@@ -429,20 +429,20 @@ function publicationRequestKey(value) {
 function createInboxPublisher(transport) {
   return {
     async publishAsk(value, options) {
-      let source = object(value, "ask");
-      keys(source, ["title", "description", "recipients", "views", "body", "questions", "notifyImmediately", "tags", "recordRefs"], "ask");
+      let source2 = object(value, "ask");
+      keys(source2, ["title", "description", "recipients", "views", "body", "questions", "notifyImmediately", "tags", "recordRefs"], "ask");
       let result2 = await transport.publish({
         requestKey: publicationRequestKey(options),
-        item: validatePublication({ ...source, kind: "ask" })
+        item: validatePublication({ ...source2, kind: "ask" })
       });
       return id(result2.id, "published ask ID"), (!("revision" in result2) || !Number.isSafeInteger(result2.revision) || result2.revision !== 1) && fail("Initial ask publication must return revision 1"), { id: result2.id, revision: result2.revision };
     },
     async publishDigest(value, options) {
-      let source = object(value, "digest");
-      keys(source, ["title", "description", "recipients", "views", "body", "notifyImmediately"], "digest");
+      let source2 = object(value, "digest");
+      keys(source2, ["title", "description", "recipients", "views", "body", "notifyImmediately"], "digest");
       let result2 = await transport.publish({
         requestKey: publicationRequestKey(options),
-        item: validatePublication({ ...source, kind: "digest" })
+        item: validatePublication({ ...source2, kind: "digest" })
       });
       return { id: id(result2.id, "published digest ID") };
     },
@@ -1406,11 +1406,11 @@ async function hostedContent(url, init2, parent, upstream = fetch, check = async
     }
     if (!response2.body)
       return detach(), response2;
-    let source = response2.body, reader, settled = !1, output, cancel = async (reason) => {
+    let source2 = response2.body, reader, settled = !1, output, cancel = async (reason) => {
       if (!settled) {
         settled = !0, detach(), delivery.signal.removeEventListener("abort", stop), delivery.abort(reason);
         try {
-          await (reader ? reader.cancel(reason) : source.cancel(reason));
+          await (reader ? reader.cancel(reason) : source2.cancel(reason));
         } catch (error) {
           if (error !== delivery.signal.reason && !(error instanceof Error && error.name === "AbortError")) throw error;
         } finally {
@@ -1429,7 +1429,7 @@ async function hostedContent(url, init2, parent, upstream = fetch, check = async
       async pull(controller) {
         try {
           if (await check(), settled) return;
-          reader ??= source.getReader();
+          reader ??= source2.getReader();
           let { done, value } = await reader.read();
           if (await check(), settled) return;
           done ? (settled = !0, detach(), delivery.signal.removeEventListener("abort", stop), reader.releaseLock(), controller.close()) : controller.enqueue(value);
@@ -2192,6 +2192,68 @@ function validCreatePath(value) {
   return value === value.trim() && value.endsWith(".md") && !value.startsWith("/") && value.split("/").every((segment) => !!segment && ![".", ".."].includes(segment) && /^[a-zA-Z0-9_.-]+$/.test(segment));
 }
 
+function locationIdentity(location) {
+  let coordinates = location.provider === "os" ? [location.file] : location.provider === "gmail" ? [location.connection, location.message, location.attachment] : location.provider === "dropbox" ? [location.connection, location.file] : void 0;
+  if (coordinates?.every((value) => typeof value == "string" && value.length > 0))
+    return JSON.stringify([location.provider, ...coordinates]);
+}
+var source = {
+  file(input) {
+    return {
+      $ref: input.$ref,
+      type: "source",
+      kind: "file",
+      filename: input.file.name,
+      media_type: input.file.mediaType,
+      size_bytes: input.file.size,
+      sha256: input.file.sha256,
+      locations: input.locations.map((location) => ({ ...location }))
+    };
+  },
+  location: {
+    os(file2) {
+      return { provider: "os", file: file2.id };
+    },
+    gmail(input) {
+      return {
+        provider: "gmail",
+        connection: input.connection,
+        message: input.message,
+        attachment: input.attachment,
+        ...input.url === void 0 ? {} : { url: input.url }
+      };
+    },
+    dropbox(input) {
+      return {
+        provider: "dropbox",
+        connection: input.connection,
+        file: input.file,
+        ...input.revision === void 0 ? {} : { revision: input.revision },
+        ...input.path === void 0 ? {} : { path: input.path },
+        ...input.url === void 0 ? {} : { url: input.url }
+      };
+    }
+  },
+  locations: {
+    merge(existing, incoming) {
+      let merged = existing.map((location) => ({ ...location }));
+      for (let location of incoming) {
+        let identity = locationIdentity(location), index = identity === void 0 ? -1 : merged.findIndex((value) => locationIdentity(value) === identity);
+        index < 0 ? merged.push({ ...location }) : merged[index] = { ...location };
+      }
+      return merged;
+    }
+  },
+  csv: {
+    /** One-based CSV record position; a present header is record 1. */
+    row(baseRef, row) {
+      if (!validRecordRef(baseRef)) throw new TypeError("CSV row links require a base Record ref");
+      if (!Number.isSafeInteger(row) || row < 1) throw new RangeError("CSV row must be a positive safe integer");
+      return `${baseRef}#row=${row}`;
+    }
+  }
+};
+
 var InboxOperationError = class extends Error {
   constructor(status, reason) {
     super(reason === "conflict" ? "This question already has an accepted answer" : reason === "unavailable" ? "Inbox request unavailable. Retry the same action." : reason === "invalid_input" ? "Invalid Inbox request" : "Inbox access unavailable");
@@ -2268,10 +2330,10 @@ function recordReference(value) {
 function responseDefinition(value) {
   let definition = object4(value);
   keys3(definition, ["type", "source"]), assert(definition.type === "selection");
-  let source = object4(definition.source);
-  if (source.type === "authored") {
-    keys3(source, ["type", "options", "suggestions", "search"], ["type", "options"]);
-    let options = array2(source.options);
+  let source2 = object4(definition.source);
+  if (source2.type === "authored") {
+    keys3(source2, ["type", "options", "suggestions", "search"], ["type", "options"]);
+    let options = array2(source2.options);
     assert(options.length > 0);
     let values = options.map((value2) => {
       let option = object4(value2);
@@ -2281,24 +2343,24 @@ function responseDefinition(value) {
       }
       return option.value;
     });
-    if (assert(new Set(values).size === values.length), "search" in source || "suggestions" in source) {
-      let search = object4(source.search);
+    if (assert(new Set(values).size === values.length), "search" in source2 || "suggestions" in source2) {
+      let search = object4(source2.search);
       keys3(search, ["triggerLabel", "placeholder", "emptyLabel"]), assert(text4(search.triggerLabel) && text4(search.placeholder) && text4(search.emptyLabel));
-      let suggestions2 = array2(source.suggestions);
+      let suggestions2 = array2(source2.suggestions);
       assert(suggestions2.length <= 8 && suggestions2.every((value2) => text4(value2) && values.includes(value2)) && new Set(suggestions2).size === suggestions2.length);
     } else assert(options.length <= 9);
     return;
   }
-  assert(source.type === "records"), keys3(source, ["type", "collection", "refPrefix", "where", "display", "suggestions"], ["type", "collection", "display"]);
-  let collection = object4(source.collection);
-  keys3(collection, ["repository", "name"]), recordReference({ repository: collection.repository, ref: "records/example" }), assert(text4(collection.name) && /^[a-zA-Z0-9_-]+(?:\/[a-zA-Z0-9_-]+)*$/.test(collection.name)), "refPrefix" in source && assert(text4(source.refPrefix) && source.refPrefix.length <= 512 && /^[_a-zA-Z0-9][a-zA-Z0-9_-]*(\/[_a-zA-Z0-9][a-zA-Z0-9_-]*)*\/$/.test(source.refPrefix));
-  let where = object4(source.where ?? {});
+  assert(source2.type === "records"), keys3(source2, ["type", "collection", "refPrefix", "where", "display", "suggestions"], ["type", "collection", "display"]);
+  let collection = object4(source2.collection);
+  keys3(collection, ["repository", "name"]), recordReference({ repository: collection.repository, ref: "records/example" }), assert(text4(collection.name) && /^[a-zA-Z0-9_-]+(?:\/[a-zA-Z0-9_-]+)*$/.test(collection.name)), "refPrefix" in source2 && assert(text4(source2.refPrefix) && source2.refPrefix.length <= 512 && /^[_a-zA-Z0-9][a-zA-Z0-9_-]*(\/[_a-zA-Z0-9][a-zA-Z0-9_-]*)*\/$/.test(source2.refPrefix));
+  let where = object4(source2.where ?? {});
   assert(Object.entries(where).every(([name2, value2]) => /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name2) && !["constructor", "prototype"].includes(name2) && (value2 === null || typeof value2 == "string" || typeof value2 == "boolean" || typeof value2 == "number" && Number.isFinite(value2))));
-  let display = object4(source.display);
+  let display = object4(source2.display);
   keys3(display, ["labelFields"]);
   let labels = array2(display.labelFields);
   assert(labels.length > 0 && labels.length <= 2 && new Set(labels).size === labels.length && labels.every((value2) => text4(value2) && /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(value2)));
-  let suggestions = array2(source.suggestions ?? []), refs = suggestions.map((value2) => {
+  let suggestions = array2(source2.suggestions ?? []), refs = suggestions.map((value2) => {
     let suggestion = object4(value2);
     keys3(suggestion, ["record", "reason"], ["record"]);
     let record4 = recordReference(suggestion.record);
@@ -3017,16 +3079,16 @@ async function send2(operation2, input, admitted) {
       }), unavailable3();
     if (operation2 === "files.read") {
       if (!response2.body) throw unavailable3();
-      let source = response2.body, reader, size = 0, cancel = async (reason) => {
+      let source2 = response2.body, reader, size = 0, cancel = async (reason) => {
         try {
-          await (reader ? reader.cancel(reason) : source.cancel(reason));
+          await (reader ? reader.cancel(reason) : source2.cancel(reason));
         } finally {
           reader?.releaseLock();
         }
       }, body = new ReadableStream({
         async pull(controller) {
           try {
-            check(), reader ??= source.getReader();
+            check(), reader ??= source2.getReader();
             let next = await reader.read();
             if (check(), next.done) {
               reader.releaseLock(), controller.close();
@@ -3126,8 +3188,8 @@ var inbox = {
 };
 
 var sources = /* @__PURE__ */ new WeakMap();
-function registerBrowserAuth(handle2, source) {
-  sources.set(handle2, source);
+function registerBrowserAuth(handle2, source2) {
+  sources.set(handle2, source2);
 }
 function browserAuthSource(handle2) {
   return sources.get(handle2);
@@ -3867,7 +3929,7 @@ function validateFileAddOptions(value) {
 var PREPARED_RECORD_INPUT_LIMIT = 64 * 1024 * 1024;
 
 function routineDataEnvelope(command) {
-  return "preflight" in command ? { operation: "changes.validate", captured: command.preflight } : "apply" in command ? { operation: "changes.publish", captured: command.apply } : { operation: "changes.publish", request: command };
+  return "apply" in command ? { operation: "changes.publish", captured: command.apply } : { operation: "changes.publish", request: command };
 }
 
 function routinePublicationClient2(options = {}) {
@@ -3970,5 +4032,6 @@ export {
   richTextBlock,
   routinePublicationClient2 as routinePublicationClient,
   schema,
-  selection
+  selection,
+  source
 };