@private.me/xbind 1.2.0

package/dist-standalone/_deps/ux-helpers/cjs/progress.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Progress Reporter
+ *
+ * Provides consistent progress reporting for long-running operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressReporter = void 0;
+exports.createStagedProgress = createStagedProgress;
+/**
+ * Progress reporter for long-running operations.
+ *
+ * Wraps a progress callback with convenient methods for reporting status updates.
+ *
+ * @example
+ * ```typescript
+ * async function processLargeFile(
+ *   data: Uint8Array,
+ *   onProgress?: ProgressCallback
+ * ): Promise<void> {
+ *   const progress = new ProgressReporter(onProgress);
+ *
+ *   progress.start('Initializing...');
+ *   // ... initialization work
+ *
+ *   progress.update('Processing...', 50);
+ *   // ... processing work
+ *
+ *   progress.complete();
+ * }
+ * ```
+ */
+class ProgressReporter {
+    callback;
+    lastPercent = 0;
+    /**
+     * Create a new progress reporter.
+     *
+     * @param callback Optional callback to invoke on progress updates
+     */
+    constructor(callback) {
+        this.callback = callback;
+    }
+    /**
+     * Report progress with status and optional percentage.
+     *
+     * @param status Human-readable status message
+     * @param percent Progress percentage (0-100), optional
+     */
+    report(status, percent) {
+        // Clamp percent to valid range if provided
+        const normalizedPercent = percent !== undefined ? Math.max(0, Math.min(100, percent)) : undefined;
+        // Update last known percent
+        if (normalizedPercent !== undefined) {
+            this.lastPercent = normalizedPercent;
+        }
+        // Call callback if provided
+        if (this.callback) {
+            this.callback(status, normalizedPercent);
+        }
+    }
+    /**
+     * Report the start of an operation (0% progress).
+     *
+     * @param status Status message
+     */
+    start(status) {
+        this.report(status, 0);
+    }
+    /**
+     * Update progress with status and percentage.
+     *
+     * @param status Status message
+     * @param percent Progress percentage (0-100)
+     */
+    update(status, percent) {
+        this.report(status, percent);
+    }
+    /**
+     * Report completion (100% progress).
+     */
+    complete() {
+        this.report('Complete', 100);
+    }
+    /**
+     * Get the last reported percentage.
+     *
+     * @returns Last reported percentage (0-100)
+     */
+    getLastPercent() {
+        return this.lastPercent;
+    }
+}
+exports.ProgressReporter = ProgressReporter;
+/**
+ * Create a progress reporter that tracks multiple stages.
+ *
+ * Divides the 0-100% range into equal segments for each stage.
+ *
+ * @param stages Array of stage names
+ * @param callback Progress callback
+ * @returns Object with methods for advancing through stages
+ *
+ * @example
+ * ```typescript
+ * const progress = createStagedProgress(
+ *   ['Initializing', 'Processing', 'Finalizing'],
+ *   (status, percent) => console.log(`${status}: ${percent}%`)
+ * );
+ *
+ * progress.start(); // "Initializing: 0%"
+ * progress.nextStage(); // "Processing: 33%"
+ * progress.nextStage(); // "Finalizing: 67%"
+ * progress.complete(); // "Complete: 100%"
+ * ```
+ */
+function createStagedProgress(stages, callback) {
+    const reporter = new ProgressReporter(callback);
+    let currentStageIndex = 0;
+    const percentPerStage = stages.length > 0 ? 100 / stages.length : 100;
+    return {
+        start: () => {
+            currentStageIndex = 0;
+            reporter.start(stages[0] ?? 'Starting...');
+        },
+        nextStage: () => {
+            currentStageIndex = Math.min(currentStageIndex + 1, stages.length - 1);
+            const percent = Math.round(currentStageIndex * percentPerStage);
+            reporter.update(stages[currentStageIndex] ?? 'Processing...', percent);
+        },
+        complete: () => {
+            currentStageIndex = stages.length;
+            reporter.complete();
+        },
+        getCurrentStage: () => {
+            return stages[currentStageIndex] ?? '';
+        },
+        getProgress: () => {
+            return Math.round(currentStageIndex * percentPerStage);
+        },
+    };
+}
+//# sourceMappingURL=progress.js.map

