@datafn/extfn 0.1.0

package/README.md

@@ -0,0 +1,143 @@
+# @datafn/extfn
+
+`@datafn/extfn` is the DataFn integration layer for `extfn`.
+
+It keeps DataFn authority in the extension background context and gives popup, options, sidepanel, and content code a proxy client surface that stays aligned with the public `@datafn/client` API.
+
+## What this package owns
+
+- background authority setup
+- background request routing for DataFn RPC methods
+- cross-context proxy client creation
+- subscription fanout and cleanup for extension contexts
+
+It does not move DataFn semantics into `extfn` core.
+
+## Public surface
+
+The package exports:
+
+- `createDatafnExtfnAuthority(...)`
+- `createDatafnExtfnProxyClient(...)`
+- `createBrowserDatafnExtfnBridge(...)`
+- `datafnExtfn(...)`
+- `createDatafnExtfnRoutes(...)`
+
+## Options
+
+`DatafnExtfnOptions` is based on the current public `DatafnClientConfig` shape.
+
+Supported keys:
+
+- `schema`
+- `clientId`
+- `namespace`
+- `sync`
+- `storage`
+- `plugins`
+- `searchProvider`
+- `requestTimeoutMs`
+
+Not supported:
+
+- `authContext`
+
+If you need auth/session behavior, keep that in consumer code or another package-owned layer and pass DataFn the resulting configuration or storage behavior explicitly.
+
+## Background authority
+
+Create the authority in background code only.
+
+```ts
+import { createDatafnExtfnAuthority } from "@datafn/extfn";
+import { demoNamespace, demoSchema } from "./demoSchema.js";
+
+const authority = createDatafnExtfnAuthority(
+  {
+    schema: demoSchema,
+    clientId: "authority:demo",
+    namespace: demoNamespace,
+  },
+  {
+    address: {
+      context: "background",
+    },
+  },
+);
+
+authority.attachBrowserRuntimeBridge();
+```
+
+The authority:
+
+- rejects non-background startup
+- reuses `@datafn/client` storage adapters
+- owns subscription lifecycle
+- speaks extfn-compatible request/response/event envelopes to extension contexts
+
+## Popup, options, sidepanel, and content clients
+
+Create a proxy client in any non-background context.
+
+```ts
+import { createDatafnExtfnProxyClient } from "@datafn/extfn";
+
+const client = createDatafnExtfnProxyClient({
+  schema: demoSchema,
+  clientId: "popup:demo",
+  namespace: demoNamespace,
+});
+
+const notes = await client.query({
+  resource: "note",
+  version: 1,
+  select: ["id", "title"],
+});
+```
+
+You can also pass explicit runtime options:
+
+```ts
+const client = createDatafnExtfnProxyClient(
+  {
+    schema: demoSchema,
+    clientId: "content:demo",
+    namespace: demoNamespace,
+  },
+  {
+    address: {
+      context: "content",
+      contentScriptId: "highlights",
+      tabId: 12,
+    },
+  },
+);
+```
+
+## Using the plugin helper
+
+`datafnExtfn(...)` returns a runtime plugin plus convenience accessors.
+
+Use it when your package wants to bundle:
+
+- a stable plugin id
+- background route registration
+- a reusable proxy-client factory
+
+Keep in mind that background authority startup is still package-owned logic.
+
+## Example in this repo
+
+See:
+
+- `extfn/examples/svelte-datafn-demo/extfn.config.ts`
+- `extfn/examples/svelte-datafn-demo/src/background/index.ts`
+- `extfn/examples/svelte-datafn-demo/src/demoClient.ts`
+
+## Validation from repo root
+
+```bash
+npm run test -- --filter=@datafn/extfn
+npm run build -- --filter=svelte-datafn-demo
+npm exec extfn scan -- --config extfn/examples/svelte-datafn-demo/extfn.config.ts
+```

package/dist/authority.d.ts

@@ -0,0 +1,44 @@
+import { createDatafnClient, type DatafnClient, type DatafnClientConfig } from "@datafn/client";
+import type { DatafnSchema } from "@datafn/core";
+import type { RuntimeAddress } from "@extfn/core";
+import type { DatafnExtfnOptions } from "./plugin.js";
+import { DatafnExtfnSubscriptions } from "./subscriptions.js";
+import { type RuntimeEventEnvelope, type RuntimeRequestEnvelope, type RuntimeResponseEnvelope } from "./shared.js";
+type DatafnRpcMethod = "query" | "mutation" | "transact" | "seed" | "clone" | "pull" | "push" | "reconcile" | "subscribe" | "unsubscribe";
+export interface BrowserRuntimeLike {
+    sendMessage?: (message: unknown, callback?: (response: unknown) => void) => Promise<unknown> | void;
+    onMessage?: {
+        addListener(handler: BrowserRuntimeMessageHandler): void;
+        removeListener(handler: BrowserRuntimeMessageHandler): void;
+    };
+}
+type BrowserRuntimeMessageHandler = (message: unknown, sender: unknown, sendResponse: (response: unknown) => void) => boolean | void;
+export interface DatafnExtfnRequestContext {
+    proxyId: string;
+    emitEvent?: (eventEnvelope: RuntimeEventEnvelope) => void | Promise<void>;
+}
+export interface DatafnExtfnBridge {
+    proxyId: string;
+    request(envelope: RuntimeRequestEnvelope): Promise<RuntimeResponseEnvelope>;
+    onEvent(handler: (eventEnvelope: RuntimeEventEnvelope) => void): () => void;
+}
+export interface CreateDatafnExtfnAuthorityOptions<S extends DatafnSchema> {
+    address?: RuntimeAddress;
+    clientFactory?: typeof createDatafnClient<S>;
+    storage?: DatafnClientConfig<S>["storage"];
+    autoStartSync?: boolean;
+}
+export interface DatafnExtfnAuthority<S extends DatafnSchema> {
+    readonly address: RuntimeAddress;
+    readonly client: DatafnClient<S>;
+    readonly options: DatafnExtfnOptions<S>;
+    readonly subscriptions: DatafnExtfnSubscriptions;
+    requestMethod(method: DatafnRpcMethod, payload: unknown, context?: DatafnExtfnRequestContext): Promise<unknown>;
+    handleRequest(envelope: RuntimeRequestEnvelope, context?: DatafnExtfnRequestContext): Promise<RuntimeResponseEnvelope>;
+    createBridge(proxyId?: string): DatafnExtfnBridge;
+    attachBrowserRuntimeBridge(runtime?: BrowserRuntimeLike): () => void;
+    destroy(): Promise<void>;
+}
+export declare function createDatafnExtfnAuthority<S extends DatafnSchema>(options: DatafnExtfnOptions<S>, init?: CreateDatafnExtfnAuthorityOptions<S>): DatafnExtfnAuthority<S>;
+export {};
+//# sourceMappingURL=authority.d.ts.map

