@sparkvault/sdk 1.1.6 → 1.8.2

package/dist/vaults/upload/api.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Upload API
+ *
+ * API client for vault upload operations.
+ */
+import type { ResolvedConfig } from '../../config';
+import type { VaultUploadConfig } from './types';
+import { SparkVaultError } from '../../errors';
+/**
+ * Error class for upload API errors.
+ */
+export declare class UploadApiError extends SparkVaultError {
+    readonly httpStatus: number;
+    constructor(message: string, code: string, httpStatus: number);
+}
+export declare class UploadApi {
+    private readonly config;
+    private readonly timeoutMs;
+    constructor(config: ResolvedConfig);
+    /**
+     * Get vault upload info (public endpoint).
+     */
+    getVaultUploadInfo(vaultId: string): Promise<VaultUploadConfig>;
+    /**
+     * Initiate an upload to get Forge URL and ingot ID.
+     */
+    initiateUpload(vaultId: string, filename: string, sizeBytes: number, contentType: string): Promise<{
+        forgeUrl: string;
+        ingotId: string;
+    }>;
+    /**
+     * Internal request method with timeout handling and error context.
+     */
+    private request;
+}

package/dist/vaults/upload/container.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Upload Container Interface
+ *
+ * Abstract interface for upload UI containers.
+ * Allows switching between modal (popup) and inline rendering modes
+ * while reusing all view logic, state management, and handlers.
+ */
+import type { UploadBranding } from './types';
+/**
+ * Container options for initialization.
+ */
+export interface UploadContainerOptions {
+    branding?: UploadBranding;
+    /** Enable backdrop blur (modal only) */
+    backdropBlur?: boolean;
+}
+/**
+ * Container interface that both ModalContainer and InlineContainer implement.
+ * The renderer interacts with containers through this interface.
+ */
+export interface UploadContainer {
+    /**
+     * Create the container with loading state.
+     * Called immediately when upload flow starts.
+     */
+    createLoading(options: {
+        backdropBlur?: boolean;
+    }, onClose: () => void): void;
+    /**
+     * Update branding after vault config loads.
+     */
+    updateBranding(branding: UploadBranding): void;
+    /**
+     * Update backdrop blur setting (may be no-op for inline container).
+     */
+    updateBackdropBlur(enabled: boolean): void;
+    /**
+     * Get the body element where views are rendered.
+     */
+    getBody(): HTMLDivElement | null;
+    /**
+     * Get the sidebar element for security info (optional).
+     */
+    getSidebar(): HTMLDivElement | null;
+    /**
+     * Show or hide the security sidebar.
+     */
+    toggleSidebar(show: boolean): void;
+    /**
+     * Check if the container is currently active.
+     */
+    isOpen(): boolean;
+    /**
+     * Destroy the container and clean up event listeners.
+     */
+    destroy(): void;
+}

