@openlv/session 0.0.1-beta.10

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,3 @@
+# @openlv/session
+
+[Documentation](https://openlv.sh/api/session)

package/dist/base.d.ts

@@ -0,0 +1,48 @@
+import { type SessionHandshakeParameters, type SessionLinkParameters } from "@openlv/core";
+import { type CreateSignalLayerFn, type SignalingLayer, type SignalState } from "@openlv/signaling";
+import { type TLayer, type TransportLayer } from "@openlv/transport";
+import { EventEmitter } from "eventemitter3";
+import type { SessionEvents } from "./events.js";
+export declare const SESSION_STATE: {
+    readonly CREATED: "created";
+    readonly SIGNALING: "signaling";
+    readonly READY: "ready";
+    readonly LINKING: "linking";
+    readonly CONNECTED: "connected";
+    readonly DISCONNECTED: "disconnected";
+};
+export type SessionState = (typeof SESSION_STATE)[keyof typeof SESSION_STATE];
+export type SessionStateObject = {
+    status: SessionState;
+    signaling?: {
+        state: SignalState;
+    };
+};
+/**
+ * an OpenLV Session
+ *
+ * https://openlv.sh/api/session
+ */
+export type Session = {
+    getState(): SessionStateObject;
+    getHandshakeParameters(): SessionHandshakeParameters;
+    connect(): Promise<void>;
+    waitForLink(): Promise<void>;
+    close(): Promise<void>;
+    send(message: object, timeout?: number): Promise<unknown>;
+    emitter: EventEmitter<SessionEvents>;
+    _internal: {
+        signal: SignalingLayer;
+        transport: TransportLayer;
+    };
+};
+/**
+ * OpenLV Session
+ *
+ * https://openlv.sh/api/session
+ */
+export declare const createSession: (initParameters: SessionLinkParameters, signalLayer: CreateSignalLayerFn, transportLayer: TLayer, onMessage: (message: object) => Promise<object | string>) => Promise<Session>;
+/**
+ * Connect to a session from its openlv:// URL
+ */
+export declare const connectSession: (connectionUrl: string, onMessage: (message: object) => Promise<object | string>, transport: TLayer) => Promise<Session>;

package/dist/base.js

@@ -0,0 +1,233 @@
+import { decodeConnectionURL, OPENLV_PROTOCOL_VERSION, } from "@openlv/core";
+import { deriveSymmetricKey, generateHandshakeKey, generateSessionId, initEncryptionKeys, initHash, parseEncryptionKey, } from "@openlv/core/encryption";
+import { SIGNAL_STATE, } from "@openlv/signaling";
+import { dynamicSignalingLayer } from "@openlv/signaling/dynamic";
+import { TRANSPORT_STATE, } from "@openlv/transport";
+import { EventEmitter } from "eventemitter3";
+import { log } from "./utils/log.js";
+export const SESSION_STATE = {
+    CREATED: "created",
+    SIGNALING: "signaling",
+    READY: "ready",
+    LINKING: "linking",
+    CONNECTED: "connected",
+    DISCONNECTED: "disconnected",
+};
+/**
+ * OpenLV Session
+ *
+ * https://openlv.sh/api/session
+ */
+export const createSession = async (initParameters, signalLayer, transportLayer, onMessage) => {
+    const emitter = new EventEmitter();
+    const messages = new EventEmitter();
+    const sessionId = "sessionId" in initParameters
+        ? initParameters.sessionId
+        : generateSessionId();
+    const { encryptionKey, decryptionKey: { decrypt }, } = await initEncryptionKeys(initParameters);
+    let relyingPublicKey;
+    const handshakeKey = "k" in initParameters
+        ? await deriveSymmetricKey(initParameters.k)
+        : await generateHandshakeKey();
+    const { hash, isHost } = await initHash("h" in initParameters ? initParameters.h : undefined, encryptionKey);
+    let status = SESSION_STATE.CREATED;
+    const protocol = initParameters.p;
+    const server = initParameters.s;
+    const updateStatus = (newStatus) => {
+        log("updateStatus", newStatus);
+        status = newStatus;
+        emitter.emit("state_change", { status, signaling: signal.getState() });
+    };
+    const signaling = await signalLayer({
+        topic: sessionId,
+        url: server,
+    });
+    const signal = await signaling({
+        h: hash,
+        canEncrypt() {
+            return relyingPublicKey !== undefined;
+        },
+        async encrypt(message) {
+            if (!relyingPublicKey) {
+                throw new Error("Relying party public key not found");
+            }
+            log(`encrypting to ${relyingPublicKey.toString()}`, message);
+            return await relyingPublicKey.encrypt(message);
+        },
+        decrypt,
+        publicKey: encryptionKey,
+        k: handshakeKey,
+        async rpDiscovered(rpKey) {
+            const role = isHost ? "host" : "client";
+            log(`rpKey discovered by ${role}`, rpKey);
+            relyingPublicKey = await parseEncryptionKey(rpKey);
+        },
+        isHost,
+    });
+    const transport = transportLayer({
+        encrypt(message) {
+            if (!relyingPublicKey) {
+                throw new Error("Relying party public key not found");
+            }
+            return relyingPublicKey?.encrypt(message);
+        },
+        decrypt,
+        isHost,
+        onmessage: async (message) => {
+            console.log("Session: received message from transport", message);
+            // @ts-ignore
+            if (message["type"] === "request") {
+                // @ts-ignore
+                const data = await onMessage(message["payload"]);
+                const response = {
+                    type: "response",
+                    // @ts-ignore
+                    messageId: message["messageId"],
+                    payload: data,
+                };
+                await transport.send(response);
+            }
+            // @ts-ignore
+            if (message["type"] === "response") {
+                messages.emit("message", message);
+            }
+        },
+        async subsend(message) {
+            console.log("Session: sending trans msg to signal", message);
+            const sessionMessage = {
+                type: "request",
+                messageId: crypto.randomUUID(),
+                payload: message,
+            };
+            await signal.send(sessionMessage);
+        },
+    });
+    transport.emitter.on("state_change", (state) => {
+        log("transport state change", state);
+        if (state === TRANSPORT_STATE.CONNECTED) {
+            updateStatus(SESSION_STATE.CONNECTED);
+        }
+    });
+    const startTransport = async () => {
+        await transport.setup();
+    };
+    // let transport: TransportLayer | undefined;
+    const onSignalMessage = async (message) => {
+        log("Session: received message from signaling", message);
+        const sessionMsg = message;
+        if (sessionMsg.type === "response") {
+            log("Session: received data message", sessionMsg.payload);
+            messages.emit("message", sessionMsg);
+        }
+        if (sessionMsg.type === "request") {
+            log("Session: received request message", sessionMsg.payload);
+            transport.handle(sessionMsg.payload);
+        }
+    };
+    return {
+        connect: async () => {
+            updateStatus(SESSION_STATE.SIGNALING);
+            log("connecting to session, isHost:", isHost);
+            // TODO: implement
+            log("connecting to session");
+            signal.on("message", onSignalMessage);
+            signal.on("state_change", (state) => {
+                log("signal state change", state);
+                if (state === SIGNAL_STATE.READY) {
+                    updateStatus(SESSION_STATE.READY);
+                }
+                if ([
+                    SIGNAL_STATE.HANDSHAKE,
+                    SIGNAL_STATE.HANDSHAKE_PARTIAL,
+                ].includes(state)) {
+                    updateStatus(SESSION_STATE.LINKING);
+                }
+                if (state === SIGNAL_STATE.ENCRYPTED) {
+                    // for now cuz we just use signaling call this a full connection
+                    // updateStatus("connected");
+                    startTransport();
+                }
+            });
+            // TODO: handle errors in setup nicely in modal UI
+            await signal.setup();
+        },
+        async close() {
+            log("session teardown");
+            await signal?.teardown();
+            updateStatus(SESSION_STATE.DISCONNECTED);
+        },
+        getState() {
+            return {
+                status,
+                signaling: signal.getState(),
+                // transport: transport.getState(),
+            };
+        },
+        getHandshakeParameters() {
+            return {
+                version: OPENLV_PROTOCOL_VERSION,
+                sessionId,
+                h: hash,
+                k: handshakeKey.toString(),
+                p: protocol,
+                s: server,
+            };
+        },
+        waitForLink: async () => {
+            return new Promise((resolve) => {
+                emitter.on("state_change", (state) => {
+                    if (state?.status === SESSION_STATE.CONNECTED) {
+                        resolve();
+                    }
+                });
+            });
+        },
+        async send(message, timeout = 5000) {
+            const ready = signal.getState().state === SIGNAL_STATE.ENCRYPTED;
+            // const transportReady = transport.getState() === TRANSPORT_STATE.CONNECTED;
+            if (!ready) {
+                throw new Error("Session not ready");
+            }
+            const randomID = crypto.randomUUID();
+            const sessionMessage = {
+                type: "request",
+                messageId: randomID,
+                payload: message,
+            };
+            // for now use signaling
+            // await signal.send(sessionMessage);
+            await transport.send(sessionMessage);
+            return Promise.race([
+                new Promise((resolve) => {
+                    messages.on("message", (message) => {
+                        if (message.messageId === randomID && message.type === "response") {
+                            resolve(message.payload);
+                        }
+                    });
+                }),
+                new Promise((resolve) => {
+                    setTimeout(() => {
+                        resolve(new Error("Timeout"));
+                    }, timeout);
+                }),
+            ]);
+        },
+        _internal: {
+            signal,
+            transport,
+        },
+        emitter,
+    };
+};
+/**
+ * Connect to a session from its openlv:// URL
+ */
+export const connectSession = async (connectionUrl, onMessage, transport) => {
+    const initParameters = decodeConnectionURL(connectionUrl);
+    const signaling = await dynamicSignalingLayer(initParameters.p);
+    if (!signaling) {
+        throw new Error(`Invalid signaling protocol: ${initParameters.p}`);
+    }
+    return createSession(initParameters, signaling, transport, onMessage);
+};
+//# sourceMappingURL=base.js.map

package/dist/base.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,4 @@
+import type { SessionStateObject } from "./base.js";
+export type SessionEvents = {
+    state_change: (state?: SessionStateObject) => void;
+};

package/dist/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/** biome-ignore-all lint/performance/noBarrelFile: package entrypoint */
+/**
+ * Open Lavatory Protocol - Decentralized Wallet Connection Library
+ *
+ * A privacy-first, peer-to-peer protocol for connecting dApps with wallets
+ * without relying on centralized infrastructure.
+ */
+export * from "./base.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+/** biome-ignore-all lint/performance/noBarrelFile: package entrypoint */
+/**
+ * Open Lavatory Protocol - Decentralized Wallet Connection Library
+ *
+ * A privacy-first, peer-to-peer protocol for connecting dApps with wallets
+ * without relying on centralized infrastructure.
+ */
+// biome-ignore lint/performance/noReExportAll: package entrypoint
+export * from "./base.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE;;;;;GAKG;AAEH,kEAAkE;AAClE,cAAc,WAAW,CAAC"}

