@lifestreamdynamics/vault-sdk 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,143 @@
+import { type KyInstance } from 'ky';
+import { VaultsResource } from './resources/vaults.js';
+import { DocumentsResource } from './resources/documents.js';
+import { SearchResource } from './resources/search.js';
+import { AiResource } from './resources/ai.js';
+import { TeamsResource } from './resources/teams.js';
+import { ApiKeysResource } from './resources/api-keys.js';
+import { UserResource } from './resources/user.js';
+import { SubscriptionResource } from './resources/subscription.js';
+import { SharesResource } from './resources/shares.js';
+import { PublishResource } from './resources/publish.js';
+import { ConnectorsResource } from './resources/connectors.js';
+import { AdminResource } from './resources/admin.js';
+import { HooksResource } from './resources/hooks.js';
+import { WebhooksResource } from './resources/webhooks.js';
+import { TokenManager, type AuthTokens, type OnTokenRefresh } from './lib/token-manager.js';
+/**
+ * Configuration options for creating a {@link LifestreamVaultClient}.
+ */
+export interface ClientOptions {
+    /** Base URL of the Lifestream Vault API server (e.g., `'https://vault.example.com'`). */
+    baseUrl: string;
+    /** API key for authentication (prefix `lsv_k_`). Provide either this or `accessToken`. */
+    apiKey?: string;
+    /** JWT access token for authentication. Provide either this or `apiKey`. */
+    accessToken?: string;
+    /** JWT refresh token for automatic token renewal. Only used with `accessToken`. */
+    refreshToken?: string;
+    /** Request timeout in milliseconds. Defaults to 30000 (30 seconds). */
+    timeout?: number;
+    /** Milliseconds before token expiry to trigger proactive refresh. Default: 60000 (1 min). */
+    refreshBufferMs?: number;
+    /** Called after a successful token refresh with the new tokens. */
+    onTokenRefresh?: OnTokenRefresh;
+    /** Enable HMAC-SHA256 request signing for sensitive operations. Defaults to true when using API keys, false for JWT. */
+    enableRequestSigning?: boolean;
+    /** Enable client-side audit logging of requests. Defaults to false. */
+    enableAuditLogging?: boolean;
+    /** Path to the audit log file. Defaults to `~/.lsvault/audit.log`. */
+    auditLogPath?: string;
+}
+/**
+ * Main client for the Lifestream Vault API.
+ *
+ * Provides access to all API resources through typed sub-clients:
+ * {@link VaultsResource | vaults}, {@link DocumentsResource | documents},
+ * {@link SearchResource | search}, {@link AiResource | ai},
+ * {@link ApiKeysResource | apiKeys}, {@link UserResource | user},
+ * {@link SubscriptionResource | subscription}, and {@link TeamsResource | teams}.
+ *
+ * @example
+ * ```typescript
+ * import { LifestreamVaultClient } from '@lifestream-vault/sdk';
+ *
+ * const client = new LifestreamVaultClient({
+ *   baseUrl: 'https://vault.example.com',
+ *   apiKey: 'lsv_k_your_api_key',
+ * });
+ *
+ * const vaults = await client.vaults.list();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using a JWT access token instead of an API key
+ * const client = new LifestreamVaultClient({
+ *   baseUrl: 'https://vault.example.com',
+ *   accessToken: 'eyJhbGci...',
+ *   timeout: 60_000,
+ * });
+ * ```
+ */
+export declare class LifestreamVaultClient {
+    /** The underlying ky HTTP client instance, pre-configured with auth and base URL. */
+    readonly http: KyInstance;
+    /** The normalized base URL of the API server. */
+    readonly baseUrl: string;
+    /** Vault management operations. */
+    readonly vaults: VaultsResource;
+    /** Document CRUD and file operations. */
+    readonly documents: DocumentsResource;
+    /** Full-text search across vaults. */
+    readonly search: SearchResource;
+    /** AI chat and document summarization. */
+    readonly ai: AiResource;
+    /** API key management operations. */
+    readonly apiKeys: ApiKeysResource;
+    /** User profile and storage information. */
+    readonly user: UserResource;
+    /** Subscription management and billing. */
+    readonly subscription: SubscriptionResource;
+    /** Team management, members, invitations, and team vaults. */
+    readonly teams: TeamsResource;
+    /** Document sharing via token-based links. */
+    readonly shares: SharesResource;
+    /** Document publishing for public access. */
+    readonly publish: PublishResource;
+    /** External connector management (e.g., Google Drive sync). */
+    readonly connectors: ConnectorsResource;
+    /** Admin operations: stats, user management, activity, health. */
+    readonly admin: AdminResource;
+    /** Vault hook management (internal event handlers). */
+    readonly hooks: HooksResource;
+    /** Vault webhook management (outbound HTTP notifications). */
+    readonly webhooks: WebhooksResource;
+    /** Token manager for JWT auto-refresh (null when using API key auth). */
+    readonly tokenManager: TokenManager | null;
+    /**
+     * Creates a new Lifestream Vault API client.
+     *
+     * @param options - Client configuration options
+     * @param options.baseUrl - Base URL of the API server (trailing slashes are stripped)
+     * @param options.apiKey - API key for authentication (mutually exclusive with `accessToken`)
+     * @param options.accessToken - JWT access token (mutually exclusive with `apiKey`)
+     * @param options.timeout - Request timeout in milliseconds (default: 30000)
+     * @throws {ValidationError} If `baseUrl` is empty or neither `apiKey` nor `accessToken` is provided
+     *
+     * @example
+     * ```typescript
+     * const client = new LifestreamVaultClient({
+     *   baseUrl: 'https://vault.example.com',
+     *   apiKey: 'lsv_k_your_api_key',
+     * });
+     * ```
+     */
+    constructor(options: ClientOptions);
+    /**
+     * Authenticate with email and password to obtain JWT tokens.
+     * Returns an authenticated client instance with token management.
+     *
+     * @param baseUrl - Base URL of the API server
+     * @param email - User email address
+     * @param password - User password
+     * @param options - Additional client options (timeout, refreshBufferMs, onTokenRefresh, etc.)
+     * @returns A new authenticated client with the access/refresh tokens used
+     */
+    static login(baseUrl: string, email: string, password: string, options?: Omit<ClientOptions, 'baseUrl' | 'apiKey' | 'accessToken' | 'refreshToken'>): Promise<{
+        client: LifestreamVaultClient;
+        tokens: AuthTokens;
+        refreshToken: string | null;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,286 @@
+import ky from 'ky';
+import { VaultsResource } from './resources/vaults.js';
+import { DocumentsResource } from './resources/documents.js';
+import { SearchResource } from './resources/search.js';
+import { AiResource } from './resources/ai.js';
+import { TeamsResource } from './resources/teams.js';
+import { ApiKeysResource } from './resources/api-keys.js';
+import { UserResource } from './resources/user.js';
+import { SubscriptionResource } from './resources/subscription.js';
+import { SharesResource } from './resources/shares.js';
+import { PublishResource } from './resources/publish.js';
+import { ConnectorsResource } from './resources/connectors.js';
+import { AdminResource } from './resources/admin.js';
+import { HooksResource } from './resources/hooks.js';
+import { WebhooksResource } from './resources/webhooks.js';
+import { ValidationError } from './errors.js';
+import { AuditLogger } from './lib/audit-logger.js';
+import { signRequest } from './lib/signature.js';
+import { TokenManager } from './lib/token-manager.js';
+/** Header used to prevent infinite 401 retry loops. */
+const RETRY_HEADER = 'X-Retry-After-Refresh';
+/**
+ * Main client for the Lifestream Vault API.
+ *
+ * Provides access to all API resources through typed sub-clients:
+ * {@link VaultsResource | vaults}, {@link DocumentsResource | documents},
+ * {@link SearchResource | search}, {@link AiResource | ai},
+ * {@link ApiKeysResource | apiKeys}, {@link UserResource | user},
+ * {@link SubscriptionResource | subscription}, and {@link TeamsResource | teams}.
+ *
+ * @example
+ * ```typescript
+ * import { LifestreamVaultClient } from '@lifestream-vault/sdk';
+ *
+ * const client = new LifestreamVaultClient({
+ *   baseUrl: 'https://vault.example.com',
+ *   apiKey: 'lsv_k_your_api_key',
+ * });
+ *
+ * const vaults = await client.vaults.list();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using a JWT access token instead of an API key
+ * const client = new LifestreamVaultClient({
+ *   baseUrl: 'https://vault.example.com',
+ *   accessToken: 'eyJhbGci...',
+ *   timeout: 60_000,
+ * });
+ * ```
+ */
+export class LifestreamVaultClient {
+    /** The underlying ky HTTP client instance, pre-configured with auth and base URL. */
+    http;
+    /** The normalized base URL of the API server. */
+    baseUrl;
+    /** Vault management operations. */
+    vaults;
+    /** Document CRUD and file operations. */
+    documents;
+    /** Full-text search across vaults. */
+    search;
+    /** AI chat and document summarization. */
+    ai;
+    /** API key management operations. */
+    apiKeys;
+    /** User profile and storage information. */
+    user;
+    /** Subscription management and billing. */
+    subscription;
+    /** Team management, members, invitations, and team vaults. */
+    teams;
+    /** Document sharing via token-based links. */
+    shares;
+    /** Document publishing for public access. */
+    publish;
+    /** External connector management (e.g., Google Drive sync). */
+    connectors;
+    /** Admin operations: stats, user management, activity, health. */
+    admin;
+    /** Vault hook management (internal event handlers). */
+    hooks;
+    /** Vault webhook management (outbound HTTP notifications). */
+    webhooks;
+    /** Token manager for JWT auto-refresh (null when using API key auth). */
+    tokenManager;
+    /**
+     * Creates a new Lifestream Vault API client.
+     *
+     * @param options - Client configuration options
+     * @param options.baseUrl - Base URL of the API server (trailing slashes are stripped)
+     * @param options.apiKey - API key for authentication (mutually exclusive with `accessToken`)
+     * @param options.accessToken - JWT access token (mutually exclusive with `apiKey`)
+     * @param options.timeout - Request timeout in milliseconds (default: 30000)
+     * @throws {ValidationError} If `baseUrl` is empty or neither `apiKey` nor `accessToken` is provided
+     *
+     * @example
+     * ```typescript
+     * const client = new LifestreamVaultClient({
+     *   baseUrl: 'https://vault.example.com',
+     *   apiKey: 'lsv_k_your_api_key',
+     * });
+     * ```
+     */
+    constructor(options) {
+        if (!options.baseUrl) {
+            throw new ValidationError('baseUrl is required');
+        }
+        if (!options.apiKey && !options.accessToken) {
+            throw new ValidationError('Either apiKey or accessToken is required');
+        }
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        const prefixUrl = `${this.baseUrl}/api/v1`;
+        const timeout = options.timeout || 30_000;
+        // Determine whether to enable request signing
+        const shouldSign = options.enableRequestSigning ?? !!options.apiKey;
+        const beforeRequestHooks = [];
+        const afterResponseHooks = [];
+        // Request signing hook -- adds HMAC signature headers to mutating requests
+        if (shouldSign && options.apiKey) {
+            const apiKeyForSigning = options.apiKey;
+            beforeRequestHooks.push(async (request) => {
+                const url = new URL(request.url);
+                const method = request.method.toUpperCase();
+                // Only sign mutating operations
+                if (!['PUT', 'POST', 'DELETE', 'PATCH'].includes(method)) {
+                    return;
+                }
+                // Read body for signing (clone to avoid consuming the stream)
+                let body = '';
+                if (request.body) {
+                    const cloned = request.clone();
+                    body = await cloned.text();
+                }
+                const sigHeaders = signRequest(apiKeyForSigning, method, url.pathname, body);
+                for (const [key, value] of Object.entries(sigHeaders)) {
+                    request.headers.set(key, value);
+                }
+            });
+        }
+        // Audit logging hooks
+        if (options.enableAuditLogging) {
+            const auditLogger = new AuditLogger({ logPath: options.auditLogPath });
+            const requestTimings = new WeakMap();
+            beforeRequestHooks.push((request) => {
+                requestTimings.set(request, Date.now());
+            });
+            afterResponseHooks.push((request, _options, response) => {
+                const startTime = requestTimings.get(request);
+                const durationMs = startTime ? Date.now() - startTime : 0;
+                const url = new URL(request.url);
+                try {
+                    auditLogger.log({
+                        timestamp: new Date().toISOString(),
+                        method: request.method,
+                        path: url.pathname,
+                        status: response.status,
+                        durationMs,
+                    });
+                }
+                catch {
+                    // Audit logging is best-effort; never break requests
+                }
+            });
+        }
+        if (options.apiKey) {
+            // API key auth: static Authorization header, no token management
+            this.tokenManager = null;
+            this.http = ky.create({
+                prefixUrl,
+                timeout,
+                headers: {
+                    'Authorization': `Bearer ${options.apiKey}`,
+                },
+                hooks: {
+                    beforeRequest: beforeRequestHooks,
+                    afterResponse: afterResponseHooks,
+                },
+            });
+        }
+        else {
+            // JWT auth: set up token manager with optional auto-refresh
+            const tokenManager = new TokenManager(options.accessToken, options.refreshToken ?? null, {
+                refreshBufferMs: options.refreshBufferMs,
+                onTokenRefresh: options.onTokenRefresh,
+            });
+            this.tokenManager = tokenManager;
+            // Base ky instance without auth hooks (used for refresh requests to avoid recursion)
+            const baseHttp = ky.create({ prefixUrl, timeout });
+            // JWT beforeRequest: proactive refresh + set Authorization header
+            beforeRequestHooks.push(async (request) => {
+                if (tokenManager.needsRefresh() && tokenManager.getRefreshToken()) {
+                    try {
+                        await tokenManager.refresh(baseHttp);
+                    }
+                    catch {
+                        // Refresh failed; proceed with current token, let 401 handler deal with it
+                    }
+                }
+                request.headers.set('Authorization', `Bearer ${tokenManager.getAccessToken()}`);
+            });
+            // JWT afterResponse: reactive 401 retry
+            afterResponseHooks.push(async (request, _options, response) => {
+                if (response.status === 401
+                    && !request.headers.get(RETRY_HEADER)
+                    && tokenManager.getRefreshToken()) {
+                    try {
+                        const newToken = await tokenManager.refresh(baseHttp);
+                        const retryRequest = new Request(request, {
+                            headers: new Headers(request.headers),
+                        });
+                        retryRequest.headers.set('Authorization', `Bearer ${newToken}`);
+                        retryRequest.headers.set(RETRY_HEADER, '1');
+                        return ky(retryRequest);
+                    }
+                    catch {
+                        // Refresh failed; return original 401
+                        return response;
+                    }
+                }
+                return response;
+            });
+            this.http = ky.create({
+                prefixUrl,
+                timeout,
+                hooks: {
+                    beforeRequest: beforeRequestHooks,
+                    afterResponse: afterResponseHooks,
+                },
+            });
+        }
+        this.vaults = new VaultsResource(this.http);
+        this.documents = new DocumentsResource(this.http);
+        this.search = new SearchResource(this.http);
+        this.ai = new AiResource(this.http);
+        this.apiKeys = new ApiKeysResource(this.http);
+        this.user = new UserResource(this.http);
+        this.subscription = new SubscriptionResource(this.http);
+        this.teams = new TeamsResource(this.http);
+        this.shares = new SharesResource(this.http);
+        this.publish = new PublishResource(this.http);
+        this.connectors = new ConnectorsResource(this.http);
+        this.admin = new AdminResource(this.http);
+        this.hooks = new HooksResource(this.http);
+        this.webhooks = new WebhooksResource(this.http);
+    }
+    /**
+     * Authenticate with email and password to obtain JWT tokens.
+     * Returns an authenticated client instance with token management.
+     *
+     * @param baseUrl - Base URL of the API server
+     * @param email - User email address
+     * @param password - User password
+     * @param options - Additional client options (timeout, refreshBufferMs, onTokenRefresh, etc.)
+     * @returns A new authenticated client with the access/refresh tokens used
+     */
+    static async login(baseUrl, email, password, options = {}) {
+        const normalizedUrl = baseUrl.replace(/\/$/, '');
+        const http = ky.create({
+            prefixUrl: `${normalizedUrl}/api/v1`,
+            timeout: options.timeout || 30_000,
+        });
+        const response = await http.post('auth/login', {
+            json: { email, password },
+        });
+        const tokens = await response.json();
+        // Extract refresh token from Set-Cookie header if present
+        const setCookie = response.headers.get('set-cookie');
+        let refreshToken = null;
+        if (setCookie) {
+            const match = setCookie.match(/lsv_refresh=([^;]+)/);
+            if (match) {
+                refreshToken = match[1];
+            }
+        }
+        const client = new LifestreamVaultClient({
+            ...options,
+            baseUrl: normalizedUrl,
+            accessToken: tokens.accessToken,
+            refreshToken: refreshToken ?? undefined,
+        });
+        return { client, tokens, refreshToken };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,28 @@
+export declare class SDKError extends Error {
+    statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+export declare class ValidationError extends SDKError {
+    details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class AuthenticationError extends SDKError {
+    constructor(message?: string);
+}
+export declare class AuthorizationError extends SDKError {
+    constructor(message?: string);
+}
+export declare class NotFoundError extends SDKError {
+    constructor(resource: string, identifier: string);
+}
+export declare class ConflictError extends SDKError {
+    constructor(message: string);
+}
+export declare class RateLimitError extends SDKError {
+    constructor(message?: string);
+}
+export declare class NetworkError extends SDKError {
+    cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IAGxB,UAAU,CAAC,EAAE,MAAM;gBAD1B,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA;CAM7B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;IAGlC,OAAO,CAAC,EAAE,OAAO;gBADxB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAI3B;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,GAAE,MAAkC;CAGxD;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,GAAE,MAA4B;CAGlD;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAGjD;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,MAA8B;CAGpD;AAED,qBAAa,YAAa,SAAQ,QAAQ;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C"}

package/dist/errors.js

@@ -0,0 +1,49 @@
+export class SDKError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = this.constructor.name;
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+export class ValidationError extends SDKError {
+    details;
+    constructor(message, details) {
+        super(message, 400);
+        this.details = details;
+    }
+}
+export class AuthenticationError extends SDKError {
+    constructor(message = 'Authentication required') {
+        super(message, 401);
+    }
+}
+export class AuthorizationError extends SDKError {
+    constructor(message = 'Permission denied') {
+        super(message, 403);
+    }
+}
+export class NotFoundError extends SDKError {
+    constructor(resource, identifier) {
+        super(`${resource} not found: ${identifier}`, 404);
+    }
+}
+export class ConflictError extends SDKError {
+    constructor(message) {
+        super(message, 409);
+    }
+}
+export class RateLimitError extends SDKError {
+    constructor(message = 'Rate limit exceeded') {
+        super(message, 429);
+    }
+}
+export class NetworkError extends SDKError {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGxB;IAFT,YACE,OAAe,EACR,UAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAGlC;IAFT,YACE,OAAe,EACR,OAAiB;QAExB,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAFb,YAAO,GAAP,OAAO,CAAU;IAG1B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,UAAkB,yBAAyB;QACrD,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,UAAkB,mBAAmB;QAC/C,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,QAAgB,EAAE,UAAkB;QAC9C,KAAK,CAAC,GAAG,QAAQ,eAAe,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,UAAkB,qBAAqB;QACjD,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAC/B,KAAK,CAAS;IAEvB,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/handle-error.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Convert a caught error into the appropriate typed SDK error.
+ * @param error  The caught error (typically from ky)
+ * @param resource  Human-readable resource name for 404 messages
+ * @param identifier  Resource identifier for 404 messages
+ */
+export declare function handleError(error: unknown, resource?: string, identifier?: string): Promise<never>;
+//# sourceMappingURL=handle-error.d.ts.map

package/dist/handle-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-error.d.ts","sourceRoot":"","sources":["../src/handle-error.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,MAAmB,EAC7B,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,KAAK,CAAC,CAuBhB"}

package/dist/handle-error.js

@@ -0,0 +1,35 @@
+import { HTTPError } from 'ky';
+import { SDKError, ValidationError, AuthenticationError, AuthorizationError, NotFoundError, ConflictError, RateLimitError, NetworkError, } from './errors.js';
+/**
+ * Convert a caught error into the appropriate typed SDK error.
+ * @param error  The caught error (typically from ky)
+ * @param resource  Human-readable resource name for 404 messages
+ * @param identifier  Resource identifier for 404 messages
+ */
+export async function handleError(error, resource = 'Resource', identifier = '') {
+    if (error instanceof HTTPError) {
+        const status = error.response.status;
+        const body = await error.response
+            .json()
+            .catch(() => ({ message: error.message }));
+        const msg = body.message ?? 'Request failed';
+        if (status === 400)
+            throw new ValidationError(msg, body.details);
+        if (status === 401)
+            throw new AuthenticationError(msg);
+        if (status === 403)
+            throw new AuthorizationError(msg);
+        if (status === 404)
+            throw new NotFoundError(resource, identifier);
+        if (status === 409)
+            throw new ConflictError(msg);
+        if (status === 429)
+            throw new RateLimitError(msg);
+        throw new SDKError(msg, status);
+    }
+    if (error instanceof Error) {
+        throw new NetworkError('Network request failed', error);
+    }
+    throw new NetworkError('Network request failed');
+}
+//# sourceMappingURL=handle-error.js.map

package/dist/handle-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-error.js","sourceRoot":"","sources":["../src/handle-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EACL,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAOrB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAc,EACd,WAAmB,UAAU,EAC7B,aAAqB,EAAE;IAEvB,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrC,MAAM,IAAI,GAAc,MAAM,KAAK,CAAC,QAAQ;aACzC,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAc,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAC;QAE7C,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAClE,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;QAElD,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,YAAY,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,YAAY,CAAC,wBAAwB,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+export { LifestreamVaultClient, type ClientOptions } from './client.js';
+export { VaultsResource } from './resources/vaults.js';
+export { DocumentsResource } from './resources/documents.js';
+export { SearchResource } from './resources/search.js';
+export { AiResource } from './resources/ai.js';
+export { ApiKeysResource } from './resources/api-keys.js';
+export type { ApiKey, ApiKeyWithSecret, CreateApiKeyParams, UpdateApiKeyParams } from './resources/api-keys.js';
+export { UserResource } from './resources/user.js';
+export type { User, VaultStorage, StorageUsage } from './resources/user.js';
+export { SubscriptionResource } from './resources/subscription.js';
+export type { Subscription, Plan, CheckoutSession, PortalSession, Invoice } from './resources/subscription.js';
+export { TeamsResource } from './resources/teams.js';
+export type { Team, TeamMember, TeamInvitation, CreateTeamParams, UpdateTeamParams } from './resources/teams.js';
+export { SharesResource } from './resources/shares.js';
+export type { ShareLink, CreateShareLinkParams, CreateShareLinkResponse } from './resources/shares.js';
+export { PublishResource } from './resources/publish.js';
+export type { PublishedDocument, PublishedDocumentWithMeta, PublishDocumentParams, UpdatePublishParams } from './resources/publish.js';
+export { ConnectorsResource } from './resources/connectors.js';
+export type { Connector, ConnectorSyncLog, CreateConnectorParams, UpdateConnectorParams, TestConnectionResult, TriggerSyncResult, ConnectorProvider, SyncDirection, ConnectorStatus, } from './resources/connectors.js';
+export { HooksResource } from './resources/hooks.js';
+export type { Hook, HookExecution, CreateHookParams, UpdateHookParams } from './resources/hooks.js';
+export { WebhooksResource } from './resources/webhooks.js';
+export type { Webhook, WebhookWithSecret, WebhookDelivery, CreateWebhookParams, UpdateWebhookParams } from './resources/webhooks.js';
+export { AdminResource } from './resources/admin.js';
+export type { SystemStats, TimeseriesDataPoint, TimeseriesResponse, AdminUser, AdminUserListResponse, AdminUserDetail, AdminUserListParams, AdminUpdateUserParams, ActivityEntry, SubscriptionSummary, SystemHealth, } from './resources/admin.js';
+export { signRequest, buildSignaturePayload, signPayload, generateNonce, SIGNATURE_HEADER, SIGNATURE_TIMESTAMP_HEADER, SIGNATURE_NONCE_HEADER, MAX_TIMESTAMP_AGE_MS, } from './lib/signature.js';
+export { AuditLogger, type AuditEntry, type AuditLoggerOptions } from './lib/audit-logger.js';
+export { generateVaultKey, encrypt as encryptContent, decrypt as decryptContent, isEncryptedEnvelope, type EncryptedEnvelope, } from './lib/encryption.js';
+export { TokenManager, decodeJwtPayload, isTokenExpired, type AuthTokens, type JwtPayload, type OnTokenRefresh, type TokenManagerOptions, } from './lib/token-manager.js';
+export { SDKError, ValidationError, AuthenticationError, AuthorizationError, NotFoundError, ConflictError, RateLimitError, NetworkError, } from './errors.js';
+export type { PaginatedResponse, ApiErrorResponse, MessageResponse, Vault, Document, DocumentWithContent, DocumentListItem, SearchResult, SearchResponse, AiChatSession, AiChatMessage, } from './types/index.js';
+//# 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":"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"}