package/dist/authority.d.ts.map

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

package/dist/authority.js

@@ -0,0 +1,242 @@
+import { createDatafnClient, IndexedDbStorageAdapter, MemoryStorageAdapter, } from "@datafn/client";
+import { DatafnExtfnSubscriptions } from "./subscriptions.js";
+import { assertValidDatafnExtfnOptionShape, assertValidRequestEnvelope, createErrorResponseEnvelope, createEventEnvelope, createExtfnLikeError, createSuccessResponseEnvelope, normalizeExtfnLikeError, toProxyId, } from "./shared.js";
+export function createDatafnExtfnAuthority(options, init = {}) {
+    assertValidDatafnExtfnOptionShape(options);
+    const address = init.address ?? { context: "background" };
+    if (address.context !== "background") {
+        throw createExtfnLikeError("E_CONTEXT_UNAVAILABLE", "DataFn authority mode is only available in background context.", {
+            context: address.context,
+        });
+    }
+    const clientFactory = init.clientFactory ?? createDatafnClient;
+    const storage = resolveAuthorityStorage(options, init.storage);
+    const sync = {
+        offlinability: options.sync?.offlinability ?? true,
+        mode: options.sync?.mode ??
+            (options.sync?.remote || options.sync?.remoteAdapter
+                ? "sync"
+                : "local-only"),
+        ...options.sync,
+    };
+    const client = clientFactory({
+        ...options,
+        sync,
+        storage,
+    });
+    const subscriptions = new DatafnExtfnSubscriptions({
+        subscribe: (handler, filter) => client.subscribe(handler, filter),
+    });
+    const runtimeBridgeCleanups = new Set();
+    if (init.autoStartSync && sync.mode === "sync") {
+        void client.sync.start();
+    }
+    const authority = {
+        address,
+        client,
+        options,
+        subscriptions,
+        async requestMethod(method, payload, context) {
+            switch (method) {
+                case "query":
+                    return client.query(payload);
+                case "mutation":
+                    return client.mutate(payload);
+                case "transact":
+                    return client.transact(payload);
+                case "seed":
+                    return client.sync.seed(payload);
+                case "clone":
+                    return client.sync.clone(payload);
+                case "pull":
+                    return client.sync.pull(payload);
+                case "push":
+                    return client.sync.push(payload);
+                case "reconcile":
+                    await client.sync.reconcileNow();
+                    return { reconciled: true };
+                case "subscribe":
+                    return handleSubscribeRequest(subscriptions, address, payload, context);
+                case "unsubscribe":
+                    return handleUnsubscribeRequest(subscriptions, payload);
+                default:
+                    throw createExtfnLikeError("E_HANDLER_NOT_FOUND", `No handler registered for datafn/${method}`);
+            }
+        },
+        async handleRequest(envelope, context) {
+            try {
+                assertValidRequestEnvelope(envelope);
+            }
+            catch (error) {
+                return createErrorResponseEnvelope(envelope.requestId, normalizeExtfnLikeError(error));
+            }
+            try {
+                const result = await authority.requestMethod(envelope.method, envelope.payload, context);
+                return createSuccessResponseEnvelope(envelope.requestId, result);
+            }
+            catch (error) {
+                return createErrorResponseEnvelope(envelope.requestId, normalizeExtfnLikeError(error));
+            }
+        },
+        createBridge(proxyId = `proxy_${Math.random().toString(36).slice(2, 10)}`) {
+            const listeners = new Set();
+            return {
+                proxyId,
+                request(envelope) {
+                    return authority.handleRequest(envelope, {
+                        proxyId,
+                        emitEvent: async (eventEnvelope) => {
+                            for (const listener of listeners) {
+                                listener(eventEnvelope);
+                            }
+                        },
+                    });
+                },
+                onEvent(handler) {
+                    listeners.add(handler);
+                    return () => {
+                        listeners.delete(handler);
+                    };
+                },
+            };
+        },
+        attachBrowserRuntimeBridge(runtime = resolveBrowserRuntime()) {
+            if (!runtime?.onMessage?.addListener) {
+                return () => { };
+            }
+            const listener = (message, _sender, sendResponse) => {
+                if (!isDatafnRequestEnvelope(message)) {
+                    return undefined;
+                }
+                const envelope = message;
+                const proxyId = toProxyId(envelope.source);
+                void authority
+                    .handleRequest(envelope, {
+                    proxyId,
+                    emitEvent: async (eventEnvelope) => {
+                        await sendBrowserRuntimeMessage(runtime, eventEnvelope);
+                    },
+                })
+                    .then(sendResponse);
+                return true;
+            };
+            runtime.onMessage.addListener(listener);
+            const cleanup = () => {
+                runtime.onMessage?.removeListener(listener);
+                runtimeBridgeCleanups.delete(cleanup);
+            };
+            runtimeBridgeCleanups.add(cleanup);
+            return cleanup;
+        },
+        async destroy() {
+            for (const cleanup of runtimeBridgeCleanups) {
+                cleanup();
+            }
+            await subscriptions.closeAll();
+            await client.destroy();
+        },
+    };
+    return authority;
+}
+function handleSubscribeRequest(subscriptions, address, payload, context) {
+    if (!context?.emitEvent) {
+        throw createExtfnLikeError("E_CONTEXT_UNAVAILABLE", "DataFn subscription fanout requires an active proxy bridge.");
+    }
+    const input = typeof payload === "object" && payload !== null
+        ? payload
+        : {};
+    return subscriptions.subscribe({
+        filter: input.filter,
+        ...(typeof input.subscriptionId === "string"
+            ? { resumeSubscriptionId: input.subscriptionId }
+            : {}),
+        deliver: async (delivery) => {
+            await context.emitEvent?.(createEventEnvelope({
+                namespace: "datafn",
+                event: "subscription",
+                source: address,
+                payload: delivery,
+            }));
+        },
+    });
+}
+async function handleUnsubscribeRequest(subscriptions, payload) {
+    if (typeof payload !== "object" ||
+        payload === null ||
+        typeof payload.subscriptionId !== "string") {
+        throw createExtfnLikeError("E_RUNTIME_PROTOCOL", "Unsubscribe payload is missing subscriptionId.");
+    }
+    await subscriptions.unsubscribe(payload.subscriptionId);
+    return { unsubscribed: true };
+}
+function resolveAuthorityStorage(options, override) {
+    const configuredStorage = override ?? options.storage;
+    if (configuredStorage) {
+        if (typeof configuredStorage === "function") {
+            if (!options.namespace) {
+                throw createExtfnLikeError("E_CONFIG_INVALID", "DataFn extfn namespace is required when storage is a factory.");
+            }
+            return configuredStorage(options.namespace);
+        }
+        return configuredStorage;
+    }
+    const namespace = options.namespace ?? options.clientId;
+    if (typeof indexedDB !== "undefined") {
+        return IndexedDbStorageAdapter.createForNamespace("datafn_extfn", namespace, undefined, options.schema);
+    }
+    return new MemoryStorageAdapter(options.schema.resources.map((resource) => resource.name));
+}
+function isDatafnRequestEnvelope(message) {
+    return (typeof message === "object" &&
+        message !== null &&
+        message.kind === "request" &&
+        message.namespace === "datafn");
+}
+function resolveBrowserRuntime() {
+    const globalRuntime = globalThis;
+    return globalRuntime.browser?.runtime ?? globalRuntime.chrome?.runtime;
+}
+function sendBrowserRuntimeMessage(runtime, message) {
+    if (typeof runtime.sendMessage !== "function") {
+        throw createExtfnLikeError("E_CONTEXT_UNAVAILABLE", "Browser runtime messaging is unavailable.");
+    }
+    const sendMessage = runtime.sendMessage.bind(runtime);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const resolveOnce = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            resolve(value);
+        };
+        const rejectOnce = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            reject(normalizeExtfnLikeError(error));
+        };
+        try {
+            if (sendMessage.length >= 2) {
+                const maybePromise = sendMessage(message, (response) => {
+                    resolveOnce(response);
+                });
+                if (maybePromise && typeof maybePromise.then === "function") {
+                    void maybePromise.then(resolveOnce, rejectOnce);
+                }
+                return;
+            }
+            const maybePromise = sendMessage(message);
+            if (maybePromise && typeof maybePromise.then === "function") {
+                void maybePromise.then(resolveOnce, rejectOnce);
+                return;
+            }
+            resolveOnce(undefined);
+        }
+        catch (error) {
+            rejectOnce(error);
+        }
+    });
+}
+//# sourceMappingURL=authority.js.map

