@zmdb/sveltekit 1.0.0-beta.1

package/README.md

@@ -0,0 +1,87 @@
+# @zmdb/sveltekit
+
+`@zmdb/sveltekit` creates request-local generated clients from SvelteKit's `event.fetch`, provides typed server and browser load helpers, forwards only allow-listed credentials, and reuses the native
+stores from `@zmdb/svelte`.
+
+## Install
+
+```bash
+yarn add @zmdb/client@1.0.0-beta.1 @zmdb/svelte@1.0.0-beta.1 @zmdb/sveltekit@1.0.0-beta.1 @sveltejs/kit@^2.70.3 svelte@^5.57.0
+```
+
+> **Prerelease** (`1.0.0-beta.1`). Requires **Node.js 26+**, SvelteKit 2.70, Svelte 5, and ESM.
+
+## Server loads
+
+Create one generated client for each request. Nothing is forwarded unless its name appears in the explicit allow-list:
+
+```ts
+import { createSvelteKitServerLoad } from '@zmdb/sveltekit/server';
+
+import { createApiClient } from '$lib/generated/api.js';
+import type { PageServerLoad } from './$types.js';
+
+export const load = createSvelteKitServerLoad({
+  key: 'account:current',
+  createClient: createApiClient,
+  clientOptions: {
+    baseUrl: '/api',
+    forward: {
+      headers: ['authorization'],
+      cookies: ['session'],
+    },
+  },
+  load: async (client, _event, signal) => ({
+    account: await client.getCurrentAccount({}, { signal }),
+  }),
+}) satisfies PageServerLoad;
+```
+
+The helper uses the current `event.fetch`, calls `depends` with the stable key, and passes `event.request.signal`. Redirects, status errors, abort reasons, and generated-client errors are never
+wrapped.
+
+## Browser navigation
+
+The browser entry uses the current universal `LoadEvent.fetch` and re-exports the Svelte context and store primitives:
+
+```ts
+import { createSvelteKitClientLoad, createSvelteKitNavigationScope, createZmdbSvelte } from '@zmdb/sveltekit/client';
+
+import { createApiClient } from '$lib/generated/api.js';
+
+export const navigation = createSvelteKitNavigationScope();
+export const zmdb = createZmdbSvelte<ReturnType<typeof createApiClient>>();
+
+export const loadAccount = createSvelteKitClientLoad({
+  key: 'account:current',
+  navigation,
+  createClient: createApiClient,
+  clientOptions: { baseUrl: '/api' },
+  load: async (client, _event, signal) => ({
+    account: await client.getCurrentAccount({}, { signal }),
+  }),
+});
+```
+
+Track SvelteKit's native navigation from a mounted root layout:
+
+```svelte
+<script lang="ts">
+  import { onNavigate } from '$app/navigation';
+  import { navigation } from '$lib/zmdb.js';
+
+  onNavigate(value => {
+    navigation.track(value);
+  });
+</script>
+```
+
+If SvelteKit rejects `navigation.complete`, active generated-client work aborts with that exact rejection as its signal reason.
+
+## 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/client.d.ts