package/dist-standalone/_deps/ux-helpers/cjs/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/progress.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAwHH,oDAwCC;AA5JD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,gBAAgB;IACV,QAAQ,CAA+B;IAChD,WAAW,GAAW,CAAC,CAAC;IAEhC;;;;OAIG;IACH,YAAY,QAA2B;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAc,EAAE,OAAgB;QACrC,2CAA2C;QAC3C,MAAM,iBAAiB,GACrB,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE1E,4BAA4B;QAC5B,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,GAAG,iBAAiB,CAAC;QACvC,CAAC;QAED,4BAA4B;QAC5B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAc;QAClB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAc,EAAE,OAAe;QACpC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AArED,4CAqEC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,oBAAoB,CAClC,MAAyB,EACzB,QAA2B;IAQ3B,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAE1B,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAEtE,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,iBAAiB,GAAG,CAAC,CAAC;YACtB,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC;QAC7C,CAAC;QAED,SAAS,EAAE,GAAG,EAAE;YACd,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,eAAe,CAAC,CAAC;YAChE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,eAAe,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC;QAED,QAAQ,EAAE,GAAG,EAAE;YACb,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;YAClC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACtB,CAAC;QAED,eAAe,EAAE,GAAG,EAAE;YACpB,OAAO,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QACzC,CAAC;QAED,WAAW,EAAE,GAAG,EAAE;YAChB,OAAO,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,eAAe,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist-standalone/_deps/ux-helpers/cjs/search.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Search Helper
+ *
+ * Provides consistent search behavior across all PRIVATE.ME packages.
+ */
+import type { SearchOptions } from './types.js';
+/**
+ * Search a collection of items.
+ *
+ * Performs case-insensitive substring matching across specified fields.
+ *
+ * @param items Collection to search
+ * @param options Search options (query, fields, fuzzy, limit)
+ * @returns Filtered items matching the search query
+ *
+ * @example
+ * ```typescript
+ * const items = [
+ *   { name: 'Alice', email: 'alice@example.com' },
+ *   { name: 'Bob', email: 'bob@example.com' },
+ *   { name: 'Charlie', email: 'charlie@example.com' },
+ * ];
+ *
+ * const results = search(items, {
+ *   query: 'alice',
+ *   fields: ['name', 'email'],
+ * });
+ * // results = [{ name: 'Alice', email: 'alice@example.com' }]
+ * ```
+ */
+export declare function search<T>(items: readonly T[], options: SearchOptions): readonly T[];
+//# sourceMappingURL=search.d.ts.map

package/dist-standalone/_deps/ux-helpers/cjs/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,aAAa,GACrB,SAAS,CAAC,EAAE,CA4Bd"}

package/dist-standalone/_deps/ux-helpers/cjs/search.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * Search Helper
+ *
+ * Provides consistent search behavior across all PRIVATE.ME packages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.search = search;
+/**
+ * Search a collection of items.
+ *
+ * Performs case-insensitive substring matching across specified fields.
+ *
+ * @param items Collection to search
+ * @param options Search options (query, fields, fuzzy, limit)
+ * @returns Filtered items matching the search query
+ *
+ * @example
+ * ```typescript
+ * const items = [
+ *   { name: 'Alice', email: 'alice@example.com' },
+ *   { name: 'Bob', email: 'bob@example.com' },
+ *   { name: 'Charlie', email: 'charlie@example.com' },
+ * ];
+ *
+ * const results = search(items, {
+ *   query: 'alice',
+ *   fields: ['name', 'email'],
+ * });
+ * // results = [{ name: 'Alice', email: 'alice@example.com' }]
+ * ```
+ */
+function search(items, options) {
+    const { query, fields, fuzzy = true, limit } = options;
+    // Empty query returns all items
+    if (!query.trim()) {
+        return limit !== undefined ? items.slice(0, limit) : items;
+    }
+    // Normalize query for comparison
+    const normalizedQuery = fuzzy ? query.toLowerCase() : query;
+    // Filter items that match the query
+    const results = items.filter((item) => {
+        // If fields are specified, search only those fields
+        if (fields && fields.length > 0) {
+            return fields.some((field) => {
+                const value = getNestedValue(item, field);
+                if (value === null || value === undefined)
+                    return false;
+                return matchesQuery(String(value), normalizedQuery, fuzzy);
+            });
+        }
+        // Otherwise, search all string fields
+        return searchAllFields(item, normalizedQuery, fuzzy);
+    });
+    // Apply limit if specified
+    return limit !== undefined ? results.slice(0, limit) : results;
+}
+/**
+ * Get nested property value using dot notation.
+ *
+ * @param obj Object to query
+ * @param path Dot-separated path (e.g., 'user.profile.name')
+ * @returns Value at the path, or null if not found
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return null;
+        if (typeof current !== 'object')
+            return null;
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Check if a value matches the query.
+ *
+ * @param value Value to check
+ * @param query Query string (already normalized)
+ * @param fuzzy Whether to use fuzzy (case-insensitive) matching
+ * @returns True if value matches query
+ */
+function matchesQuery(value, query, fuzzy) {
+    if (fuzzy) {
+        return value.toLowerCase().includes(query);
+    }
+    return value.includes(query);
+}
+/**
+ * Search all string fields in an object recursively.
+ *
+ * @param obj Object to search
+ * @param query Normalized query string
+ * @param fuzzy Whether to use fuzzy matching
+ * @returns True if any field matches the query
+ */
+function searchAllFields(obj, query, fuzzy) {
+    if (obj === null || obj === undefined)
+        return false;
+    // Check primitive types
+    if (typeof obj === 'string') {
+        return matchesQuery(obj, query, fuzzy);
+    }
+    if (typeof obj === 'number' || typeof obj === 'boolean') {
+        return matchesQuery(String(obj), query, fuzzy);
+    }
+    // Recurse into arrays
+    if (Array.isArray(obj)) {
+        return obj.some((item) => searchAllFields(item, query, fuzzy));
+    }
+    // Recurse into objects
+    if (typeof obj === 'object') {
+        return Object.values(obj).some((value) => searchAllFields(value, query, fuzzy));
+    }
+    return false;
+}
+//# sourceMappingURL=search.js.map

