@zmdb/svelte 1.0.0-beta.1

package/README.md

@@ -0,0 +1,82 @@
+# @zmdb/svelte
+
+`@zmdb/svelte` binds an application-generated zmdb client to Svelte's typed component context and projects query and mutation state through native stores. Queries start on their first subscription,
+abort after the final unsubscribe, restart on a later subscription, and suppress completions from superseded inputs.
+
+## Install
+
+```bash
+yarn add @zmdb/svelte@1.0.0-beta.1 svelte@^5.57.0
+```
+
+> **Prerelease** (`1.0.0-beta.1`). Requires **Node.js 26+**, Svelte 5, and ESM. Svelte is a required peer and is never bundled into the adapter.
+
+## Typed context
+
+Create one binding namespace for the generated client type:
+
+```ts
+// src/lib/zmdb.ts
+import { createZmdbSvelte } from '@zmdb/svelte';
+
+import type { ApiClient } from './generated/api.js';
+
+export const zmdb = createZmdbSvelte<ApiClient>();
+```
+
+Set the request- or tree-local client during provider component initialisation:
+
+```svelte
+<script lang="ts">
+  import { zmdb } from '$lib/zmdb.js';
+  import type { ApiClient } from '$lib/generated/api.js';
+
+  let { client, children }: { client: ApiClient; children: import('svelte').Snippet } = $props();
+  zmdb.setClient(client);
+</script>
+
+{@render children()}
+```
+
+Descendants retain every generated operation without a cast:
+
+```svelte
+<script lang="ts">
+  import { writable } from 'svelte/store';
+
+  import { zmdb } from '$lib/zmdb.js';
+
+  let { id }: { id: string } = $props();
+  const input = writable({ id });
+  const widget = zmdb.query(input, (client, value, signal) => client.getWidget(value, { signal }));
+  const rename = zmdb.mutation((client, value: { id: string; name: string }, signal) =>
+    client.renameWidget(value, { signal }),
+  );
+</script>
+
+{#if $widget.loading}
+  <p>Loading…</p>
+{:else if $widget.error}
+  <p>Could not load the widget.</p>
+{:else if $widget.data}
+  <h1>{$widget.data.name}</h1>
+{/if}
+
+<button onclick={() => rename.mutate({ id, name: 'Renamed' })} disabled={$rename.pending}>Rename</button>
+```
+
+An input store change clears data for the old identity, aborts that request, and starts the new one while subscribed. A generated-client error is placed in store state by identity; it is not wrapped
+or translated.
+
+## Direct store ownership
+
+`createQueryStore(client, input, load)` and `createMutationStore(client, run)` expose the same stores without component context. Query stores remain lazy. The last subscriber cancels active work; call
+`destroy()` as well when a non-component owner has a shorter lifetime than its subscriptions.
+
+## Documentation
+
+Full project documentation is at **https://ambasta.github.io/zmdb/**.
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later) — see [LICENSE](./LICENSE).

package/dist/context.d.ts

@@ -0,0 +1,3 @@
+import type { ZmdbSvelteBindings } from './types.js';
+export declare function createZmdbSvelte<Client>(): ZmdbSvelteBindings<Client>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAKV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAAC,MAAM,KAAK,kBAAkB,CAAC,MAAM,CAAC,CAqBrE"}

package/dist/context.js

