@private.me/xbind 1.3.0 → 2.3.4

package/dist-standalone/cjs/connect.js

@@ -1,312 +1 @@
-"use strict";
-/**
- * @module connect
- * High-level connect() API for zero-config XBind connections.
- *
- * Enables: `const service = await connect('payments-service')`
- *
- * Combines:
- * - Service discovery
- * - Trust verification
- * - Agent creation
- * - Connection establishment
- *
- * @example
- * ```ts
- * import { connect } from '@private.me/xbind';
- *
- * // Connect by name (uses registry):
- * const payments = await connect('payments-service');
- *
- * // Connect by domain (uses .well-known):
- * const payments = await connect('payments.example.com');
- *
- * // Connect by URL (direct):
- * const payments = await connect('https://api.payments.com/xbind');
- *
- * // Use the connection:
- * await payments.send({
- *   to: payments.did,
- *   payload: { action: 'createCharge', amount: 100 },
- *   scope: 'payments',
- * });
- * ```
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConnectErrorCode = void 0;
-exports.connect = connect;
-exports.acceptInvite = acceptInvite;
-const shared_1 = require("../_deps/shared/index.js");
-const crypto_1 = require("../_deps/crypto/index.js");
-const agent_js_1 = require("./agent.js");
-const discovery_js_1 = require("./discovery.js");
-const transport_js_1 = require("./transport.js");
-const trust_registry_js_1 = require("./trust-registry.js");
-const identity_js_1 = require("./identity.js");
-/**
- * Connect error codes.
- */
-var ConnectErrorCode;
-(function (ConnectErrorCode) {
-    ConnectErrorCode["DISCOVERY_FAILED"] = "CONNECT_DISCOVERY_FAILED";
-    ConnectErrorCode["AGENT_CREATION_FAILED"] = "CONNECT_AGENT_CREATION_FAILED";
-    ConnectErrorCode["TRUST_VERIFICATION_FAILED"] = "CONNECT_TRUST_VERIFICATION_FAILED";
-    ConnectErrorCode["INVALID_SERVICE_INFO"] = "CONNECT_INVALID_SERVICE_INFO";
-})(ConnectErrorCode || (exports.ConnectErrorCode = ConnectErrorCode = {}));
-/**
- * Connect to a service with zero configuration.
- *
- * @param nameOrUrl - Service name, domain, or URL
- * @param options - Connection options
- * @returns Connection or error
- *
- * @example
- * ```ts
- * // Minimal:
- * const connection = await connect('payments-service');
- * if (connection.ok) {
- *   await connection.value.agent.send({
- *     to: connection.value.did,
- *     payload: { action: 'test' },
- *     scope: 'test',
- *   });
- * }
- *
- * // With options:
- * const connection = await connect('payments-service', {
- *   name: 'billing-service',
- *   xchange: true, // Use faster Xchange mode
- *   splitChannel: true, // Use split-channel by default
- * });
- * ```
- */
-async function connect(nameOrUrl, options = {}) {
-    // Step 1: Discover service
-    const discovery = options.discovery || new discovery_js_1.ServiceDiscovery();
-    const serviceResult = await discovery.discover(nameOrUrl);
-    if (!serviceResult.ok) {
-        return (0, shared_1.err)({
-            code: ConnectErrorCode.DISCOVERY_FAILED,
-            message: `Failed to discover service: ${serviceResult.error.message}`,
-            hint: serviceResult.error.hint,
-            cause: serviceResult.error,
-        });
-    }
-    const service = serviceResult.value;
-    // Step 2: Validate service info
-    if (!service.did || !service.endpoint || !service.publicKey) {
-        return (0, shared_1.err)({
-            code: ConnectErrorCode.INVALID_SERVICE_INFO,
-            message: 'Service info missing required fields (did, endpoint, publicKey)',
-            hint: 'Service must provide complete metadata',
-        });
-    }
-    // Step 3: Create trust registry and add service
-    const registry = options.registry || new trust_registry_js_1.MemoryTrustRegistry();
-    try {
-        // Import public key (convert from base64 string)
-        const publicKeyBytes = (0, crypto_1.fromBase64)(service.publicKey);
-        const publicKeyResult = await (0, identity_js_1.importPublicKey)(publicKeyBytes);
-        if (!publicKeyResult.ok) {
-            return (0, shared_1.err)({
-                code: ConnectErrorCode.TRUST_VERIFICATION_FAILED,
-                message: 'Invalid service public key',
-                cause: publicKeyResult.error,
-            });
-        }
-        // Add to trust registry
-        await registry.add({
-            did: service.did,
-            publicKey: publicKeyResult.value,
-            x25519PublicKey: service.x25519PublicKey
-                ? await (0, identity_js_1.importPublicKey)((0, crypto_1.fromBase64)(service.x25519PublicKey)).then(r => r.ok ? r.value : undefined)
-                : undefined,
-            mlKemPublicKey: service.mlKemPublicKey
-                ? (0, crypto_1.fromBase64)(service.mlKemPublicKey)
-                : undefined,
-        });
-    }
-    catch (error) {
-        return (0, shared_1.err)({
-            code: ConnectErrorCode.TRUST_VERIFICATION_FAILED,
-            message: 'Failed to verify service public key',
-            cause: error,
-        });
-    }
-    // Step 4: Create transport
-    const transport = options.transport || new transport_js_1.HttpsTransportAdapter({
-        baseUrl: service.endpoint,
-    });
-    // Step 5: Create agent
-    const agentName = options.name || `client-${Date.now()}`;
-    const agentOptions = {
-        name: agentName,
-        registry,
-        transport,
-        xchange: options.xchange,
-        postQuantumSig: options.postQuantumSig,
-    };
-    const agentResult = await agent_js_1.Agent.create(agentOptions);
-    if (!agentResult.ok) {
-        return (0, shared_1.err)({
-            code: ConnectErrorCode.AGENT_CREATION_FAILED,
-            message: 'Failed to create agent',
-            cause: agentResult.error,
-        });
-    }
-    // Step 6: Return connection
-    return (0, shared_1.ok)({
-        agent: agentResult.value,
-        service,
-        did: service.did,
-        endpoint: service.endpoint,
-    });
-}
-/**
- * Accept an invite and establish connection.
- *
- * @param inviteUrl - Invite URL
- * @param options - Connection options
- * @returns Connection or error
- *
- * @example
- * ```ts
- * const connection = await acceptInvite('https://xbind.to/invite/abc123', {
- *   name: 'my-service',
- * });
- *
- * if (connection.ok) {
- *   console.log('Connected to:', connection.value.service.name);
- * }
- * ```
- */
-async function acceptInvite(inviteUrl, options = {}) {
-    const { InviteService } = await Promise.resolve().then(() => __importStar(require('./invite.js')));
-    const inviteService = new InviteService();
-    // Get invite details
-    const inviteResult = await inviteService.get(inviteUrl);
-    if (!inviteResult.ok) {
-        return (0, shared_1.err)({
-            code: ConnectErrorCode.DISCOVERY_FAILED,
-            message: `Failed to get invite: ${inviteResult.error.message}`,
-            cause: inviteResult.error,
-        });
-    }
-    const invite = inviteResult.value;
-    // Convert invite.from to ServiceInfo
-    const service = {
-        name: invite.from.name,
-        did: invite.from.did,
-        endpoint: invite.from.endpoint,
-        publicKey: invite.from.publicKey,
-        x25519PublicKey: invite.from.x25519PublicKey,
-        mlKemPublicKey: invite.from.mlKemPublicKey,
-    };
-    // Connect to service (same as connect())
-    // Create trust registry and add service
-    const registry = options.registry || new trust_registry_js_1.MemoryTrustRegistry();
-    try {
-        // Import public key (convert from base64 string)
-        const publicKeyBytes = (0, crypto_1.fromBase64)(service.publicKey);
-        const publicKeyResult = await (0, identity_js_1.importPublicKey)(publicKeyBytes);
-        if (!publicKeyResult.ok) {
-            return (0, shared_1.err)({
-                code: ConnectErrorCode.TRUST_VERIFICATION_FAILED,
-                message: 'Invalid service public key',
-                cause: publicKeyResult.error,
-            });
-        }
-        await registry.add({
-            did: service.did,
-            publicKey: publicKeyResult.value,
-            x25519PublicKey: service.x25519PublicKey
-                ? await (0, identity_js_1.importPublicKey)((0, crypto_1.fromBase64)(service.x25519PublicKey)).then(r => r.ok ? r.value : undefined)
-                : undefined,
-            mlKemPublicKey: service.mlKemPublicKey
-                ? (0, crypto_1.fromBase64)(service.mlKemPublicKey)
-                : undefined,
-        });
-    }
-    catch (error) {
-        return (0, shared_1.err)({
-            code: ConnectErrorCode.TRUST_VERIFICATION_FAILED,
-            message: 'Failed to verify service public key',
-            cause: error,
-        });
-    }
-    const transport = options.transport || new transport_js_1.HttpsTransportAdapter({
-        baseUrl: service.endpoint,
-    });
-    const agentName = options.name || `client-${Date.now()}`;
-    const agentOptions = {
-        name: agentName,
-        registry,
-        transport,
-        xchange: options.xchange,
-        postQuantumSig: options.postQuantumSig,
-    };
-    const agentResult = await agent_js_1.Agent.create(agentOptions);
-    if (!agentResult.ok) {
-        return (0, shared_1.err)({
-            code: ConnectErrorCode.AGENT_CREATION_FAILED,
-            message: 'Failed to create agent',
-            cause: agentResult.error,
-        });
-    }
-    // Accept the invite
-    const acceptResult = await inviteService.accept({
-        inviteUrl,
-        acceptor: {
-            name: agentOptions.name,
-            did: agentResult.value.did,
-            endpoint: options.endpoint || '', // Agent's endpoint (where it can be reached), empty for client-only agents
-            publicKey: (0, crypto_1.toBase64)(agentResult.value.identity.rawPublicKey),
-            x25519PublicKey: agentResult.value.identity.rawX25519PublicKey
-                ? (0, crypto_1.toBase64)(agentResult.value.identity.rawX25519PublicKey)
-                : undefined,
-        },
-    });
-    if (!acceptResult.ok) {
-        // Connection created but invite acceptance failed - still return connection
-        // (invite acceptance is for tracking/notification, not required for connectivity)
-    }
-    return (0, shared_1.ok)({
-        agent: agentResult.value,
-        service,
-        did: service.did,
-        endpoint: service.endpoint,
-    });
-}
+"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,i){void 0===i&&(i=t);var o=Object.getOwnPropertyDescriptor(r,t);o&&!("get"in o?!r.__esModule:o.writable||o.configurable)||(o={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,i,o)}:function(e,r,t,i){void 0===i&&(i=t),e[i]=r[t]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(e,r){Object.defineProperty(e,"default",{enumerable:!0,value:r})}:function(e,r){e.default=r}),__importStar=this&&this.__importStar||function(){var e=function(r){return e=Object.getOwnPropertyNames||function(e){var r=[];for(var t in e)Object.prototype.hasOwnProperty.call(e,t)&&(r[r.length]=t);return r},e(r)};return function(r){if(r&&r.__esModule)return r;var t={};if(null!=r)for(var i=e(r),o=0;o<i.length;o++)"default"!==i[o]&&__createBinding(t,r,i[o]);return __setModuleDefault(t,r),t}}();Object.defineProperty(exports,"__esModule",{value:!0}),exports.ConnectErrorCode=void 0,exports.connect=connect,exports.acceptInvite=acceptInvite;const shared_1=require("../_deps/shared/index.js"),crypto_utils_js_1=require("./crypto-utils.js"),agent_js_1=require("./agent.js"),discovery_js_1=require("./discovery.js"),transport_js_1=require("./transport.js"),trust_registry_js_1=require("./trust-registry.js"),identity_js_1=require("./identity.js");var ConnectErrorCode;async function connect(e,r={}){const t=r.discovery||new discovery_js_1.ServiceDiscovery,i=await t.discover(e);if(!i.ok)return(0,shared_1.err)({code:ConnectErrorCode.DISCOVERY_FAILED,message:`Failed to discover service: ${i.error.message}`,hint:i.error.hint,cause:i.error});const o=i.value;if(!o.did||!o.endpoint||!o.publicKey)return(0,shared_1.err)({code:ConnectErrorCode.INVALID_SERVICE_INFO,message:"Service info missing required fields (did, endpoint, publicKey)",hint:"Service must provide complete metadata"});const n=r.registry||new trust_registry_js_1.MemoryTrustRegistry;try{const e=(0,crypto_utils_js_1.fromBase64)(o.publicKey),r=await(0,identity_js_1.importPublicKey)(e);if(!r.ok)return(0,shared_1.err)({code:ConnectErrorCode.TRUST_VERIFICATION_FAILED,message:"Invalid service public key",cause:r.error});await n.add({did:o.did,publicKey:r.value,x25519PublicKey:o.x25519PublicKey?await(0,identity_js_1.importPublicKey)((0,crypto_utils_js_1.fromBase64)(o.x25519PublicKey)).then(e=>e.ok?e.value:void 0):void 0,mlKemPublicKey:o.mlKemPublicKey?(0,crypto_utils_js_1.fromBase64)(o.mlKemPublicKey):void 0})}catch(e){return(0,shared_1.err)({code:ConnectErrorCode.TRUST_VERIFICATION_FAILED,message:"Failed to verify service public key",cause:e})}const s=r.transport||new transport_js_1.HttpsTransportAdapter({baseUrl:o.endpoint}),a={name:r.name||`client-${Date.now()}`,registry:n,transport:s,xchange:r.xchange,postQuantumSig:r.postQuantumSig},c=await agent_js_1.Agent.create(a);return c.ok?(0,shared_1.ok)({agent:c.value,service:o,did:o.did,endpoint:o.endpoint}):(0,shared_1.err)({code:ConnectErrorCode.AGENT_CREATION_FAILED,message:"Failed to create agent",cause:c.error})}async function acceptInvite(e,r={}){const{InviteService:t}=await Promise.resolve().then(()=>__importStar(require("./invite.js"))),i=new t,o=await i.get(e);if(!o.ok)return(0,shared_1.err)({code:ConnectErrorCode.DISCOVERY_FAILED,message:`Failed to get invite: ${o.error.message}`,cause:o.error});const n=o.value,s={name:n.from.name,did:n.from.did,endpoint:n.from.endpoint,publicKey:n.from.publicKey,x25519PublicKey:n.from.x25519PublicKey,mlKemPublicKey:n.from.mlKemPublicKey},a=r.registry||new trust_registry_js_1.MemoryTrustRegistry;try{const e=(0,crypto_utils_js_1.fromBase64)(s.publicKey),r=await(0,identity_js_1.importPublicKey)(e);if(!r.ok)return(0,shared_1.err)({code:ConnectErrorCode.TRUST_VERIFICATION_FAILED,message:"Invalid service public key",cause:r.error});await a.add({did:s.did,publicKey:r.value,x25519PublicKey:s.x25519PublicKey?await(0,identity_js_1.importPublicKey)((0,crypto_utils_js_1.fromBase64)(s.x25519PublicKey)).then(e=>e.ok?e.value:void 0):void 0,mlKemPublicKey:s.mlKemPublicKey?(0,crypto_utils_js_1.fromBase64)(s.mlKemPublicKey):void 0})}catch(e){return(0,shared_1.err)({code:ConnectErrorCode.TRUST_VERIFICATION_FAILED,message:"Failed to verify service public key",cause:e})}const c=r.transport||new transport_js_1.HttpsTransportAdapter({baseUrl:s.endpoint}),u={name:r.name||`client-${Date.now()}`,registry:a,transport:c,xchange:r.xchange,postQuantumSig:r.postQuantumSig},d=await agent_js_1.Agent.create(u);if(!d.ok)return(0,shared_1.err)({code:ConnectErrorCode.AGENT_CREATION_FAILED,message:"Failed to create agent",cause:d.error});return(await i.accept({inviteUrl:e,acceptor:{name:u.name,did:d.value.did,endpoint:r.endpoint||"",publicKey:(0,crypto_utils_js_1.toBase64)(d.value.identity.rawPublicKey),x25519PublicKey:d.value.identity.rawX25519PublicKey?(0,crypto_utils_js_1.toBase64)(d.value.identity.rawX25519PublicKey):void 0}})).ok,(0,shared_1.ok)({agent:d.value,service:s,did:s.did,endpoint:s.endpoint})}!function(e){e.DISCOVERY_FAILED="CONNECT_DISCOVERY_FAILED",e.AGENT_CREATION_FAILED="CONNECT_AGENT_CREATION_FAILED",e.TRUST_VERIFICATION_FAILED="CONNECT_TRUST_VERIFICATION_FAILED",e.INVALID_SERVICE_INFO="CONNECT_INVALID_SERVICE_INFO"}(ConnectErrorCode||(exports.ConnectErrorCode=ConnectErrorCode={}));

