@draftlab/auth 0.14.0 → 0.15.1

package/dist/storage/storage.d.mts

@@ -10,34 +10,34 @@
  */
 interface StorageAdapter {
   /**
-   * Retrieves a value by its key path.
-   *
-   * @param key - Array of key segments forming the storage path
-   * @returns Promise resolving to the stored value or undefined if not found
-   */
+       * Retrieves a value by its key path.
+       *
+       * @param key - Array of key segments forming the storage path
+       * @returns Promise resolving to the stored value or undefined if not found
+       */
   get(key: string[]): Promise<Record<string, unknown> | undefined>;
   /**
-   * Removes a value by its key path.
-   *
-   * @param key - Array of key segments forming the storage path
-   * @returns Promise that resolves when removal is complete
-   */
+       * Removes a value by its key path.
+       *
+       * @param key - Array of key segments forming the storage path
+       * @returns Promise that resolves when removal is complete
+       */
   remove(key: string[]): Promise<void>;
   /**
-   * Stores a value with an optional expiration date.
-   *
-   * @param key - Array of key segments forming the storage path
-   * @param value - The value to store
-   * @param expiry - Optional expiration date for automatic cleanup
-   * @returns Promise that resolves when storage is complete
-   */
+       * Stores a value with an optional expiration date.
+       *
+       * @param key - Array of key segments forming the storage path
+       * @param value - The value to store
+       * @param expiry - Optional expiration date for automatic cleanup
+       * @returns Promise that resolves when storage is complete
+       */
   set(key: string[], value: unknown, expiry?: Date): Promise<void>;
   /**
-   * Scans for keys matching a prefix pattern.
-   *
-   * @param prefix - Array of key segments to use as prefix filter
-   * @returns Async iterable of key-value pairs matching the prefix
-   */
+       * Scans for keys matching a prefix pattern.
+       *
+       * @param prefix - Array of key segments to use as prefix filter
+       * @returns Async iterable of key-value pairs matching the prefix
+       */
   scan(prefix: string[]): AsyncIterable<readonly [string[], unknown]>;
 }
 /**
@@ -75,104 +75,104 @@ declare const splitKey: (key: string) => string[];
  */
 declare const Storage: {
   /**
-   * Encodes key segments by escaping special characters.
-   * Ensures storage keys don't contain unescaped separator characters that could cause collisions.
-   *
-   * @param key - Array of key segments to encode
-   * @returns Array of properly escaped key segments
-   *
-   * @throws {Error} If any segment is empty or whitespace-only
-   *
-   * @example
-   * ```ts
-   * Storage.encode(['user', 'data\x1fwith\x1fseparators'])
-   * // Returns: ['user', 'data\\x1fwith\\x1fseparators']
-   * ```
-   */
+       * Encodes key segments by escaping special characters.
+       * Ensures storage keys don't contain unescaped separator characters that could cause collisions.
+       *
+       * @param key - Array of key segments to encode
+       * @returns Array of properly escaped key segments
+       *
+       * @throws {Error} If any segment is empty or whitespace-only
+       *
+       * @example
+       * ```ts
+       * Storage.encode(['user', 'data\x1fwith\x1fseparators'])
+       * // Returns: ['user', 'data\\x1fwith\\x1fseparators']
+       * ```
+       */
   readonly encode: (key: string[]) => string[];
   /**
-   * Decodes key segments by unescaping special characters.
-   * Reverse operation of encode().
-   *
-   * @param key - Array of encoded key segments
-   * @returns Array of decoded key segments
-   *
-   * @internal
-   */
+       * Decodes key segments by unescaping special characters.
+       * Reverse operation of encode().
+       *
+       * @param key - Array of encoded key segments
+       * @returns Array of decoded key segments
+       *
+       * @internal
+       */
   readonly decode: (key: string[]) => string[];
   /**
-   * Retrieves a typed value from storage.
-   *
-   * @template T - Expected type of the stored value
-   * @param adapter - Storage adapter to use
-   * @param key - Array of key segments identifying the value
-   * @returns Promise resolving to the typed value or null if not found
-   *
-   * @example
-   * ```ts
-   * interface UserSession {
-   *   userId: string
-   *   expiresAt: number
-   * }
-   *
-   * const session = await Storage.get<UserSession>(adapter, ['sessions', sessionId])
-   * if (session) {
-   *   // Fully typed: session.userId
-   * }
-   * ```
-   */
+       * Retrieves a typed value from storage.
+       *
+       * @template T - Expected type of the stored value
+       * @param adapter - Storage adapter to use
+       * @param key - Array of key segments identifying the value
+       * @returns Promise resolving to the typed value or null if not found
+       *
+       * @example
+       * ```ts
+       * interface UserSession {
+       *   userId: string
+       *   expiresAt: number
+       * }
+       *
+       * const session = await Storage.get<UserSession>(adapter, ['sessions', sessionId])
+       * if (session) {
+       *   // Fully typed: session.userId
+       * }
+       * ```
+       */
   readonly get: <T = Record<string, unknown>>(adapter: StorageAdapter, key: string[]) => Promise<T | null>;
   /**
-   * Stores a value with optional time-to-live in seconds.
-   * Validates that TTL is a positive integer to prevent edge cases like negative or overflow values.
-   *
-   * @param adapter - Storage adapter to use
-   * @param key - Array of key segments identifying where to store
-   * @param value - The value to store
-   * @param ttlSeconds - Optional TTL in seconds for automatic expiration
-   * @returns Promise that resolves when storage is complete
-   *
-   * @throws {RangeError} If TTL is invalid (negative, non-integer, or exceeds maximum)
-   *
-   * @example
-   * ```ts
-   * // Store with 1 hour TTL
-   * await Storage.set(adapter, ['sessions', sessionId], sessionData, 3600)
-   *
-   * // Store permanently (no expiration)
-   * await Storage.set(adapter, ['users', userId], userData)
-   * ```
-   */
+       * Stores a value with optional time-to-live in seconds.
+       * Validates that TTL is a positive integer to prevent edge cases like negative or overflow values.
+       *
+       * @param adapter - Storage adapter to use
+       * @param key - Array of key segments identifying where to store
+       * @param value - The value to store
+       * @param ttlSeconds - Optional TTL in seconds for automatic expiration
+       * @returns Promise that resolves when storage is complete
+       *
+       * @throws {RangeError} If TTL is invalid (negative, non-integer, or exceeds maximum)
+       *
+       * @example
+       * ```ts
+       * // Store with 1 hour TTL
+       * await Storage.set(adapter, ['sessions', sessionId], sessionData, 3600)
+       *
+       * // Store permanently (no expiration)
+       * await Storage.set(adapter, ['users', userId], userData)
+       * ```
+       */
   readonly set: (adapter: StorageAdapter, key: string[], value: unknown, ttlSeconds?: number) => Promise<void>;
   /**
-   * Removes a value from storage.
-   *
-   * @param adapter - Storage adapter to use
-   * @param key - Array of key segments identifying the value to remove
-   * @returns Promise that resolves when removal is complete
-   *
-   * @example
-   * ```ts
-   * await Storage.remove(adapter, ['sessions', expiredSessionId])
-   * ```
-   */
+       * Removes a value from storage.
+       *
+       * @param adapter - Storage adapter to use
+       * @param key - Array of key segments identifying the value to remove
+       * @returns Promise that resolves when removal is complete
+       *
+       * @example
+       * ```ts
+       * await Storage.remove(adapter, ['sessions', expiredSessionId])
+       * ```
+       */
   readonly remove: (adapter: StorageAdapter, key: string[]) => Promise<void>;
   /**
-   * Scans for entries matching a key prefix with type safety.
-   *
-   * @template T - Expected type of the stored values
-   * @param adapter - Storage adapter to use
-   * @param prefix - Array of key segments to use as prefix filter
-   * @returns Async iterable of typed key-value pairs
-   *
-   * @example
-   * ```ts
-   * // Find all user sessions
-   * for await (const [key, session] of Storage.scan<UserSession>(adapter, ['sessions'])) {
-   *   // Session: `${key.join('/')} expires at ${session.expiresAt}`
-   * }
-   * ```
-   */
+       * Scans for entries matching a key prefix with type safety.
+       *
+       * @template T - Expected type of the stored values
+       * @param adapter - Storage adapter to use
+       * @param prefix - Array of key segments to use as prefix filter
+       * @returns Async iterable of typed key-value pairs
+       *
+       * @example
+       * ```ts
+       * // Find all user sessions
+       * for await (const [key, session] of Storage.scan<UserSession>(adapter, ['sessions'])) {
+       *   // Session: `${key.join('/')} expires at ${session.expiresAt}`
+       * }
+       * ```
+       */
   readonly scan: <T = Record<string, unknown>>(adapter: StorageAdapter, prefix: string[]) => AsyncIterable<readonly [string[], T]>;
 };
 //#endregion