package/dist/vaults/upload/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Vault Upload Module
+ *
+ * Embedded upload widget for vaults with public upload enabled.
+ *
+ * @example Dialog mode (immediate)
+ * const result = await sv.vaults.upload({ vaultId: 'vlt_abc123' });
+ *
+ * @example Dialog mode (attached to clicks)
+ * sv.vaults.upload.attach('.upload-btn', { vaultId: 'vlt_abc123' });
+ *
+ * @example Inline mode
+ * const result = await sv.vaults.upload({
+ *   vaultId: 'vlt_abc123',
+ *   target: '#upload-container'
+ * });
+ */
+import type { ResolvedConfig } from '../../config';
+import type { UploadOptions, UploadAttachOptions, UploadResult } from './types';
+export declare class VaultUploadModule {
+    private readonly config;
+    private readonly api;
+    private renderer;
+    private attachedElements;
+    constructor(config: ResolvedConfig);
+    /**
+     * Upload a file to a vault.
+     *
+     * - Without `target`: Opens a dialog (modal)
+     * - With `target`: Renders inline into the specified element
+     *
+     * @example Dialog mode
+     * const result = await sv.vaults.upload({ vaultId: 'vlt_abc123' });
+     * console.log('Uploaded:', result.ingotId);
+     *
+     * @example Inline mode
+     * const result = await sv.vaults.upload({
+     *   vaultId: 'vlt_abc123',
+     *   target: '#upload-container'
+     * });
+     */
+    upload(options: UploadOptions): Promise<UploadResult>;
+    /**
+     * Attach upload functionality to element clicks.
+     * When any matching element is clicked, opens the upload dialog.
+     *
+     * @param selector - CSS selector for elements to attach to
+     * @param options - Upload options including vaultId and callbacks
+     * @returns Cleanup function to remove event listeners
+     *
+     * @example
+     * const cleanup = sv.vaults.upload.attach('.upload-btn', {
+     *   vaultId: 'vlt_abc123',
+     *   onSuccess: (result) => console.log('Uploaded:', result.ingotId)
+     * });
+     *
+     * // Later, remove listeners
+     * cleanup();
+     */
+    attach(selector: string, options: UploadAttachOptions): () => void;
+    /**
+     * Close the upload dialog/inline UI if open.
+     */
+    close(): void;
+    /**
+     * Resolve target to an HTMLElement and create inline container.
+     */
+    private createInlineContainer;
+    /**
+     * @deprecated Use `upload()` instead. Will be removed in v2.0.
+     */
+    pop(options: UploadOptions): Promise<UploadResult>;
+    /**
+     * @deprecated Use `upload({ target })` instead. Will be removed in v2.0.
+     */
+    render(options: UploadOptions): Promise<UploadResult>;
+}
+export type { UploadOptions, UploadAttachOptions, UploadResult, UploadProgress, VaultUploadConfig, UploadBranding, EncryptionInfo, UploadPopOptions, UploadRenderOptions, } from './types';
+export { UploadApiError } from './api';

package/dist/vaults/upload/inline-container.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Inline Upload Container
+ *
+ * Renders upload UI inline within a target element.
+ * Unlike UploadModalContainer which creates an overlay popup, this embeds
+ * directly into the customer's page where render() was called.
+ *
+ * Implements the UploadContainer interface for use with UploadRenderer.
+ */
+import type { UploadContainer } from './container';
+import type { UploadBranding } from './types';
+export interface InlineContainerOptions {
+    /** Show header with branding and optional close button */
+    showHeader?: boolean;
+    /** Show close button in header (requires showHeader) */
+    showCloseButton?: boolean;
+    /** Show footer with SparkVault branding */
+    showFooter?: boolean;
+}
+export declare class UploadInlineContainer implements UploadContainer {
+    private readonly targetElement;
+    private readonly containerOptions;
+    private container;
+    private header;
+    private body;
+    private footer;
+    private sidebar;
+    private closeBtn;
+    private onCloseCallback;
+    private closeBtnClickHandler;
+    private isDarkMode;
+    private branding;
+    constructor(targetElement: HTMLElement, options?: InlineContainerOptions);
+    /**
+     * Create the inline container with loading state.
+     */
+    createLoading(_options: {
+        backdropBlur?: boolean;
+    }, onClose: () => void): void;
+    /**
+     * Update branding after vault config loads.
+     */
+    updateBranding(branding: UploadBranding): void;
+    /**
+     * Update backdrop blur setting (no-op for inline container).
+     */
+    updateBackdropBlur(_enabled: boolean): void;
+    /**
+     * Set dark mode for uploading/ceremony states.
+     */
+    setDarkMode(enabled: boolean): void;
+    /**
+     * Show or hide the security sidebar.
+     */
+    toggleSidebar(show: boolean): void;
+    /**
+     * Get the body element for content rendering.
+     */
+    getBody(): HTMLDivElement | null;
+    /**
+     * Get the sidebar element.
+     */
+    getSidebar(): HTMLDivElement | null;
+    /**
+     * Check if the container is currently active.
+     */
+    isOpen(): boolean;
+    /**
+     * Destroy the container and clean up.
+     */
+    destroy(): void;
+    private createHeader;
+    private createSecuritySidebar;
+    private handleClose;
+}

