authula 0.7.16 → 0.8.0-beta.0

package/README.md

@@ -3,7 +3,7 @@
 </p>
 
 <p align="center">
-This Node.js SDK provides seamless integration with an Authula server for both client-side and server-side applications and is framework agnostic.
+This Node.js SDK provides seamless integration with an Authula server for client-side and server-side applications. Import only the pieces you need from a framework subpath.
 </p>
 
 <div align="center">
@@ -22,70 +22,218 @@ This Node.js SDK provides seamless integration with an Authula server for both c
 
 ## Features
 
-- **Framework Agnostic**: Works with Next.js/React, Vue.js and more
+- **Framework subpaths**: `authula/core`, `authula/models`, `authula/plugins`, `authula/zod`, `authula/react`, `authula/vue`, `authula/solid`, `authula/svelte`
 - **Full TypeScript Support**: Complete TypeScript definitions with strict typing
 - **CSRF Protection**: Automatic CSRF token handling for mutating requests
 - **Multiple Auth Methods**: Email/password, OAuth2, JWT-based authentication
 - **Plugin Architecture**: Extensible plugin system for custom authentication flows
 - **Automatic Token Refresh**: Built-in bearer token refresh mechanism
-- **Built-in support for Zod and Tanstack Query**: provides types and zod schemas out of the box along with tanstack query code for all available methods.
+- **Built-in Zod and TanStack Query support**: Zod schemas from `authula/zod` and per-framework TanStack Query hooks
 
 ## Installation
 
+Install `authula` plus the TanStack Query adapter for your framework:
+
+```bash
+# React
+pnpm add authula @tanstack/react-query
+
+# Vue
+pnpm add authula @tanstack/vue-query
+
+# Solid
+pnpm add authula @tanstack/solid-query
+
+# Svelte
+pnpm add authula @tanstack/svelte-query
+```
+
+The framework runtime (`react`, `vue`, `solid-js`, `svelte`) is already present in
+your app and is declared as an optional peer, not installed by `authula`.
+
+Core-only/server users need no query adapter and no framework runtime:
+
 ```bash
-npm install authula
-# or
-yarn add authula
-# or
 pnpm add authula
 ```
 
+## Imports
+
+| Import            | Contents                                                               |
+| ----------------- | ---------------------------------------------------------------------- |
+| `authula/core`    | `AuthulaClient`, core `createClient` (direct methods only), `ApiError` |
+| `authula/models`  | Generated TypeScript models and enum values                            |
+| `authula/zod`     | Generated Zod schemas                                                  |
+| `authula/plugins` | Plugin classes                                                         |
+| `authula/react`   | React `createClient`, hooks/types, core re-export                      |
+| `authula/vue`     | Vue `createClient`, hooks/types, core re-export                        |
+| `authula/solid`   | Solid `createClient`, hooks/types, core re-export                      |
+| `authula/svelte`  | Svelte `createClient`, hooks/types, core re-export                     |
+
+There is no `authula` root import. Always use a subpath.
+
 ## Quick Start
 
-### Basic Setup
+Import `createClient` from your framework subpath. The client it returns has
+both direct methods and that framework's query hooks attached to each plugin:
+
+```ts
+const client = createClient({ url, plugins: [new CorePlugin()] });
 
-`Client instance`:
+await client.core.getMe(); // direct request method
+client.core.useGetMe(); // React/Vue/Solid hook
+client.core.createGetMe(); // Svelte hook
+```
 
-Use with SPA (Vite etc.)
+Hooks are bound to the client instance that created them, so their URL, cookies,
+and CSRF/bearer hooks always come from that client. They still use the TanStack
+Query client from your app's `QueryClientProvider` (or equivalent).
 
-```typescript
-import { createClient } from "authula";
+### React
+
+```tsx
+import { createClient } from "authula/react";
 import { CorePlugin, EmailPasswordPlugin } from "authula/plugins";
 
