@fideus-labs/fizarrita 1.0.0

package/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026-present Fideus Labs LLC <info@fideus.io>
+
+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.

package/dist/codec-worker.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Web Worker that handles encode/decode operations using zarrita's codec pipeline.
+ *
+ * Uses our self-contained codec pipeline builder (which references zarrita's
+ * publicly exported `registry`) to decode/encode chunks with real codecs
+ * (gzip, blosc, zstd, bytes, transpose, etc.).
+ *
+ * Message protocol:
+ *   init:        { type: 'init', id, metaId, meta: CodecChunkMeta }
+ *                -> { type: 'init_ok', id }
+ *
+ *   decode:      { type: 'decode', id, bytes: ArrayBuffer, metaId }
+ *                -> { type: 'decoded', id, data: ArrayBuffer, shape, stride }
+ *
+ *   decode_into: { type: 'decode_into', id, bytes, metaId, output: SAB, ... }
+ *                -> { type: 'decode_into_ok', id }
+ *                Worker decodes and writes directly into SharedArrayBuffer.
+ *
+ *   encode:      { type: 'encode', id, data: ArrayBuffer, metaId }
+ *                -> { type: 'encoded', id, bytes: ArrayBuffer }
+ */
+export {};
+//# sourceMappingURL=codec-worker.d.ts.map

package/dist/codec-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-worker.d.ts","sourceRoot":"","sources":["../src/codec-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/codec-worker.js