package/dist/storage/turso.d.mts

@@ -2,7 +2,6 @@ import { StorageAdapter } from "./storage.mjs";
 import { Client } from "@libsql/client";
 
 //#region src/storage/turso.d.ts
-
 /**
  * Creates a Turso storage adapter using the provided LibSQL client.
  * Automatically initializes the required database table and implements

package/dist/storage/unstorage.d.mts

@@ -2,7 +2,6 @@ import { StorageAdapter } from "./storage.mjs";
 import { Driver } from "unstorage";
 
 //#region src/storage/unstorage.d.ts
-
 /**
  * Creates a Draft Auth storage adapter using Unstorage drivers.
  * Supports automatic expiration, error handling, and any Unstorage driver.

package/dist/subject.d.mts

@@ -2,7 +2,6 @@ import { Prettify } from "./util.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/subject.d.ts
-
 /**
  * Schema definition for subjects, mapping subject type names to their validation schemas.
  * Each key represents a subject type, and each value is a schema that validates

package/dist/themes/theme.d.mts

@@ -46,12 +46,12 @@
  */
 interface ColorScheme {
   /**
-   * The value for dark mode.
-   */
+       * The value for dark mode.
+       */
   dark: string;
   /**
-   * The value for light mode.
-   */
+       * The value for light mode.
+       */
   light: string;
 }
 /**
@@ -59,122 +59,122 @@ interface ColorScheme {
  */
 interface Theme {
   /**
-   * The name of your app. Also used as the title of the page.
-   *
-   * @example
-   * ```ts
-   * {
-   *   title: "Acne"
-   * }
-   * ```
-   */
+       * The name of your app. Also used as the title of the page.
+       *
+       * @example
+       * ```ts
+       * {
+       *   title: "Acne"
+       * }
+       * ```
+       */
   title?: string;
   /**
-   * A URL to the favicon of your app.
-   *
-   * @example
-   * ```ts
-   * {
-   *   favicon: "https://www.example.com/favicon.svg"
-   * }
-   * ```
-   */
+       * A URL to the favicon of your app.
+       *
+       * @example
+       * ```ts
+       * {
+       *   favicon: "https://www.example.com/favicon.svg"
+       * }
+       * ```
+       */
   favicon?: string;
   /**
-   * The border radius of the UI elements.
-   *
-   * @example
-   * ```ts
-   * {
-   *   radius: "none"
-   * }
-   * ```
-   */
+       * The border radius of the UI elements.
+       *
+       * @example
+       * ```ts
+       * {
+       *   radius: "none"
+       * }
+       * ```
+       */
   radius?: "none" | "sm" | "md" | "lg" | "full";
   /**
-   * The primary color of the theme.
-   *
-   * Takes a color or both light and dark colors.
-   *
-   * @example
-   * ```ts
-   * {
-   *   primary: "#FF5E00"
-   * }
-   * ```
-   */
+       * The primary color of the theme.
+       *
+       * Takes a color or both light and dark colors.
+       *
+       * @example
+       * ```ts
+       * {
+       *   primary: "#FF5E00"
+       * }
+       * ```
+       */
   primary: string | ColorScheme;
   /**
-   * The background color of the theme.
-   *
-   * Takes a color or both light and dark colors.
-   *
-   * @example
-   * ```ts
-   * {
-   *   background: "#FFF"
-   * }
-   * ```
-   */
+       * The background color of the theme.
+       *
+       * Takes a color or both light and dark colors.
+       *
+       * @example
+       * ```ts
+       * {
+       *   background: "#FFF"
+       * }
+       * ```
+       */
   background?: string | ColorScheme;
   /**
-   * A URL to the logo of your app.
-   *
-   * Takes a single image or both light and dark mode versions.
-   *
-   * @example
-   * ```ts
-   * {
-   *   logo: "https://www.example.com/logo.svg"
-   * }
-   * ```
-   */
+       * A URL to the logo of your app.
+       *
+       * Takes a single image or both light and dark mode versions.
+       *
+       * @example
+       * ```ts
+       * {
+       *   logo: "https://www.example.com/logo.svg"
+       * }
+       * ```
+       */
   logo?: string | ColorScheme;
   /**
-   * The font family and scale of the theme.
-   */
+       * The font family and scale of the theme.
+       */
   font?: {
     /**
-     * The font family of the theme.
-     *
-     * @example
-     * ```ts
-     * {
-     *   font: {
-     *     family: "Geist Mono, monospace"
-     *   }
-     * }
-     * ```
-     */
+             * The font family of the theme.
+             *
+             * @example
+             * ```ts
+             * {
+             *   font: {
+             *     family: "Geist Mono, monospace"
+             *   }
+             * }
+             * ```
+             */
     family?: string;
     /**
-     * The font scale of the theme. Can be used to increase or decrease the font sizes across
-     * the UI.
-     *
-     * @default "1"
-     * @example
-     * ```ts
-     * {
-     *   font: {
-     *     scale: "1.25"
-     *   }
-     * }
-     * ```
-     */
+             * The font scale of the theme. Can be used to increase or decrease the font sizes across
+             * the UI.
+             *
+             * @default "1"
+             * @example
+             * ```ts
+             * {
+             *   font: {
+             *     scale: "1.25"
+             *   }
+             * }
+             * ```
+             */
     scale?: string;
   };
   /**
-   * Custom CSS that's added to the page in a `<style>` tag.
-   *
-   * This can be used to import custom fonts.
-   *
-   * @example
-   * ```ts
-   * {
-   *   css: `@import url('https://fonts.googleapis.com/css2?family=Rubik:wght@100;200;300;400;500;600;700;800;900&display=swap');`
-   * }
-   * ```
-   */
+       * Custom CSS that's added to the page in a `<style>` tag.
+       *
+       * This can be used to import custom fonts.
+       *
+       * @example
+       * ```ts
+       * {
+       *   css: `@import url('https://fonts.googleapis.com/css2?family=Rubik:wght@100;200;300;400;500;600;700;800;900&display=swap');`
+       * }
+       * ```
+       */
   css?: string;
 }
 /**

package/dist/toolkit/client.d.mts

@@ -2,7 +2,6 @@ import { OAuthStrategy } from "./providers/strategy.mjs";
 import { AuthStorage } from "./storage.mjs";
 
 //#region src/toolkit/client.d.ts
-
 /**
  * Configuration for a single OAuth provider.
  */
