@partylayer/vue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PartyLayer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @partylayer/vue
+
+Vue 3 composables for PartyLayer sessions — thin reactive bindings over the
+framework-agnostic [`@partylayer/session`](../session) store. Mirrors
+[`@partylayer/react`](../react)'s session API.
+
+## Install
+
+```bash
+npm install @partylayer/vue @partylayer/session vue
+```
+
+## Usage
+
+Provide a store near the root, then read it from any descendant composable.
+
+```ts
+// main.ts — plugin form
+import { createApp } from 'vue';
+import { createPartyLayerSession } from '@partylayer/vue';
+import App from './App.vue';
+
+createApp(App)
+  .use(createPartyLayerSession({ provider, persistSnapshot: true, broadcast: true }))
+  .mount('#app');
+```
+
+```vue
+<!-- or in a root setup() -->
+<script setup lang="ts">
+import { provideSessionStore, useSession, useAccount } from '@partylayer/vue';
+
+provideSessionStore({ provider /* any CIP0103Provider */, reconnect: { /* … */ } });
+
+const { status, account, networkId, isConnected, connect, disconnect, on } = useSession();
+const { party, chain } = useAccount();
+</script>
+
+<template>
+  <button v-if="!isConnected" @click="connect()">Connect</button>
+  <div v-else>{{ party }} · {{ networkId }} <button @click="disconnect()">Disconnect</button></div>
+</template>
+```
+
+Side-effects on session transitions:
+
+```ts
+import { useAccountEffect } from '@partylayer/vue';
+
+useAccountEffect({
+  onConnect: ({ account }) => {/* … */},
+  onDisconnect: () => {/* … */},
+  onPartyChanged: ({ previous, current }) => {/* invalidate caches */},
+});
+```
+
+## Composables
+
+- **`useSession()`** → reactive `SessionState` (`status`, `account`, `accounts`,
+  `networkId`, `lastError`, `isConnected`/`isConnecting`/`isReconnecting`/
+  `isDisconnected`) plus actions `connect` / `disconnect` / `restore` and the
+  narrowed event subscription `on(event, handler)`.
+- **`useAccount()`** → reactive `{ party, address, account, accounts, status,
+  isConnected, …, networkId, chain, lastError }`.
+- **`useAccountEffect({ onConnect, onDisconnect, onPartyChanged })`** →
+  fire-and-forget side-effects; auto-cleans on scope teardown.
+
+## Provisioning
+
+- **`provideSessionStore(config)`** — core; call in a `setup()`.
+- **`createPartyLayerSession(config)`** — a thin Vue plugin (`app.use(...)`)
+  over the same provide (single source of truth).
+
+`config` is **either** a pre-built `SessionStore` **or**
+`{ provider: CIP0103Provider } & SessionStoreOptions`.
+
+**Ownership rule:** when built from config, this layer owns the lifecycle —
+`init()` runs **client-only** (on mount), `destroy()` on scope/app teardown. A
+**pre-built** store's lifecycle belongs to you; it is never `init()`/`destroy()`d
+here.
+
+SSR-safe: the store is constructed without DOM access and `init()` is deferred to
+the client; with no provided store, composables report a disconnected session and
+the actions are no-ops.
+
+## React ↔ Vue parity (deviations flagged)
+
+| `@partylayer/react` | `@partylayer/vue` | Deviation |
+|---|---|---|
+| `useSession()` → plain values | `useSession()` → **Vue refs** (`ComputedRef`) | **Returns refs** — access `.value` (or auto-unwrap in templates); destructuring keeps reactivity |
+| `useAccount()` → plain values | `useAccount()` → **Vue refs** | same — refs, not plain values |
+| `useAccountEffect({…})` | `useAccountEffect({…})` | identical handler shape; Vue cleans up via `onScopeDispose` |
+| `<PartyLayerProvider>` / `<PartyLayerKit>` (components) | **`provideSessionStore()`** / **`createPartyLayerSession()` plugin** | Vue uses provide-inject / a plugin, not a wrapper component |
+| `useClientSession()` (legacy SDK getter) | — | **not ported** (Vue has no legacy SDK-session layer) |
+
+`connect(params?)` mirrors the store's own signature exactly
+(`params?: Record<string, unknown>`).

package/dist/index.d.mts

