@toon-protocol/connector 3.3.1 → 3.3.2

package/dist/encoding/oer-parser.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OERParser = void 0;
+class OERParser {
+    constructor(_logger) {
+    }
+    readVarUInt(buffer, offset) {
+        if (offset >= buffer.length) {
+            throw new Error('Buffer underflow: cannot read var uint');
+        }
+        const firstByte = buffer[offset];
+        if (firstByte === undefined) {
+            throw new Error('Buffer underflow: cannot read first byte');
+        }
+        if ((firstByte & 0x80) === 0) {
+            return { value: BigInt(firstByte), bytesRead: 1 };
+        }
+        const lengthOfLength = firstByte & 0x7f;
+        if (lengthOfLength > 8) {
+            throw new Error(`Invalid var uint length: ${lengthOfLength}`);
+        }
+        if (offset + 1 + lengthOfLength > buffer.length) {
+            throw new Error('Buffer underflow: incomplete var uint');
+        }
+        const valueBytes = buffer.slice(offset + 1, offset + 1 + lengthOfLength);
+        let value = BigInt(0);
+        for (let i = 0; i < lengthOfLength; i++) {
+            const byte = valueBytes[i];
+            if (byte === undefined) {
+                throw new Error('Buffer underflow: incomplete value bytes');
+            }
+            value = (value << BigInt(8)) | BigInt(byte);
+        }
+        return { value, bytesRead: 1 + lengthOfLength };
+    }
+    readVarOctetString(buffer, offset) {
+        const { value: length, bytesRead: lengthBytes } = this.readVarUInt(buffer, offset);
+        const lengthNum = Number(length);
+        if (lengthNum > Number.MAX_SAFE_INTEGER) {
+            throw new Error(`Octet string too large: ${length}`);
+        }
+        if (offset + lengthBytes + lengthNum > buffer.length) {
+            throw new Error('Buffer underflow: incomplete octet string');
+        }
+        const value = buffer.slice(offset + lengthBytes, offset + lengthBytes + lengthNum);
+        return { value, bytesRead: lengthBytes + lengthNum };
+    }
+    readOctetString(buffer, offset, length) {
+        if (offset + length > buffer.length) {
+            throw new Error('Buffer underflow: incomplete fixed octet string');
+        }
+        const value = buffer.slice(offset, offset + length);
+        return { value, bytesRead: length };
+    }
+    readUInt8(buffer, offset) {
+        if (offset >= buffer.length) {
+            throw new Error('Buffer underflow: cannot read uint8');
+        }
+        const value = buffer[offset];
+        if (value === undefined) {
+            throw new Error('Buffer underflow: cannot read uint8 value');
+        }
+        return { value, bytesRead: 1 };
+    }
+    readUInt16(buffer, offset) {
+        if (offset + 2 > buffer.length) {
+            throw new Error('Buffer underflow: cannot read uint16');
+        }
+        const value = buffer.readUInt16BE(offset);
+        return { value, bytesRead: 2 };
+    }
+    readUInt32(buffer, offset) {
+        if (offset + 4 > buffer.length) {
+            throw new Error('Buffer underflow: cannot read uint32');
+        }
+        const value = buffer.readUInt32BE(offset);
+        return { value, bytesRead: 4 };
+    }
+    readUInt64(buffer, offset) {
+        if (offset + 8 > buffer.length) {
+            throw new Error('Buffer underflow: cannot read uint64');
+        }
+        const value = buffer.readBigUInt64BE(offset);
+        return { value, bytesRead: 8 };
+    }
+    writeVarUInt(value) {
+        const bigIntValue = typeof value === 'number' ? BigInt(value) : value;
+        if (bigIntValue < 0) {
+            throw new Error('Cannot encode negative value as var uint');
+        }
+        if (bigIntValue < 128) {
+            return Buffer.from([Number(bigIntValue)]);
+        }
+        const bytes = [];
+        let remaining = bigIntValue;
+        while (remaining > 0) {
+            bytes.unshift(Number(remaining & BigInt(0xff)));
+            remaining = remaining >> BigInt(8);
+        }
+        const lengthOfLength = bytes.length;
+        if (lengthOfLength > 127) {
+            throw new Error('Value too large for var uint encoding');
+        }
+        const result = Buffer.allocUnsafe(1 + lengthOfLength);
+        result[0] = 0x80 | lengthOfLength;
+        for (let i = 0; i < lengthOfLength; i++) {
+            const byte = bytes[i];
+            if (byte === undefined) {
+                throw new Error('Internal error: invalid bytes array');
+            }
+            result[1 + i] = byte;
+        }
+        return result;
+    }
+    writeVarOctetString(data) {
+        const lengthPrefix = this.writeVarUInt(data.length);
+        return Buffer.concat([lengthPrefix, data]);
+    }
+    writeUInt8(value) {
+        if (value < 0 || value > 255) {
+            throw new Error('Value out of range for uint8');
+        }
+        const buffer = Buffer.allocUnsafe(1);
+        buffer.writeUInt8(value, 0);
+        return buffer;
+    }
+    writeUInt16(value) {
+        if (value < 0 || value > 65535) {
+            throw new Error('Value out of range for uint16');
+        }
+        const buffer = Buffer.allocUnsafe(2);
+        buffer.writeUInt16BE(value, 0);
+        return buffer;
+    }
+    writeUInt32(value) {
+        if (value < 0 || value > 4294967295) {
+            throw new Error('Value out of range for uint32');
+        }
+        const buffer = Buffer.allocUnsafe(4);
+        buffer.writeUInt32BE(value, 0);
+        return buffer;
+    }
+    writeUInt64(value) {
+        const bigIntValue = typeof value === 'number' ? BigInt(value) : value;
+        if (bigIntValue < 0 || bigIntValue > BigInt('0xFFFFFFFFFFFFFFFF')) {
+            throw new Error('Value out of range for uint64');
+        }
+        const buffer = Buffer.allocUnsafe(8);
+        buffer.writeBigUInt64BE(bigIntValue, 0);
+        return buffer;
+    }
+}
+exports.OERParser = OERParser;
+//# sourceMappingURL=oer-parser.js.map

