@layr8/sdk 0.1.0

package/dist/rest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Internal REST client for the Layr8 cloud-node HTTP API.
+ *
+ * Handles JSON serialization, API key authentication, and localhost resolution.
+ *
+ * Uses Node's http/https modules instead of fetch because fetch (undici) does
+ * not honor custom Host headers — required for *.localhost resolution (RFC 6761).
+ */
+/**
+ * Derive the HTTP base URL from a WebSocket URL.
+ *
+ * ws://alice-test.localhost:4000/plugin_socket/websocket -> http://alice-test.localhost:4000
+ * wss://alice-test.localhost/plugin_socket/websocket -> https://alice-test.localhost
+ */
+export declare function restUrlFromWebSocket(wsUrl: string): string;
+/** RESTError represents an error response from the cloud-node REST API. */
+export declare class RESTError extends Error {
+    readonly statusCode: number;
+    constructor(statusCode: number, message: string);
+}
+/** Internal REST client for the cloud-node HTTP API. */
+export declare class RestClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    /** Send a JSON POST request and return the decoded response. */
+    post<T>(path: string, body: unknown): Promise<T>;
+    /** Send a GET request and return the decoded response. */
+    get<T>(path: string): Promise<T>;
+    /** Execute an HTTP request using node:http with localhost resolution (RFC 6761). */
+    private request;
+}
+//# sourceMappingURL=rest.d.ts.map

package/dist/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../src/rest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6B1D;AAED,2EAA2E;AAC3E,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKhD;AAED,wDAAwD;AACxD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK3C,gEAAgE;IAC1D,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAYtD,0DAA0D;IACpD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAQtC,oFAAoF;IACpF,OAAO,CAAC,OAAO;CA2DhB"}

package/dist/rest.js

@@ -0,0 +1,150 @@
+/**
+ * Internal REST client for the Layr8 cloud-node HTTP API.
+ *
+ * Handles JSON serialization, API key authentication, and localhost resolution.
+ *
+ * Uses Node's http/https modules instead of fetch because fetch (undici) does
+ * not honor custom Host headers — required for *.localhost resolution (RFC 6761).
+ */
+import http from "node:http";
+import https from "node:https";
+/** Check whether a hostname is localhost or a subdomain of it (RFC 6761). */
+function isLocalhost(hostname) {
+    return hostname === "localhost" || hostname.endsWith(".localhost");
+}
+/**
+ * Derive the HTTP base URL from a WebSocket URL.
+ *
+ * ws://alice-test.localhost:4000/plugin_socket/websocket -> http://alice-test.localhost:4000
+ * wss://alice-test.localhost/plugin_socket/websocket -> https://alice-test.localhost
+ */
+export function restUrlFromWebSocket(wsUrl) {
+    let u;
+    try {
+        u = new URL(wsUrl);
+    }
+    catch {
+        // Fallback: simple scheme replacement, strip path
+        let s = wsUrl.replace("wss://", "https://").replace("ws://", "http://");
+        const schemeEnd = s.indexOf("://");
+        if (schemeEnd !== -1) {
+            const pathStart = s.indexOf("/", schemeEnd + 3);
+            if (pathStart !== -1) {
+                s = s.slice(0, pathStart);
+            }
+        }
+        return s;
+    }
+    switch (u.protocol) {
+        case "wss:":
+            u.protocol = "https:";
+            break;
+        default:
+            u.protocol = "http:";
+            break;
+    }
+    u.pathname = "";
+    u.search = "";
+    u.hash = "";
+    return u.toString().replace(/\/$/, "");
+}
+/** RESTError represents an error response from the cloud-node REST API. */
+export class RESTError extends Error {
+    statusCode;
+    constructor(statusCode, message) {
+        super(`REST API error ${statusCode}: ${message}`);
+        this.name = "RESTError";
+        this.statusCode = statusCode;
+    }
+}
+/** Internal REST client for the cloud-node HTTP API. */
+export class RestClient {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl;
+        this.apiKey = apiKey;
+    }
+    /** Send a JSON POST request and return the decoded response. */
+    async post(path, body) {
+        const data = JSON.stringify(body);
+        const headers = {
+            "Content-Type": "application/json",
+            "Content-Length": String(Buffer.byteLength(data)),
+        };
+        if (this.apiKey) {
+            headers["x-api-key"] = this.apiKey;
+        }
+        return this.request("POST", path, headers, data);
+    }
+    /** Send a GET request and return the decoded response. */
+    async get(path) {
+        const headers = {};
+        if (this.apiKey) {
+            headers["x-api-key"] = this.apiKey;
+        }
+        return this.request("GET", path, headers);
+    }
+    /** Execute an HTTP request using node:http with localhost resolution (RFC 6761). */
+    request(method, path, headers, body) {
+        const parsed = new URL(this.baseUrl + path);
+        const isHttps = parsed.protocol === "https:";
+        const mod = isHttps ? https : http;
+        // Resolve *.localhost to 127.0.0.1, preserving the original Host header.
+        let hostname = parsed.hostname;
+        if (isLocalhost(hostname)) {
+            headers["Host"] = parsed.host;
+            hostname = "127.0.0.1";
+        }
+        return new Promise((resolve, reject) => {
+            const req = mod.request({
+                hostname,
+                port: parsed.port || (isHttps ? 443 : 80),
+                path: parsed.pathname + parsed.search,
+                method,
+                headers,
+            }, (res) => {
+                const chunks = [];
+                res.on("data", (chunk) => chunks.push(chunk));
+                res.on("end", () => {
+                    const respBody = Buffer.concat(chunks).toString("utf-8");
+                    const status = res.statusCode ?? 0;
+                    if (status >= 400) {
+                        reject(parseRESTError(status, respBody));
+                        return;
+                    }
+                    if (respBody.length > 0) {
+                        try {
+                            resolve(JSON.parse(respBody));
+                        }
+                        catch {
+                            reject(new Error(`Invalid JSON response: ${respBody}`));
+                        }
+                    }
+                    else {
+                        resolve(undefined);
+                    }
+                });
+            });
+            req.on("error", reject);
+            if (body) {
+                req.write(body);
+            }
+            req.end();
+        });
+    }
+}
+/** Parse an error response body into a RESTError. */
+function parseRESTError(statusCode, body) {
+    try {
+        const parsed = JSON.parse(body);
+        if (parsed.error) {
+            return new RESTError(statusCode, parsed.error);
+        }
+    }
+    catch {
+        // Not JSON; use raw body as message
+    }
+    return new RESTError(statusCode, body);
+}
+//# sourceMappingURL=rest.js.map

package/dist/rest.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@layr8/sdk",
+  "version": "0.1.0",
+  "description": "Layr8 DIDComm Agent SDK for Node.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "test:integration": "tsx tests/integration-test.ts"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "ws": "^8.18.0",
+    "uuid": "^11.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT"
+}