@molecule/app-solid 1.0.0

package/dist/primitives/index.js

@@ -0,0 +1,27 @@
+/**
+ * Solid.js primitives for molecule.dev framework bindings.
+ *
+ * @module
+ */
+export * from './async-state.js';
+export * from './auth.js';
+export * from './capacitor-app.js';
+export * from './change-password.js';
+export * from './device.js';
+export * from './forms.js';
+export * from './http.js';
+export * from './i18n.js';
+export * from './logger.js';
+export * from './login.js';
+export * from './oauth.js';
+export * from './password-reset.js';
+export * from './platform.js';
+export * from './promise.js';
+export * from './push.js';
+export * from './router.js';
+export * from './signup.js';
+export * from './state.js';
+export * from './storage.js';
+export * from './theme.js';
+export * from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/dist/primitives/logger.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Solid.js primitives for logging.
+ *
+ * @module
+ */
+import type { Logger, LoggerConfig, LoggerProvider } from '@molecule/app-logger';
+/**
+ * Get a logger instance.
+ *
+ * @param name - Logger name
+ * @returns Logger instance
+ *
+ * @example
+ * ```tsx
+ * import { getLogger } from '@molecule/app-solid'
+ * import { onMount, onCleanup } from 'solid-js'
+ *
+ * function MyComponent() {
+ *   const logger = getLogger('MyComponent')
+ *
+ *   onMount(() => {
+ *     logger.info('Component mounted')
+ *   })
+ *
+ *   onCleanup(() => {
+ *     logger.debug('Component unmounted')
+ *   })
+ *
+ *   const handleError = (error: Error) => {
+ *     logger.error('Operation failed', error)
+ *   }
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export declare function getLogger(name?: string): Logger;
+/**
+ * Create a logger with custom configuration.
+ *
+ * @param config - Logger configuration
+ * @returns Logger instance
+ *
+ * @example
+ * ```tsx
+ * const logger = createLogger({
+ *   name: 'API',
+ *   level: 'debug',
+ *   context: { module: 'api' },
+ * })
+ * ```
+ */
+export declare function createLogger(config: LoggerConfig): Logger;
+/**
+ * Get the root logger.
+ *
+ * @returns Root logger instance
+ */
+export declare function getRootLogger(): Logger;
+/**
+ * Create a child logger with additional context.
+ *
+ * @param name - Parent logger name
+ * @param context - Additional context
+ * @returns Child logger instance
+ *
+ * @example
+ * ```tsx
+ * function UserProfile(props: { userId: string }) {
+ *   const logger = getChildLogger('UserProfile', { userId: props.userId })
+ *   // All logs will include userId in context
+ *   logger.info('Profile loaded')
+ * }
+ * ```
+ */
+export declare function getChildLogger(name: string, context: Record<string, unknown>): Logger;
+/**
+ * Create a component logger that includes component name in context.
+ *
+ * @param componentName - Name of the component
+ * @returns Logger configured for the component
+ *
+ * @example
+ * ```tsx
+ * function Dashboard() {
+ *   const logger = useComponentLogger('Dashboard')
+ *
+ *   const handleRefresh = () => {
+ *     logger.info('Dashboard refreshed')
+ *   }
+ *
+ *   return <button onClick={handleRefresh}>Refresh</button>
+ * }
+ * ```
+ */
+export declare function useComponentLogger(componentName: string): Logger;
+/**
+ * Create logger helpers from context.
+ *
+ * @returns Logger helper functions
+ */
+/**
+ * Creates a logger helpers.
+ * @returns The created result.
+ */
+export declare function createLoggerHelpers(): {
+    getLogger: (name?: string) => Logger;
+    createLogger: (config: LoggerConfig) => Logger;
+    setLevel: (level: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent') => void;
+    getLevel: () => string;
+    enable: () => void;
+    disable: () => void;
+    isEnabled: () => boolean;
+};
+/**
+ * Create logger helpers from a specific provider.
+ *
+ * @param provider - Logger provider
+ * @returns Logger helper functions
+ */
+/**
+ * Creates a logger helpers from provider.
+ * @param provider - The provider implementation.
+ * @returns The created result.
+ */
+export declare function createLoggerHelpersFromProvider(provider: LoggerProvider): {
+    getLogger: (name?: string) => Logger;
+    createLogger: (config: LoggerConfig) => Logger;
+    setLevel: (level: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent') => void;
+    getLevel: () => string;
+    enable: () => void;
+    disable: () => void;
+    isEnabled: () => boolean;
+};
+/**
+ * Create logger from a specific provider.
+ *
+ * @param provider - Logger provider
+ * @param name - Logger name
+ * @returns Logger instance
+ */
+export declare function createLoggerFromProvider(provider: LoggerProvider, name?: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/primitives/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/primitives/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAIrF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACpC,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAA;IAC9C,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAA;IACnF,QAAQ,EAAE,MAAM,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,OAAO,CAAA;CACzB,CAaA;AAED;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,cAAc,GAAG;IACzE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACpC,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAA;IAC9C,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAA;IACnF,QAAQ,EAAE,MAAM,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,OAAO,CAAA;CACzB,CAWA;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAExF"}

package/dist/primitives/logger.js

@@ -0,0 +1,165 @@
+/**
+ * Solid.js primitives for logging.
+ *
+ * @module
+ */
+import { getLoggerProvider } from '../context.js';
+/**
+ * Get a logger instance.
+ *
+ * @param name - Logger name
+ * @returns Logger instance
+ *
+ * @example
+ * ```tsx
+ * import { getLogger } from '@molecule/app-solid'
+ * import { onMount, onCleanup } from 'solid-js'
+ *
+ * function MyComponent() {
+ *   const logger = getLogger('MyComponent')
+ *
+ *   onMount(() => {
+ *     logger.info('Component mounted')
+ *   })
+ *
+ *   onCleanup(() => {
+ *     logger.debug('Component unmounted')
+ *   })
+ *
+ *   const handleError = (error: Error) => {
+ *     logger.error('Operation failed', error)
+ *   }
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export function getLogger(name) {
+    const provider = getLoggerProvider();
+    return provider.getLogger(name);
+}
+/**
+ * Create a logger with custom configuration.
+ *
+ * @param config - Logger configuration
+ * @returns Logger instance
+ *
+ * @example
+ * ```tsx
+ * const logger = createLogger({
+ *   name: 'API',
+ *   level: 'debug',
+ *   context: { module: 'api' },
+ * })
+ * ```
+ */
+export function createLogger(config) {
+    const provider = getLoggerProvider();
+    return provider.createLogger(config);
+}
+/**
+ * Get the root logger.
+ *
+ * @returns Root logger instance
+ */
+export function getRootLogger() {
+    const provider = getLoggerProvider();
+    return provider.getLogger();
+}
+/**
+ * Create a child logger with additional context.
+ *
+ * @param name - Parent logger name
+ * @param context - Additional context
+ * @returns Child logger instance
+ *
+ * @example
+ * ```tsx
+ * function UserProfile(props: { userId: string }) {
+ *   const logger = getChildLogger('UserProfile', { userId: props.userId })
+ *   // All logs will include userId in context
+ *   logger.info('Profile loaded')
+ * }
+ * ```
+ */
+export function getChildLogger(name, context) {
+    const provider = getLoggerProvider();
+    const parent = provider.getLogger(name);
+    return parent.withContext(context);
+}
+/**
+ * Create a component logger that includes component name in context.
+ *
+ * @param componentName - Name of the component
+ * @returns Logger configured for the component
+ *
+ * @example
+ * ```tsx
+ * function Dashboard() {
+ *   const logger = useComponentLogger('Dashboard')
+ *
+ *   const handleRefresh = () => {
+ *     logger.info('Dashboard refreshed')
+ *   }
+ *
+ *   return <button onClick={handleRefresh}>Refresh</button>
+ * }
+ * ```
+ */
+export function useComponentLogger(componentName) {
+    return getLogger(componentName);
+}
+/**
+ * Create logger helpers from context.
+ *
+ * @returns Logger helper functions
+ */
+/**
+ * Creates a logger helpers.
+ * @returns The created result.
+ */
+export function createLoggerHelpers() {
+    const provider = getLoggerProvider();
+    return {
+        getLogger: (name) => provider.getLogger(name),
+        createLogger: (config) => provider.createLogger(config),
+        setLevel: (level) => provider.setLevel(level),
+        getLevel: () => provider.getLevel(),
+        enable: () => provider.enable(),
+        disable: () => provider.disable(),
+        isEnabled: () => provider.isEnabled(),
+    };
+}
+/**
+ * Create logger helpers from a specific provider.
+ *
+ * @param provider - Logger provider
+ * @returns Logger helper functions
+ */
+/**
+ * Creates a logger helpers from provider.
+ * @param provider - The provider implementation.
+ * @returns The created result.
+ */
+export function createLoggerHelpersFromProvider(provider) {
+    return {
+        getLogger: (name) => provider.getLogger(name),
+        createLogger: (config) => provider.createLogger(config),
+        setLevel: (level) => provider.setLevel(level),
+        getLevel: () => provider.getLevel(),
+        enable: () => provider.enable(),
+        disable: () => provider.disable(),
+        isEnabled: () => provider.isEnabled(),
+    };
+}
+/**
+ * Create logger from a specific provider.
+ *
+ * @param provider - Logger provider
+ * @param name - Logger name
+ * @returns Logger instance
+ */
+export function createLoggerFromProvider(provider, name) {
+    return provider.getLogger(name);
+}
+//# sourceMappingURL=logger.js.map

package/dist/primitives/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/primitives/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IACpC,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IACpC,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IACpC,OAAO,QAAQ,CAAC,SAAS,EAAE,CAAA;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAgC;IAC3E,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACvC,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,OAAO,SAAS,CAAC,aAAa,CAAC,CAAA;AACjC,CAAC;AAED;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IASjC,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;IAEpC,OAAO;QACL,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;QACtD,YAAY,EAAE,CAAC,MAAoB,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC;QACrE,QAAQ,EAAE,CAAC,KAA+D,EAAE,EAAE,CAC5E,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1B,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE;QACnC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC/B,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE;QACjC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE;KACtC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,QAAwB;IAStE,OAAO;QACL,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;QACtD,YAAY,EAAE,CAAC,MAAoB,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC;QACrE,QAAQ,EAAE,CAAC,KAA+D,EAAE,EAAE,CAC5E,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1B,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE;QACnC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC/B,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE;QACjC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE;KACtC,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAwB,EAAE,IAAa;IAC9E,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AACjC,CAAC"}

package/dist/primitives/login.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Solid.js primitive for login with async state tracking.
+ *
+ * @module
+ */
+import type { Accessor } from 'solid-js';
+import type { AuthResult, LoginCredentials } from '@molecule/app-auth';
+import type { PromiseState } from '@molecule/app-utilities';
+/**
+ * Return type for createLogin primitive.
+ */
+export interface CreateLoginReturn<T = unknown> {
+    state: Accessor<PromiseState<AuthResult<T>>>;
+    login: (credentials: LoginCredentials) => Promise<AuthResult<T>>;
+    reset: () => void;
+}
+/**
+ * Creates a login primitive with async state tracking.
+ *
+ * @returns Login state and action
+ *
+ * @example
+ * ```tsx
+ * const { state, login } = createLogin()
+ *
+ * return (
+ *   <button
+ *     onClick={() => login({ email: email(), password: password() })}
+ *     disabled={state().status === 'pending'}
+ *   >
+ *     {state().status === 'pending' ? 'Logging in...' : 'Login'}
+ *   </button>
+ * )
+ * ```
+ */
+export declare function createLogin<T = unknown>(): CreateLoginReturn<T>;
+//# sourceMappingURL=login.d.ts.map

package/dist/primitives/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/primitives/login.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAK3D;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,KAAK,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IAChE,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,KAAK,iBAAiB,CAAC,CAAC,CAAC,CAO/D"}

package/dist/primitives/login.js

@@ -0,0 +1,32 @@
+/**
+ * Solid.js primitive for login with async state tracking.
+ *
+ * @module
+ */
+import { getAuthClient } from '../context.js';
+import { createPromise } from './promise.js';
+/**
+ * Creates a login primitive with async state tracking.
+ *
+ * @returns Login state and action
+ *
+ * @example
+ * ```tsx
+ * const { state, login } = createLogin()
+ *
+ * return (
+ *   <button
+ *     onClick={() => login({ email: email(), password: password() })}
+ *     disabled={state().status === 'pending'}
+ *   >
+ *     {state().status === 'pending' ? 'Logging in...' : 'Login'}
+ *   </button>
+ * )
+ * ```
+ */
+export function createLogin() {
+    const client = getAuthClient();
+    const { state, call, reset } = createPromise((credentials) => client.login(credentials));
+    return { state, login: call, reset };
+}
+//# sourceMappingURL=login.js.map

package/dist/primitives/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/primitives/login.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAW5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,aAAa,EAAK,CAAA;IACjC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,CAAC,WAA6B,EAAE,EAAE,CAC7E,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAC1B,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AACtC,CAAC"}

package/dist/primitives/oauth.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Solid.js primitive for OAuth authentication.
+ *
+ * Builds provider initiation URLs, starts the full-page redirect flow, and
+ * automatically handles the OAuth callback: when the page loads with a `code`
+ * (+ optional `state`) URL parameter and a stashed provider, the code is
+ * exchanged for a session via `POST {baseURL}{loginEndpoint}`.
+ *
+ * Session establishment prefers an auth client — an explicit
+ * {@link CreateOAuthOptions.authClient} override, else the surrounding
+ * `MoleculeProvider`'s client. Without any client, the code exchange itself
+ * has already established the httpOnly-cookie session server-side, so a
+ * user-carrying response still counts as a successful login.
+ *
+ * @module
+ */
+import type { Accessor } from 'solid-js';
+import type { AuthClient } from '@molecule/app-auth';
+/**
+ * OAuth configuration options.
+ */
+export interface CreateOAuthOptions {
+    /** Base URL for the API server (e.g. `https://api.example.com`). */
+    baseURL?: string;
+    /** List of supported OAuth provider names (e.g. `['github', 'google']`). */
+    oauthProviders?: string[];
+    /** Path prefix for OAuth initiation routes. Defaults to `/oauth`. */
+    oauthEndpoint?: string;
+    /** Path for the OAuth login POST endpoint. Defaults to `/users/log-in/oauth`. */
+    loginEndpoint?: string;
+    /** Called after a successful OAuth login (session established). */
+    onSuccess?: () => void;
+    /** Called with a failure message when the OAuth login fails. */
+    onError?: (error: string) => void;
+    /**
+     * Auth client used to establish the session after the code exchange.
+     * Overrides context resolution — when omitted, the client is resolved from
+     * the surrounding `MoleculeProvider` (tolerated when absent; see the
+     * cookie-session fallback documented on
+     * {@link CreateOAuthReturn.handleCallback}).
+     */
+    authClient?: AuthClient<unknown>;
+}
+/**
+ * Return type for createOAuth primitive.
+ */
+export interface CreateOAuthReturn {
+    /** Accessor for the configured OAuth provider names. */
+    providers: Accessor<string[]>;
+    /** Builds the OAuth initiation URL for a provider. */
+    getOAuthUrl: (provider: string) => string;
+    /** Starts the full-page redirect flow for a provider. */
+    redirect: (provider: string) => void;
+    /**
+     * Handles the OAuth callback: exchanges the `code` URL parameter for a
+     * session. Invoked automatically at creation (see {@link createOAuth});
+     * exposed for callers that need to re-run it manually. No-ops unless
+     * running in a browser with a `code` URL parameter and a stashed provider.
+     *
+     * When an auth client is available (explicit option or context), the
+     * session is established locally (`setAccessToken` + `setUser` +
+     * `initialize`). When no client is available, the server has already
+     * established the httpOnly-cookie session during the exchange, so a
+     * user-carrying response still counts as success.
+     */
+    handleCallback: () => Promise<void>;
+}
+/**
+ * Creates OAuth helpers.
+ *
+ * Automatically handles OAuth callbacks by detecting `code` and `state` URL
+ * parameters and exchanging them for a session:
+ *   - Inside a Solid owner (component setup / `createRoot`), the callback
+ *     handling is deferred to `onMount` so it runs client-side after mount.
+ *   - Outside an owner (a plain function call, e.g. bootstrap code), it runs
+ *     immediately at creation, browser-guarded.
+ *
+ * @param options - OAuth configuration
+ *
+ * @example
+ * ```tsx
+ * const { providers, getOAuthUrl, redirect } = createOAuth({
+ *   baseURL: 'https://api.example.com',
+ *   oauthProviders: ['github', 'google'],
+ *   onSuccess: () => navigate('/dashboard'),
+ *   onError: (error) => setErrorMessage(error),
+ * })
+ *
+ * return (
+ *   <For each={providers()}>
+ *     {(provider) => (
+ *       <button onClick={() => redirect(provider)}>
+ *         Login with {provider}
+ *       </button>
+ *     )}
+ *   </For>
+ * )
+ * ```
+ * @returns The created instance.
+ */
+export declare function createOAuth(options?: CreateOAuthOptions): CreateOAuthReturn;
+//# sourceMappingURL=oauth.d.ts.map

package/dist/primitives/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/primitives/oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAIpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAC7B,sDAAsD;IACtD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;IACzC,yDAAyD;IACzD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAiM3E"}