@elaraai/e3-cloud-files 1.0.94 → 1.1.0

package/dist/src/compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../src/compat.ts"],"names":[],"mappings":"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"}

package/dist/src/compat.js

@@ -0,0 +1,258 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * `@elaraai/e3-cloud-files/compat`: Files' stored values as the first
+ * version wrote them, and their lift into the current types.
+ *
+ * The first version mapped a source's files to inputs alone: a mapping was
+ * `{input, source, shape}`, a `file` or `latest` shape named no type, a
+ * refusal's reason was a string, a sync was asked for `inputs`, and a ledger
+ * entry held an ETag and a size. The current types map to a target (an
+ * input, a record or a mutation), may name a type, tell refusals apart, ask
+ * for `targets` and `reset`, and remember a file's hash and the commit a
+ * seed or feed made.
+ *
+ * A store reads a stored value through {@link readFilesManifest},
+ * {@link readFilesSyncReport}, {@link readFilesLedger},
+ * {@link readFilesSyncJob} or {@link readFilesHistoryManifest}: each reads
+ * the root type the bytes' beast2 header declares, decodes a current value as
+ * it is, and decodes a first-version value with its own type and lifts it
+ * (`input` → `target: input(name)`, each `file`/`latest` shape `type: none`,
+ * a refusal's string `other(reason)`, the new fields none). A value is
+ * written at the current version on its next write. The lifts are pure, so
+ * the CLI lifts a local repository's state file through them too.
+ *
+ * The first version's types are kept here, and nowhere else, under their
+ * `V1` names.
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, BooleanType, DateTimeType, DictType, IntegerType, OptionType, StringType, StructType, VariantType, decodeBeast2For, isTypeValueEqual, none, readBeast2Type, some, toEastTypeValue, variant, } from '@elaraai/east';
+import { FilesLedgerType, FilesManifestType, FilesSyncJobType, FilesSyncReportType, FilesSyncStateType, } from '@elaraai/e3-cloud-types';
+/** A `file` or `latest` shape of the first version: no type. */
+export const FilesShapeTypeV1 = VariantType({
+    file: StructType({ key: StringType }),
+    latest: StructType({ prefix: StringType, include: OptionType(StringType) }),
+    folder: StructType({ prefix: StringType, include: OptionType(StringType) }),
+    listing: StructType({ prefix: StringType, include: OptionType(StringType) }),
+});
+/** A mapping of the first version: an input, by name. */
+export const FilesMappingTypeV1 = StructType({
+    input: StringType,
+    source: StringType,
+    shape: FilesShapeTypeV1,
+});
+/** The declarations of the first version. */
+export const FilesManifestTypeV1 = StructType({
+    sources: ArrayType(StringType),
+    mappings: ArrayType(FilesMappingTypeV1),
+});
+/** A refusal of the first version: its reason a string. */
+export const FilesRefusalTypeV1 = StructType({ key: StringType, reason: StringType });
+/** A mapping's report of the first version. */
+export const FilesMappingReportTypeV1 = StructType({
+    input: StringType,
+    added: IntegerType,
+    changed: IntegerType,
+    removed: IntegerType,
+    unchanged: IntegerType,
+    refused: ArrayType(FilesRefusalTypeV1),
+    bytes: IntegerType,
+    updated: BooleanType,
+});
+/** A sync's report of the first version. */
+export const FilesSyncReportTypeV1 = StructType({
+    started: DateTimeType,
+    finished: DateTimeType,
+    dryRun: BooleanType,
+    mappings: ArrayType(FilesMappingReportTypeV1),
+});
+/** A ledger of the first version: each file's ETag and size. */
+export const FilesLedgerTypeV1 = StructType({
+    entries: DictType(StringType, StructType({ etag: StringType, size: IntegerType })),
+    value: OptionType(StringType),
+    under: OptionType(StringType),
+});
+/** A sync of the first version: asked for inputs. */
+export const FilesSyncJobTypeV1 = StructType({
+    id: StringType,
+    workspace: StringType,
+    by: StringType,
+    dryRun: BooleanType,
+    inputs: OptionType(ArrayType(StringType)),
+    state: FilesSyncStateType,
+    startedAt: DateTimeType,
+    finishedAt: OptionType(DateTimeType),
+    report: OptionType(FilesSyncReportTypeV1),
+});
+/**
+ * A first-version shape as the current one: a `file` or `latest` names no type.
+ *
+ * @param shape - The shape
+ * @returns The current shape
+ */
+export function liftFilesShapeV1(shape) {
+    switch (shape.type) {
+        case 'file': return variant('file', { key: shape.value.key, type: none });
+        case 'latest': return variant('latest', { prefix: shape.value.prefix, include: shape.value.include, type: none });
+        case 'folder': return variant('folder', shape.value);
+        case 'listing': return variant('listing', shape.value);
+    }
+}
+/**
+ * A first-version mapping as the current one: its input, as a target.
+ *
+ * @param mapping - The mapping
+ * @returns The current mapping
+ */
+export function liftFilesMappingV1(mapping) {
+    return { target: variant('input', mapping.input), source: mapping.source, shape: liftFilesShapeV1(mapping.shape) };
+}
+/**
+ * First-version declarations as the current ones.
+ *
+ * @param manifest - The declarations
+ * @returns The current declarations
+ */
+export function liftFilesManifestV1(manifest) {
+    return { sources: [...manifest.sources], mappings: manifest.mappings.map(liftFilesMappingV1) };
+}
+/**
+ * A first-version mapping's report as the current one: its reasons kept as
+ * `other`, and nothing taken, committed, kept or waiting.
+ *
+ * @param report - The report
+ * @returns The current report
+ */
+export function liftFilesMappingReportV1(report) {
+    const refused = report.refused.map((r) => ({ key: r.key, reason: variant('other', r.reason) }));
+    return {
+        target: variant('input', report.input),
+        added: report.added,
+        changed: report.changed,
+        removed: report.removed,
+        unchanged: report.unchanged,
+        refused,
+        bytes: report.bytes,
+        updated: report.updated,
+        taken: none,
+        commit: none,
+        kept: none,
+        waiting: none,
+    };
+}
+/**
+ * A first-version sync's report as the current one.
+ *
+ * @param report - The report
+ * @returns The current report
+ */
+export function liftFilesSyncReportV1(report) {
+    return { started: report.started, finished: report.finished, dryRun: report.dryRun, mappings: report.mappings.map(liftFilesMappingReportV1) };
+}
+/**
+ * A first-version ledger as the current one: no hashes, no commit.
+ *
+ * @param ledger - The ledger
+ * @returns The current ledger
+ */
+export function liftFilesLedgerV1(ledger) {
+    return {
+        entries: new Map([...ledger.entries].map(([key, e]) => [key, { etag: e.etag, size: e.size, sha256: none, modified: none }])),
+        value: ledger.value,
+        under: ledger.under,
+        commit: none,
+        tried: none,
+        taking: none,
+    };
+}
+/**
+ * A first-version sync as the current one: its inputs, as targets.
+ *
+ * @param job - The sync
+ * @returns The current sync
+ */
+export function liftFilesSyncJobV1(job) {
+    return {
+        id: job.id,
+        workspace: job.workspace,
+        by: job.by,
+        dryRun: job.dryRun,
+        targets: job.inputs.type === 'some' ? some(job.inputs.value.map((input) => variant('input', input))) : none,
+        reset: [],
+        state: job.state,
+        startedAt: job.startedAt,
+        finishedAt: job.finishedAt,
+        report: job.report.type === 'some' ? some(liftFilesSyncReportV1(job.report.value)) : none,
+    };
+}
+/**
+ * A reader of a stored value at any version: the bytes' header type decides
+ * which type decodes them, and an older value is lifted.
+ *
+ * @param what - What the value is, for the error
+ * @param current - The current type
+ * @param older - Each older version, its type and lift
+ * @returns The reader
+ */
+function versioned(what, current, older) {
+    const decodeCurrent = decodeBeast2For(current);
+    const currentType = toEastTypeValue(current);
+    const olders = older.map((o) => ({ ...o, typeValue: toEastTypeValue(o.type), decode: decodeBeast2For(o.type) }));
+    return (bytes) => {
+        let header;
+        try {
+            header = readBeast2Type(bytes);
+        }
+        catch (err) {
+            throw new Error(`The stored ${what} is not a beast2 value: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+        if (isTypeValueEqual(header, currentType))
+            return decodeCurrent(bytes);
+        for (const o of olders) {
+            if (isTypeValueEqual(header, o.typeValue))
+                return o.lift(o.decode(bytes));
+        }
+        throw new Error(`The stored ${what} is of a type this version does not read`);
+    };
+}
+/** Reads stored declarations, at any version, as the current ones. */
+export const readFilesManifest = versioned('Files declarations', FilesManifestType, [
+    { type: FilesManifestTypeV1, lift: liftFilesManifestV1 },
+]);
+/** Reads a stored sync's report, at any version, as the current one. */
+export const readFilesSyncReport = versioned('Files sync report', FilesSyncReportType, [
+    { type: FilesSyncReportTypeV1, lift: liftFilesSyncReportV1 },
+]);
+/** Reads a stored ledger, at any version, as the current one. */
+export const readFilesLedger = versioned('Files ledger', FilesLedgerType, [
+    { type: FilesLedgerTypeV1, lift: liftFilesLedgerV1 },
+]);
+/** Reads a stored sync, at any version, as the current one. */
+export const readFilesSyncJob = versioned('Files sync', FilesSyncJobType, [
+    { type: FilesSyncJobTypeV1, lift: liftFilesSyncJobV1 },
+]);
+/** The declarations a workspace's history entry left: none, or the declarations. */
+const HistoryManifestType = OptionType(FilesManifestType);
+const HistoryManifestTypeV1 = OptionType(FilesManifestTypeV1);
+/** Reads the declarations a history entry left (`Option<FilesManifest>`), at any version, as the current ones. */
+export const readFilesHistoryManifest = versioned('Files declarations of a history entry', HistoryManifestType, [
+    {
+        type: HistoryManifestTypeV1,
+        lift: ((value) => (value.type === 'some' ? some(liftFilesManifestV1(value.value)) : none)),
+    },
+]);
+/** The stored versions of a workspace's declarations (`FILES/` `manifest`). */
+export const FILES_MANIFEST_VERSIONS = { current: FilesManifestType, older: [{ type: FilesManifestTypeV1, lift: liftFilesManifestV1 }] };
+/** The stored versions of a sync's report (`FILES/` `lastSync`, `FILESJOB/` `report`). */
+export const FILES_REPORT_VERSIONS = { current: FilesSyncReportType, older: [{ type: FilesSyncReportTypeV1, lift: liftFilesSyncReportV1 }] };
+/** The stored versions of a sync as filed (`FILESJOB/` `value`). */
+export const FILES_JOB_VERSIONS = { current: FilesSyncJobType, older: [{ type: FilesSyncJobTypeV1, lift: liftFilesSyncJobV1 }] };
+/** The stored versions of the declarations a history entry left (`RELEASE/` `files`). */
+export const FILES_HISTORY_VERSIONS = {
+    current: HistoryManifestType,
+    older: [{ type: HistoryManifestTypeV1, lift: ((value) => (value.type === 'some' ? some(liftFilesManifestV1(value.value)) : none)) }],
+};
+//# sourceMappingURL=compat.js.map

package/dist/src/compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.js","sourceRoot":"","sources":["../../src/compat.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -4,24 +4,29 @@
  */
 /**
  * `@elaraai/e3-cloud-files`: a solution's inputs that come from files in a
- * bucket.
+ * bucket, and its records seeded or fed from them.
  *
  * - `Files.source(name)`: a source, which each workspace binds to a bucket
  *   and a prefix; its `file`, `latest`, `folder` and `listing` declare the
- *   inputs its files fill, each an ordinary `e3.input`.
+ *   inputs its files fill, each an ordinary `e3.input`, a `file` or `latest`
+ *   typed when it names a `type`; its `record` declares a record seeded
+ *   from a file, an `e3.record` with no initial value and its parts as
+ *   `e3.record` takes them; its `mutation` names a record's mutation fed by
+ *   its files.
  * - `Files.manifest(sources)`: the declarations `e3-cloud files deploy`
  *   deploys beside the package.
- * - `checkFiles`, `checkBindings`, `readPackageInputs`: the checks a deploy
- *   and a bind run.
+ * - `checkFiles`, `checkBindings`, `readPackageSurface`: the checks a deploy
+ *   and a bind run, against the package's inputs, records and mutations.
  *
- * A file arrives as it is, a `Blob`; the solution decodes it in East. The
- * sync is `@elaraai/e3-cloud-files/sync`; the East types are
+ * A file with no type arrives as it is, a `Blob`; the solution decodes it in
+ * East. A typed file arrives as the beast2 value it holds. The sync is
+ * `@elaraai/e3-cloud-files/sync`; the East types are
  * `@elaraai/e3-cloud-types`'s `Files*`.
  *
  * @packageDocumentation
  */
-export { Files, FilesSource, FilesDeclarationError, type FilesInput, type FilesSelection } from './authoring.js';
-export { checkFiles, checkBindings, readPackageInputs, shapeType, type PackageInput, type ObjectReader, type BindingPolicy, } from './check.js';
+export { Files, FilesSource, FilesDeclarationError, type FilesInput, type FilesMutation, type FilesRecordParts, type FilesSelection, type FilesKeySpec, type FilesTypedKeySpec, type FilesTypedSelection, } from './authoring.js';
+export { checkFiles, checkBindings, readPackageInputs, readPackageSurface, shapeType, type PackageInput, type PackageRecord, type PackageMutation, type PackageSurface, type ObjectReader, type BindingPolicy, } from './check.js';
 export { globMatcher, parseBucketUrl, keyProblem, prefixProblem, includeProblem, type BucketLocation } from './paths.js';
-export { FilesManifestType, FilesMappingType, FilesShapeType, FilesBindingType, FilesSyncReportType, FilesMappingReportType, FilesStatusType, FilesProblemType, FilesListingRowType, FilesFileType, FilesFolderType, FilesListingType, FILES_FILE_MAX_BYTES, FILES_FOLDER_ENTRY_MAX_BYTES, filesProblemText, type FilesManifest, type FilesMapping, type FilesShape, type FilesBinding, type FilesSyncReport, type FilesMappingReport, type FilesStatus, type FilesProblem, type FilesListingRow, } from '@elaraai/e3-cloud-types';
+export { FilesManifestType, FilesMappingType, FilesShapeType, FilesTargetType, FilesBindingType, FilesSyncReportType, FilesMappingReportType, FilesRefusalReasonType, FilesStatusType, FilesProblemType, FilesListingRowType, FilesFileType, FilesFolderType, FilesListingType, FILES_FILE_MAX_BYTES, FILES_FOLDER_ENTRY_MAX_BYTES, FILES_TYPED_VALUE_MAX_BYTES, FILES_SEGMENT_MAX_BYTES, filesProblemText, filesRefusalText, filesTargetText, parseFilesTarget, sameFilesTarget, type FilesManifest, type FilesMapping, type FilesShape, type FilesTarget, type FilesBinding, type FilesSyncReport, type FilesMappingReport, type FilesRefusalReason, type FilesStatus, type FilesProblem, type FilesListingRow, } from '@elaraai/e3-cloud-types';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjH,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACzH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,KAAK,EAAE,WAAW,EAAE,qBAAqB,EACzC,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,GACrJ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACzH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/src/index.js

@@ -4,24 +4,29 @@
  */
 /**
  * `@elaraai/e3-cloud-files`: a solution's inputs that come from files in a
- * bucket.
+ * bucket, and its records seeded or fed from them.
  *
  * - `Files.source(name)`: a source, which each workspace binds to a bucket
  *   and a prefix; its `file`, `latest`, `folder` and `listing` declare the
- *   inputs its files fill, each an ordinary `e3.input`.
+ *   inputs its files fill, each an ordinary `e3.input`, a `file` or `latest`
+ *   typed when it names a `type`; its `record` declares a record seeded
+ *   from a file, an `e3.record` with no initial value and its parts as
+ *   `e3.record` takes them; its `mutation` names a record's mutation fed by
+ *   its files.
  * - `Files.manifest(sources)`: the declarations `e3-cloud files deploy`
  *   deploys beside the package.
- * - `checkFiles`, `checkBindings`, `readPackageInputs`: the checks a deploy
- *   and a bind run.
+ * - `checkFiles`, `checkBindings`, `readPackageSurface`: the checks a deploy
+ *   and a bind run, against the package's inputs, records and mutations.
  *
- * A file arrives as it is, a `Blob`; the solution decodes it in East. The
- * sync is `@elaraai/e3-cloud-files/sync`; the East types are
+ * A file with no type arrives as it is, a `Blob`; the solution decodes it in
+ * East. A typed file arrives as the beast2 value it holds. The sync is
+ * `@elaraai/e3-cloud-files/sync`; the East types are
  * `@elaraai/e3-cloud-types`'s `Files*`.
  *
  * @packageDocumentation
  */
-export { Files, FilesSource, FilesDeclarationError } from './authoring.js';
-export { checkFiles, checkBindings, readPackageInputs, shapeType, } from './check.js';
+export { Files, FilesSource, FilesDeclarationError, } from './authoring.js';
+export { checkFiles, checkBindings, readPackageInputs, readPackageSurface, shapeType, } from './check.js';
 export { globMatcher, parseBucketUrl, keyProblem, prefixProblem, includeProblem } from './paths.js';
-export { FilesManifestType, FilesMappingType, FilesShapeType, FilesBindingType, FilesSyncReportType, FilesMappingReportType, FilesStatusType, FilesProblemType, FilesListingRowType, FilesFileType, FilesFolderType, FilesListingType, FILES_FILE_MAX_BYTES, FILES_FOLDER_ENTRY_MAX_BYTES, filesProblemText, } from '@elaraai/e3-cloud-types';
+export { FilesManifestType, FilesMappingType, FilesShapeType, FilesTargetType, FilesBindingType, FilesSyncReportType, FilesMappingReportType, FilesRefusalReasonType, FilesStatusType, FilesProblemType, FilesListingRowType, FilesFileType, FilesFolderType, FilesListingType, FILES_FILE_MAX_BYTES, FILES_FOLDER_ENTRY_MAX_BYTES, FILES_TYPED_VALUE_MAX_BYTES, FILES_SEGMENT_MAX_BYTES, filesProblemText, filesRefusalText, filesTargetText, parseFilesTarget, sameFilesTarget, } from '@elaraai/e3-cloud-types';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAwC,MAAM,gBAAgB,CAAC;AACjH,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,GAIV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AACzH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,GAUjB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,KAAK,EAAE,WAAW,EAAE,qBAAqB,GAE1C,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,GAOV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AACzH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAYhB,MAAM,yBAAyB,CAAC"}

package/dist/src/s3/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/s3/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAiF,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAClI,OAAO,EAA0C,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7F,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgCD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,GAAG,WAAW,CAgEjF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/s3/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAiF,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAClI,OAAO,EAA0C,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7F,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgCD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,GAAG,WAAW,CAqFjF"}

package/dist/src/s3/index.js

@@ -63,6 +63,22 @@ function unreadable(err) {
  */
 export function s3FilesReader(client, location) {
     const absolute = (key) => `${location.prefix}${key}`;
+    /** A file, or a range of it, at the version its listing gave; a refusal of the file's own is unreadable. */
+    const get = async (file, range) => {
+        let object;
+        try {
+            object = await client.send(new GetObjectCommand({ Bucket: location.bucket, Key: absolute(file.key), IfMatch: `"${file.etag}"`, ...(range !== undefined && { Range: range }) }));
+        }
+        catch (err) {
+            const reason = unreadable(err);
+            if (reason !== null)
+                throw new FilesUnreadableError(file.key, reason);
+            throw err;
+        }
+        if (object.Body === undefined)
+            throw new Error(`s3://${location.bucket}/${absolute(file.key)} answered no bytes`);
+        return object;
+    };
     return {
         async *list(prefix, options = {}) {
             let token;
@@ -114,18 +130,7 @@ export function s3FilesReader(client, location) {
             return { key, size: object.Size ?? 0, modified: object.LastModified ?? new Date(0), etag: bare(object.ETag) };
         },
         async read(file) {
-            let object;
-            try {
-                object = await client.send(new GetObjectCommand({ Bucket: location.bucket, Key: absolute(file.key), IfMatch: `"${file.etag}"` }));
-            }
-            catch (err) {
-                const reason = unreadable(err);
-                if (reason !== null)
-                    throw new FilesUnreadableError(file.key, reason);
-                throw err;
-            }
-            if (object.Body === undefined)
-                throw new Error(`s3://${location.bucket}/${absolute(file.key)} answered no bytes`);
+            const object = await get(file);
             if (object.ContentLength !== undefined && object.ContentLength !== file.size) {
                 // Never buffered: its size was never checked
                 object.Body.destroy?.();
@@ -133,6 +138,23 @@ export function s3FilesReader(client, location) {
             }
             return object.Body.transformToByteArray();
         },
+        async readRange(file, start, end) {
+            if (end <= start)
+                return new Uint8Array(0);
+            // A range's end is inclusive to the bucket
+            const object = await get(file, `bytes=${start}-${end - 1}`);
+            return object.Body.transformToByteArray();
+        },
+        async open(file, options = {}) {
+            const start = options.start ?? 0;
+            const object = await get(file, start > 0 ? `bytes=${start}-` : undefined);
+            if (object.ContentLength !== undefined && object.ContentLength !== file.size - start) {
+                object.Body.destroy?.();
+                throw new FilesUnreadableError(file.key, `changed since it was listed (${object.ContentLength + start} bytes, not the ${file.size} listed): the next sync takes it`);
+            }
+            // A bucket's body is a stream of chunks
+            return object.Body;
+        },
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/src/s3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/s3/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/s3/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,kBAAkB,EAAiB,MAAM,oBAAoB,CAAC;AAClI,OAAO,EAAE,oBAAoB,EAAsC,MAAM,mBAAmB,CAAC;AAS7F,yDAAyD;AACzD,SAAS,IAAI,CAAC,IAAwB;IACpC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,6DAA6D;AAC7D,SAAS,OAAO,CAAC,GAAY;IAC3B,OAAO,GAAG,YAAY,kBAAkB,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,SAAS,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC;AAC5I,CAAC;AAED,+DAA+D;AAC/D,SAAS,MAAM,CAAC,GAAY;IAC1B,OAAO,GAAG,YAAY,kBAAkB,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,SAAS,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC;AACpH,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,GAAY;IAC9B,IAAI,CAAC,CAAC,GAAG,YAAY,kBAAkB,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,oBAAoB,CAAC,CAAC,OAAO,qDAAqD,CAAC;QACxF,KAAK,oBAAoB,CAAC,CAAC,OAAO,uEAAuE,CAAC;QAC1G,KAAK,cAAc,CAAC,CAAC,OAAO,kFAAkF,CAAC;QAC/G,KAAK,WAAW,CAAC,CAAC,OAAO,6BAA6B,CAAC;QACvD,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,SAAS,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9F,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAgB,EAAE,QAAoB;IAClE,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;IAC7D,4GAA4G;IAC5G,MAAM,GAAG,GAAG,KAAK,EAAE,IAAiB,EAAE,KAAc,EAAE,EAAE;QACtD,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACtE,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClH,OAAO,MAAmE,CAAC;IAC7E,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE;YAC9B,IAAI,KAAyB,CAAC;YAC9B,GAAG,CAAC;gBACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC;oBACtD,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;oBACxB,iBAAiB,EAAE,KAAK;oBACxB,4EAA4E;oBAC5E,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,IAAI,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;iBAC1D,CAAC,CAAC,CAAC;gBACJ,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;oBACzC,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;wBAAE,SAAS;oBACvC,MAAM;wBACJ,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;wBAC7C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;wBACtB,QAAQ,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC;wBAC5C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;qBACxB,CAAC;gBACJ,CAAC;gBACD,KAAK,GAAG,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7E,CAAC,QAAQ,KAAK,KAAK,SAAS,EAAE;QAChC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG;YACZ,qEAAqE;YACrE,kDAAkD;YAClD,IAAI,IAAI,CAAC;YACT,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACrH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;oBAAE,MAAM,GAAG,CAAC;gBAC5B,mFAAmF;gBACnF,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBACvG,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnH,CAAC;gBAAC,OAAO,OAAO,EAAE,CAAC;oBACjB,IAAI,OAAO,CAAC,OAAO,CAAC;wBAAE,OAAO,IAAI,CAAC;oBAClC,MAAM,OAAO,CAAC;gBAChB,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,MAAM,EAAE,GAAG,KAAK,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI;YACb,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC7E,6CAA6C;gBAC5C,MAAM,CAAC,IAAiC,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtD,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,gCAAgC,MAAM,CAAC,aAAa,mBAAmB,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAC;YAC/J,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG;YAC9B,IAAI,GAAG,IAAI,KAAK;gBAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3C,2CAA2C;YAC3C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,EAAE;YAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC1E,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC;gBACpF,MAAM,CAAC,IAAiC,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtD,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,gCAAgC,MAAM,CAAC,aAAa,GAAG,KAAK,mBAAmB,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAC;YACvK,CAAC;YACD,wCAAwC;YACxC,OAAO,MAAM,CAAC,IAA4C,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/storage/index.d.ts

@@ -2,15 +2,96 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Licensed under BSL 1.1. See LICENSE for details.
  */
-import { type StorageBackend } from '@elaraai/e3-core';
-import type { FilesWriter } from '../sync/engine.js';
+import { type StorageBackend, type TaskRunner } from '@elaraai/e3-core';
+import { type FilesRefusalReason } from '@elaraai/e3-cloud-types';
+import { type FilesWriter } from '../sync/engine.js';
+/** What the writer is given beside the store. */
+export interface StorageWriterOptions {
+    /** The runner that takes a typed collection in by pieces, and runs a fed mutation; without one, a typed file that is a collection the store does not know, or a feed, is refused */
+    readonly runner?: TaskRunner;
+    /** Where a typed file's bytes are streamed to before e3 takes them in: a directory of the caller's (default the system's temporary directory) */
+    readonly scratchDir?: string;
+    /** Who a feed's commit records as its actor (default `files`) */
+    readonly actor?: string;
+    /** How long a fed mutation may run, in ms (default e3's) */
+    readonly feedBudgetMs?: number;
+}
+/**
+ * A refusal e3's door answered, as the sync reports it; null for an error the
+ * door did not refuse.
+ *
+ * @param err - What the door threw
+ * @param type - The mapping's type
+ * @returns The refusal, or null
+ */
+export declare function doorRefusal(err: unknown): FilesRefusalReason | null;
+/**
+ * What a failed mutation said, from the runner's stderr: its last lines that
+ * are no stack frame (a runtime error prints its message, then where it was
+ * raised), at most three, as one line. What a refusal of a feed or a seed
+ * carries (`mutation {outcome: 'failed', message}`).
+ *
+ * @param stderr - The runner's stderr
+ * @returns The words
+ */
+export declare function failureWords(stderr: string): string;
 /**
  * The sync's writer over an e3 store, for one workspace.
  *
  * @param storage - The store: a local repository's (`LocalStorage`) or the platform's
  * @param repo - The repository: a local repository's path, or the platform's repository name
  * @param ws - The workspace
+ * @param options - The runner, the scratch directory and the actor
+ * @returns The writer
+ */
+export declare function storageWriter(storage: StorageBackend, repo: string, ws: string, options?: StorageWriterOptions): FilesWriter;
+/**
+ * Stages a typed file's bytes in the object store as the object their
+ * SHA-256 names, hashing them as they stream: the platform's typed intake,
+ * never on a disk. A stage the signal stops keeps nothing: the next round
+ * starts the file again.
+ */
+export interface FilesStaging {
+    /**
+     * @param repo - The repository, as the storage names it
+     * @param open - The file's bytes, from a byte on: opened at 0, or where a stage left off
+     * @param size - The file's size, as its listing gave it
+     * @param options - The round's signal, and where an earlier stage of the same file stood (its `progress`)
+     * @returns The bytes' SHA-256, the object placed; or `aborted` when the
+     *   signal stopped it, with where it stood for the next round to resume
+     *   (null when nothing was kept)
+     */
+    stage(repo: string, open: (start: number) => Promise<AsyncIterable<Uint8Array>>, size: number, options: {
+        readonly signal?: AbortSignal;
+        readonly resume?: string;
+    }): Promise<{
+        sha256: string;
+    } | {
+        aborted: true;
+        progress: string | null;
+    }>;
+}
+/** What the cloud's writer is given beside the store. */
+export interface CloudWriterOptions extends Omit<StorageWriterOptions, 'scratchDir'> {
+    /** The round's runner: takes a typed collection in by pieces, runs a fed mutation */
+    readonly runner: TaskRunner;
+    /** Where a typed file's bytes are staged: the platform's object store */
+    readonly staging: FilesStaging;
+}
+/**
+ * The sync's writer for a deployed workspace: the store's writer, with a
+ * typed file taken in through the platform's staging and e3's door for a
+ * delivery the store holds (`datasetAdoptObject`), so no byte of it passes
+ * through a disk (D7), and an intake the round's deadline stops resumes in
+ * the next round with the pieces it finished remembered; a record seeded
+ * from a staged file the same way (`deliveryAdoptStored`, then the
+ * record's `$init` or `$seed` commit).
+ *
+ * @param storage - The platform's storage
+ * @param repo - The repository, as the storage names it
+ * @param ws - The workspace
+ * @param options - The runner, the staging, the actor
  * @returns The writer
  */
-export declare function storageWriter(storage: StorageBackend, repo: string, ws: string): FilesWriter;
+export declare function cloudWriter(storage: StorageBackend, repo: string, ws: string, options: CloudWriterOptions): FilesWriter;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AAgDpE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CA4B5F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+CH,OAAO,EAmBL,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAA0E,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC1I,OAAO,EAEkE,KAAK,WAAW,EAExF,MAAM,mBAAmB,CAAC;AAwD3B,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,oLAAoL;IACpL,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,iJAAiJ;IACjJ,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CASnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAkGD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,WAAW,CAoIhI;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAChP;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAC;IAClF,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAyEvH"}