@@ -60,69 +59,69 @@ interface OAuthClientConfig<TProviders extends Record<string, ProviderConfig<OAu
  */
 interface OAuthClient<TProviders extends Record<string, ProviderConfig<OAuthStrategy>>> {
   /**
-   * Initiate OAuth authorization flow.
-   *
-   * @param provider - Provider name (key from providers config)
-   * @param options - Authorization options
-   * @returns Authorization URL to redirect user to
-   *
-   * @example
-   * ```ts
-   * // Basic usage
-   * const { url } = await client.authorize('github')
-   * window.location.href = url
-   *
-   * // With custom scopes
-   * const { url } = await client.authorize('google', {
-   *   scopes: ['openid', 'email', 'profile']
-   * })
-   *
-   * // With additional params
-   * const { url } = await client.authorize('github', {
-   *   params: { prompt: 'consent' }
-   * })
-   * ```
-   */
+       * Initiate OAuth authorization flow.
+       *
+       * @param provider - Provider name (key from providers config)
+       * @param options - Authorization options
+       * @returns Authorization URL to redirect user to
+       *
+       * @example
+       * ```ts
+       * // Basic usage
+       * const { url } = await client.authorize('github')
+       * window.location.href = url
+       *
+       * // With custom scopes
+       * const { url } = await client.authorize('google', {
+       *   scopes: ['openid', 'email', 'profile']
+       * })
+       *
+       * // With additional params
+       * const { url } = await client.authorize('github', {
+       *   params: { prompt: 'consent' }
+       * })
+       * ```
+       */
   authorize(provider: (string & {}) | keyof TProviders, options?: AuthorizeOptions): Promise<{
     url: string;
     state: string;
   }>;
   /**
-   * Handle OAuth callback and exchange code for tokens.
-   *
-   * @param callbackUrl - Full callback URL with query parameters
-   * @returns Token exchange result
-   *
-   * @throws {Error} If callback URL is invalid, state mismatch, or token exchange fails
-   *
-   * @example
-   * ```ts
-   * // Client-side
-   * const result = await client.handleCallback(window.location.href)
-   * console.log(result.accessToken, result.provider)
-   *
-   * // Server-side (Next.js)
-   * export async function GET(req: Request) {
-   *   const result = await client.handleCallback(req.url)
-   *   // Store tokens, create session, etc.
-   *   return Response.redirect('/')
-   * }
-   * ```
-   */
+       * Handle OAuth callback and exchange code for tokens.
+       *
+       * @param callbackUrl - Full callback URL with query parameters
+       * @returns Token exchange result
+       *
+       * @throws {Error} If callback URL is invalid, state mismatch, or token exchange fails
+       *
+       * @example
+       * ```ts
+       * // Client-side
+       * const result = await client.handleCallback(window.location.href)
+       * console.log(result.accessToken, result.provider)
+       *
+       * // Server-side (Next.js)
+       * export async function GET(req: Request) {
+       *   const result = await client.handleCallback(req.url)
+       *   // Store tokens, create session, etc.
+       *   return Response.redirect('/')
+       * }
+       * ```
+       */
   handleCallback(callbackUrl: string): Promise<CallbackResult>;
   /**
-   * Get user info from OAuth provider using access token.
-   *
-   * @param provider - Provider name
-   * @param accessToken - Access token from provider
-   * @returns User info from provider
-   *
-   * @example
-   * ```ts
-   * const userInfo = await client.getUserInfo('github', accessToken)
-   * console.log(userInfo.email, userInfo.name)
-   * ```
-   */
+       * Get user info from OAuth provider using access token.
+       *
+       * @param provider - Provider name
+       * @param accessToken - Access token from provider
+       * @returns User info from provider
+       *
+       * @example
+       * ```ts
+       * const userInfo = await client.getUserInfo('github', accessToken)
+       * console.log(userInfo.email, userInfo.name)
+       * ```
+       */
   getUserInfo(provider: (string & {}) | keyof TProviders, accessToken: string): Promise<Record<string, unknown>>;
 }
 /**

package/dist/toolkit/providers/facebook.d.mts

@@ -1,7 +1,6 @@
 import { OAuthStrategy } from "./strategy.mjs";
 
 //#region src/toolkit/providers/facebook.d.ts
-
 /**
  * Facebook OAuth 2.0 strategy.
  *

package/dist/toolkit/providers/github.d.mts

@@ -1,7 +1,6 @@
 import { OAuthStrategy } from "./strategy.mjs";
 
 //#region src/toolkit/providers/github.d.ts
-
 /**
  * GitHub OAuth 2.0 strategy.
  *