@adobe/data 0.5.23 → 0.6.0

package/README.md

@@ -11,6 +11,11 @@ Adobe Data Oriented Programming Library
 
 Until we reach 1.0.0, minor version changes may be API breaking.
 
+## Data Oriented Programming
+
+This library is built using a data oriented and functional programming paradigm.
+We prefer composition over inheritance, avoid classes when possible and emphasize separation of concerns.
+
 ## Data
 
 This library uses data oriented design paradigm and prefers pure functional interfaces whenever practical.
@@ -156,7 +161,7 @@ The `memoize` function can be used to cache expensive, deterministic, asynchrono
 
 ### BlobStore
 
-It is important to handle `Blob`s correctly within an application. Retaining references to a large number of them can cause memory problems depending upon their size.
+It is important to handle `Blob`s correctly within an application.
 
 The `BlobStore` interface and corresponding `blobStore` exported instance provide a convenient way to convert `Blob`s into small JSON handles to them called `BlobRef`s. Those `BlobRef`s can later be converted back into a `Blob`.
 
@@ -165,7 +170,6 @@ The `BlobStore` interface and corresponding `blobStore` exported instance provid
 `BlobRef`s have a number of advantages over directly using blobs.
 `BlobRef`s are:
 - small json objects
-- use negligible memory since the `Blob` is stored on disc till needed.
 - deterministic for each `Blob` based on mime type and content.
 - suitable for persistence to locations with limited size.
 - suitable for use as a cache key