package/dist/vaults/upload/modal.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Upload Modal Container
+ *
+ * Single responsibility: DOM modal container lifecycle.
+ * Creates, shows, hides, and destroys the modal overlay and container.
+ * Does NOT handle content rendering - that's the Renderer's job.
+ */
+import type { UploadBranding } from './types';
+import type { UploadContainer } from './container';
+export interface UploadModalOptions {
+    branding?: UploadBranding;
+    backdropBlur?: boolean;
+}
+export interface ModalContainerElements {
+    overlay: HTMLDivElement;
+    modal: HTMLDivElement;
+    main: HTMLDivElement;
+    header: HTMLDivElement;
+    body: HTMLDivElement;
+    footer: HTMLDivElement;
+    sidebar: HTMLDivElement | null;
+}
+export declare class UploadModalContainer implements UploadContainer {
+    private elements;
+    private onCloseCallback;
+    private keydownHandler;
+    private overlayClickHandler;
+    private closeBtnClickHandler;
+    private closeBtn;
+    private backdropBlur;
+    private isDarkMode;
+    private headerElement;
+    private branding;
+    /**
+     * Create and show the modal immediately with loading state.
+     */
+    createLoading(options: {
+        backdropBlur?: boolean;
+    }, onClose: () => void): void;
+    /**
+     * Create and show the modal container.
+     */
+    private create;
+    private createHeader;
+    /**
+     * Update branding after vault config loads.
+     */
+    updateBranding(branding: UploadBranding): void;
+    /**
+     * Update backdrop blur setting.
+     */
+    updateBackdropBlur(enabled: boolean): void;
+    /**
+     * Set dark mode for uploading/ceremony states.
+     */
+    setDarkMode(enabled: boolean): void;
+    /**
+     * Show or hide the security sidebar.
+     */
+    toggleSidebar(show: boolean): void;
+    private createSecuritySidebar;
+    private handleClose;
+    /**
+     * Get the modal body element for content rendering.
+     */
+    getBody(): HTMLDivElement | null;
+    /**
+     * Get the sidebar element.
+     */
+    getSidebar(): HTMLDivElement | null;
+    /**
+     * Check if the modal is currently open.
+     */
+    isOpen(): boolean;
+    /**
+     * Destroy the modal and clean up all event listeners.
+     */
+    destroy(): void;
+}

package/dist/vaults/upload/renderer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Upload Renderer
+ *
+ * Orchestrates view state and rendering for vault upload flows.
+ * Manages the complete upload lifecycle: form, uploading, ceremony, completion.
+ */
+import type { UploadOptions, UploadResult, UploadProgress } from './types';
+import type { UploadContainer } from './container';
+import { UploadApi } from './api';
+interface RendererCallbacks {
+    onSuccess: (result: UploadResult) => void;
+    onError: (error: Error) => void;
+    onCancel: () => void;
+    onProgress?: (progress: UploadProgress) => void;
+}
+export declare class UploadRenderer {
+    private readonly api;
+    private readonly container;
+    private readonly options;
+    private readonly callbacks;
+    private viewState;
+    private config;
+    private selectedFile;
+    private fileInputElement;
+    constructor(container: UploadContainer, api: UploadApi, options: UploadOptions, callbacks: RendererCallbacks);
+    /**
+     * Start the upload flow.
+     */
+    start(): Promise<void>;
+    /**
+     * Close the upload flow.
+     */
+    close(): void;
+    private handleClose;
+    private setState;
+    private render;
+    private renderLoading;
+    private renderForm;
+    private renderUploading;
+    private renderCeremony;
+    private renderComplete;
+    private renderError;
+    private handleFileSelect;
+    private openFileSelector;
+    private cleanupFileInput;
+    private pasteHandler;
+    private setupPasteHandler;
+    private cleanupPasteHandler;
+    private startUpload;
+    private uploadWithTus;
+    private runCeremony;
+    private handleApiError;
+    private escapeHtml;
+}
+export {};

package/dist/vaults/upload/styles.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Upload Widget Styles
+ *
+ * Enterprise-grade styling for the vault upload widget.
+ * Follows the same design principles as the identity modal.
+ */
+import type { UploadBranding } from './types';
+export interface UploadStyleOptions {
+    branding?: UploadBranding;
+    backdropBlur?: boolean;
+    theme?: 'light' | 'dark';
+}
+/**
+ * Inject upload widget styles into the document head.
+ */
+export declare function injectUploadStyles(options: UploadStyleOptions): void;
+/**
+ * Remove upload widget styles.
+ */
+export declare function removeUploadStyles(): void;

