@absolutejs/sync-expo 0.0.1

package/LICENSE

@@ -0,0 +1,88 @@
+# Business Source License 1.1
+
+**Licensor:** Alex Kahn
+
+**Licensed Work:** @absolutejs/sync-expo (https://github.com/absolutejs/sync-expo)
+
+**Change Date:** May 29, 2030
+
+**Change License:** Apache License, Version 2.0
+
+---
+
+## Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, permitting limited production use.
+
+### Additional Use Grant
+
+You may use the Licensed Work in production, provided your use does not include
+any of the following:
+
+1. **Offering a Competing Service.** You may not offer the Licensed Work, or
+   any derivative or substantial portion of it, to third parties as a hosted or
+   managed service that competes with a hosted reactive sync engine, realtime database, or live-collaboration backend service (including, but not limited to, services like Convex, Liveblocks, Zero, Replicache, ElectricSQL, RxDB Cloud, or PowerSync). This includes any
+   product whose primary value to its users is the functionality the Licensed
+   Work provides.
+
+2. **Resale or Redistribution as a Standalone Product.** You may not sell,
+   license, or distribute the Licensed Work, or any derivative or fork of it,
+   as a standalone commercial product.
+
+3. **Removal of Attribution.** Any derivative work, fork, or redistribution of
+   the Licensed Work must prominently credit AbsoluteJS and include a link to
+   the original project repository (https://github.com/absolutejs/sync-expo).
+
+For clarity, the following uses are expressly permitted:
+
+- Using the Licensed Work to build and operate your own applications, websites,
+  internal tools, or SaaS products (whether commercial or non-commercial), so
+  long as the Licensed Work itself is not the primary product you are selling.
+- Using the Licensed Work as a dependency in commercial software you build and
+  sell, as long as the software is not itself a competing managed service of
+  the kind described in clause 1.
+- Providing consulting, development, or professional services to clients using
+  the Licensed Work.
+- Forking and modifying the Licensed Work for your own internal use, provided
+  attribution is maintained.
+
+### Change Date and Change License
+
+On the Change Date specified above, or on such other date as the Licensor may
+specify by written notice, the Licensed Work will be made available under the
+Change License (Apache License, Version 2.0). Until the Change Date, the terms
+of this Business Source License 1.1 apply.
+
+### Trademark
+
+This license does not grant you any rights to use the "AbsoluteJS" or
+"@absolutejs" name, logo, or any related trademarks. Forks and derivative works
+must not be named or branded in a manner that suggests endorsement by or
+affiliation with AbsoluteJS or the Licensor.
+
+### Notices
+
+You must not remove or obscure any licensing, copyright, or other notices
+included in the Licensed Work.
+
+### No Warranty
+
+THE LICENSED WORK IS PROVIDED "AS IS". THE LICENSOR HEREBY DISCLAIMS ALL
+WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE LICENSOR 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 LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE
+LICENSED WORK.
+
+---
+
+## Contact
+
+For commercial licensing inquiries or additional permissions, contact:
+
+- **Alex Kahn**
+- alexkahndev@gmail.com
+- alexkahndev.github.io

package/README.md

@@ -0,0 +1,19 @@
+# @absolutejs/sync-expo
+
+Expo-native persistence and lifecycle integration for
+[`@absolutejs/sync`](https://github.com/absolutejs/sync).
+
+- Expo SQLite durable cache, outbox, receipts, cursors, and dead letters.
+- Principal-partitioned storage with the same migrations and policy contract as
+  web and Capacitor.
+- AES-256-GCM record protection with a device-only key held by Expo SecureStore.
+- AppState and Expo Network wake-up handling.
+- Bounded Expo Background Task integration.
+
+AbsoluteJS provisions this package automatically for Expo applications that use
+`@absolutejs/sync`. Direct package consumers can use the exported adapter
+functions without AbsoluteJS.
+
+Background execution is an acceleration only. Foreground startup, resume, and
+connectivity recovery remain authoritative because Android and iOS decide when
+deferrable work is allowed to run.

package/dist/bridge.d.ts

@@ -0,0 +1,43 @@
+import type { SyncLocalStore } from "@absolutejs/sync/client";
+export type ExpoSyncBridgeHostOptions = {
+    store: SyncLocalStore;
+    namespace: string;
+    /** Maximum time one WebView may hold an atomic transaction. Defaults to 8s. */
+    transactionTimeoutMs?: number;
+    createId?: () => string;
+};
+export type ExpoSyncSocketBridgeEvent = {
+    socketId: string;
+    type: "close" | "error" | "message-chunk" | "open";
+    code?: number;
+    data?: string;
+    index?: number;
+    messageId?: string;
+    reason?: string;
+    total?: number;
+};
+export type ExpoSyncSocketBridgeHostOptions = {
+    allowedOrigin: string;
+    socketTicket: (audience?: string) => Promise<string>;
+    emit(event: ExpoSyncSocketBridgeEvent): void;
+    webSocketImpl?: typeof WebSocket;
+    maxSockets?: number;
+    /** Maximum encoded Sync frame size. Defaults to 4 MiB. */
+    maxFrameBytes?: number;
+};
+/**
+ * Native owner for WebView local-store transactions. It exposes only Sync's
+ * typed persistence contract and never accepts a namespace from page code.
+ */
+export declare const createExpoSyncBridgeHost: ({ store, namespace, transactionTimeoutMs, createId, }: ExpoSyncBridgeHostOptions) => {
+    close: () => Promise<void>;
+    request: (method: string, rawParams: unknown) => Promise<unknown>;
+};
+/**
+ * Owns authenticated sockets in native JavaScript. Only ordinary string Sync
+ * frames cross the WebView bridge; the single-use ticket is consumed here.
+ */
+export declare const createExpoSyncSocketBridgeHost: ({ allowedOrigin, socketTicket, emit, webSocketImpl, maxSockets, maxFrameBytes, }: ExpoSyncSocketBridgeHostOptions) => {
+    close: () => void;
+    request: (method: string, rawParams: unknown) => Promise<unknown>;
+};

package/dist/client.d.ts

@@ -0,0 +1,20 @@
+import type { SyncLocalStore, SyncLocalStoreSchemaInput } from "@absolutejs/sync/client";
+export type AbsoluteExpoSyncBridgeProvider = {
+    on(event: "sync.socket", listener: (payload: Record<string, unknown>) => void): () => void;
+    request(method: string, params: Record<string, unknown>): Promise<unknown>;
+};
+export type ExpoSyncBridgeLocalStoreOptions = {
+    provider: AbsoluteExpoSyncBridgeProvider;
+    storageSchema?: SyncLocalStoreSchemaInput;
+};
+/**
+ * SyncLocalStore proxy whose atomic transaction is owned by native SQLite.
+ * The namespace argument never crosses the bridge; the native Auth principal
+ * selected when the host was created is authoritative.
+ */
+export declare const createExpoSyncBridgeLocalStore: ({ provider, storageSchema, }: ExpoSyncBridgeLocalStoreOptions) => SyncLocalStore;
+/**
+ * Browser-compatible string WebSocket facade backed by the native socket host.
+ * Default JSON Sync frames are supported; binary serializers fail explicitly.
+ */
+export declare const createExpoSyncBridgeWebSocket: (provider: AbsoluteExpoSyncBridgeProvider) => typeof WebSocket;

package/dist/client.js

@@ -0,0 +1,255 @@
+// src/client.ts
+import {
+  resolveSyncLocalDataPolicy,
+  resolveSyncLocalMutationPolicy
+} from "@absolutejs/sync/client";
+var record = (value, label) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    throw new TypeError(`Expo Sync bridge returned invalid ${label}.`);
+  return value;
+};
+var transactionId = (value) => {
+  const id = Reflect.get(record(value, "transaction"), "transactionId");
+  if (typeof id !== "string" || id.length === 0)
+    throw new TypeError("Expo Sync bridge returned an invalid transaction id.");
+  return id;
+};
+var nullable = (value) => value === null || value === undefined ? undefined : value;
+var createExpoSyncBridgeLocalStore = ({
+  provider,
+  storageSchema = { version: 1 }
+}) => {
+  const policy = resolveSyncLocalDataPolicy(storageSchema);
+  const transaction = async (_namespace, mode, run) => {
+    const id = transactionId(await provider.request("sync.store.begin", { mode }));
+    const request = (method, params = {}) => provider.request(method, { ...params, transactionId: id });
+    const remote = {
+      deleteCollection: async (key) => {
+        await request("sync.tx.deleteCollection", { key });
+      },
+      deleteMutation: async (operationId) => {
+        await request("sync.tx.deleteMutation", { operationId });
+      },
+      getCollection: async (key) => nullable(await request("sync.tx.getCollection", { key })),
+      getInstallationId: async () => nullable(await request("sync.tx.getInstallationId")),
+      getMutation: async (operationId) => nullable(await request("sync.tx.getMutation", { operationId })),
+      listCollections: async () => await request("sync.tx.listCollections"),
+      listMutations: async () => await request("sync.tx.listMutations"),
+      putCollection: async (key, collectionRecord) => {
+        await request("sync.tx.putCollection", {
+          key,
+          record: collectionRecord
+        });
+      },
+      putMutation: async (mutationRecord) => {
+        await request("sync.tx.putMutation", { record: mutationRecord });
+      },
+      resolveMutationPolicy: (name) => resolveSyncLocalMutationPolicy(policy, name),
+      setInstallationId: async (installationId) => {
+        await request("sync.tx.setInstallationId", { installationId });
+      }
+    };
+    try {
+      const result = await run(remote);
+      await provider.request("sync.store.end", {
+        commit: true,
+        transactionId: id
+      });
+      return result;
+    } catch (error) {
+      await provider.request("sync.store.end", {
+        commit: false,
+        transactionId: id
+      }).catch(() => {
+        return;
+      });
+      throw error;
+    }
+  };
+  return {
+    deleteNamespace: async () => {
+      await provider.request("sync.store.deleteNamespace", {});
+    },
+    getSchemaStatus: async () => nullable(await provider.request("sync.store.schema", {})) ?? (() => {
+      throw new Error("Expo Sync native schema status is unavailable.");
+    })(),
+    transaction
+  };
+};
+var SOCKET_CHUNK_BYTES = 24 * 1024;
+var MAX_SOCKET_FRAME_BYTES = 4 * 1024 * 1024;
+var encodeBase64 = (value) => {
+  let binary = "";
+  for (const byte of value)
+    binary += String.fromCharCode(byte);
+  return btoa(binary);
+};
+var decodeBase64 = (value) => Uint8Array.from(atob(value), (character) => character.charCodeAt(0));
+var createExpoSyncBridgeWebSocket = (provider) => {
+
+  class ExpoBridgeWebSocket extends EventTarget {
+    static CLOSED = 3;
+    static CLOSING = 2;
+    static CONNECTING = 0;
+    static OPEN = 1;
+    CLOSED = 3;
+    CLOSING = 2;
+    CONNECTING = 0;
+    OPEN = 1;
+    binaryType = "blob";
+    bufferedAmount = 0;
+    extensions = "";
+    onclose = null;
+    onerror = null;
+    onmessage = null;
+    onopen = null;
+    protocol = "";
+    readyState = ExpoBridgeWebSocket.CONNECTING;
+    url;
+    #socketId = `websocket_${crypto.randomUUID()}`;
+    #messages = new Map;
+    #remove;
+    #sendSequence = 0;
+    #sendTail = Promise.resolve();
+    constructor(url, protocols) {
+      super();
+      if (protocols !== undefined && (typeof protocols !== "string" || protocols.length > 0) && (!Array.isArray(protocols) || protocols.length > 0))
+        throw new TypeError("Expo Sync bridge does not support WebSocket subprotocols.");
+      this.url = String(url);
+      this.#remove = provider.on("sync.socket", (payload) => {
+        if (payload.socketId !== this.#socketId)
+          return;
+        this.#receive(payload);
+      });
+      provider.request("sync.socket.open", {
+        socketId: this.#socketId,
+        url: this.url
+      }).catch(() => this.#fail());
+    }
+    close(code, reason) {
+      if (this.readyState === ExpoBridgeWebSocket.CLOSED || this.readyState === ExpoBridgeWebSocket.CLOSING)
+        return;
+      this.readyState = ExpoBridgeWebSocket.CLOSING;
+      provider.request("sync.socket.close", {
+        ...code === undefined ? {} : { code },
+        ...reason === undefined ? {} : { reason },
+        socketId: this.#socketId
+      }).catch(() => this.#closed(code ?? 1006, reason ?? ""));
+    }
+    ping() {
+      throw new TypeError("Expo Sync bridge WebSocket ping is not supported.");
+    }
+    send(data) {
+      if (this.readyState !== ExpoBridgeWebSocket.OPEN)
+        throw new DOMException("WebSocket is not open.", "InvalidStateError");
+      if (typeof data !== "string")
+        throw new TypeError("Expo Sync bridge supports the default string serializer only.");
+      const bytes = new TextEncoder().encode(data);
+      if (bytes.byteLength > MAX_SOCKET_FRAME_BYTES)
+        throw new DOMException("Sync frame exceeds 4 MiB.", "QuotaExceededError");
+      const total = Math.max(1, Math.ceil(bytes.byteLength / SOCKET_CHUNK_BYTES));
+      const messageId = `web_${(this.#sendSequence += 1).toString(36)}`;
+      this.#sendTail = this.#sendTail.then(async () => {
+        for (let index = 0;index < total; index += 1)
+          await provider.request("sync.socket.sendChunk", {
+            data: encodeBase64(bytes.slice(index * SOCKET_CHUNK_BYTES, Math.min(bytes.byteLength, (index + 1) * SOCKET_CHUNK_BYTES))),
+            index,
+            messageId,
+            socketId: this.#socketId,
+            total
+          });
+      }).catch(() => this.#fail());
+    }
+    #dispatch(event, listener) {
+      this.dispatchEvent(event);
+      listener?.call(this, event);
+    }
+    #closed(code, reason) {
+      if (this.readyState === ExpoBridgeWebSocket.CLOSED)
+        return;
+      this.readyState = ExpoBridgeWebSocket.CLOSED;
+      this.#remove();
+      for (const message of this.#messages.values())
+        clearTimeout(message.timer);
+      this.#messages.clear();
+      this.#dispatch(new CloseEvent("close", { code, reason }), this.onclose);
+    }
+    #fail() {
+      if (this.readyState === ExpoBridgeWebSocket.CLOSED)
+        return;
+      this.#dispatch(new Event("error"), this.onerror);
+      this.#closed(1006, "");
+    }
+    #receive(payload) {
+      if (payload.type === "open") {
+        if (this.readyState !== ExpoBridgeWebSocket.CONNECTING)
+          return;
+        this.readyState = ExpoBridgeWebSocket.OPEN;
+        this.#dispatch(new Event("open"), this.onopen);
+        return;
+      }
+      if (payload.type === "error") {
+        this.#dispatch(new Event("error"), this.onerror);
+        return;
+      }
+      if (payload.type === "close") {
+        this.#closed(typeof payload.code === "number" ? payload.code : 1006, typeof payload.reason === "string" ? payload.reason : "");
+        return;
+      }
+      if (payload.type !== "message-chunk")
+        return;
+      const messageId = payload.messageId;
+      const index = payload.index;
+      const total = payload.total;
+      const data = payload.data;
+      if (typeof messageId !== "string" || typeof index !== "number" || !Number.isSafeInteger(index) || typeof total !== "number" || !Number.isSafeInteger(total) || typeof data !== "string" || index < 0 || total < 1 || index >= total || total > Math.ceil(MAX_SOCKET_FRAME_BYTES / SOCKET_CHUNK_BYTES)) {
+        this.#fail();
+        return;
+      }
+      let message = this.#messages.get(messageId);
+      if (!message) {
+        message = {
+          chunks: Array.from({ length: total }),
+          timer: setTimeout(() => this.#fail(), 1e4)
+        };
+        this.#messages.set(messageId, message);
+      }
+      if (message.chunks.length !== total || message.chunks[index]) {
+        this.#fail();
+        return;
+      }
+      try {
+        message.chunks[index] = decodeBase64(data);
+      } catch {
+        this.#fail();
+        return;
+      }
+      if (!message.chunks.every((chunk) => chunk !== undefined))
+        return;
+      clearTimeout(message.timer);
+      this.#messages.delete(messageId);
+      const size = message.chunks.reduce((sum, chunk) => sum + (chunk?.byteLength ?? 0), 0);
+      if (size > MAX_SOCKET_FRAME_BYTES) {
+        this.#fail();
+        return;
+      }
+      const bytes = new Uint8Array(size);
+      let offset = 0;
+      for (const chunk of message.chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+      }
+      this.#dispatch(new MessageEvent("message", {
+        data: new TextDecoder().decode(bytes)
+      }), this.onmessage);
+    }
+  }
+  return ExpoBridgeWebSocket;
+};
+export {
+  createExpoSyncBridgeLocalStore,
+  createExpoSyncBridgeWebSocket
+};
+
+//# debugId=BF289F120D89D52A64756E2164756E21
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/client.ts"],
+  "sourcesContent": [
+    "import type {\n  LocalCollectionRecord,\n  LocalMutationRecord,\n  SyncLocalStore,\n  SyncLocalStoreMode,\n  SyncLocalStoreSchemaInput,\n  SyncLocalStoreSchemaStatus,\n  SyncLocalTransaction,\n} from \"@absolutejs/sync/client\";\nimport {\n  resolveSyncLocalDataPolicy,\n  resolveSyncLocalMutationPolicy,\n} from \"@absolutejs/sync/client\";\n\nexport type AbsoluteExpoSyncBridgeProvider = {\n  on(\n    event: \"sync.socket\",\n    listener: (payload: Record<string, unknown>) => void,\n  ): () => void;\n  request(method: string, params: Record<string, unknown>): Promise<unknown>;\n};\n\nexport type ExpoSyncBridgeLocalStoreOptions = {\n  provider: AbsoluteExpoSyncBridgeProvider;\n  storageSchema?: SyncLocalStoreSchemaInput;\n};\n\nconst record = (value: unknown, label: string) => {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value))\n    throw new TypeError(`Expo Sync bridge returned invalid ${label}.`);\n\n  return value as Record<string, unknown>;\n};\n\nconst transactionId = (value: unknown) => {\n  const id = Reflect.get(record(value, \"transaction\"), \"transactionId\");\n  if (typeof id !== \"string\" || id.length === 0)\n    throw new TypeError(\"Expo Sync bridge returned an invalid transaction id.\");\n\n  return id;\n};\n\nconst nullable = <T>(value: unknown): T | undefined =>\n  value === null || value === undefined ? undefined : (value as T);\n\n/**\n * SyncLocalStore proxy whose atomic transaction is owned by native SQLite.\n * The namespace argument never crosses the bridge; the native Auth principal\n * selected when the host was created is authoritative.\n */\nexport const createExpoSyncBridgeLocalStore = ({\n  provider,\n  storageSchema = { version: 1 },\n}: ExpoSyncBridgeLocalStoreOptions): SyncLocalStore => {\n  const policy = resolveSyncLocalDataPolicy(storageSchema);\n  const transaction = async <T>(\n    _namespace: string,\n    mode: SyncLocalStoreMode,\n    run: (transaction: SyncLocalTransaction) => Promise<T>,\n  ) => {\n    const id = transactionId(\n      await provider.request(\"sync.store.begin\", { mode }),\n    );\n    const request = (method: string, params: Record<string, unknown> = {}) =>\n      provider.request(method, { ...params, transactionId: id });\n    const remote: SyncLocalTransaction = {\n      deleteCollection: async (key) => {\n        await request(\"sync.tx.deleteCollection\", { key });\n      },\n      deleteMutation: async (operationId) => {\n        await request(\"sync.tx.deleteMutation\", { operationId });\n      },\n      getCollection: async <R>(key: string) =>\n        nullable<LocalCollectionRecord<R>>(\n          await request(\"sync.tx.getCollection\", { key }),\n        ),\n      getInstallationId: async () =>\n        nullable<string>(await request(\"sync.tx.getInstallationId\")),\n      getMutation: async (operationId) =>\n        nullable<LocalMutationRecord>(\n          await request(\"sync.tx.getMutation\", { operationId }),\n        ),\n      listCollections: async () =>\n        (await request(\"sync.tx.listCollections\")) as Array<{\n          key: string;\n          record: LocalCollectionRecord;\n        }>,\n      listMutations: async () =>\n        (await request(\"sync.tx.listMutations\")) as LocalMutationRecord[],\n      putCollection: async (key, collectionRecord) => {\n        await request(\"sync.tx.putCollection\", {\n          key,\n          record: collectionRecord,\n        });\n      },\n      putMutation: async (mutationRecord) => {\n        await request(\"sync.tx.putMutation\", { record: mutationRecord });\n      },\n      resolveMutationPolicy: (name) =>\n        resolveSyncLocalMutationPolicy(policy, name),\n      setInstallationId: async (installationId) => {\n        await request(\"sync.tx.setInstallationId\", { installationId });\n      },\n    };\n    try {\n      const result = await run(remote);\n      await provider.request(\"sync.store.end\", {\n        commit: true,\n        transactionId: id,\n      });\n\n      return result;\n    } catch (error) {\n      await provider\n        .request(\"sync.store.end\", {\n          commit: false,\n          transactionId: id,\n        })\n        .catch(() => undefined);\n      throw error;\n    }\n  };\n\n  return {\n    deleteNamespace: async () => {\n      await provider.request(\"sync.store.deleteNamespace\", {});\n    },\n    getSchemaStatus: async () =>\n      nullable<SyncLocalStoreSchemaStatus>(\n        await provider.request(\"sync.store.schema\", {}),\n      ) ??\n      (() => {\n        throw new Error(\"Expo Sync native schema status is unavailable.\");\n      })(),\n    transaction,\n  };\n};\n\nconst SOCKET_CHUNK_BYTES = 24 * 1024;\nconst MAX_SOCKET_FRAME_BYTES = 4 * 1024 * 1024;\nconst encodeBase64 = (value: Uint8Array) => {\n  let binary = \"\";\n  for (const byte of value) binary += String.fromCharCode(byte);\n\n  return btoa(binary);\n};\nconst decodeBase64 = (value: string) =>\n  Uint8Array.from(atob(value), (character) => character.charCodeAt(0));\n\ntype PendingMessage = {\n  chunks: Array<Uint8Array | undefined>;\n  timer: ReturnType<typeof setTimeout>;\n};\n\n/**\n * Browser-compatible string WebSocket facade backed by the native socket host.\n * Default JSON Sync frames are supported; binary serializers fail explicitly.\n */\nexport const createExpoSyncBridgeWebSocket = (\n  provider: AbsoluteExpoSyncBridgeProvider,\n): typeof WebSocket => {\n  class ExpoBridgeWebSocket extends EventTarget implements WebSocket {\n    static readonly CLOSED = 3;\n    static readonly CLOSING = 2;\n    static readonly CONNECTING = 0;\n    static readonly OPEN = 1;\n    readonly CLOSED = 3;\n    readonly CLOSING = 2;\n    readonly CONNECTING = 0;\n    readonly OPEN = 1;\n    binaryType: BinaryType = \"blob\";\n    readonly bufferedAmount = 0;\n    readonly extensions = \"\";\n    onclose: ((this: WebSocket, event: CloseEvent) => unknown) | null = null;\n    onerror: ((this: WebSocket, event: Event) => unknown) | null = null;\n    onmessage:\n      | ((this: WebSocket, event: MessageEvent<unknown>) => unknown)\n      | null = null;\n    onopen: ((this: WebSocket, event: Event) => unknown) | null = null;\n    readonly protocol = \"\";\n    readyState = ExpoBridgeWebSocket.CONNECTING;\n    readonly url: string;\n    readonly #socketId = `websocket_${crypto.randomUUID()}`;\n    readonly #messages = new Map<string, PendingMessage>();\n    readonly #remove: () => void;\n    #sendSequence = 0;\n    #sendTail = Promise.resolve();\n\n    constructor(url: string | URL, protocols?: string | string[]) {\n      super();\n      if (\n        protocols !== undefined &&\n        (typeof protocols !== \"string\" || protocols.length > 0) &&\n        (!Array.isArray(protocols) || protocols.length > 0)\n      )\n        throw new TypeError(\n          \"Expo Sync bridge does not support WebSocket subprotocols.\",\n        );\n      this.url = String(url);\n      this.#remove = provider.on(\"sync.socket\", (payload) => {\n        if (payload.socketId !== this.#socketId) return;\n        this.#receive(payload);\n      });\n      void provider\n        .request(\"sync.socket.open\", {\n          socketId: this.#socketId,\n          url: this.url,\n        })\n        .catch(() => this.#fail());\n    }\n\n    close(code?: number, reason?: string): void {\n      if (\n        this.readyState === ExpoBridgeWebSocket.CLOSED ||\n        this.readyState === ExpoBridgeWebSocket.CLOSING\n      )\n        return;\n      this.readyState = ExpoBridgeWebSocket.CLOSING;\n      void provider\n        .request(\"sync.socket.close\", {\n          ...(code === undefined ? {} : { code }),\n          ...(reason === undefined ? {} : { reason }),\n          socketId: this.#socketId,\n        })\n        .catch(() => this.#closed(code ?? 1006, reason ?? \"\"));\n    }\n\n    ping(): void {\n      throw new TypeError(\"Expo Sync bridge WebSocket ping is not supported.\");\n    }\n\n    send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void {\n      if (this.readyState !== ExpoBridgeWebSocket.OPEN)\n        throw new DOMException(\"WebSocket is not open.\", \"InvalidStateError\");\n      if (typeof data !== \"string\")\n        throw new TypeError(\n          \"Expo Sync bridge supports the default string serializer only.\",\n        );\n      const bytes = new TextEncoder().encode(data);\n      if (bytes.byteLength > MAX_SOCKET_FRAME_BYTES)\n        throw new DOMException(\n          \"Sync frame exceeds 4 MiB.\",\n          \"QuotaExceededError\",\n        );\n      const total = Math.max(\n        1,\n        Math.ceil(bytes.byteLength / SOCKET_CHUNK_BYTES),\n      );\n      const messageId = `web_${(this.#sendSequence += 1).toString(36)}`;\n      this.#sendTail = this.#sendTail\n        .then(async () => {\n          for (let index = 0; index < total; index += 1)\n            await provider.request(\"sync.socket.sendChunk\", {\n              data: encodeBase64(\n                bytes.slice(\n                  index * SOCKET_CHUNK_BYTES,\n                  Math.min(bytes.byteLength, (index + 1) * SOCKET_CHUNK_BYTES),\n                ),\n              ),\n              index,\n              messageId,\n              socketId: this.#socketId,\n              total,\n            });\n        })\n        .catch(() => this.#fail());\n    }\n\n    #dispatch<T extends Event>(\n      event: T,\n      listener: ((this: WebSocket, event: T) => unknown) | null,\n    ) {\n      this.dispatchEvent(event);\n      listener?.call(this, event);\n    }\n\n    #closed(code: number, reason: string) {\n      if (this.readyState === ExpoBridgeWebSocket.CLOSED) return;\n      this.readyState = ExpoBridgeWebSocket.CLOSED;\n      this.#remove();\n      for (const message of this.#messages.values())\n        clearTimeout(message.timer);\n      this.#messages.clear();\n      this.#dispatch(new CloseEvent(\"close\", { code, reason }), this.onclose);\n    }\n\n    #fail() {\n      if (this.readyState === ExpoBridgeWebSocket.CLOSED) return;\n      this.#dispatch(new Event(\"error\"), this.onerror);\n      this.#closed(1006, \"\");\n    }\n\n    #receive(payload: Record<string, unknown>) {\n      if (payload.type === \"open\") {\n        if (this.readyState !== ExpoBridgeWebSocket.CONNECTING) return;\n        this.readyState = ExpoBridgeWebSocket.OPEN;\n        this.#dispatch(new Event(\"open\"), this.onopen);\n\n        return;\n      }\n      if (payload.type === \"error\") {\n        this.#dispatch(new Event(\"error\"), this.onerror);\n\n        return;\n      }\n      if (payload.type === \"close\") {\n        this.#closed(\n          typeof payload.code === \"number\" ? payload.code : 1006,\n          typeof payload.reason === \"string\" ? payload.reason : \"\",\n        );\n\n        return;\n      }\n      if (payload.type !== \"message-chunk\") return;\n      const messageId = payload.messageId;\n      const index = payload.index;\n      const total = payload.total;\n      const data = payload.data;\n      if (\n        typeof messageId !== \"string\" ||\n        typeof index !== \"number\" ||\n        !Number.isSafeInteger(index) ||\n        typeof total !== \"number\" ||\n        !Number.isSafeInteger(total) ||\n        typeof data !== \"string\" ||\n        index < 0 ||\n        total < 1 ||\n        index >= total ||\n        total > Math.ceil(MAX_SOCKET_FRAME_BYTES / SOCKET_CHUNK_BYTES)\n      ) {\n        this.#fail();\n\n        return;\n      }\n      let message = this.#messages.get(messageId);\n      if (!message) {\n        message = {\n          chunks: Array.from({ length: total }),\n          timer: setTimeout(() => this.#fail(), 10_000),\n        };\n        this.#messages.set(messageId, message);\n      }\n      if (message.chunks.length !== total || message.chunks[index]) {\n        this.#fail();\n\n        return;\n      }\n      try {\n        message.chunks[index] = decodeBase64(data);\n      } catch {\n        this.#fail();\n\n        return;\n      }\n      if (!message.chunks.every((chunk) => chunk !== undefined)) return;\n      clearTimeout(message.timer);\n      this.#messages.delete(messageId);\n      const size = message.chunks.reduce(\n        (sum, chunk) => sum + (chunk?.byteLength ?? 0),\n        0,\n      );\n      if (size > MAX_SOCKET_FRAME_BYTES) {\n        this.#fail();\n\n        return;\n      }\n      const bytes = new Uint8Array(size);\n      let offset = 0;\n      for (const chunk of message.chunks) {\n        bytes.set(chunk!, offset);\n        offset += chunk!.byteLength;\n      }\n      this.#dispatch(\n        new MessageEvent(\"message\", {\n          data: new TextDecoder().decode(bytes),\n        }),\n        this.onmessage,\n      );\n    }\n  }\n\n  return ExpoBridgeWebSocket as unknown as typeof WebSocket;\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "BF289F120D89D52A64756E2164756E21",
+  "names": []
+}

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import type { SyncClient } from "@absolutejs/sync/client";
+import type { SyncLocalProtectionProvider } from "@absolutejs/sync/client";
+export * from "./store";
+export * from "./bridge";
+export type ExpoSyncSecureStore = {
+    AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY: number;
+    deleteItemAsync(key: string, options?: Record<string, unknown>): Promise<void>;
+    getItemAsync(key: string, options?: Record<string, unknown>): Promise<string | null>;
+    isAvailableAsync(): Promise<boolean>;
+    setItemAsync(key: string, value: string, options?: Record<string, unknown>): Promise<void>;
+};
+export type ExpoSyncProtectionOptions = {
+    secureStore?: ExpoSyncSecureStore;
+    storagePrefix?: string;
+};
+/** AES-256-GCM records whose data key is retained only by Expo SecureStore. */
+export declare const createExpoSyncProtection: (options?: ExpoSyncProtectionOptions) => SyncLocalProtectionProvider;
+type Subscription = {
+    remove(): void;
+};
+export type ExpoSyncLifecycleDependencies = {
+    appState: {
+        currentState?: string | null;
+        addEventListener(type: "change", listener: (state: string) => void): Subscription;
+    };
+    network: {
+        addNetworkStateListener(listener: (state: {
+            isConnected?: boolean;
+            isInternetReachable?: boolean;
+        }) => void): Subscription;
+    };
+};
+export type ExpoSyncLifecycleOptions = {
+    client: Pick<SyncClient, "reconnect"> & Partial<Pick<SyncClient, "flush">>;
+    /** Finite outbox budget after a wake-up. Defaults to 10 seconds. */
+    flushTimeoutMs?: number;
+    onError?: (error: unknown) => void;
+    dependencies?: ExpoSyncLifecycleDependencies;
+};
+/** Reconnect and perform a bounded flush after foreground or connectivity. */
+export declare const installExpoSyncLifecycle: ({ client, flushTimeoutMs, onError, dependencies, }: ExpoSyncLifecycleOptions) => () => void;
+export type ExpoSyncBackgroundDependencies = {
+    backgroundTask: {
+        Failed: number;
+        Success: number;
+        getStatusAsync(): Promise<number | null>;
+        registerTaskAsync(taskName: string, options?: {
+            minimumInterval?: number;
+        }): Promise<void>;
+        unregisterTaskAsync(taskName: string): Promise<void>;
+    };
+    taskManager: {
+        defineTask(taskName: string, run: () => Promise<number>): void;
+        isAvailableAsync(): Promise<boolean>;
+        isTaskDefined(taskName: string): boolean;
+        isTaskRegisteredAsync(taskName: string): Promise<boolean>;
+    };
+};
+/** Define the task at module scope before registering it during app startup. */
+export declare const defineExpoSyncBackgroundTask: (taskName: string, run: () => Promise<unknown>, dependencies?: ExpoSyncBackgroundDependencies) => void;
+export type ExpoSyncBackgroundRegistration = {
+    available: boolean;
+    registered: boolean;
+    status: number | null;
+};
+export declare const registerExpoSyncBackgroundTask: (taskName: string, options?: {
+    minimumInterval?: number;
+}, dependencies?: ExpoSyncBackgroundDependencies) => Promise<ExpoSyncBackgroundRegistration>;
+export declare const unregisterExpoSyncBackgroundTask: (taskName: string, dependencies?: ExpoSyncBackgroundDependencies) => Promise<void>;