-const authulaBrowserClient = createClient({
-  // Your Authula server URL
+const client = createClient({
   url: "http://localhost:8080/api/auth",
   plugins: [new CorePlugin(), new EmailPasswordPlugin()],
 });
 
-// Direct method call
-const response = await authulaBrowserClient.core.getMe();
-
-// Tanstack Query
-const { data, error, isLoading, isError } = await authulaBrowserClient.core.useGetMe();
+function Profile() {
+  const { data, isLoading, isError } = client.core.useGetMe();
+  if (isLoading) return <p>Loading…</p>;
+  if (isError) return <p>Not signed in</p>;
+  return <p>{data?.user?.email}</p>;
+}
 ```
 
-`Server instance`:
+### Vue
 
-Use with SSR frameworks e.g. Next.js/Tanstack Start etc.
+```vue
+<script setup lang="ts">
+import { createClient } from "authula/vue";
+import { CorePlugin, EmailPasswordPlugin } from "authula/plugins";
 
-```typescript
-import { cookies } from "next/headers";
+const client = createClient({
+  url: "http://localhost:8080/api/auth",
+  plugins: [new CorePlugin(), new EmailPasswordPlugin()],
+});
+
+const { data, isLoading, isError } = client.core.useGetMe();
+</script>
+
+<template>
+  <p v-if="isLoading">Loading…</p>
+  <p v-else-if="isError">Not signed in</p>
+  <p v-else>{{ data?.user?.email }}</p>
+</template>
+```
 
-import { createClient } from "authula";
+### Solid
+
+```tsx
+import { createClient } from "authula/solid";
 import { CorePlugin, EmailPasswordPlugin } from "authula/plugins";
 
-const authulaServerClient = createClient({
-  // Your Authula server URL
+const client = createClient({
   url: "http://localhost:8080/api/auth",
   plugins: [new CorePlugin(), new EmailPasswordPlugin()],
-  // For frameworks other than Next.js, you may need to implement this cookies object manually by implementing the interface.
-  cookies: cookies,
 });
 
-// Now you can use the client...
+function Profile() {
+  const query = client.core.useGetMe();
+  if (query.isLoading) return <p>Loading…</p>;
+  if (query.isError) return <p>Not signed in</p>;
+  return <p>{query.data?.user?.email}</p>;
+}
+```
+
+### Svelte
+
+```svelte
+<script lang="ts">
+  import { createClient } from "authula/svelte";
+  import { CorePlugin, EmailPasswordPlugin } from "authula/plugins";
 
-const response = await authulaServerClient.core.getMe();
+  const client = createClient({
+    url: "http://localhost:8080/api/auth",
+    plugins: [new CorePlugin(), new EmailPasswordPlugin()],
+  });
+
+  const query = client.core.createGetMe();
+</script>
+
+{#if $query.isLoading}
+  <p>Loading…</p>
+{:else if $query.isError}
+  <p>Not signed in</p>
+{:else}
+  <p>{$query.data?.user?.email}</p>
+{/if}
+```
+
+Raw hooks are still exported from each framework subpath for convenience:
+
+```ts
+import { createClient, useGetMe } from "authula/react";
+```
+
+The raw hook resolves the most recently created client as its default. Prefer
+`client.core.useGetMe()` when you need a specific client instance, such as SSR.
+
+### Direct methods and models
+
+For server-side or core-only usage, import `createClient` from `authula/core`.
+It provides direct methods without query hooks:
+
+```ts
+import { createClient } from "authula/core";
+import { CorePlugin } from "authula/plugins";
+import type { User } from "authula/models";
+
+const client = createClient({
+  url: "http://localhost:8080/api/auth",
+  plugins: [new CorePlugin()],
+});
+
+const me = await client.core.getMe();
+
+const user: User = me.data.user;
+```
+
+### Zod schemas
+
+```ts
+import * as schemas from "authula/zod";
+
+const result = schemas.SignInRequest.safeParse(input);
+```
+
+## Server-side rendering
+
+- Client-bound hooks (`client.core.useGetMe()`) use the cookies and URL of the
+  client instance they came from, so create one client per request when using
+  hooks during SSR.
+- Use direct client methods (`await client.core.getMe()`) when possible.
+- Raw hook imports (`import { useGetMe } from "authula/react"`) use the most
+  recently created client globally, so avoid them for request-scoped SSR.
+- Per-call overrides are supported and take precedence over the client config:
+  `client.core.useGetMe({ request: { baseUrl, cookies } })`.
+
+```ts
+import { cookies } from "next/headers";
+
+import { createClient } from "authula/react";
+import { CorePlugin } from "authula/plugins";
+
+const client = createClient({
+  url: "http://localhost:8080/api/auth",
+  plugins: [new CorePlugin()],
+  cookies,
+});
+
+const me = await client.core.getMe();
 ```
 
 ## Available Plugins
@@ -109,8 +257,6 @@ The following plugins are available in this SDK:
 
 ### Fetch Options
 
-Configure fetch behavior with timeout and other options:
-
 ```typescript
 const authulaClient = createClient({
   url: "http://localhost:8080/auth",
@@ -126,33 +272,43 @@ const authulaClient = createClient({
 
 ### Custom Hooks
 
-Add custom before/after fetch hooks for advanced customization:
-
 ```typescript
 const authulaClient = createClient({
   url: "http://localhost:8080/auth",
   plugins: [new CorePlugin()],
 });
 
-// Register a before fetch hook
 authulaClient.registerBeforeFetch(async (ctx) => {
   console.log(`Making request to: ${ctx.url}`);
-  // Modify context if needed
   ctx.init.headers = {
     ...ctx.init.headers,
     "X-Custom-Header": "value",
   };
 });
 
-// Register an after fetch hook
 authulaClient.registerAfterFetch(async (ctx, response) => {
   console.log(`Received response: ${response.status}`);
-  if (response.status >= 400) {
-    // Handle error
-  }
 });
 ```
 
+## Migration from 0.7.x to 0.8.0
+
+| Before                                   | After                                                              |
+| ---------------------------------------- | ------------------------------------------------------------------ |
+| `import { createClient } from "authula"` | `import { createClient } from "authula/react"` (or your framework) |
+| `import type { User } from "authula"`    | `import type { User } from "authula/models"`                       |
+| `client.core.useGetMe()`                 | unchanged when `createClient` comes from a framework subpath       |
+| `authula/plugins`                        | unchanged                                                          |
+| zod schemas inaccessible                 | `import * as schemas from "authula/zod"`                           |
+
+For core-only or server code, `authula/core` also exports `createClient`, but its
+clients expose direct methods only (no query hooks).
+
+`@tanstack/react-query` was previously a direct dependency and is now an optional
+peer, so existing React users must add it explicitly. The same applies to the
+other TanStack adapters and to the framework runtimes (`react`, `vue`,
+`solid-js`, `svelte`), which are optional peers supplied by your app.
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

package/dist/{index.js → core-Csdt31Tx.js}

@@ -1,17 +1,7 @@
-import { t as ApiError } from "./custom-fetch-CXJ4-i7I.js";
+import { r as setDefaultClient } from "./custom-fetch-DJxn7nVP.js";
 import { parseCookie } from "cookie";
 
-//#region src/gen/models/organization-invitation-status.ts
-const OrganizationInvitationStatus = {
-	pending: "pending",
-	accepted: "accepted",
-	rejected: "rejected",
-	revoked: "revoked",
-	expired: "expired"
-};
-
-//#endregion
-//#region src/client.ts
+// src/core/client.ts
 var AuthulaClient = class {
 	config;
 	plugins;
@@ -22,6 +12,7 @@ var AuthulaClient = class {
 		const { plugins: _, ...rest } = options;
 		this.config = rest;
 		for (const plugin of this.plugins) this[plugin.id] = plugin.init(this);
+		setDefaultClient(this);
 	}
 	registerBeforeFetch(hook) {
 		this.beforeFetchHooks.push(hook);
@@ -55,12 +46,10 @@ var AuthulaClient = class {
 	}
 };
 
-//#endregion
-//#region src/sdk.ts
+// src/core/sdk.ts
 function createClient(options) {
 	return new AuthulaClient(options);
 }
 
-//#endregion
-export { ApiError, AuthulaClient, OrganizationInvitationStatus, createClient };
-//# sourceMappingURL=index.js.map
+export { AuthulaClient as n, createClient as t };
+//# sourceMappingURL=core-Csdt31Tx.js.map

package/dist/core-Csdt31Tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-Csdt31Tx.js","names":[],"sources":["../src/core/client.ts","../src/core/sdk.ts"],"sourcesContent":["import { parseCookie } from \"cookie\";\n\nimport { setDefaultClient } from \"./runtime\";\nimport type {\n  FetchContext,\n  AuthulaClientConfig,\n  AuthulaClientOptions,\n  Plugin,\n  BeforeFetchHook,\n  AfterFetchHook,\n} from \"./types\";\n\nexport class AuthulaClient {\n  public readonly config: AuthulaClientConfig;\n  private readonly plugins: Array<Plugin>;\n  private readonly beforeFetchHooks: BeforeFetchHook[] = [];\n  private readonly afterFetchHooks: AfterFetchHook[] = [];\n\n  constructor(options: AuthulaClientOptions) {\n    this.plugins = options.plugins || [];\n\n    const { plugins: _, ...rest } = options;\n    this.config = rest;\n\n    for (const plugin of this.plugins) {\n      (this as any)[plugin.id] = plugin.init(this);\n    }\n\n    setDefaultClient(this);\n  }\n\n  public registerBeforeFetch(hook: BeforeFetchHook): void {\n    this.beforeFetchHooks.push(hook);\n  }\n\n  public registerAfterFetch(hook: AfterFetchHook): void {\n    this.afterFetchHooks.push(hook);\n  }\n\n  public async runBeforeFetch(ctx: FetchContext): Promise<void> {\n    for (const hook of this.beforeFetchHooks) {\n      await hook(ctx);\n    }\n  }\n\n  public async runAfterFetch(ctx: FetchContext, res: Response) {\n    for (const hook of this.afterFetchHooks) {\n      const result = await hook(ctx, res);\n      if (result === \"retry\") {\n        return \"retry\";\n      }\n    }\n  }\n\n  public getPlugin<T extends Plugin>(id: string): T | undefined {\n    return this.plugins.find((plugin) => plugin.id === id) as T | undefined;\n  }\n\n  public async getCookie(name: string): Promise<string | undefined> {\n    const all = await this.getAllCookies();\n    return all ? all[name] : undefined;\n  }\n\n  public async getAllCookies(): Promise<Record<string, string | undefined> | undefined> {\n    if (this.config.cookies) {\n      try {\n        const store = await this.config.cookies();\n        const all = store.getAll();\n        const map: Record<string, string> = {};\n        for (const c of all) {\n          map[c.name] = c.value;\n        }\n        return map;\n      } catch {\n        return undefined;\n      }\n    }\n\n    if (typeof document !== \"undefined\") {\n      return parseCookie(document.cookie);\n    }\n\n    return undefined;\n  }\n}\n","import { AuthulaClient } from \"./client\";\nimport type { AuthulaClientOptions, Plugin } from \"./types\";\n\n// Helper to extract plugin methods\nexport type InferPluginMethods<P> = P extends { init: (client: any) => infer M } ? M : never;\n\nexport type ClientWithPlugins<T extends readonly Plugin[]> = AuthulaClient & {\n  [P in T[number] as P[\"id\"]]: InferPluginMethods<P>;\n};\n\nexport function createClient<const T extends readonly Plugin[]>(\n  options: Omit<AuthulaClientOptions, \"plugins\"> & { plugins: T },\n): ClientWithPlugins<T> {\n  return new AuthulaClient(options as any) as ClientWithPlugins<T>;\n}\n"],"mappings":";;;;AAYA,IAAa,gBAAb,MAA2B;CACzB,AAAgB;CAChB,AAAiB;CACjB,AAAiB,mBAAsC,CAAC;CACxD,AAAiB,kBAAoC,CAAC;CAEtD,YAAY,SAA+B;EACzC,KAAK,UAAU,QAAQ,WAAW,CAAC;EAEnC,MAAM,EAAE,SAAS,GAAG,GAAG,SAAS;EAChC,KAAK,SAAS;EAEd,KAAK,MAAM,UAAU,KAAK,SACxB,AAAC,KAAa,OAAO,MAAM,OAAO,KAAK,IAAI;EAG7C,iBAAiB,IAAI;CACvB;CAEA,AAAO,oBAAoB,MAA6B;EACtD,KAAK,iBAAiB,KAAK,IAAI;CACjC;CAEA,AAAO,mBAAmB,MAA4B;EACpD,KAAK,gBAAgB,KAAK,IAAI;CAChC;CAEA,MAAa,eAAe,KAAkC;EAC5D,KAAK,MAAM,QAAQ,KAAK,kBACtB,MAAM,KAAK,GAAG;CAElB;CAEA,MAAa,cAAc,KAAmB,KAAe;EAC3D,KAAK,MAAM,QAAQ,KAAK,iBAEtB,IAAI,MADiB,KAAK,KAAK,GAAG,MACnB,SACb,OAAO;CAGb;CAEA,AAAO,UAA4B,IAA2B;EAC5D,OAAO,KAAK,QAAQ,MAAM,WAAW,OAAO,OAAO,EAAE;CACvD;CAEA,MAAa,UAAU,MAA2C;EAChE,MAAM,MAAM,MAAM,KAAK,cAAc;EACrC,OAAO,MAAM,IAAI,QAAQ;CAC3B;CAEA,MAAa,gBAAyE;EACpF,IAAI,KAAK,OAAO,SACd,IAAI;GAEF,MAAM,OAAM,MADQ,KAAK,OAAO,QAAQ,EACvB,CAAC,OAAO;GACzB,MAAM,MAA8B,CAAC;GACrC,KAAK,MAAM,KAAK,KACd,IAAI,EAAE,QAAQ,EAAE;GAElB,OAAO;EACT,QAAQ;GACN;EACF;EAGF,IAAI,OAAO,aAAa,aACtB,OAAO,YAAY,SAAS,MAAM;CAItC;AACF;;;AC1EA,SAAgB,aACd,SACsB;CACtB,OAAO,IAAI,cAAc,OAAc;AACzC"}

package/dist/core.d.ts

@@ -0,0 +1,2 @@
+import { c as CookieAttributes, d as Plugin, f as AuthulaClient, h as FetchContext, i as ApiError, l as CookieStore, m as BeforeFetchHook, n as InferPluginMethods, o as AuthulaClientConfig, p as AfterFetchHook, r as createClient, s as AuthulaClientOptions, t as ClientWithPlugins, u as FetchOptions } from "./sdk-Cu28BXFh.js";
+export { AfterFetchHook, ApiError, AuthulaClient, AuthulaClientConfig, AuthulaClientOptions, BeforeFetchHook, type ClientWithPlugins, CookieAttributes, CookieStore, FetchContext, FetchOptions, type InferPluginMethods, Plugin, createClient };

package/dist/core.js

@@ -0,0 +1,4 @@
+import { t as ApiError } from "./custom-fetch-DJxn7nVP.js";
+import { n as AuthulaClient, t as createClient } from "./core-Csdt31Tx.js";
+
+export { ApiError, AuthulaClient, createClient };

package/dist/{custom-fetch-CXJ4-i7I.js → custom-fetch-DJxn7nVP.js}

@@ -1,7 +1,18 @@
 import { parseSetCookie } from "cookie";
 import { toCamelCaseKeys, toSnakeCaseKeys } from "es-toolkit";
 
-//#region src/mutators/custom-fetch.ts
+// src/core/runtime.ts
+const DEFAULT_CLIENT = Symbol.for("authula.default-client");
+const globalStore = globalThis;
+const store = globalStore[DEFAULT_CLIENT] ??= {};
+function setDefaultClient(client) {
+	store.client = client;
+}
+function getDefaultClient() {
+	return store.client;
+}
+
+// src/core/mutators/custom-fetch.ts
 var ApiError = class extends Error {
 	status;
 	data;
@@ -80,12 +91,18 @@ function convertQueryKeysToSnakeCase(url) {
 	return `${base}?${snakeParams.toString()}`;
 }
 async function customFetch(url, options) {
-	const resolvedUrl = convertQueryKeysToSnakeCase(prependBase(url, options?.baseUrl ?? ""));
+	const client = options?.baseUrl === void 0 ? getDefaultClient() : void 0;
+	const baseUrl = options?.baseUrl ?? client?.config.url.replace(/\/+$/, "") ?? "";
+	const cookies = options?.cookies ?? client?.config.cookies;
+	const onBeforeFetch = options?.onBeforeFetch ?? (client ? client.runBeforeFetch.bind(client) : void 0);
+	const onAfterFetch = options?.onAfterFetch ?? (client ? client.runAfterFetch.bind(client) : void 0);
+	if (!baseUrl && !/^https?:\/\//.test(url)) throw new Error("No Authula client configured. Call createClient() before using Authula hooks, or pass a baseUrl request option.");
+	const resolvedUrl = convertQueryKeysToSnakeCase(prependBase(url, baseUrl));
 	const headers = new Headers(options?.headers || {});
 	let cookieStore = null;
 	let resolvedCookies;
-	if (options?.cookies) try {
-		cookieStore = await options.cookies();
+	if (cookies) try {
+		cookieStore = await cookies();
 		const all = cookieStore.getAll();
 		if (all.length > 0 && !headers.has("cookie")) headers.set("cookie", all.map((c) => `${c.name}=${c.value}`).join("; "));
 		resolvedCookies = {};
@@ -105,10 +122,10 @@ async function customFetch(url, options) {
 		meta: {},
 		cookies: resolvedCookies
 	};
-	if (options?.onBeforeFetch) await options.onBeforeFetch(ctx);
+	if (onBeforeFetch) await onBeforeFetch(ctx);
 	let res = await fetch(ctx.url, ctx.init);
-	if (options?.onAfterFetch) {
-		if (await options.onAfterFetch(ctx, res) === "retry" && !ctx.meta.retry) {
+	if (onAfterFetch) {
+		if (await onAfterFetch(ctx, res) === "retry" && !ctx.meta.retry) {
 			ctx.meta.retry = true;
 			res = await fetch(ctx.url, ctx.init);
 		}
@@ -125,6 +142,5 @@ async function customFetch(url, options) {
 	return toCamelCaseKeys(data);
 }
 
-//#endregion
-export { customFetch as n, ApiError as t };
-//# sourceMappingURL=custom-fetch-CXJ4-i7I.js.map
+export { customFetch as n, setDefaultClient as r, ApiError as t };
+//# sourceMappingURL=custom-fetch-DJxn7nVP.js.map

package/dist/custom-fetch-DJxn7nVP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-fetch-DJxn7nVP.js","names":[],"sources":["../src/core/runtime.ts","../src/core/mutators/custom-fetch.ts"],"sourcesContent":["import type { AuthulaClient } from \"./client\";\n\nconst DEFAULT_CLIENT = Symbol.for(\"authula.default-client\");\n\ntype RuntimeStore = {\n  client?: AuthulaClient;\n};\n\nconst globalStore = globalThis as unknown as Record<symbol, RuntimeStore | undefined>;\nconst store = (globalStore[DEFAULT_CLIENT] ??= {});\n\nexport function setDefaultClient(client: AuthulaClient | undefined): void {\n  store.client = client;\n}\n\nexport function getDefaultClient(): AuthulaClient | undefined {\n  return store.client;\n}\n","import { parseSetCookie } from \"cookie\";\nimport { toCamelCaseKeys, toSnakeCaseKeys } from \"es-toolkit\";\n\nimport type { FetchContext, CookieStore } from \"../types\";\nimport { getDefaultClient } from \"../runtime\";\n\nexport class ApiError extends Error {\n  status: number;\n  data: any;\n  headers: Headers;\n\n  constructor(message: string, status: number, data: any, headers: Headers) {\n    super(message || `Request failed with status ${status}`);\n    this.name = \"ApiError\";\n    this.status = status;\n    this.data = data;\n    this.headers = headers;\n  }\n}\n\nfunction prependBase(url: string, base: string): string {\n  if (!base) {\n    return url;\n  }\n  if (/^https?:\\/\\//.test(url)) {\n    return url.replace(/^https?:\\/\\/[^/]+/, base);\n  }\n  return `${base}${url.startsWith(\"/\") ? url : `/${url}`}`;\n}\n\nfunction convertRequestBodyToSnakeCase(\n  body: BodyInit | null | undefined,\n): BodyInit | null | undefined {\n  if (typeof body !== \"string\") {\n    return body;\n  }\n  try {\n    const parsed = JSON.parse(body);\n    return parsed !== null && typeof parsed === \"object\"\n      ? JSON.stringify(toSnakeCaseKeys(parsed))\n      : body;\n  } catch {\n    return body;\n  }\n}\n\nasync function parseJsonBody(res: Response): Promise<any> {\n  if ([204, 205, 304].includes(res.status)) {\n    return null;\n  }\n  const text = await res.text();\n  return text ? JSON.parse(text) : null;\n}\n\nconst KNOWN_COOKIE_ATTRS = new Set([\n  \"path\",\n  \"domain\",\n  \"expires\",\n  \"maxAge\",\n  \"httpOnly\",\n  \"secure\",\n  \"sameSite\",\n]);\n\nfunction parseSetCookieToStore(raw: string, store: CookieStore): void {\n  let parsed: Record<string, any>;\n  try {\n    parsed = parseSetCookie(raw) as Record<string, any>;\n  } catch {\n    return;\n  }\n  if (!parsed) {\n    return;\n  }\n\n  const { name, value, ...attrs } = parsed;\n  const normalized: Record<string, any> = {};\n  for (const [k, v] of Object.entries(attrs)) {\n    const lower = k.toLowerCase();\n    if (KNOWN_COOKIE_ATTRS.has(k)) {\n      normalized[k] = v;\n    } else if (lower === \"maxage\") normalized[\"maxAge\"] = v;\n    else if (lower === \"httponly\") normalized[\"httpOnly\"] = v;\n    else if (lower === \"samesite\") normalized[\"sameSite\"] = v;\n  }\n\n  try {\n    store.set(name, value, normalized);\n  } catch {\n    // store may be immutable during SSR render\n  }\n}\n\nexport function convertQueryKeysToSnakeCase(url: string): string {\n  const qIndex = url.indexOf(\"?\");\n  if (qIndex === -1) {\n    return url;\n  }\n\n  const base = url.slice(0, qIndex);\n  const searchParams = new URLSearchParams(url.slice(qIndex + 1));\n  const snakeParams = new URLSearchParams();\n\n  for (const [key, value] of searchParams.entries()) {\n    const snakeKey = key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);\n    snakeParams.append(snakeKey, value);\n  }\n\n  return `${base}?${snakeParams.toString()}`;\n}\n\nexport async function customFetch<T>(\n  url: string,\n  options?: RequestInit & {\n    method?: string;\n    baseUrl?: string;\n    cookies?: () => CookieStore | Promise<CookieStore>;\n    onBeforeFetch?: (ctx: FetchContext) => Promise<void>;\n    onAfterFetch?: (ctx: FetchContext, res: Response) => Promise<\"retry\" | void>;\n  },\n): Promise<T> {\n  const client = options?.baseUrl === undefined ? getDefaultClient() : undefined;\n  const baseUrl = options?.baseUrl ?? client?.config.url.replace(/\\/+$/, \"\") ?? \"\";\n  const cookies = options?.cookies ?? client?.config.cookies;\n  const onBeforeFetch =\n    options?.onBeforeFetch ?? (client ? client.runBeforeFetch.bind(client) : undefined);\n  const onAfterFetch =\n    options?.onAfterFetch ?? (client ? client.runAfterFetch.bind(client) : undefined);\n\n  if (!baseUrl && !/^https?:\\/\\//.test(url)) {\n    throw new Error(\n      \"No Authula client configured. Call createClient() before using Authula hooks, or pass a baseUrl request option.\",\n    );\n  }\n\n  const resolvedUrl = convertQueryKeysToSnakeCase(prependBase(url, baseUrl));\n\n  const headers = new Headers(options?.headers || {});\n\n  let cookieStore: CookieStore | null = null;\n  let resolvedCookies: Record<string, string> | undefined;\n  if (cookies) {\n    try {\n      cookieStore = await cookies();\n      const all = cookieStore.getAll();\n      if (all.length > 0 && !headers.has(\"cookie\")) {\n        headers.set(\"cookie\", all.map((c) => `${c.name}=${c.value}`).join(\"; \"));\n      }\n      resolvedCookies = {};\n      for (const c of all) {\n        resolvedCookies[c.name] = c.value;\n      }\n    } catch {\n      cookieStore = null;\n    }\n  }\n\n  const ctx: FetchContext = {\n    url: resolvedUrl,\n    init: {\n      method: options?.method ?? \"GET\",\n      headers,\n      body: convertRequestBodyToSnakeCase(options?.body),\n      credentials: \"include\",\n      signal: options?.signal ?? null,\n    },\n    meta: {},\n    cookies: resolvedCookies,\n  };\n\n  if (onBeforeFetch) {\n    await onBeforeFetch(ctx);\n  }\n\n  let res = await fetch(ctx.url, ctx.init);\n\n  if (onAfterFetch) {\n    const action = await onAfterFetch(ctx, res);\n    if (action === \"retry\" && !ctx.meta.retry) {\n      ctx.meta.retry = true;\n      res = await fetch(ctx.url, ctx.init);\n    }\n  }\n\n  if (cookieStore) {\n    const values: string[] =\n      typeof res.headers.getSetCookie === \"function\"\n        ? res.headers.getSetCookie()\n        : (res.headers.get(\"set-cookie\")?.split(\", \") ?? []);\n    for (const raw of values) {\n      parseSetCookieToStore(raw, cookieStore);\n    }\n  }\n\n  const data = await parseJsonBody(res);\n\n  if (!res.ok) {\n    const message =\n      typeof data === \"object\" && data !== null && \"message\" in data ? String(data.message) : \"\";\n    throw new ApiError(message, res.status, data, res.headers);\n  }\n\n  return toCamelCaseKeys(data) as T;\n}\n"],"mappings":";;;;AAEA,MAAM,iBAAiB,OAAO,IAAI,wBAAwB;AAM1D,MAAM,cAAc;AACpB,MAAM,QAAS,YAAY,oBAAoB,CAAC;AAEhD,SAAgB,iBAAiB,QAAyC;CACxE,MAAM,SAAS;AACjB;AAEA,SAAgB,mBAA8C;CAC5D,OAAO,MAAM;AACf;;;ACXA,IAAa,WAAb,cAA8B,MAAM;CAClC;CACA;CACA;CAEA,YAAY,SAAiB,QAAgB,MAAW,SAAkB;EACxE,MAAM,WAAW,8BAA8B,QAAQ;EACvD,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,OAAO;EACZ,KAAK,UAAU;CACjB;AACF;AAEA,SAAS,YAAY,KAAa,MAAsB;CACtD,IAAI,CAAC,MACH,OAAO;CAET,IAAI,eAAe,KAAK,GAAG,GACzB,OAAO,IAAI,QAAQ,qBAAqB,IAAI;CAE9C,OAAO,GAAG,OAAO,IAAI,WAAW,GAAG,IAAI,MAAM,IAAI;AACnD;AAEA,SAAS,8BACP,MAC6B;CAC7B,IAAI,OAAO,SAAS,UAClB,OAAO;CAET,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;EAC9B,OAAO,WAAW,QAAQ,OAAO,WAAW,WACxC,KAAK,UAAU,gBAAgB,MAAM,CAAC,IACtC;CACN,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAe,cAAc,KAA6B;CACxD,IAAI;EAAC;EAAK;EAAK;CAAG,CAAC,CAAC,SAAS,IAAI,MAAM,GACrC,OAAO;CAET,MAAM,OAAO,MAAM,IAAI,KAAK;CAC5B,OAAO,OAAO,KAAK,MAAM,IAAI,IAAI;AACnC;AAEA,MAAM,qCAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,SAAS,sBAAsB,KAAa,OAA0B;CACpE,IAAI;CACJ,IAAI;EACF,SAAS,eAAe,GAAG;CAC7B,QAAQ;EACN;CACF;CACA,IAAI,CAAC,QACH;CAGF,MAAM,EAAE,MAAM,OAAO,GAAG,UAAU;CAClC,MAAM,aAAkC,CAAC;CACzC,KAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,KAAK,GAAG;EAC1C,MAAM,QAAQ,EAAE,YAAY;EAC5B,IAAI,mBAAmB,IAAI,CAAC,GAC1B,WAAW,KAAK;OACX,IAAI,UAAU,UAAU,WAAW,YAAY;OACjD,IAAI,UAAU,YAAY,WAAW,cAAc;OACnD,IAAI,UAAU,YAAY,WAAW,cAAc;CAC1D;CAEA,IAAI;EACF,MAAM,IAAI,MAAM,OAAO,UAAU;CACnC,QAAQ,CAER;AACF;AAEA,SAAgB,4BAA4B,KAAqB;CAC/D,MAAM,SAAS,IAAI,QAAQ,GAAG;CAC9B,IAAI,WAAW,IACb,OAAO;CAGT,MAAM,OAAO,IAAI,MAAM,GAAG,MAAM;CAChC,MAAM,eAAe,IAAI,gBAAgB,IAAI,MAAM,SAAS,CAAC,CAAC;CAC9D,MAAM,cAAc,IAAI,gBAAgB;CAExC,KAAK,MAAM,CAAC,KAAK,UAAU,aAAa,QAAQ,GAAG;EACjD,MAAM,WAAW,IAAI,QAAQ,WAAW,MAAM,IAAI,EAAE,YAAY,GAAG;EACnE,YAAY,OAAO,UAAU,KAAK;CACpC;CAEA,OAAO,GAAG,KAAK,GAAG,YAAY,SAAS;AACzC;AAEA,eAAsB,YACpB,KACA,SAOY;CACZ,MAAM,SAAS,SAAS,YAAY,SAAY,iBAAiB,IAAI;CACrE,MAAM,UAAU,SAAS,WAAW,QAAQ,OAAO,IAAI,QAAQ,QAAQ,EAAE,KAAK;CAC9E,MAAM,UAAU,SAAS,WAAW,QAAQ,OAAO;CACnD,MAAM,gBACJ,SAAS,kBAAkB,SAAS,OAAO,eAAe,KAAK,MAAM,IAAI;CAC3E,MAAM,eACJ,SAAS,iBAAiB,SAAS,OAAO,cAAc,KAAK,MAAM,IAAI;CAEzE,IAAI,CAAC,WAAW,CAAC,eAAe,KAAK,GAAG,GACtC,MAAM,IAAI,MACR,iHACF;CAGF,MAAM,cAAc,4BAA4B,YAAY,KAAK,OAAO,CAAC;CAEzE,MAAM,UAAU,IAAI,QAAQ,SAAS,WAAW,CAAC,CAAC;CAElD,IAAI,cAAkC;CACtC,IAAI;CACJ,IAAI,SACF,IAAI;EACF,cAAc,MAAM,QAAQ;EAC5B,MAAM,MAAM,YAAY,OAAO;EAC/B,IAAI,IAAI,SAAS,KAAK,CAAC,QAAQ,IAAI,QAAQ,GACzC,QAAQ,IAAI,UAAU,IAAI,KAAK,MAAM,GAAG,EAAE,KAAK,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;EAEzE,kBAAkB,CAAC;EACnB,KAAK,MAAM,KAAK,KACd,gBAAgB,EAAE,QAAQ,EAAE;CAEhC,QAAQ;EACN,cAAc;CAChB;CAGF,MAAM,MAAoB;EACxB,KAAK;EACL,MAAM;GACJ,QAAQ,SAAS,UAAU;GAC3B;GACA,MAAM,8BAA8B,SAAS,IAAI;GACjD,aAAa;GACb,QAAQ,SAAS,UAAU;EAC7B;EACA,MAAM,CAAC;EACP,SAAS;CACX;CAEA,IAAI,eACF,MAAM,cAAc,GAAG;CAGzB,IAAI,MAAM,MAAM,MAAM,IAAI,KAAK,IAAI,IAAI;CAEvC,IAAI,cAEF;MAAI,MADiB,aAAa,KAAK,GAAG,MAC3B,WAAW,CAAC,IAAI,KAAK,OAAO;GACzC,IAAI,KAAK,QAAQ;GACjB,MAAM,MAAM,MAAM,IAAI,KAAK,IAAI,IAAI;EACrC;;CAGF,IAAI,aAAa;EACf,MAAM,SACJ,OAAO,IAAI,QAAQ,iBAAiB,aAChC,IAAI,QAAQ,aAAa,IACxB,IAAI,QAAQ,IAAI,YAAY,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC;EACtD,KAAK,MAAM,OAAO,QAChB,sBAAsB,KAAK,WAAW;CAE1C;CAEA,MAAM,OAAO,MAAM,cAAc,GAAG;CAEpC,IAAI,CAAC,IAAI,IAAI;EACX,MAAM,UACJ,OAAO,SAAS,YAAY,SAAS,QAAQ,aAAa,OAAO,OAAO,KAAK,OAAO,IAAI;EAC1F,MAAM,IAAI,SAAS,SAAS,IAAI,QAAQ,MAAM,IAAI,OAAO;CAC3D;CAEA,OAAO,gBAAgB,IAAI;AAC7B"}

package/dist/framework-client-CsGjKPXl.d.ts

@@ -0,0 +1,8 @@
+import { d as Plugin, f as AuthulaClient, n as InferPluginMethods } from "./sdk-Cu28BXFh.js";
+type HookPrefix = "use" | "create";
+type HookName<Prefix extends HookPrefix, Method extends PropertyKey> = Method extends string ? `${Prefix}${Capitalize<Method>}` : never;
+type PluginHooks<P extends Plugin, G extends object, Prefix extends HookPrefix> = { [K in keyof G as K extends HookName<Prefix, keyof InferPluginMethods<P>> ? K : never]: G[K]; };
+type WithFrameworkApi<P extends Plugin, G extends object, Prefix extends HookPrefix> = [InferPluginMethods<P>] extends [void] ? InferPluginMethods<P> : InferPluginMethods<P> & PluginHooks<P, G, Prefix>;
+type ClientWithPluginHooks<T extends readonly Plugin[], G extends object, Prefix extends HookPrefix> = AuthulaClient & { [P in T[number] as P["id"]]: WithFrameworkApi<P, G, Prefix>; };
+export { ClientWithPluginHooks as t };
+//# sourceMappingURL=framework-client-CsGjKPXl.d.ts.map

package/dist/framework-client-D-yGjqAx.js

@@ -0,0 +1,50 @@
+// src/core/framework-client.ts
+function hookName(prefix, method) {
+	return `${prefix}${method.charAt(0).toUpperCase()}${method.slice(1)}`;
+}
+function createRequestContext(client) {
+	return {
+		baseUrl: client.config.url.replace(/\/+$/, ""),
+		cookies: client.config.cookies,
+		onBeforeFetch: (ctx) => client.runBeforeFetch(ctx),
+		onAfterFetch: (ctx, res) => client.runAfterFetch(ctx, res)
+	};
+}
+function wrapHook(hook, client) {
+	const requestContext = createRequestContext(client);
+	return (...args) => {
+		let optionsIdx = Math.max(0, hook.length - 2);
+		if (args[optionsIdx] != null && typeof args[optionsIdx] !== "object") optionsIdx = Math.max(0, hook.length - 1);
+		while (args.length <= optionsIdx) args.push(void 0);
+		const existing = args[optionsIdx];
+		const existingOptions = typeof existing === "object" && existing !== null ? existing : {};
+		const existingRequest = existingOptions.request;
+		args[optionsIdx] = {
+			...existingOptions,
+			request: {
+				...requestContext,
+				...existingRequest
+			}
+		};
+		return hook(...args);
+	};
+}
+function attachFrameworkHooks(client, plugins, generated, prefix) {
+	const generatedHooks = generated;
+	const pluginApis = client;
+	for (const plugin of plugins) {
+		const api = pluginApis[plugin.id];
+		if (!api || typeof api !== "object") continue;
+		const pluginApi = api;
+		for (const [method, value] of Object.entries(pluginApi)) {
+			if (typeof value !== "function") continue;
+			const name = hookName(prefix, method);
+			const hook = generatedHooks[name];
+			if (typeof hook === "function") pluginApi[name] = wrapHook(hook, client);
+		}
+	}
+	return client;
+}
+
+export { attachFrameworkHooks as t };
+//# sourceMappingURL=framework-client-D-yGjqAx.js.map

package/dist/framework-client-D-yGjqAx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-client-D-yGjqAx.js","names":[],"sources":["../src/core/framework-client.ts"],"sourcesContent":["import type { AuthulaClient } from \"./client\";\nimport type { InferPluginMethods } from \"./sdk\";\nimport type { Plugin } from \"./types\";\n\nexport type HookPrefix = \"use\" | \"create\";\n\ntype HookName<Prefix extends HookPrefix, Method extends PropertyKey> = Method extends string\n  ? `${Prefix}${Capitalize<Method>}`\n  : never;\n\ntype PluginHooks<P extends Plugin, G extends object, Prefix extends HookPrefix> = {\n  [K in keyof G as K extends HookName<Prefix, keyof InferPluginMethods<P>> ? K : never]: G[K];\n};\n\ntype WithFrameworkApi<P extends Plugin, G extends object, Prefix extends HookPrefix> = [\n  InferPluginMethods<P>,\n] extends [void]\n  ? InferPluginMethods<P>\n  : InferPluginMethods<P> & PluginHooks<P, G, Prefix>;\n\nexport type ClientWithPluginHooks<\n  T extends readonly Plugin[],\n  G extends object,\n  Prefix extends HookPrefix,\n> = AuthulaClient & {\n  [P in T[number] as P[\"id\"]]: WithFrameworkApi<P, G, Prefix>;\n};\n\ntype AnyFunction = (...args: any[]) => any;\n\nfunction hookName(prefix: HookPrefix, method: string): string {\n  return `${prefix}${method.charAt(0).toUpperCase()}${method.slice(1)}`;\n}\n\nfunction createRequestContext(client: AuthulaClient) {\n  return {\n    baseUrl: client.config.url.replace(/\\/+$/, \"\"),\n    cookies: client.config.cookies,\n    onBeforeFetch: (ctx: any) => client.runBeforeFetch(ctx),\n    onAfterFetch: (ctx: any, res: Response) => client.runAfterFetch(ctx, res),\n  };\n}\n\nexport function wrapHook(hook: AnyFunction, client: AuthulaClient): AnyFunction {\n  const requestContext = createRequestContext(client);\n\n  return (...args: any[]) => {\n    let optionsIdx = Math.max(0, hook.length - 2);\n    if (args[optionsIdx] != null && typeof args[optionsIdx] !== \"object\") {\n      optionsIdx = Math.max(0, hook.length - 1);\n    }\n    while (args.length <= optionsIdx) {\n      args.push(undefined);\n    }\n\n    const existing = args[optionsIdx];\n    const existingOptions = typeof existing === \"object\" && existing !== null ? existing : {};\n    const existingRequest = (existingOptions as { request?: object }).request;\n\n    args[optionsIdx] = {\n      ...existingOptions,\n      // Explicit per-call values win over the client defaults, so SSR callers\n      // can override cookies/baseUrl for a single request.\n      request: { ...requestContext, ...existingRequest },\n    };\n\n    return hook(...args);\n  };\n}\n\nexport function attachFrameworkHooks<\n  T extends readonly Plugin[],\n  G extends object,\n  Prefix extends HookPrefix,\n>(\n  client: AuthulaClient,\n  plugins: T,\n  generated: G,\n  prefix: Prefix,\n): ClientWithPluginHooks<T, G, Prefix> {\n  const generatedHooks = generated as Record<string, unknown>;\n  const pluginApis = client as unknown as Record<string, unknown>;\n\n  for (const plugin of plugins) {\n    const api = pluginApis[plugin.id];\n    if (!api || typeof api !== \"object\") {\n      continue;\n    }\n\n    const pluginApi = api as Record<string, unknown>;\n    for (const [method, value] of Object.entries(pluginApi)) {\n      if (typeof value !== \"function\") {\n        continue;\n      }\n\n      const name = hookName(prefix, method);\n      const hook = generatedHooks[name];\n      if (typeof hook === \"function\") {\n        pluginApi[name] = wrapHook(hook as AnyFunction, client);\n      }\n    }\n  }\n\n  return client as ClientWithPluginHooks<T, G, Prefix>;\n}\n"],"mappings":";AA8BA,SAAS,SAAS,QAAoB,QAAwB;CAC5D,OAAO,GAAG,SAAS,OAAO,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,OAAO,MAAM,CAAC;AACpE;AAEA,SAAS,qBAAqB,QAAuB;CACnD,OAAO;EACL,SAAS,OAAO,OAAO,IAAI,QAAQ,QAAQ,EAAE;EAC7C,SAAS,OAAO,OAAO;EACvB,gBAAgB,QAAa,OAAO,eAAe,GAAG;EACtD,eAAe,KAAU,QAAkB,OAAO,cAAc,KAAK,GAAG;CAC1E;AACF;AAEA,SAAgB,SAAS,MAAmB,QAAoC;CAC9E,MAAM,iBAAiB,qBAAqB,MAAM;CAElD,QAAQ,GAAG,SAAgB;EACzB,IAAI,aAAa,KAAK,IAAI,GAAG,KAAK,SAAS,CAAC;EAC5C,IAAI,KAAK,eAAe,QAAQ,OAAO,KAAK,gBAAgB,UAC1D,aAAa,KAAK,IAAI,GAAG,KAAK,SAAS,CAAC;EAE1C,OAAO,KAAK,UAAU,YACpB,KAAK,KAAK,MAAS;EAGrB,MAAM,WAAW,KAAK;EACtB,MAAM,kBAAkB,OAAO,aAAa,YAAY,aAAa,OAAO,WAAW,CAAC;EACxF,MAAM,kBAAmB,gBAAyC;EAElE,KAAK,cAAc;GACjB,GAAG;GAGH,SAAS;IAAE,GAAG;IAAgB,GAAG;GAAgB;EACnD;EAEA,OAAO,KAAK,GAAG,IAAI;CACrB;AACF;AAEA,SAAgB,qBAKd,QACA,SACA,WACA,QACqC;CACrC,MAAM,iBAAiB;CACvB,MAAM,aAAa;CAEnB,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,MAAM,WAAW,OAAO;EAC9B,IAAI,CAAC,OAAO,OAAO,QAAQ,UACzB;EAGF,MAAM,YAAY;EAClB,KAAK,MAAM,CAAC,QAAQ,UAAU,OAAO,QAAQ,SAAS,GAAG;GACvD,IAAI,OAAO,UAAU,YACnB;GAGF,MAAM,OAAO,SAAS,QAAQ,MAAM;GACpC,MAAM,OAAO,eAAe;GAC5B,IAAI,OAAO,SAAS,YAClB,UAAU,QAAQ,SAAS,MAAqB,MAAM;EAE1D;CACF;CAEA,OAAO;AACT"}