@@ -0,0 +1,119 @@
+import { InjectionKey, Plugin, ComputedRef } from 'vue';
+import { SessionStore, SessionStoreOptions, SessionAccount, SessionStatus, SessionState, SessionEvent } from '@partylayer/session';
+import { CIP0103Provider } from '@partylayer/core';
+
+/**
+ * Session store provisioning for Vue — `provideSessionStore` (the core) and a
+ * thin `createPartyLayerSession` plugin that wraps the same provide, so there is
+ * a single source of truth (one injection key, one store-resolution path).
+ *
+ * Ownership rule:
+ *   - Built from config → THIS layer owns the lifecycle: `init()` runs
+ *     client-only (`onMounted`), `destroy()` on scope/app teardown.
+ *   - A PRE-BUILT store → its lifecycle belongs to the caller; we NEVER
+ *     `init()`/`destroy()` it.
+ *
+ * SSR-safe: the store is constructed without DOM access; `init()` is deferred to
+ * `onMounted` (client only), so server rendering never touches the wallet.
+ */
+
+/** Injection key for the shared session store (or `null` when none provided). */
+declare const SESSION_STORE_KEY: InjectionKey<SessionStore | null>;
+/** Either a pre-built store, or config to build one (provider + store options). */
+type ProvideSessionConfig = SessionStore | ({
+    provider: CIP0103Provider;
+} & Partial<SessionStoreOptions>);
+/**
+ * Provide a session store to descendant composables. Call in a component
+ * `setup()` (e.g. your root). Returns the store for direct use if needed.
+ *
+ * When built from config, lifecycle is owned here (client-only `init()` on
+ * mount, `destroy()` on scope teardown). A pre-built store is left untouched.
+ */
+declare function provideSessionStore(config: ProvideSessionConfig): SessionStore;
+/**
+ * Vue plugin form — a THIN wrapper over the same provide/resolution, for
+ * `app.use(...)`. Owned stores `init()` on the client at install and `destroy()`
+ * when the app unmounts.
+ */
+declare function createPartyLayerSession(config: ProvideSessionConfig): Plugin;
+/** Internal: read the provided store, or `null` if none (SSR / outside provider). */
+declare function injectSessionStore(): SessionStore | null;
+
+/**
+ * Vue composables over the `@partylayer/session` store. Wagmi/React parity:
+ * `useSession` (reactive state + actions), `useAccount`, `useAccountEffect`.
+ *
+ * Each composable derives individual `ComputedRef`s from ONE internal
+ * `shallowRef<SessionState>` fed by a single `store.subscribe`, cleaned up via
+ * `onScopeDispose` (no leak after unmount). Returning refs — not a `reactive()`
+ * object — means destructuring keeps reactivity.
+ *
+ * SSR-safe: with no provided store the refs report a disconnected session and
+ * the actions are no-ops; nothing touches `window`.
+ */
+
+/** wagmi-parity chain handle derived from the CAIP-2 networkId. */
+interface SessionChain {
+    id: string;
+}
+interface UseSessionReturn {
+    status: ComputedRef<SessionStatus>;
+    account: ComputedRef<SessionAccount | null>;
+    accounts: ComputedRef<readonly SessionAccount[]>;
+    networkId: ComputedRef<string | null>;
+    lastError: ComputedRef<Error | null>;
+    isConnected: ComputedRef<boolean>;
+    isConnecting: ComputedRef<boolean>;
+    isReconnecting: ComputedRef<boolean>;
+    isDisconnected: ComputedRef<boolean>;
+    /** Connect via the store (mirrors the store's own signature exactly). */
+    connect(params?: Record<string, unknown>): Promise<SessionState>;
+    disconnect(): Promise<void>;
+    restore(): Promise<SessionState>;
+    /** Subscribe to a structured resilience/sync event (narrowed by `event`). */
+    on<T extends SessionEvent['type']>(event: T, handler: (event: Extract<SessionEvent, {
+        type: T;
+    }>) => void): () => void;
+}
+/** Reactive session state + bound actions. */
+declare function useSession(): UseSessionReturn;
+interface UseAccountReturn {
+    party: ComputedRef<string | null>;
+    /** wagmi-parity alias of `party`. */
+    address: ComputedRef<string | null>;
+    account: ComputedRef<SessionAccount | null>;
+    accounts: ComputedRef<readonly SessionAccount[]>;
+    status: ComputedRef<SessionStatus>;
+    isConnected: ComputedRef<boolean>;
+    isConnecting: ComputedRef<boolean>;
+    isReconnecting: ComputedRef<boolean>;
+    isDisconnected: ComputedRef<boolean>;
+    networkId: ComputedRef<string | null>;
+    chain: ComputedRef<SessionChain | null>;
+    lastError: ComputedRef<Error | null>;
+}
+/** Reactive active-account view (wagmi parity). */
+declare function useAccount(): UseAccountReturn;
+interface UseAccountEffectParameters {
+    /** Fired on a transition INTO `connected` (once the account is available). */
+    onConnect?: (data: {
+        account: SessionAccount | null;
+        accounts: readonly SessionAccount[];
+        networkId: string | null;
+    }) => void;
+    /** Fired on a transition `connected → disconnected`. */
+    onDisconnect?: () => void;
+    /** Fired when the active PRIMARY party changes (a switch, not a reorder). */
+    onPartyChanged?: (data: {
+        previous: string | null;
+        current: string | null;
+    }) => void;
+}
+/**
+ * Fire side-effects on session transitions — no render churn. Auto-cleans on
+ * scope teardown (`onScopeDispose`). No-op when no store is provided.
+ */
+declare function useAccountEffect(parameters?: UseAccountEffectParameters): void;
+
+export { type ProvideSessionConfig, SESSION_STORE_KEY, type SessionChain, type UseAccountEffectParameters, type UseAccountReturn, type UseSessionReturn, createPartyLayerSession, injectSessionStore, provideSessionStore, useAccount, useAccountEffect, useSession };

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+import { InjectionKey, Plugin, ComputedRef } from 'vue';
+import { SessionStore, SessionStoreOptions, SessionAccount, SessionStatus, SessionState, SessionEvent } from '@partylayer/session';
+import { CIP0103Provider } from '@partylayer/core';
+
+/**
+ * Session store provisioning for Vue — `provideSessionStore` (the core) and a
+ * thin `createPartyLayerSession` plugin that wraps the same provide, so there is
+ * a single source of truth (one injection key, one store-resolution path).
+ *
+ * Ownership rule:
+ *   - Built from config → THIS layer owns the lifecycle: `init()` runs
+ *     client-only (`onMounted`), `destroy()` on scope/app teardown.
+ *   - A PRE-BUILT store → its lifecycle belongs to the caller; we NEVER
+ *     `init()`/`destroy()` it.
+ *
+ * SSR-safe: the store is constructed without DOM access; `init()` is deferred to
+ * `onMounted` (client only), so server rendering never touches the wallet.
+ */
+
+/** Injection key for the shared session store (or `null` when none provided). */
+declare const SESSION_STORE_KEY: InjectionKey<SessionStore | null>;
+/** Either a pre-built store, or config to build one (provider + store options). */
+type ProvideSessionConfig = SessionStore | ({
+    provider: CIP0103Provider;
+} & Partial<SessionStoreOptions>);
+/**
+ * Provide a session store to descendant composables. Call in a component
+ * `setup()` (e.g. your root). Returns the store for direct use if needed.
+ *
+ * When built from config, lifecycle is owned here (client-only `init()` on
+ * mount, `destroy()` on scope teardown). A pre-built store is left untouched.
+ */
+declare function provideSessionStore(config: ProvideSessionConfig): SessionStore;
+/**
+ * Vue plugin form — a THIN wrapper over the same provide/resolution, for
+ * `app.use(...)`. Owned stores `init()` on the client at install and `destroy()`
+ * when the app unmounts.
+ */
+declare function createPartyLayerSession(config: ProvideSessionConfig): Plugin;
+/** Internal: read the provided store, or `null` if none (SSR / outside provider). */
+declare function injectSessionStore(): SessionStore | null;
+
+/**
+ * Vue composables over the `@partylayer/session` store. Wagmi/React parity:
+ * `useSession` (reactive state + actions), `useAccount`, `useAccountEffect`.
+ *
+ * Each composable derives individual `ComputedRef`s from ONE internal
+ * `shallowRef<SessionState>` fed by a single `store.subscribe`, cleaned up via
+ * `onScopeDispose` (no leak after unmount). Returning refs — not a `reactive()`
+ * object — means destructuring keeps reactivity.
+ *
+ * SSR-safe: with no provided store the refs report a disconnected session and
+ * the actions are no-ops; nothing touches `window`.
+ */
+
+/** wagmi-parity chain handle derived from the CAIP-2 networkId. */
+interface SessionChain {
+    id: string;
+}
+interface UseSessionReturn {
+    status: ComputedRef<SessionStatus>;
+    account: ComputedRef<SessionAccount | null>;
+    accounts: ComputedRef<readonly SessionAccount[]>;
+    networkId: ComputedRef<string | null>;
+    lastError: ComputedRef<Error | null>;
+    isConnected: ComputedRef<boolean>;
+    isConnecting: ComputedRef<boolean>;
+    isReconnecting: ComputedRef<boolean>;
+    isDisconnected: ComputedRef<boolean>;
+    /** Connect via the store (mirrors the store's own signature exactly). */
+    connect(params?: Record<string, unknown>): Promise<SessionState>;
+    disconnect(): Promise<void>;
+    restore(): Promise<SessionState>;
+    /** Subscribe to a structured resilience/sync event (narrowed by `event`). */
+    on<T extends SessionEvent['type']>(event: T, handler: (event: Extract<SessionEvent, {
+        type: T;
+    }>) => void): () => void;
+}
+/** Reactive session state + bound actions. */
+declare function useSession(): UseSessionReturn;
+interface UseAccountReturn {
+    party: ComputedRef<string | null>;
+    /** wagmi-parity alias of `party`. */
+    address: ComputedRef<string | null>;
+    account: ComputedRef<SessionAccount | null>;
+    accounts: ComputedRef<readonly SessionAccount[]>;
+    status: ComputedRef<SessionStatus>;
+    isConnected: ComputedRef<boolean>;
+    isConnecting: ComputedRef<boolean>;
+    isReconnecting: ComputedRef<boolean>;
+    isDisconnected: ComputedRef<boolean>;
+    networkId: ComputedRef<string | null>;
+    chain: ComputedRef<SessionChain | null>;
+    lastError: ComputedRef<Error | null>;
+}
+/** Reactive active-account view (wagmi parity). */
+declare function useAccount(): UseAccountReturn;
+interface UseAccountEffectParameters {
+    /** Fired on a transition INTO `connected` (once the account is available). */
+    onConnect?: (data: {
+        account: SessionAccount | null;
+        accounts: readonly SessionAccount[];
+        networkId: string | null;
+    }) => void;
+    /** Fired on a transition `connected → disconnected`. */
+    onDisconnect?: () => void;
+    /** Fired when the active PRIMARY party changes (a switch, not a reorder). */
+    onPartyChanged?: (data: {
+        previous: string | null;
+        current: string | null;
+    }) => void;
+}
+/**
+ * Fire side-effects on session transitions — no render churn. Auto-cleans on
+ * scope teardown (`onScopeDispose`). No-op when no store is provided.
+ */
+declare function useAccountEffect(parameters?: UseAccountEffectParameters): void;
+
+export { type ProvideSessionConfig, SESSION_STORE_KEY, type SessionChain, type UseAccountEffectParameters, type UseAccountReturn, type UseSessionReturn, createPartyLayerSession, injectSessionStore, provideSessionStore, useAccount, useAccountEffect, useSession };

