@hardkas/sessions 0.4.0-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Javier Rodriguez
+
+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/dist/index.d.ts

@@ -0,0 +1,34 @@
+interface HardkasSession {
+    readonly schema: "hardkas.session.v1";
+    readonly name: string;
+    readonly l1: {
+        readonly wallet: string;
+        readonly address?: string;
+    };
+    readonly l2: {
+        readonly account: string;
+        readonly address?: string;
+    };
+    readonly bridge: {
+        readonly mode: "local-simulated" | "mainnet-multisig";
+    };
+    readonly createdAt: string;
+}
+interface SessionStore {
+    readonly activeSession?: string;
+    readonly sessions: Record<string, HardkasSession>;
+}
+
+declare const SESSION_FILE = ".hardkas/sessions.json";
+declare function loadSessionStore(cwd?: string): SessionStore;
+declare function loadSessionStoreStrict(cwd?: string): SessionStore;
+declare function loadSessionStoreWithDiagnostics(cwd?: string): {
+    store: SessionStore;
+    diagnostics: string[];
+};
+declare function saveSessionStore(store: SessionStore, cwd?: string): Promise<void>;
+declare function createSession(session: HardkasSession, cwd?: string): Promise<void>;
+declare function setActiveSession(name: string, cwd?: string): Promise<void>;
+declare function getActiveSession(cwd?: string): HardkasSession | undefined;
+
+export { type HardkasSession, SESSION_FILE, type SessionStore, createSession, getActiveSession, loadSessionStore, loadSessionStoreStrict, loadSessionStoreWithDiagnostics, saveSessionStore, setActiveSession };

package/dist/index.js

@@ -0,0 +1,105 @@
+// src/store.ts
+import { readFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { writeFileAtomic, withLock } from "@hardkas/core";
+var SESSION_FILE = ".hardkas/sessions.json";
+function loadSessionStore(cwd = process.cwd()) {
+  const { store } = loadSessionStoreWithDiagnostics(cwd);
+  return store;
+}
+function loadSessionStoreStrict(cwd = process.cwd()) {
+  const { store, diagnostics } = loadSessionStoreWithDiagnostics(cwd);
+  if (diagnostics.length > 0) {
+    throw new Error(`Invalid session store: ${diagnostics.join("; ")}`);
+  }
+  return store;
+}
+function loadSessionStoreWithDiagnostics(cwd = process.cwd()) {
+  const path = join(cwd, SESSION_FILE);
+  if (!existsSync(path)) {
+    return { store: { sessions: {} }, diagnostics: [] };
+  }
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync(path, "utf-8"));
+  } catch (e) {
+    return { store: { sessions: {} }, diagnostics: [`Malformed JSON in ${SESSION_FILE}`] };
+  }
+  const diagnostics = [];
+  if (!raw || typeof raw !== "object") {
+    diagnostics.push("Session store must be a JSON object");
+    return { store: { sessions: {} }, diagnostics };
+  }
+  if (!raw.sessions || typeof raw.sessions !== "object") {
+    diagnostics.push("Session store missing 'sessions' object");
+    return { store: { sessions: {} }, diagnostics };
+  }
+  if (raw.activeSession && !raw.sessions[raw.activeSession]) {
+    diagnostics.push(`Active session '${raw.activeSession}' not found in sessions list`);
+  }
+  for (const [name, session] of Object.entries(raw.sessions)) {
+    const s = session;
+    if (s.schema !== "hardkas.session.v1") {
+      diagnostics.push(`Session '${name}' has invalid or missing schema version`);
+    }
+    if (!s.l1 || !s.l1.wallet) {
+      diagnostics.push(`Session '${name}' missing L1 wallet configuration`);
+    }
+    if (!s.l2 || !s.l2.account) {
+      diagnostics.push(`Session '${name}' missing L2 account configuration`);
+    }
+    if (!s.bridge || !s.bridge.mode) {
+      diagnostics.push(`Session '${name}' missing bridge configuration`);
+    }
+  }
+  return { store: raw, diagnostics };
+}
+async function saveSessionStore(store, cwd = process.cwd()) {
+  const path = join(cwd, SESSION_FILE);
+  const dir = join(cwd, ".hardkas");
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  await writeFileAtomic(path, JSON.stringify(store, null, 2), {
+    fsyncParent: true
+  });
+}
+async function createSession(session, cwd = process.cwd()) {
+  await withLock({ rootDir: cwd, name: "workspace", wait: true, timeoutMs: 5e3 }, async () => {
+    const store = loadSessionStoreStrict(cwd);
+    const newStore = {
+      ...store,
+      sessions: {
+        ...store.sessions,
+        [session.name]: session
+      },
+      activeSession: store.activeSession || session.name
+    };
+    await saveSessionStore(newStore, cwd);
+  });
+}
+async function setActiveSession(name, cwd = process.cwd()) {
+  await withLock({ rootDir: cwd, name: "workspace", wait: true, timeoutMs: 5e3 }, async () => {
+    const store = loadSessionStoreStrict(cwd);
+    if (!store.sessions[name]) {
+      throw new Error(`Session "${name}" not found.`);
+    }
+    const newStore = { ...store, activeSession: name };
+    await saveSessionStore(newStore, cwd);
+  });
+}
+function getActiveSession(cwd = process.cwd()) {
+  const store = loadSessionStore(cwd);
+  if (!store.activeSession) return void 0;
+  return store.sessions[store.activeSession];
+}
+export {
+  SESSION_FILE,
+  createSession,
+  getActiveSession,
+  loadSessionStore,
+  loadSessionStoreStrict,
+  loadSessionStoreWithDiagnostics,
+  saveSessionStore,
+  setActiveSession
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@hardkas/sessions",
+  "version": "0.4.0-alpha",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@hardkas/core": "0.4.0-alpha"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "license": "MIT",
+  "author": "Javier Rodriguez",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
+}