@sparkvault/sdk 1.21.10 → 1.23.1

package/dist/identity/container.d.ts

@@ -34,6 +34,13 @@ export interface Container {
      * Update backdrop blur setting (may be no-op for inline container).
      */
     updateBackdropBlur(enabled: boolean): void;
+    /**
+     * Switch to minimal chrome mode for full-bleed views (e.g. terminal error
+     * screens). Hides the header (so customer branding doesn't appear on
+     * SparkVault-owned messaging) and exposes a floating close affordance.
+     * No-op for containers that don't have chrome to hide.
+     */
+    setMinimalChrome(enabled: boolean): void;
     /**
      * Get the body element where views are rendered.
      */

package/dist/identity/index.d.ts

@@ -72,11 +72,13 @@ export declare class IdentityModule {
      */
     private createInlineContainer;
     /**
-     * @deprecated Use `verify()` instead. Will be removed in v2.0.
+     * Open the identity verification modal as a popup. Equivalent to
+     * `verify(options)`.
      */
     pop(options?: VerifyOptions): Promise<VerifyResult>;
     /**
-     * @deprecated Use `verify({ target })` instead. Will be removed in v2.0.
+     * Render the identity verification UI inline into a target element.
+     * Equivalent to `verify({ ...options, target })`.
      */
     render(options: VerifyOptions & {
         target: HTMLElement;

package/dist/identity/inline-container.d.ts

@@ -43,6 +43,11 @@ export declare class InlineContainer implements Container {
      * Update backdrop blur setting (no-op for inline container).
      */
     updateBackdropBlur(_enabled: boolean): void;
+    /**
+     * Minimal-chrome toggle (no-op for inline container).
+     * Inline containers don't own page-level chrome to hide.
+     */
+    setMinimalChrome(_enabled: boolean): void;
     /**
      * Get the body element for content rendering.
      */

package/dist/identity/modal.d.ts

@@ -29,6 +29,8 @@ export declare class ModalContainer implements Container {
     private backdropBlur;
     private effectiveTheme;
     private headerElement;
+    private floatingCloseBtn;
+    private floatingCloseHandler;
     /**
      * Create and show the modal immediately with loading state.
      * Uses default branding until real config is loaded.
@@ -42,6 +44,12 @@ export declare class ModalContainer implements Container {
      * Called after SDK config loads.
      */
     updateBranding(branding: SdkConfigBranding): void;
+    /**
+     * Toggle minimal-chrome mode. In minimal mode the header (logo + close)
+     * is hidden and a floating close button is positioned over the modal so
+     * the body view can render edge-to-edge as its own full-dialog design.
+     */
+    setMinimalChrome(enabled: boolean): void;
     /**
      * Update the backdrop blur setting.
      * Called after SDK config loads with resolved value (client override > server config > default).

package/dist/identity/renderer.d.ts

@@ -34,12 +34,24 @@ export declare class IdentityRenderer {
      * Otherwise shows loading state while fetching config.
      */
     start(): Promise<void>;
+    /**
+     * Map a config-fetch error to the appropriate terminal view.
+     * `app_not_installed` is a misconfiguration (account hasn't installed the
+     * Identity app) — show a developer-targeted "Not Activated" screen with a
+     * link to SparkVault.com instead of the generic service-unavailable view.
+     */
+    private viewStateForConfigError;
     /**
      * Fetch config with a single retry on network errors.
      * Handles transient failures common during subdomain switches
      * (DNS resolution, connection setup, Safari ITP).
      */
     private fetchConfigWithRetry;
+    /**
+     * Retry loading config after a service-unavailable error.
+     * Shows loading state, re-fetches config, then proceeds normally.
+     */
+    private retryConfigLoad;
     /**
      * Close the modal and clean up.
      * Cancels all pending API requests to prevent orphaned operations.

package/dist/identity/types.d.ts

@@ -212,4 +212,8 @@ export type IdentityViewState = {
     view: 'error';
     message: string;
     code: string;
+} | {
+    view: 'service-unavailable';
+} | {
+    view: 'app-not-activated';
 };

package/dist/identity/views/app-not-activated.d.ts

@@ -0,0 +1,21 @@
+/**
+ * App Not Activated View
+ *
+ * Full-dialog terminal screen shown when the SparkVault Identity app has not
+ * been activated for the account that the JS SDK is configured against. The
+ * audience is the website owner / developer — this is a misconfiguration
+ * surface, not an end-user error — so the dialog drops customer branding and
+ * presents itself as an unmistakable SparkVault notice.
+ */
+import type { View } from './base';
+export interface AppNotActivatedViewProps {
+    onClose: () => void;
+}
+export declare class AppNotActivatedView implements View {
+    private readonly props;
+    private dismissButton;
+    private readonly boundHandleClose;
+    constructor(props: AppNotActivatedViewProps);
+    render(): HTMLElement;
+    destroy(): void;
+}

package/dist/identity/views/index.d.ts

@@ -12,3 +12,5 @@ export * from './passkey';
 export * from './passkey-prompt';
 export * from './sparklink-waiting';
 export * from './error';
+export * from './service-unavailable';
+export * from './app-not-activated';

package/dist/identity/views/service-unavailable.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Service Unavailable View
+ *
+ * Shown when the identity config endpoint is unreachable.
+ * Clean, professional, branded — no error codes or technical jargon.
+ */
+import type { View } from './base';
+export interface ServiceUnavailableViewProps {
+    onRetry: () => void;
+    onClose: () => void;
+}
+export declare class ServiceUnavailableView implements View {
+    private readonly props;
+    private retryButton;
+    private closeButton;
+    private readonly boundHandleRetry;
+    private readonly boundHandleClose;
+    constructor(props: ServiceUnavailableViewProps);
+    render(): HTMLElement;
+    destroy(): void;
+}

package/dist/index.d.ts

@@ -188,11 +188,13 @@ declare class IdentityModule {
      */
     private createInlineContainer;
     /**
-     * @deprecated Use `verify()` instead. Will be removed in v2.0.
+     * Open the identity verification modal as a popup. Equivalent to
+     * `verify(options)`.
      */
     pop(options?: VerifyOptions): Promise<VerifyResult>;
     /**
-     * @deprecated Use `verify({ target })` instead. Will be removed in v2.0.
+     * Render the identity verification UI inline into a target element.
+     * Equivalent to `verify({ ...options, target })`.
      */
     render(options: VerifyOptions & {
         target: HTMLElement;
@@ -422,10 +424,6 @@ interface UploadAttachOptions {
     /** Callback for upload progress */
     onProgress?: (progress: UploadProgress) => void;
 }
-/** @deprecated Use UploadOptions instead */
-type UploadPopOptions = UploadOptions;
-/** @deprecated Use UploadOptions instead */
-type UploadRenderOptions = UploadOptions;
 /**
  * Upload progress information.
  */
@@ -692,4 +690,4 @@ declare global {
 }
 
 export { AuthenticationError, AuthorizationError, NetworkError, PopupBlockedError, SparkVault, SparkVaultError, TimeoutError, UserCancelledError, ValidationError, SparkVault as default, logger, setDebugMode };
-export type { AuthMethod, CreateVaultOptions, AttachOptions as IdentityAttachOptions, Ingot, SparkVaultConfig, Theme, TokenClaims, UnsealedVault, UploadAttachOptions, UploadBranding, UploadIngotOptions, UploadOptions, UploadPopOptions, UploadProgress, UploadRenderOptions, UploadResult, Vault, VaultSummary, VaultUploadConfig, VerifyOptions, VerifyResult };
+export type { AuthMethod, CreateVaultOptions, AttachOptions as IdentityAttachOptions, Ingot, SparkVaultConfig, Theme, TokenClaims, UnsealedVault, UploadAttachOptions, UploadBranding, UploadIngotOptions, UploadOptions, UploadProgress, UploadResult, Vault, VaultSummary, VaultUploadConfig, VerifyOptions, VerifyResult };