@@ -0,0 +1,22 @@
+import type { LoadEvent, OnNavigate } from '@sveltejs/kit';
+import type { GeneratedClientFactory, SvelteKitClientOptions } from './shared.js';
+export { createMutationStore, createQueryStore, createZmdbSvelte } from '@zmdb/svelte';
+export type { MutationRunner, MutationSnapshot, QueryLoader, QuerySnapshot, SvelteMutationStore, SvelteQueryStore, ZmdbSvelteBindings, } from '@zmdb/svelte';
+export { SvelteKitAdapterError } from './errors.js';
+export type { GeneratedClientFactory, SvelteKitClientOptions } from './shared.js';
+export type SvelteKitClientLoadEvent = Pick<LoadEvent, 'depends' | 'fetch'>;
+export interface SvelteKitNavigationScope {
+    readonly signal: AbortSignal | undefined;
+    track(navigation: Pick<OnNavigate, 'complete'>): AbortSignal;
+}
+export interface SvelteKitClientLoadDefinition<Client, Event extends SvelteKitClientLoadEvent, Output> {
+    readonly key: `${string}:${string}`;
+    readonly navigation: SvelteKitNavigationScope;
+    readonly createClient: GeneratedClientFactory<Client>;
+    readonly clientOptions: SvelteKitClientOptions;
+    readonly load: (client: Client, event: Event, signal: AbortSignal) => PromiseLike<Output>;
+}
+export declare function createSvelteKitBrowserClient<Client>(event: Pick<LoadEvent, 'fetch'>, createClient: GeneratedClientFactory<Client>, options: SvelteKitClientOptions): Client;
+export declare function createSvelteKitNavigationScope(): SvelteKitNavigationScope;
+export declare function createSvelteKitClientLoad<Client, Event extends SvelteKitClientLoadEvent, Output>(definition: SvelteKitClientLoadDefinition<Client, Event, Output>): (event: Event) => Promise<Output>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvF,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;AAE5E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,WAAW,CAAC;CAC9D;AAED,MAAM,WAAW,6BAA6B,CAAC,MAAM,EAAE,KAAK,SAAS,wBAAwB,EAAE,MAAM;IACnG,QAAQ,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,KAAK,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3F;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EACjD,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAC5C,OAAO,EAAE,sBAAsB,GAC9B,MAAM,CAKR;AAED,wBAAgB,8BAA8B,IAAI,wBAAwB,CA4BzE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,KAAK,SAAS,wBAAwB,EAAE,MAAM,EAC9F,UAAU,EAAE,6BAA6B,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAC/D,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,CAWnC"}

package/dist/client.js

