@sixb/core 0.1.19 → 0.1.21

package/dist/chunk-48qjhh6v.js

@@ -0,0 +1,185 @@
+// @bun
+import {
+  ARTIFACT_LIMITS2,
+  isArtifactAddress2,
+  parseArtifactAddress2
+} from "./chunk-mjddfa7k.js";
+import {
+  isValidFileRef
+} from "./chunk-wkv3h3q7.js";
+import {
+  statFileRef2
+} from "./chunk-a3faa34j.js";
+
+// src/artifacts/errors.ts
+class ArtifactRequestError2 extends Error {
+  code;
+  name = "ArtifactRequestError";
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+}
+
+// src/artifacts/html.ts
+var NAMED_ENTITIES = {
+  amp: "&",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'",
+  nbsp: String.fromCharCode(160)
+};
+function decodeHtmlEntities(value) {
+  return value.replace(/&(#x[\da-f]+|#\d+|[a-z]+);/gi, (match, entity) => {
+    if (entity[0] !== "#")
+      return NAMED_ENTITIES[entity.toLowerCase()] ?? match;
+    const codePoint = entity[1]?.toLowerCase() === "x" ? Number.parseInt(entity.slice(2), 16) : Number(entity.slice(1));
+    return Number.isInteger(codePoint) && codePoint >= 0 && codePoint <= 1114111 ? String.fromCodePoint(codePoint) : match;
+  });
+}
+
+// src/artifacts/publish/files.ts
+async function checkArtifactFiles(blobStorage, files) {
+  if (files.length === 0)
+    throw invalidArtifact("A version needs at least one file.");
+  if (files.length > ARTIFACT_LIMITS2.maxFiles) {
+    throw invalidArtifact(`A version holds at most ${ARTIFACT_LIMITS2.maxFiles} files; this one has ${files.length}.`);
+  }
+  const paths = new Set;
+  let totalBytes = 0;
+  for (const entry of files) {
+    if (!isArtifactPath(entry.path)) {
+      throw invalidArtifact(`'${entry.path}' is not a usable file path: use a relative path with / separators, no . or .. segments, and at most ${ARTIFACT_LIMITS2.maxPathLength} characters.`);
+    }
+    if (paths.has(entry.path))
+      throw invalidArtifact(`'${entry.path}' appears twice.`);
+    paths.add(entry.path);
+    if (!isValidFileRef(entry.file)) {
+      throw invalidArtifact(`'${entry.path}' does not have a valid file reference.`);
+    }
+    if (entry.file.sizeBytes > ARTIFACT_LIMITS2.maxFileBytes) {
+      throw invalidArtifact(`'${entry.path}' is ${entry.file.sizeBytes} bytes; a file may be at most ${ARTIFACT_LIMITS2.maxFileBytes}.`);
+    }
+    totalBytes += entry.file.sizeBytes;
+  }
+  if (totalBytes > ARTIFACT_LIMITS2.maxVersionBytes) {
+    throw invalidArtifact(`The files total ${totalBytes} bytes; a version may hold at most ${ARTIFACT_LIMITS2.maxVersionBytes}.`);
+  }
+  const stored = await Promise.all(files.map((entry) => statFileRef2(blobStorage, entry.file)));
+  const missing = files.find((_, index) => !stored[index]);
+  if (missing)
+    throw invalidArtifact(`'${missing.path}' refers to a file that is not stored.`);
+}
+async function readArtifactText(blobStorage, file, maxBytes) {
+  if (file.file.sizeBytes > maxBytes) {
+    throw invalidArtifact(`'${file.path}' is ${file.file.sizeBytes} bytes; it may be at most ${maxBytes}.`);
+  }
+  const text = await new Response(await blobStorage.open(file.file.blobId)).text();
+  return text.charCodeAt(0) === 65279 ? text.slice(1) : text;
+}
+function isArtifactPath(path) {
+  return typeof path === "string" && path.length > 0 && path.length <= ARTIFACT_LIMITS2.maxPathLength && !path.startsWith("/") && !path.includes("\\") && !/[\u0000-\u001f\u007f]/.test(path) && path.split("/").every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
+}
+function invalidArtifact(message) {
+  return new ArtifactRequestError2("invalid_artifact", `[Sixb] ${message}`);
+}
+
+// src/artifacts/publish/validate/slides.ts
+var SLIDES_ENTRY2 = "index.html";
+var FRAME_ASSET_PREFIX = "__sixb/";
+async function validateSlides(blobStorage, files) {
+  const entry = files.find((file) => file.path === SLIDES_ENTRY2);
+  if (!entry) {
+    throw invalidArtifact(`A deck needs '${SLIDES_ENTRY2}' with one <section class="slide"> per slide.`);
+  }
+  const reserved = files.find((file) => file.path.startsWith(FRAME_ASSET_PREFIX));
+  if (reserved) {
+    throw invalidArtifact(`'${reserved.path}' is under ${FRAME_ASSET_PREFIX}, where Sixb serves the deck's kit and runtime: move it.`);
+  }
+  const html = await readArtifactText(blobStorage, entry, ARTIFACT_LIMITS2.maxDeckBytes);
+  const slides = [];
+  const references = [];
+  let refused;
+  const at = () => String(Math.max(1, slides.length));
+  let reading = null;
+  new HTMLRewriter().on("section", {
+    element(element) {
+      const classes = (element.getAttribute("class") ?? "").split(/\s+/);
+      if (classes.includes("slide"))
+        slides.push({ title: "", heading: false });
+    }
+  }).on("h1, h2, h3", {
+    element(element) {
+      const slide = slides.at(-1);
+      if (!slide || slide.heading)
+        return;
+      slide.heading = true;
+      reading = slide;
+      element.onEndTag(() => {
+        reading = null;
+      });
+    },
+    text(chunk) {
+      if (reading)
+        reading.title += chunk.text;
+    }
+  }).on("a[href]", {
+    element(element) {
+      const href = decodeHtmlEntities(element.getAttribute("href") ?? "");
+      if (isArtifactAddress2(href)) {
+        references.push({ address: href.trim(), as: "link", at: at() });
+      }
+    }
+  }).on("img[src]", {
+    element(element) {
+      const source = decodeHtmlEntities(element.getAttribute("src") ?? "").trim();
+      if (!isArtifactAddress2(source))
+        return;
+      if (!parseArtifactAddress2(source)?.path) {
+        refused ??= `An <img> shows a file from another artifact, and '${source}' names none: show a chart, a range, a section, or a slide with <sixb-embed src="${source}"></sixb-embed>.`;
+        return;
+      }
+      references.push({ address: source, as: "embed", at: at() });
+    }
+  }).on("sixb-embed", {
+    element(element) {
+      const source = decodeHtmlEntities(element.getAttribute("src") ?? "").trim();
+      if (!isArtifactAddress2(source)) {
+        refused ??= `<sixb-embed> shows another artifact: give it src="artifact:\u2026", such as artifact:art_k3m9q2x7tp#chart=revenue.`;
+        return;
+      }
+      references.push({ address: source, as: "embed", at: at() });
+    }
+  }).on("iframe[src], object[data], embed[src]", {
+    element(element) {
+      const source = decodeHtmlEntities(element.getAttribute("src") ?? element.getAttribute("data") ?? "").trim();
+      if (isArtifactAddress2(source)) {
+        refused ??= `${SLIDES_ENTRY2} frames '${source}': show another artifact with <sixb-embed src="${source}"></sixb-embed>, or a file of one with <img>.`;
+      }
+    }
+  }).transform(html);
+  if (refused)
+    throw invalidArtifact(refused);
+  if (slides.length === 0) {
+    throw invalidArtifact(`${SLIDES_ENTRY2} has no slides: put each slide in a <section class="slide">.`);
+  }
+  if (slides.length > ARTIFACT_LIMITS2.maxSlides) {
+    throw invalidArtifact(`A deck holds at most ${ARTIFACT_LIMITS2.maxSlides} slides; this one has ${slides.length}.`);
+  }
+  return {
+    entry: SLIDES_ENTRY2,
+    outline: {
+      kind: "slides",
+      slides: slides.map(({ title }) => {
+        const plain = decodeHtmlEntities(title).replace(/\s+/g, " ").trim();
+        return plain ? { title: plain } : {};
+      })
+    },
+    references
+  };
+}
+
+export { ArtifactRequestError2, checkArtifactFiles, readArtifactText, invalidArtifact, decodeHtmlEntities, SLIDES_ENTRY2, FRAME_ASSET_PREFIX, validateSlides };
+
+//# debugId=ED695A8232578D1464756E2164756E21