package/dist-standalone/cjs/connection-pool.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.ConnectionPool=void 0,exports.getGlobalPool=getGlobalPool,exports.resetGlobalPool=resetGlobalPool;class ConnectionPool{options;connections=new Map;metrics;cleanupInterval=null;constructor(t={}){this.options={maxConnections:t.maxConnections??10,minConnections:t.minConnections??2,keepAliveTimeout:t.keepAliveTimeout??3e4,idleTimeout:t.idleTimeout??6e4,requestTimeout:t.requestTimeout??3e4,enableMetrics:t.enableMetrics??!0,retryOnFailure:t.retryOnFailure??!0,maxRetries:t.maxRetries??3},this.metrics={totalRequests:0,reuseCount:0,failedRequests:0,requestDurations:[],byOrigin:new Map},this.startCleanup()}async fetch(t,e){const s=Date.now(),n=this.getOrigin(t);try{const o=await this.acquireConnection(n);this.options.enableMetrics&&(this.metrics.totalRequests++,o.requestCount>0&&this.metrics.reuseCount++);const i={...e,signal:e?.signal??o.controller.signal,keepalive:!0},r=await fetch(t,i);if(o.requestCount++,o.lastUsedAt=Date.now(),o.state="idle",this.options.enableMetrics){const t=Date.now()-s;this.recordMetrics(n,t)}return r}catch(s){if(this.options.enableMetrics&&this.metrics.failedRequests++,this.options.retryOnFailure&&!0!==e?.signal?.aborted)return this.retryRequest(t,e,1);throw s}}async retryRequest(t,e,s){if(s>this.options.maxRetries)throw new Error(`Request failed after ${this.options.maxRetries} retries: ${t}`);const n=100*Math.pow(2,s-1);await new Promise(t=>setTimeout(t,n));const o=this.getOrigin(t);try{const s=await this.acquireConnection(o),n={...e,signal:e?.signal??s.controller.signal,keepalive:!0},i=await fetch(t,n);return s.requestCount++,s.lastUsedAt=Date.now(),s.state="idle",i}catch(n){if(s>=this.options.maxRetries)throw new Error(`Request failed after ${this.options.maxRetries} retries: ${t}`);return this.retryRequest(t,e,s+1)}}async acquireConnection(t){let e=this.connections.get(t);e||(e=[],this.connections.set(t,e));const s=e.find(t=>"idle"===t.state);if(s)return s.state="active",s;if(e.length<this.options.maxConnections){const s=this.createConnection(t);return e.push(s),s}return this.waitForConnection(t)}async waitForConnection(t){const e=Date.now(),s=this.options.requestTimeout;for(;Date.now()-e<s;){const e=this.connections.get(t);if(!e)throw new Error(`Connection pool for ${t} disappeared`);const s=e.find(t=>"idle"===t.state);if(s)return s.state="active",s;await new Promise(t=>setTimeout(t,10))}throw new Error(`Timeout waiting for connection to ${t} after ${s}ms`)}createConnection(t){const e=new Uint8Array(8);crypto.getRandomValues(e);return{id:`conn_${Array.from(e).map(t=>t.toString(16).padStart(2,"0")).join("")}`,origin:t,createdAt:Date.now(),lastUsedAt:Date.now(),requestCount:0,state:"active",controller:new AbortController}}getOrigin(t){try{const e=new URL(t);return`${e.protocol}//${e.host}`}catch(e){throw new Error(`Invalid URL: ${t}`)}}recordMetrics(t,e){this.metrics.requestDurations.push(e),this.metrics.requestDurations.length>1e3&&this.metrics.requestDurations.shift();let s=this.metrics.byOrigin.get(t);s||(s={requests:0,durations:[]},this.metrics.byOrigin.set(t,s)),s.requests++,s.durations.push(e),s.durations.length>100&&s.durations.shift()}getMetrics(){let t=0,e=0,s=0;const n=new Map;for(const[o,i]of this.connections.entries()){t+=i.length,e+=i.filter(t=>"active"===t.state).length,s+=i.filter(t=>"idle"===t.state).length;const r=this.metrics.byOrigin.get(o);if(r){const t=r.durations.length>0?r.durations.reduce((t,e)=>t+e,0)/r.durations.length:0;n.set(o,{connections:i.length,requests:r.requests,avgDuration:Math.round(t)})}}const o=this.metrics.requestDurations.length>0?Math.round(this.metrics.requestDurations.reduce((t,e)=>t+e,0)/this.metrics.requestDurations.length):0,i=this.metrics.totalRequests>0?this.metrics.reuseCount/this.metrics.totalRequests:0;return{totalConnections:t,activeConnections:e,idleConnections:s,totalRequests:this.metrics.totalRequests,reuseCount:this.metrics.reuseCount,failedRequests:this.metrics.failedRequests,avgRequestDuration:o,hitRate:i,byOrigin:n}}resetMetrics(){this.metrics={totalRequests:0,reuseCount:0,failedRequests:0,requestDurations:[],byOrigin:new Map}}startCleanup(){this.cleanupInterval=setInterval(()=>{this.cleanup()},1e4)}cleanup(){const t=Date.now();for(const[e,s]of this.connections.entries()){const n=s.filter(e=>t-e.lastUsedAt>this.options.idleTimeout&&"idle"===e.state?(e.controller.abort(),e.state="closed",!1):"closed"!==e.state);for(;n.length<this.options.minConnections&&n.length<this.options.maxConnections;){const t=this.createConnection(e);t.state="idle",n.push(t)}n.length>0?this.connections.set(e,n):this.connections.delete(e)}}cleanupNow(){this.cleanup()}async close(){this.cleanupInterval&&(clearInterval(this.cleanupInterval),this.cleanupInterval=null);for(const[t,e]of this.connections.entries())for(const t of e)t.controller.abort(),t.state="closed";this.connections.clear()}getConnectionCount(t){const e=this.connections.get(t);return e?e.length:0}getOrigins(){return Array.from(this.connections.keys())}isHealthy(){const t=this.getMetrics();return!((t.totalRequests>0?t.failedRequests/t.totalRequests:0)>.1)&&!(t.avgRequestDuration>5e3)}}exports.ConnectionPool=ConnectionPool;let globalPool=null;function getGlobalPool(t){return globalPool||(globalPool=new ConnectionPool(t)),globalPool}async function resetGlobalPool(){globalPool&&(await globalPool.close(),globalPool=null)}

