@adobe/data 0.6.2 → 0.7.0

package/dist/ecs/store/store-schema/create-store-schema.d.ts

@@ -1,11 +1 @@
-import { StringKeyof } from "../../../types/types.js";
-import { ComponentSchemas } from "../../component-schemas.js";
-import { ResourceSchemas } from "../../resource-schemas.js";
-import { ArchetypeComponents } from "../archetype-components.js";
-import { StoreSchema } from "./store-schema.js";
-export declare function createStoreSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>>(components: CS, resources: RS, archetypes: A): {
-    readonly components: CS;
-    readonly resources: RS;
-    readonly archetypes: A;
-};
-export declare function createStoreFromSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>>(schema: StoreSchema<CS, RS, A>): import("../store.js").Store<{ [K in Extract<keyof CS, string>]: import("../../../schema/schema.js").FromSchema<CS[K], 5>; }, { -readonly [K_1 in Extract<keyof RS, string>]: import("../../../schema/schema.js").FromSchema<RS[K_1], 5>; }, A>;
+export {};

package/dist/ecs/store/store-schema/create-store-schema.js

@@ -1,31 +1,45 @@
-/*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 { createStore } from "../create-store.js";
-export function createStoreSchema(components, resources, archetypes) {
-    return { components, resources, archetypes };
-}
-;
-export function createStoreFromSchema(schema) {
-    return createStore(schema.components, schema.resources, schema.archetypes);
-}
-;
+// /*MIT License
+export {};
+// © 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 { StringKeyof } from "../../../types/types.js";
+// import { ComponentSchemas } from "../../component-schemas.js";
+// import { ResourceSchemas } from "../../resource-schemas.js";
+// import { ArchetypeComponents } from "../archetype-components.js";
+// import { createStore } from "../create-store.js";
+// import { StoreSchema } from "./store-schema.js";
+// export function createStoreSchema<
+//     const CS extends ComponentSchemas,
+//     const RS extends ResourceSchemas,
+//     const A extends ArchetypeComponents<StringKeyof<CS>>,
+// >(
+//     components: CS,
+//     resources: RS,
+//     archetypes: A,
+// ) {
+//     return { components, resources, archetypes } as const satisfies StoreSchema<CS, RS, A>;
+// };
+// export function createStoreFromSchema<
+//     const CS extends ComponentSchemas,
+//     const RS extends ResourceSchemas,
+//     const A extends ArchetypeComponents<StringKeyof<CS>>,
+// >(
+//     schema: StoreSchema<CS, RS, A>,
+// ) {
+//     return createStore(schema.components, schema.resources, schema.archetypes);
+// };
 //# sourceMappingURL=create-store-schema.js.map

package/dist/ecs/store/store-schema/create-store-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-store-schema.js","sourceRoot":"","sources":["../../../../src/ecs/store/store-schema/create-store-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAMX,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,UAAU,iBAAiB,CAK7B,UAAc,EACd,SAAa,EACb,UAAa;IAEb,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAA4C,CAAC;AAC3F,CAAC;AAAA,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAKjC,MAA8B;IAE9B,OAAO,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC/E,CAAC;AAAA,CAAC"}
+{"version":3,"file":"create-store-schema.js","sourceRoot":"","sources":["../../../../src/ecs/store/store-schema/create-store-schema.ts"],"names":[],"mappings":"AAAA,gBAAgB;;AAEhB,+CAA+C;AAE/C,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAE3D,iFAAiF;AACjF,kDAAkD;AAElD,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,cAAc;AAEd,yDAAyD;AACzD,iEAAiE;AACjE,+DAA+D;AAC/D,oEAAoE;AACpE,oDAAoD;AACpD,mDAAmD;AAEnD,qCAAqC;AACrC,yCAAyC;AACzC,wCAAwC;AACxC,4DAA4D;AAC5D,KAAK;AACL,sBAAsB;AACtB,qBAAqB;AACrB,qBAAqB;AACrB,MAAM;AACN,8FAA8F;AAC9F,KAAK;AAEL,yCAAyC;AACzC,yCAAyC;AACzC,wCAAwC;AACxC,4DAA4D;AAC5D,KAAK;AACL,sCAAsC;AACtC,MAAM;AACN,kFAAkF;AAClF,KAAK"}

package/dist/ecs/store/store-schema/index.d.ts

@@ -1,2 +1 @@
-export * from "./create-store-schema.js";
-export * from "./store-schema.js";
+export {};

package/dist/ecs/store/store-schema/index.js

@@ -1,24 +1,21 @@
-/*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 "./create-store-schema.js";
-export * from "./store-schema.js";
+// /*MIT License
+export {};
+// © 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 "./create-store-schema.js";
+// export * from "./store-schema.js";
 //# sourceMappingURL=index.js.map

package/dist/ecs/store/store-schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ecs/store/store-schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ecs/store/store-schema/index.ts"],"names":[],"mappings":"AAAA,gBAAgB;;AAEhB,+CAA+C;AAE/C,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAE3D,iFAAiF;AACjF,kDAAkD;AAElD,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,cAAc;AAEd,4CAA4C;AAC5C,qCAAqC"}

package/dist/ecs/store/store-schema/store-schema.d.ts

@@ -1,12 +1 @@
-import { FromSchemas } from "../../../schema/schema.js";
-import { ComponentSchemas } from "../../component-schemas.js";
-import { ResourceSchemas } from "../../resource-schemas.js";
-import { Store } from "../store.js";
-import { ArchetypeComponents } from "../archetype-components.js";
-import { StringKeyof } from "../../../types/types.js";
-export type StoreSchema<CS extends ComponentSchemas, RS extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<CS>>> = {
-    readonly components: CS;
-    readonly resources: RS;
-    readonly archetypes: A;
-};
-export type StoreFromSchema<T> = T extends StoreSchema<infer CS, infer RS, infer A> ? Store<FromSchemas<CS>, FromSchemas<RS>, A> : never;
+export {};

package/dist/ecs/store/store-schema/store-schema.js

@@ -1,23 +1,57 @@
-/*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.*/
+// /*MIT License
 export {};