package/dist/encoding/oer-parser.js.map

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

package/dist/facilitator/index.d.ts

@@ -0,0 +1,2 @@
+export { SPSPClient, SPSPError, SPSPResponse } from './spsp-client';
+//# sourceMappingURL=index.d.ts.map

package/dist/facilitator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/facilitator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/facilitator/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPSPError = exports.SPSPClient = void 0;
+var spsp_client_1 = require("./spsp-client");
+Object.defineProperty(exports, "SPSPClient", { enumerable: true, get: function () { return spsp_client_1.SPSPClient; } });
+Object.defineProperty(exports, "SPSPError", { enumerable: true, get: function () { return spsp_client_1.SPSPError; } });
+//# sourceMappingURL=index.js.map

package/dist/facilitator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/facilitator/index.ts"],"names":[],"mappings":";;;AAAA,6CAAoE;AAA3D,yGAAA,UAAU,OAAA;AAAE,wGAAA,SAAS,OAAA"}

package/dist/facilitator/spsp-client.d.ts

@@ -0,0 +1,18 @@
+import pino from 'pino';
+export interface SPSPResponse {
+    destination_account: string;
+    shared_secret: Buffer;
+}
+export declare class SPSPError extends Error {
+    code: string;
+    statusCode?: number;
+    constructor(message: string, code?: string, statusCode?: number);
+}
+export declare class SPSPClient {
+    private logger;
+    private timeout;
+    constructor(logger: pino.Logger, timeout?: number);
+    private paymentPointerToUrl;
+    resolvePaymentPointer(paymentPointer: string): Promise<SPSPResponse>;
+}
+//# sourceMappingURL=spsp-client.d.ts.map

package/dist/facilitator/spsp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spsp-client.d.ts","sourceRoot":"","sources":["../../src/facilitator/spsp-client.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAMhE;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,GAAE,MAAa;IAKvD,OAAO,CAAC,mBAAmB;IAcrB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAkG3E"}