package/dist/vaults/upload/types.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Vault Upload Module Types
+ *
+ * Types for the embedded vault upload widget.
+ */
+/**
+ * Branding configuration from vault upload info.
+ */
+export interface UploadBranding {
+    /** Organization name */
+    organizationName: string;
+    /** Light theme logo URL */
+    logoLightUrl: string | null;
+    /** Dark theme logo URL */
+    logoDarkUrl: string | null;
+}
+/**
+ * Encryption information for the vault.
+ */
+export interface EncryptionInfo {
+    /** Encryption algorithm (e.g., 'AES-256-GCM') */
+    algorithm: string;
+    /** Key derivation method (e.g., 'Triple Zero-Trust') */
+    keyDerivation: string;
+    /** Post-quantum protection status */
+    postQuantum: string;
+}
+/**
+ * Vault upload configuration from API.
+ */
+export interface VaultUploadConfig {
+    /** Vault ID */
+    vaultId: string;
+    /** Vault name */
+    vaultName: string;
+    /** Maximum upload size in bytes */
+    maxSizeBytes: number;
+    /** Branding information */
+    branding: UploadBranding;
+    /** Encryption details */
+    encryption: EncryptionInfo;
+    /** Forge status */
+    forgeStatus: 'active' | 'inactive';
+}
+/**
+ * Options for upload().
+ * - Without `target`: Opens a dialog (modal)
+ * - With `target`: Renders inline into the specified element
+ */
+export interface UploadOptions {
+    /** Vault ID to upload to */
+    vaultId: string;
+    /**
+     * Target element for inline rendering. Can be:
+     * - A CSS selector string (e.g., "#upload-container")
+     * - An HTMLElement reference
+     * - Omitted for dialog mode (default)
+     */
+    target?: string | HTMLElement;
+    /** Override backdrop blur for this dialog (uses global config if omitted) */
+    backdropBlur?: boolean;
+    /** Callback when upload completes successfully (if omitted, uses server-configured redirect) */
+    onSuccess?: (result: UploadResult) => void;
+    /** Callback when an error occurs (if omitted, uses server-configured redirect) */
+    onError?: (error: Error) => void;
+    /** Callback when user cancels (if omitted, uses server-configured redirect) */
+    onCancel?: () => void;
+    /** Callback for upload progress */
+    onProgress?: (progress: UploadProgress) => void;
+}
+/** Options for attach() - binds upload to element clicks */
+export interface UploadAttachOptions {
+    /** Vault ID to upload to */
+    vaultId: string;
+    /** Callback when upload completes successfully */
+    onSuccess?: (result: UploadResult) => void;
+    /** Callback when an error occurs */
+    onError?: (error: Error) => void;
+    /** Callback when user cancels */
+    onCancel?: () => void;
+    /** Callback for upload progress */
+    onProgress?: (progress: UploadProgress) => void;
+}
+/** @deprecated Use UploadOptions instead */
+export type UploadPopOptions = UploadOptions;
+/** @deprecated Use UploadOptions instead */
+export type UploadRenderOptions = UploadOptions;
+/**
+ * Upload progress information.
+ */
+export interface UploadProgress {
+    /** Bytes uploaded */
+    bytesUploaded: number;
+    /** Total bytes */
+    bytesTotal: number;
+    /** Percentage (0-100) */
+    percentage: number;
+    /** Current phase */
+    phase: 'uploading' | 'ceremony' | 'complete';
+}
+/**
+ * Successful upload result.
+ */
+export interface UploadResult {
+    /** Ingot ID */
+    ingotId: string;
+    /** Vault ID */
+    vaultId: string;
+    /** Original filename */
+    filename: string;
+    /** File size in bytes */
+    sizeBytes: number;
+    /** Upload timestamp (ISO 8601) */
+    uploadTime: string;
+}
+/**
+ * Upload view states.
+ */
+export type UploadViewState = {
+    view: 'loading';
+} | {
+    view: 'form';
+    config: VaultUploadConfig;
+    error?: string;
+} | {
+    view: 'uploading';
+    file: File;
+    ingotId: string;
+    requestId: string;
+    progress: number;
+    bytesUploaded: number;
+} | {
+    view: 'ceremony';
+    file: File;
+    ingotId: string;
+    requestId: string;
+    step: number;
+    complete: boolean;
+} | {
+    view: 'complete';
+    result: UploadResult;
+    config: VaultUploadConfig;
+} | {
+    view: 'error';
+    message: string;
+    code: string;
+    httpStatus?: number;
+};
+/**
+ * API response for vault upload info.
+ */
+export interface VaultUploadInfoResponse {
+    vault_id: string;
+    vault_name: string;
+    max_size_bytes: number;
+    branding: {
+        organization_name: string;
+        logo_light_url: string | null;
+        logo_dark_url: string | null;
+    };
+    encryption: {
+        algorithm: string;
+        key_derivation: string;
+        post_quantum: string;
+    };
+    forge_status: 'active' | 'inactive';
+}
+/**
+ * API response for initiating upload.
+ */
+export interface InitiateUploadResponse {
+    forge_url: string;
+    ingot_id: string;
+}
+/**
+ * Ceremony step definition.
+ */
+export interface CeremonyStep {
+    /** Display text */
+    text: string;
+    /** Duration in milliseconds */
+    duration: number;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sparkvault/sdk",
-  "version": "1.1.6",
-  "description": "SparkVault JavaScript SDK - Identity, Sparks, Vaults, and RNG",
+  "version": "1.8.2",
+  "description": "SparkVault JavaScript SDK - Identity Verification and Encrypted Vaults",
   "type": "module",
   "main": "dist/sparkvault.cjs.js",
   "module": "dist/sparkvault.esm.js",
@@ -16,8 +16,7 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext .ts",
     "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run build"
+    "test:watch": "vitest"
   },
   "keywords": [
     "sparkvault",
@@ -28,14 +27,14 @@
     "passkey",
     "webauthn",
     "totp",
-    "vault",
-    "rng"
+    "vault"
   ],
   "author": "SparkVault",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Spark-Vault/sdk-js.git"