+// © 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 { FromSchemas } from "../../../schema/schema.js";
+// import { ComponentSchemas } from "../../component-schemas.js";
+// import { ResourceSchemas } from "../../resource-schemas.js";
+// import { Store } from "../store.js";
+// import { ArchetypeComponents } from "../archetype-components.js";
+// import { StringKeyof } from "../../../types/types.js";
+// import { Assert } from "../../../types/assert.js";
+// import { Equal } from "../../../types/equal.js";
+// import { Archetype } from "../../archetype/archetype.js";
+// import { CoreComponents } from "../../core-components.js";
+// export type StoreSchema<
+//     CS extends ComponentSchemas,
+//     RS extends ResourceSchemas,
+//     A extends ArchetypeComponents<StringKeyof<CS>>,
+// > = {
+//     readonly components: CS;
+//     readonly resources: RS;
+//     readonly archetypes: A;
+// };
+// export type StoreFromSchema<T> = T extends StoreSchema<infer CS, infer RS, infer A> ? Store<FromSchemas<CS>, FromSchemas<RS>, A> : never;
+// type CheckStoreFromSchema = StoreFromSchema<StoreSchema<{
+//     velocity: { type: "number" },
+//     particle: { type: "boolean" },
+// }, {
+//     mousePosition: { type: "number", default: 0 },
+//     fooPosition: { type: "number", default: 0 },
+// }, {
+//     Particle: ["particle"],
+//     DynamicParticle: ["particle", "velocity"],
+// }>>;
+// declare const testStore: CheckStoreFromSchema;
+// type CheckDynamicParticle = Assert<Equal<typeof testStore.archetypes.DynamicParticle, Archetype<CoreComponents & {
+//     particle: boolean;
+//     velocity: number;
+// }>>>;
+// type CheckParticle = Assert<Equal<typeof testStore.archetypes.Particle, Archetype<CoreComponents & {
+//     particle: boolean;
+// }>>>;
 //# sourceMappingURL=store-schema.js.map

package/dist/ecs/store/store-schema/store-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"store-schema.js","sourceRoot":"","sources":["../../../../src/ecs/store/store-schema/store-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW"}
+{"version":3,"file":"store-schema.js","sourceRoot":"","sources":["../../../../src/ecs/store/store-schema/store-schema.ts"],"names":[],"mappings":"AAAA,gBAAgB;;AAEhB,+CAA+C;AAE/C,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAE3D,iFAAiF;AACjF,kDAAkD;AAElD,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,cAAc;AAEd,2DAA2D;AAC3D,iEAAiE;AACjE,+DAA+D;AAC/D,uCAAuC;AACvC,oEAAoE;AACpE,yDAAyD;AACzD,qDAAqD;AACrD,mDAAmD;AACnD,4DAA4D;AAC5D,6DAA6D;AAE7D,2BAA2B;AAC3B,mCAAmC;AACnC,kCAAkC;AAClC,sDAAsD;AACtD,QAAQ;AACR,+BAA+B;AAC/B,8BAA8B;AAC9B,8BAA8B;AAC9B,KAAK;AAEL,4IAA4I;AAE5I,4DAA4D;AAC5D,oCAAoC;AACpC,qCAAqC;AACrC,OAAO;AACP,qDAAqD;AACrD,mDAAmD;AACnD,OAAO;AACP,8BAA8B;AAC9B,iDAAiD;AACjD,OAAO;AACP,iDAAiD;AACjD,qHAAqH;AACrH,yBAAyB;AACzB,wBAAwB;AACxB,QAAQ;AACR,uGAAuG;AACvG,yBAAyB;AACzB,QAAQ"}

package/dist/functions/serialization/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./serialize.js";
 export * from "./serialize-to-blobs.js";
+export * from "./serialize-to-json.js";

package/dist/functions/serialization/index.js

@@ -21,4 +21,5 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
 export * from "./serialize.js";
 export * from "./serialize-to-blobs.js";
+export * from "./serialize-to-json.js";
 //# sourceMappingURL=index.js.map