package/dist/chunk-48qjhh6v.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/artifacts/errors.ts", "../src/artifacts/html.ts", "../src/artifacts/publish/files.ts", "../src/artifacts/publish/validate/slides.ts"],
+  "sourcesContent": [
+    "export type ArtifactRequestErrorCode =\n  | \"artifact_not_found\"\n  | \"artifact_kind_mismatch\"\n  | \"invalid_artifact\"\n  | \"not_allowed\"\n  | \"storage_unavailable\"\n\n/**\n * Error for an artifact request the caller can correct or must be told about. Callers branch on\n * `code`; the message says what to change.\n */\nexport class ArtifactRequestError extends Error {\n  readonly name = \"ArtifactRequestError\"\n\n  constructor(\n    readonly code: ArtifactRequestErrorCode,\n    message: string\n  ) {\n    super(message)\n  }\n}\n",
+    "const NAMED_ENTITIES: Readonly<Record<string, string>> = {\n  amp: \"&\",\n  lt: \"<\",\n  gt: \">\",\n  quot: '\"',\n  apos: \"'\",\n  nbsp: String.fromCharCode(0xa0),\n}\n\n/**\n * Text or an attribute as the browser reads it. HTMLRewriter hands both over as written in the\n * HTML, entities included, so `artifact:…#Q3%20&amp;%20Q4` must read `&` before it is resolved.\n */\nexport function decodeHtmlEntities(value: string): string {\n  return value.replace(/&(#x[\\da-f]+|#\\d+|[a-z]+);/gi, (match, entity: string) => {\n    if (entity[0] !== \"#\") return NAMED_ENTITIES[entity.toLowerCase()] ?? match\n    const codePoint =\n      entity[1]?.toLowerCase() === \"x\"\n        ? Number.parseInt(entity.slice(2), 16)\n        : Number(entity.slice(1))\n    return Number.isInteger(codePoint) && codePoint >= 0 && codePoint <= 0x10ffff\n      ? String.fromCodePoint(codePoint)\n      : match\n  })\n}\n",
+    "import { statFileRef } from \"../../blob-storage/file-content\"\nimport type { BlobStorage } from \"../../blob-storage/types\"\nimport { isValidFileRef } from \"../../blob-storage/validation\"\nimport type { ArtifactFile } from \"../../storage/artifacts/types\"\nimport { ArtifactRequestError } from \"../errors\"\nimport { ARTIFACT_LIMITS } from \"../limits\"\n\nexport type ArtifactBlobStorage = Pick<BlobStorage, \"stat\" | \"open\">\n\n/**\n * Checks a version's files before anything reads them: safe unique paths, the per-version limits,\n * and stored bytes that match each reference.\n */\nexport async function checkArtifactFiles(\n  blobStorage: ArtifactBlobStorage,\n  files: readonly ArtifactFile[]\n): Promise<void> {\n  if (files.length === 0) throw invalidArtifact(\"A version needs at least one file.\")\n  if (files.length > ARTIFACT_LIMITS.maxFiles) {\n    throw invalidArtifact(\n      `A version holds at most ${ARTIFACT_LIMITS.maxFiles} files; this one has ${files.length}.`\n    )\n  }\n\n  const paths = new Set<string>()\n  let totalBytes = 0\n  for (const entry of files) {\n    if (!isArtifactPath(entry.path)) {\n      throw invalidArtifact(\n        `'${entry.path}' is not a usable file path: use a relative path with / separators, no . or .. segments, and at most ${ARTIFACT_LIMITS.maxPathLength} characters.`\n      )\n    }\n    if (paths.has(entry.path)) throw invalidArtifact(`'${entry.path}' appears twice.`)\n    paths.add(entry.path)\n    if (!isValidFileRef(entry.file)) {\n      throw invalidArtifact(`'${entry.path}' does not have a valid file reference.`)\n    }\n    if (entry.file.sizeBytes > ARTIFACT_LIMITS.maxFileBytes) {\n      throw invalidArtifact(\n        `'${entry.path}' is ${entry.file.sizeBytes} bytes; a file may be at most ${ARTIFACT_LIMITS.maxFileBytes}.`\n      )\n    }\n    totalBytes += entry.file.sizeBytes\n  }\n  if (totalBytes > ARTIFACT_LIMITS.maxVersionBytes) {\n    throw invalidArtifact(\n      `The files total ${totalBytes} bytes; a version may hold at most ${ARTIFACT_LIMITS.maxVersionBytes}.`\n    )\n  }\n\n  const stored = await Promise.all(files.map((entry) => statFileRef(blobStorage, entry.file)))\n  const missing = files.find((_, index) => !stored[index])\n  if (missing) throw invalidArtifact(`'${missing.path}' refers to a file that is not stored.`)\n}\n\n/** The file at `path`, read as UTF-8 text when it is no larger than `maxBytes`. */\nexport async function readArtifactText(\n  blobStorage: ArtifactBlobStorage,\n  file: ArtifactFile,\n  maxBytes: number\n): Promise<string> {\n  if (file.file.sizeBytes > maxBytes) {\n    throw invalidArtifact(\n      `'${file.path}' is ${file.file.sizeBytes} bytes; it may be at most ${maxBytes}.`\n    )\n  }\n  const text = await new Response(await blobStorage.open(file.file.blobId)).text()\n  // A byte-order mark is not part of the text.\n  return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text\n}\n\n/** Relative, `/`-separated, no empty, `.`, or `..` segment, no backslash or control character. */\nexport function isArtifactPath(path: string): boolean {\n  return (\n    typeof path === \"string\" &&\n    path.length > 0 &&\n    path.length <= ARTIFACT_LIMITS.maxPathLength &&\n    !path.startsWith(\"/\") &&\n    !path.includes(\"\\\\\") &&\n    !/[\\u0000-\\u001f\\u007f]/.test(path) &&\n    path.split(\"/\").every((segment) => segment.length > 0 && segment !== \".\" && segment !== \"..\")\n  )\n}\n\nexport function invalidArtifact(message: string): ArtifactRequestError {\n  return new ArtifactRequestError(\"invalid_artifact\", `[Sixb] ${message}`)\n}\n",
+    "import type { ArtifactFile } from \"../../../storage/artifacts/types\"\nimport { isArtifactAddress, parseArtifactAddress } from \"../../address\"\nimport { decodeHtmlEntities } from \"../../html\"\nimport { ARTIFACT_LIMITS } from \"../../limits\"\nimport type { SlidesOutline } from \"../../outline\"\nimport { type ArtifactBlobStorage, invalidArtifact, readArtifactText } from \"../files\"\nimport type { FoundReference } from \"../references\"\n\n/** The file a deck renders from. */\nexport const SLIDES_ENTRY = \"index.html\"\n\n/** Where the frame serves the kit and the runtime, beside a deck's own files. */\nexport const FRAME_ASSET_PREFIX = \"__sixb/\"\n\n/**\n * Reads a deck: `index.html` with one `<section class=\"slide\">` per 1280×720 slide, and the files\n * it loads beside it. Each slide's first heading becomes its title in the outline. The `artifact:`\n * addresses it uses are returned with the slide each is on, to resolve: links (`<a href>`), files\n * it shows from other artifacts (`<img src>`), and anything else it shows (`<sixb-embed src>`), a\n * chart, a range, a section, or a slide, which the app draws over the frame.\n */\nexport async function validateSlides(\n  blobStorage: ArtifactBlobStorage,\n  files: readonly ArtifactFile[]\n): Promise<{\n  readonly entry: string\n  readonly outline: SlidesOutline\n  readonly references: readonly FoundReference[]\n}> {\n  const entry = files.find((file) => file.path === SLIDES_ENTRY)\n  if (!entry) {\n    throw invalidArtifact(\n      `A deck needs '${SLIDES_ENTRY}' with one <section class=\"slide\"> per slide.`\n    )\n  }\n  const reserved = files.find((file) => file.path.startsWith(FRAME_ASSET_PREFIX))\n  if (reserved) {\n    throw invalidArtifact(\n      `'${reserved.path}' is under ${FRAME_ASSET_PREFIX}, where Sixb serves the deck's kit and runtime: move it.`\n    )\n  }\n  const html = await readArtifactText(blobStorage, entry, ARTIFACT_LIMITS.maxDeckBytes)\n\n  const slides: { title: string; heading: boolean }[] = []\n  const references: FoundReference[] = []\n  let refused: string | undefined\n  const at = () => String(Math.max(1, slides.length))\n  // The heading being read, if it is the first of the current slide.\n  let reading: { title: string; heading: boolean } | null = null\n  new HTMLRewriter()\n    .on(\"section\", {\n      element(element) {\n        const classes = (element.getAttribute(\"class\") ?? \"\").split(/\\s+/)\n        if (classes.includes(\"slide\")) slides.push({ title: \"\", heading: false })\n      },\n    })\n    .on(\"h1, h2, h3\", {\n      element(element) {\n        const slide = slides.at(-1)\n        if (!slide || slide.heading) return\n        slide.heading = true\n        reading = slide\n        element.onEndTag(() => {\n          reading = null\n        })\n      },\n      text(chunk) {\n        if (reading) reading.title += chunk.text\n      },\n    })\n    .on(\"a[href]\", {\n      element(element) {\n        const href = decodeHtmlEntities(element.getAttribute(\"href\") ?? \"\")\n        if (isArtifactAddress(href)) {\n          references.push({ address: href.trim(), as: \"link\", at: at() })\n        }\n      },\n    })\n    .on(\"img[src]\", {\n      element(element) {\n        const source = decodeHtmlEntities(element.getAttribute(\"src\") ?? \"\").trim()\n        if (!isArtifactAddress(source)) return\n        if (!parseArtifactAddress(source)?.path) {\n          refused ??= `An <img> shows a file from another artifact, and '${source}' names none: show a chart, a range, a section, or a slide with <sixb-embed src=\"${source}\"></sixb-embed>.`\n          return\n        }\n        references.push({ address: source, as: \"embed\", at: at() })\n      },\n    })\n    .on(\"sixb-embed\", {\n      element(element) {\n        const source = decodeHtmlEntities(element.getAttribute(\"src\") ?? \"\").trim()\n        if (!isArtifactAddress(source)) {\n          refused ??= `<sixb-embed> shows another artifact: give it src=\"artifact:…\", such as artifact:art_k3m9q2x7tp#chart=revenue.`\n          return\n        }\n        references.push({ address: source, as: \"embed\", at: at() })\n      },\n    })\n    .on(\"iframe[src], object[data], embed[src]\", {\n      element(element) {\n        const source = decodeHtmlEntities(\n          element.getAttribute(\"src\") ?? element.getAttribute(\"data\") ?? \"\"\n        ).trim()\n        if (isArtifactAddress(source)) {\n          refused ??= `${SLIDES_ENTRY} frames '${source}': show another artifact with <sixb-embed src=\"${source}\"></sixb-embed>, or a file of one with <img>.`\n        }\n      },\n    })\n    .transform(html)\n\n  if (refused) throw invalidArtifact(refused)\n  if (slides.length === 0) {\n    throw invalidArtifact(\n      `${SLIDES_ENTRY} has no slides: put each slide in a <section class=\"slide\">.`\n    )\n  }\n  if (slides.length > ARTIFACT_LIMITS.maxSlides) {\n    throw invalidArtifact(\n      `A deck holds at most ${ARTIFACT_LIMITS.maxSlides} slides; this one has ${slides.length}.`\n    )\n  }\n  return {\n    entry: SLIDES_ENTRY,\n    outline: {\n      kind: \"slides\",\n      slides: slides.map(({ title }) => {\n        const plain = decodeHtmlEntities(title).replace(/\\s+/g, \" \").trim()\n        return plain ? { title: plain } : {}\n      }),\n    },\n    references,\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "ED695A8232578D1464756E2164756E21",
+  "names": []
+}