+    "url": "git+https://github.com/Spark-Vault/platform.git",
+    "directory": "packages/sdk-js"
   },
   "homepage": "https://sparkvault.com/api/docs/sdk",
   "devDependencies": {

package/dist/rng/index.d.ts

@@ -1,54 +0,0 @@
-/**
- * RNG Module
- *
- * Generate cryptographically secure random numbers.
- * Uses hybrid entropy from AWS KMS HSM + local CSPRNG.
- */
-import { HttpClient } from '../http';
-import type { GenerateOptions, RandomResult } from './types';
-export declare class RNGModule {
-    private readonly http;
-    constructor(http: HttpClient);
-    /**
-     * Generate cryptographically secure random bytes.
-     *
-     * @example
-     * const result = await sv.rng.generate({ bytes: 32, format: 'hex' });
-     * console.log(result.value);
-     */
-    generate(options: GenerateOptions): Promise<RandomResult>;
-    /**
-     * Generate a random UUID v4.
-     *
-     * @example
-     * const uuid = await sv.rng.uuid();
-     * console.log(uuid); // 'f47ac10b-58cc-4372-a567-0e02b2c3d479'
-     */
-    uuid(): Promise<string>;
-    /**
-     * Generate a random hex string.
-     *
-     * @example
-     * const hex = await sv.rng.hex(16);
-     * console.log(hex); // '1a2b3c4d5e6f7890...'
-     */
-    hex(bytes: number): Promise<string>;
-    /**
-     * Generate a random alphanumeric string.
-     *
-     * @example
-     * const code = await sv.rng.alphanumeric(8);
-     * console.log(code); // 'A1B2C3D4'
-     */
-    alphanumeric(bytes: number): Promise<string>;
-    /**
-     * Generate a random password with special characters.
-     *
-     * @example
-     * const password = await sv.rng.password(16);
-     * console.log(password); // 'aB3$xY7!mN9@pQ2#'
-     */
-    password(bytes: number): Promise<string>;
-    private validateOptions;
-}
-export type { GenerateOptions, RandomResult, RNGFormat } from './types';