@@ -0,0 +1,46 @@
+import { createFetchTransport } from '@zmdb/client';
+import { SvelteKitAdapterError } from './errors.js';
+export { createMutationStore, createQueryStore, createZmdbSvelte } from '@zmdb/svelte';
+export { SvelteKitAdapterError } from './errors.js';
+export function createSvelteKitBrowserClient(event, createClient, options) {
+    return createClient({
+        ...options,
+        transport: createFetchTransport(event.fetch),
+    });
+}
+export function createSvelteKitNavigationScope() {
+    let current;
+    const clear = (selected) => {
+        if (Object.is(current, selected))
+            current = undefined;
+    };
+    const scope = {
+        get signal() {
+            return current?.signal;
+        },
+        track(navigation) {
+            const controller = new AbortController();
+            current = controller;
+            void navigation.complete.then(() => {
+                clear(controller);
+            }, (reason) => {
+                controller.abort(reason);
+                clear(controller);
+            });
+            return controller.signal;
+        },
+    };
+    return Object.freeze(scope);
+}
+export function createSvelteKitClientLoad(definition) {
+    if (!definition.key.includes(':')) {
+        throw new SvelteKitAdapterError('@zmdb/sveltekit client load keys must contain a namespace prefix');
+    }
+    return async (event) => {
+        event.depends(definition.key);
+        const client = createSvelteKitBrowserClient(event, definition.createClient, definition.clientOptions);
+        const signal = definition.navigation.signal ?? new AbortController().signal;
+        return definition.load(client, event, signal);
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAUvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAkBpD,MAAM,UAAU,4BAA4B,CAC1C,KAA+B,EAC/B,YAA4C,EAC5C,OAA+B;IAE/B,OAAO,YAAY,CAAC;QAClB,GAAG,OAAO;QACV,SAAS,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,IAAI,OAAoC,CAAC;IAEzC,MAAM,KAAK,GAAG,CAAC,QAAyB,EAAQ,EAAE;QAChD,IAAI,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;YAAE,OAAO,GAAG,SAAS,CAAC;IACxD,CAAC,CAAC;IAEF,MAAM,KAAK,GAA6B;QACtC,IAAI,MAAM;YACR,OAAO,OAAO,EAAE,MAAM,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,UAAwC;YAC5C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,OAAO,GAAG,UAAU,CAAC;YACrB,KAAK,UAAU,CAAC,QAAQ,CAAC,IAAI,CAC3B,GAAG,EAAE;gBACH,KAAK,CAAC,UAAU,CAAC,CAAC;YACpB,CAAC,EACD,CAAC,MAAe,EAAE,EAAE;gBAClB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACzB,KAAK,CAAC,UAAU,CAAC,CAAC;YACpB,CAAC,CACF,CAAC;YACF,OAAO,UAAU,CAAC,MAAM,CAAC;QAC3B,CAAC;KACF,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAgE;IAEhE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,qBAAqB,CAAC,kEAAkE,CAAC,CAAC;IACtG,CAAC;IAED,OAAO,KAAK,EAAC,KAAK,EAAC,EAAE;QACnB,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,EAAE,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;QACtG,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;QAC5E,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+import { ClientError } from '@zmdb/client';
+export declare class SvelteKitAdapterError 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,qBAAsB,SAAQ,WAAW;IACpD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/dist/errors.js

@@ -0,0 +1,8 @@
+import { ClientError } from '@zmdb/client';
+export class SvelteKitAdapterError extends ClientError {
+    constructor(message) {
+        super(message);
+        this.name = 'SvelteKitAdapterError';
+    }
+}
+//# 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,qBAAsB,SAAQ,WAAW;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/server.d.ts

@@ -0,0 +1,24 @@
+import type { RequestEvent, ServerLoadEvent } from '@sveltejs/kit';
+import type { ClientOptions } from '@zmdb/client';
+import type { GeneratedClientFactory } from './shared.js';
+export { SvelteKitAdapterError } from './errors.js';
+export type { GeneratedClientFactory, SvelteKitClientOptions } from './shared.js';
+export type SvelteKitRequestEvent = Pick<RequestEvent, 'cookies' | 'fetch' | 'request'>;
+export type SvelteKitServerLoadEvent = SvelteKitRequestEvent & Pick<ServerLoadEvent, 'depends'>;
+export interface SvelteKitForwarding {
+    readonly headers?: readonly string[];
+    readonly cookies?: readonly string[];
+}
+export interface SvelteKitServerClientOptions extends Omit<ClientOptions, 'transport'> {
+    readonly forward?: SvelteKitForwarding;
+}
+export interface SvelteKitServerLoadDefinition<Client, Event extends SvelteKitServerLoadEvent, Output> {
+    readonly key: `${string}:${string}`;
+    readonly createClient: GeneratedClientFactory<Client>;
+    readonly clientOptions: SvelteKitServerClientOptions;
+    readonly load: (client: Client, event: Event, signal: AbortSignal) => PromiseLike<Output>;
+}
+export declare function createSvelteKitServerFetch(event: SvelteKitRequestEvent, forwarding?: SvelteKitForwarding): typeof globalThis.fetch;
+export declare function createSvelteKitServerClient<Client>(event: SvelteKitRequestEvent, createClient: GeneratedClientFactory<Client>, options: SvelteKitServerClientOptions): Client;
+export declare function createSvelteKitServerLoad<Client, Event extends SvelteKitServerLoadEvent, Output>(definition: SvelteKitServerLoadDefinition<Client, Event, Output>): (event: Event) => Promise<Output>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;AAEhG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC;IACpF,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,6BAA6B,CAAC,MAAM,EAAE,KAAK,SAAS,wBAAwB,EAAE,MAAM;IACnG,QAAQ,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,KAAK,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3F;AAgED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,qBAAqB,EAC5B,UAAU,GAAE,mBAAwB,GACnC,OAAO,UAAU,CAAC,KAAK,CAqBzB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAChD,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAC5C,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAMR;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,KAAK,SAAS,wBAAwB,EAAE,MAAM,EAC9F,UAAU,EAAE,6BAA6B,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,GAC/D,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,CAUnC"}

package/dist/server.js

@@ -0,0 +1,98 @@
+import { createFetchTransport } from '@zmdb/client';
+import { SvelteKitAdapterError } from './errors.js';
+export { SvelteKitAdapterError } from './errors.js';
+const COOKIE_NAME = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+function uniqueHeaderNames(names) {
+    const selected = [];
+    const seen = new Set();
+    for (const candidate of names) {
+        const probe = new Headers();
+        probe.set(candidate, 'probe');
+        const name = candidate.toLowerCase();
+        if (name === 'cookie' || name === 'set-cookie') {
+            throw new SvelteKitAdapterError(`@zmdb/sveltekit forwards ${name} only through the explicit cookie allow-list`);
+        }
+        if (!seen.has(name)) {
+            seen.add(name);
+            selected.push(name);
+        }
+    }
+    return Object.freeze(selected);
+}
+function uniqueCookieNames(names) {
+    const selected = [];
+    const seen = new Set();
+    for (const name of names) {
+        if (!COOKIE_NAME.test(name)) {
+            throw new SvelteKitAdapterError(`@zmdb/sveltekit cannot forward invalid cookie name ${JSON.stringify(name)}`);
+        }
+        if (!seen.has(name)) {
+            seen.add(name);
+            selected.push(name);
+        }
+    }
+    return Object.freeze(selected);
+}
+function outgoingHeaders(input, init) {
+    const headers = new Headers(input instanceof Request ? input.headers : undefined);
+    if (init?.headers !== undefined) {
+        for (const [name, value] of new Headers(init.headers))
+            headers.set(name, value);
+    }
+    return headers;
+}
+function setForwardedHeader(headers, name, value) {
+    const existing = headers.get(name);
+    if (existing !== null && existing !== value) {
+        throw new SvelteKitAdapterError(`@zmdb/sveltekit refused to replace generated-client header ${name} while forwarding the request event`);
+    }
+    headers.set(name, value);
+}
+function selectedCookieHeader(event, names) {
+    const pairs = [];
+    for (const name of names) {
+        const value = event.cookies.get(name);
+        if (value !== undefined)
+            pairs.push(`${name}=${encodeURIComponent(value)}`);
+    }
+    return pairs.join('; ');
+}
+export function createSvelteKitServerFetch(event, forwarding = {}) {
+    const headerNames = uniqueHeaderNames(forwarding.headers ?? []);
+    const cookieNames = uniqueCookieNames(forwarding.cookies ?? []);
+    const fetch = async (input, init) => {
+        const headers = outgoingHeaders(input, init);
+        for (const name of headerNames) {
+            const value = event.request.headers.get(name);
+            if (value !== null)
+                setForwardedHeader(headers, name, value);
+        }
+        const cookie = selectedCookieHeader(event, cookieNames);
+        if (cookie !== '')
+            setForwardedHeader(headers, 'cookie', cookie);
+        return event.fetch(input, {
+            ...init,
+            credentials: 'omit',
+            headers,
+        });
+    };
+    return fetch;
+}
+export function createSvelteKitServerClient(event, createClient, options) {
+    const { forward, ...clientOptions } = options;
+    return createClient({
+        ...clientOptions,
+        transport: createFetchTransport(createSvelteKitServerFetch(event, forward)),
+    });
+}
+export function createSvelteKitServerLoad(definition) {
+    if (!definition.key.includes(':')) {
+        throw new SvelteKitAdapterError('@zmdb/sveltekit server load keys must contain a namespace prefix');
+    }
+    return async (event) => {
+        event.depends(definition.key);
+        const client = createSvelteKitServerClient(event, definition.createClient, definition.clientOptions);
+        return definition.load(client, event, event.request.signal);
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/shared.d.ts

@@ -0,0 +1,4 @@
+import type { ClientOptions } from '@zmdb/client';
+export type GeneratedClientFactory<Client> = (options: ClientOptions) => Client;
+export type SvelteKitClientOptions = Omit<ClientOptions, 'transport'>;
+//# 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,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,MAAM,sBAAsB,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC;AAEhF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC"}

package/dist/shared.js

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

package/dist/shared.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@zmdb/sveltekit",
+  "version": "1.0.0-beta.1",
+  "description": "Request-local SvelteKit clients, typed load helpers, explicit credential forwarding, and navigation cancellation for generated zmdb clients.",
+  "keywords": [
+    "client",
+    "load",
+    "svelte",
+    "sveltekit",
+    "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/sveltekit"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@zmdb/client": "1.0.0-beta.1",
+    "@zmdb/svelte": "1.0.0-beta.1"
+  },
+  "peerDependencies": {
+    "@sveltejs/kit": ">=2.70.3 <3.0.0",
+    "svelte": ">=5.57.0 <6.0.0"
+  },
+  "engines": {
+    "node": ">=26"
+  }
+}

package/src/client.ts

@@ -0,0 +1,89 @@
+import type { LoadEvent, OnNavigate } from '@sveltejs/kit';
+import { createFetchTransport } from '@zmdb/client';
+
+import { SvelteKitAdapterError } from './errors.js';
+import type { GeneratedClientFactory, SvelteKitClientOptions } from './shared.js';
+
+export { createMutationStore, createQueryStore, createZmdbSvelte } from '@zmdb/svelte';
+export type {
+  MutationRunner,
+  MutationSnapshot,
+  QueryLoader,
+  QuerySnapshot,
+  SvelteMutationStore,
+  SvelteQueryStore,
+  ZmdbSvelteBindings,
+} from '@zmdb/svelte';
+export { SvelteKitAdapterError } from './errors.js';
+export type { GeneratedClientFactory, SvelteKitClientOptions } from './shared.js';
+
+export type SvelteKitClientLoadEvent = Pick<LoadEvent, 'depends' | 'fetch'>;
+
+export interface SvelteKitNavigationScope {
+  readonly signal: AbortSignal | undefined;
+  track(navigation: Pick<OnNavigate, 'complete'>): AbortSignal;
+}
+
+export interface SvelteKitClientLoadDefinition<Client, Event extends SvelteKitClientLoadEvent, Output> {
+  readonly key: `${string}:${string}`;
+  readonly navigation: SvelteKitNavigationScope;
+  readonly createClient: GeneratedClientFactory<Client>;
+  readonly clientOptions: SvelteKitClientOptions;
+  readonly load: (client: Client, event: Event, signal: AbortSignal) => PromiseLike<Output>;
+}
+
+export function createSvelteKitBrowserClient<Client>(
+  event: Pick<LoadEvent, 'fetch'>,
+  createClient: GeneratedClientFactory<Client>,
+  options: SvelteKitClientOptions,
+): Client {
+  return createClient({
+    ...options,
+    transport: createFetchTransport(event.fetch),
+  });
+}
+
+export function createSvelteKitNavigationScope(): SvelteKitNavigationScope {
+  let current: AbortController | undefined;
+
+  const clear = (selected: AbortController): void => {
+    if (Object.is(current, selected)) current = undefined;
+  };
+
+  const scope: SvelteKitNavigationScope = {
+    get signal() {
+      return current?.signal;
+    },
+    track(navigation: Pick<OnNavigate, 'complete'>) {
+      const controller = new AbortController();
+      current = controller;
+      void navigation.complete.then(
+        () => {
+          clear(controller);
+        },
+        (reason: unknown) => {
+          controller.abort(reason);
+          clear(controller);
+        },
+      );
+      return controller.signal;
+    },
+  };
+
+  return Object.freeze(scope);
+}
+
+export function createSvelteKitClientLoad<Client, Event extends SvelteKitClientLoadEvent, Output>(
+  definition: SvelteKitClientLoadDefinition<Client, Event, Output>,
+): (event: Event) => Promise<Output> {
+  if (!definition.key.includes(':')) {
+    throw new SvelteKitAdapterError('@zmdb/sveltekit client load keys must contain a namespace prefix');
+  }
+
+  return async event => {
+    event.depends(definition.key);
+    const client = createSvelteKitBrowserClient(event, definition.createClient, definition.clientOptions);
+    const signal = definition.navigation.signal ?? new AbortController().signal;
+    return definition.load(client, event, signal);
+  };
+}

package/src/errors.ts

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

package/src/server.ts

@@ -0,0 +1,143 @@
+import type { RequestEvent, ServerLoadEvent } from '@sveltejs/kit';
+import { createFetchTransport } from '@zmdb/client';
+import type { ClientOptions } from '@zmdb/client';
+
+import { SvelteKitAdapterError } from './errors.js';
+import type { GeneratedClientFactory } from './shared.js';
+
+export { SvelteKitAdapterError } from './errors.js';
+export type { GeneratedClientFactory, SvelteKitClientOptions } from './shared.js';
+
+export type SvelteKitRequestEvent = Pick<RequestEvent, 'cookies' | 'fetch' | 'request'>;
+
+export type SvelteKitServerLoadEvent = SvelteKitRequestEvent & Pick<ServerLoadEvent, 'depends'>;
+
+export interface SvelteKitForwarding {
+  readonly headers?: readonly string[];
+  readonly cookies?: readonly string[];
+}
+
+export interface SvelteKitServerClientOptions extends Omit<ClientOptions, 'transport'> {
+  readonly forward?: SvelteKitForwarding;
+}
+
+export interface SvelteKitServerLoadDefinition<Client, Event extends SvelteKitServerLoadEvent, Output> {
+  readonly key: `${string}:${string}`;
+  readonly createClient: GeneratedClientFactory<Client>;
+  readonly clientOptions: SvelteKitServerClientOptions;
+  readonly load: (client: Client, event: Event, signal: AbortSignal) => PromiseLike<Output>;
+}
+
+const COOKIE_NAME = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+
+function uniqueHeaderNames(names: readonly string[]): readonly string[] {
+  const selected: string[] = [];
+  const seen = new Set<string>();
+  for (const candidate of names) {
+    const probe = new Headers();
+    probe.set(candidate, 'probe');
+    const name = candidate.toLowerCase();
+    if (name === 'cookie' || name === 'set-cookie') {
+      throw new SvelteKitAdapterError(`@zmdb/sveltekit forwards ${name} only through the explicit cookie allow-list`);
+    }
+    if (!seen.has(name)) {
+      seen.add(name);
+      selected.push(name);
+    }
+  }
+  return Object.freeze(selected);
+}
+
+function uniqueCookieNames(names: readonly string[]): readonly string[] {
+  const selected: string[] = [];
+  const seen = new Set<string>();
+  for (const name of names) {
+    if (!COOKIE_NAME.test(name)) {
+      throw new SvelteKitAdapterError(`@zmdb/sveltekit cannot forward invalid cookie name ${JSON.stringify(name)}`);
+    }
+    if (!seen.has(name)) {
+      seen.add(name);
+      selected.push(name);
+    }
+  }
+  return Object.freeze(selected);
+}
+
+function outgoingHeaders(input: RequestInfo | URL, init: RequestInit | undefined): Headers {
+  const headers = new Headers(input instanceof Request ? input.headers : undefined);
+  if (init?.headers !== undefined) {
+    for (const [name, value] of new Headers(init.headers)) headers.set(name, value);
+  }
+  return headers;
+}
+
+function setForwardedHeader(headers: Headers, name: string, value: string): void {
+  const existing = headers.get(name);
+  if (existing !== null && existing !== value) {
+    throw new SvelteKitAdapterError(
+      `@zmdb/sveltekit refused to replace generated-client header ${name} while forwarding the request event`,
+    );
+  }
+  headers.set(name, value);
+}
+
+function selectedCookieHeader(event: SvelteKitRequestEvent, names: readonly string[]): string {
+  const pairs: string[] = [];
+  for (const name of names) {
+    const value = event.cookies.get(name);
+    if (value !== undefined) pairs.push(`${name}=${encodeURIComponent(value)}`);
+  }
+  return pairs.join('; ');
+}
+
+export function createSvelteKitServerFetch(
+  event: SvelteKitRequestEvent,
+  forwarding: SvelteKitForwarding = {},
+): typeof globalThis.fetch {
+  const headerNames = uniqueHeaderNames(forwarding.headers ?? []);
+  const cookieNames = uniqueCookieNames(forwarding.cookies ?? []);
+
+  const fetch: typeof globalThis.fetch = async (input, init) => {
+    const headers = outgoingHeaders(input, init);
+    for (const name of headerNames) {
+      const value = event.request.headers.get(name);
+      if (value !== null) setForwardedHeader(headers, name, value);
+    }
+    const cookie = selectedCookieHeader(event, cookieNames);
+    if (cookie !== '') setForwardedHeader(headers, 'cookie', cookie);
+
+    return event.fetch(input, {
+      ...init,
+      credentials: 'omit',
+      headers,
+    });
+  };
+
+  return fetch;
+}
+
+export function createSvelteKitServerClient<Client>(
+  event: SvelteKitRequestEvent,
+  createClient: GeneratedClientFactory<Client>,
+  options: SvelteKitServerClientOptions,
+): Client {
+  const { forward, ...clientOptions } = options;
+  return createClient({
+    ...clientOptions,
+    transport: createFetchTransport(createSvelteKitServerFetch(event, forward)),
+  });
+}
+
+export function createSvelteKitServerLoad<Client, Event extends SvelteKitServerLoadEvent, Output>(
+  definition: SvelteKitServerLoadDefinition<Client, Event, Output>,
+): (event: Event) => Promise<Output> {
+  if (!definition.key.includes(':')) {
+    throw new SvelteKitAdapterError('@zmdb/sveltekit server load keys must contain a namespace prefix');
+  }
+
+  return async event => {
+    event.depends(definition.key);
+    const client = createSvelteKitServerClient(event, definition.createClient, definition.clientOptions);
+    return definition.load(client, event, event.request.signal);
+  };
+}

package/src/shared.ts

@@ -0,0 +1,5 @@
+import type { ClientOptions } from '@zmdb/client';
+
+export type GeneratedClientFactory<Client> = (options: ClientOptions) => Client;
+
+export type SvelteKitClientOptions = Omit<ClientOptions, 'transport'>;