package/dist/{chunk-80mc0971.js → chunk-561r0yc9.js}

@@ -13,31 +13,31 @@ import {
   ShareDefinitionError2,
   isShareDefinition,
   snapshotShareDefinition
-} from "./chunk-3gnrh4ve.js";
+} from "./chunk-nn5xnx3s.js";
 import {
   isProjectionDefinition2
-} from "./chunk-y7rqfrgg.js";
+} from "./chunk-6vb4st8k.js";
 import {
   isMarkingDefinition,
   isGroupDefinition,
   isMembershipPolicyDefinition,
   isRoleDefinition
-} from "./chunk-xt1zt7gv.js";
+} from "./chunk-f4pamkt9.js";
 import {
   isWorkflowDefinition2
-} from "./chunk-ey3pyej1.js";
+} from "./chunk-akzryx9h.js";
 import {
   isDatasetDefinition2
-} from "./chunk-rz53yb4v.js";
+} from "./chunk-q5e5tv4b.js";
 import {
   isPipelineDefinition2
-} from "./chunk-tjb1mk5t.js";
+} from "./chunk-5vems3nx.js";
 import {
   isSyncDefinition2
-} from "./chunk-rhg02hxq.js";
+} from "./chunk-d7dnxdep.js";
 import {
   compileShareAccessPlan
-} from "./chunk-52bk93x8.js";
+} from "./chunk-z58tm0hm.js";
 import {
   RuntimeError2
 } from "./chunk-m4ehq95f.js";

