@symbiote-native/blob 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+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/README.md

@@ -0,0 +1,117 @@
+# @symbiote-native/blob
+
+Build, slice and read binary data with the same `Blob` you use in the browser. React Native's own
+`Blob` has gaps, notably in `slice()`; this one follows the W3C File API. One API for every
+[SymbioteNative](../../README.md) adapter (React, Vue, Svelte, Solid and Angular).
+
+It wraps [`expo-blob`](https://github.com/expo/expo/tree/main/packages/expo-blob), a native,
+JSI-backed `Blob`, the same way [`@symbiote-native/print`](../print) wraps its upstream:
+`expo-modules-core` is a direct dependency and the upstream JS is hand-ported into `core/`. See the
+`symbiote-expo-native-module` project skill for the full mechanism.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --blob
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --blob
+```
+
+Either way: installs `@symbiote-native/blob` and wires the native autolinking automatically -
+see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI - installing and wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/blob
+```
+
+`expo-blob` and `expo-modules-core` come along as regular, pinned dependencies - never install
+either yourself, and never add the `expo` meta-package to this project.
+
+### Required one-time step: native autolinking wiring
+
+Same one-time app wiring every `expo-modules-core` package shares - see
+[`@symbiote-native/print`'s README](../print/README.md#required-one-time-step-native-autolinking-wiring)
+for the full table; nothing package-specific here.
+
+### No permissions, no config plugin
+
+- **No runtime permission on either platform.** A `Blob` is pure in-memory/on-device data.
+- **No manifest edit.** `expo-blob`'s own `AndroidManifest.xml` declares nothing.
+- **No config plugin.** Upstream ships none.
+
+</details>
+
+## Shape
+
+```
+src/core/                 the whole API: the Blob class. native-module.ts resolves ExpoBlob
+                          through expo-modules-core's requireNativeModule.
+src/angular/              @symbiote-native/blob/angular
+```
+
+`./react`, `./vue`, `./svelte`, and `./solid` are `exports`-map aliases straight onto `src/core/` -
+`Blob` is a plain class with no framework lifecycle to wrap.
+
+## Use it
+
+```ts
+import { Blob } from '@symbiote-native/blob';
+
+const blob = new Blob(['hello ', 'world'], { type: 'text/plain' });
+blob.size; // 11
+blob.type; // 'text/plain'
+
+const text = await blob.text();
+const bytes = await blob.bytes();
+const buffer = await blob.arrayBuffer();
+const firstFive = blob.slice(0, 5, 'text/plain');
+```
+
+## API
+
+| Export | Notes |
+| ------ | ----- |
+| `Blob` | Constructor: `(blobParts?: IBlobPart[], options?: IBlobPropertyBag)`. `IBlobPart = string \| ArrayBuffer \| ArrayBufferView \| Blob`. Instance: `size`, `type`, `slice(start?, end?, contentType?)`, `bytes()`, `text()`, `arrayBuffer()`, `stream()`, `toString()`. |
+
+## Notes
+
+- **This package's `tsconfig.json` adds `"DOM"` to its `lib` array** (every other package here
+  stays `ES2022`-only) - the ported API's shape genuinely needs `ReadableStream`,
+  `ReadableByteStreamController`, and `BlobPropertyBag`, none of which exist in the plain ES lib.
+  Scoped to this package only; nothing else in the repo is affected.
+- **`.stream()` needs a global `ReadableStream` to actually run.** Hermes/React Native ship no
+  WHATWG Streams implementation - `new ReadableStream(...)` throws `ReferenceError` unless the
+  app installs a polyfill (e.g. `web-streams-polyfill`). Typed and ported for parity; this is an
+  environment prerequisite, not a porting gap.
+
+## Common questions
+
+- **Why not React Native's `Blob`?** It lacks `text()`, `bytes()`, `arrayBuffer()` and `stream()`
+  and has gaps in `slice()`; this one follows the File API.
+- **`ReferenceError: ReadableStream is not defined`.** Hermes has no Streams; install a polyfill
+  (`web-streams-polyfill`) or use `arrayBuffer()` / `bytes()`.
+- **Upload a blob.** Pass it as a `fetch` body or append it to a `FormData`.
+- **Does `.stream()` avoid loading everything?** No: it loads the whole blob into memory first.
+
+Sources: [Expo docs: Blob](https://docs.expo.dev/versions/latest/sdk/blob/),
+[expo/expo#33463](https://github.com/expo/expo/pull/33463).
+
+## Test it
+
+```bash
+pnpm vitest run packages/blob
+```
+
+Upstream ships no test suite of its own (`expo-blob`'s `src/` has no `__tests__`), so nothing to
+port - every test here is net-new coverage of the ported logic (constructor validation, part
+concatenation, `slice`'s prototype-fixup, `arrayBuffer`'s fresh-buffer guarantee, `stream`'s
+default read path).

package/build/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build/angular/index.js

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core/index.js';

package/build/core/blob.d.ts

@@ -0,0 +1,10 @@
+import { expoBlob } from './native-module';
+import type { IBlobPart, IBlobPropertyBag } from './types';
+export declare class Blob extends expoBlob.Blob {
+    constructor(blobParts?: IBlobPart[] | Iterable<IBlobPart>, options?: IBlobPropertyBag);
+    slice(start?: number, end?: number, contentType?: string): Blob;
+    stream(): ReadableStream;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    toString(): string;
+    static get length(): number;
+}

package/build/core/blob.js

@@ -0,0 +1,100 @@
+import { expoBlob } from './native-module.js';
+import { DEFAULT_CHUNK_SIZE, isTypedArray, normalizedContentType, preprocessOptions, } from './utils.js';
+function inputMapping(blobPart) {
+    if (blobPart instanceof ArrayBuffer) {
+        return new Uint8Array(blobPart);
+    }
+    if (blobPart instanceof Blob || isTypedArray(blobPart)) {
+        return blobPart;
+    }
+    return String(blobPart);
+}
+function assertArrayBuffer(buffer) {
+    if (!(buffer instanceof ArrayBuffer)) {
+        throw new TypeError('Blob data must be backed by an ArrayBuffer');
+    }
+}
+function isBlob(value) {
+    return value instanceof Blob;
+}
+export class Blob extends expoBlob.Blob {
+    constructor(blobParts, options) {
+        if (!new.target) {
+            throw new TypeError("Blob constructor requires 'new' operator");
+        }
+        if (blobParts === undefined) {
+            super([], preprocessOptions(options));
+        }
+        else if (blobParts === null || typeof blobParts !== 'object') {
+            throw new TypeError('Blob constructor requires blobParts to be a non-null object or undefined');
+        }
+        else {
+            const processedBlobParts = [];
+            for (const blobPart of blobParts) {
+                processedBlobParts.push(inputMapping(blobPart));
+            }
+            super(processedBlobParts, preprocessOptions(options));
+        }
+    }
+    slice(start, end, contentType) {
+        const normalizedType = normalizedContentType(contentType);
+        const slicedBlob = super.slice(start, end, normalizedType);
+        Object.setPrototypeOf(slicedBlob, Blob.prototype);
+        if (!isBlob(slicedBlob)) {
+            throw new Error('unreachable — just reassigned the prototype to Blob');
+        }
+        return slicedBlob;
+    }
+    stream() {
+        let getBlobBytes = this.bytes.bind(this);
+        let offset = 0;
+        let cachedBytes = null;
+        return new ReadableStream({
+            type: 'bytes',
+            async pull(controller) {
+                if (!cachedBytes) {
+                    if (!getBlobBytes) {
+                        throw new Error('Cannot read from a closed stream');
+                    }
+                    cachedBytes = await getBlobBytes();
+                    getBlobBytes = null;
+                }
+                if (offset >= cachedBytes.length) {
+                    controller.close();
+                    cachedBytes = null;
+                    return;
+                }
+                if (controller.byobRequest?.view) {
+                    const view = new Uint8Array(controller.byobRequest.view.buffer, controller.byobRequest.view.byteOffset, controller.byobRequest.view.byteLength);
+                    const end = Math.min(offset + view.byteLength, cachedBytes.length);
+                    const chunk = cachedBytes.subarray(offset, end);
+                    view.set(chunk, 0);
+                    controller.byobRequest.respond(chunk.length);
+                    offset = end;
+                    if (offset >= cachedBytes.length) {
+                        controller.close();
+                        cachedBytes = null;
+                    }
+                    return;
+                }
+                const end = Math.min(offset + DEFAULT_CHUNK_SIZE, cachedBytes.length);
+                const chunk = cachedBytes.subarray(offset, end);
+                assertArrayBuffer(chunk.buffer);
+                controller.enqueue(new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength));
+                offset = end;
+            },
+        });
+    }
+    async arrayBuffer() {
+        const bytes = await super.bytes();
+        assertArrayBuffer(bytes.buffer);
+        // The Blob spec requires a NEW ArrayBuffer even when its bounds match the TypedArray's.
+        return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    }
+    toString() {
+        return '[object Blob]';
+    }
+    static get length() {
+        return 0;
+    }
+}

package/build/core/index.d.ts

@@ -0,0 +1,2 @@
+export { Blob } from './blob';
+export type { IBlobPart, IBlobPropertyBag } from './types';

package/build/core/index.js

@@ -0,0 +1 @@
+export { Blob } from './blob.js';

package/build/core/native-module.d.ts

@@ -0,0 +1,14 @@
+import { SharedObject } from 'expo-modules-core';
+import type { IBlobPart, IBlobPropertyBag } from './types';
+export declare class NativeBlob extends SharedObject {
+    readonly size: number;
+    readonly type: string;
+    constructor(blobParts?: IBlobPart[], options?: IBlobPropertyBag);
+    slice(start?: number, end?: number, contentType?: string): NativeBlob;
+    bytes(): Promise<Uint8Array>;
+    text(): Promise<string>;
+}
+export type INativeBlobModule = {
+    Blob: typeof NativeBlob;
+};
+export declare const expoBlob: INativeBlobModule;

package/build/core/native-module.js

@@ -0,0 +1,3 @@
+import { requireNativeModule, SharedObject } from 'expo-modules-core';
+const EXPO_BLOB_MODULE_NAME = 'ExpoBlob';
+export const expoBlob = requireNativeModule(EXPO_BLOB_MODULE_NAME);

package/build/core/types.d.ts

@@ -0,0 +1,6 @@
+import type { Blob } from './blob';
+export type IBlobPropertyBag = {
+    endings?: 'transparent' | 'native';
+    type?: string;
+};
+export type IBlobPart = string | ArrayBuffer | ArrayBufferView | Blob;

package/build/core/types.js

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

package/build/core/utils.d.ts

@@ -0,0 +1,7 @@
+import type { IBlobPropertyBag } from './types';
+/** ASCII-printable-only, lowercased; anything else normalizes to `''`. */
+export declare function normalizedContentType(type?: string): string;
+export declare function isTypedArray(value: unknown): value is ArrayBufferView;
+export declare function preprocessOptions(options?: IBlobPropertyBag): IBlobPropertyBag | undefined;
+/** Not spec-mandated — a widely-adopted default (matches Node's own stream chunk size). */
+export declare const DEFAULT_CHUNK_SIZE = 65536;

package/build/core/utils.js

@@ -0,0 +1,43 @@
+/** ASCII-printable-only, lowercased; anything else normalizes to `''`. */
+export function normalizedContentType(type) {
+    const str = `${type}`;
+    const asciiPrintable = /^[\x20-\x7E]+$/;
+    if (type === undefined || !asciiPrintable.test(str))
+        return '';
+    return str.toLowerCase();
+}
+export function isTypedArray(value) {
+    return (value instanceof Int8Array ||
+        value instanceof Int16Array ||
+        value instanceof Int32Array ||
+        value instanceof BigInt64Array ||
+        value instanceof Uint8Array ||
+        value instanceof Uint16Array ||
+        value instanceof Uint32Array ||
+        value instanceof BigUint64Array ||
+        value instanceof Float32Array ||
+        value instanceof Float64Array);
+}
+export function preprocessOptions(options) {
+    if (!options)
+        return options;
+    if (!(options instanceof Object)) {
+        throw new TypeError(`The 'options' argument must be a dictionary. Received type ${typeof options}`);
+    }
+    let endings = options.endings;
+    let type = options.type;
+    if (endings && typeof endings === 'object') {
+        endings = String(endings);
+    }
+    if (type && typeof type === 'object') {
+        type = String(type);
+    }
+    if (endings !== undefined &&
+        endings !== 'native' &&
+        endings !== 'transparent') {
+        throw new TypeError(`Provided '${endings}' endings value is not a valid enum value of EndingType, try 'native' or 'transparent'`);
+    }
+    return { endings, type: normalizedContentType(type) };
+}
+/** Not spec-mandated — a widely-adopted default (matches Node's own stream chunk size). */
+export const DEFAULT_CHUNK_SIZE = 65_536;

package/build-ngc/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build-ngc/angular/index.js

@@ -0,0 +1,3 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core';
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,cAAc,SAAS,CAAC"}

package/build-ngc/core/blob.d.ts

@@ -0,0 +1,10 @@
+import { expoBlob } from './native-module';
+import type { IBlobPart, IBlobPropertyBag } from './types';
+export declare class Blob extends expoBlob.Blob {
+    constructor(blobParts?: IBlobPart[] | Iterable<IBlobPart>, options?: IBlobPropertyBag);
+    slice(start?: number, end?: number, contentType?: string): Blob;
+    stream(): ReadableStream;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    toString(): string;
+    static get length(): number;
+}

package/build-ngc/core/blob.js

@@ -0,0 +1,101 @@
+import { expoBlob } from './native-module';
+import { DEFAULT_CHUNK_SIZE, isTypedArray, normalizedContentType, preprocessOptions, } from './utils';
+function inputMapping(blobPart) {
+    if (blobPart instanceof ArrayBuffer) {
+        return new Uint8Array(blobPart);
+    }
+    if (blobPart instanceof Blob || isTypedArray(blobPart)) {
+        return blobPart;
+    }
+    return String(blobPart);
+}
+function assertArrayBuffer(buffer) {
+    if (!(buffer instanceof ArrayBuffer)) {
+        throw new TypeError('Blob data must be backed by an ArrayBuffer');
+    }
+}
+function isBlob(value) {
+    return value instanceof Blob;
+}
+export class Blob extends expoBlob.Blob {
+    constructor(blobParts, options) {
+        if (!new.target) {
+            throw new TypeError("Blob constructor requires 'new' operator");
+        }
+        if (blobParts === undefined) {
+            super([], preprocessOptions(options));
+        }
+        else if (blobParts === null || typeof blobParts !== 'object') {
+            throw new TypeError('Blob constructor requires blobParts to be a non-null object or undefined');
+        }
+        else {
+            const processedBlobParts = [];
+            for (const blobPart of blobParts) {
+                processedBlobParts.push(inputMapping(blobPart));
+            }
+            super(processedBlobParts, preprocessOptions(options));
+        }
+    }
+    slice(start, end, contentType) {
+        const normalizedType = normalizedContentType(contentType);
+        const slicedBlob = super.slice(start, end, normalizedType);
+        Object.setPrototypeOf(slicedBlob, Blob.prototype);
+        if (!isBlob(slicedBlob)) {
+            throw new Error('unreachable — just reassigned the prototype to Blob');
+        }
+        return slicedBlob;
+    }
+    stream() {
+        let getBlobBytes = this.bytes.bind(this);
+        let offset = 0;
+        let cachedBytes = null;
+        return new ReadableStream({
+            type: 'bytes',
+            async pull(controller) {
+                if (!cachedBytes) {
+                    if (!getBlobBytes) {
+                        throw new Error('Cannot read from a closed stream');
+                    }
+                    cachedBytes = await getBlobBytes();
+                    getBlobBytes = null;
+                }
+                if (offset >= cachedBytes.length) {
+                    controller.close();
+                    cachedBytes = null;
+                    return;
+                }
+                if (controller.byobRequest?.view) {
+                    const view = new Uint8Array(controller.byobRequest.view.buffer, controller.byobRequest.view.byteOffset, controller.byobRequest.view.byteLength);
+                    const end = Math.min(offset + view.byteLength, cachedBytes.length);
+                    const chunk = cachedBytes.subarray(offset, end);
+                    view.set(chunk, 0);
+                    controller.byobRequest.respond(chunk.length);
+                    offset = end;
+                    if (offset >= cachedBytes.length) {
+                        controller.close();
+                        cachedBytes = null;
+                    }
+                    return;
+                }
+                const end = Math.min(offset + DEFAULT_CHUNK_SIZE, cachedBytes.length);
+                const chunk = cachedBytes.subarray(offset, end);
+                assertArrayBuffer(chunk.buffer);
+                controller.enqueue(new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength));
+                offset = end;
+            },
+        });
+    }
+    async arrayBuffer() {
+        const bytes = await super.bytes();
+        assertArrayBuffer(bytes.buffer);
+        // The Blob spec requires a NEW ArrayBuffer even when its bounds match the TypedArray's.
+        return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    }
+    toString() {
+        return '[object Blob]';
+    }
+    static get length() {
+        return 0;
+    }
+}
+//# sourceMappingURL=blob.js.map

package/build-ngc/core/blob.js.map

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

package/build-ngc/core/index.d.ts

@@ -0,0 +1,2 @@
+export { Blob } from './blob';
+export type { IBlobPart, IBlobPropertyBag } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,2 @@
+export { Blob } from './blob';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,14 @@
+import { SharedObject } from 'expo-modules-core';
+import type { IBlobPart, IBlobPropertyBag } from './types';
+export declare class NativeBlob extends SharedObject {
+    readonly size: number;
+    readonly type: string;
+    constructor(blobParts?: IBlobPart[], options?: IBlobPropertyBag);
+    slice(start?: number, end?: number, contentType?: string): NativeBlob;
+    bytes(): Promise<Uint8Array>;
+    text(): Promise<string>;
+}
+export type INativeBlobModule = {
+    Blob: typeof NativeBlob;
+};
+export declare const expoBlob: INativeBlobModule;

package/build-ngc/core/native-module.js

@@ -0,0 +1,4 @@
+import { requireNativeModule, SharedObject } from 'expo-modules-core';
+const EXPO_BLOB_MODULE_NAME = 'ExpoBlob';
+export const expoBlob = requireNativeModule(EXPO_BLOB_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

package/build-ngc/core/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtE,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAezC,MAAM,CAAC,MAAM,QAAQ,GAAG,mBAAmB,CACzC,qBAAqB,CACtB,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,6 @@
+import type { Blob } from './blob';
+export type IBlobPropertyBag = {
+    endings?: 'transparent' | 'native';
+    type?: string;
+};
+export type IBlobPart = string | ArrayBuffer | ArrayBufferView | Blob;

package/build-ngc/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/build-ngc/core/utils.d.ts

@@ -0,0 +1,7 @@
+import type { IBlobPropertyBag } from './types';
+/** ASCII-printable-only, lowercased; anything else normalizes to `''`. */
+export declare function normalizedContentType(type?: string): string;
+export declare function isTypedArray(value: unknown): value is ArrayBufferView;
+export declare function preprocessOptions(options?: IBlobPropertyBag): IBlobPropertyBag | undefined;
+/** Not spec-mandated — a widely-adopted default (matches Node's own stream chunk size). */
+export declare const DEFAULT_CHUNK_SIZE = 65536;

package/build-ngc/core/utils.js

@@ -0,0 +1,44 @@
+/** ASCII-printable-only, lowercased; anything else normalizes to `''`. */
+export function normalizedContentType(type) {
+    const str = `${type}`;
+    const asciiPrintable = /^[\x20-\x7E]+$/;
+    if (type === undefined || !asciiPrintable.test(str))
+        return '';
+    return str.toLowerCase();
+}
+export function isTypedArray(value) {
+    return (value instanceof Int8Array ||
+        value instanceof Int16Array ||
+        value instanceof Int32Array ||
+        value instanceof BigInt64Array ||
+        value instanceof Uint8Array ||
+        value instanceof Uint16Array ||
+        value instanceof Uint32Array ||
+        value instanceof BigUint64Array ||
+        value instanceof Float32Array ||
+        value instanceof Float64Array);
+}
+export function preprocessOptions(options) {
+    if (!options)
+        return options;
+    if (!(options instanceof Object)) {
+        throw new TypeError(`The 'options' argument must be a dictionary. Received type ${typeof options}`);
+    }
+    let endings = options.endings;
+    let type = options.type;
+    if (endings && typeof endings === 'object') {
+        endings = String(endings);
+    }
+    if (type && typeof type === 'object') {
+        type = String(type);
+    }
+    if (endings !== undefined &&
+        endings !== 'native' &&
+        endings !== 'transparent') {
+        throw new TypeError(`Provided '${endings}' endings value is not a valid enum value of EndingType, try 'native' or 'transparent'`);
+    }
+    return { endings, type: normalizedContentType(type) };
+}
+/** Not spec-mandated — a widely-adopted default (matches Node's own stream chunk size). */
+export const DEFAULT_CHUNK_SIZE = 65_536;
+//# sourceMappingURL=utils.js.map

package/build-ngc/core/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,MAAM,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;IACtB,MAAM,cAAc,GAAG,gBAAgB,CAAC;IACxC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/D,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,KAAK,YAAY,SAAS;QAC1B,KAAK,YAAY,UAAU;QAC3B,KAAK,YAAY,UAAU;QAC3B,KAAK,YAAY,aAAa;QAC9B,KAAK,YAAY,UAAU;QAC3B,KAAK,YAAY,WAAW;QAC5B,KAAK,YAAY,WAAW;QAC5B,KAAK,YAAY,cAAc;QAC/B,KAAK,YAAY,YAAY;QAC7B,KAAK,YAAY,YAAY,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAA0B;IAE1B,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAC7B,IAAI,CAAC,CAAC,OAAO,YAAY,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CACjB,8DAA8D,OAAO,OAAO,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAuB,OAAO,CAAC,OAAO,CAAC;IAClD,IAAI,IAAI,GAAuB,OAAO,CAAC,IAAI,CAAC;IAC5C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,IACE,OAAO,KAAK,SAAS;QACrB,OAAO,KAAK,QAAQ;QACpB,OAAO,KAAK,aAAa,EACzB,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,aAAa,OAAO,wFAAwF,CAC7G,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC"}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-blob",
+    "modules": [
+      {
+        "importPath": "expo.modules.blob.BlobModule",
+        "className": "BlobModule",
+        "nativeName": "ExpoBlob"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,149 @@
+{
+  "name": "@symbiote-native/blob",
+  "version": "0.1.0",
+  "description": "expo-blob wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. A native, JSI-backed W3C Blob implementation.",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-blob",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "blob"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/blob"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/blob#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./react": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./svelte": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./solid": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-blob": "57.0.2",
+    "expo-modules-core": "57.0.20"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "^3.1.3",
+    "@symbiote-native/engine": "^1.4.0",
+    "@symbiote-native/solid": "^3.0.5",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/svelte": "^3.0.5",
+    "@symbiote-native/vue": "^3.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "3.1.3",
+    "@symbiote-native/engine": "1.4.0",
+    "@symbiote-native/react": "3.1.0",
+    "@symbiote-native/svelte": "3.0.5",
+    "@symbiote-native/solid": "3.0.5",
+    "@symbiote-native/test-utils": "0.4.5",
+    "@symbiote-native/vue": "3.1.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core';

package/src/core/blob.ts

@@ -0,0 +1,135 @@
+import { expoBlob } from './native-module';
+import {
+  DEFAULT_CHUNK_SIZE,
+  isTypedArray,
+  normalizedContentType,
+  preprocessOptions,
+} from './utils';
+import type { IBlobPart, IBlobPropertyBag } from './types';
+
+function inputMapping(blobPart: IBlobPart): IBlobPart {
+  if (blobPart instanceof ArrayBuffer) {
+    return new Uint8Array(blobPart);
+  }
+  if (blobPart instanceof Blob || isTypedArray(blobPart)) {
+    return blobPart;
+  }
+  return String(blobPart);
+}
+
+function assertArrayBuffer(
+  buffer: ArrayBufferLike,
+): asserts buffer is ArrayBuffer {
+  if (!(buffer instanceof ArrayBuffer)) {
+    throw new TypeError('Blob data must be backed by an ArrayBuffer');
+  }
+}
+
+function isBlob(value: unknown): value is Blob {
+  return value instanceof Blob;
+}
+
+export class Blob extends expoBlob.Blob {
+  constructor(
+    blobParts?: IBlobPart[] | Iterable<IBlobPart>,
+    options?: IBlobPropertyBag,
+  ) {
+    if (!new.target) {
+      throw new TypeError("Blob constructor requires 'new' operator");
+    }
+
+    if (blobParts === undefined) {
+      super([], preprocessOptions(options));
+    } else if (blobParts === null || typeof blobParts !== 'object') {
+      throw new TypeError(
+        'Blob constructor requires blobParts to be a non-null object or undefined',
+      );
+    } else {
+      const processedBlobParts: IBlobPart[] = [];
+      for (const blobPart of blobParts) {
+        processedBlobParts.push(inputMapping(blobPart));
+      }
+      super(processedBlobParts, preprocessOptions(options));
+    }
+  }
+
+  override slice(start?: number, end?: number, contentType?: string): Blob {
+    const normalizedType = normalizedContentType(contentType);
+    const slicedBlob = super.slice(start, end, normalizedType);
+    Object.setPrototypeOf(slicedBlob, Blob.prototype);
+    if (!isBlob(slicedBlob)) {
+      throw new Error('unreachable — just reassigned the prototype to Blob');
+    }
+    return slicedBlob;
+  }
+
+  stream(): ReadableStream {
+    let getBlobBytes: (() => Promise<Uint8Array>) | null =
+      this.bytes.bind(this);
+    let offset = 0;
+    let cachedBytes: Uint8Array | null = null;
+
+    return new ReadableStream({
+      type: 'bytes',
+      async pull(controller) {
+        if (!cachedBytes) {
+          if (!getBlobBytes) {
+            throw new Error('Cannot read from a closed stream');
+          }
+          cachedBytes = await getBlobBytes();
+          getBlobBytes = null;
+        }
+
+        if (offset >= cachedBytes.length) {
+          controller.close();
+          cachedBytes = null;
+          return;
+        }
+
+        if (controller.byobRequest?.view) {
+          const view = new Uint8Array(
+            controller.byobRequest.view.buffer,
+            controller.byobRequest.view.byteOffset,
+            controller.byobRequest.view.byteLength,
+          );
+          const end = Math.min(offset + view.byteLength, cachedBytes.length);
+          const chunk = cachedBytes.subarray(offset, end);
+          view.set(chunk, 0);
+          controller.byobRequest.respond(chunk.length);
+          offset = end;
+          if (offset >= cachedBytes.length) {
+            controller.close();
+            cachedBytes = null;
+          }
+          return;
+        }
+
+        const end = Math.min(offset + DEFAULT_CHUNK_SIZE, cachedBytes.length);
+        const chunk = cachedBytes.subarray(offset, end);
+        assertArrayBuffer(chunk.buffer);
+        controller.enqueue(
+          new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength),
+        );
+        offset = end;
+      },
+    });
+  }
+
+  async arrayBuffer(): Promise<ArrayBuffer> {
+    const bytes = await super.bytes();
+    assertArrayBuffer(bytes.buffer);
+    // The Blob spec requires a NEW ArrayBuffer even when its bounds match the TypedArray's.
+    return bytes.buffer.slice(
+      bytes.byteOffset,
+      bytes.byteOffset + bytes.byteLength,
+    );
+  }
+
+  override toString(): string {
+    return '[object Blob]';
+  }
+
+  static override get length(): number {
+    return 0;
+  }
+}

package/src/core/index.ts

@@ -0,0 +1,2 @@
+export { Blob } from './blob';
+export type { IBlobPart, IBlobPropertyBag } from './types';

package/src/core/native-module.ts

@@ -0,0 +1,21 @@
+import { requireNativeModule, SharedObject } from 'expo-modules-core';
+import type { IBlobPart, IBlobPropertyBag } from './types';
+
+const EXPO_BLOB_MODULE_NAME = 'ExpoBlob';
+
+export declare class NativeBlob extends SharedObject {
+  readonly size: number;
+  readonly type: string;
+  constructor(blobParts?: IBlobPart[], options?: IBlobPropertyBag);
+  slice(start?: number, end?: number, contentType?: string): NativeBlob;
+  bytes(): Promise<Uint8Array>;
+  text(): Promise<string>;
+}
+
+export type INativeBlobModule = {
+  Blob: typeof NativeBlob;
+};
+
+export const expoBlob = requireNativeModule<INativeBlobModule>(
+  EXPO_BLOB_MODULE_NAME,
+);

package/src/core/types.ts

@@ -0,0 +1,8 @@
+import type { Blob } from './blob';
+
+export type IBlobPropertyBag = {
+  endings?: 'transparent' | 'native';
+  type?: string;
+};
+
+export type IBlobPart = string | ArrayBuffer | ArrayBufferView | Blob;

package/src/core/utils.ts

@@ -0,0 +1,58 @@
+import type { IBlobPropertyBag } from './types';
+
+/** ASCII-printable-only, lowercased; anything else normalizes to `''`. */
+export function normalizedContentType(type?: string): string {
+  const str = `${type}`;
+  const asciiPrintable = /^[\x20-\x7E]+$/;
+  if (type === undefined || !asciiPrintable.test(str)) return '';
+  return str.toLowerCase();
+}
+
+export function isTypedArray(value: unknown): value is ArrayBufferView {
+  return (
+    value instanceof Int8Array ||
+    value instanceof Int16Array ||
+    value instanceof Int32Array ||
+    value instanceof BigInt64Array ||
+    value instanceof Uint8Array ||
+    value instanceof Uint16Array ||
+    value instanceof Uint32Array ||
+    value instanceof BigUint64Array ||
+    value instanceof Float32Array ||
+    value instanceof Float64Array
+  );
+}
+
+export function preprocessOptions(
+  options?: IBlobPropertyBag,
+): IBlobPropertyBag | undefined {
+  if (!options) return options;
+  if (!(options instanceof Object)) {
+    throw new TypeError(
+      `The 'options' argument must be a dictionary. Received type ${typeof options}`,
+    );
+  }
+
+  let endings: string | undefined = options.endings;
+  let type: string | undefined = options.type;
+  if (endings && typeof endings === 'object') {
+    endings = String(endings);
+  }
+  if (type && typeof type === 'object') {
+    type = String(type);
+  }
+  if (
+    endings !== undefined &&
+    endings !== 'native' &&
+    endings !== 'transparent'
+  ) {
+    throw new TypeError(
+      `Provided '${endings}' endings value is not a valid enum value of EndingType, try 'native' or 'transparent'`,
+    );
+  }
+
+  return { endings, type: normalizedContentType(type) };
+}
+
+/** Not spec-mandated — a widely-adopted default (matches Node's own stream chunk size). */
+export const DEFAULT_CHUNK_SIZE = 65_536;