@sparkvault/sdk-mobile 0.1.3

package/dist/config.d.ts

@@ -0,0 +1,39 @@
+import type { FetchLike, MobileFileDownloader, MobileFileReader, SparkVaultLogger, TokenStorageAdapter } from './types.js';
+export interface SparkVaultMobileConfig {
+    tokenStorage: TokenStorageAdapter;
+    apiBaseUrl?: string;
+    identityBaseUrl?: string;
+    identityAccountId: string;
+    preloadIdentityConfig?: boolean;
+    userAgent?: string;
+    timeoutMs?: number;
+    fileTransferTimeoutMs?: number;
+    tusPostTimeoutMs?: number;
+    tusChunkTimeoutMs?: number;
+    tusChunkSizeBytes?: number;
+    fetch?: FetchLike;
+    fileReader?: MobileFileReader;
+    fileDownloader?: MobileFileDownloader;
+    logger?: Partial<SparkVaultLogger>;
+    allowedDownloadHostPatterns?: RegExp[];
+}
+export interface ResolvedMobileConfig {
+    tokenStorage: TokenStorageAdapter;
+    apiBaseUrl: string;
+    identityBaseUrl: string;
+    identityAccountId: string;
+    preloadIdentityConfig: boolean;
+    userAgent: string;
+    timeoutMs: number;
+    fileTransferTimeoutMs: number;
+    tusPostTimeoutMs: number;
+    tusChunkTimeoutMs: number;
+    tusChunkSizeBytes: number;
+    fetch: FetchLike;
+    fileReader?: MobileFileReader;
+    fileDownloader?: MobileFileDownloader;
+    logger: SparkVaultLogger;
+    allowedDownloadHostPatterns: RegExp[];
+}
+export declare function resolveMobileConfig(config: SparkVaultMobileConfig): ResolvedMobileConfig;
+export declare function identityUrl(config: ResolvedMobileConfig, path: string): string;

package/dist/config.js