package/dist/{chunk-5e43w60z.js → chunk-5948n82c.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   parseSixbFailure2
-} from "./chunk-8mx7qw3y.js";
+} from "./chunk-dvd2fp9q.js";
 import {
   AGENT_RUN_FAILURE_CODES2
-} from "./chunk-hkc3jct7.js";
+} from "./chunk-c06hmxyy.js";
 import {
   isJsonValue2,
   isPlainRecord

package/dist/{chunk-yzwja0mj.js → chunk-5hx48dnn.js}

@@ -3,14 +3,14 @@ import {
   createSixbError2,
   toSixbFailure2,
   serializeSixbFailure2
-} from "./chunk-8mx7qw3y.js";
+} from "./chunk-dvd2fp9q.js";
 import {
   ONTOLOGY_OUTBOX_FAILURE_CODES2
 } from "./chunk-d62kjtbg.js";
 import {
   SixbErrorReporter2,
   reportEventDeliveryFailure3
-} from "./chunk-7t429e3f.js";
+} from "./chunk-xvsc5m8n.js";
 import {
   getInvalidJsonValueReason2
 } from "./chunk-wy0qdqfm.js";

package/dist/{chunk-tjb1mk5t.js → chunk-5vems3nx.js}

@@ -1,15 +1,14 @@
 // @bun