package/dist/authority.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createDatafnExtfnAuthority, type BrowserRuntimeLike, type CreateDatafnExtfnAuthorityOptions, type DatafnExtfnAuthority, type DatafnExtfnBridge, type DatafnExtfnRequestContext, } from "./authority.js";
+export { datafnExtfn, assertValidDatafnExtfnOptions, type DatafnExtfnOptions, type DatafnExtfnPlugin, type DatafnExtfnPluginInit, } from "./plugin.js";
+export { createDatafnExtfnProxyClient, createBrowserDatafnExtfnBridge, type DatafnExtfnProxyClientOptions, } from "./proxyClient.js";
+export { createDatafnExtfnRoutes, } from "./routes.js";
+export { DatafnExtfnSubscriptions, type DatafnExtfnSubscriptionDelivery, type DatafnExtfnSubscriptionOptions, type DatafnExtfnSubscriptionRegistration, } from "./subscriptions.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,OAAO,EACL,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iCAAiC,EACtC,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACnC,KAAK,mCAAmC,GACzC,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { createDatafnExtfnAuthority, } from "./authority.js";
+export { datafnExtfn, assertValidDatafnExtfnOptions, } from "./plugin.js";
+export { createDatafnExtfnProxyClient, createBrowserDatafnExtfnBridge, } from "./proxyClient.js";
+export { createDatafnExtfnRoutes, } from "./routes.js";
+export { DatafnExtfnSubscriptions, } from "./subscriptions.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,OAAO,EACL,0BAA0B,GAM3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,6BAA6B,GAI9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAE/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,GAIzB,MAAM,oBAAoB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,22 @@
+import type { DatafnClient, DatafnClientConfig } from "@datafn/client";
+import type { DatafnSchema } from "@datafn/core";
+import type { RuntimePlugin } from "@extfn/core";
+import { type CreateDatafnExtfnAuthorityOptions, type DatafnExtfnAuthority } from "./authority.js";
+import { type DatafnExtfnProxyClientOptions } from "./proxyClient.js";
+type PublicDatafnExtfnConfig<S extends DatafnSchema> = Pick<DatafnClientConfig<S>, "schema" | "clientId" | "namespace" | "sync" | "storage" | "plugins" | "searchProvider"> & {
+    requestTimeoutMs?: number;
+};
+export interface DatafnExtfnOptions<S extends DatafnSchema> extends PublicDatafnExtfnConfig<S> {
+}
+export interface DatafnExtfnPlugin<S extends DatafnSchema> extends RuntimePlugin {
+    readonly authority: DatafnExtfnAuthority<S>;
+    createProxyClient(runtimeOptions?: DatafnExtfnProxyClientOptions): DatafnClient<S>;
+}
+export interface DatafnExtfnPluginInit<S extends DatafnSchema> {
+    authority?: DatafnExtfnAuthority<S>;
+    authorityOptions?: CreateDatafnExtfnAuthorityOptions<S>;
+}
+export declare function assertValidDatafnExtfnOptions<S extends DatafnSchema>(options: DatafnExtfnOptions<S>): void;
+export declare function datafnExtfn<S extends DatafnSchema>(options: DatafnExtfnOptions<S>, init?: DatafnExtfnPluginInit<S>): DatafnExtfnPlugin<S>;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,kBAAkB,CAAC;AAI1B,KAAK,uBAAuB,CAAC,CAAC,SAAS,YAAY,IAAI,IAAI,CACzD,kBAAkB,CAAC,CAAC,CAAC,EACnB,QAAQ,GACR,UAAU,GACV,WAAW,GACX,MAAM,GACN,SAAS,GACT,SAAS,GACT,gBAAgB,CACnB,GAAG;IACF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,YAAY,CACxD,SAAQ,uBAAuB,CAAC,CAAC,CAAC;CAAG;AAEvC,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,YAAY,CACvD,SAAQ,aAAa;IACrB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC5C,iBAAiB,CACf,cAAc,CAAC,EAAE,6BAA6B,GAC7C,YAAY,CAAC,CAAC,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,YAAY;IAC3D,SAAS,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACpC,gBAAgB,CAAC,EAAE,iCAAiC,CAAC,CAAC,CAAC,CAAC;CACzD;AAED,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,YAAY,EAClE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,IAAI,CAEN;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAChD,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,IAAI,GAAE,qBAAqB,CAAC,CAAC,CAAM,GAClC,iBAAiB,CAAC,CAAC,CAAC,CAkBtB"}

