@seedkey/sdk-client 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+v0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Maksim Bessarab
+
+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,262 @@
+# 🔐 SeedKey Client SDK
+
+![license](https://img.shields.io/badge/license-MIT-blue)
+
+SeedKey Client SDK — a client library for passwordless authentication via a browser extension, part of the SeedKey open-source ecosystem.
+
+## Table of Contents
+
+- [🔍 Interaction architecture](#-interaction-architecture)
+- [🧩 Features](#-features)
+- [📦 Installation](#-installation)
+- [🚀 Quick start](#-quick-start)
+- [🔧 SDK methods](#-sdk-methods)
+- [🔌 Backend integration](#-backend-integration)
+- [🤝 Contributing](#-contributing)
+- [🛡️ Vulnerability disclosure](#-vulnerability-disclosure)
+- [📄 License](#-license)
+
+## 🔍 Interaction architecture
+
+![SeedKey Architecture](doc/SeedKeyArchitecture.png)
+
+## 🧩 Features
+
+The SDK provides:
+
+- **Extension communication** — get `publicKey`, sign a `challenge`, or sign custom messages.
+- **High-level API** — a ready authentication flow with your backend via the REST contract `auth()` / `register()` / `authenticate()`.
+- **Low-level API** — flexible customization: `getPublicKey()` / `signChallenge()` / `requestChallenge()`.
+- **Token storage helpers** in `localStorage`.
+
+Important: your **backend** must implement the REST API (see [Backend integration](#-backend-integration) below).
+
+The SDK also provides tools to simplify authentication integration into your service:
+
+- **Protocol types** — interfaces for `Challenge`, `User`, `Token`, `Session`.
+- **Cryptographic utilities** — Ed25519 signature verification.
+- **Authentication services** — `AuthService` and `KeyService`.
+- **Storage abstractions** — adapter interfaces for databases.
+- **Error types** — `SeedKeyError` + `ERROR_CODES`.
+
+## 📦 Installation
+
+```bash
+npm install @seedkey/sdk-client
+```
+
+```bash
+yarn add @seedkey/sdk-client
+```
+
+```bash
+pnpm add @seedkey/sdk-client
+```
+
+## 🚀 Quick start
+
+```ts
+import { getSeedKey, saveTokens, SeedKeyError } from '@seedkey/sdk-client';
+
+// SDK initialization
+const sdk = getSeedKey({
+  backendUrl: 'https://api.example.com',
+  timeout: 60000,
+  debug: true, 
+});
+
+// Check extension availability
+const available = await sdk.isAvailable();
+if (!available) {
+  console.log('Install the SeedKey extension');
+  return;
+}
+
+// Check extension initialization (identity exists)
+const initialized = await sdk.isInitialized();
+if (!initialized) {
+  console.log('Create an Identity in the SeedKey extension');
+  return;
+}
+
+// Authentication (auto-register if user is new)
+try {
+  const result = await sdk.auth();
+  console.log('User ID:', result.user.id);
+  console.log('Access Token:', result.token.accessToken);
+
+  // Save tokens to localStorage
+  saveTokens(result.token, result.user.id);
+} catch (error) {
+  if (error instanceof SeedKeyError) {
+    console.error('Code:', error.code, 'Message:', error.message);
+  }
+}
+```
+
+Token handling:
+
+```ts
+import {
+  saveTokens,
+  getAccessToken,
+  getRefreshToken,
+  getUserId,
+  isTokenExpired,
+  hasToken,
+  clearTokens,
+  getSession,
+  getSeedKey,
+} from '@seedkey/sdk-client';
+
+const sdk = getSeedKey();
+
+// Get access token
+const token = getAccessToken();
+
+// Check token expiration
+if (isTokenExpired()) {
+  const newTokens = await sdk.refreshToken(getRefreshToken()!);
+  saveTokens(newTokens, getUserId() ?? undefined);
+}
+
+// Get full session
+const session = getSession();
+// { accessToken, refreshToken, userId, isExpired }
+
+// Clear on logout
+clearTokens();
+```
+
+Error handling:
+
+```ts
+import { getSeedKey, SeedKeyError, ERROR_CODES } from '@seedkey/sdk-client';
+
+const sdk = getSeedKey();
+
+try {
+  await sdk.auth();
+} catch (error) {
+  if (error instanceof SeedKeyError) {
+    switch (error.code) {
+      // Extension errors
+      case ERROR_CODES.EXTENSION_NOT_FOUND:
+        // Extension is not installed
+        break;
+      case ERROR_CODES.NOT_INITIALIZED:
+        // Identity is not configured
+        break;
+      case ERROR_CODES.EXTENSION_LOCKED:
+        // Extension is locked
+        break;
+      case ERROR_CODES.TIMEOUT:
+        // Operation timeout
+        break;
+
+      // User actions
+      case ERROR_CODES.USER_REJECTED:
+        // User rejected the request
+        break;
+
+      // Network errors
+      case ERROR_CODES.NETWORK_ERROR:
+        // Network error
+        break;
+      case ERROR_CODES.SERVER_ERROR:
+        // Server error
+        break;
+
+      // Auth errors
+      case ERROR_CODES.USER_NOT_FOUND:
+        // User not found
+        break;
+      case ERROR_CODES.USER_EXISTS:
+        // User already exists
+        break;
+      case ERROR_CODES.INVALID_SIGNATURE:
+        // Invalid signature
+        break;
+      case ERROR_CODES.INVALID_TOKEN:
+        // Invalid token
+        break;
+    }
+
+    console.log('Code:', error.code);
+    console.log('Message:', error.message);
+    console.log('Hint:', error.hint);
+  }
+}
+```
+
+You can rely on the SDK and let it handle the routine for you, or implement the logic yourself using the library’s low-level API.
+
+In the basic variant, the authentication flow looks like this:
+
+1. Extension: `sdk.getPublicKey()`
+2. Backend: `POST /api/v1/seedkey/challenge` `{ publicKey, action: "authenticate" }`
+3. Extension: `sdk.signChallenge()`
+4. Backend: `POST /api/v1/seedkey/verify` `{ challengeId, challenge, signature, publicKey }`
+
+Registration flow:
+
+1. Extension: `sdk.getPublicKey()`
+2. Backend: `POST /api/v1/seedkey/challenge` `{ publicKey, action: "register" }`
+3. Extension: `sdk.signChallenge()`
+4. Backend: `POST /api/v1/seedkey/register` `{ publicKey, challenge, signature, metadata }`
+
+## 🔧 SDK methods
+
+| Method | Description | Returns |
+|:--|:--|:--|
+| `isAvailable()` | Check if the extension is installed | `Promise<boolean>` |
+| `isInitialized()` | Check if the extension is initialized | `Promise<boolean>` |
+| `getPublicKey()` | Get the public key for the current domain | `Promise<string>` |
+| `signMessage(message)` | Sign a message (optional) | `Promise<SignMessageResult>` |
+| `signChallenge(challenge: Challenge)` | Sign a `Challenge` | `Promise<SignChallengeResult>` |
+| `register(opts?)` | Register a new account | `Promise<AuthResult>` |
+| `authenticate()` | Authenticate an existing account | `Promise<AuthResult>` |
+| `auth(opts?)` | Smart auth (register/login) | `Promise<AuthResult>` |
+| `getUser(accessToken)` | Get the current user profile | `Promise<UserProfile>` |
+| `logout(accessToken)` | Logout (invalidate access token) | `Promise<void>` |
+| `refreshToken(refreshToken)` | Refresh token pair | `Promise<TokenInfo>` |
+| `getVersion()` | Get SDK version | `string` |
+| `destroy()` | Cleanup resources | `void` |
+
+Important: your **backend** must support the request/response types sent by the SDK and/or implement full endpoints — depending on your chosen integration.
+
+REST API used by the SDK:
+
+| Route | Method | Purpose | Request (JSON / headers) | Response |
+|:--|:--|:--|:--|:--|
+| `/api/v1/seedkey/challenge` | `POST` | Get a challenge to sign in the extension | Body: `{ publicKey, action: "register" \| "authenticate" }` | `ChallengeResponse` |
+| `/api/v1/seedkey/register` | `POST` | Create a new user by signed challenge | Body: `{ publicKey, challenge, signature, metadata }` | `AuthResult` |
+| `/api/v1/seedkey/verify` | `POST` | Verify challenge signature and issue tokens | Body: `{ challengeId, challenge, signature, publicKey }` | `AuthResult` |
+| `/api/v1/seedkey/user` | `GET` | Get current user profile | Header: `Authorization: Bearer <accessToken>` | `{ user: UserProfile }` |
+| `/api/v1/seedkey/logout` | `POST` | Invalidate session | Header: `Authorization: Bearer <accessToken>`; Body: `{}` (or empty) | `{ success: boolean }` |
+| `/api/v1/seedkey/refresh` | `POST` | Refresh token pair using refresh token | Body: `{ refreshToken }` | `TokenInfo` / `{ accessToken, refreshToken, expiresIn }` |
+
+## 🔌 Backend integration
+
+For efficient integration with your backend:
+
+- use `seedkey-sdk-server` — a library to implement the authentication mechanism yourself;
+- or deploy the ready self-hosted service `seedkey-auth-service`.
+
+Also check out other repositories in the ecosystem:
+
+- `seedkey-auth-service-migrations` — Liquibase migrations for `seedkey-auth-service`.
+- `seedkey-auth-service-helm-chart` — Helm Chart for deploying `seedkey-auth-service` + `seedkey-auth-service-migrations`.
+- `seedkey-browser-extension` — browser extension.
+
+## 🤝 Contributing
+
+If you have ideas and want to contribute — feel free to open an issue or a pull request.
+
+## 🛡️ Vulnerability disclosure
+
+Please **do not publish** vulnerabilities in public issues. Report them privately via `maks@besssarab.ru` or open a private security advisory on GitHub.
+
+## 📄 License
+
+See `LICENSE`.

package/dist/api.d.ts

@@ -0,0 +1,34 @@
+/**
+ * API client for backend integration
+ */
+import { UserProfile } from './types';
+export declare class ApiClient {
+    private baseUrl;
+    constructor(baseUrl: string);
+    /**
+     * Get user profile
+     */
+    getUser(accessToken: string): Promise<UserProfile>;
+    /**
+     * Logout (invalidate token)
+     */
+    logout(accessToken: string): Promise<void>;
+    /**
+     * Refresh token
+     */
+    refreshToken(refreshToken: string): Promise<{
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+    }>;
+    /**
+     * Base fetch with defaults
+     */
+    private fetch;
+}
+export declare function getApiClient(baseUrl?: string): ApiClient;
+/**
+ * Reset singleton API client instance
+ */
+export declare function resetApiClient(): void;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAA6B,MAAM,SAAS,CAAC;AAOjE,qBAAa,SAAS;IACR,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAInC;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAuBxD;;OAEG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBhD;;OAEG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAChD,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAqBF;;OAEG;YACW,KAAK;CA0BpB;AAQD,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAUxD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/api.js

@@ -0,0 +1,115 @@
+/**
+ * API client for backend integration
+ */
+import { SeedKeyError, ERROR_CODES } from './types';
+import { apiLogger as log } from './logger';
+// ============================================================================
+// API Client
+// ============================================================================
+export class ApiClient {
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+        log.info('ApiClient initialized', { baseUrl });
+    }
+    /**
+     * Get user profile
+     */
+    async getUser(accessToken) {
+        log.debug('GET /api/v1/seedkey/user');
+        const response = await this.fetch('/api/v1/seedkey/user', {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            log.error('Failed to get user', { status: response.status, error });
+            throw new SeedKeyError(error.error || ERROR_CODES.SERVER_ERROR, error.message || 'Failed to get user');
+        }
+        const data = await response.json();
+        log.info('User retrieved', { userId: data.user?.id });
+        return data.user;
+    }
+    /**
+     * Logout (invalidate token)
+     */
+    async logout(accessToken) {
+        log.debug('POST /api/v1/seedkey/logout');
+        const response = await this.fetch('/api/v1/seedkey/logout', {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            log.error('Logout failed', { status: response.status, error });
+            throw new SeedKeyError(error.error || ERROR_CODES.SERVER_ERROR, error.message || 'Logout failed');
+        }
+        log.info('Logout successful');
+    }
+    /**
+     * Refresh token
+     */
+    async refreshToken(refreshToken) {
+        log.debug('POST /api/v1/seedkey/refresh');
+        const response = await this.fetch('/api/v1/seedkey/refresh', {
+            method: 'POST',
+            body: JSON.stringify({ refreshToken }),
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            log.error('Token refresh failed', { status: response.status, error });
+            throw new SeedKeyError(error.error || ERROR_CODES.INVALID_TOKEN, error.message || 'Token refresh failed');
+        }
+        const result = await response.json();
+        log.info('Token refreshed', { expiresIn: result.expiresIn });
+        return result;
+    }
+    /**
+     * Base fetch with defaults
+     */
+    async fetch(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            ...options.headers,
+        };
+        log.time(`fetch ${endpoint}`);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                headers,
+            });
+            log.timeEnd(`fetch ${endpoint}`);
+            log.debug(`${options.method || 'GET'} ${endpoint}`, { status: response.status, ok: response.ok });
+            return response;
+        }
+        catch (error) {
+            log.timeEnd(`fetch ${endpoint}`);
+            log.error(`Network error: ${endpoint}`, error);
+            throw new SeedKeyError(ERROR_CODES.NETWORK_ERROR, `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+let apiClientInstance = null;
+export function getApiClient(baseUrl) {
+    if (!apiClientInstance && baseUrl) {
+        apiClientInstance = new ApiClient(baseUrl);
+    }
+    if (!apiClientInstance) {
+        throw new Error('ApiClient not initialized. Call getApiClient with baseUrl first.');
+    }
+    return apiClientInstance;
+}
+/**
+ * Reset singleton API client instance
+ */
+export function resetApiClient() {
+    apiClientInstance = null;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * SeedKey Auth SDK
+ *
+ * Client library for authentication via the SeedKey browser extension
+ *
+ * ## Two usage modes
+ *
+ * ### 1. Ready-to-use methods (REST API) - recommended
+ *
+ * @example
+ * ```ts
+ * import { SeedKey, getSeedKey } from '@seedkey/sdk-client';
+ *
+ * const sdk = getSeedKey({ backendUrl: 'http://localhost:3000', debug: true });
+ *
+ * // Extension check
+ * const status = await sdk.getExtensionStatus();
+ * if (!status.installed) {
+ *   console.log('Install extension:', status.downloadUrl);
+ *   return;
+ * }
+ *
+ * // Full authentication (register if user doesn't exist)
+ * const result = await sdk.auth();
+ * console.log('User ID:', result.user.id);
+ * ```
+ *
+ * ### 2. Low-level methods for custom authentication
+ *
+ * @example
+ * ```ts
+ * const sdk = getSeedKey({ backendUrl: 'http://localhost:3000' });
+ *
+ * // Extension check (throws if there are issues)
+ * await sdk.checkExtension();
+ *
+ * // Custom flow
+ * const publicKey = await sdk.getPublicKey();
+ * const { challenge, challengeId } = await sdk.requestChallenge(publicKey, 'authenticate');
+ * const { signature } = await sdk.signChallenge(challenge);
+ *
+ * // Send to your backend
+ * await fetch('/my-api/verify', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ challengeId, signature, publicKey })
+ * });
+ * ```
+ */
+export { SeedKey, getSeedKey, resetSeedKey, getRequestEventName, getResponseEventName, } from './seedkey';
+export { ApiClient, getApiClient, resetApiClient } from './api';
+export { saveTokens, clearTokens, getAccessToken, getRefreshToken, getUserId, isTokenExpired, hasToken, getSession, } from './storage';
+export { createLogger, enableDebug, disableDebug, sdkLogger, authLogger, apiLogger, storageLogger, uiLogger, } from './logger';
+export type { Challenge, TokenInfo, UserInfo, AuthResult, PublicKeyInfo, UserProfile, SeedKeyOptions, AuthOptions, SeedKeyAction, SeedKeyRequest, SeedKeyResponse, PublicKeyResult, SignChallengeResult, SignMessageResult, ChallengeResponse, RegisterRequest, VerifyRequest, ErrorCode, ExtensionStatus, } from './types';
+export { SeedKeyError, ExtensionNotFoundError, ExtensionNotConfiguredError, ERROR_CODES, EXTENSION_DOWNLOAD_URL, SDK_VERSION, REQUEST_EVENT, RESPONSE_EVENT, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAGH,OAAO,EACL,OAAO,EACP,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGhE,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,SAAS,EACT,cAAc,EACd,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,QAAQ,GACT,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,WAAW,EACX,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,59 @@
+/**
+ * SeedKey Auth SDK
+ *
+ * Client library for authentication via the SeedKey browser extension
+ *
+ * ## Two usage modes
+ *
+ * ### 1. Ready-to-use methods (REST API) - recommended
+ *
+ * @example
+ * ```ts
+ * import { SeedKey, getSeedKey } from '@seedkey/sdk-client';
+ *
+ * const sdk = getSeedKey({ backendUrl: 'http://localhost:3000', debug: true });
+ *
+ * // Extension check
+ * const status = await sdk.getExtensionStatus();
+ * if (!status.installed) {
+ *   console.log('Install extension:', status.downloadUrl);
+ *   return;
+ * }
+ *
+ * // Full authentication (register if user doesn't exist)
+ * const result = await sdk.auth();
+ * console.log('User ID:', result.user.id);
+ * ```
+ *
+ * ### 2. Low-level methods for custom authentication
+ *
+ * @example
+ * ```ts
+ * const sdk = getSeedKey({ backendUrl: 'http://localhost:3000' });
+ *
+ * // Extension check (throws if there are issues)
+ * await sdk.checkExtension();
+ *
+ * // Custom flow
+ * const publicKey = await sdk.getPublicKey();
+ * const { challenge, challengeId } = await sdk.requestChallenge(publicKey, 'authenticate');
+ * const { signature } = await sdk.signChallenge(challenge);
+ *
+ * // Send to your backend
+ * await fetch('/my-api/verify', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ challengeId, signature, publicKey })
+ * });
+ * ```
+ */
+// SDK
+export { SeedKey, getSeedKey, resetSeedKey, getRequestEventName, getResponseEventName, } from './seedkey';
+// API Client
+export { ApiClient, getApiClient, resetApiClient } from './api';
+// Storage
+export { saveTokens, clearTokens, getAccessToken, getRefreshToken, getUserId, isTokenExpired, hasToken, getSession, } from './storage';
+// Logger
+export { createLogger, enableDebug, disableDebug, sdkLogger, authLogger, apiLogger, storageLogger, uiLogger, } from './logger';
+// Errors & Constants
+export { SeedKeyError, ExtensionNotFoundError, ExtensionNotConfiguredError, ERROR_CODES, EXTENSION_DOWNLOAD_URL, SDK_VERSION, REQUEST_EVENT, RESPONSE_EVENT, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,MAAM;AACN,OAAO,EACL,OAAO,EACP,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAEnB,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEhE,UAAU;AACV,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,SAAS,EACT,cAAc,EACd,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,SAAS;AACT,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,QAAQ,GACT,MAAM,UAAU,CAAC;AAyBlB,qBAAqB;AACrB,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,WAAW,EACX,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Debug Logger
+ */
+/**
+ * Enable debug logging
+ */
+export declare function enableDebug(): void;
+/**
+ * Disable debug logging
+ */
+export declare function disableDebug(): void;
+/**
+ * Create a module logger
+ */
+export declare function createLogger(module: string): {
+    debug: (message: string, data?: unknown) => void;
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+    /** Log grouping */
+    group: (label: string, collapsed?: boolean) => void;
+    /** End group */
+    groupEnd: () => void;
+    /** Data table */
+    table: (data: unknown) => void;
+    /** Timing */
+    time: (label: string) => void;
+    /** End timing */
+    timeEnd: (label: string) => void;
+};
+export declare const sdkLogger: {
+    debug: (message: string, data?: unknown) => void;
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+    /** Log grouping */
+    group: (label: string, collapsed?: boolean) => void;
+    /** End group */
+    groupEnd: () => void;
+    /** Data table */
+    table: (data: unknown) => void;
+    /** Timing */
+    time: (label: string) => void;
+    /** End timing */
+    timeEnd: (label: string) => void;
+};
+export declare const authLogger: {
+    debug: (message: string, data?: unknown) => void;
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+    /** Log grouping */
+    group: (label: string, collapsed?: boolean) => void;
+    /** End group */
+    groupEnd: () => void;
+    /** Data table */
+    table: (data: unknown) => void;
+    /** Timing */
+    time: (label: string) => void;
+    /** End timing */
+    timeEnd: (label: string) => void;
+};
+export declare const apiLogger: {
+    debug: (message: string, data?: unknown) => void;
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+    /** Log grouping */
+    group: (label: string, collapsed?: boolean) => void;
+    /** End group */
+    groupEnd: () => void;
+    /** Data table */
+    table: (data: unknown) => void;
+    /** Timing */
+    time: (label: string) => void;
+    /** End timing */
+    timeEnd: (label: string) => void;
+};
+export declare const storageLogger: {
+    debug: (message: string, data?: unknown) => void;
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+    /** Log grouping */
+    group: (label: string, collapsed?: boolean) => void;
+    /** End group */
+    groupEnd: () => void;
+    /** Data table */
+    table: (data: unknown) => void;
+    /** Timing */
+    time: (label: string) => void;
+    /** End timing */
+    timeEnd: (label: string) => void;
+};
+export declare const uiLogger: {
+    debug: (message: string, data?: unknown) => void;
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+    /** Log grouping */
+    group: (label: string, collapsed?: boolean) => void;
+    /** End group */
+    groupEnd: () => void;
+    /** Data table */
+    table: (data: unknown) => void;
+    /** Timing */
+    time: (label: string) => void;
+    /** End timing */
+    timeEnd: (label: string) => void;
+};
+//# sourceMappingURL=logger.d.ts.map