package/dist/index.test.d.ts

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

package/dist/index.test.js

@@ -0,0 +1,42 @@
+import { decodeConnectionURL, encodeConnectionURL } from "@openlv/core";
+import { ntfy } from "@openlv/signaling/ntfy";
+import { webrtc } from "@openlv/transport/webrtc";
+import { describe, expect, test } from "vitest";
+import { connectSession, createSession } from "./base.js";
+describe("Session", () => {
+    test("Should be able to create a session", async () => {
+        const sessionA = await createSession({
+            sessionId: "mytestsession111",
+            p: "ntfy",
+            s: "https://ntfy.sh/",
+        }, ntfy, webrtc(), async (message) => {
+            console.log("sessionA received message", message);
+            return { result: "success" };
+        });
+        expect(sessionA).toBeDefined();
+        console.log(sessionA.getState());
+        await sessionA.connect();
+        const handshakeParametersA = sessionA.getHandshakeParameters();
+        const encodedUrl = encodeConnectionURL(handshakeParametersA);
+        console.log(encodedUrl);
+        const decodedUrl = decodeConnectionURL(encodedUrl);
+        expect(decodedUrl).toEqual(handshakeParametersA);
+        //
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        console.log("Connecting to session B");
+        const sessionB = await connectSession(encodedUrl, async (message) => {
+            console.log("sessionB received message", message);
+            return { result: "success" };
+        }, webrtc());
+        console.log(sessionB.getState());
+        await sessionB.connect();
+        await Promise.all([sessionA.waitForLink(), sessionB.waitForLink()]);
+        //
+        console.log("A", sessionA.getState());
+        console.log("B", sessionB.getState());
+        const response = await sessionA.send({ data: "test" });
+        console.log("response", response);
+        expect(response).toEqual({ result: "success" });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1D,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC;YACE,SAAS,EAAE,kBAAkB;YAC7B,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,kBAAkB;SACtB,EACD,IAAI,EACJ,MAAM,EAAE,EACR,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;YAElD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEjC,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEzB,MAAM,oBAAoB,GAAG,QAAQ,CAAC,sBAAsB,EAAE,CAAC;QAC/D,MAAM,UAAU,GAAG,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;QAE7D,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAExB,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAEnD,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAEjD,EAAE;QACF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAEvC,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC,UAAU,EACV,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;YAElD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC,EACD,MAAM,EAAE,CACT,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjC,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEzB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAEpE,EAAE;QACF,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvD,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAElC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/messages/index.d.ts

@@ -0,0 +1,11 @@
+export type SessionMessage = SessionMessageRequest | SessionMessageResponse;
+export type SessionMessageRequest = {
+    type: "request";
+    messageId: string;
+    payload: object | string;
+};
+export type SessionMessageResponse = {
+    type: "response";
+    messageId: string;
+    payload: object | string;
+};

package/dist/messages/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/messages/index.js.map

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

package/dist/utils/log.d.ts

@@ -0,0 +1 @@
+export declare const log: (...x: Parameters<typeof console.log>) => void;

package/dist/utils/log.js

@@ -0,0 +1,5 @@
+export const log = (...x) => console.log("[session]", 
+// "color: orange; font-weight: bold",
+// "color: inherit; font-weight: normal",
+...x);
+//# sourceMappingURL=log.js.map

package/dist/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/utils/log.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAiC,EAAE,EAAE,CAC1D,OAAO,CAAC,GAAG,CACT,WAAW;AACX,sCAAsC;AACtC,yCAAyC;AACzC,GAAG,CAAC,CACL,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@openlv/session",
+  "version": "0.0.1-beta.10",
+  "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/session"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "Open-Lavatory",
+    "url": "https://github.com/v3xlabs/open-lavatory"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "import": "./dist/provider.js",
+      "default": "./dist/provider.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "eventemitter3": "^5.0.1",
+    "globals": "^16.2.0",
+    "ts-pattern": "^5",
+    "@openlv/core": "0.0.1-beta.8",
+    "@openlv/signaling": "0.0.1-beta.7",
+    "@openlv/transport": "0.0.1-beta.7"
+  },
+  "devDependencies": {
+    "@vitest/browser-playwright": "^4.0.8",
+    "playwright": "1.58.1",
+    "typescript": "^5",
+    "vitest": "^4"
+  },
+  "peerDependencies": {
+    "@wagmi/core": "2",
+    "viem": "2",
+    "wagmi": "2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest"
+  }
+}