package/dist/facilitator/spsp-client.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPSPClient = exports.SPSPError = void 0;
+class SPSPError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode) {
+        super(message);
+        this.name = 'SPSPError';
+        this.code = code || 'SPSP_ERROR';
+        this.statusCode = statusCode;
+    }
+}
+exports.SPSPError = SPSPError;
+class SPSPClient {
+    logger;
+    timeout;
+    constructor(logger, timeout = 5000) {
+        this.logger = logger;
+        this.timeout = timeout;
+    }
+    paymentPointerToUrl(paymentPointer) {
+        if (!paymentPointer.startsWith('$')) {
+            throw new SPSPError('Invalid payment pointer format', 'INVALID_POINTER');
+        }
+        const withoutDollar = paymentPointer.substring(1);
+        const parts = withoutDollar.split('/');
+        const domain = parts[0];
+        const path = parts.slice(1).join('/');
+        return `https://${domain}/.well-known/pay${path ? '/' + path : ''}`;
+    }
+    async resolvePaymentPointer(paymentPointer) {
+        const startTime = Date.now();
+        const url = this.paymentPointerToUrl(paymentPointer);
+        const maxRetries = 3;
+        const backoffDelays = [100, 200, 400];
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+                const response = await fetch(url, {
+                    headers: { Accept: 'application/spsp4+json' },
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    if (response.status === 404) {
+                        throw new SPSPError('Invalid payment pointer', 'INVALID_PAYMENT_POINTER', 404);
+                    }
+                    throw new SPSPError(`SPSP handshake failed: ${response.status}`, 'SPSP_ERROR', response.status);
+                }
+                const data = (await response.json());
+                if (!data.destination_account || !data.shared_secret) {
+                    throw new SPSPError('Invalid SPSP response', 'INVALID_RESPONSE');
+                }
+                const handshakeDuration = Date.now() - startTime;
+                this.logger.info({
+                    paymentPointer,
+                    destination: data.destination_account,
+                    duration: handshakeDuration,
+                }, 'SPSP handshake complete');
+                return {
+                    destination_account: data.destination_account,
+                    shared_secret: Buffer.from(data.shared_secret, 'base64'),
+                };
+            }
+            catch (error) {
+                if (error instanceof SPSPError) {
+                    throw error;
+                }
+                const err = error;
+                if (err.code === 'ENOTFOUND') {
+                    throw new SPSPError('Peer unreachable', 'PEER_UNREACHABLE');
+                }
+                if (err.name === 'AbortError') {
+                    if (attempt === maxRetries - 1) {
+                        throw new SPSPError('SPSP timeout', 'SPSP_TIMEOUT');
+                    }
+                    this.logger.warn({ attempt: attempt + 1, delay: backoffDelays[attempt] }, 'SPSP timeout, retrying');
+                    await new Promise((resolve) => setTimeout(resolve, backoffDelays[attempt]));
+                    continue;
+                }
+                if (attempt === maxRetries - 1) {
+                    const errorMessage = err.message || 'Unknown error';
+                    throw new SPSPError(`SPSP handshake failed: ${errorMessage}`, 'SPSP_ERROR');
+                }
+                this.logger.warn({ attempt: attempt + 1, delay: backoffDelays[attempt], err: error }, 'SPSP error, retrying');
+                await new Promise((resolve) => setTimeout(resolve, backoffDelays[attempt]));
+            }
+        }
+        throw new SPSPError('SPSP handshake failed after retries', 'SPSP_ERROR');
+    }
+}
+exports.SPSPClient = SPSPClient;
+//# sourceMappingURL=spsp-client.js.map

package/dist/facilitator/spsp-client.js.map

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

package/dist/http/admin-api-inventory.d.ts

@@ -0,0 +1,29 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+export type ServerName = 'AdminServer' | 'HealthServer';
+export type AuthModel = 'X-Api-Key' | 'unauthenticated' | 'ip-allowlist';
+export type CrossSurfaceGroupId = 'peer-existence' | 'packet-counters' | 'channel-state' | 'health-liveness-readiness';
+export interface InventoryEntry {
+    path: string;
+    method: HttpMethod;
+    server: ServerName;
+    mountPrefix: string;
+    authModel: AuthModel;
+    successStatus: number;
+    failureModes: Array<{
+        status: number;
+        description: string;
+        condition?: string;
+    }>;
+    requestContract: string;
+    responseContract: string;
+    owningModule: string;
+    relatedStories: string[];
+    crossSurfaceGroupId?: CrossSurfaceGroupId;
+    operationalNotes: string;
+}
+export declare const ADMIN_API_INVENTORY: readonly InventoryEntry[];
+export type AdminApiInventoryEntry = (typeof ADMIN_API_INVENTORY)[number];
+export declare function getEntriesByServer(server: ServerName): readonly InventoryEntry[];
+export declare function getEntriesByGroup(groupId: CrossSurfaceGroupId): readonly InventoryEntry[];
+export declare function getEntriesByAuthModel(authModel: AuthModel): readonly InventoryEntry[];
+//# sourceMappingURL=admin-api-inventory.d.ts.map

package/dist/http/admin-api-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-api-inventory.d.ts","sourceRoot":"","sources":["../../src/http/admin-api-inventory.ts"],"names":[],"mappings":"AAgCA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAKrE,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,cAAc,CAAC;AAYxD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAMzE,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,2BAA2B,CAAC;AAKhC,MAAM,WAAW,cAAc;IAE7B,IAAI,EAAE,MAAM,CAAC;IAGb,MAAM,EAAE,UAAU,CAAC;IAGnB,MAAM,EAAE,UAAU,CAAC;IAGnB,WAAW,EAAE,MAAM,CAAC;IAGpB,SAAS,EAAE,SAAS,CAAC;IAGrB,aAAa,EAAE,MAAM,CAAC;IAGtB,YAAY,EAAE,KAAK,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IAGH,eAAe,EAAE,MAAM,CAAC;IAGxB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,MAAM,CAAC;IAGrB,cAAc,EAAE,MAAM,EAAE,CAAC;IAGzB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAG1C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAeD,eAAO,MAAM,mBAAmB,EAAE,SAAS,cAAc,EAomB/C,CAAC;AAKX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAK1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,cAAc,EAAE,CAEhF;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,cAAc,EAAE,CAEzF;AAKD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,cAAc,EAAE,CAErF"}