@elaraai/e3-cloud-files 1.0.93 → 1.0.97

package/dist/src/sync/push.js.map

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

package/dist/test/typed.examples.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * The worked example of typed files and feeds: a price list that
+ * arrives as beast2 and is an input of its type with no task in between,
+ * and a price book, a record, fed through one of its mutations by each new
+ * delta file. `typedFiles` is what a partner drops, written with East's
+ * beast2 encoder; `wrongPrices` is a file of another type, and `notBeast2`
+ * no beast2 at all, which the examples' tests have refused.
+ */
+import { ArrayType, DictType, FloatType, IntegerType, StringType, StructType } from '@elaraai/east';
+import { type FilesManifest } from '../src/index.js';
+export declare const Price: StructType<{
+    readonly sku: StringType;
+    readonly price: FloatType;
+}>;
+export declare const PriceBook: DictType<StringType, FloatType>;
+/** Where the partners' files are: each workspace binds it to a bucket and prefix. */
+export declare const upload: import("../src/authoring.js").FilesSource;
+/** The price list, as the beast2 value it holds: an input of `Array<Price>`. */
+export declare const prices: import("@elaraai/e3").DatasetDef<ArrayType<StructType<{
+    readonly sku: StringType;
+    readonly price: FloatType;
+}>>, [import("@elaraai/east").variant<"field", "inputs">, import("@elaraai/east").variant<"field", "prices">]>;
+/** The price book, a record the app's users may edit, and a mutation that loads a delivery into it, each price over its sku's. */
+export declare const priceBook: import("@elaraai/e3").RecordDef<DictType<StringType, FloatType>, [import("@elaraai/east").variant<"field", "records">, import("@elaraai/east").variant<"field", "price_book">]>;
+export declare const loadPrices: import("@elaraai/e3").MutationDef<"load_prices", DictType<StringType, FloatType>, [ArrayType<StructType<{
+    readonly sku: StringType;
+    readonly price: FloatType;
+}>>]>;
+/** How many prices there are, in the list and the book. */
+export declare const priceSummary: import("@elaraai/e3").TaskDef<IntegerType, [import("@elaraai/east").variant<"field", "tasks">, import("@elaraai/east").variant<"field", "price_summary">, import("@elaraai/east").variant<"field", "output">]>;
+export declare const typedPackage: import("@elaraai/e3").PackageDef<Record<string, unknown>>;
+/** What `e3-cloud files deploy` deploys. */
+declare const typedManifest: FilesManifest;
+export default typedManifest;
+/** The price list: three prices. */
+export declare const priceList: Uint8Array<ArrayBufferLike>;
+/** Sample files, by key under the binding. */
+export declare const typedFiles: ReadonlyMap<string, Uint8Array>;
+/** A second delta, newer. */
+export declare const laterDelta: Uint8Array<ArrayBufferLike>;
+/** A file of another type than the price list's: refused, naming both types. */
+export declare const wrongPrices: Uint8Array<ArrayBufferLike>;
+/** No beast2 at all. */
+export declare const notBeast2: NodeJS.NonSharedUint8Array;
+//# sourceMappingURL=typed.examples.d.ts.map

package/dist/test/typed.examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed.examples.d.ts","sourceRoot":"","sources":["../../test/typed.examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAQ,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAmB,MAAM,eAAe,CAAC;AAE3H,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAM5D,eAAO,MAAM,KAAK;;;EAAoD,CAAC;AACvE,eAAO,MAAM,SAAS,iCAAkC,CAAC;AAEzD,qFAAqF;AACrF,eAAO,MAAM,MAAM,2CAAyB,CAAC;AAE7C,gFAAgF;AAChF,eAAO,MAAM,MAAM;;;8GAA0E,CAAC;AAE9F,kIAAkI;AAClI,eAAO,MAAM,SAAS,iLAAgD,CAAC;AACvE,eAAO,MAAM,UAAU;;;KAOpB,CAAC;AAEJ,2DAA2D;AAC3D,eAAO,MAAM,YAAY,gNACyG,CAAC;AAEnI,eAAO,MAAM,YAAY,2DAAyD,CAAC;AAOnF,4CAA4C;AAC5C,QAAA,MAAM,aAAa,EAAE,aAAwC,CAAC;AAC9D,eAAe,aAAa,CAAC;AAM7B,oCAAoC;AACpC,eAAO,MAAM,SAAS,6BAA8F,CAAC;AAErH,8CAA8C;AAC9C,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAGrD,CAAC;AAEH,6BAA6B;AAC7B,eAAO,MAAM,UAAU,6BAAkE,CAAC;AAE1F,gFAAgF;AAChF,eAAO,MAAM,WAAW,6BAAuG,CAAC;AAEhI,wBAAwB;AACxB,eAAO,MAAM,SAAS,4BAAkD,CAAC"}

package/dist/test/typed.examples.js