+import {
+  isDatasetDefinition2
+} from "./chunk-q5e5tv4b.js";
 import {
   isScheduleReference2,
   isScheduleDefinition2
 } from "./chunk-nq6gpjt7.js";
-import {
-  isDatasetDefinition2
-} from "./chunk-rz53yb4v.js";
 import {
   PipelineError2
-} from "./chunk-d2ync1v3.js";
-
+} from "./chunk-hke9aeen.js";
 // src/lake-storage/sql-transforms.ts
 var SQL_DIALECT = {
   duckdb: "duckdb"
@@ -161,4 +160,4 @@ function isRecord(value) {
 }
 export { definePipelineStep2, definePipeline2, isPipelineDefinition2, isPipelineStepDefinition2 };
 
-//# debugId=F10FF17B5F67599B64756E2164756E21
+//# debugId=483E90D721E5117C64756E2164756E21

package/dist/{chunk-tjb1mk5t.js.map → chunk-5vems3nx.js.map}

@@ -2,11 +2,11 @@
   "version": 3,
   "sources": ["../src/lake-storage/sql-transforms.ts", "../src/pipelines/builders.ts", "../src/pipelines/types.ts"],
   "sourcesContent": [
-    "import type { DatasetDefinition } from \"../datasets\"\nimport type {\n  DatasetProducer,\n  DatasetRow,\n  DatasetWriteCommitResult,\n  DatasetWriteMode,\n  LakeStorage,\n} from \"./types\"\n\nexport const SQL_DIALECT = {\n  duckdb: \"duckdb\",\n} as const\n\nexport const SQL_DIALECTS = Object.values(SQL_DIALECT)\nexport type SqlDialect = (typeof SQL_DIALECT)[keyof typeof SQL_DIALECT]\n\nexport interface LakeStorageWithSql<TSqlDialect extends SqlDialect = SqlDialect>\n  extends LakeStorage {\n  readonly sql: LakeSqlExecutor<TSqlDialect>\n}\n\nexport interface LakeSqlExecutor<TSqlDialect extends SqlDialect = SqlDialect> {\n  readonly dialect: TSqlDialect\n  readonly capabilities: LakeSqlTransformCapabilities\n\n  preview(input: PreviewSqlTransformInput<TSqlDialect>): AsyncIterable<DatasetRow>\n  execute(input: ExecuteSqlTransformInput<TSqlDialect>): Promise<DatasetWriteCommitResult>\n}\n\nexport interface LakeSqlTransformCapabilities {\n  readonly preview: boolean\n  readonly supportsAppend: boolean\n  readonly supportsSnapshot: boolean\n}\n\nexport interface ExecuteSqlTransformInput<TSqlDialect extends SqlDialect = SqlDialect> {\n  readonly sources: Readonly<Record<string, SqlTransformSource>>\n  readonly sql: SqlTransformBody<TSqlDialect>\n  readonly target: DatasetDefinition\n  readonly mode: DatasetWriteMode\n  readonly producer?: DatasetProducer\n  /** Atomic target version guard; null requires that no version exists. */\n  readonly expectedLatestVersionId?: string | null\n  readonly commitMessage?: string\n}\n\nexport interface PreviewSqlTransformInput<TSqlDialect extends SqlDialect = SqlDialect> {\n  readonly sources: Readonly<Record<string, SqlTransformSource>>\n  readonly sql: SqlTransformBody<TSqlDialect>\n  readonly limit?: number\n}\n\nexport interface SqlTransformSource {\n  readonly dataset: DatasetDefinition\n  readonly versionId?: string\n}\n\nexport interface SqlTransformRelation {\n  toString(): string\n}\n\nexport type SqlTransformBody<_TSqlDialect extends SqlDialect = SqlDialect> = (\n  relations: Readonly<Record<string, SqlTransformRelation>>\n) => string\n\nexport function isSqlDialect(value: unknown): value is SqlDialect {\n  return typeof value === \"string\" && SQL_DIALECTS.includes(value as SqlDialect)\n}\n",
+    "import type { DatasetDefinition } from \"../datasets\"\nimport type {\n  DatasetProducer,\n  DatasetRow,\n  DatasetWriteCommitResult,\n  DatasetWriteMode,\n  LakeStorage,\n} from \"./types\"\n\nexport const SQL_DIALECT = {\n  duckdb: \"duckdb\",\n} as const\n\nexport const SQL_DIALECTS = Object.values(SQL_DIALECT)\nexport type SqlDialect = (typeof SQL_DIALECT)[keyof typeof SQL_DIALECT]\n\nexport interface LakeStorageWithSql<TSqlDialect extends SqlDialect = SqlDialect>\n  extends LakeStorage {\n  readonly sql: LakeSqlExecutor<TSqlDialect>\n}\n\nexport interface LakeSqlExecutor<TSqlDialect extends SqlDialect = SqlDialect> {\n  readonly dialect: TSqlDialect\n  readonly capabilities: LakeSqlTransformCapabilities\n\n  preview(input: PreviewSqlTransformInput<TSqlDialect>): AsyncIterable<DatasetRow>\n  /**\n   * Records the resolved lineage of the executed SQL on the committed version, as the writer of a\n   * run step passes `BeginDatasetWriteInput.lineage`: the provider analyzes the SQL it executes\n   * (as `analyze`), maps that lineage through the source versions it read with\n   * `resolveStepLineage`, and stores what `lineageAtCommit` returns for it, which merges in what an\n   * append keeps of its parent. SQL it cannot analyze exactly but that reads only its sources\n   * depends on every column it reads, as a run step does. Otherwise it passes no lineage, and the\n   * version is classified with every marking.\n   */\n  execute(input: ExecuteSqlTransformInput<TSqlDialect>): Promise<DatasetWriteCommitResult>\n  /**\n   * Column lineage of a transform, bound against the sources' column schemas without reading any\n   * data. A provider without it cannot run SQL over marked columns.\n   */\n  analyze?(input: AnalyzeSqlTransformInput<TSqlDialect>): Promise<SqlTransformAnalysis>\n}\n\nexport interface LakeSqlTransformCapabilities {\n  readonly preview: boolean\n  readonly supportsAppend: boolean\n  readonly supportsSnapshot: boolean\n}\n\nexport interface ExecuteSqlTransformInput<TSqlDialect extends SqlDialect = SqlDialect> {\n  /** The source versions read. The lineage the provider records is resolved through them. */\n  readonly sources: Readonly<Record<string, SqlTransformSource>>\n  readonly sql: SqlTransformBody<TSqlDialect>\n  readonly target: DatasetDefinition\n  readonly mode: DatasetWriteMode\n  readonly producer?: DatasetProducer\n  /** Atomic target version guard; null requires that no version exists. */\n  readonly expectedLatestVersionId?: string | null\n  readonly commitMessage?: string\n}\n\nexport interface PreviewSqlTransformInput<TSqlDialect extends SqlDialect = SqlDialect> {\n  readonly sources: Readonly<Record<string, SqlTransformSource>>\n  readonly sql: SqlTransformBody<TSqlDialect>\n  readonly limit?: number\n}\n\nexport interface SqlTransformSource {\n  readonly dataset: DatasetDefinition\n  readonly versionId?: string\n  /** Columns the transform may read, in order. Every column of the dataset when omitted. */\n  readonly columns?: readonly string[]\n}\n\nexport interface AnalyzeSqlTransformInput<TSqlDialect extends SqlDialect = SqlDialect> {\n  readonly sources: Readonly<Record<string, AnalyzeSqlTransformSource>>\n  readonly sql: SqlTransformBody<TSqlDialect>\n}\n\nexport interface AnalyzeSqlTransformSource {\n  readonly dataset: DatasetDefinition\n  /** Columns the transform may read, in order. Every column of the dataset when omitted. */\n  readonly columns?: readonly string[]\n}\n\nexport type SqlTransformAnalysis =\n  | { readonly supported: true; readonly lineage: SqlTransformLineage }\n  /** The provider could not analyze this SQL exactly; `reason` names the construct. */\n  | { readonly supported: false; readonly reason: string }\n\n/** Lineage of one transform, by source name. Same semantics as `DatasetColumnLineage`. */\nexport interface SqlTransformLineage {\n  readonly rows: readonly SqlTransformColumnRef[]\n  readonly columns: Readonly<Record<string, readonly SqlTransformColumnRef[]>>\n}\n\nexport interface SqlTransformColumnRef {\n  /** Source name, as passed in `sources`. */\n  readonly source: string\n  readonly column: string\n}\n\nexport interface SqlTransformRelation {\n  toString(): string\n}\n\nexport type SqlTransformBody<_TSqlDialect extends SqlDialect = SqlDialect> = (\n  relations: Readonly<Record<string, SqlTransformRelation>>\n) => string\n\nexport function isSqlDialect(value: unknown): value is SqlDialect {\n  return typeof value === \"string\" && SQL_DIALECTS.includes(value as SqlDialect)\n}\n",
     "import type { DatasetDefinition } from \"../datasets\"\nimport type { DatasetWriteMode } from \"../lake-storage\"\nimport { SQL_DIALECT } from \"../lake-storage/sql-transforms\"\nimport type { ScheduleDefinition, ScheduleReference } from \"../schedules\"\nimport { isScheduleDefinition } from \"../schedules\"\nimport { PipelineError } from \"./errors\"\nimport type {\n  PipelineBuilder,\n  PipelineDefinition,\n  PipelineGraph,\n  PipelineStepDefinition,\n  PipelineStepExecutorBuilder,\n  PipelineStepInputBuilder,\n  PipelineStepOutputBuilder,\n  PipelineStepOutputOptions,\n  PipelineStepRunHandler,\n} from \"./types\"\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (!value.trim()) {\n    throw new PipelineError(`Pipeline ${field} must not be empty.`)\n  }\n}\n\nfunction assertDataset(dataset: DatasetDefinition, field: string): void {\n  assertNonEmpty(dataset.id, field)\n}\n\nfunction assertDatasetWriteMode(mode: DatasetWriteMode): void {\n  if (mode !== \"snapshot\" && mode !== \"append\") {\n    throw new PipelineError(`Pipeline step output mode '${mode}' is not supported.`)\n  }\n}\n\nfunction assertInputs(inputs: Readonly<Record<string, DatasetDefinition>>): void {\n  const entries = Object.entries(inputs)\n  if (entries.length === 0) {\n    throw new PipelineError(\"Pipeline step input dataset must contain at least one entry.\")\n  }\n\n  for (const [name, dataset] of entries) {\n    assertNonEmpty(name, \"step input name\")\n    assertDataset(dataset, \"step input dataset\")\n  }\n}\n\nfunction scheduleReference(schedule: ScheduleDefinition): ScheduleReference {\n  if (!isScheduleDefinition(schedule)) {\n    throw new PipelineError(\"Pipeline .when(...) only accepts schedules.\")\n  }\n  return { type: \"schedule\", scheduleId: schedule.id }\n}\n\nfunction createPipelineBuilder<TId extends string>(\n  definition: PipelineDefinition<TId>\n): PipelineBuilder<TId> {\n  return {\n    ...definition,\n    when(schedule: ScheduleDefinition): PipelineBuilder<TId> {\n      return createPipelineBuilder({\n        ...definition,\n        triggers: [...definition.triggers, scheduleReference(schedule)],\n      })\n    },\n    // biome-ignore lint/suspicious/noThenProperty: Pipeline composition intentionally uses `.then(step)`.\n    then(step: PipelineStepDefinition): PipelineBuilder<TId> {\n      const graph: PipelineGraph = {\n        kind: \"sequence\",\n        nodes: [...definition.graph.nodes, { kind: \"step\", step }],\n      }\n\n      return createPipelineBuilder({\n        ...definition,\n        graph,\n      })\n    },\n  }\n}\n\n/**\n * Define one dataset transform step.\n *\n * The returned definition is inert until referenced by a pipeline definition.\n */\nexport function definePipelineStep<TId extends string>(id: TId): PipelineStepInputBuilder<TId> {\n  assertNonEmpty(id, \"step id\")\n\n  return {\n    inputs<TInputs extends Record<string, DatasetDefinition>>(\n      inputs: TInputs\n    ): PipelineStepOutputBuilder<TId, TInputs> {\n      assertInputs(inputs)\n\n      return {\n        output(\n          dataset: DatasetDefinition,\n          options: PipelineStepOutputOptions = {}\n        ): PipelineStepExecutorBuilder<TId, TInputs> {\n          assertDataset(dataset, \"step output dataset\")\n          const mode = options.mode ?? \"snapshot\"\n          assertDatasetWriteMode(mode)\n\n          return {\n            run(handler): PipelineStepDefinition<TId, TInputs> {\n              return {\n                kind: \"pipeline.step\",\n                id,\n                inputs,\n                output: dataset,\n                mode,\n                executor: {\n                  kind: \"run\",\n                  handler: handler as unknown as PipelineStepRunHandler,\n                },\n              }\n            },\n            sql(sql): PipelineStepDefinition<TId, TInputs> {\n              return {\n                kind: \"pipeline.step\",\n                id,\n                inputs,\n                output: dataset,\n                mode,\n                executor: {\n                  kind: \"sql\",\n                  dialect: SQL_DIALECT.duckdb,\n                  sql,\n                },\n              }\n            },\n          }\n        },\n      }\n    },\n  }\n}\n\n/**\n * Define a sequential pipeline that composes dataset transform steps.\n *\n * The returned definition is inert and safe to export from `pipelines/` modules.\n */\nexport function definePipeline<TId extends string>(id: TId): PipelineBuilder<TId> {\n  assertNonEmpty(id, \"id\")\n\n  return createPipelineBuilder({\n    kind: \"pipeline\",\n    id,\n    triggers: [],\n    graph: {\n      kind: \"sequence\",\n      nodes: [],\n    },\n  })\n}\n",
     "import type { DatasetDefinition } from \"../datasets\"\nimport { isDatasetDefinition } from \"../datasets\"\nimport type {\n  DatasetRow,\n  DatasetVersion,\n  DatasetWriteMode,\n  ReadDatasetRowsInput,\n} from \"../lake-storage\"\nimport {\n  isSqlDialect,\n  type SqlDialect,\n  type SqlTransformBody,\n} from \"../lake-storage/sql-transforms\"\nimport type { Logger } from \"../logging\"\nimport type { ScheduleDefinition, ScheduleReference } from \"../schedules\"\nimport { isScheduleReference } from \"../schedules\"\n\n// ── Step execution ─────────────────────────────────────────\n\nexport type PipelineStepExecutor =\n  | {\n      readonly kind: \"sql\"\n      readonly dialect: SqlDialect\n      readonly sql: SqlTransformBody<SqlDialect>\n    }\n  | {\n      readonly kind: \"run\"\n      readonly handler: PipelineStepRunHandler\n    }\n\nexport interface PipelineStepInput {\n  readonly dataset: DatasetDefinition\n  readonly version: DatasetVersion\n  readRows(input?: Omit<ReadDatasetRowsInput, \"datasetId\" | \"versionId\">): AsyncIterable<DatasetRow>\n}\n\nexport interface PipelineStepOutput {\n  writeRows(rows: Iterable<DatasetRow> | AsyncIterable<DatasetRow>): Promise<void>\n}\n\nexport interface PipelineStepRunContext<\n  TInputs extends Record<string, DatasetDefinition> = Record<string, DatasetDefinition>,\n> {\n  readonly projectId: string\n  readonly pipelineId: string\n  readonly stepId: string\n  readonly runId: string\n  readonly signal: AbortSignal\n  readonly inputs: { readonly [K in keyof TInputs]: PipelineStepInput }\n  readonly output: PipelineStepOutput\n  readonly logger: Logger\n}\n\nexport type PipelineStepRunHandler<\n  TInputs extends Record<string, DatasetDefinition> = Record<string, DatasetDefinition>,\n> = (ctx: PipelineStepRunContext<TInputs>) => Promise<void> | void\n\n// ── Step definition ────────────────────────────────────────\n\nexport interface PipelineStepDefinition<\n  TId extends string = string,\n  TInputs extends Record<string, DatasetDefinition> = Record<string, DatasetDefinition>,\n> {\n  readonly kind: \"pipeline.step\"\n  readonly id: TId\n  readonly inputs: Readonly<TInputs>\n  readonly output: DatasetDefinition\n  readonly mode: DatasetWriteMode\n  readonly executor: PipelineStepExecutor\n}\n\n// ── Pipeline definition ────────────────────────────────────\n\nexport interface PipelineStepNode {\n  readonly kind: \"step\"\n  readonly step: PipelineStepDefinition\n}\n\nexport interface PipelineSequenceGraph {\n  readonly kind: \"sequence\"\n  readonly nodes: readonly PipelineStepNode[]\n}\n\nexport type PipelineGraph = PipelineSequenceGraph\n\n/**\n * Inert pipeline definition registered with Sixb.\n *\n * V1 executes a single sequential graph. The graph shape leaves room for\n * parallel nodes later without changing step definitions.\n */\nexport interface PipelineDefinition<TId extends string = string> {\n  readonly kind: \"pipeline\"\n  readonly id: TId\n  readonly triggers: readonly ScheduleReference[]\n  readonly graph: PipelineGraph\n}\n\n// ── Builder interfaces ─────────────────────────────────────\n\nexport interface PipelineStepInputBuilder<TId extends string = string> {\n  inputs<TInputs extends Record<string, DatasetDefinition>>(\n    inputs: TInputs\n  ): PipelineStepOutputBuilder<TId, TInputs>\n}\n\nexport interface PipelineStepOutputBuilder<\n  TId extends string = string,\n  TInputs extends Record<string, DatasetDefinition> = Record<string, DatasetDefinition>,\n> {\n  output(\n    dataset: DatasetDefinition,\n    options?: PipelineStepOutputOptions\n  ): PipelineStepExecutorBuilder<TId, TInputs>\n}\n\nexport interface PipelineStepExecutorBuilder<\n  TId extends string = string,\n  TInputs extends Record<string, DatasetDefinition> = Record<string, DatasetDefinition>,\n> {\n  run(handler: PipelineStepRunHandler<TInputs>): PipelineStepDefinition<TId, TInputs>\n  sql(sql: SqlTransformBody<SqlDialect>): PipelineStepDefinition<TId, TInputs>\n}\n\nexport interface PipelineStepOutputOptions {\n  readonly mode?: DatasetWriteMode\n}\n\nexport interface PipelineBuilder<TId extends string = string> extends PipelineDefinition<TId> {\n  when(schedule: ScheduleDefinition): PipelineBuilder<TId>\n  then(step: PipelineStepDefinition): PipelineBuilder<TId>\n}\n\n// ── Type guards ────────────────────────────────────────────\n\n/** Runtime type guard for values discovered from `pipelines/` modules. */\nexport function isPipelineDefinition(value: unknown): value is PipelineDefinition {\n  if (!isRecord(value)) return false\n  return (\n    value.kind === \"pipeline\" &&\n    typeof value.id === \"string\" &&\n    Array.isArray(value.triggers) &&\n    value.triggers.every(isScheduleReference) &&\n    isPipelineGraph(value.graph)\n  )\n}\n\nexport function isPipelineStepDefinition(value: unknown): value is PipelineStepDefinition {\n  return (\n    isRecord(value) &&\n    value.kind === \"pipeline.step\" &&\n    typeof value.id === \"string\" &&\n    isInputsRecord(value.inputs) &&\n    isDatasetDefinition(value.output) &&\n    isDatasetWriteMode(value.mode) &&\n    isPipelineStepExecutor(value.executor)\n  )\n}\n\nfunction isPipelineGraph(value: unknown): value is PipelineGraph {\n  return (\n    isRecord(value) &&\n    value.kind === \"sequence\" &&\n    Array.isArray(value.nodes) &&\n    value.nodes.every(\n      (node) => isRecord(node) && node.kind === \"step\" && isPipelineStepDefinition(node.step)\n    )\n  )\n}\n\nfunction isPipelineStepExecutor(value: unknown): value is PipelineStepExecutor {\n  if (!isRecord(value)) return false\n\n  switch (value.kind) {\n    case \"sql\":\n      return isSqlDialect(value.dialect) && typeof value.sql === \"function\"\n    case \"run\":\n      return typeof value.handler === \"function\"\n    default:\n      return false\n  }\n}\n\nfunction isInputsRecord(value: unknown): value is Readonly<Record<string, DatasetDefinition>> {\n  return (\n    isRecord(value) &&\n    Object.entries(value).every(\n      ([key, dataset]) => key.trim().length > 0 && isDatasetDefinition(dataset)\n    )\n  )\n}\n\nfunction isDatasetWriteMode(value: unknown): value is DatasetWriteMode {\n  return value === \"snapshot\" || value === \"append\"\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "F10FF17B5F67599B64756E2164756E21",
+  "mappings": "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",
+  "debugId": "483E90D721E5117C64756E2164756E21",
   "names": []
 }