package/dist-standalone/cjs/correlation-id.js

@@ -1,339 +1 @@
-"use strict";
-/**
- * @module correlation-id
- * Client-side correlation ID utilities for request tracking
- *
- * Correlation IDs enable distributed tracing across xBind agent operations,
- * making it easier to debug issues, track requests across microservices,
- * and correlate logs between client and server.
- *
- * Format: `req_{timestamp}_{random}`
- * Example: `req_1716234567890_a3f5c9d2`
- *
- * Usage:
- * ```typescript
- * import { generateCorrelationId, attachCorrelationId } from '@private.me/xbind';
- *
- * // Generate a new correlation ID
- * const id = generateCorrelationId();
- *
- * // Attach to request headers
- * const headers = attachCorrelationId(new Headers(), id);
- *
- * // Validate format
- * if (validateCorrelationId(id)) {
- *   console.log('Valid correlation ID');
- * }
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CORRELATION_ID_ALIASES = exports.CORRELATION_ID_HEADER = void 0;
-exports.generateCorrelationId = generateCorrelationId;
-exports.validateCorrelationId = validateCorrelationId;
-exports.parseCorrelationId = parseCorrelationId;
-exports.attachCorrelationId = attachCorrelationId;
-exports.extractCorrelationId = extractCorrelationId;
-exports.getOrCreateCorrelationId = getOrCreateCorrelationId;
-exports.createCorrelationIdFromTimestamp = createCorrelationIdFromTimestamp;
-exports.getCorrelationIdAge = getCorrelationIdAge;
-exports.isCorrelationIdExpired = isCorrelationIdExpired;
-exports.correlationIdMiddleware = correlationIdMiddleware;
-/**
- * Standard header name for correlation ID
- */
-exports.CORRELATION_ID_HEADER = 'X-Correlation-ID';
-/**
- * Alternative header names for compatibility
- */
-exports.CORRELATION_ID_ALIASES = [
-    'X-Request-ID',
-    'X-Trace-ID',
-    'X-Transaction-ID',
-];
-/**
- * Regular expression for validating correlation ID format
- */
-const CORRELATION_ID_PATTERN = /^req_\d{13}_[a-f0-9]{8}$/;
-/**
- * Generate a new correlation ID
- *
- * Format: `req_{timestamp}_{random}`
- * - `req`: Static prefix for identification
- * - `timestamp`: Unix timestamp in milliseconds (13 digits)
- * - `random`: 8-character hex string for uniqueness
- *
- * @returns New correlation ID string
- *
- * @example
- * ```typescript
- * const id = generateCorrelationId();
- * // => "req_1716234567890_a3f5c9d2"
- * ```
- */
-function generateCorrelationId() {
-    const timestamp = Date.now();
-    const random = generateRandomHex(8);
-    return `req_${timestamp}_${random}`;
-}
-/**
- * Validate correlation ID format
- *
- * Checks if the provided string matches the expected correlation ID format.
- *
- * @param id - String to validate
- * @returns True if valid, false otherwise
- *
- * @example
- * ```typescript
- * validateCorrelationId('req_1716234567890_a3f5c9d2'); // => true
- * validateCorrelationId('invalid'); // => false
- * validateCorrelationId('req_123_abc'); // => false (wrong lengths)
- * ```
- */
-function validateCorrelationId(id) {
-    if (typeof id !== 'string')
-        return false;
-    return CORRELATION_ID_PATTERN.test(id);
-}
-/**
- * Parse correlation ID into components
- *
- * Extracts the timestamp and random components from a correlation ID.
- *
- * @param id - Correlation ID to parse
- * @returns Parsed components or null if invalid
- *
- * @example
- * ```typescript
- * const spec = parseCorrelationId('req_1716234567890_a3f5c9d2');
- * // => { prefix: 'req', timestamp: 1716234567890, random: 'a3f5c9d2' }
- * ```
- */
-function parseCorrelationId(id) {
-    if (!validateCorrelationId(id))
-        return null;
-    const parts = id.split('_');
-    return {
-        prefix: parts[0] ?? 'req',
-        timestamp: parseInt(parts[1] ?? '0', 10),
-        random: parts[2] ?? '',
-    };
-}
-/**
- * Attach correlation ID to request headers
- *
- * Adds the correlation ID to the X-Correlation-ID header.
- * If no ID is provided, generates a new one.
- * Compatible with both Headers API and plain objects.
- *
- * @param headers - Headers object or plain object
- * @param id - Correlation ID (generates new if not provided)
- * @returns Updated headers object
- *
- * @example
- * ```typescript
- * // With Headers API
- * const headers = new Headers();
- * attachCorrelationId(headers);
- *
- * // With plain object
- * const headers = { 'Content-Type': 'application/json' };
- * attachCorrelationId(headers, 'req_1716234567890_a3f5c9d2');
- *
- * // With existing correlation ID
- * const id = generateCorrelationId();
- * attachCorrelationId(headers, id);
- * ```
- */
-function attachCorrelationId(headers, id) {
-    const correlationId = id ?? generateCorrelationId();
-    if (!validateCorrelationId(correlationId)) {
-        throw new Error(`Invalid correlation ID format: ${correlationId}. Expected format: req_{timestamp}_{random}`);
-    }
-    if (headers instanceof Headers) {
-        headers.set(exports.CORRELATION_ID_HEADER, correlationId);
-    }
-    else {
-        headers[exports.CORRELATION_ID_HEADER] = correlationId;
-    }
-    return headers;
-}
-/**
- * Extract correlation ID from request headers
- *
- * Checks the standard header and common aliases.
- *
- * @param headers - Headers object or plain object
- * @returns Correlation ID if found, undefined otherwise
- *
- * @example
- * ```typescript
- * const headers = new Headers({
- *   'X-Correlation-ID': 'req_1716234567890_a3f5c9d2'
- * });
- * const id = extractCorrelationId(headers);
- * // => 'req_1716234567890_a3f5c9d2'
- * ```
- */
-function extractCorrelationId(headers) {
-    // Check primary header
-    const primary = headers instanceof Headers
-        ? headers.get(exports.CORRELATION_ID_HEADER)
-        : headers[exports.CORRELATION_ID_HEADER];
-    if (primary && validateCorrelationId(primary)) {
-        return primary;
-    }
-    // Check aliases
-    for (const alias of exports.CORRELATION_ID_ALIASES) {
-        const value = headers instanceof Headers ? headers.get(alias) : headers[alias];
-        if (value && validateCorrelationId(value)) {
-            return value;
-        }
-    }
-    return undefined;
-}
-/**
- * Get or create correlation ID from headers
- *
- * Returns existing correlation ID from headers, or generates a new one if not found.
- * Does NOT modify the input headers.
- *
- * @param headers - Headers to check
- * @returns Existing or new correlation ID
- *
- * @example
- * ```typescript
- * const headers = new Headers();
- * const id = getOrCreateCorrelationId(headers);
- * // => Generates new ID if not found in headers
- * ```
- */
-function getOrCreateCorrelationId(headers) {
-    if (!headers)
-        return generateCorrelationId();
-    const existing = extractCorrelationId(headers);
-    return existing ?? generateCorrelationId();
-}
-/**
- * Create a correlation ID from a timestamp
- *
- * Useful for testing or when you need deterministic IDs.
- *
- * @param timestamp - Unix timestamp in milliseconds
- * @param random - Optional random component (generates if not provided)
- * @returns Correlation ID
- *
- * @example
- * ```typescript
- * const id = createCorrelationIdFromTimestamp(1716234567890);
- * // => 'req_1716234567890_a3f5c9d2'
- *
- * const deterministicId = createCorrelationIdFromTimestamp(1716234567890, 'aaaaaaaa');
- * // => 'req_1716234567890_aaaaaaaa'
- * ```
- */
-function createCorrelationIdFromTimestamp(timestamp, random) {
-    const randomComponent = random ?? generateRandomHex(8);
-    if (!/^[a-f0-9]{8}$/.test(randomComponent)) {
-        throw new Error(`Invalid random component: ${randomComponent}. Expected 8 hex characters`);
-    }
-    return `req_${timestamp}_${randomComponent}`;
-}
-/**
- * Calculate age of correlation ID in milliseconds
- *
- * @param id - Correlation ID
- * @returns Age in milliseconds, or null if invalid
- *
- * @example
- * ```typescript
- * const id = generateCorrelationId();
- * setTimeout(() => {
- *   const age = getCorrelationIdAge(id);
- *   console.log(`Request age: ${age}ms`);
- * }, 1000);
- * ```
- */
-function getCorrelationIdAge(id) {
-    const spec = parseCorrelationId(id);
-    if (!spec)
-        return null;
-    const now = Date.now();
-    return now - spec.timestamp;
-}
-/**
- * Check if correlation ID is expired
- *
- * @param id - Correlation ID
- * @param maxAgeMs - Maximum age in milliseconds (default: 5 minutes)
- * @returns True if expired, false otherwise
- *
- * @example
- * ```typescript
- * const id = generateCorrelationId();
- * if (isCorrelationIdExpired(id, 60000)) {
- *   console.log('Request older than 1 minute');
- * }
- * ```
- */
-function isCorrelationIdExpired(id, maxAgeMs = 5 * 60 * 1000) {
-    const age = getCorrelationIdAge(id);
-    return age !== null && age > maxAgeMs;
-}
-/**
- * Generate random hex string
- *
- * Uses Web Crypto API in browser, Node.js crypto in Node.
- * Falls back to Math.random() if neither available (NOT cryptographically secure).
- *
- * @param length - Number of hex characters to generate
- * @returns Random hex string
- *
- * @internal
- */
-function generateRandomHex(length) {
-    const bytes = Math.ceil(length / 2);
-    // Try Web Crypto API (browser)
-    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
-        const buffer = new Uint8Array(bytes);
-        crypto.getRandomValues(buffer);
-        return Array.from(buffer)
-            .map((b) => b.toString(16).padStart(2, '0'))
-            .join('')
-            .substring(0, length);
-    }
-    // Try Node.js crypto
-    try {
-        const nodeCrypto = require('node:crypto');
-        return nodeCrypto.randomBytes(bytes).toString('hex').substring(0, length);
-    }
-    catch {
-        // SECURITY: Never fall back to Math.random() in production (OWASP violation)
-        // Correlation IDs must be cryptographically random to prevent enumeration attacks
-        throw new Error('Cryptographic random generation unavailable. ' +
-            'Install crypto polyfill or use environment with crypto support.');
-    }
-}
-/**
- * Middleware helper for Express/Koa-style frameworks
- *
- * Automatically attaches correlation ID to incoming requests.
- *
- * @example
- * ```typescript
- * import express from 'express';
- * import { correlationIdMiddleware } from '@private.me/xbind';
- *
- * const app = express();
- * app.use(correlationIdMiddleware());
- * ```
- */
-function correlationIdMiddleware() {
-    return (req, res, next) => {
-        const id = getOrCreateCorrelationId(req.headers);
-        req.correlationId = id;
-        res.setHeader(exports.CORRELATION_ID_HEADER, id);
-        if (typeof next === 'function')
-            next();
-    };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.CORRELATION_ID_ALIASES=exports.CORRELATION_ID_HEADER=void 0,exports.generateCorrelationId=generateCorrelationId,exports.validateCorrelationId=validateCorrelationId,exports.parseCorrelationId=parseCorrelationId,exports.attachCorrelationId=attachCorrelationId,exports.extractCorrelationId=extractCorrelationId,exports.getOrCreateCorrelationId=getOrCreateCorrelationId,exports.createCorrelationIdFromTimestamp=createCorrelationIdFromTimestamp,exports.getCorrelationIdAge=getCorrelationIdAge,exports.isCorrelationIdExpired=isCorrelationIdExpired,exports.correlationIdMiddleware=correlationIdMiddleware,exports.CORRELATION_ID_HEADER="X-Correlation-ID",exports.CORRELATION_ID_ALIASES=["X-Request-ID","X-Trace-ID","X-Transaction-ID"];const CORRELATION_ID_PATTERN=/^req_\d{13}_[a-f0-9]{8}$/;function generateCorrelationId(){return`req_${Date.now()}_${generateRandomHex(8)}`}function validateCorrelationId(r){return"string"==typeof r&&CORRELATION_ID_PATTERN.test(r)}function parseCorrelationId(r){if(!validateCorrelationId(r))return null;const e=r.split("_");return{prefix:e[0]??"req",timestamp:parseInt(e[1]??"0",10),random:e[2]??""}}function attachCorrelationId(r,e){const t=e??generateCorrelationId();if(!validateCorrelationId(t))throw new Error(`Invalid correlation ID format: ${t}. Expected format: req_{timestamp}_{random}`);return r instanceof Headers?r.set(exports.CORRELATION_ID_HEADER,t):r[exports.CORRELATION_ID_HEADER]=t,r}function extractCorrelationId(r){const e=r instanceof Headers?r.get(exports.CORRELATION_ID_HEADER):r[exports.CORRELATION_ID_HEADER];if(e&&validateCorrelationId(e))return e;for(const e of exports.CORRELATION_ID_ALIASES){const t=r instanceof Headers?r.get(e):r[e];if(t&&validateCorrelationId(t))return t}}function getOrCreateCorrelationId(r){if(!r)return generateCorrelationId();return extractCorrelationId(r)??generateCorrelationId()}function createCorrelationIdFromTimestamp(r,e){const t=e??generateRandomHex(8);if(!/^[a-f0-9]{8}$/.test(t))throw new Error(`Invalid random component: ${t}. Expected 8 hex characters`);return`req_${r}_${t}`}function getCorrelationIdAge(r){const e=parseCorrelationId(r);if(!e)return null;return Date.now()-e.timestamp}function isCorrelationIdExpired(r,e=3e5){const t=getCorrelationIdAge(r);return null!==t&&t>e}function generateRandomHex(r){const e=Math.ceil(r/2);if("undefined"!=typeof crypto&&crypto.getRandomValues){const t=new Uint8Array(e);return crypto.getRandomValues(t),Array.from(t).map(r=>r.toString(16).padStart(2,"0")).join("").substring(0,r)}try{return require("node:crypto").randomBytes(e).toString("hex").substring(0,r)}catch{throw new Error("Cryptographic random generation unavailable. Install crypto polyfill or use environment with crypto support.")}}function correlationIdMiddleware(){return(r,e,t)=>{const o=getOrCreateCorrelationId(r.headers);r.correlationId=o,e.setHeader(exports.CORRELATION_ID_HEADER,o),"function"==typeof t&&t()}}

package/dist-standalone/cjs/crypto-utils.js

@@ -0,0 +1 @@
+"use strict";function toBase64(r){if("undefined"!=typeof Buffer)return Buffer.from(r).toString("base64");const e=String.fromCharCode(...r);return btoa(e)}function fromBase64(r){if("undefined"!=typeof Buffer)return new Uint8Array(Buffer.from(r,"base64"));const e=atob(r),t=new Uint8Array(e.length);for(let r=0;r<e.length;r++)t[r]=e.charCodeAt(r);return t}function toBase64Url(r){return toBase64(r).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,"")}function fromBase64Url(r){let e=r.replace(/-/g,"+").replace(/_/g,"/");for(;e.length%4;)e+="=";return fromBase64(e)}function generateUUID(){if("undefined"!=typeof crypto&&crypto.randomUUID)return crypto.randomUUID();const r=new Uint8Array(16);crypto.getRandomValues(r),r[6]=15&r[6]|64,r[8]=63&r[8]|128;const e=Array.from(r).map(r=>r.toString(16).padStart(2,"0")).join("");return`${e.substring(0,8)}-${e.substring(8,12)}-${e.substring(12,16)}-${e.substring(16,20)}-${e.substring(20)}`}Object.defineProperty(exports,"__esModule",{value:!0}),exports.isCryptoLoaded=exports.getCrypto=exports.loadCryptoPackage=void 0,exports.toBase64=toBase64,exports.fromBase64=fromBase64,exports.toBase64Url=toBase64Url,exports.fromBase64Url=fromBase64Url,exports.generateUUID=generateUUID,exports.formatShareHeader=formatShareHeader,exports.parseShareHeader=parseShareHeader,exports.hasShareHeader=hasShareHeader,exports.splitXorIDA=splitXorIDA,exports.reconstructXorIDA=reconstructXorIDA,exports.nextOddPrime=nextOddPrime,exports.pkcs7Pad=pkcs7Pad,exports.pkcs7Unpad=pkcs7Unpad,exports.generateHMAC=generateHMAC,exports.verifyHMAC=verifyHMAC;const START_MARKER="Encrypted://",END_MARKER="=> Generated by Xecret (TM)",BRAND_PREFIX="Xecret (TM) -> PRIVATE .ME (R) -> IDA5 -> ";function formatShareHeader(r){return`${BRAND_PREFIX}${START_MARKER} ${r} ${END_MARKER}`}function parseShareHeader(r){const e=r.indexOf(START_MARKER);if(e<0)return r.trim();const t=e+START_MARKER.length,o=r.indexOf(END_MARKER,t);return o<0?r.trim():r.substring(t,o).trim()}function hasShareHeader(r){return r.includes(START_MARKER)&&r.includes(END_MARKER)}const vault_store_loader_js_1=require("./vault-store-loader.js");function splitXorIDA(r,e,t){const o=(0,vault_store_loader_js_1.getCrypto)();if(!o)throw new Error("Crypto package not loaded. Call loadCryptoPackage() first.");return o.splitXorIDA(r,e,t)}function reconstructXorIDA(r,e,t,o){const a=(0,vault_store_loader_js_1.getCrypto)();if(!a)throw new Error("Crypto package not loaded. Call loadCryptoPackage() first.");return a.reconstructXorIDA(r,e,t,o)}function nextOddPrime(r){const e=(0,vault_store_loader_js_1.getCrypto)();if(!e)throw new Error("Crypto package not loaded. Call loadCryptoPackage() first.");return e.nextOddPrime(r)}function pkcs7Pad(r,e){const t=(0,vault_store_loader_js_1.getCrypto)();if(!t)throw new Error("Crypto package not loaded. Call loadCryptoPackage() first.");return t.pkcs7Pad(r,e)}function pkcs7Unpad(r,e){const t=(0,vault_store_loader_js_1.getCrypto)();if(!t)throw new Error("Crypto package not loaded. Call loadCryptoPackage() first.");return t.pkcs7Unpad(r,e)}async function generateHMAC(r){const e=(0,vault_store_loader_js_1.getCrypto)();if(!e)throw new Error("Crypto package not loaded. Call loadCryptoPackage() first.");return e.generateHMAC(r)}async function verifyHMAC(r,e,t){const o=(0,vault_store_loader_js_1.getCrypto)();if(!o)throw new Error("Crypto package not loaded. Call loadCryptoPackage() first.");return o.verifyHMAC(r,e,t)}Object.defineProperty(exports,"getCrypto",{enumerable:!0,get:function(){return vault_store_loader_js_1.getCrypto}}),Object.defineProperty(exports,"loadCryptoPackage",{enumerable:!0,get:function(){return vault_store_loader_js_1.loadCryptoPackage}}),Object.defineProperty(exports,"isCryptoLoaded",{enumerable:!0,get:function(){return vault_store_loader_js_1.isCryptoLoaded}});