package/dist-standalone/_deps/ux-helpers/cjs/search.js.map

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

package/dist-standalone/_deps/ux-helpers/cjs/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * UX Helpers - Type Definitions
+ *
+ * Shared types for UX utilities across all PRIVATE.ME packages.
+ */
+/**
+ * Options for paginating a collection.
+ */
+export interface PaginationOptions {
+    /** Page number (1-based). Defaults to 1. */
+    readonly page?: number;
+    /** Items per page. Defaults to 50, max 100. */
+    readonly limit?: number;
+}
+/**
+ * Paginated result with metadata.
+ */
+export interface PaginatedResult<T> {
+    /** Items for the current page. */
+    readonly data: readonly T[];
+    /** Pagination metadata. */
+    readonly pagination: {
+        readonly page: number;
+        readonly limit: number;
+        readonly total: number;
+        readonly totalPages: number;
+        readonly hasNext: boolean;
+        readonly hasPrev: boolean;
+    };
+}
+/**
+ * Options for searching a collection.
+ */
+export interface SearchOptions {
+    /** Search query string. */
+    readonly query: string;
+    /** Fields to search in. If not specified, searches all string fields. */
+    readonly fields?: readonly string[];
+    /** Enable fuzzy matching (case-insensitive substring). Defaults to true. */
+    readonly fuzzy?: boolean;
+    /** Maximum number of results to return. Defaults to unlimited. */
+    readonly limit?: number;
+}
+/**
+ * Callback for progress updates.
+ *
+ * @param status Human-readable status message
+ * @param percent Progress percentage (0-100), optional
+ */
+export type ProgressCallback = (status: string, percent?: number) => void;
+/**
+ * Detailed error information for ACI-level operations.
+ */
+export interface ACIErrorDetail {
+    /** Machine-readable error code (e.g., 'INVALID_DID'). */
+    readonly code: string;
+    /** Human-readable error message. */
+    readonly message: string;
+    /** Optional hint for resolving the error. */
+    readonly hint?: string;
+    /** Actionable step to resolve the error (imperative verb form). */
+    readonly suggested_action?: string;
+    /** Field name that caused the error, if applicable. */
+    readonly field?: string;
+    /** Documentation URL for more information. */
+    readonly docs?: string;
+    /** Error severity level. */
+    readonly severity?: 'info' | 'warning' | 'error' | 'critical';
+}
+/**
+ * Multiple format representations for structured data.
+ *
+ * Used for operations that return rich information (not primitives like IDs or hashes).
+ * Each format is optimized for a different use case:
+ * - multiline: Human display (terminal, UI)
+ * - singleline: Logs (one line per event)
+ * - json: APIs (machine-readable)
+ * - markdown: Documentation (rendered output)
+ */
+export interface FormattedOutput {
+    /** Multi-line format for human display. */
+    readonly multiline: string;
+    /** Single-line format for logs. */
+    readonly singleline: string;
+    /** JSON string for APIs. */
+    readonly json: string;
+    /** Markdown format for documentation. */
+    readonly markdown: string;
+}
+/**
+ * Error with multiple format representations.
+ *
+ * Extends ACIErrorDetail with structured formats for different use cases.
+ */
+export interface FormattedError extends ACIErrorDetail {
+    /** Multiple format representations. */
+    readonly formats: FormattedOutput;
+}
+/**
+ * Options for creating a detailed error.
+ */
+export interface ACIErrorOptions {
+    readonly hint?: string;
+    readonly suggested_action?: string;
+    readonly field?: string;
+    readonly docs?: string;
+    readonly severity?: 'info' | 'warning' | 'error' | 'critical';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist-standalone/_deps/ux-helpers/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH;AAID;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAID;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;CAC/D;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;CAC/D"}

package/dist-standalone/_deps/ux-helpers/cjs/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * UX Helpers - Type Definitions
+ *
+ * Shared types for UX utilities across all PRIVATE.ME packages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-standalone/_deps/ux-helpers/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist-standalone/_deps/ux-helpers/errors.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Error Formatter
+ *
+ * Provides consistent error formatting across all PRIVATE.ME packages.
+ */
+import type { ACIErrorDetail, ACIErrorOptions } from './types.js';
+/**
+ * Create a detailed ACI error.
+ *
+ * @param code Machine-readable error code (e.g., 'INVALID_DID')
+ * @param message Human-readable error message
+ * @param options Optional error details (hint, field, docs)
+ * @returns Detailed error object
+ *
+ * @example
+ * ```typescript
+ * const error = createDetailedError(
+ *   'INVALID_DID',
+ *   'DID format is invalid',
+ *   {
+ *     hint: 'DIDs must start with "did:" followed by method (e.g., did:key:z6Mk...)',
+ *     field: 'recipientDID',
+ *     docs: 'https://private.me/docs/did-format'
+ *   }
+ * );
+ * ```
+ */
+export declare function createDetailedError(code: string, message: string, options?: ACIErrorOptions): ACIErrorDetail;
+/**
+ * Format an error for display to the user.
+ *
+ * Creates a human-friendly error message with hints and documentation links.
+ *
+ * @param error Detailed error object
+ * @returns Formatted error string
+ *
+ * @deprecated Use formatErrorStructured() for new code. This function remains for backward compatibility.
+ *
+ * @example
+ * ```typescript
+ * const error = createDetailedError('INVALID_DID', 'DID format is invalid', {
+ *   hint: 'DIDs must start with "did:"',
+ *   docs: 'https://private.me/docs/did-format'
+ * });
+ *
+ * const formatted = formatErrorForUser(error);
+ * // "DID format is invalid
+ * //  Hint: DIDs must start with "did:"
+ * //  Docs: https://private.me/docs/did-format"
+ * ```
+ */
+export declare function formatErrorForUser(error: ACIErrorDetail): string;
+/**
+ * Format an error for logging (includes error code).
+ *
+ * @param error Detailed error object
+ * @returns Formatted log string
+ */
+export declare function formatErrorForLog(error: ACIErrorDetail): string;
+/**
+ * Check if an error is an ACIErrorDetail.
+ *
+ * @param error Unknown error object
+ * @returns True if error is an ACIErrorDetail
+ */
+export declare function isACIError(error: unknown): error is ACIErrorDetail;
+/**
+ * Convert any error to an ACIErrorDetail.
+ *
+ * @param error Error object (Error, ACIErrorDetail, or unknown)
+ * @returns ACIErrorDetail
+ */
+export declare function toACIError(error: unknown): ACIErrorDetail;
+/**
+ * Format an error with multiple structured representations.
+ *
+ * Returns an object with the original error details plus formatted versions
+ * optimized for different use cases (display, logging, APIs, docs).
+ *
+ * @param error Detailed error object
+ * @returns Error with formats
+ *
+ * @example
+ * ```typescript
+ * const error = createDetailedError('INVALID_DID', 'DID format is invalid', {
+ *   hint: 'DIDs must start with "did:"',
+ *   field: 'recipientDID',
+ *   docs: 'https://private.me/docs/did-format'
+ * });
+ *
+ * const formatted = formatErrorStructured(error);
+ * console.log(formatted.formats.singleline);
+ * // "error | INVALID_DID | DID format is invalid | field=recipientDID"
+ *
+ * console.log(formatted.formats.multiline);
+ * // "Error: DID format is invalid
+ * //  Code: INVALID_DID
+ * //  Field: recipientDID
+ * //  Hint: DIDs must start with "did:"
+ * //  Docs: https://private.me/docs/did-format"
+ *
+ * console.log(formatted.formats.json);
+ * // '{"code":"INVALID_DID","message":"DID format is invalid",...}'
+ * ```
+ */
+export declare function formatErrorStructured(error: ACIErrorDetail): import('./types.js').FormattedError;
+/**
+ * Detailed error information for debugging and user-facing messages.
+ * Maps error codes to human-readable descriptions and recovery suggestions.
+ */
+export declare const ERROR_DETAILS: Record<string, {
+    description: string;
+    recovery: string;
+}>;
+//# sourceMappingURL=errors.d.ts.map

package/dist-standalone/_deps/ux-helpers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAUhB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAgBhE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAgB/D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAWlE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAqBzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,YAAY,EAAE,cAAc,CA2DhG;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAOnF,CAAC"}