@@ -0,0 +1,22 @@
+import { createContext, onDestroy } from 'svelte';
+import { createMutationStore } from './mutation.js';
+import { createQueryStore } from './query.js';
+export function createZmdbSvelte() {
+    const [getClient, setClient, hasClient] = createContext();
+    return Object.freeze({
+        getClient,
+        setClient,
+        hasClient,
+        query(input, load) {
+            const store = createQueryStore(getClient(), input, load);
+            onDestroy(store.destroy);
+            return store;
+        },
+        mutation(run) {
+            const store = createMutationStore(getClient(), run);
+            onDestroy(store.destroy);
+            return store;
+        },
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGlD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAS9C,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,aAAa,EAAU,CAAC;IAElE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS;QACT,SAAS;QACT,SAAS;QACT,KAAK,CACH,KAA8B,EAC9B,IAAwC;YAExC,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACzD,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,QAAQ,CAAgB,GAA0C;YAChE,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;YACpD,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+import { ClientError } from '@zmdb/client';
+export declare class SvelteAdapterError extends ClientError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/dist/errors.js

@@ -0,0 +1,8 @@
+import { ClientError } from '@zmdb/client';
+export class SvelteAdapterError extends ClientError {
+    constructor(message) {
+        super(message);
+        this.name = 'SvelteAdapterError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createZmdbSvelte } from './context.js';
+export { SvelteAdapterError } from './errors.js';
+export { createMutationStore } from './mutation.js';
+export { createQueryStore } from './query.js';
+export type { MutationRunner, MutationSnapshot, QueryLoader, QuerySnapshot, SvelteMutationStore, SvelteQueryStore, ZmdbSvelteBindings, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createZmdbSvelte } from './context.js';
+export { SvelteAdapterError } from './errors.js';
+export { createMutationStore } from './mutation.js';
+export { createQueryStore } from './query.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,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,3 @@
+export declare function lifecycleAbort(message: string): Error;
+export declare function isAbort(error: unknown, signal: AbortSignal): boolean;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAIrD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAEpE"}

package/dist/lifecycle.js

@@ -0,0 +1,9 @@
+export function lifecycleAbort(message) {
+    const reason = new Error(message);
+    reason.name = 'AbortError';
+    return reason;
+}
+export function isAbort(error, signal) {
+    return signal.aborted && Object.is(error, signal.reason);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,MAAmB;IACzD,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC3D,CAAC"}

package/dist/mutation.d.ts

@@ -0,0 +1,3 @@
+import type { MutationRunner, SvelteMutationStore } from './types.js';
+export declare function createMutationStore<Client, Input, Output>(client: Client, run: MutationRunner<Client, Input, Output>): SvelteMutationStore<Input, Output>;
+//# sourceMappingURL=mutation.d.ts.map

package/dist/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../src/mutation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOxF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EACvD,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GACzC,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CA6EpC"}

package/dist/mutation.js

@@ -0,0 +1,81 @@
+import { writable } from 'svelte/store';
+import { SvelteAdapterError } from './errors.js';
+import { isAbort, lifecycleAbort } from './lifecycle.js';
+export function createMutationStore(client, run) {
+    let snapshot = Object.freeze({ error: undefined, pending: false });
+    const state = writable(snapshot);
+    const requests = new Map();
+    let subscribers = 0;
+    let destroyed = false;
+    let epoch = 0;
+    let sequence = 0;
+    let latestSequence = 0;
+    const publish = (next) => {
+        snapshot = Object.freeze(next);
+        state.set(snapshot);
+    };
+    const pendingInCurrentEpoch = () => [...requests.values()].some(request => request.epoch === epoch);
+    const cancelActive = (reason) => {
+        epoch += 1;
+        const abortReason = lifecycleAbort(reason);
+        for (const request of requests.values()) {
+            if (!request.controller.signal.aborted)
+                request.controller.abort(abortReason);
+        }
+        if (snapshot.pending)
+            publish({ error: snapshot.error, pending: false });
+    };
+    const store = {
+        subscribe(runSubscriber, invalidate) {
+            subscribers += 1;
+            const unsubscribe = state.subscribe(runSubscriber, invalidate);
+            let subscribed = true;
+            return () => {
+                if (!subscribed)
+                    return;
+                subscribed = false;
+                unsubscribe();
+                subscribers -= 1;
+                if (subscribers === 0 && requests.size > 0) {
+                    cancelActive('@zmdb/svelte mutation cancelled after its final subscriber left');
+                }
+            };
+        },
+        async mutate(input) {
+            if (destroyed)
+                throw new SvelteAdapterError('@zmdb/svelte mutation store is destroyed');
+            const selectedEpoch = epoch;
+            const selectedSequence = ++sequence;
+            latestSequence = selectedSequence;
+            const controller = new AbortController();
+            requests.set(selectedSequence, { controller, epoch: selectedEpoch });
+            publish({ error: undefined, pending: true });
+            try {
+                return await run(client, input, controller.signal);
+            }
+            catch (error) {
+                if (!destroyed &&
+                    selectedEpoch === epoch &&
+                    selectedSequence === latestSequence &&
+                    !isAbort(error, controller.signal)) {
+                    publish({ error, pending: pendingInCurrentEpoch() });
+                }
+                throw error;
+            }
+            finally {
+                requests.delete(selectedSequence);
+                if (!destroyed && selectedEpoch === epoch) {
+                    publish({ error: snapshot.error, pending: pendingInCurrentEpoch() });
+                }
+            }
+        },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            cancelActive('@zmdb/svelte mutation cancelled because its owner was destroyed');
+        },
+    };
+    return Object.freeze(store);
+}
+//# sourceMappingURL=mutation.js.map

package/dist/mutation.js.map

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

package/dist/query.d.ts

@@ -0,0 +1,4 @@
+import type { Readable } from 'svelte/store';
+import type { QueryLoader, SvelteQueryStore } from './types.js';
+export declare function createQueryStore<Client, Input, Output>(client: Client, input: Input | Readable<Input>, load: QueryLoader<Client, Input, Output>): SvelteQueryStore<Output>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,cAAc,CAAC;AAI3D,OAAO,KAAK,EAAE,WAAW,EAAiB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgB/E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EACpD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,EAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GACvC,gBAAgB,CAAC,MAAM,CAAC,CA+H1B"}

package/dist/query.js

@@ -0,0 +1,134 @@
+import { writable } from 'svelte/store';
+import { SvelteAdapterError } from './errors.js';
+import { isAbort, lifecycleAbort } from './lifecycle.js';
+function property(value, name) {
+    return (typeof value === 'object' && value !== null) || typeof value === 'function'
+        ? Reflect.get(value, name)
+        : undefined;
+}
+function isReadable(value) {
+    return typeof property(value, 'subscribe') === 'function';
+}
+export function createQueryStore(client, input, load) {
+    let snapshot = Object.freeze({
+        data: undefined,
+        error: undefined,
+        loading: false,
+    });
+    const state = writable(snapshot);
+    let subscribers = 0;
+    let active = false;
+    let destroyed = false;
+    let generation = 0;
+    let request;
+    let inputUnsubscribe;
+    let currentInput;
+    const publish = (next) => {
+        snapshot = Object.freeze(next);
+        state.set(snapshot);
+    };
+    const abortSelected = (reason) => {
+        const selected = request;
+        request = undefined;
+        if (selected !== undefined && !selected.controller.signal.aborted)
+            selected.controller.abort(reason);
+    };
+    const launch = async (selectedInput, clearData, reason) => {
+        if (destroyed)
+            throw new SvelteAdapterError('@zmdb/svelte query store is destroyed');
+        if (!active)
+            throw new SvelteAdapterError('@zmdb/svelte query store is inactive; subscribe before refreshing');
+        abortSelected(lifecycleAbort(reason));
+        const selectedGeneration = ++generation;
+        const controller = new AbortController();
+        request = { controller };
+        publish({
+            data: clearData ? undefined : snapshot.data,
+            error: undefined,
+            loading: true,
+        });
+        try {
+            const data = await load(client, selectedInput, controller.signal);
+            if (!active || destroyed || selectedGeneration !== generation)
+                return;
+            request = undefined;
+            publish({ data, error: undefined, loading: false });
+        }
+        catch (error) {
+            if (active && !destroyed && selectedGeneration === generation) {
+                request = undefined;
+                if (!isAbort(error, controller.signal)) {
+                    publish({ data: snapshot.data, error, loading: false });
+                }
+            }
+            throw error;
+        }
+    };
+    const startForInput = (selectedInput) => {
+        const changed = currentInput !== undefined && !Object.is(currentInput.value, selectedInput);
+        currentInput = { value: selectedInput };
+        void launch(selectedInput, changed, changed
+            ? '@zmdb/svelte query superseded by an input-store change'
+            : '@zmdb/svelte query restarted for a new subscription').catch(() => undefined);
+    };
+    const activate = () => {
+        if (active || destroyed)
+            return;
+        active = true;
+        if (isReadable(input)) {
+            inputUnsubscribe = input.subscribe(startForInput);
+        }
+        else {
+            startForInput(input);
+        }
+    };
+    const deactivate = (reason) => {
+        if (!active)
+            return;
+        active = false;
+        generation += 1;
+        inputUnsubscribe?.();
+        inputUnsubscribe = undefined;
+        abortSelected(lifecycleAbort(reason));
+        if (snapshot.loading)
+            publish({ data: snapshot.data, error: snapshot.error, loading: false });
+    };
+    const store = {
+        subscribe(run, invalidate) {
+            if (subscribers === 0)
+                activate();
+            subscribers += 1;
+            const unsubscribe = state.subscribe(run, invalidate);
+            let subscribed = true;
+            return () => {
+                if (!subscribed)
+                    return;
+                subscribed = false;
+                unsubscribe();
+                subscribers -= 1;
+                if (subscribers === 0) {
+                    deactivate('@zmdb/svelte query cancelled after its final subscriber left');
+                }
+            };
+        },
+        refresh() {
+            if (!active) {
+                return Promise.reject(new SvelteAdapterError(destroyed
+                    ? '@zmdb/svelte query store is destroyed'
+                    : '@zmdb/svelte query store is inactive; subscribe before refreshing'));
+            }
+            if (currentInput === undefined) {
+                return Promise.reject(new SvelteAdapterError('@zmdb/svelte query store has no current input'));
+            }
+            return launch(currentInput.value, false, '@zmdb/svelte query superseded by refresh');
+        },
+        destroy() {
+            if (destroyed)
+                return;
+            destroyed = true;
+            deactivate('@zmdb/svelte query cancelled because its owner was destroyed');
+        },
+    };
+    return Object.freeze(store);
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+import type { Readable } from 'svelte/store';
+export type QueryLoader<Client, Input, Output> = (client: Client, input: Input, signal: AbortSignal) => PromiseLike<Output>;
+export type MutationRunner<Client, Input, Output> = (client: Client, input: Input, signal: AbortSignal) => PromiseLike<Output>;
+export interface QuerySnapshot<Output> {
+    readonly data: Output | undefined;
+    readonly error: unknown;
+    readonly loading: boolean;
+}
+export interface MutationSnapshot {
+    readonly error: unknown;
+    readonly pending: boolean;
+}
+export interface SvelteQueryStore<Output> extends Readable<QuerySnapshot<Output>> {
+    refresh(): Promise<void>;
+    destroy(): void;
+}
+export interface SvelteMutationStore<Input, Output> extends Readable<MutationSnapshot> {
+    mutate(input: Input): Promise<Output>;
+    destroy(): void;
+}
+export interface ZmdbSvelteBindings<Client> {
+    getClient(): Client;
+    setClient(client: Client): Client;
+    hasClient(): boolean;
+    query<Input, Output>(input: Input | Readable<Input>, load: QueryLoader<Client, Input, Output>): SvelteQueryStore<Output>;
+    mutation<Input, Output>(run: MutationRunner<Client, Input, Output>): SvelteMutationStore<Input, Output>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,CAC/C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,KAChB,WAAW,CAAC,MAAM,CAAC,CAAC;AAEzB,MAAM,MAAM,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,CAClD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,KAChB,WAAW,CAAC,MAAM,CAAC,CAAC;AAEzB,MAAM,WAAW,aAAa,CAAC,MAAM;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB,CAAC,MAAM,CAAE,SAAQ,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAE,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;IACpF,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB,CAAC,MAAM;IACxC,SAAS,IAAI,MAAM,CAAC;IACpB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,SAAS,IAAI,OAAO,CAAC;IACrB,KAAK,CAAC,KAAK,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,EAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GACvC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;CACzG"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@zmdb/svelte",
+  "version": "1.0.0-beta.1",
+  "description": "Typed Svelte context, lazy query stores, mutation stores, and lifecycle cancellation for generated zmdb clients.",
+  "keywords": [
+    "client",
+    "stores",
+    "svelte",
+    "typescript",
+    "zmdb"
+  ],
+  "homepage": "https://github.com/ambasta/zmdb#readme",
+  "bugs": {
+    "url": "https://github.com/ambasta/zmdb/issues"
+  },
+  "license": "GPL-3.0-or-later",
+  "author": "zmdb contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambasta/zmdb.git",
+    "directory": "packages/svelte"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@zmdb/client": "1.0.0-beta.1"
+  },
+  "peerDependencies": {
+    "svelte": ">=5.57.0 <6.0.0"
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/src/context.ts

@@ -0,0 +1,35 @@
+import { createContext, onDestroy } from 'svelte';
+import type { Readable } from 'svelte/store';
+
+import { createMutationStore } from './mutation.js';
+import { createQueryStore } from './query.js';
+import type {
+  MutationRunner,
+  QueryLoader,
+  SvelteMutationStore,
+  SvelteQueryStore,
+  ZmdbSvelteBindings,
+} from './types.js';
+
+export function createZmdbSvelte<Client>(): ZmdbSvelteBindings<Client> {
+  const [getClient, setClient, hasClient] = createContext<Client>();
+
+  return Object.freeze({
+    getClient,
+    setClient,
+    hasClient,
+    query<Input, Output>(
+      input: Input | Readable<Input>,
+      load: QueryLoader<Client, Input, Output>,
+    ): SvelteQueryStore<Output> {
+      const store = createQueryStore(getClient(), input, load);
+      onDestroy(store.destroy);
+      return store;
+    },
+    mutation<Input, Output>(run: MutationRunner<Client, Input, Output>): SvelteMutationStore<Input, Output> {
+      const store = createMutationStore(getClient(), run);
+      onDestroy(store.destroy);
+      return store;
+    },
+  });
+}

package/src/errors.ts

@@ -0,0 +1,8 @@
+import { ClientError } from '@zmdb/client';
+
+export class SvelteAdapterError extends ClientError {
+  constructor(message: string) {
+    super(message);
+    this.name = 'SvelteAdapterError';
+  }
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export { createZmdbSvelte } from './context.js';
+export { SvelteAdapterError } from './errors.js';
+export { createMutationStore } from './mutation.js';
+export { createQueryStore } from './query.js';
+export type {
+  MutationRunner,
+  MutationSnapshot,
+  QueryLoader,
+  QuerySnapshot,
+  SvelteMutationStore,
+  SvelteQueryStore,
+  ZmdbSvelteBindings,
+} from './types.js';

package/src/lifecycle.ts

@@ -0,0 +1,9 @@
+export function lifecycleAbort(message: string): Error {
+  const reason = new Error(message);
+  reason.name = 'AbortError';
+  return reason;
+}
+
+export function isAbort(error: unknown, signal: AbortSignal): boolean {
+  return signal.aborted && Object.is(error, signal.reason);
+}