package/dist/functions/serialization/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/functions/serialization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/functions/serialization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/functions/serialization/serialize-to-json.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Serializes data to a single JSON string with base64-encoded and compressed binary data.
+ * The binary arrays are concatenated, compressed using deflate, and their original lengths are stored to allow reconstruction.
+ */
+export declare const serializeToJSON: <T>(data: T) => Promise<string>;
+/**
+ * Deserializes data from a JSON string with base64-encoded and compressed binary data.
+ */
+export declare const deserializeFromJSON: <T>(jsonString: string) => Promise<T>;

package/dist/functions/serialization/serialize-to-json.js

@@ -0,0 +1,161 @@
+/*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 { serialize, deserialize } from "./serialize.js";
+/**
+ * Converts a Uint8Array to a base64 string
+ * Uses chunked processing with String.fromCharCode for optimal performance
+ */
+const uint8ArrayToBase64 = (data) => {
+    // Process in 32KB chunks for two reasons:
+    // 1. Prevents "Maximum call stack size exceeded" with spread operator on large arrays
+    // 2. String.fromCharCode(...chunk) is a single optimized native call per chunk
+    const CHUNK_SIZE = 0x8000;
+    const chunks = [];
+    for (let i = 0; i < data.length; i += CHUNK_SIZE) {
+        const end = Math.min(i + CHUNK_SIZE, data.length);
+        const chunk = data.subarray(i, end);
+        chunks.push(String.fromCharCode(...chunk));
+    }
+    // Modern engines handle array.join() efficiently (no O(n²) with ropes/cons strings)
+    return btoa(chunks.join(''));
+};
+/**
+ * Converts a base64 string to a Uint8Array
+ */
+const base64ToUint8Array = (base64) => {
+    const binary = atob(base64);
+    const len = binary.length;
+    const bytes = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+};
+/**
+ * Compresses a Uint8Array using the deflate algorithm
+ */
+const compressData = async (data) => {
+    const stream = new ReadableStream({
+        start(controller) {
+            controller.enqueue(data);
+            controller.close();
+        }
+    });
+    const compressedStream = stream.pipeThrough(new CompressionStream('deflate'));
+    const chunks = [];
+    const reader = compressedStream.getReader();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+    }
+    // Concatenate all chunks
+    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+};
+/**
+ * Decompresses a Uint8Array using the deflate algorithm
+ */
+const decompressData = async (data) => {
+    const stream = new ReadableStream({
+        start(controller) {
+            controller.enqueue(data);
+            controller.close();
+        }
+    });
+    const decompressedStream = stream.pipeThrough(new DecompressionStream('deflate'));
+    const chunks = [];
+    const reader = decompressedStream.getReader();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+    }
+    // Concatenate all chunks
+    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+};
+/**
+ * Serializes data to a single JSON string with base64-encoded and compressed binary data.
+ * The binary arrays are concatenated, compressed using deflate, and their original lengths are stored to allow reconstruction.
+ */
+export const serializeToJSON = async (data) => {
+    const serialized = serialize(data);
+    // Store the length of each binary chunk
+    const lengths = serialized.binary.map(chunk => chunk.byteLength);
+    // Calculate total size and concatenate all binary arrays into a single Uint8Array
+    const totalSize = lengths.reduce((sum, len) => sum + len, 0);
+    const combinedBinary = new Uint8Array(totalSize);
+    let offset = 0;
+    for (const binaryChunk of serialized.binary) {
+        combinedBinary.set(binaryChunk, offset);
+        offset += binaryChunk.byteLength;
+    }
+    // Compress the binary data
+    const compressedBinary = await compressData(combinedBinary);
+    // Convert to base64
+    const base64Binary = uint8ArrayToBase64(compressedBinary);
+    const result = {
+        json: JSON.parse(serialized.json), // Parse to avoid double-encoding
+        lengths,
+        binary: base64Binary
+    };
+    return JSON.stringify(result, null, 2);
+};
+/**
+ * Deserializes data from a JSON string with base64-encoded and compressed binary data.
+ */
+export const deserializeFromJSON = async (jsonString) => {
+    const parsed = JSON.parse(jsonString);
+    // Convert base64 back to Uint8Array
+    const compressedBinary = base64ToUint8Array(parsed.binary);
+    // Decompress the binary data
+    const combinedBinary = await decompressData(compressedBinary);
+    // Split the combined binary back into chunks based on lengths
+    const binaryChunks = [];
+    let offset = 0;
+    for (const length of parsed.lengths) {
+        const chunk = combinedBinary.slice(offset, offset + length);
+        binaryChunks.push(chunk);
+        offset += length;
+    }
+    // Deserialize using the original deserialize function
+    return deserialize({
+        json: JSON.stringify(parsed.json), // Convert back to string for deserialize()
+        binary: binaryChunks
+    });
+};
+//# sourceMappingURL=serialize-to-json.js.map

package/dist/functions/serialization/serialize-to-json.js.map

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

package/dist/functions/serialization/serialize-to-json.test.d.ts

@@ -0,0 +1 @@
+export {};