package/dist/plugin.js

@@ -0,0 +1,25 @@
+import { createDatafnExtfnAuthority, } from "./authority.js";
+import { createDatafnExtfnProxyClient, } from "./proxyClient.js";
+import { createDatafnExtfnRoutes } from "./routes.js";
+import { assertValidDatafnExtfnOptionShape } from "./shared.js";
+export function assertValidDatafnExtfnOptions(options) {
+    assertValidDatafnExtfnOptionShape(options);
+}
+export function datafnExtfn(options, init = {}) {
+    assertValidDatafnExtfnOptions(options);
+    const authority = init.authority ??
+        createDatafnExtfnAuthority(options, init.authorityOptions);
+    return {
+        id: "datafn-extfn",
+        registerBackgroundHandlers() {
+            return createDatafnExtfnRoutes(authority);
+        },
+        get authority() {
+            return authority;
+        },
+        createProxyClient(runtimeOptions) {
+            return createDatafnExtfnProxyClient(options, runtimeOptions);
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,0BAA0B,GAG3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,4BAA4B,GAE7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AA+BhE,MAAM,UAAU,6BAA6B,CAC3C,OAA8B;IAE9B,iCAAiC,CAAC,OAAkB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAA8B,EAC9B,OAAiC,EAAE;IAEnC,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,SAAS,GACb,IAAI,CAAC,SAAS;QACd,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAE7D,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,0BAA0B;YACxB,OAAO,uBAAuB,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,SAAS;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,iBAAiB,CAAC,cAAc;YAC9B,OAAO,4BAA4B,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/proxyClient.d.ts

@@ -0,0 +1,16 @@
+import { type DatafnClient } from "@datafn/client";
+import type { DatafnSchema } from "@datafn/core";
+import type { RuntimeAddress } from "@extfn/core";
+import type { BrowserRuntimeLike, DatafnExtfnBridge } from "./authority.js";
+import type { DatafnExtfnOptions } from "./plugin.js";
+export interface DatafnExtfnProxyClientOptions {
+    bridge?: DatafnExtfnBridge;
+    address?: RuntimeAddress;
+    browserRuntime?: BrowserRuntimeLike;
+}
+export declare function createDatafnExtfnProxyClient<S extends DatafnSchema>(options: DatafnExtfnOptions<S>, runtimeOptions?: DatafnExtfnProxyClientOptions): DatafnClient<S>;
+export declare function createBrowserDatafnExtfnBridge(options: {
+    address: RuntimeAddress;
+    browserRuntime?: BrowserRuntimeLike;
+}): DatafnExtfnBridge;
+//# sourceMappingURL=proxyClient.d.ts.map

package/dist/proxyClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxyClient.d.ts","sourceRoot":"","sources":["../src/proxyClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAUtD,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,YAAY,EACjE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,cAAc,GAAE,6BAAkC,GACjD,YAAY,CAAC,CAAC,CAAC,CAuBjB;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,OAAO,EAAE,cAAc,CAAC;IACxB,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC,GAAG,iBAAiB,CA+BpB"}

package/dist/proxyClient.js

@@ -0,0 +1,192 @@
+import { createDatafnClient, createExtensionTransport, } from "@datafn/client";
+import { assertValidDatafnExtfnOptionShape, createExtfnLikeError, createRequestEnvelope, normalizeExtfnLikeError, } from "./shared.js";
+export function createDatafnExtfnProxyClient(options, runtimeOptions = {}) {
+    assertValidDatafnExtfnOptionShape(options);
+    const bridge = runtimeOptions.bridge ??
+        createBrowserDatafnExtfnBridge({
+            address: runtimeOptions.address ?? { context: "popup" },
+            browserRuntime: runtimeOptions.browserRuntime,
+        });
+    const transport = createExtensionTransport(createMessageBus(bridge, runtimeOptions.address ?? { context: "popup" }), {
+        timeout: options.requestTimeoutMs,
+    });
+    return createDatafnClient({
+        ...options,
+        sync: {
+            ...options.sync,
+            mode: "sync",
+            remoteAdapter: transport,
+        },
+    });
+}
+export function createBrowserDatafnExtfnBridge(options) {
+    const browserRuntime = options.browserRuntime ?? resolveBrowserRuntime();
+    if (!browserRuntime) {
+        throw createExtfnLikeError("E_CONTEXT_UNAVAILABLE", "Browser runtime messaging is unavailable.");
+    }
+    return {
+        proxyId: createBrowserProxyId(options.address),
+        async request(envelope) {
+            const response = await sendBrowserRuntimeMessage(browserRuntime, envelope);
+            return normalizeRuntimeResponse(response, envelope.requestId);
+        },
+        onEvent(handler) {
+            if (!browserRuntime.onMessage?.addListener) {
+                return () => { };
+            }
+            const listener = (message) => {
+                if (isDatafnEventEnvelope(message)) {
+                    handler(message);
+                }
+            };
+            browserRuntime.onMessage.addListener(listener);
+            return () => {
+                browserRuntime.onMessage?.removeListener(listener);
+            };
+        },
+    };
+}
+function createMessageBus(bridge, address) {
+    const listeners = new Set();
+    bridge.onEvent((eventEnvelope) => {
+        const payload = eventEnvelope.payload;
+        if (typeof payload.subscriptionId === "string" &&
+            "event" in payload) {
+            const eventMessage = {
+                type: "event",
+                subscriptionId: payload.subscriptionId,
+                event: payload.event,
+            };
+            for (const listener of listeners) {
+                listener(eventMessage);
+            }
+        }
+    });
+    return {
+        postMessage(message) {
+            const request = message;
+            const envelope = createRequestEnvelope({
+                requestId: request.id,
+                namespace: "datafn",
+                method: request.method,
+                source: address,
+                target: { context: "background" },
+                payload: request.payload,
+            });
+            void bridge
+                .request(envelope)
+                .then((responseEnvelope) => {
+                const responseMessage = {
+                    id: request.id,
+                    envelope: toDatafnEnvelope(responseEnvelope),
+                };
+                for (const listener of listeners) {
+                    listener(responseMessage);
+                }
+            })
+                .catch((error) => {
+                const responseMessage = {
+                    id: request.id,
+                    envelope: {
+                        ok: false,
+                        error: normalizeExtfnLikeError(error),
+                    },
+                };
+                for (const listener of listeners) {
+                    listener(responseMessage);
+                }
+            });
+        },
+        onMessage(handler) {
+            listeners.add(handler);
+            return () => {
+                listeners.delete(handler);
+            };
+        },
+    };
+}
+function toDatafnEnvelope(responseEnvelope) {
+    if (responseEnvelope.ok) {
+        return {
+            ok: true,
+            result: responseEnvelope.result,
+        };
+    }
+    return {
+        ok: false,
+        error: responseEnvelope.error ??
+            createExtfnLikeError("E_RUNTIME_PROTOCOL", "Runtime response did not include an error payload."),
+    };
+}
+function normalizeRuntimeResponse(response, requestId) {
+    if (typeof response === "object" &&
+        response !== null &&
+        response.kind === "response") {
+        return response;
+    }
+    throw createExtfnLikeError("E_RUNTIME_PROTOCOL", "Runtime response did not match the extfn response envelope shape.", { requestId });
+}
+function isDatafnEventEnvelope(message) {
+    return (typeof message === "object" &&
+        message !== null &&
+        message.kind === "event" &&
+        message.namespace === "datafn" &&
+        message.event === "subscription");
+}
+function createBrowserProxyId(address) {
+    return [
+        address.context,
+        address.surfaceId ?? "surface",
+        address.contentScriptId ?? "content",
+        address.tabId ?? "tab",
+        address.frameId ?? "frame",
+    ].join(":");
+}
+function resolveBrowserRuntime() {
+    const globalRuntime = globalThis;
+    return globalRuntime.browser?.runtime ?? globalRuntime.chrome?.runtime;
+}
+function sendBrowserRuntimeMessage(runtime, message) {
+    if (typeof runtime.sendMessage !== "function") {
+        throw createExtfnLikeError("E_CONTEXT_UNAVAILABLE", "Browser runtime messaging is unavailable.");
+    }
+    const sendMessage = runtime.sendMessage.bind(runtime);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const resolveOnce = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            resolve(value);
+        };
+        const rejectOnce = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            reject(normalizeExtfnLikeError(error));
+        };
+        try {
+            if (sendMessage.length >= 2) {
+                const maybePromise = sendMessage(message, (response) => {
+                    resolveOnce(response);
+                });
+                if (maybePromise && typeof maybePromise.then === "function") {
+                    void maybePromise.then(resolveOnce, rejectOnce);
+                }
+                return;
+            }
+            const maybePromise = sendMessage(message);
+            if (maybePromise && typeof maybePromise.then === "function") {
+                void maybePromise.then(resolveOnce, rejectOnce);
+                return;
+            }
+            resolveOnce(undefined);
+        }
+        catch (error) {
+            rejectOnce(error);
+        }
+    });
+}
+//# sourceMappingURL=proxyClient.js.map