@@ -0,0 +1,69 @@
+import { SparkVaultValidationError } from './errors.js';
+const DEFAULT_API_BASE_URL = 'https://api.sparkvault.com/v1';
+const DEFAULT_IDENTITY_BASE_URL = 'https://api.sparkvault.com/v1/apps/identity';
+// Hosts that are allowed to serve backend-issued ingot download URLs.
+// Keep in sync with the sdk-js default in packages/sdk-js/src/config.ts.
+const DEFAULT_ALLOWED_DOWNLOAD_HOST_PATTERNS = [
+    /(^|\.)sparkvault\.com$/i,
+    /(^|\.)(x|files|file|send|spark|by|at|db|auth)\.sv$/i,
+    /\.amazonaws\.com$/i,
+    /\.cloudfront\.net$/i,
+];
+const noopLogger = {
+    debug: () => undefined,
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+};
+function normalizeBaseUrl(url, field) {
+    if (!url || typeof url !== 'string') {
+        throw new SparkVaultValidationError(`${field} must be a non-empty string`, { field });
+    }
+    return url.replace(/\/+$/, '');
+}
+function defaultFetch(url, options) {
+    if (typeof fetch !== 'function') {
+        throw new SparkVaultValidationError('A fetch implementation is required in this runtime');
+    }
+    return fetch(url, options);
+}
+export function resolveMobileConfig(config) {
+    if (!config.tokenStorage) {
+        throw new SparkVaultValidationError('tokenStorage is required', { field: 'tokenStorage' });
+    }
+    const identityAccountId = config.identityAccountId;
+    if (!identityAccountId || typeof identityAccountId !== 'string') {
+        throw new SparkVaultValidationError('identityAccountId is required', {
+            field: 'identityAccountId',
+            received: identityAccountId,
+        });
+    }
+    if (!identityAccountId.startsWith('acc_')) {
+        throw new SparkVaultValidationError('identityAccountId must start with "acc_"', {
+            field: 'identityAccountId',
+            received: identityAccountId,
+        });
+    }
+    return {
+        tokenStorage: config.tokenStorage,
+        apiBaseUrl: normalizeBaseUrl(config.apiBaseUrl ?? DEFAULT_API_BASE_URL, 'apiBaseUrl'),
+        identityBaseUrl: normalizeBaseUrl(config.identityBaseUrl ?? DEFAULT_IDENTITY_BASE_URL, 'identityBaseUrl'),
+        identityAccountId,
+        preloadIdentityConfig: config.preloadIdentityConfig ?? true,
+        userAgent: config.userAgent ?? 'SparkVaultMobileSDK/0.1.0',
+        timeoutMs: config.timeoutMs ?? 30000,
+        fileTransferTimeoutMs: config.fileTransferTimeoutMs ?? 300000,
+        tusPostTimeoutMs: config.tusPostTimeoutMs ?? 30000,
+        tusChunkTimeoutMs: config.tusChunkTimeoutMs ?? 120000,
+        tusChunkSizeBytes: config.tusChunkSizeBytes ?? 5 * 1024 * 1024,
+        fetch: config.fetch ?? defaultFetch,
+        fileReader: config.fileReader,
+        fileDownloader: config.fileDownloader,
+        logger: { ...noopLogger, ...config.logger },
+        allowedDownloadHostPatterns: config.allowedDownloadHostPatterns ?? DEFAULT_ALLOWED_DOWNLOAD_HOST_PATTERNS,
+    };
+}
+export function identityUrl(config, path) {
+    return `${config.identityBaseUrl}/${config.identityAccountId}${path}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/encoding.d.ts

@@ -0,0 +1,7 @@
+export declare function utf8ToBytes(value: string): Uint8Array;
+export declare function base64EncodeUtf8(value: string): string;
+export declare function bytesToUtf8(bytes: Uint8Array): string;
+export declare function base64UrlToBytes(value: string): Uint8Array;
+export declare function base64UrlToUtf8(value: string): string;
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function base64ToBytes(value: string): Uint8Array;

package/dist/encoding.js

@@ -0,0 +1,113 @@
+const BASE64_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+const BASE64_LOOKUP = new Map(Array.from(BASE64_ALPHABET).map((char, index) => [char, index]));
+export function utf8ToBytes(value) {
+    const bytes = [];
+    for (let i = 0; i < value.length; i++) {
+        let codePoint = value.charCodeAt(i);
+        if (codePoint >= 0xd800 && codePoint <= 0xdbff && i + 1 < value.length) {
+            const next = value.charCodeAt(i + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                codePoint = 0x10000 + ((codePoint - 0xd800) << 10) + (next - 0xdc00);
+                i++;
+            }
+        }
+        if (codePoint <= 0x7f) {
+            bytes.push(codePoint);
+        }
+        else if (codePoint <= 0x7ff) {
+            bytes.push(0xc0 | (codePoint >> 6), 0x80 | (codePoint & 0x3f));
+        }
+        else if (codePoint <= 0xffff) {
+            bytes.push(0xe0 | (codePoint >> 12), 0x80 | ((codePoint >> 6) & 0x3f), 0x80 | (codePoint & 0x3f));
+        }
+        else {
+            bytes.push(0xf0 | (codePoint >> 18), 0x80 | ((codePoint >> 12) & 0x3f), 0x80 | ((codePoint >> 6) & 0x3f), 0x80 | (codePoint & 0x3f));
+        }
+    }
+    return new Uint8Array(bytes);
+}
+export function base64EncodeUtf8(value) {
+    return bytesToBase64(utf8ToBytes(value));
+}
+export function bytesToUtf8(bytes) {
+    let output = '';
+    let i = 0;
+    while (i < bytes.length) {
+        const byte1 = bytes[i++];
+        if (byte1 < 0x80) {
+            output += String.fromCharCode(byte1);
+            continue;
+        }
+        if (byte1 >= 0xc0 && byte1 < 0xe0) {
+            const byte2 = bytes[i++];
+            output += String.fromCharCode(((byte1 & 0x1f) << 6) | (byte2 & 0x3f));
+            continue;
+        }
+        if (byte1 >= 0xe0 && byte1 < 0xf0) {
+            const byte2 = bytes[i++];
+            const byte3 = bytes[i++];
+            output += String.fromCharCode(((byte1 & 0x0f) << 12) |
+                ((byte2 & 0x3f) << 6) |
+                (byte3 & 0x3f));
+            continue;
+        }
+        const byte2 = bytes[i++];
+        const byte3 = bytes[i++];
+        const byte4 = bytes[i++];
+        const codePoint = (((byte1 & 0x07) << 18) |
+            ((byte2 & 0x3f) << 12) |
+            ((byte3 & 0x3f) << 6) |
+            (byte4 & 0x3f)) - 0x10000;
+        output += String.fromCharCode(0xd800 + (codePoint >> 10), 0xdc00 + (codePoint & 0x3ff));
+    }
+    return output;
+}
+export function base64UrlToBytes(value) {
+    return base64ToBytes(value);
+}
+export function base64UrlToUtf8(value) {
+    return bytesToUtf8(base64UrlToBytes(value));
+}
+export function bytesToBase64(bytes) {
+    let output = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const byte1 = bytes[i];
+        const byte2 = bytes[i + 1] ?? 0;
+        const byte3 = bytes[i + 2] ?? 0;
+        const triplet = (byte1 << 16) | (byte2 << 8) | byte3;
+        output += BASE64_ALPHABET[(triplet >> 18) & 0x3f];
+        output += BASE64_ALPHABET[(triplet >> 12) & 0x3f];
+        output += i + 1 < bytes.length ? BASE64_ALPHABET[(triplet >> 6) & 0x3f] : '=';
+        output += i + 2 < bytes.length ? BASE64_ALPHABET[triplet & 0x3f] : '=';
+    }
+    return output;
+}
+export function base64ToBytes(value) {
+    const sanitized = value.replace(/\s/g, '').replace(/-/g, '+').replace(/_/g, '/');
+    if (sanitized.length % 4 === 1) {
+        throw new Error('Invalid base64 input');
+    }
+    const padded = sanitized.padEnd(Math.ceil(sanitized.length / 4) * 4, '=');
+    const bytes = [];
+    for (let i = 0; i < padded.length; i += 4) {
+        const c1 = padded[i];
+        const c2 = padded[i + 1];
+        const c3 = padded[i + 2];
+        const c4 = padded[i + 3];
+        const v1 = BASE64_LOOKUP.get(c1);
+        const v2 = BASE64_LOOKUP.get(c2);
+        const v3 = c3 === '=' ? 0 : BASE64_LOOKUP.get(c3);
+        const v4 = c4 === '=' ? 0 : BASE64_LOOKUP.get(c4);
+        if (v1 === undefined || v2 === undefined || v3 === undefined || v4 === undefined) {
+            throw new Error('Invalid base64 input');
+        }
+        const triplet = (v1 << 18) | (v2 << 12) | (v3 << 6) | v4;
+        bytes.push((triplet >> 16) & 0xff);
+        if (c3 !== '=')
+            bytes.push((triplet >> 8) & 0xff);
+        if (c4 !== '=')
+            bytes.push(triplet & 0xff);
+    }
+    return new Uint8Array(bytes);
+}
+//# sourceMappingURL=encoding.js.map

package/dist/encoding.js.map

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

package/dist/entropy.d.ts

@@ -0,0 +1,18 @@
+import type { MobileHttpClient } from './http.js';
+export type EntropyFormat = 'hex' | 'base64' | 'bytes' | 'uuid';
+export interface GenerateEntropyOptions {
+    bytes: number;
+    format?: EntropyFormat;
+}
+export interface EntropyResponse {
+    value: string;
+    num_bytes: number;
+    format?: EntropyFormat;
+}
+export declare class MobileEntropyClient {
+    private readonly http;
+    constructor(http: MobileHttpClient);
+    generate(options: GenerateEntropyOptions): Promise<EntropyResponse>;
+    generateBytes(bytes: number): Promise<Uint8Array>;
+    private validateByteCount;
+}

package/dist/entropy.js

@@ -0,0 +1,35 @@
+import { base64ToBytes } from './encoding.js';
+import { SparkVaultMobileError, SparkVaultValidationError } from './errors.js';
+export class MobileEntropyClient {
+    constructor(http) {
+        this.http = http;
+    }
+    async generate(options) {
+        this.validateByteCount(options.bytes);
+        const response = await this.http.post('/entropy/generate', {
+            num_bytes: options.bytes,
+            format: options.format ?? 'base64',
+        });
+        return response.data;
+    }
+    async generateBytes(bytes) {
+        const response = await this.generate({ bytes, format: 'base64' });
+        if (typeof response.value !== 'string' || response.value.length === 0) {
+            throw new SparkVaultMobileError('Entropy endpoint returned no value');
+        }
+        const entropy = base64ToBytes(response.value);
+        if (entropy.length !== bytes) {
+            throw new SparkVaultMobileError(`Entropy length mismatch: expected ${bytes}, got ${entropy.length}`);
+        }
+        return entropy;
+    }
+    validateByteCount(bytes) {
+        if (!Number.isInteger(bytes) || bytes < 1 || bytes > 1024) {
+            throw new SparkVaultValidationError('Entropy byte count must be an integer from 1 to 1024', {
+                field: 'bytes',
+                received: bytes,
+            });
+        }
+    }
+}
+//# sourceMappingURL=entropy.js.map

package/dist/entropy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entropy.js","sourceRoot":"","sources":["../src/entropy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAgB/E,MAAM,OAAO,mBAAmB;IAG9B,YAAY,IAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAA+B;QAC5C,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAkB,mBAAmB,EAAE;YAC1E,SAAS,EAAE,OAAO,CAAC,KAAK;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ;SACnC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAa;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,qBAAqB,CAAC,oCAAoC,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,qBAAqB,CAAC,qCAAqC,KAAK,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACvG,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,iBAAiB,CAAC,KAAa;QACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;YAC1D,MAAM,IAAI,yBAAyB,CAAC,sDAAsD,EAAE;gBAC1F,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,46 @@
+import type { ApiMeta } from './types.js';
+export declare class SparkVaultMobileError extends Error {
+    readonly code: string | number;
+    readonly statusCode?: number;
+    readonly details?: Record<string, unknown>;
+    readonly meta?: ApiMeta;
+    constructor(message: string, options?: {
+        code?: string | number;
+        statusCode?: number;
+        details?: Record<string, unknown>;
+        meta?: ApiMeta;
+    });
+}
+export declare class SparkVaultValidationError extends SparkVaultMobileError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class SparkVaultAuthenticationError extends SparkVaultMobileError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+export declare class SparkVaultAuthorizationError extends SparkVaultMobileError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+export declare class SparkVaultNetworkError extends SparkVaultMobileError {
+    constructor(message?: string, details?: Record<string, unknown>);
+}
+export declare class SparkVaultTimeoutError extends SparkVaultMobileError {
+    constructor(message?: string);
+}
+export declare class TusUploadError extends SparkVaultMobileError {
+    readonly cause: Error | null;
+    readonly filename: string | null;
+    readonly fileSize: number | null;
+    readonly phase: 'create' | 'upload' | 'network' | 'timeout' | 'cancelled' | 'stalled' | 'unknown';
+    constructor(message: string, options?: {
+        cause?: Error | null;
+        httpStatus?: number | null;
+        filename?: string | null;
+        fileSize?: number | null;
+        phase?: TusUploadError['phase'];
+    });
+    static fromError(error: Error, context: {
+        filename?: string;
+        fileSize?: number;
+        phase?: TusUploadError['phase'];
+    }): TusUploadError;
+}

package/dist/errors.js

@@ -0,0 +1,72 @@
+export class SparkVaultMobileError extends Error {
+    constructor(message, options = {}) {
+        super(message);
+        this.name = 'SparkVaultMobileError';
+        this.code = options.code ?? 'sparkvault_error';
+        this.statusCode = options.statusCode;
+        this.details = options.details;
+        this.meta = options.meta;
+        Object.setPrototypeOf(this, SparkVaultMobileError.prototype);
+    }
+}
+export class SparkVaultValidationError extends SparkVaultMobileError {
+    constructor(message, details) {
+        super(message, { code: 'validation_error', statusCode: 400, details });
+        this.name = 'SparkVaultValidationError';
+        Object.setPrototypeOf(this, SparkVaultValidationError.prototype);
+    }
+}
+export class SparkVaultAuthenticationError extends SparkVaultMobileError {
+    constructor(message = 'Authentication required', details) {
+        super(message, { code: 'authentication_error', statusCode: 401, details });
+        this.name = 'SparkVaultAuthenticationError';
+        Object.setPrototypeOf(this, SparkVaultAuthenticationError.prototype);
+    }
+}
+export class SparkVaultAuthorizationError extends SparkVaultMobileError {
+    constructor(message = 'Forbidden', details) {
+        super(message, { code: 'authorization_error', statusCode: 403, details });
+        this.name = 'SparkVaultAuthorizationError';
+        Object.setPrototypeOf(this, SparkVaultAuthorizationError.prototype);
+    }
+}
+export class SparkVaultNetworkError extends SparkVaultMobileError {
+    constructor(message = 'Network request failed', details) {
+        super(message, { code: 'network_error', details });
+        this.name = 'SparkVaultNetworkError';
+        Object.setPrototypeOf(this, SparkVaultNetworkError.prototype);
+    }
+}
+export class SparkVaultTimeoutError extends SparkVaultMobileError {
+    constructor(message = 'Request timed out') {
+        super(message, { code: 'timeout_error', statusCode: 408 });
+        this.name = 'SparkVaultTimeoutError';
+        Object.setPrototypeOf(this, SparkVaultTimeoutError.prototype);
+    }
+}
+export class TusUploadError extends SparkVaultMobileError {
+    constructor(message, options = {}) {
+        super(message, {
+            code: options.httpStatus ?? 'tus_upload_error',
+            statusCode: options.httpStatus ?? undefined,
+        });
+        this.name = 'TusUploadError';
+        this.cause = options.cause ?? null;
+        this.filename = options.filename ?? null;
+        this.fileSize = options.fileSize ?? null;
+        this.phase = options.phase ?? 'unknown';
+        Object.setPrototypeOf(this, TusUploadError.prototype);
+    }
+    static fromError(error, context) {
+        const statusMatch = error.message.match(/(\d{3})/);
+        const httpStatus = statusMatch ? parseInt(statusMatch[1], 10) : null;
+        return new TusUploadError(error.message, {
+            cause: error,
+            httpStatus,
+            filename: context.filename,
+            fileSize: context.fileSize,
+            phase: context.phase ?? 'unknown',
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAM9C,YACE,OAAe,EACf,UAKI,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,kBAAkB,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,qBAAqB;IAClE,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;CACF;AAED,MAAM,OAAO,6BAA8B,SAAQ,qBAAqB;IACtE,YAAY,OAAO,GAAG,yBAAyB,EAAE,OAAiC;QAChF,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,6BAA6B,CAAC,SAAS,CAAC,CAAC;IACvE,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,qBAAqB;IACrE,YAAY,OAAO,GAAG,WAAW,EAAE,OAAiC;QAClE,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,qBAAqB;IAC/D,YAAY,OAAO,GAAG,wBAAwB,EAAE,OAAiC;QAC/E,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,qBAAqB;IAC/D,YAAY,OAAO,GAAG,mBAAmB;QACvC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,qBAAqB;IAMvD,YACE,OAAe,EACf,UAMI,EAAE;QAEN,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,OAAO,CAAC,UAAU,IAAI,kBAAkB;YAC9C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;SAC5C,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,SAAS,CACd,KAAY,EACZ,OAAkF;QAElF,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrE,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE;YACvC,KAAK,EAAE,KAAK;YACZ,UAAU;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;SAClC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/folders.d.ts

@@ -0,0 +1,15 @@
+import type { MobileHttpClient } from './http.js';
+import type { CreateFolderRequest, Folder, FolderBreadcrumbItem, ListFoldersResponse, UpdateFolderRequest } from './types.js';
+export declare class MobileFoldersClient {
+    private readonly http;
+    constructor(http: MobileHttpClient);
+    list(vaultId: string, vat: string): Promise<ListFoldersResponse>;
+    get(vaultId: string, folderId: string, vat: string): Promise<Folder>;
+    getBreadcrumb(vaultId: string, folderId: string, vat: string): Promise<FolderBreadcrumbItem[]>;
+    create(vaultId: string, vat: string, data: CreateFolderRequest): Promise<Folder>;
+    update(vaultId: string, folderId: string, vat: string, data: UpdateFolderRequest): Promise<Folder>;
+    move(vaultId: string, folderId: string, vat: string, newParentId: string | null): Promise<Folder>;
+    togglePin(vaultId: string, folderId: string, vat: string, pinned: boolean): Promise<Folder>;
+    delete(vaultId: string, folderId: string, vat: string): Promise<void>;
+    moveIngot(vaultId: string, ingotId: string, vat: string, folderId: string | null): Promise<void>;
+}

package/dist/folders.js

@@ -0,0 +1,54 @@
+import { validateFolderId, validateIngotId, validateVaultId } from './validation.js';
+export class MobileFoldersClient {
+    constructor(http) {
+        this.http = http;
+    }
+    async list(vaultId, vat) {
+        validateVaultId(vaultId);
+        const response = await this.http.get(`/vaults/${vaultId}/folders`, { vat });
+        return response.data;
+    }
+    async get(vaultId, folderId, vat) {
+        validateVaultId(vaultId);
+        validateFolderId(folderId);
+        const response = await this.http.get(`/vaults/${vaultId}/folders/${folderId}`, { vat });
+        return response.data;
+    }
+    async getBreadcrumb(vaultId, folderId, vat) {
+        validateVaultId(vaultId);
+        validateFolderId(folderId);
+        const response = await this.http.get(`/vaults/${vaultId}/folders/${folderId}/breadcrumb`, { vat });
+        return response.data.breadcrumb;
+    }
+    async create(vaultId, vat, data) {
+        validateVaultId(vaultId);
+        const response = await this.http.post(`/vaults/${vaultId}/folders`, data, { vat });
+        return response.data;
+    }
+    async update(vaultId, folderId, vat, data) {
+        validateVaultId(vaultId);
+        validateFolderId(folderId);
+        const response = await this.http.patch(`/vaults/${vaultId}/folders/${folderId}`, data, { vat });
+        return response.data;
+    }
+    async move(vaultId, folderId, vat, newParentId) {
+        return this.update(vaultId, folderId, vat, { parent_id: newParentId });
+    }
+    async togglePin(vaultId, folderId, vat, pinned) {
+        return this.update(vaultId, folderId, vat, { pinned });
+    }
+    async delete(vaultId, folderId, vat) {
+        validateVaultId(vaultId);
+        validateFolderId(folderId);
+        await this.http.delete(`/vaults/${vaultId}/folders/${folderId}`, { vat });
+    }
+    async moveIngot(vaultId, ingotId, vat, folderId) {
+        validateVaultId(vaultId);
+        validateIngotId(ingotId);
+        if (folderId !== null) {
+            validateFolderId(folderId);
+        }
+        await this.http.patch(`/vaults/${vaultId}/ingots/${ingotId}`, { folder_id: folderId }, { vat });
+    }
+}
+//# sourceMappingURL=folders.js.map

package/dist/folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.js","sourceRoot":"","sources":["../src/folders.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAErF,MAAM,OAAO,mBAAmB;IAG9B,YAAY,IAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,GAAW;QACrC,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,WAAW,OAAO,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACjG,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,QAAgB,EAAE,GAAW;QACtD,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,WAAW,OAAO,YAAY,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAChG,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,QAAgB,EAAE,GAAW;QAChE,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAClC,WAAW,OAAO,YAAY,QAAQ,aAAa,EACnD,EAAE,GAAG,EAAE,CACR,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,GAAW,EAAE,IAAyB;QAClE,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAS,WAAW,OAAO,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3F,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,QAAgB,EAAE,GAAW,EAAE,IAAyB;QACpF,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAS,WAAW,OAAO,YAAY,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACxG,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,QAAgB,EAAE,GAAW,EAAE,WAA0B;QACnF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,QAAgB,EAAE,GAAW,EAAE,MAAe;QAC7E,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,QAAgB,EAAE,GAAW;QACzD,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,OAAO,YAAY,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,OAAe,EAAE,GAAW,EAAE,QAAuB;QACpF,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,OAAO,WAAW,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAClG,CAAC;CACF"}

package/dist/health.d.ts

@@ -0,0 +1,19 @@
+import type { ResolvedMobileConfig } from './config.js';
+export interface HealthCheckOptions {
+    timeoutMs?: number;
+}
+export interface HealthCheckResult {
+    online: boolean;
+    status: string;
+    httpStatus?: number;
+    checkedAt: number;
+    error?: string;
+}
+export declare class MobileHealthClient {
+    private readonly config;
+    constructor(config: ResolvedMobileConfig);
+    check(options?: HealthCheckOptions): Promise<HealthCheckResult>;
+    isOnline(options?: HealthCheckOptions): Promise<boolean>;
+    private healthUrl;
+    private readStatus;
+}

package/dist/health.js

@@ -0,0 +1,60 @@
+export class MobileHealthClient {
+    constructor(config) {
+        this.config = config;
+    }
+    async check(options = {}) {
+        const checkedAt = Math.floor(Date.now() / 1000);
+        try {
+            const response = await this.config.fetch(this.healthUrl(), {
+                method: 'GET',
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': this.config.userAgent,
+                },
+                timeoutMs: options.timeoutMs ?? this.config.timeoutMs,
+            });
+            return {
+                online: response.ok,
+                status: response.ok ? await this.readStatus(response) : 'unhealthy',
+                httpStatus: response.status,
+                checkedAt,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this.config.logger.debug('Health check failed', { error: message });
+            return {
+                online: false,
+                status: 'unreachable',
+                checkedAt,
+                error: message,
+            };
+        }
+    }
+    async isOnline(options = {}) {
+        const result = await this.check(options);
+        return result.online;
+    }
+    healthUrl() {
+        return `${this.config.apiBaseUrl.replace(/\/v1$/, '')}/health`;
+    }
+    async readStatus(response) {
+        try {
+            const body = await response.json();
+            const data = typeof body === 'object' && body !== null && 'data' in body
+                ? body.data
+                : body;
+            if (typeof data === 'object' && data !== null) {
+                const status = data.status;
+                if (typeof status === 'string' && status) {
+                    return status;
+                }
+            }
+        }
+        catch {
+            return response.ok ? 'healthy' : 'unhealthy';
+        }
+        return response.ok ? 'healthy' : 'unhealthy';
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,kBAAkB;IAG7B,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,UAA8B,EAAE;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE;gBACzD,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,MAAM,EAAE,kBAAkB;oBAC1B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;iBACpC;gBACD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;aACtD,CAAC,CAAC;YAEH,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW;gBACnE,UAAU,EAAE,QAAQ,CAAC,MAAM;gBAC3B,SAAS;aACV,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACpE,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,aAAa;gBACrB,SAAS;gBACT,KAAK,EAAE,OAAO;aACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAA8B,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAEO,SAAS;QACf,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC;IACjE,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,QAAkB;QACzC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI;gBACtE,CAAC,CAAE,IAA2B,CAAC,IAAI;gBACnC,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC9C,MAAM,MAAM,GAAI,IAA6B,CAAC,MAAM,CAAC;gBACrD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,EAAE,CAAC;oBACzC,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;QAC/C,CAAC;QAED,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/C,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,45 @@
+import type { ResolvedMobileConfig } from './config.js';
+import type { ApiMeta, ApiResponse, RateLimitInfo } from './types.js';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface RequestOptions {
+    body?: unknown;
+    headers?: Record<string, string>;
+    skipAuth?: boolean;
+    vat?: string;
+    timeoutMs?: number;
+}
+export type AuthEvent = 'logout' | 'token_refreshed';
+export type AuthEventListener = (event: AuthEvent) => void;
+export declare class MobileHttpClient {
+    private readonly config;
+    private readonly authListeners;
+    private readonly refreshMutex;
+    private lastMeta;
+    private rateLimitInfo;
+    constructor(config: ResolvedMobileConfig);
+    get baseUrl(): string;
+    get meta(): ApiMeta | null;
+    get rateLimit(): RateLimitInfo | null;
+    onAuthEvent(listener: AuthEventListener): () => void;
+    private emitAuthEvent;
+    private getHeaders;
+    private parseRateLimitHeaders;
+    private normalizeError;
+    private makeUrl;
+    private serializeBody;
+    refreshAccessToken(): Promise<boolean>;
+    private doRefreshOnce;
+    private doRefresh;
+    request<T>(method: HttpMethod, endpoint: string, options?: RequestOptions): Promise<ApiResponse<T>>;
+    requestRaw(endpoint: string, options?: RequestOptions & {
+        method?: HttpMethod;
+        responseType?: XMLHttpRequestResponseType;
+    }): Promise<Response>;
+    get<T>(endpoint: string, options?: RequestOptions): Promise<ApiResponse<T>>;
+    post<T>(endpoint: string, body?: unknown, options?: RequestOptions): Promise<ApiResponse<T>>;
+    put<T>(endpoint: string, body?: unknown, options?: RequestOptions): Promise<ApiResponse<T>>;
+    patch<T>(endpoint: string, body?: unknown, options?: RequestOptions): Promise<ApiResponse<T>>;
+    delete<T>(endpoint: string, options?: RequestOptions): Promise<ApiResponse<T>>;
+    uploadFile<T>(endpoint: string, formData: FormData, options?: Omit<RequestOptions, 'body'>): Promise<ApiResponse<T>>;
+    private defaultErrorMessage;
+}