@lyeve-labs/client-svelte 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LyEve Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,207 @@
+# @lyeve/cms-client-svelte
+
+Svelte 5 reactive stores for the LyEve Core API. Thin wrapper around
+`@lyeve/cms-client` using Svelte 5 runes (`$state`).
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Svelte 5](https://img.shields.io/badge/svelte-5-ff3e00.svg)](https://svelte.dev)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178c6.svg)](https://www.typescriptlang.org)
+
+```bash
+pnpm add @lyeve/cms-client @lyeve/cms-client-svelte
+```
+
+```svelte
+<script lang="ts">
+  import { createCmsClient, createAsyncStore } from '@lyeve/cms-client-svelte';
+  import { getSchemas } from '@lyeve/cms-client-rest';
+
+  const client = createCmsClient({
+    baseUrl: 'https://cms.example.com',
+    getHeaders: () => ({ Authorization: `Bearer ${token}` }),
+  });
+
+  const schemas = createAsyncStore((client) => getSchemas(client), client);
+</script>
+
+{#if schemas.loading}
+  <p>Loading...</p>
+{:else if schemas.error}
+  <p>Error: {schemas.error.message}</p>
+{:else}
+  <ul>
+    {#each schemas.data ?? [] as schema}
+      <li>{schema.name}</li>
+    {/each}
+  </ul>
+{/if}
+```
+
+No Provider needed. Create a client, pass it in, done.
+
+---
+
+## What's in the box
+
+- **createCmsClient:** factory that returns a configured `HttpClient` with
+  base URL and dynamic headers.
+- **createAsyncStore:** reactive async data store built on `$state`. Returns
+  `{ data, error, loading, refetch }`. All reactive, no boilerplate.
+- **createAuthStore:** auth state store with reactive `user`, `token`, and
+  `isAuthenticated`. Methods to `setUser`, `clear`, and `load` from storage.
+- **Svelte 5 native:** built on runes. No legacy stores, no `writable`.
+
+## Requirements
+
+- **Node 20** or newer
+- **Svelte 5.0** or newer
+- **[@lyeve/cms-client](https://www.npmjs.com/package/@lyeve/cms-client)** `>=0.1.0`
+
+## Install
+
+```bash
+pnpm add @lyeve/cms-client @lyeve/cms-client-svelte
+# or npm install @lyeve/cms-client @lyeve/cms-client-svelte
+# or yarn add @lyeve/cms-client @lyeve/cms-client-svelte
+```
+
+## Use
+
+### Data fetching
+
+```svelte
+<script lang="ts">
+  import { createCmsClient, createAsyncStore } from '@lyeve/cms-client-svelte';
+  import { getSchemas } from '@lyeve/cms-client-rest';
+
+  const client = createCmsClient({
+    baseUrl: 'https://cms.example.com',
+    getHeaders: () => ({ Authorization: `Bearer ${token}` }),
+  });
+
+  const schemas = createAsyncStore((c) => getSchemas(c), client);
+</script>
+
+{#if schemas.loading}
+  <p>Loading...</p>
+{:else if schemas.error}
+  <p>Error: {schemas.error.message}</p>
+{:else}
+  <ul>
+    {#each schemas.data ?? [] as schema}
+      <li>{schema.name}</li>
+    {/each}
+  </ul>
+{/if}
+
+<button onclick={() => schemas.refetch()}>Reload</button>
+```
+
+### Authentication
+
+```svelte
+<script lang="ts">
+  import { createCmsClient, createAuthStore } from '@lyeve/cms-client-svelte';
+
+  const client = createCmsClient({ baseUrl: 'https://cms.example.com' });
+  const auth = createAuthStore(client);
+
+  function handleLogin(e: SubmitEvent) {
+    e.preventDefault();
+    const data = new FormData(e.target as HTMLFormElement);
+    const credentials = {
+      email: data.get('email') as string,
+      password: data.get('password') as string,
+    };
+    // Call your auth endpoint, then store the result:
+    const user = { id: '1', email: credentials.email, roles: ['admin'] };
+    auth.setUser(user, 'jwt-token');
+  }
+</script>
+
+{#if !auth.isAuthenticated}
+  <form onsubmit={handleLogin}>
+    <input type="email" name="email" required />
+    <input type="password" name="password" required />
+    <button type="submit">Log in</button>
+  </form>
+{:else}
+  <p>Welcome, {auth.user?.email}</p>
+  <button onclick={() => auth.clear()}>Log out</button>
+{/if}
+```
+
+## API
+
+### createCmsClient(config)
+
+```ts
+function createCmsClient(config: {
+  baseUrl?: string;
+  getHeaders?: () => Record<string, string>;
+}): HttpClient;
+```
+
+### createAsyncStore(fetcher, client)
+
+```ts
+function createAsyncStore<T>(
+  fetcher: (client: HttpClient) => Promise<T>,
+  client: HttpClient,
+): {
+  data: T | null;
+  error: Error | null;
+  loading: boolean;
+  refetch: () => void;
+};
+```
+
+All fields are reactive (`$state` rune).
+
+### createAuthStore(client)
+
+```ts
+function createAuthStore(client: HttpClient): {
+  user: { id: string; email: string; roles: string[] } | null;
+  token: string | null;
+  isAuthenticated: boolean;
+  setUser: (user: User, token: string) => void;
+  clear: () => void;
+  load: () => Promise<void>;
+};
+```
+
+## Local development
+
+```bash
+pnpm install            # install dependencies
+pnpm test               # run unit tests
+pnpm check              # type-check
+pnpm build              # tsup + publint -> dist/
+```
+
+## Project layout
+
+```
+src/
+  index.ts           # public API (re-exports)
+  index.svelte.ts    # Svelte 5 entry point
+  runes.ts           # createAsyncStore, createAuthStore
+  ambient.d.ts       # type declarations
+tests/               # vitest test suite
+```
+
+## Versioning
+
+`@lyeve/cms-client-svelte` follows [SemVer](https://semver.org). While under `1.0`,
+breaking changes bump the **minor** version; additive changes bump the **patch**.
+Every release is logged in [`CHANGELOG.md`](CHANGELOG.md).
+
+## Contributing
+
+Bug reports and feature requests are welcome. See
+[`CONTRIBUTING.md`](CONTRIBUTING.md) for the development setup and conventions.
+
+## License
+
+MIT. See [`LICENSE`](LICENSE).

package/dist/index.cjs

@@ -0,0 +1,136 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  createAsyncStore: () => createAsyncStore,
+  createAuthStore: () => createAuthStore,
+  createCmsClient: () => createCmsClient,
+  createMutation: () => createMutation
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/runes.ts
+var import_cms_client = require("@lyeve/cms-client");
+function createCmsClient(config) {
+  const base = config.baseUrl ?? "";
+  return (0, import_cms_client.createClient)((url, init) => {
+    const fullUrl = typeof url === "string" ? `${base}${url}` : url;
+    return fetch(fullUrl, {
+      ...init,
+      headers: { ...init?.headers, ...config.getHeaders?.() }
+    });
+  });
+}
+function createAsyncStore(fetcher, client) {
+  let data = $state(null);
+  let error = $state(null);
+  let loading = $state(true);
+  async function fetch2() {
+    loading = true;
+    try {
+      data = await fetcher(client);
+      error = null;
+    } catch (e) {
+      error = e;
+    } finally {
+      loading = false;
+    }
+  }
+  fetch2();
+  return {
+    get data() {
+      return data;
+    },
+    get error() {
+      return error;
+    },
+    get loading() {
+      return loading;
+    },
+    refetch: fetch2
+  };
+}
+function createMutation(mutator, client) {
+  let data = $state(null);
+  let error = $state(null);
+  let loading = $state(false);
+  async function run(vars) {
+    loading = true;
+    error = null;
+    try {
+      const result = await mutator(client, vars);
+      data = result;
+      return result;
+    } catch (e) {
+      error = e;
+      throw e;
+    } finally {
+      loading = false;
+    }
+  }
+  return {
+    get data() {
+      return data;
+    },
+    get error() {
+      return error;
+    },
+    get loading() {
+      return loading;
+    },
+    run
+  };
+}
+function createAuthStore(client) {
+  let state = $state({ user: null, token: null });
+  return {
+    get user() {
+      return state.user;
+    },
+    get token() {
+      return state.token;
+    },
+    get isAuthenticated() {
+      return state.token !== null;
+    },
+    setUser(user, token) {
+      state = { user, token };
+    },
+    clear() {
+      state = { user: null, token: null };
+    },
+    async load() {
+      try {
+        const user = await client.get("/api/admin/auth/me");
+        state = { ...state, user };
+      } catch {
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAsyncStore,
+  createAuthStore,
+  createCmsClient,
+  createMutation
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/runes.ts"],"sourcesContent":["// Re-exports for non-Svelte consumers (bundled by tsup).\n// Implementation lives in runes.svelte.ts so Svelte's compiler handles\n// $state runes natively via the \"svelte\" export condition.\nexport {\n\tcreateCmsClient,\n\tcreateAsyncStore,\n\tcreateMutation,\n\tcreateAuthStore,\n\ttype SvelteCmsConfig,\n\ttype AsyncStore,\n\ttype AuthState,\n\ttype AuthStore,\n} from './runes.js';\n","import { createClient, type HttpClient } from '@lyeve/cms-client';\n\n// Client factory\n\nexport interface SvelteCmsConfig {\n\t/** Base URL prepended to every request path. */\n\tbaseUrl?: string;\n\t/**\n\t * Callback returning headers added to every request.\n\t * Called on every request so auth tokens can be refreshed without\n\t * recreating the client.\n\t */\n\tgetHeaders?: () => Record<string, string>;\n}\n\n/**\n * Creates an HttpClient pre-configured with base URL and dynamic request\n * headers. No Provider needed - Svelte callers just pass the client around.\n *\n * @example\n * ```ts\n * const client = createCmsClient({\n *   baseUrl: 'https://cms.example.com',\n *   getHeaders: () => ({ Authorization: `Bearer ${token}` }),\n * });\n * ```\n */\nexport function createCmsClient(config: SvelteCmsConfig): HttpClient {\n\tconst base = config.baseUrl ?? '';\n\treturn createClient((url, init) => {\n\t\tconst fullUrl = typeof url === 'string' ? `${base}${url}` : url;\n\t\treturn fetch(fullUrl, {\n\t\t\t...init,\n\t\t\theaders: { ...init?.headers, ...config.getHeaders?.() },\n\t\t});\n\t});\n}\n\n// Generic async store\n\nexport interface AsyncStore<T> {\n\treadonly data: T | null;\n\treadonly error: Error | null;\n\treadonly loading: boolean;\n\trefetch: () => void;\n}\n\n/**\n * Reactive async data store using the $state rune.\n * Fires the fetcher immediately and exposes reactive loading/data/error\n * getters that Svelte components can read directly in markup.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   const schemas = createAsyncStore((c) => getSchemas(c), client);\n * </script>\n * {#if schemas.loading}...{/if}\n * ```\n */\nexport function createAsyncStore<T>(\n\tfetcher: (client: HttpClient) => Promise<T>,\n\tclient: HttpClient,\n): AsyncStore<T> {\n\tlet data = $state<T | null>(null);\n\tlet error = $state<Error | null>(null);\n\tlet loading = $state(true);\n\n\tasync function fetch() {\n\t\tloading = true;\n\t\ttry {\n\t\t\tdata = await fetcher(client);\n\t\t\terror = null;\n\t\t} catch (e) {\n\t\t\terror = e as Error;\n\t\t} finally {\n\t\t\tloading = false;\n\t\t}\n\t}\n\n\tfetch();\n\n\treturn {\n\t\tget data() { return data; },\n\t\tget error() { return error; },\n\t\tget loading() { return loading; },\n\t\trefetch: fetch,\n\t};\n}\n\n/**\n * Reactive mutation primitive using the $state rune.\n * Returns data/error/loading state and a run function that triggers the\n * mutation. Unlike createAsyncStore, the mutation does not fire immediately.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   const createArticle = createMutation(\n *     (c, vars: { title: string }) => createArticle(c, vars),\n *     client,\n *   );\n * </script>\n * <button onclick={() => createArticle.run({ title: 'Hello' })}>\n *   {createArticle.loading ? 'Saving...' : 'Create'}\n * </button>\n * ```\n */\nexport function createMutation<T, V>(\n\tmutator: (client: HttpClient, vars: V) => Promise<T>,\n\tclient: HttpClient,\n) {\n\tlet data = $state<T | null>(null);\n\tlet error = $state<Error | null>(null);\n\tlet loading = $state(false);\n\n\tasync function run(vars: V): Promise<T> {\n\t\tloading = true;\n\t\terror = null;\n\t\ttry {\n\t\t\tconst result = await mutator(client, vars);\n\t\t\tdata = result;\n\t\t\treturn result;\n\t\t} catch (e) {\n\t\t\terror = e as Error;\n\t\t\tthrow e;\n\t\t} finally {\n\t\t\tloading = false;\n\t\t}\n\t}\n\n\treturn {\n\t\tget data() { return data; },\n\t\tget error() { return error; },\n\t\tget loading() { return loading; },\n\t\trun,\n\t};\n}\n\n// Auth store\n\nexport interface AuthState {\n\tuser: { id: string; email: string; roles: string[] } | null;\n\ttoken: string | null;\n}\n\nexport interface AuthStore {\n\treadonly user: AuthState['user'];\n\treadonly token: string | null;\n\treadonly isAuthenticated: boolean;\n\t/** Set the current user and token after a successful login. */\n\tsetUser: (user: AuthState['user'], token: string | null) => void;\n\t/** Clear auth state (e.g. after logout). */\n\tclear: () => void;\n\t/** Try to load the current user from the server using the stored token. */\n\tload: () => Promise<void>;\n}\n\n/**\n * Simple reactive auth store. The caller is responsible for calling\n * {@link AuthStore.setUser} after login and {@link AuthStore.clear} after\n * logout. Use {@link AuthStore.load} on app start to restore a session\n * from an existing cookie.\n */\nexport function createAuthStore(client: HttpClient): AuthStore {\n\tlet state = $state<AuthState>({ user: null, token: null });\n\n\treturn {\n\t\tget user() { return state.user; },\n\t\tget token() { return state.token; },\n\t\tget isAuthenticated() { return state.token !== null; },\n\t\tsetUser(user: AuthState['user'], token: string | null) {\n\t\t\tstate = { user, token };\n\t\t},\n\t\tclear() {\n\t\t\tstate = { user: null, token: null };\n\t\t},\n\t\tasync load() {\n\t\t\ttry {\n\t\t\t\tconst user = await client.get<{ id: string; email: string; roles: string[] }>('/api/admin/auth/me');\n\t\t\t\tstate = { ...state, user };\n\t\t\t} catch { /* not logged in */ }\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,wBAA8C;AA2BvC,SAAS,gBAAgB,QAAqC;AACpE,QAAM,OAAO,OAAO,WAAW;AAC/B,aAAO,gCAAa,CAAC,KAAK,SAAS;AAClC,UAAM,UAAU,OAAO,QAAQ,WAAW,GAAG,IAAI,GAAG,GAAG,KAAK;AAC5D,WAAO,MAAM,SAAS;AAAA,MACrB,GAAG;AAAA,MACH,SAAS,EAAE,GAAG,MAAM,SAAS,GAAG,OAAO,aAAa,EAAE;AAAA,IACvD,CAAC;AAAA,EACF,CAAC;AACF;AAwBO,SAAS,iBACf,SACA,QACgB;AAChB,MAAI,OAAO,OAAiB,IAAI;AAChC,MAAI,QAAQ,OAAqB,IAAI;AACrC,MAAI,UAAU,OAAO,IAAI;AAEzB,iBAAeA,SAAQ;AACtB,cAAU;AACV,QAAI;AACH,aAAO,MAAM,QAAQ,MAAM;AAC3B,cAAQ;AAAA,IACT,SAAS,GAAG;AACX,cAAQ;AAAA,IACT,UAAE;AACD,gBAAU;AAAA,IACX;AAAA,EACD;AAEA,EAAAA,OAAM;AAEN,SAAO;AAAA,IACN,IAAI,OAAO;AAAE,aAAO;AAAA,IAAM;AAAA,IAC1B,IAAI,QAAQ;AAAE,aAAO;AAAA,IAAO;AAAA,IAC5B,IAAI,UAAU;AAAE,aAAO;AAAA,IAAS;AAAA,IAChC,SAASA;AAAA,EACV;AACD;AAoBO,SAAS,eACf,SACA,QACC;AACD,MAAI,OAAO,OAAiB,IAAI;AAChC,MAAI,QAAQ,OAAqB,IAAI;AACrC,MAAI,UAAU,OAAO,KAAK;AAE1B,iBAAe,IAAI,MAAqB;AACvC,cAAU;AACV,YAAQ;AACR,QAAI;AACH,YAAM,SAAS,MAAM,QAAQ,QAAQ,IAAI;AACzC,aAAO;AACP,aAAO;AAAA,IACR,SAAS,GAAG;AACX,cAAQ;AACR,YAAM;AAAA,IACP,UAAE;AACD,gBAAU;AAAA,IACX;AAAA,EACD;AAEA,SAAO;AAAA,IACN,IAAI,OAAO;AAAE,aAAO;AAAA,IAAM;AAAA,IAC1B,IAAI,QAAQ;AAAE,aAAO;AAAA,IAAO;AAAA,IAC5B,IAAI,UAAU;AAAE,aAAO;AAAA,IAAS;AAAA,IAChC;AAAA,EACD;AACD;AA2BO,SAAS,gBAAgB,QAA+B;AAC9D,MAAI,QAAQ,OAAkB,EAAE,MAAM,MAAM,OAAO,KAAK,CAAC;AAEzD,SAAO;AAAA,IACN,IAAI,OAAO;AAAE,aAAO,MAAM;AAAA,IAAM;AAAA,IAChC,IAAI,QAAQ;AAAE,aAAO,MAAM;AAAA,IAAO;AAAA,IAClC,IAAI,kBAAkB;AAAE,aAAO,MAAM,UAAU;AAAA,IAAM;AAAA,IACrD,QAAQ,MAAyB,OAAsB;AACtD,cAAQ,EAAE,MAAM,MAAM;AAAA,IACvB;AAAA,IACA,QAAQ;AACP,cAAQ,EAAE,MAAM,MAAM,OAAO,KAAK;AAAA,IACnC;AAAA,IACA,MAAM,OAAO;AACZ,UAAI;AACH,cAAM,OAAO,MAAM,OAAO,IAAoD,oBAAoB;AAClG,gBAAQ,EAAE,GAAG,OAAO,KAAK;AAAA,MAC1B,QAAQ;AAAA,MAAsB;AAAA,IAC/B;AAAA,EACD;AACD;","names":["fetch"]}

package/dist/index.d.cts

@@ -0,0 +1,97 @@
+import { HttpClient } from '@lyeve/cms-client';
+
+interface SvelteCmsConfig {
+    /** Base URL prepended to every request path. */
+    baseUrl?: string;
+    /**
+     * Callback returning headers added to every request.
+     * Called on every request so auth tokens can be refreshed without
+     * recreating the client.
+     */
+    getHeaders?: () => Record<string, string>;
+}
+/**
+ * Creates an HttpClient pre-configured with base URL and dynamic request
+ * headers. No Provider needed - Svelte callers just pass the client around.
+ *
+ * @example
+ * ```ts
+ * const client = createCmsClient({
+ *   baseUrl: 'https://cms.example.com',
+ *   getHeaders: () => ({ Authorization: `Bearer ${token}` }),
+ * });
+ * ```
+ */
+declare function createCmsClient(config: SvelteCmsConfig): HttpClient;
+interface AsyncStore<T> {
+    readonly data: T | null;
+    readonly error: Error | null;
+    readonly loading: boolean;
+    refetch: () => void;
+}
+/**
+ * Reactive async data store using the $state rune.
+ * Fires the fetcher immediately and exposes reactive loading/data/error
+ * getters that Svelte components can read directly in markup.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   const schemas = createAsyncStore((c) => getSchemas(c), client);
+ * </script>
+ * {#if schemas.loading}...{/if}
+ * ```
+ */
+declare function createAsyncStore<T>(fetcher: (client: HttpClient) => Promise<T>, client: HttpClient): AsyncStore<T>;
+/**
+ * Reactive mutation primitive using the $state rune.
+ * Returns data/error/loading state and a run function that triggers the
+ * mutation. Unlike createAsyncStore, the mutation does not fire immediately.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   const createArticle = createMutation(
+ *     (c, vars: { title: string }) => createArticle(c, vars),
+ *     client,
+ *   );
+ * </script>
+ * <button onclick={() => createArticle.run({ title: 'Hello' })}>
+ *   {createArticle.loading ? 'Saving...' : 'Create'}
+ * </button>
+ * ```
+ */
+declare function createMutation<T, V>(mutator: (client: HttpClient, vars: V) => Promise<T>, client: HttpClient): {
+    readonly data: T | null;
+    readonly error: Error | null;
+    readonly loading: boolean;
+    run: (vars: V) => Promise<T>;
+};
+interface AuthState {
+    user: {
+        id: string;
+        email: string;
+        roles: string[];
+    } | null;
+    token: string | null;
+}
+interface AuthStore {
+    readonly user: AuthState['user'];
+    readonly token: string | null;
+    readonly isAuthenticated: boolean;
+    /** Set the current user and token after a successful login. */
+    setUser: (user: AuthState['user'], token: string | null) => void;
+    /** Clear auth state (e.g. after logout). */
+    clear: () => void;
+    /** Try to load the current user from the server using the stored token. */
+    load: () => Promise<void>;
+}
+/**
+ * Simple reactive auth store. The caller is responsible for calling
+ * {@link AuthStore.setUser} after login and {@link AuthStore.clear} after
+ * logout. Use {@link AuthStore.load} on app start to restore a session
+ * from an existing cookie.
+ */
+declare function createAuthStore(client: HttpClient): AuthStore;
+
+export { type AsyncStore, type AuthState, type AuthStore, type SvelteCmsConfig, createAsyncStore, createAuthStore, createCmsClient, createMutation };

package/dist/index.d.ts

@@ -0,0 +1,97 @@
+import { HttpClient } from '@lyeve/cms-client';
+
+interface SvelteCmsConfig {
+    /** Base URL prepended to every request path. */
+    baseUrl?: string;
+    /**
+     * Callback returning headers added to every request.
+     * Called on every request so auth tokens can be refreshed without
+     * recreating the client.
+     */
+    getHeaders?: () => Record<string, string>;
+}
+/**
+ * Creates an HttpClient pre-configured with base URL and dynamic request
+ * headers. No Provider needed - Svelte callers just pass the client around.
+ *
+ * @example
+ * ```ts
+ * const client = createCmsClient({
+ *   baseUrl: 'https://cms.example.com',
+ *   getHeaders: () => ({ Authorization: `Bearer ${token}` }),
+ * });
+ * ```
+ */
+declare function createCmsClient(config: SvelteCmsConfig): HttpClient;
+interface AsyncStore<T> {
+    readonly data: T | null;
+    readonly error: Error | null;
+    readonly loading: boolean;
+    refetch: () => void;
+}
+/**
+ * Reactive async data store using the $state rune.
+ * Fires the fetcher immediately and exposes reactive loading/data/error
+ * getters that Svelte components can read directly in markup.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   const schemas = createAsyncStore((c) => getSchemas(c), client);
+ * </script>
+ * {#if schemas.loading}...{/if}
+ * ```
+ */
+declare function createAsyncStore<T>(fetcher: (client: HttpClient) => Promise<T>, client: HttpClient): AsyncStore<T>;
+/**
+ * Reactive mutation primitive using the $state rune.
+ * Returns data/error/loading state and a run function that triggers the
+ * mutation. Unlike createAsyncStore, the mutation does not fire immediately.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   const createArticle = createMutation(
+ *     (c, vars: { title: string }) => createArticle(c, vars),
+ *     client,
+ *   );
+ * </script>
+ * <button onclick={() => createArticle.run({ title: 'Hello' })}>
+ *   {createArticle.loading ? 'Saving...' : 'Create'}
+ * </button>
+ * ```
+ */
+declare function createMutation<T, V>(mutator: (client: HttpClient, vars: V) => Promise<T>, client: HttpClient): {
+    readonly data: T | null;
+    readonly error: Error | null;
+    readonly loading: boolean;
+    run: (vars: V) => Promise<T>;
+};
+interface AuthState {
+    user: {
+        id: string;
+        email: string;
+        roles: string[];
+    } | null;
+    token: string | null;
+}
+interface AuthStore {
+    readonly user: AuthState['user'];
+    readonly token: string | null;
+    readonly isAuthenticated: boolean;
+    /** Set the current user and token after a successful login. */
+    setUser: (user: AuthState['user'], token: string | null) => void;
+    /** Clear auth state (e.g. after logout). */
+    clear: () => void;
+    /** Try to load the current user from the server using the stored token. */
+    load: () => Promise<void>;
+}
+/**
+ * Simple reactive auth store. The caller is responsible for calling
+ * {@link AuthStore.setUser} after login and {@link AuthStore.clear} after
+ * logout. Use {@link AuthStore.load} on app start to restore a session
+ * from an existing cookie.
+ */
+declare function createAuthStore(client: HttpClient): AuthStore;
+
+export { type AsyncStore, type AuthState, type AuthStore, type SvelteCmsConfig, createAsyncStore, createAuthStore, createCmsClient, createMutation };

package/dist/index.js

@@ -0,0 +1,106 @@
+// src/runes.ts
+import { createClient } from "@lyeve/cms-client";
+function createCmsClient(config) {
+  const base = config.baseUrl ?? "";
+  return createClient((url, init) => {
+    const fullUrl = typeof url === "string" ? `${base}${url}` : url;
+    return fetch(fullUrl, {
+      ...init,
+      headers: { ...init?.headers, ...config.getHeaders?.() }
+    });
+  });
+}
+function createAsyncStore(fetcher, client) {
+  let data = $state(null);
+  let error = $state(null);
+  let loading = $state(true);
+  async function fetch2() {
+    loading = true;
+    try {
+      data = await fetcher(client);
+      error = null;
+    } catch (e) {
+      error = e;
+    } finally {
+      loading = false;
+    }
+  }
+  fetch2();
+  return {
+    get data() {
+      return data;
+    },
+    get error() {
+      return error;
+    },
+    get loading() {
+      return loading;
+    },
+    refetch: fetch2
+  };
+}
+function createMutation(mutator, client) {
+  let data = $state(null);
+  let error = $state(null);
+  let loading = $state(false);
+  async function run(vars) {
+    loading = true;
+    error = null;
+    try {
+      const result = await mutator(client, vars);
+      data = result;
+      return result;
+    } catch (e) {
+      error = e;
+      throw e;
+    } finally {
+      loading = false;
+    }
+  }
+  return {
+    get data() {
+      return data;
+    },
+    get error() {
+      return error;
+    },
+    get loading() {
+      return loading;
+    },
+    run
+  };
+}
+function createAuthStore(client) {
+  let state = $state({ user: null, token: null });
+  return {
+    get user() {
+      return state.user;
+    },
+    get token() {
+      return state.token;
+    },
+    get isAuthenticated() {
+      return state.token !== null;
+    },
+    setUser(user, token) {
+      state = { user, token };
+    },
+    clear() {
+      state = { user: null, token: null };
+    },
+    async load() {
+      try {
+        const user = await client.get("/api/admin/auth/me");
+        state = { ...state, user };
+      } catch {
+      }
+    }
+  };
+}
+export {
+  createAsyncStore,
+  createAuthStore,
+  createCmsClient,
+  createMutation
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runes.ts"],"sourcesContent":["import { createClient, type HttpClient } from '@lyeve/cms-client';\n\n// Client factory\n\nexport interface SvelteCmsConfig {\n\t/** Base URL prepended to every request path. */\n\tbaseUrl?: string;\n\t/**\n\t * Callback returning headers added to every request.\n\t * Called on every request so auth tokens can be refreshed without\n\t * recreating the client.\n\t */\n\tgetHeaders?: () => Record<string, string>;\n}\n\n/**\n * Creates an HttpClient pre-configured with base URL and dynamic request\n * headers. No Provider needed - Svelte callers just pass the client around.\n *\n * @example\n * ```ts\n * const client = createCmsClient({\n *   baseUrl: 'https://cms.example.com',\n *   getHeaders: () => ({ Authorization: `Bearer ${token}` }),\n * });\n * ```\n */\nexport function createCmsClient(config: SvelteCmsConfig): HttpClient {\n\tconst base = config.baseUrl ?? '';\n\treturn createClient((url, init) => {\n\t\tconst fullUrl = typeof url === 'string' ? `${base}${url}` : url;\n\t\treturn fetch(fullUrl, {\n\t\t\t...init,\n\t\t\theaders: { ...init?.headers, ...config.getHeaders?.() },\n\t\t});\n\t});\n}\n\n// Generic async store\n\nexport interface AsyncStore<T> {\n\treadonly data: T | null;\n\treadonly error: Error | null;\n\treadonly loading: boolean;\n\trefetch: () => void;\n}\n\n/**\n * Reactive async data store using the $state rune.\n * Fires the fetcher immediately and exposes reactive loading/data/error\n * getters that Svelte components can read directly in markup.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   const schemas = createAsyncStore((c) => getSchemas(c), client);\n * </script>\n * {#if schemas.loading}...{/if}\n * ```\n */\nexport function createAsyncStore<T>(\n\tfetcher: (client: HttpClient) => Promise<T>,\n\tclient: HttpClient,\n): AsyncStore<T> {\n\tlet data = $state<T | null>(null);\n\tlet error = $state<Error | null>(null);\n\tlet loading = $state(true);\n\n\tasync function fetch() {\n\t\tloading = true;\n\t\ttry {\n\t\t\tdata = await fetcher(client);\n\t\t\terror = null;\n\t\t} catch (e) {\n\t\t\terror = e as Error;\n\t\t} finally {\n\t\t\tloading = false;\n\t\t}\n\t}\n\n\tfetch();\n\n\treturn {\n\t\tget data() { return data; },\n\t\tget error() { return error; },\n\t\tget loading() { return loading; },\n\t\trefetch: fetch,\n\t};\n}\n\n/**\n * Reactive mutation primitive using the $state rune.\n * Returns data/error/loading state and a run function that triggers the\n * mutation. Unlike createAsyncStore, the mutation does not fire immediately.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   const createArticle = createMutation(\n *     (c, vars: { title: string }) => createArticle(c, vars),\n *     client,\n *   );\n * </script>\n * <button onclick={() => createArticle.run({ title: 'Hello' })}>\n *   {createArticle.loading ? 'Saving...' : 'Create'}\n * </button>\n * ```\n */\nexport function createMutation<T, V>(\n\tmutator: (client: HttpClient, vars: V) => Promise<T>,\n\tclient: HttpClient,\n) {\n\tlet data = $state<T | null>(null);\n\tlet error = $state<Error | null>(null);\n\tlet loading = $state(false);\n\n\tasync function run(vars: V): Promise<T> {\n\t\tloading = true;\n\t\terror = null;\n\t\ttry {\n\t\t\tconst result = await mutator(client, vars);\n\t\t\tdata = result;\n\t\t\treturn result;\n\t\t} catch (e) {\n\t\t\terror = e as Error;\n\t\t\tthrow e;\n\t\t} finally {\n\t\t\tloading = false;\n\t\t}\n\t}\n\n\treturn {\n\t\tget data() { return data; },\n\t\tget error() { return error; },\n\t\tget loading() { return loading; },\n\t\trun,\n\t};\n}\n\n// Auth store\n\nexport interface AuthState {\n\tuser: { id: string; email: string; roles: string[] } | null;\n\ttoken: string | null;\n}\n\nexport interface AuthStore {\n\treadonly user: AuthState['user'];\n\treadonly token: string | null;\n\treadonly isAuthenticated: boolean;\n\t/** Set the current user and token after a successful login. */\n\tsetUser: (user: AuthState['user'], token: string | null) => void;\n\t/** Clear auth state (e.g. after logout). */\n\tclear: () => void;\n\t/** Try to load the current user from the server using the stored token. */\n\tload: () => Promise<void>;\n}\n\n/**\n * Simple reactive auth store. The caller is responsible for calling\n * {@link AuthStore.setUser} after login and {@link AuthStore.clear} after\n * logout. Use {@link AuthStore.load} on app start to restore a session\n * from an existing cookie.\n */\nexport function createAuthStore(client: HttpClient): AuthStore {\n\tlet state = $state<AuthState>({ user: null, token: null });\n\n\treturn {\n\t\tget user() { return state.user; },\n\t\tget token() { return state.token; },\n\t\tget isAuthenticated() { return state.token !== null; },\n\t\tsetUser(user: AuthState['user'], token: string | null) {\n\t\t\tstate = { user, token };\n\t\t},\n\t\tclear() {\n\t\t\tstate = { user: null, token: null };\n\t\t},\n\t\tasync load() {\n\t\t\ttry {\n\t\t\t\tconst user = await client.get<{ id: string; email: string; roles: string[] }>('/api/admin/auth/me');\n\t\t\t\tstate = { ...state, user };\n\t\t\t} catch { /* not logged in */ }\n\t\t},\n\t};\n}\n"],"mappings":";AAAA,SAAS,oBAAqC;AA2BvC,SAAS,gBAAgB,QAAqC;AACpE,QAAM,OAAO,OAAO,WAAW;AAC/B,SAAO,aAAa,CAAC,KAAK,SAAS;AAClC,UAAM,UAAU,OAAO,QAAQ,WAAW,GAAG,IAAI,GAAG,GAAG,KAAK;AAC5D,WAAO,MAAM,SAAS;AAAA,MACrB,GAAG;AAAA,MACH,SAAS,EAAE,GAAG,MAAM,SAAS,GAAG,OAAO,aAAa,EAAE;AAAA,IACvD,CAAC;AAAA,EACF,CAAC;AACF;AAwBO,SAAS,iBACf,SACA,QACgB;AAChB,MAAI,OAAO,OAAiB,IAAI;AAChC,MAAI,QAAQ,OAAqB,IAAI;AACrC,MAAI,UAAU,OAAO,IAAI;AAEzB,iBAAeA,SAAQ;AACtB,cAAU;AACV,QAAI;AACH,aAAO,MAAM,QAAQ,MAAM;AAC3B,cAAQ;AAAA,IACT,SAAS,GAAG;AACX,cAAQ;AAAA,IACT,UAAE;AACD,gBAAU;AAAA,IACX;AAAA,EACD;AAEA,EAAAA,OAAM;AAEN,SAAO;AAAA,IACN,IAAI,OAAO;AAAE,aAAO;AAAA,IAAM;AAAA,IAC1B,IAAI,QAAQ;AAAE,aAAO;AAAA,IAAO;AAAA,IAC5B,IAAI,UAAU;AAAE,aAAO;AAAA,IAAS;AAAA,IAChC,SAASA;AAAA,EACV;AACD;AAoBO,SAAS,eACf,SACA,QACC;AACD,MAAI,OAAO,OAAiB,IAAI;AAChC,MAAI,QAAQ,OAAqB,IAAI;AACrC,MAAI,UAAU,OAAO,KAAK;AAE1B,iBAAe,IAAI,MAAqB;AACvC,cAAU;AACV,YAAQ;AACR,QAAI;AACH,YAAM,SAAS,MAAM,QAAQ,QAAQ,IAAI;AACzC,aAAO;AACP,aAAO;AAAA,IACR,SAAS,GAAG;AACX,cAAQ;AACR,YAAM;AAAA,IACP,UAAE;AACD,gBAAU;AAAA,IACX;AAAA,EACD;AAEA,SAAO;AAAA,IACN,IAAI,OAAO;AAAE,aAAO;AAAA,IAAM;AAAA,IAC1B,IAAI,QAAQ;AAAE,aAAO;AAAA,IAAO;AAAA,IAC5B,IAAI,UAAU;AAAE,aAAO;AAAA,IAAS;AAAA,IAChC;AAAA,EACD;AACD;AA2BO,SAAS,gBAAgB,QAA+B;AAC9D,MAAI,QAAQ,OAAkB,EAAE,MAAM,MAAM,OAAO,KAAK,CAAC;AAEzD,SAAO;AAAA,IACN,IAAI,OAAO;AAAE,aAAO,MAAM;AAAA,IAAM;AAAA,IAChC,IAAI,QAAQ;AAAE,aAAO,MAAM;AAAA,IAAO;AAAA,IAClC,IAAI,kBAAkB;AAAE,aAAO,MAAM,UAAU;AAAA,IAAM;AAAA,IACrD,QAAQ,MAAyB,OAAsB;AACtD,cAAQ,EAAE,MAAM,MAAM;AAAA,IACvB;AAAA,IACA,QAAQ;AACP,cAAQ,EAAE,MAAM,MAAM,OAAO,KAAK;AAAA,IACnC;AAAA,IACA,MAAM,OAAO;AACZ,UAAI;AACH,cAAM,OAAO,MAAM,OAAO,IAAoD,oBAAoB;AAClG,gBAAQ,EAAE,GAAG,OAAO,KAAK;AAAA,MAC1B,QAAQ;AAAA,MAAsB;AAAA,IAC/B;AAAA,EACD;AACD;","names":["fetch"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@lyeve-labs/client-svelte",
+  "version": "0.1.2",
+  "description": "Svelte 5 reactive stores for the LyEve Core API - thin wrapper around @lyeve/cms-client using $state runes",
+  "license": "MIT",
+  "author": "LyEve Labs <hello@lyeve.com>",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "svelte": "./src/index.svelte.ts",
+  "exports": {
+    ".": {
+      "svelte": "./src/index.svelte.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/*.spec.*"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@lyeve-labs/client-svelte": ">=0.1.0",
+    "svelte": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@lyeve-labs/client-svelte": "^0.1.0",
+    "svelte": "^5.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0",
+    "publint": "^0.3.0",
+    "prettier": "^3.4.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup && publint",
+    "check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  }
+}