package/dist/proxyClient.js.map

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

package/dist/routes.d.ts

@@ -0,0 +1,5 @@
+import type { BackgroundHandlerDefinition } from "@extfn/core";
+import type { DatafnSchema } from "@datafn/core";
+import type { DatafnExtfnAuthority } from "./authority.js";
+export declare function createDatafnExtfnRoutes<S extends DatafnSchema>(authority: DatafnExtfnAuthority<S>): readonly BackgroundHandlerDefinition[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAmB3D,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,YAAY,EAC5D,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,GACjC,SAAS,2BAA2B,EAAE,CA0BxC"}

package/dist/routes.js

@@ -0,0 +1,33 @@
+import { createExtfnLikeError, toProxyId, } from "./shared.js";
+const DATAFN_ROUTE_METHODS = [
+    "query",
+    "mutation",
+    "transact",
+    "seed",
+    "clone",
+    "pull",
+    "push",
+    "reconcile",
+    "subscribe",
+    "unsubscribe",
+];
+export function createDatafnExtfnRoutes(authority) {
+    return DATAFN_ROUTE_METHODS.map((method) => ({
+        namespace: "datafn",
+        method,
+        handle: async (...args) => {
+            const payload = args[1];
+            const envelope = args[2];
+            const proxyId = envelope?.source
+                ? toProxyId(envelope.source)
+                : "datafn-route";
+            if (method === "subscribe") {
+                throw createExtfnLikeError("E_CONTEXT_UNAVAILABLE", "DataFn subscription routes require a live proxy bridge for event fanout.", { proxyId });
+            }
+            return authority.requestMethod(method, payload, {
+                proxyId,
+            });
+        },
+    }));
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,oBAAoB,EACpB,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,MAAM,oBAAoB,GAAG;IAC3B,OAAO;IACP,UAAU;IACV,UAAU;IACV,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,WAAW;IACX,WAAW;IACX,aAAa;CACL,CAAC;AAEX,MAAM,UAAU,uBAAuB,CACrC,SAAkC;IAElC,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,SAAS,EAAE,QAAQ;QACnB,MAAM;QACN,MAAM,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAEV,CAAC;YACd,MAAM,OAAO,GAAG,QAAQ,EAAE,MAAM;gBAC9B,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC5B,CAAC,CAAC,cAAc,CAAC;YAEnB,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC3B,MAAM,oBAAoB,CACxB,uBAAuB,EACvB,0EAA0E,EAC1E,EAAE,OAAO,EAAE,CACZ,CAAC;YACJ,CAAC;YAED,OAAO,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE;gBAC9C,OAAO;aACR,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/shared.d.ts

@@ -0,0 +1,45 @@
+import type { RuntimeAddress } from "@extfn/core";
+export interface RuntimeRequestEnvelope {
+    v: 1;
+    kind: "request";
+    requestId: string;
+    namespace: string;
+    method: string;
+    source: RuntimeAddress;
+    target: RuntimeAddress;
+    payload: unknown;
+    timeoutMs?: number;
+}
+export interface RuntimeResponseEnvelope {
+    v: 1;
+    kind: "response";
+    requestId: string;
+    ok: boolean;
+    result?: unknown;
+    error?: ExtfnLikeError;
+}
+export interface RuntimeEventEnvelope {
+    v: 1;
+    kind: "event";
+    namespace: string;
+    event: string;
+    source: RuntimeAddress;
+    payload: unknown;
+}
+export interface ExtfnLikeError {
+    code: string;
+    message: string;
+    status: number;
+    retryable: boolean;
+    details?: Record<string, unknown>;
+}
+export declare function createExtfnLikeError(code: string, message: string, details?: Record<string, unknown>): ExtfnLikeError;
+export declare function normalizeExtfnLikeError(error: unknown): ExtfnLikeError;
+export declare function assertValidDatafnExtfnOptionShape(options: unknown): void;
+export declare function createRequestEnvelope(input: Omit<RuntimeRequestEnvelope, "v" | "kind">): RuntimeRequestEnvelope;
+export declare function createSuccessResponseEnvelope(requestId: string, result: unknown): RuntimeResponseEnvelope;
+export declare function createErrorResponseEnvelope(requestId: string, error: ExtfnLikeError): RuntimeResponseEnvelope;
+export declare function createEventEnvelope(input: Omit<RuntimeEventEnvelope, "v" | "kind">): RuntimeEventEnvelope;
+export declare function assertValidRequestEnvelope(envelope: RuntimeRequestEnvelope): RuntimeRequestEnvelope;
+export declare function toProxyId(address: RuntimeAddress): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,EAAE,CAAC,CAAC;IACL,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAaD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,cAAc,CAQhB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CA4BtE;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwBxE;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,GAAG,GAAG,MAAM,CAAC,GAChD,sBAAsB,CASxB;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GACd,uBAAuB,CAQzB;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,cAAc,GACpB,uBAAuB,CAQzB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,GAAG,GAAG,MAAM,CAAC,GAC9C,oBAAoB,CAMtB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,sBAAsB,GAC/B,sBAAsB,CA6BxB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAQzD"}

package/dist/shared.js

@@ -0,0 +1,137 @@
+const ALLOWED_DATAFN_EXTFN_OPTION_KEYS = new Set([
+    "schema",
+    "clientId",
+    "namespace",
+    "sync",
+    "storage",
+    "plugins",
+    "searchProvider",
+    "requestTimeoutMs",
+]);
+export function createExtfnLikeError(code, message, details) {
+    return {
+        code,
+        message,
+        status: defaultStatusForCode(code),
+        retryable: false,
+        details,
+    };
+}
+export function normalizeExtfnLikeError(error) {
+    if (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        "message" in error) {
+        const candidate = error;
+        return {
+            code: candidate.code,
+            message: candidate.message,
+            status: candidate.status ?? defaultStatusForCode(candidate.code),
+            retryable: candidate.retryable ?? false,
+            ...(candidate.details ? { details: candidate.details } : {}),
+        };
+    }
+    return createExtfnLikeError("E_RUNTIME_PROTOCOL", error instanceof Error ? error.message : "Runtime protocol failure.");
+}
+export function assertValidDatafnExtfnOptionShape(options) {
+    if (typeof options !== "object" || options === null) {
+        throw createExtfnLikeError("E_CONFIG_INVALID", "@datafn/extfn options must be an object.");
+    }
+    const optionRecord = options;
+    for (const key of Object.keys(optionRecord)) {
+        if (key === "authContext") {
+            throw createExtfnLikeError("E_CONFIG_INVALID", "@datafn/extfn option authContext is not part of the current public @datafn/client API.");
+        }
+        if (!ALLOWED_DATAFN_EXTFN_OPTION_KEYS.has(key)) {
+            throw createExtfnLikeError("E_CONFIG_INVALID", `Unsupported @datafn/extfn option: ${key}`);
+        }
+    }
+}
+export function createRequestEnvelope(input) {
+    const envelope = {
+        v: 1,
+        kind: "request",
+        ...input,
+    };
+    assertValidRequestEnvelope(envelope);
+    return envelope;
+}
+export function createSuccessResponseEnvelope(requestId, result) {
+    return {
+        v: 1,
+        kind: "response",
+        requestId,
+        ok: true,
+        result,
+    };
+}
+export function createErrorResponseEnvelope(requestId, error) {
+    return {
+        v: 1,
+        kind: "response",
+        requestId,
+        ok: false,
+        error,
+    };
+}
+export function createEventEnvelope(input) {
+    return {
+        v: 1,
+        kind: "event",
+        ...input,
+    };
+}
+export function assertValidRequestEnvelope(envelope) {
+    assertField(envelope.v === 1, "Request envelope is missing required field: v");
+    assertField(envelope.kind === "request", "Request envelope is missing required field: kind");
+    assertField(typeof envelope.requestId === "string" && envelope.requestId.length > 0, "Request envelope is missing required field: requestId");
+    assertField(typeof envelope.namespace === "string" && envelope.namespace.length > 0, "Request envelope is missing required field: namespace");
+    assertField(typeof envelope.method === "string" && envelope.method.length > 0, "Request envelope is missing required field: method");
+    assertField(Boolean(envelope.source), "Request envelope is missing required field: source");
+    assertField(Boolean(envelope.target), "Request envelope is missing required field: target");
+    if (!("payload" in envelope)) {
+        throw createExtfnLikeError("E_RUNTIME_PROTOCOL", "Request envelope is missing required field: payload");
+    }
+    return envelope;
+}
+export function toProxyId(address) {
+    return [
+        address.context,
+        address.surfaceId ?? "surface",
+        address.contentScriptId ?? "content",
+        address.tabId ?? "tab",
+        address.frameId ?? "frame",
+    ].join(":");
+}
+function assertField(condition, message) {
+    if (!condition) {
+        throw createExtfnLikeError("E_RUNTIME_PROTOCOL", message);
+    }
+}
+function defaultStatusForCode(code) {
+    switch (code) {
+        case "E_ENTRY_NOT_FOUND":
+            return 404;
+        case "E_HANDLER_NOT_FOUND":
+            return 404;
+        case "E_CONTEXT_UNAVAILABLE":
+            return 503;
+        case "E_TARGET_UNSUPPORTED":
+            return 422;
+        case "E_TIMEOUT":
+            return 504;
+        case "E_PAYLOAD_TOO_LARGE":
+            return 413;
+        case "E_PLUGIN_CONFLICT":
+            return 409;
+        case "E_RUNTIME_PROTOCOL":
+            return 500;
+        case "E_ANCHOR_RESOLUTION":
+            return 500;
+        case "E_MANIFEST_COLLISION":
+        case "E_CONFIG_INVALID":
+        default:
+            return 400;
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

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

package/dist/subscriptions.d.ts

@@ -0,0 +1,34 @@
+import type { EventFilter } from "@datafn/client";
+import type { DatafnEvent } from "@datafn/core";
+import { type ExtfnLikeError } from "./shared.js";
+export interface DatafnExtfnSubscriptionDelivery {
+    subscriptionId: string;
+    event: DatafnEvent;
+}
+export interface DatafnExtfnSubscriptionRegistration {
+    subscriptionId: string;
+    resumed: boolean;
+}
+export interface DatafnExtfnSubscriptionOptions {
+    filter?: EventFilter;
+    resumeSubscriptionId?: string;
+    deliver: (delivery: DatafnExtfnSubscriptionDelivery) => void | Promise<void>;
+    onFailure?: (error: ExtfnLikeError, subscriptionId: string) => void | Promise<void>;
+}
+export interface DatafnExtfnSubscriptionsOptions {
+    subscribe: (handler: (event: DatafnEvent) => void, filter?: EventFilter) => () => void;
+}
+export declare class DatafnExtfnSubscriptions {
+    private readonly options;
+    private active;
+    private recoverable;
+    private nextId;
+    constructor(options: DatafnExtfnSubscriptionsOptions);
+    subscribe(options: DatafnExtfnSubscriptionOptions): Promise<DatafnExtfnSubscriptionRegistration>;
+    unsubscribe(subscriptionId: string): Promise<void>;
+    handleBackgroundRestart(): Promise<void>;
+    closeAll(): Promise<void>;
+    getActiveSubscriptionCount(): number;
+    getRecoverableSubscriptionCount(): number;
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,mCAAmC;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,CACP,QAAQ,EAAE,+BAA+B,KACtC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,SAAS,CAAC,EAAE,CACV,KAAK,EAAE,cAAc,EACrB,cAAc,EAAE,MAAM,KACnB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,CACT,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EACrC,MAAM,CAAC,EAAE,WAAW,KACjB,MAAM,IAAI,CAAC;CACjB;AAaD,qBAAa,wBAAwB;IAKvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,MAAM,CAAK;gBAEU,OAAO,EAAE,+BAA+B;IAE/D,SAAS,CACb,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,mCAAmC,CAAC;IAgEzC,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBxC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,0BAA0B,IAAI,MAAM;IAIpC,+BAA+B,IAAI,MAAM;CAG1C"}

package/dist/subscriptions.js

@@ -0,0 +1,95 @@
+import { createExtfnLikeError, } from "./shared.js";
+export class DatafnExtfnSubscriptions {
+    options;
+    active = new Map();
+    recoverable = new Map();
+    nextId = 1;
+    constructor(options) {
+        this.options = options;
+    }
+    async subscribe(options) {
+        const resumable = options.resumeSubscriptionId !== undefined;
+        const subscriptionId = options.resumeSubscriptionId ?? `sub_${this.nextId++}`;
+        if (this.active.has(subscriptionId)) {
+            throw createExtfnLikeError("E_RUNTIME_PROTOCOL", "Duplicate DataFn subscription registration detected after reconnect.", { subscriptionId });
+        }
+        const recovered = resumable
+            ? this.recoverable.get(subscriptionId)
+            : undefined;
+        if (resumable && !recovered) {
+            throw createExtfnLikeError("E_RUNTIME_PROTOCOL", "Cannot resume unknown DataFn subscription.", { subscriptionId });
+        }
+        const filter = recovered?.filter ?? options.filter;
+        const unsubscribeAuthority = this.options.subscribe((event) => {
+            void Promise.resolve(options.deliver({
+                subscriptionId,
+                event,
+            })).catch(async (error) => {
+                if (options.onFailure) {
+                    try {
+                        await options.onFailure(normalizeDeliveryError(error, subscriptionId), subscriptionId);
+                    }
+                    catch {
+                        // Ignore onFailure handler errors so detached delivery work does not
+                        // surface unhandled rejections when callers use a best-effort hook.
+                    }
+                }
+            });
+        }, filter);
+        this.active.set(subscriptionId, {
+            filter,
+            deliver: options.deliver,
+            onFailure: options.onFailure,
+            unsubscribeAuthority,
+        });
+        if (recovered) {
+            this.recoverable.delete(subscriptionId);
+        }
+        return {
+            subscriptionId,
+            resumed: Boolean(recovered),
+        };
+    }
+    async unsubscribe(subscriptionId) {
+        const activeSubscription = this.active.get(subscriptionId);
+        if (activeSubscription) {
+            this.active.delete(subscriptionId);
+            activeSubscription.unsubscribeAuthority();
+        }
+        this.recoverable.delete(subscriptionId);
+    }
+    async handleBackgroundRestart() {
+        const activeSubscriptions = Array.from(this.active.entries());
+        this.active.clear();
+        await Promise.all(activeSubscriptions.map(async ([subscriptionId, subscription]) => {
+            subscription.unsubscribeAuthority();
+            this.recoverable.set(subscriptionId, {
+                filter: subscription.filter,
+            });
+            if (subscription.onFailure) {
+                await subscription.onFailure(createExtfnLikeError("E_RUNTIME_PROTOCOL", "DataFn background subscription state was reset.", { subscriptionId }), subscriptionId);
+            }
+        }));
+    }
+    async closeAll() {
+        for (const subscription of this.active.values()) {
+            subscription.unsubscribeAuthority();
+        }
+        this.active.clear();
+        this.recoverable.clear();
+    }
+    getActiveSubscriptionCount() {
+        return this.active.size;
+    }
+    getRecoverableSubscriptionCount() {
+        return this.recoverable.size;
+    }
+}
+function normalizeDeliveryError(error, subscriptionId) {
+    return error && typeof error === "object" && "code" in error && "message" in error
+        ? error
+        : createExtfnLikeError("E_RUNTIME_PROTOCOL", error instanceof Error
+            ? error.message
+            : "DataFn subscription delivery failed.", { subscriptionId });
+}
+//# sourceMappingURL=subscriptions.js.map

package/dist/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,GAErB,MAAM,aAAa,CAAC;AA0CrB,MAAM,OAAO,wBAAwB;IAKN;IAJrB,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC/C,WAAW,GAAG,IAAI,GAAG,EAAmC,CAAC;IACzD,MAAM,GAAG,CAAC,CAAC;IAEnB,YAA6B,OAAwC;QAAxC,YAAO,GAAP,OAAO,CAAiC;IAAG,CAAC;IAEzE,KAAK,CAAC,SAAS,CACb,OAAuC;QAEvC,MAAM,SAAS,GAAG,OAAO,CAAC,oBAAoB,KAAK,SAAS,CAAC;QAC7D,MAAM,cAAc,GAClB,OAAO,CAAC,oBAAoB,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAEzD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACpC,MAAM,oBAAoB,CACxB,oBAAoB,EACpB,sEAAsE,EACtE,EAAE,cAAc,EAAE,CACnB,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,SAAS;YACzB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC;YACtC,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,oBAAoB,CACxB,oBAAoB,EACpB,4CAA4C,EAC5C,EAAE,cAAc,EAAE,CACnB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;QACnD,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5D,KAAK,OAAO,CAAC,OAAO,CAClB,OAAO,CAAC,OAAO,CAAC;gBACd,cAAc;gBACd,KAAK;aACN,CAAC,CACH,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACtB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBACtB,IAAI,CAAC;wBACH,MAAM,OAAO,CAAC,SAAS,CACrB,sBAAsB,CAAC,KAAK,EAAE,cAAc,CAAC,EAC7C,cAAc,CACf,CAAC;oBACJ,CAAC;oBAAC,MAAM,CAAC;wBACP,qEAAqE;wBACrE,oEAAoE;oBACtE,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,MAAM,CAAC,CAAC;QAEX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE;YAC9B,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,oBAAoB;SACrB,CAAC,CAAC;QAEH,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO;YACL,cAAc;YACd,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;SAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,cAAsB;QACtC,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC3D,IAAI,kBAAkB,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YACnC,kBAAkB,CAAC,oBAAoB,EAAE,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,uBAAuB;QAC3B,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEpB,MAAM,OAAO,CAAC,GAAG,CACf,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC,EAAE,EAAE;YAC/D,YAAY,CAAC,oBAAoB,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE;gBACnC,MAAM,EAAE,YAAY,CAAC,MAAM;aAC5B,CAAC,CAAC;YAEH,IAAI,YAAY,CAAC,SAAS,EAAE,CAAC;gBAC3B,MAAM,YAAY,CAAC,SAAS,CAC1B,oBAAoB,CAClB,oBAAoB,EACpB,iDAAiD,EACjD,EAAE,cAAc,EAAE,CACnB,EACD,cAAc,CACf,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YAChD,YAAY,CAAC,oBAAoB,EAAE,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,0BAA0B;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,+BAA+B;QAC7B,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;CACF;AAED,SAAS,sBAAsB,CAC7B,KAAc,EACd,cAAsB;IAEtB,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK;QAChF,CAAC,CAAE,KAAwB;QAC3B,CAAC,CAAC,oBAAoB,CAClB,oBAAoB,EACpB,KAAK,YAAY,KAAK;YACpB,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,sCAAsC,EAC1C,EAAE,cAAc,EAAE,CACnB,CAAC;AACR,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@datafn/extfn",
+  "version": "0.1.0",
+  "description": "DataFn integration plugin and proxy client surface for extfn consumers",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "lint": "echo 'lint not configured'",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "datafn",
+    "extfn",
+    "browser-extension",
+    "superfunctions"
+  ],
+  "author": "21n",
+  "license": "MIT",
+  "dependencies": {
+    "@datafn/client": "0.0.3",
+    "@datafn/core": "0.0.3",
+    "@extfn/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.2.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/21nCo/super-functions.git",
+    "directory": "datafn/extfn"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}