@openlv/core 0.0.1-beta.1

package/dist/utils/url.js

@@ -0,0 +1,66 @@
+export const encodeConnectionURL = (payload) => {
+    const params = new URLSearchParams();
+    params.set("h", payload.h);
+    params.set("k", payload.k);
+    if (payload.p) {
+        params.set("p", payload.p);
+    }
+    if (payload.s) {
+        params.set("s", payload.s);
+    }
+    return `openlv://${payload.sessionId}?${params.toString()}`;
+};
+export const decodeConnectionURL = (url) => {
+    // Type check and validation
+    if (typeof url !== "string") {
+        throw new Error(`Invalid URL type: expected string, got ${typeof url}`);
+    }
+    if (!url || url.trim() === "") {
+        throw new Error("URL cannot be empty");
+    }
+    if (!url.startsWith("openlv://")) {
+        throw new Error(`Invalid URL format: must start with 'openlv://', got: ${url}`);
+    }
+    try {
+        const urlObj = new URL(url);
+        const sessionId = urlObj.hostname || urlObj.pathname.replace("/", "");
+        const h = urlObj.searchParams.get("h") || "";
+        const k = urlObj.searchParams.get("k") || "";
+        const s = urlObj.searchParams.get("s") || undefined;
+        const p = urlObj.searchParams.get("p") || "mqtt";
+        if (!sessionId) {
+            throw new Error("Session ID is required in URL");
+        }
+        // Validate session ID format (16 characters, URL-safe alphabet)
+        if (!/^[A-Za-z0-9_-]{16}$/.test(sessionId)) {
+            throw new Error("Invalid session ID format: must be 16 URL-safe characters");
+        }
+        if (!h) {
+            throw new Error("Public key hash (h parameter) is required in URL");
+        }
+        // Validate public key hash format (16 hex characters)
+        if (!/^[0-9a-f]{16}$/.test(h)) {
+            throw new Error("Invalid public key hash format: must be 16 hex characters");
+        }
+        if (!k) {
+            throw new Error("Shared key (k parameter) is required in URL");
+        }
+        // Validate shared key format (32 hex characters)
+        if (!/^[0-9a-f]{32}$/.test(k)) {
+            throw new Error(`Invalid shared key format: must be 32 hex characters, received: ${k}`);
+        }
+        return {
+            sessionId,
+            h,
+            k,
+            // TODO: figure out why '' empty string and not undefined
+            s: s ? decodeURIComponent(s) : "",
+            p,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        throw new Error(`Failed to parse URL: ${url}. Original error: ${errorMessage}`);
+    }
+};
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

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

package/dist/utils/url.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/url.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, test } from "vitest";
+import { decodeConnectionURL, encodeConnectionURL } from "./url.js";
+const testCases = [
+    {
+        url: "openlv://k7n8m9x2w5q1p3r6?h=a1b2c3d4e5f60708&k=0123456789abcdef0123456789abcdef&p=mqtt&s=wss%3A%2F%2Ftest.mosquitto.org%3A8081%2Fmqtt",
+        expected: {
+            sessionId: "k7n8m9x2w5q1p3r6",
+            h: "a1b2c3d4e5f60708",
+            k: "0123456789abcdef0123456789abcdef",
+            p: "mqtt",
+            s: "wss://test.mosquitto.org:8081/mqtt",
+        },
+    },
+];
+describe("URL Utilities", () => {
+    test("should decode connection URL", () => {
+        testCases.forEach((testCase) => {
+            const result = decodeConnectionURL(testCase.url);
+            expect(result).toEqual(testCase.expected);
+        });
+    });
+    test("should encode connection URL", () => {
+        testCases.forEach((testCase) => {
+            const result = encodeConnectionURL(testCase.expected);
+            expect(result).toEqual(testCase.url);
+        });
+    });
+});
+//# sourceMappingURL=url.test.js.map

package/dist/utils/url.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.test.js","sourceRoot":"","sources":["../../src/utils/url.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpE,MAAM,SAAS,GAAG;IAChB;QACE,GAAG,EAAE,uIAAuI;QAC5I,QAAQ,EAAE;YACR,SAAS,EAAE,kBAAkB;YAC7B,CAAC,EAAE,kBAAkB;YACrB,CAAC,EAAE,kCAAkC;YACrC,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,oCAAoC;SACxC;KACF;CACF,CAAC;AAEF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACxC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACxC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEtD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@openlv/core",
+  "version": "0.0.1-beta.1",
+  "license": "LGPL-3.0-only",
+  "keywords": [
+    "open-lavatory"
+  ],
+  "homepage": "https://github.com/v3xlabs/open-lavatory",
+  "bugs": {
+    "url": "https://github.com/v3xlabs/open-lavatory/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/v3xlabs/open-lavatory.git",
+    "directory": "packages/core"
+  },
+  "author": {
+    "name": "Open-Lavatory",
+    "url": "https://github.com/v3xlabs/open-lavatory"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./encryption": {
+      "types": "./dist/encryption/index.d.ts",
+      "default": "./dist/encryption/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "default": "./dist/errors/index.js"
+    },
+    "./icons": {
+      "types": "./dist/icons/index.d.ts",
+      "default": "./dist/icons/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "eventemitter3": "^5.0.1",
+    "tweetnacl": "^1.0.3"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "vitest": "^4"
+  },
+  "peerDependencies": {
+    "@wagmi/core": "2",
+    "viem": "2",
+    "wagmi": "2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest"
+  }
+}