package/dist/index.js

@@ -0,0 +1,149 @@
+'use strict';
+
+var vue = require('vue');
+var session = require('@partylayer/session');
+
+// src/provide.ts
+var SESSION_STORE_KEY = /* @__PURE__ */ Symbol("partylayer.session.store");
+function isStore(config) {
+  return typeof config.getSnapshot === "function";
+}
+function resolveStore(config) {
+  if (isStore(config)) return { store: config, owned: false };
+  const { provider, ...options } = config;
+  return { store: session.createSessionStore(provider, options), owned: true };
+}
+function provideSessionStore(config) {
+  const { store, owned } = resolveStore(config);
+  vue.provide(SESSION_STORE_KEY, store);
+  if (owned) {
+    vue.onMounted(() => {
+      void store.init();
+    });
+    vue.onScopeDispose(() => {
+      store.destroy();
+    });
+  }
+  return store;
+}
+function createPartyLayerSession(config) {
+  return {
+    install(app) {
+      const { store, owned } = resolveStore(config);
+      app.provide(SESSION_STORE_KEY, store);
+      if (owned) {
+        if (typeof window !== "undefined") void store.init();
+        const unmount = app.unmount.bind(app);
+        app.unmount = () => {
+          try {
+            store.destroy();
+          } finally {
+            unmount();
+          }
+        };
+      }
+    }
+  };
+}
+function injectSessionStore() {
+  return vue.inject(SESSION_STORE_KEY, null);
+}
+var DISCONNECTED = {
+  status: "disconnected",
+  account: null,
+  accounts: [],
+  networkId: null,
+  lastError: null
+};
+function useSessionState() {
+  const store = injectSessionStore();
+  const state = vue.shallowRef(store ? store.getSnapshot() : DISCONNECTED);
+  if (store) {
+    const unsubscribe = store.subscribe(() => {
+      state.value = store.getSnapshot();
+    });
+    vue.onScopeDispose(unsubscribe);
+  }
+  return { store, state };
+}
+function useSession() {
+  const { store, state } = useSessionState();
+  return {
+    status: vue.computed(() => state.value.status),
+    account: vue.computed(() => state.value.account),
+    accounts: vue.computed(() => state.value.accounts),
+    networkId: vue.computed(() => state.value.networkId),
+    lastError: vue.computed(() => state.value.lastError),
+    isConnected: vue.computed(() => state.value.status === "connected"),
+    isConnecting: vue.computed(() => state.value.status === "connecting"),
+    isReconnecting: vue.computed(() => state.value.status === "reconnecting"),
+    isDisconnected: vue.computed(() => state.value.status === "disconnected"),
+    connect: (params) => store ? store.connect(params) : Promise.resolve(DISCONNECTED),
+    disconnect: () => store ? store.disconnect() : Promise.resolve(),
+    restore: () => store ? store.restore() : Promise.resolve(DISCONNECTED),
+    on: (event, handler) => store ? store.on(event, handler) : () => {
+    }
+  };
+}
+function useAccount() {
+  const { state } = useSessionState();
+  const party = vue.computed(() => state.value.account?.partyId ?? null);
+  return {
+    party,
+    address: party,
+    account: vue.computed(() => state.value.account),
+    accounts: vue.computed(() => state.value.accounts),
+    status: vue.computed(() => state.value.status),
+    isConnected: vue.computed(() => state.value.status === "connected"),
+    isConnecting: vue.computed(() => state.value.status === "connecting"),
+    isReconnecting: vue.computed(() => state.value.status === "reconnecting"),
+    isDisconnected: vue.computed(() => state.value.status === "disconnected"),
+    networkId: vue.computed(() => state.value.networkId),
+    chain: vue.computed(() => state.value.networkId ? { id: state.value.networkId } : null),
+    lastError: vue.computed(() => state.value.lastError)
+  };
+}
+function useAccountEffect(parameters = {}) {
+  const store = injectSessionStore();
+  if (!store) return;
+  let prev = store.getSnapshot().status;
+  let firedConnect = false;
+  const unsubscribe = store.subscribe(() => {
+    const next = store.getSnapshot();
+    const was = prev;
+    const now = next.status;
+    prev = now;
+    if (now === "connected") {
+      if (!firedConnect && next.account) {
+        firedConnect = true;
+        parameters.onConnect?.({
+          account: next.account,
+          accounts: next.accounts,
+          networkId: next.networkId
+        });
+      }
+    } else if (now === "disconnected" && (was === "connected" || firedConnect)) {
+      firedConnect = false;
+      parameters.onDisconnect?.();
+    }
+  });
+  const unsubscribeParty = store.on("party:changed", (e) => {
+    if (e.type === "party:changed") {
+      parameters.onPartyChanged?.({ previous: e.previous, current: e.current });
+    }
+  });
+  vue.onScopeDispose(() => {
+    unsubscribe();
+    unsubscribeParty();
+  });
+}
+
+exports.SESSION_STORE_KEY = SESSION_STORE_KEY;
+exports.createPartyLayerSession = createPartyLayerSession;
+exports.injectSessionStore = injectSessionStore;
+exports.provideSessionStore = provideSessionStore;
+exports.useAccount = useAccount;
+exports.useAccountEffect = useAccountEffect;
+exports.useSession = useSession;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provide.ts","../src/composables.ts"],"names":["createSessionStore","provide","onMounted","onScopeDispose","inject","shallowRef","computed"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Session store provisioning for Vue — `provideSessionStore` (the core) and a\n * thin `createPartyLayerSession` plugin that wraps the same provide, so there is\n * a single source of truth (one injection key, one store-resolution path).\n *\n * Ownership rule:\n *   - Built from config → THIS layer owns the lifecycle: `init()` runs\n *     client-only (`onMounted`), `destroy()` on scope/app teardown.\n *   - A PRE-BUILT store → its lifecycle belongs to the caller; we NEVER\n *     `init()`/`destroy()` it.\n *\n * SSR-safe: the store is constructed without DOM access; `init()` is deferred to\n * `onMounted` (client only), so server rendering never touches the wallet.\n */\nimport { inject, onMounted, onScopeDispose, provide, type App, type InjectionKey, type Plugin } from 'vue';\nimport { createSessionStore, type SessionStore, type SessionStoreOptions } from '@partylayer/session';\nimport type { CIP0103Provider } from '@partylayer/core';\n\n/** Injection key for the shared session store (or `null` when none provided). */\nexport const SESSION_STORE_KEY: InjectionKey<SessionStore | null> = Symbol('partylayer.session.store');\n\n/** Either a pre-built store, or config to build one (provider + store options). */\nexport type ProvideSessionConfig =\n  | SessionStore\n  | ({ provider: CIP0103Provider } & Partial<SessionStoreOptions>);\n\nfunction isStore(config: ProvideSessionConfig): config is SessionStore {\n  return typeof (config as SessionStore).getSnapshot === 'function';\n}\n\n/** Resolve a config into a store + whether THIS layer owns its lifecycle. */\nfunction resolveStore(config: ProvideSessionConfig): { store: SessionStore; owned: boolean } {\n  if (isStore(config)) return { store: config, owned: false };\n  const { provider, ...options } = config;\n  return { store: createSessionStore(provider, options), owned: true };\n}\n\n/**\n * Provide a session store to descendant composables. Call in a component\n * `setup()` (e.g. your root). Returns the store for direct use if needed.\n *\n * When built from config, lifecycle is owned here (client-only `init()` on\n * mount, `destroy()` on scope teardown). A pre-built store is left untouched.\n */\nexport function provideSessionStore(config: ProvideSessionConfig): SessionStore {\n  const { store, owned } = resolveStore(config);\n  provide(SESSION_STORE_KEY, store);\n  if (owned) {\n    // Client-only restore/reconnect; never runs during SSR.\n    onMounted(() => {\n      void store.init();\n    });\n    onScopeDispose(() => {\n      store.destroy();\n    });\n  }\n  return store;\n}\n\n/**\n * Vue plugin form — a THIN wrapper over the same provide/resolution, for\n * `app.use(...)`. Owned stores `init()` on the client at install and `destroy()`\n * when the app unmounts.\n */\nexport function createPartyLayerSession(config: ProvideSessionConfig): Plugin {\n  return {\n    install(app: App) {\n      const { store, owned } = resolveStore(config);\n      app.provide(SESSION_STORE_KEY, store);\n      if (owned) {\n        if (typeof window !== 'undefined') void store.init(); // client only (SSR-safe)\n        const unmount = app.unmount.bind(app);\n        app.unmount = () => {\n          try {\n            store.destroy();\n          } finally {\n            unmount();\n          }\n        };\n      }\n    },\n  };\n}\n\n/** Internal: read the provided store, or `null` if none (SSR / outside provider). */\nexport function injectSessionStore(): SessionStore | null {\n  return inject(SESSION_STORE_KEY, null);\n}\n","/**\n * Vue composables over the `@partylayer/session` store. Wagmi/React parity:\n * `useSession` (reactive state + actions), `useAccount`, `useAccountEffect`.\n *\n * Each composable derives individual `ComputedRef`s from ONE internal\n * `shallowRef<SessionState>` fed by a single `store.subscribe`, cleaned up via\n * `onScopeDispose` (no leak after unmount). Returning refs — not a `reactive()`\n * object — means destructuring keeps reactivity.\n *\n * SSR-safe: with no provided store the refs report a disconnected session and\n * the actions are no-ops; nothing touches `window`.\n */\nimport { computed, onScopeDispose, shallowRef, type ComputedRef } from 'vue';\nimport type {\n  SessionAccount,\n  SessionEvent,\n  SessionState,\n  SessionStatus,\n} from '@partylayer/session';\nimport { injectSessionStore } from './provide';\n\nconst DISCONNECTED: SessionState = {\n  status: 'disconnected',\n  account: null,\n  accounts: [],\n  networkId: null,\n  lastError: null,\n};\n\n/** Subscribe ONCE to the provided store; returns a reactive snapshot ref. */\nfunction useSessionState() {\n  const store = injectSessionStore();\n  const state = shallowRef<SessionState>(store ? store.getSnapshot() : DISCONNECTED);\n  if (store) {\n    const unsubscribe = store.subscribe(() => {\n      state.value = store.getSnapshot();\n    });\n    onScopeDispose(unsubscribe);\n  }\n  return { store, state };\n}\n\n/** wagmi-parity chain handle derived from the CAIP-2 networkId. */\nexport interface SessionChain {\n  id: string;\n}\n\nexport interface UseSessionReturn {\n  status: ComputedRef<SessionStatus>;\n  account: ComputedRef<SessionAccount | null>;\n  accounts: ComputedRef<readonly SessionAccount[]>;\n  networkId: ComputedRef<string | null>;\n  lastError: ComputedRef<Error | null>;\n  isConnected: ComputedRef<boolean>;\n  isConnecting: ComputedRef<boolean>;\n  isReconnecting: ComputedRef<boolean>;\n  isDisconnected: ComputedRef<boolean>;\n  /** Connect via the store (mirrors the store's own signature exactly). */\n  connect(params?: Record<string, unknown>): Promise<SessionState>;\n  disconnect(): Promise<void>;\n  restore(): Promise<SessionState>;\n  /** Subscribe to a structured resilience/sync event (narrowed by `event`). */\n  on<T extends SessionEvent['type']>(\n    event: T,\n    handler: (event: Extract<SessionEvent, { type: T }>) => void,\n  ): () => void;\n}\n\n/** Reactive session state + bound actions. */\nexport function useSession(): UseSessionReturn {\n  const { store, state } = useSessionState();\n  return {\n    status: computed(() => state.value.status),\n    account: computed(() => state.value.account),\n    accounts: computed(() => state.value.accounts),\n    networkId: computed(() => state.value.networkId),\n    lastError: computed(() => state.value.lastError),\n    isConnected: computed(() => state.value.status === 'connected'),\n    isConnecting: computed(() => state.value.status === 'connecting'),\n    isReconnecting: computed(() => state.value.status === 'reconnecting'),\n    isDisconnected: computed(() => state.value.status === 'disconnected'),\n    connect: (params?: Record<string, unknown>) =>\n      store ? store.connect(params) : Promise.resolve(DISCONNECTED),\n    disconnect: () => (store ? store.disconnect() : Promise.resolve()),\n    restore: () => (store ? store.restore() : Promise.resolve(DISCONNECTED)),\n    on: <T extends SessionEvent['type']>(\n      event: T,\n      handler: (event: Extract<SessionEvent, { type: T }>) => void,\n    ): (() => void) => (store ? store.on(event, handler as (e: SessionEvent) => void) : () => {}),\n  };\n}\n\nexport interface UseAccountReturn {\n  party: ComputedRef<string | null>;\n  /** wagmi-parity alias of `party`. */\n  address: ComputedRef<string | null>;\n  account: ComputedRef<SessionAccount | null>;\n  accounts: ComputedRef<readonly SessionAccount[]>;\n  status: ComputedRef<SessionStatus>;\n  isConnected: ComputedRef<boolean>;\n  isConnecting: ComputedRef<boolean>;\n  isReconnecting: ComputedRef<boolean>;\n  isDisconnected: ComputedRef<boolean>;\n  networkId: ComputedRef<string | null>;\n  chain: ComputedRef<SessionChain | null>;\n  lastError: ComputedRef<Error | null>;\n}\n\n/** Reactive active-account view (wagmi parity). */\nexport function useAccount(): UseAccountReturn {\n  const { state } = useSessionState();\n  const party = computed(() => state.value.account?.partyId ?? null);\n  return {\n    party,\n    address: party,\n    account: computed(() => state.value.account),\n    accounts: computed(() => state.value.accounts),\n    status: computed(() => state.value.status),\n    isConnected: computed(() => state.value.status === 'connected'),\n    isConnecting: computed(() => state.value.status === 'connecting'),\n    isReconnecting: computed(() => state.value.status === 'reconnecting'),\n    isDisconnected: computed(() => state.value.status === 'disconnected'),\n    networkId: computed(() => state.value.networkId),\n    chain: computed(() => (state.value.networkId ? { id: state.value.networkId } : null)),\n    lastError: computed(() => state.value.lastError),\n  };\n}\n\nexport interface UseAccountEffectParameters {\n  /** Fired on a transition INTO `connected` (once the account is available). */\n  onConnect?: (data: {\n    account: SessionAccount | null;\n    accounts: readonly SessionAccount[];\n    networkId: string | null;\n  }) => void;\n  /** Fired on a transition `connected → disconnected`. */\n  onDisconnect?: () => void;\n  /** Fired when the active PRIMARY party changes (a switch, not a reorder). */\n  onPartyChanged?: (data: { previous: string | null; current: string | null }) => void;\n}\n\n/**\n * Fire side-effects on session transitions — no render churn. Auto-cleans on\n * scope teardown (`onScopeDispose`). No-op when no store is provided.\n */\nexport function useAccountEffect(parameters: UseAccountEffectParameters = {}): void {\n  const store = injectSessionStore();\n  if (!store) return;\n\n  let prev: SessionStatus = store.getSnapshot().status;\n  // statusChanged(connected) can arrive BEFORE accountsChanged, so fire\n  // onConnect once per session on the tick the account becomes available.\n  let firedConnect = false;\n\n  const unsubscribe = store.subscribe(() => {\n    const next = store.getSnapshot();\n    const was = prev;\n    const now = next.status;\n    prev = now;\n    if (now === 'connected') {\n      if (!firedConnect && next.account) {\n        firedConnect = true;\n        parameters.onConnect?.({\n          account: next.account,\n          accounts: next.accounts,\n          networkId: next.networkId,\n        });\n      }\n    } else if (now === 'disconnected' && (was === 'connected' || firedConnect)) {\n      firedConnect = false;\n      parameters.onDisconnect?.();\n    }\n  });\n\n  const unsubscribeParty = store.on('party:changed', (e) => {\n    if (e.type === 'party:changed') {\n      parameters.onPartyChanged?.({ previous: e.previous, current: e.current });\n    }\n  });\n\n  onScopeDispose(() => {\n    unsubscribe();\n    unsubscribeParty();\n  });\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,141 @@
+import { provide, onMounted, onScopeDispose, inject, computed, shallowRef } from 'vue';
+import { createSessionStore } from '@partylayer/session';
+
+// src/provide.ts
+var SESSION_STORE_KEY = /* @__PURE__ */ Symbol("partylayer.session.store");
+function isStore(config) {
+  return typeof config.getSnapshot === "function";
+}
+function resolveStore(config) {
+  if (isStore(config)) return { store: config, owned: false };
+  const { provider, ...options } = config;
+  return { store: createSessionStore(provider, options), owned: true };
+}
+function provideSessionStore(config) {
+  const { store, owned } = resolveStore(config);
+  provide(SESSION_STORE_KEY, store);
+  if (owned) {
+    onMounted(() => {
+      void store.init();
+    });
+    onScopeDispose(() => {
+      store.destroy();
+    });
+  }
+  return store;
+}
+function createPartyLayerSession(config) {
+  return {
+    install(app) {
+      const { store, owned } = resolveStore(config);
+      app.provide(SESSION_STORE_KEY, store);
+      if (owned) {
+        if (typeof window !== "undefined") void store.init();
+        const unmount = app.unmount.bind(app);
+        app.unmount = () => {
+          try {
+            store.destroy();
+          } finally {
+            unmount();
+          }
+        };
+      }
+    }
+  };
+}
+function injectSessionStore() {
+  return inject(SESSION_STORE_KEY, null);
+}
+var DISCONNECTED = {
+  status: "disconnected",
+  account: null,
+  accounts: [],
+  networkId: null,
+  lastError: null
+};
+function useSessionState() {
+  const store = injectSessionStore();
+  const state = shallowRef(store ? store.getSnapshot() : DISCONNECTED);
+  if (store) {
+    const unsubscribe = store.subscribe(() => {
+      state.value = store.getSnapshot();
+    });
+    onScopeDispose(unsubscribe);
+  }
+  return { store, state };
+}
+function useSession() {
+  const { store, state } = useSessionState();
+  return {
+    status: computed(() => state.value.status),
+    account: computed(() => state.value.account),
+    accounts: computed(() => state.value.accounts),
+    networkId: computed(() => state.value.networkId),
+    lastError: computed(() => state.value.lastError),
+    isConnected: computed(() => state.value.status === "connected"),
+    isConnecting: computed(() => state.value.status === "connecting"),
+    isReconnecting: computed(() => state.value.status === "reconnecting"),
+    isDisconnected: computed(() => state.value.status === "disconnected"),
+    connect: (params) => store ? store.connect(params) : Promise.resolve(DISCONNECTED),
+    disconnect: () => store ? store.disconnect() : Promise.resolve(),
+    restore: () => store ? store.restore() : Promise.resolve(DISCONNECTED),
+    on: (event, handler) => store ? store.on(event, handler) : () => {
+    }
+  };
+}
+function useAccount() {
+  const { state } = useSessionState();
+  const party = computed(() => state.value.account?.partyId ?? null);
+  return {
+    party,
+    address: party,
+    account: computed(() => state.value.account),
+    accounts: computed(() => state.value.accounts),
+    status: computed(() => state.value.status),
+    isConnected: computed(() => state.value.status === "connected"),
+    isConnecting: computed(() => state.value.status === "connecting"),
+    isReconnecting: computed(() => state.value.status === "reconnecting"),
+    isDisconnected: computed(() => state.value.status === "disconnected"),
+    networkId: computed(() => state.value.networkId),
+    chain: computed(() => state.value.networkId ? { id: state.value.networkId } : null),
+    lastError: computed(() => state.value.lastError)
+  };
+}
+function useAccountEffect(parameters = {}) {
+  const store = injectSessionStore();
+  if (!store) return;
+  let prev = store.getSnapshot().status;
+  let firedConnect = false;
+  const unsubscribe = store.subscribe(() => {
+    const next = store.getSnapshot();
+    const was = prev;
+    const now = next.status;
+    prev = now;
+    if (now === "connected") {
+      if (!firedConnect && next.account) {
+        firedConnect = true;
+        parameters.onConnect?.({
+          account: next.account,
+          accounts: next.accounts,
+          networkId: next.networkId
+        });
+      }
+    } else if (now === "disconnected" && (was === "connected" || firedConnect)) {
+      firedConnect = false;
+      parameters.onDisconnect?.();
+    }
+  });
+  const unsubscribeParty = store.on("party:changed", (e) => {
+    if (e.type === "party:changed") {
+      parameters.onPartyChanged?.({ previous: e.previous, current: e.current });
+    }
+  });
+  onScopeDispose(() => {
+    unsubscribe();
+    unsubscribeParty();
+  });
+}
+
+export { SESSION_STORE_KEY, createPartyLayerSession, injectSessionStore, provideSessionStore, useAccount, useAccountEffect, useSession };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provide.ts","../src/composables.ts"],"names":["onScopeDispose"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Session store provisioning for Vue — `provideSessionStore` (the core) and a\n * thin `createPartyLayerSession` plugin that wraps the same provide, so there is\n * a single source of truth (one injection key, one store-resolution path).\n *\n * Ownership rule:\n *   - Built from config → THIS layer owns the lifecycle: `init()` runs\n *     client-only (`onMounted`), `destroy()` on scope/app teardown.\n *   - A PRE-BUILT store → its lifecycle belongs to the caller; we NEVER\n *     `init()`/`destroy()` it.\n *\n * SSR-safe: the store is constructed without DOM access; `init()` is deferred to\n * `onMounted` (client only), so server rendering never touches the wallet.\n */\nimport { inject, onMounted, onScopeDispose, provide, type App, type InjectionKey, type Plugin } from 'vue';\nimport { createSessionStore, type SessionStore, type SessionStoreOptions } from '@partylayer/session';\nimport type { CIP0103Provider } from '@partylayer/core';\n\n/** Injection key for the shared session store (or `null` when none provided). */\nexport const SESSION_STORE_KEY: InjectionKey<SessionStore | null> = Symbol('partylayer.session.store');\n\n/** Either a pre-built store, or config to build one (provider + store options). */\nexport type ProvideSessionConfig =\n  | SessionStore\n  | ({ provider: CIP0103Provider } & Partial<SessionStoreOptions>);\n\nfunction isStore(config: ProvideSessionConfig): config is SessionStore {\n  return typeof (config as SessionStore).getSnapshot === 'function';\n}\n\n/** Resolve a config into a store + whether THIS layer owns its lifecycle. */\nfunction resolveStore(config: ProvideSessionConfig): { store: SessionStore; owned: boolean } {\n  if (isStore(config)) return { store: config, owned: false };\n  const { provider, ...options } = config;\n  return { store: createSessionStore(provider, options), owned: true };\n}\n\n/**\n * Provide a session store to descendant composables. Call in a component\n * `setup()` (e.g. your root). Returns the store for direct use if needed.\n *\n * When built from config, lifecycle is owned here (client-only `init()` on\n * mount, `destroy()` on scope teardown). A pre-built store is left untouched.\n */\nexport function provideSessionStore(config: ProvideSessionConfig): SessionStore {\n  const { store, owned } = resolveStore(config);\n  provide(SESSION_STORE_KEY, store);\n  if (owned) {\n    // Client-only restore/reconnect; never runs during SSR.\n    onMounted(() => {\n      void store.init();\n    });\n    onScopeDispose(() => {\n      store.destroy();\n    });\n  }\n  return store;\n}\n\n/**\n * Vue plugin form — a THIN wrapper over the same provide/resolution, for\n * `app.use(...)`. Owned stores `init()` on the client at install and `destroy()`\n * when the app unmounts.\n */\nexport function createPartyLayerSession(config: ProvideSessionConfig): Plugin {\n  return {\n    install(app: App) {\n      const { store, owned } = resolveStore(config);\n      app.provide(SESSION_STORE_KEY, store);\n      if (owned) {\n        if (typeof window !== 'undefined') void store.init(); // client only (SSR-safe)\n        const unmount = app.unmount.bind(app);\n        app.unmount = () => {\n          try {\n            store.destroy();\n          } finally {\n            unmount();\n          }\n        };\n      }\n    },\n  };\n}\n\n/** Internal: read the provided store, or `null` if none (SSR / outside provider). */\nexport function injectSessionStore(): SessionStore | null {\n  return inject(SESSION_STORE_KEY, null);\n}\n","/**\n * Vue composables over the `@partylayer/session` store. Wagmi/React parity:\n * `useSession` (reactive state + actions), `useAccount`, `useAccountEffect`.\n *\n * Each composable derives individual `ComputedRef`s from ONE internal\n * `shallowRef<SessionState>` fed by a single `store.subscribe`, cleaned up via\n * `onScopeDispose` (no leak after unmount). Returning refs — not a `reactive()`\n * object — means destructuring keeps reactivity.\n *\n * SSR-safe: with no provided store the refs report a disconnected session and\n * the actions are no-ops; nothing touches `window`.\n */\nimport { computed, onScopeDispose, shallowRef, type ComputedRef } from 'vue';\nimport type {\n  SessionAccount,\n  SessionEvent,\n  SessionState,\n  SessionStatus,\n} from '@partylayer/session';\nimport { injectSessionStore } from './provide';\n\nconst DISCONNECTED: SessionState = {\n  status: 'disconnected',\n  account: null,\n  accounts: [],\n  networkId: null,\n  lastError: null,\n};\n\n/** Subscribe ONCE to the provided store; returns a reactive snapshot ref. */\nfunction useSessionState() {\n  const store = injectSessionStore();\n  const state = shallowRef<SessionState>(store ? store.getSnapshot() : DISCONNECTED);\n  if (store) {\n    const unsubscribe = store.subscribe(() => {\n      state.value = store.getSnapshot();\n    });\n    onScopeDispose(unsubscribe);\n  }\n  return { store, state };\n}\n\n/** wagmi-parity chain handle derived from the CAIP-2 networkId. */\nexport interface SessionChain {\n  id: string;\n}\n\nexport interface UseSessionReturn {\n  status: ComputedRef<SessionStatus>;\n  account: ComputedRef<SessionAccount | null>;\n  accounts: ComputedRef<readonly SessionAccount[]>;\n  networkId: ComputedRef<string | null>;\n  lastError: ComputedRef<Error | null>;\n  isConnected: ComputedRef<boolean>;\n  isConnecting: ComputedRef<boolean>;\n  isReconnecting: ComputedRef<boolean>;\n  isDisconnected: ComputedRef<boolean>;\n  /** Connect via the store (mirrors the store's own signature exactly). */\n  connect(params?: Record<string, unknown>): Promise<SessionState>;\n  disconnect(): Promise<void>;\n  restore(): Promise<SessionState>;\n  /** Subscribe to a structured resilience/sync event (narrowed by `event`). */\n  on<T extends SessionEvent['type']>(\n    event: T,\n    handler: (event: Extract<SessionEvent, { type: T }>) => void,\n  ): () => void;\n}\n\n/** Reactive session state + bound actions. */\nexport function useSession(): UseSessionReturn {\n  const { store, state } = useSessionState();\n  return {\n    status: computed(() => state.value.status),\n    account: computed(() => state.value.account),\n    accounts: computed(() => state.value.accounts),\n    networkId: computed(() => state.value.networkId),\n    lastError: computed(() => state.value.lastError),\n    isConnected: computed(() => state.value.status === 'connected'),\n    isConnecting: computed(() => state.value.status === 'connecting'),\n    isReconnecting: computed(() => state.value.status === 'reconnecting'),\n    isDisconnected: computed(() => state.value.status === 'disconnected'),\n    connect: (params?: Record<string, unknown>) =>\n      store ? store.connect(params) : Promise.resolve(DISCONNECTED),\n    disconnect: () => (store ? store.disconnect() : Promise.resolve()),\n    restore: () => (store ? store.restore() : Promise.resolve(DISCONNECTED)),\n    on: <T extends SessionEvent['type']>(\n      event: T,\n      handler: (event: Extract<SessionEvent, { type: T }>) => void,\n    ): (() => void) => (store ? store.on(event, handler as (e: SessionEvent) => void) : () => {}),\n  };\n}\n\nexport interface UseAccountReturn {\n  party: ComputedRef<string | null>;\n  /** wagmi-parity alias of `party`. */\n  address: ComputedRef<string | null>;\n  account: ComputedRef<SessionAccount | null>;\n  accounts: ComputedRef<readonly SessionAccount[]>;\n  status: ComputedRef<SessionStatus>;\n  isConnected: ComputedRef<boolean>;\n  isConnecting: ComputedRef<boolean>;\n  isReconnecting: ComputedRef<boolean>;\n  isDisconnected: ComputedRef<boolean>;\n  networkId: ComputedRef<string | null>;\n  chain: ComputedRef<SessionChain | null>;\n  lastError: ComputedRef<Error | null>;\n}\n\n/** Reactive active-account view (wagmi parity). */\nexport function useAccount(): UseAccountReturn {\n  const { state } = useSessionState();\n  const party = computed(() => state.value.account?.partyId ?? null);\n  return {\n    party,\n    address: party,\n    account: computed(() => state.value.account),\n    accounts: computed(() => state.value.accounts),\n    status: computed(() => state.value.status),\n    isConnected: computed(() => state.value.status === 'connected'),\n    isConnecting: computed(() => state.value.status === 'connecting'),\n    isReconnecting: computed(() => state.value.status === 'reconnecting'),\n    isDisconnected: computed(() => state.value.status === 'disconnected'),\n    networkId: computed(() => state.value.networkId),\n    chain: computed(() => (state.value.networkId ? { id: state.value.networkId } : null)),\n    lastError: computed(() => state.value.lastError),\n  };\n}\n\nexport interface UseAccountEffectParameters {\n  /** Fired on a transition INTO `connected` (once the account is available). */\n  onConnect?: (data: {\n    account: SessionAccount | null;\n    accounts: readonly SessionAccount[];\n    networkId: string | null;\n  }) => void;\n  /** Fired on a transition `connected → disconnected`. */\n  onDisconnect?: () => void;\n  /** Fired when the active PRIMARY party changes (a switch, not a reorder). */\n  onPartyChanged?: (data: { previous: string | null; current: string | null }) => void;\n}\n\n/**\n * Fire side-effects on session transitions — no render churn. Auto-cleans on\n * scope teardown (`onScopeDispose`). No-op when no store is provided.\n */\nexport function useAccountEffect(parameters: UseAccountEffectParameters = {}): void {\n  const store = injectSessionStore();\n  if (!store) return;\n\n  let prev: SessionStatus = store.getSnapshot().status;\n  // statusChanged(connected) can arrive BEFORE accountsChanged, so fire\n  // onConnect once per session on the tick the account becomes available.\n  let firedConnect = false;\n\n  const unsubscribe = store.subscribe(() => {\n    const next = store.getSnapshot();\n    const was = prev;\n    const now = next.status;\n    prev = now;\n    if (now === 'connected') {\n      if (!firedConnect && next.account) {\n        firedConnect = true;\n        parameters.onConnect?.({\n          account: next.account,\n          accounts: next.accounts,\n          networkId: next.networkId,\n        });\n      }\n    } else if (now === 'disconnected' && (was === 'connected' || firedConnect)) {\n      firedConnect = false;\n      parameters.onDisconnect?.();\n    }\n  });\n\n  const unsubscribeParty = store.on('party:changed', (e) => {\n    if (e.type === 'party:changed') {\n      parameters.onPartyChanged?.({ previous: e.previous, current: e.current });\n    }\n  });\n\n  onScopeDispose(() => {\n    unsubscribe();\n    unsubscribeParty();\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@partylayer/vue",
+  "version": "0.1.0",
+  "description": "Vue 3 composables for PartyLayer sessions",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "canton",
+    "wallet",
+    "vue",
+    "composables"
+  ],
+  "author": "PartyLayer Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PartyLayer/PartyLayer.git",
+    "directory": "packages/vue"
+  },
+  "homepage": "https://partylayer.xyz",
+  "bugs": {
+    "url": "https://github.com/PartyLayer/PartyLayer/issues"
+  },
+  "peerDependencies": {
+    "vue": ">=3.4.0"
+  },
+  "dependencies": {
+    "@partylayer/core": "^0.5.0",
+    "@partylayer/session": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@vue/test-utils": "^2.4.6",
+    "happy-dom": "^14.12.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0",
+    "vue": "^3.4.0",
+    "@partylayer/testing": "^0.1.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}