@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * The worked example of typed files and feeds: a price list that
+ * arrives as beast2 and is an input of its type with no task in between,
+ * and a price book, a record, fed through one of its mutations by each new
+ * delta file. `typedFiles` is what a partner drops, written with East's
+ * beast2 encoder; `wrongPrices` is a file of another type, and `notBeast2`
+ * no beast2 at all, which the examples' tests have refused.
+ */
+import { East, ArrayType, DictType, FloatType, IntegerType, StringType, StructType, encodeBeast2For } from '@elaraai/east';
+import e3 from '@elaraai/e3';
+import { Files } from '../src/index.js';
+const RUNNER = { runtime: 'east-c', platforms: ['east-c-std'] };
+// ─── src/package.ts ──────────────────────────────────────────────────────────
+export const Price = StructType({ sku: StringType, price: FloatType });
+export const PriceBook = DictType(StringType, FloatType);
+/** Where the partners' files are: each workspace binds it to a bucket and prefix. */
+export const upload = Files.source('upload');
+/** The price list, as the beast2 value it holds: an input of `Array<Price>`. */
+export const prices = upload.file('prices', { key: 'prices.beast2', type: ArrayType(Price) });
+/** The price book, a record the app's users may edit, and a mutation that loads a delivery into it, each price over its sku's. */
+export const priceBook = e3.record('price_book', PriceBook, new Map());
+export const loadPrices = e3.mutation.reduce('load_prices', priceBook, East.function([PriceBook, ArrayType(Price)], PriceBook, ($, state, rows) => {
+    // A copy of the book as it is (a mutation's state is immutable), each delivered price set over its sku's
+    const next = $.let(state.copy());
+    $.for(rows, ($, row) => {
+        $(next.insertOrUpdate(row.sku, row.price, (_$, _existing, delivered) => delivered));
+    });
+    return next;
+}));
+/** How many prices there are, in the list and the book. */
+export const priceSummary = e3.task('price_summary', [prices, priceBook], East.function([ArrayType(Price), PriceBook], IntegerType, (_$, rows, book) => rows.size().add(book.size())), { runner: RUNNER });
+export const typedPackage = e3.package('typed', '1.0.0', priceSummary, loadPrices);
+// ─── src/files.ts ────────────────────────────────────────────────────────────
+/** Each new delta file, the newest under `deltas/`, loads the price book through the mutation. */
+upload.mutation(loadPrices, { prefix: 'deltas/', include: '*.beast2' });
+/** What `e3-cloud files deploy` deploys. */
+const typedManifest = Files.manifest([upload]);
+export default typedManifest;
+// ─── What a partner drops ───────────────────────────────────────────────────
+const priceFile = encodeBeast2For(ArrayType(Price));
+/** The price list: three prices. */
+export const priceList = priceFile([{ sku: 'A1', price: 1.5 }, { sku: 'B2', price: 2.25 }, { sku: 'C3', price: 9 }]);
+/** Sample files, by key under the binding. */
+export const typedFiles = new Map([
+    ['prices.beast2', priceList],
+    ['deltas/2026-10-01.beast2', priceFile([{ sku: 'A1', price: 1.75 }])],
+]);
+/** A second delta, newer. */
+export const laterDelta = priceFile([{ sku: 'A1', price: 1.8 }, { sku: 'D4', price: 4 }]);
+/** A file of another type than the price list's: refused, naming both types. */
+export const wrongPrices = encodeBeast2For(ArrayType(StructType({ id: StringType, qty: IntegerType })))([{ id: 'x', qty: 1n }]);
+/** No beast2 at all. */
+export const notBeast2 = new TextEncoder().encode('sku,price\nA1,1.5\n');
+//# sourceMappingURL=typed.examples.js.map

package/dist/test/typed.examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed.examples.js","sourceRoot":"","sources":["../../test/typed.examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3H,OAAO,EAAmB,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAsB,MAAM,iBAAiB,CAAC;AAE5D,MAAM,MAAM,GAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;AAExE,gFAAgF;AAEhF,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAEzD,qFAAqF;AACrF,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAE7C,gFAAgF;AAChF,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAE9F,kIAAkI;AAClI,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAChJ,yGAAyG;IACzG,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACrB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC,CAAC;AAEJ,2DAA2D;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EACtE,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEnI,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;AAEnF,gFAAgF;AAEhF,kGAAkG;AAClG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;AAExE,4CAA4C;AAC5C,MAAM,aAAa,GAAkB,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,eAAe,aAAa,CAAC;AAE7B,+EAA+E;AAE/E,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAEpD,oCAAoC;AACpC,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAErH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,UAAU,GAAoC,IAAI,GAAG,CAAC;IACjE,CAAC,eAAe,EAAE,SAAS,CAAC;IAC5B,CAAC,0BAA0B,EAAE,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;CACtE,CAAC,CAAC;AAEH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE1F,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAEhI,wBAAwB;AACxB,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elaraai/e3-cloud-files",
-  "version": "1.0.93",
+  "version": "1.0.97",
   "description": "Files for e3 cloud: a solution's inputs that come from files in a bucket, declared in its code and synced on demand, locally and in the cloud",
   "type": "module",
   "main": "dist/src/index.js",
@@ -26,6 +26,10 @@
       "types": "./dist/src/s3/index.d.ts",
       "default": "./dist/src/s3/index.js"
     },
+    "./compat": {
+      "types": "./dist/src/compat.d.ts",
+      "default": "./dist/src/compat.js"
+    },
     "./examples/*": {
       "types": "./dist/test/*.examples.d.ts",
       "default": "./dist/test/*.examples.js"
@@ -53,14 +57,14 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@elaraai/e3-types": "1.0.93",
-    "@elaraai/e3-cloud-types": "1.0.93"
+    "@elaraai/e3-types": "1.0.97",
+    "@elaraai/e3-cloud-types": "1.0.97"
   },
   "peerDependencies": {
     "@aws-sdk/client-s3": "^3.966.0",
-    "@elaraai/e3": "1.0.93",
-    "@elaraai/e3-core": "1.0.93",
-    "@elaraai/east": "1.0.93"
+    "@elaraai/e3": "1.0.97",
+    "@elaraai/e3-core": "1.0.97",
+    "@elaraai/east": "1.0.97"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-s3": {