@@ -179,132 +183,114 @@ Contains some standard data type schemas in JSON Schema format for convenience.
 
 This ECS database is a high performance, strongly typed typescript implementation inspired by the Sanders Mertens C++ based [Flecs](https://www.flecs.dev/flecs/md_docs_2Docs.html).
 
-This library provides three different high performance ECS interfaces. They each share the same basic read API but differ in their interface for writing and observability of changes.
-
-- [ECS](./docs/api/interfaces/ecs.ECS.html)
-    - allows direct write access to the data.
-    - no changes are observability.
-- [Transaction ECS](./docs/api/interfaces/ecs.TransactionECS.html)
-    - requires transactions for writing changes.
-    - all changes are observable.
-- [Action ECS](./docs/api/interfaces/ecs.ActionECS.html)
-    - requires pre-defined actions for writing changes.
-    - actions are implemented using transactions.
-    - action functions must be synchronous and may never throw.
-    - all changes are observable.
-    - provides Operational Transform to resolve concurrent multi player edits.
-
-### What is an ECS?
+This library provides two main interfaces for ECS operations: **Store** and **Database**. They share the same read API but differ significantly in their approach to writing and observability.
 
-Sanders Mertens also covers this thoroughly in his ECS FAQ:
+### Store Interface
 
-[https://github.com/SanderMertens/ecs-faq?tab=readme-ov-file#what-is-ecs](https://github.com/SanderMertens/ecs-faq?tab=readme-ov-file#what-is-ecs)
+The **Store** is the foundational, low-level interface for direct ECS data operations.
 
-In addition to the Entity, Component and System definitions which are standard, we also use the term Resource. A Resource is just a value which is defined globally on the ECS itself and not attached to any specific Entity.
+**Key Characteristics:**
+- **Direct Access**: Provides immediate, synchronous read/write access to entities, components, and resources
+- **No Transaction Control**: Changes are applied directly without transaction boundaries  
+- **No Observability**: Changes are not automatically observable or trackable
+- **High Performance**: Minimal overhead for direct operations using Structure of Arrays (SoA) with linear memory layout of numeric types for optimal cache performance
+- **Core ECS Operations**: Includes entity creation, component updates, archetype querying, and resource management
 
-### Action ECS Usage
+**Usage**: Ideal for scenarios requiring fast, direct ECS manipulation where you don't need change tracking or transactional safety.
 
 ```typescript
-//  create an action ecs
-const ecs = createActionECS()
-  //  define components with schemas
-  .withComponents({
-    position: Vector3Schema,
-    velocity: Vector3Schema,
-    color: Vector4Schema,
-    size: { type: "number" },
+// Create a store with components, resources, and archetypes
+const store = createStore(
+  { 
+    position: Vec3.schema, 
     health: { type: "number" },
-    player: { const: true },
-  } as const)
-  //  define archetypes with component names
-  .withArchetypes({
-    particle: ["position", "velocity", "color", "size"],
-    player: ["position", "health", "player"],
-  })
-  //  define resources with initial values
-  .withResources({
-    gravity: 9.8,
-  })
-  //  define actions with transactional functions
-  .withActions({
-    createParticle(t, props: { position: Vector3, velocity: Vector3, color: Vector4, size: number }) {
-      t.createEntity(t.ecs.archetypes.particle, props);
-    },
-    deleteParticle(t, entity: number) {
-      t.deleteEntity(entity);
-    },
-    createPlayer(t, position: Vector3) {
-      t.createEntity(t.ecs.archetypes.player, { position, health: 100, player: true });
-    },
-    movePlayer(t, entity: number, position: Vector3) {
-      t.setComponentValue(entity, "position", position);
-    },
-    setGravity(t, gravity: number) {
-      t.resources.gravity = gravity;
-    },
-  })
-
-//  call some actions to modify the ECS
-ecs.actions.createParticle({ position: [0, 0, 0], velocity: [1, 0, 0], color: [1, 1, 1, 1], size: 1 });
-ecs.actions.createParticle({ position: [1, 1, 1], velocity: [1, 1, 1], color: [1, 1, 1, 1], size: 2 });
-ecs.actions.createPlayer([10, 20, 0]);
-ecs.actions.movePlayer(1, [10, 20, 0]);
-
-//  read some values from the ECS
-const players = ecs.selectEntities(ecs.archetypes.player);
-const particles = ecs.selectEntities(ecs.archetypes.particle);
-
-//  observe changes to the ECS
-ecs.observe.archetypeEntities(ecs.archetypes.player)((playerEntities) => {
-  for (const playerEntity of playerEntities) {
-    const player = ecs.getEntityValues(playerEntity);
-    console.log("Player entity changed", player);
+    player: { const: true } 
+  },
+  { 
+    gravity: { default: 9.8 as number } 
+  },
+  {
+    Player: ["position", "health", "player"],
+    Particle: ["position"]
   }
-});
+);
 
+// Direct operations
+const playerId = store.archetypes.Player.insert({ 
+  position: [0, 0, 0], 
+  health: 100, 
+  player: true 
+});
+store.update(playerId, { position: [1, 1, 1] });
+store.resources.gravity = 10.0;
 ```
 
-### ECS Persistence
+### Database Interface
+
+The **Database** wraps a Store to provide **transaction-based operations** with **full observability**.
+
+**Key Characteristics:**
+- **Transaction-Based**: All changes must occur within predefined atomic transactions that can be undone.
+- **Full Observability**: Every change is observable through the `observe` API
+- **Predefined Operations**: Uses predefined transaction functions rather than direct mutations
+- **Undo/Redo Support**: Transactions generate undo/redo operations automatically
+- **Change Tracking**: Tracks which entities, components, and archetypes changed
+- **Event Notifications**: Automatically notifies observers of changes
 
-The ECS can be converted to JSON and from JSON.
+**Usage**: Ideal for applications requiring change history, multiplayer synchronization, undo/redo functionality, or reactive UI updates.
 
-The persistence format is logically consistent with the internal ECS data format so studying it may help you understand how an ECS is structured:
+**Important Note**: Even when using a Database, transaction functions are written as direct modifications to the underlying Store interface. The Database wraps these operations to provide transactional guarantees and observability.
 
 ```typescript
-{
-  ecs: true,
-  version: 2,
-  components: {
-    id: { type: 'integer', minimum: +0, maximum: 4294967295 },
-    position: { type: 'array', items: { type: 'number', precision: 1 }, minItems: 3, maxItems: 3 },
-    velocity: { type: 'array', items: { type: 'number', precision: 1 }, minItems: 3, maxItems: 3 },
-    color: { type: 'array', items: { type: 'number', precision: 1 }, minItems: 3, maxItems: 3 },
-    size: { type: 'number' }, health: { type: 'number' }, player: { const: true },
-    gravity: {}
+// Create a database with predefined transactions
+const database = createDatabase(store, {
+  createPlayer(t, args: { position: Vector3, health: number }) {
+    // Transaction function receives Store interface for direct operations
+    return t.archetypes.Player.insert({ 
+      ...args, 
+      player: true 
+    });
   },
-  //  The main entities table has two entries for each entity.
-  //  The first value is the index of the tables array and represents the entities archetype.
-  //  The second value is the row of the entity within the archetype table.
-  entities: [ 3, +0, 1, +0, 1, +1, 2, +0 ],
-  tables: [
-    { rows: +0, columns: { id: [] } },  // the empty archetype contains only an id component
-    {
-      rows: 2,
-      columns: {
-        //  component data is stored as Structure of Arrays (SoA)
-        id: [ 1, 2 ],
-        color: [ [1, 0, 0, 0], [1, 1, 1, 1] ],
-        position: [ [0, 0, 0, 0], [1, 1, 1, 1] ],
-        size: [ 1, 2 ],
-        velocity: [ [0, 0, 0], [1, 1, 1] ]
-      }
-    },
-    { rows: 1, columns: { id: [ 3 ], health: [ 100 ], player: true, position: [ [ 10, 20, +0 ] ] } },
-    { rows: 1, columns: { gravity: [ 9.8 ], id: [ +0 ] } }  // resources are stored internally as components
-  ]
-}
+  movePlayer(t, args: { entity: Entity, position: Vector3 }) {
+    // Direct Store operations within transaction context
+    t.update(args.entity, { position: args.position });
+  },
+  setGravity(t, gravity: number) {
+    // Direct resource modification within transaction
+    t.resources.gravity = gravity;
+  }
+});
+
+// Execute transactions (these provide observability and undo/redo)
+const playerId = database.transactions.createPlayer({ 
+  position: [10, 20, 0], 
+  health: 100 
+});
+database.transactions.movePlayer({ entity: playerId, position: [15, 25, 5] });
+
+// Observe all changes
+database.observe.transactions((result) => {
+  console.log('Transaction applied:', result);
+  console.log('Changed entities:', result.changedEntities);
+  console.log('Undo operations:', result.undo);
+});
+
+// Observe specific entities
+database.observe.entity(playerId)((entityData) => {
+  if (entityData) {
+    console.log('Player moved to:', entityData.position);
+  }
+});
 ```
 
+### What is an ECS?
+
+Sanders Mertens also covers this thoroughly in his ECS FAQ:
+
+[https://github.com/SanderMertens/ecs-faq?tab=readme-ov-file#what-is-ecs](https://github.com/SanderMertens/ecs-faq?tab=readme-ov-file#what-is-ecs)
+
+In addition to the Entity, Component and System definitions which are standard, we also use the term Resource. A Resource is just a value which is defined globally on the ECS itself and not attached to any specific Entity. You can think of them as a singleton Component.
+
 ## Performance Test
 
 [Performance Test](https://git.corp.adobe.com/pages/neuralfiltersplatform/firefly-data/docs/perftest.html)

package/dist/blob/blob-handle.d.ts

@@ -1,5 +1,5 @@
 import { FromSchema } from "../schema/schema.js";
-export declare const BlobHandleSchema: {
+declare const BlobHandleSchema: {
     readonly type: "object";
     readonly properties: {
         readonly handle: {
@@ -8,6 +8,12 @@ export declare const BlobHandleSchema: {
         readonly expires: {
             readonly type: "string";
         };
+        readonly upload: {
+            readonly type: "boolean";
+        };
+        readonly download: {
+            readonly type: "boolean";
+        };
         readonly type: {
             readonly type: "string";
         };
@@ -24,6 +30,51 @@ export declare const BlobHandleSchema: {
             readonly type: "number";
         };
     };
-    readonly required: readonly ["type", "size", "handle"];
+    readonly required: readonly ["type", "size", "handle", "expires"];
 };
 export type BlobHandle = FromSchema<typeof BlobHandleSchema>;
+export type UploadHandle = BlobHandle & {
+    upload: true;
+};
+export type DownloadHandle = BlobHandle & {
+    download: true;
+};
+export declare namespace BlobHandle {
+    const schema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly handle: {
+                readonly type: "string";
+            };
+            readonly expires: {
+                readonly type: "string";
+            };
+            readonly upload: {
+                readonly type: "boolean";
+            };
+            readonly download: {
+                readonly type: "boolean";
+            };
+            readonly type: {
+                readonly type: "string";
+            };
+            readonly size: {
+                readonly type: "number";
+            };
+            readonly width: {
+                readonly type: "number";
+            };
+            readonly height: {
+                readonly type: "number";
+            };
+            readonly duration: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["type", "size", "handle", "expires"];
+    };
+    function is(value: unknown): value is BlobHandle;
+    function isUpload(value: unknown): value is UploadHandle;
+    function isDownload(value: unknown): value is DownloadHandle;
+}
+export {};

package/dist/blob/blob-handle.js

@@ -1,11 +1,55 @@
-import { BlobMetaSchema } from "./blob-meta.js";
-export const BlobHandleSchema = {
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { BlobMeta } from "./blob-meta.js";
+const BlobHandleSchema = {
     type: 'object',
     properties: {
-        ...BlobMetaSchema.properties,
+        ...BlobMeta.schema.properties,
         handle: { type: 'string' },
         expires: { type: 'string' },
+        upload: { type: 'boolean' },
+        download: { type: 'boolean' },
     },
-    required: [...BlobMetaSchema.required, 'handle'],
+    required: [...BlobMeta.schema.required, 'handle', 'expires'],
 };
+export var BlobHandle;
+(function (BlobHandle) {
+    BlobHandle.schema = BlobHandleSchema;
+    function is(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            'handle' in value &&
+            'expires' in value &&
+            typeof value.handle === 'string' &&
+            typeof value.expires === 'string');
+    }
+    BlobHandle.is = is;
+    function isUpload(value) {
+        return is(value) && 'upload' in value && value.upload === true;
+    }
+    BlobHandle.isUpload = isUpload;
+    function isDownload(value) {
+        return is(value) && 'download' in value && value.download === true;
+    }
+    BlobHandle.isDownload = isDownload;
+})(BlobHandle || (BlobHandle = {}));
 //# sourceMappingURL=blob-handle.js.map

package/dist/blob/blob-handle.js.map

@@ -1 +1 @@
-{"version":3,"file":"blob-handle.js","sourceRoot":"","sources":["../../src/blob/blob-handle.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAI1D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,GAAG,cAAc,CAAC,UAAU;QAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC9B;IACD,QAAQ,EAAE,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACzB,CAAC"}
+{"version":3,"file":"blob-handle.js","sourceRoot":"","sources":["../../src/blob/blob-handle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAGX,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,gBAAgB,GAAG;IACrB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAChC;IACD,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;CACrC,CAAC;AAK5B,MAAM,KAAW,UAAU,CAkB1B;AAlBD,WAAiB,UAAU;IACV,iBAAM,GAAG,gBAAgB,CAAC;IACvC,SAAgB,EAAE,CAAC,KAAc;QAC7B,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,QAAQ,IAAI,KAAK;YACjB,SAAS,IAAI,KAAK;YAClB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YAChC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CACpC,CAAC;IACN,CAAC;IATe,aAAE,KASjB,CAAA;IACD,SAAgB,QAAQ,CAAC,KAAc;QACnC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,QAAQ,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;IACnE,CAAC;IAFe,mBAAQ,WAEvB,CAAA;IACD,SAAgB,UAAU,CAAC,KAAc;QACrC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,UAAU,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;IACvE,CAAC;IAFe,qBAAU,aAEzB,CAAA;AACL,CAAC,EAlBgB,UAAU,KAAV,UAAU,QAkB1B"}

package/dist/blob/blob-meta.d.ts

@@ -1,5 +1,5 @@
 import { FromSchema } from "../schema/schema.js";
-export declare const BlobMetaSchema: {
+declare const BlobMetaSchema: {
     readonly type: "object";
     readonly properties: {
         readonly type: {
@@ -21,3 +21,28 @@ export declare const BlobMetaSchema: {
     readonly required: readonly ["type", "size"];
 };
 export type BlobMeta = FromSchema<typeof BlobMetaSchema>;
+export declare namespace BlobMeta {
+    const schema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly type: {
+                readonly type: "string";
+            };
+            readonly size: {
+                readonly type: "number";
+            };
+            readonly width: {
+                readonly type: "number";
+            };
+            readonly height: {
+                readonly type: "number";
+            };
+            readonly duration: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["type", "size"];
+    };
+    function is(value: unknown): value is BlobMeta;
+}
+export {};

package/dist/blob/blob-meta.js

@@ -1,4 +1,4 @@
-export const BlobMetaSchema = {
+const BlobMetaSchema = {
     type: 'object',
     properties: {
         type: { type: 'string' },
@@ -9,4 +9,17 @@ export const BlobMetaSchema = {
     },
     required: ['type', 'size'],
 };
+export var BlobMeta;
+(function (BlobMeta) {
+    BlobMeta.schema = BlobMetaSchema;
+    function is(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            'type' in value &&
+            'size' in value &&
+            typeof value.type === 'string' &&
+            typeof value.size === 'number');
+    }
+    BlobMeta.is = is;
+})(BlobMeta || (BlobMeta = {}));
 //# sourceMappingURL=blob-meta.js.map

package/dist/blob/blob-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"blob-meta.js","sourceRoot":"","sources":["../../src/blob/blob-meta.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC/B;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;CACH,CAAC"}
+{"version":3,"file":"blob-meta.js","sourceRoot":"","sources":["../../src/blob/blob-meta.ts"],"names":[],"mappings":"AAuBA,MAAM,cAAc,GAAG;IACnB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC/B;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;CACH,CAAC;AAG5B,MAAM,KAAW,QAAQ,CAYxB;AAZD,WAAiB,QAAQ;IACR,eAAM,GAAG,cAAc,CAAC;IACrC,SAAgB,EAAE,CAAC,KAAc;QAC7B,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,MAAM,IAAI,KAAK;YACf,MAAM,IAAI,KAAK;YACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC9B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CACjC,CAAC;IACN,CAAC;IATe,WAAE,KASjB,CAAA;AACL,CAAC,EAZgB,QAAQ,KAAR,QAAQ,QAYxB"}

package/dist/blob/index.d.ts

@@ -1,4 +1,2 @@
 export * from "./blob-handle.js";
 export * from "./blob-meta.js";
-export * from "./download-handle.js";
-export * from "./upload-handle.js";

package/dist/blob/index.js

@@ -1,5 +1,24 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
 export * from "./blob-handle.js";
 export * from "./blob-meta.js";
-export * from "./download-handle.js";
-export * from "./upload-handle.js";
 //# sourceMappingURL=index.js.map

package/dist/blob/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/blob/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/blob/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/cache/functions/hashing/blob-to-hash.js

@@ -42,11 +42,13 @@ export async function blobToHash(blob) {
         const writer = digestStream.writable.getWriter();
         await writer.write(tBytes);
         const reader = blob.stream().getReader();
-        while (true) {
-            const { value, done } = await reader.read();
-            if (done)
-                break;
-            await writer.write(value);
+        let done = false;
+        while (!done) {
+            const result = await reader.read();
+            done = result.done;
+            if (!done) {
+                await writer.write(result.value);
+            }
         }
         await writer.close();
         const hashBuf = await digestStream.digest;

package/dist/cache/functions/hashing/blob-to-hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"blob-to-hash.js","sourceRoot":"","sources":["../../../../src/cache/functions/hashing/blob-to-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAU;IACzC,sBAAsB;IACtB,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,IAAK,MAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAEjE,mCAAmC;QACnC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE7C,wCAAwC;QACxC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACjD,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;QACzC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,MAAM,MAAM,CAAC,KAAK,CAAC,KAAM,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC;QAC1C,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,iBAAiB;IACjB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IACtB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3D,mEAAmE;IACnE,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEvE,wBAAwB;IACxB,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;IACjD,QAAQ,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC,CAAC;IAE9D,2BAA2B;IAC3B,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"blob-to-hash.js","sourceRoot":"","sources":["../../../../src/cache/functions/hashing/blob-to-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAU;IACzC,sBAAsB;IACtB,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,IAAK,MAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAEjE,mCAAmC;QACnC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE7C,wCAAwC;QACxC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACjD,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;QACzC,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,OAAO,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAM,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC;QAC1C,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,iBAAiB;IACjB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IACtB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAE3D,mEAAmE;IACnE,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEvE,wBAAwB;IACxB,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;IACjD,QAAQ,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC,CAAC;IAE9D,2BAA2B;IAC3B,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}