@@ -0,0 +1,149 @@
+/**
+ * Web Worker that handles encode/decode operations using zarrita's codec pipeline.
+ *
+ * Uses our self-contained codec pipeline builder (which references zarrita's
+ * publicly exported `registry`) to decode/encode chunks with real codecs
+ * (gzip, blosc, zstd, bytes, transpose, etc.).
+ *
+ * Message protocol:
+ *   init:        { type: 'init', id, metaId, meta: CodecChunkMeta }
+ *                -> { type: 'init_ok', id }
+ *
+ *   decode:      { type: 'decode', id, bytes: ArrayBuffer, metaId }
+ *                -> { type: 'decoded', id, data: ArrayBuffer, shape, stride }
+ *
+ *   decode_into: { type: 'decode_into', id, bytes, metaId, output: SAB, ... }
+ *                -> { type: 'decode_into_ok', id }
+ *                Worker decodes and writes directly into SharedArrayBuffer.
+ *
+ *   encode:      { type: 'encode', id, data: ArrayBuffer, metaId }
+ *                -> { type: 'encoded', id, bytes: ArrayBuffer }
+ */
+import { create_codec_pipeline } from './internals/codec-pipeline.js';
+import { compat_chunk, set_from_chunk_binary } from './internals/setter.js';
+import { get_ctr, get_strides } from './internals/util.js';
+const ctx = self;
+// ---------------------------------------------------------------------------
+// Codec pipeline cache — keyed by metaId (integer lookup, no JSON.stringify)
+// ---------------------------------------------------------------------------
+const pipelineByMetaId = new Map();
+const metaByMetaId = new Map();
+// Legacy fallback: pipeline cache keyed by JSON string (for any decode/encode
+// messages that arrive with a full `meta` object instead of `metaId`)
+const pipelineByKey = new Map();
+function getPipeline(metaId) {
+    const pipeline = pipelineByMetaId.get(metaId);
+    if (!pipeline) {
+        throw new Error(`No pipeline for metaId ${metaId}. Send an 'init' message first.`);
+    }
+    return pipeline;
+}
+function getOrCreatePipelineLegacy(meta) {
+    const key = JSON.stringify(meta);
+    let pipeline = pipelineByKey.get(key);
+    if (!pipeline) {
+        pipeline = create_codec_pipeline({
+            data_type: meta.data_type,
+            shape: meta.chunk_shape,
+            codecs: meta.codecs,
+        });
+        pipelineByKey.set(key, pipeline);
+    }
+    return pipeline;
+}
+ctx.addEventListener('message', async (event) => {
+    const msg = event.data;
+    try {
+        if (msg.type === 'init') {
+            // Register codec metadata and pre-create pipeline
+            metaByMetaId.set(msg.metaId, msg.meta);
+            const pipeline = create_codec_pipeline({
+                data_type: msg.meta.data_type,
+                shape: msg.meta.chunk_shape,
+                codecs: msg.meta.codecs,
+            });
+            pipelineByMetaId.set(msg.metaId, pipeline);
+            ctx.postMessage({ type: 'init_ok', id: msg.id });
+            return;
+        }
+        if (msg.type === 'decode') {
+            // Resolve pipeline: prefer metaId, fall back to legacy meta
+            const pipeline = msg.metaId !== undefined && pipelineByMetaId.has(msg.metaId)
+                ? getPipeline(msg.metaId)
+                : getOrCreatePipelineLegacy(msg.meta);
+            const bytes = new Uint8Array(msg.bytes);
+            const chunk = await pipeline.decode(bytes);
+            // Extract the underlying ArrayBuffer from the decoded TypedArray
+            const dataView = chunk.data;
+            const buffer = dataView.buffer;
+            const byteOffset = dataView.byteOffset;
+            const byteLength = dataView.byteLength;
+            // If the decoded data doesn't own the full buffer, copy for clean transfer
+            let transferBuffer;
+            if (byteOffset === 0 && byteLength === buffer.byteLength) {
+                transferBuffer = buffer;
+            }
+            else {
+                transferBuffer = buffer.slice(byteOffset, byteOffset + byteLength);
+            }
+            ctx.postMessage({
+                type: 'decoded',
+                id: msg.id,
+                data: transferBuffer,
+                shape: chunk.shape,
+                stride: chunk.stride,
+            }, [transferBuffer]);
+        }
+        else if (msg.type === 'decode_into') {
+            // Decode and write directly into SharedArrayBuffer — no transfer back
+            const pipeline = getPipeline(msg.metaId);
+            const bytes = new Uint8Array(msg.bytes);
+            const chunk = await pipeline.decode(bytes);
+            // Create a Uint8Array view over the shared output buffer
+            const destView = new Uint8Array(msg.output, 0, msg.outputByteLength);
+            // Convert decoded chunk to byte-level representation
+            const src = compat_chunk(chunk);
+            // Write decoded data directly into the shared output memory
+            set_from_chunk_binary({ data: destView, stride: msg.outputStride }, src, msg.bytesPerElement, msg.projections);
+            ctx.postMessage({ type: 'decode_into_ok', id: msg.id });
+        }
+        else if (msg.type === 'encode') {
+            // Resolve pipeline and meta
+            let pipeline;
+            let meta;
+            if (msg.metaId !== undefined && pipelineByMetaId.has(msg.metaId)) {
+                pipeline = getPipeline(msg.metaId);
+                meta = metaByMetaId.get(msg.metaId);
+            }
+            else {
+                meta = msg.meta;
+                pipeline = getOrCreatePipelineLegacy(meta);
+            }
+            // Reconstruct a Chunk from the transferred ArrayBuffer
+            const Ctr = get_ctr(meta.data_type);
+            const data = new Ctr(msg.data, 0, msg.data.byteLength / Ctr.BYTES_PER_ELEMENT);
+            const shape = meta.chunk_shape;
+            const stride = get_strides(shape, 'C');
+            const chunk = { data, shape, stride };
+            const encoded = await pipeline.encode(chunk);
+            // Transfer the encoded bytes back
+            const transferBuffer = encoded.byteOffset === 0 && encoded.byteLength === encoded.buffer.byteLength
+                ? encoded.buffer
+                : encoded.buffer.slice(encoded.byteOffset, encoded.byteOffset + encoded.byteLength);
+            ctx.postMessage({
+                type: 'encoded',
+                id: msg.id,
+                bytes: transferBuffer,
+            }, [transferBuffer]);
+        }
+    }
+    catch (error) {
+        // Send error back to main thread
+        ctx.postMessage({
+            type: msg.type === 'decode' ? 'decoded' : msg.type === 'encode' ? 'encoded' : msg.type === 'decode_into' ? 'decode_into_ok' : 'init_ok',
+            id: msg.id,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+});
+//# sourceMappingURL=codec-worker.js.map

package/dist/codec-worker.js.map

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

package/dist/get-worker.d.ts

@@ -0,0 +1,40 @@
+/**
+ * getWorker() — Worker-accelerated get for zarrita arrays.
+ *
+ * Reads data from a zarrita Array, offloading codec decode operations to a
+ * WorkerPool. The main thread fetches raw bytes from the store, transfers
+ * them to a worker for decoding, then copies the decoded chunk into the
+ * output array on the main thread.
+ *
+ * Uses WorkerPool.runTasks() for bounded-concurrency scheduling.
+ */
+import type { Array as ZarrArray, Chunk, DataType, Readable, Scalar, Slice } from 'zarrita';
+import type { GetWorkerOptions } from './types.js';
+/**
+ * Read data from a zarrita Array with codec decoding offloaded to Web Workers.
+ *
+ * Drop-in replacement for zarrita's `get()` with worker acceleration.
+ * The main thread fetches raw bytes from the store, then workers handle
+ * the (potentially expensive) codec decode operations in parallel.
+ *
+ * @param arr       - The zarrita Array to read from.
+ * @param selection - Index selection (null for full array, or per-dimension slices/indices).
+ * @param opts      - Options including the WorkerPool and store options.
+ * @returns The result chunk, or a scalar if all dimensions are integer-indexed.
+ *
+ * @example
+ * ```ts
+ * import { WorkerPool } from '@fideus-labs/worker-pool'
+ * import { getWorker } from '@fideus-labs/fizarrita'
+ * import * as zarr from 'zarrita'
+ *
+ * const pool = new WorkerPool(4)
+ * const store = new zarr.FetchStore('https://example.com/data.zarr')
+ * const arr = await zarr.open(store, { kind: 'array' })
+ * const result = await getWorker(arr, null, { pool })
+ *
+ * pool.terminateWorkers()
+ * ```
+ */
+export declare function getWorker<D extends DataType, Store extends Readable, Sel extends (null | Slice | number)[]>(arr: ZarrArray<D, Store>, selection: (Sel | null) | undefined, opts: GetWorkerOptions<Parameters<Store['get']>[1]>): Promise<null extends Sel[number] ? Chunk<D> : Slice extends Sel[number] ? Chunk<D> : Scalar<D>>;
+//# sourceMappingURL=get-worker.d.ts.map

package/dist/get-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-worker.d.ts","sourceRoot":"","sources":["../src/get-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,KAAK,IAAI,SAAS,EAClB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,KAAK,EACN,MAAM,SAAS,CAAA;AAUhB,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAA;AAyFlE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,SAAS,CAC7B,CAAC,SAAS,QAAQ,EAClB,KAAK,SAAS,QAAQ,EACtB,GAAG,SAAS,CAAC,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,EAAE,EAErC,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,EACxB,SAAS,GAAE,GAAG,GAAG,IAAI,aAAO,EAC5B,IAAI,EAAE,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CACR,IAAI,SAAS,GAAG,CAAC,MAAM,CAAC,GACpB,KAAK,CAAC,CAAC,CAAC,GACR,KAAK,SAAS,GAAG,CAAC,MAAM,CAAC,GACvB,KAAK,CAAC,CAAC,CAAC,GACR,MAAM,CAAC,CAAC,CAAC,CAChB,CAoHA"}

package/dist/get-worker.js

@@ -0,0 +1,203 @@
+/**
+ * getWorker() — Worker-accelerated get for zarrita arrays.
+ *
+ * Reads data from a zarrita Array, offloading codec decode operations to a
+ * WorkerPool. The main thread fetches raw bytes from the store, transfers
+ * them to a worker for decoding, then copies the decoded chunk into the
+ * output array on the main thread.
+ *
+ * Uses WorkerPool.runTasks() for bounded-concurrency scheduling.
+ */
+import { BasicIndexer } from './internals/indexer.js';
+import { setter } from './internals/setter.js';
+import { get_ctr, get_strides, create_chunk_key_encoder, assertSharedArrayBufferAvailable, createBuffer, } from './internals/util.js';
+import { workerDecode, workerDecodeInto, getMetaId } from './worker-rpc.js';
+/**
+ * Default URL for the codec worker. Uses `import.meta.url` to resolve
+ * relative to this module.
+ */
+const DEFAULT_WORKER_URL = new URL('./codec-worker.js', import.meta.url);
+/** Shared TextDecoder instance. */
+const decoder = new TextDecoder();
+async function readArrayMetadata(arr) {
+    const store = arr.store;
+    // Try v3 first: read zarr.json
+    const v3Path = (arr.path === '/' ? '/zarr.json' : `${arr.path}/zarr.json`);
+    const v3Bytes = await store.get(v3Path);
+    if (v3Bytes) {
+        const metadata = JSON.parse(decoder.decode(v3Bytes));
+        return {
+            codecMeta: {
+                data_type: metadata.data_type,
+                chunk_shape: metadata.chunk_grid.configuration.chunk_shape,
+                codecs: metadata.codecs,
+            },
+            encodeChunkKey: create_chunk_key_encoder(metadata.chunk_key_encoding),
+            fillValue: metadata.fill_value ?? null,
+        };
+    }
+    // Try v2: read .zarray
+    const v2Path = (arr.path === '/' ? '/.zarray' : `${arr.path}/.zarray`);
+    const v2Bytes = await store.get(v2Path);
+    if (v2Bytes) {
+        const metadata = JSON.parse(decoder.decode(v2Bytes));
+        const codecs = [];
+        if (metadata.order === 'F') {
+            codecs.push({ name: 'transpose', configuration: { order: 'F' } });
+        }
+        if (metadata.compressor) {
+            const { id, ...configuration } = metadata.compressor;
+            codecs.push({ name: id, configuration });
+        }
+        for (const { id, ...configuration } of metadata.filters ?? []) {
+            codecs.push({ name: id, configuration });
+        }
+        return {
+            codecMeta: {
+                data_type: arr.dtype,
+                chunk_shape: arr.chunks,
+                codecs: codecs.length > 0 ? codecs : [{ name: 'bytes', configuration: { endian: 'little' } }],
+            },
+            encodeChunkKey: create_chunk_key_encoder({
+                name: 'v2',
+                configuration: { separator: metadata.dimension_separator ?? '.' },
+            }),
+            fillValue: metadata.fill_value ?? null,
+        };
+    }
+    // Fallback: BytesCodec only, default v3 key encoding
+    return {
+        codecMeta: {
+            data_type: arr.dtype,
+            chunk_shape: arr.chunks,
+            codecs: [{ name: 'bytes', configuration: { endian: 'little' } }],
+        },
+        encodeChunkKey: create_chunk_key_encoder({ name: 'default' }),
+        fillValue: null,
+    };
+}
+// ---------------------------------------------------------------------------
+// getWorker
+// ---------------------------------------------------------------------------
+/**
+ * Read data from a zarrita Array with codec decoding offloaded to Web Workers.
+ *
+ * Drop-in replacement for zarrita's `get()` with worker acceleration.
+ * The main thread fetches raw bytes from the store, then workers handle
+ * the (potentially expensive) codec decode operations in parallel.
+ *
+ * @param arr       - The zarrita Array to read from.
+ * @param selection - Index selection (null for full array, or per-dimension slices/indices).
+ * @param opts      - Options including the WorkerPool and store options.
+ * @returns The result chunk, or a scalar if all dimensions are integer-indexed.
+ *
+ * @example
+ * ```ts
+ * import { WorkerPool } from '@fideus-labs/worker-pool'
+ * import { getWorker } from '@fideus-labs/fizarrita'
+ * import * as zarr from 'zarrita'
+ *
+ * const pool = new WorkerPool(4)
+ * const store = new zarr.FetchStore('https://example.com/data.zarr')
+ * const arr = await zarr.open(store, { kind: 'array' })
+ * const result = await getWorker(arr, null, { pool })
+ *
+ * pool.terminateWorkers()
+ * ```
+ */
+export async function getWorker(arr, selection = null, opts) {
+    const { pool, workerUrl } = opts;
+    const resolvedWorkerUrl = workerUrl ?? DEFAULT_WORKER_URL;
+    const useShared = !!opts.useSharedArrayBuffer;
+    if (useShared) {
+        assertSharedArrayBufferAvailable();
+    }
+    // Read metadata from store — single read, single parse
+    const { codecMeta, encodeChunkKey, fillValue } = await readArrayMetadata(arr);
+    // Get stable metaId for the codec metadata (used by worker-rpc meta-init)
+    const metaId = getMetaId(codecMeta);
+    const Ctr = get_ctr(arr.dtype);
+    const bytesPerElement = Ctr.BYTES_PER_ELEMENT;
+    // Set up the indexer
+    const indexer = new BasicIndexer({
+        selection,
+        shape: arr.shape,
+        chunk_shape: arr.chunks,
+    });
+    // Allocate output — backed by SharedArrayBuffer when requested
+    const size = indexer.shape.reduce((a, b) => a * b, 1);
+    const buffer = createBuffer(size * bytesPerElement, useShared);
+    const data = new Ctr(buffer, 0, size);
+    const outStride = get_strides(indexer.shape);
+    const out = setter.prepare(data, indexer.shape, outStride);
+    // Pre-compute chunk invariants (hoisted out of loop)
+    const chunkShape = arr.chunks;
+    const chunkStrides = get_strides(chunkShape);
+    const chunkSize = chunkShape.reduce((a, b) => a * b, 1);
+    // Build tasks — one per chunk
+    const tasks = [];
+    for (const { chunk_coords, mapping } of indexer) {
+        const chunkKey = encodeChunkKey(chunk_coords);
+        const chunkPath = arr.resolve(chunkKey).path;
+        tasks.push(async (workerSlot) => {
+            const worker = workerSlot ?? new Worker(resolvedWorkerUrl, { type: 'module' });
+            // Fetch raw bytes from store on main thread
+            const rawBytes = await arr.store.get(chunkPath, opts.opts);
+            if (!rawBytes) {
+                // Missing chunk — fill value, no worker needed
+                const chunkData = new Ctr(chunkSize);
+                if (fillValue != null) {
+                    // @ts-expect-error: fill_value type is union
+                    chunkData.fill(fillValue);
+                }
+                const chunk = {
+                    data: chunkData,
+                    shape: chunkShape.slice(),
+                    stride: chunkStrides.slice(),
+                };
+                // Copy fill-value chunk into output on main thread
+                setter.set_from_chunk(out, chunk, mapping);
+            }
+            else if (useShared) {
+                // Decode-into-shared: worker decodes AND writes directly into
+                // the SharedArrayBuffer output — no transfer back, no main-thread copy
+                try {
+                    await workerDecodeInto(worker, rawBytes, metaId, codecMeta, buffer, size * bytesPerElement, outStride, mapping, bytesPerElement);
+                }
+                catch (error) {
+                    worker.terminate();
+                    throw error;
+                }
+            }
+            else {
+                // Standard path: worker decodes, transfers back, main thread copies
+                let chunk;
+                try {
+                    chunk = await workerDecode(worker, rawBytes, metaId, codecMeta);
+                }
+                catch (error) {
+                    worker.terminate();
+                    throw error;
+                }
+                setter.set_from_chunk(out, chunk, mapping);
+            }
+            return { worker, result: undefined };
+        });
+    }
+    // Execute all tasks with bounded concurrency via WorkerPool
+    if (tasks.length > 0) {
+        const { promise } = pool.runTasks(tasks);
+        await promise;
+    }
+    // If the final shape is empty (all integer selections), return a scalar
+    if (indexer.shape.length === 0) {
+        const unwrap = 'get' in out.data
+            ? out.data.get(0)
+            : out.data[0];
+        // @ts-expect-error: TS can't narrow conditional type
+        return unwrap;
+    }
+    // @ts-expect-error: TS can't narrow conditional type
+    return out;
+}
+//# sourceMappingURL=get-worker.js.map

package/dist/get-worker.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fideus-labs/fizarrita — Worker-pool-accelerated get/set for zarrita.
+ *
+ * Provides `getWorker` and `setWorker` as drop-in replacements for zarrita's
+ * `get` and `set` that offload codec encode/decode to Web Workers via a
+ * WorkerPool with bounded concurrency.
+ */
+export { getWorker } from './get-worker.js';
+export { setWorker } from './set-worker.js';
+export type { GetWorkerOptions, SetWorkerOptions, CodecChunkMeta, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @fideus-labs/fizarrita — Worker-pool-accelerated get/set for zarrita.
+ *
+ * Provides `getWorker` and `setWorker` as drop-in replacements for zarrita's
+ * `get` and `set` that offload codec encode/decode to Web Workers via a
+ * WorkerPool with bounded concurrency.
+ */
+export { getWorker } from './get-worker.js';
+export { setWorker } from './set-worker.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/internals/codec-pipeline.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Codec pipeline builder — adapted from zarrita.js/src/codecs.ts
+ *
+ * Uses zarrita's publicly exported `registry` to load codecs and
+ * builds encode/decode pipelines from codec metadata.
+ *
+ * Self-contained — only imports `registry` from zarrita's public API.
+ */
+import type { Chunk, CodecMetadata, DataType } from 'zarrita';
+interface ChunkMetadata<D extends DataType> {
+    data_type: D;
+    shape: number[];
+    codecs: CodecMetadata[];
+}
+/**
+ * Create a codec pipeline from chunk metadata.
+ *
+ * Uses zarrita's publicly exported `registry` to resolve codec implementations.
+ * Lazily loads codecs on first encode/decode call, then caches them.
+ *
+ * @param chunk_metadata - The data_type, chunk_shape, and codecs array
+ * @returns An object with encode and decode methods
+ */
+export declare function create_codec_pipeline<D extends DataType>(chunk_metadata: ChunkMetadata<D>): {
+    encode(chunk: Chunk<D>): Promise<Uint8Array>;
+    decode(bytes: Uint8Array): Promise<Chunk<D>>;
+};
+export {};
+//# sourceMappingURL=codec-pipeline.d.ts.map

package/dist/internals/codec-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-pipeline.d.ts","sourceRoot":"","sources":["../../src/internals/codec-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAO7D,UAAU,aAAa,CAAC,CAAC,SAAS,QAAQ;IACxC,SAAS,EAAE,CAAC,CAAA;IACZ,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,aAAa,EAAE,CAAA;CACxB;AAyID;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EACtD,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,GAC/B;IACD,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAC5C,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;CAC7C,CA2BA"}

package/dist/internals/codec-pipeline.js

@@ -0,0 +1,135 @@
+/**
+ * Codec pipeline builder — adapted from zarrita.js/src/codecs.ts
+ *
+ * Uses zarrita's publicly exported `registry` to load codecs and
+ * builds encode/decode pipelines from codec metadata.
+ *
+ * Self-contained — only imports `registry` from zarrita's public API.
+ */
+import { registry } from 'zarrita';
+import { get_ctr, get_strides } from './util.js';
+// ---------------------------------------------------------------------------
+// Fallback BytesCodec
+// ---------------------------------------------------------------------------
+const LITTLE_ENDIAN_OS = (() => {
+    const a = new Uint32Array([0x12345678]);
+    const b = new Uint8Array(a.buffer, a.byteOffset, a.byteLength);
+    return !(b[0] === 0x12);
+})();
+function byteswap_inplace(view, bytes_per_element) {
+    const numFlips = bytes_per_element / 2;
+    const endByteIndex = bytes_per_element - 1;
+    let t = 0;
+    for (let i = 0; i < view.length; i += bytes_per_element) {
+        for (let j = 0; j < numFlips; j += 1) {
+            t = view[i + j];
+            view[i + j] = view[i + endByteIndex - j];
+            view[i + endByteIndex - j] = t;
+        }
+    }
+}
+/**
+ * Fallback BytesCodec for when no explicit array_to_bytes codec is specified.
+ * Handles TypedArray <-> Uint8Array conversion with optional endian swap.
+ */
+function createBytesCodec(endian, meta) {
+    const Ctr = get_ctr(meta.data_type);
+    const shape = meta.shape;
+    const stride = get_strides(shape, 'C');
+    const sample = new Ctr(0);
+    const BYTES_PER_ELEMENT = sample.BYTES_PER_ELEMENT;
+    return {
+        encode(chunk) {
+            const bytes = new Uint8Array(chunk.data.buffer, chunk.data.byteOffset, chunk.data.byteLength);
+            if (LITTLE_ENDIAN_OS && endian === 'big') {
+                byteswap_inplace(bytes, BYTES_PER_ELEMENT);
+            }
+            return bytes;
+        },
+        decode(bytes) {
+            if (LITTLE_ENDIAN_OS && endian === 'big') {
+                byteswap_inplace(bytes, BYTES_PER_ELEMENT);
+            }
+            return {
+                data: new Ctr(bytes.buffer, bytes.byteOffset, bytes.byteLength / BYTES_PER_ELEMENT),
+                shape,
+                stride,
+            };
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Load codecs from registry
+// ---------------------------------------------------------------------------
+async function load_codecs(chunk_meta) {
+    const promises = chunk_meta.codecs.map(async (meta) => {
+        const factory = registry.get(meta.name);
+        if (!factory)
+            throw new Error(`Unknown codec: ${meta.name}`);
+        const CodecClass = await factory();
+        return { CodecClass: CodecClass, meta };
+    });
+    const array_to_array = [];
+    let array_to_bytes;
+    const bytes_to_bytes = [];
+    for await (const { CodecClass, meta } of promises) {
+        const codec = CodecClass.fromConfig(meta.configuration, chunk_meta);
+        switch (codec.kind) {
+            case 'array_to_array':
+                array_to_array.push(codec);
+                break;
+            case 'array_to_bytes':
+                array_to_bytes = codec;
+                break;
+            default:
+                bytes_to_bytes.push(codec);
+        }
+    }
+    if (!array_to_bytes) {
+        // Default BytesCodec for numeric types
+        array_to_bytes = createBytesCodec('little', chunk_meta);
+    }
+    return { array_to_array, array_to_bytes, bytes_to_bytes };
+}
+// ---------------------------------------------------------------------------
+// create_codec_pipeline
+// ---------------------------------------------------------------------------
+/**
+ * Create a codec pipeline from chunk metadata.
+ *
+ * Uses zarrita's publicly exported `registry` to resolve codec implementations.
+ * Lazily loads codecs on first encode/decode call, then caches them.
+ *
+ * @param chunk_metadata - The data_type, chunk_shape, and codecs array
+ * @returns An object with encode and decode methods
+ */
+export function create_codec_pipeline(chunk_metadata) {
+    let codecs;
+    return {
+        async encode(chunk) {
+            if (!codecs)
+                codecs = await load_codecs(chunk_metadata);
+            for (const codec of codecs.array_to_array) {
+                chunk = await codec.encode(chunk);
+            }
+            let bytes = await codecs.array_to_bytes.encode(chunk);
+            for (const codec of codecs.bytes_to_bytes) {
+                bytes = await codec.encode(bytes);
+            }
+            return bytes;
+        },
+        async decode(bytes) {
+            if (!codecs)
+                codecs = await load_codecs(chunk_metadata);
+            for (let i = codecs.bytes_to_bytes.length - 1; i >= 0; i--) {
+                bytes = await codecs.bytes_to_bytes[i].decode(bytes);
+            }
+            let chunk = await codecs.array_to_bytes.decode(bytes);
+            for (let i = codecs.array_to_array.length - 1; i >= 0; i--) {
+                chunk = await codecs.array_to_array[i].decode(chunk);
+            }
+            return chunk;
+        },
+    };
+}
+//# sourceMappingURL=codec-pipeline.js.map