@sna-sdk/core 0.5.0 → 0.6.0

package/dist/db/schema.js

@@ -18,7 +18,8 @@ function getDb() {
     const BetterSqlite3 = loadBetterSqlite3();
     const dir = path.dirname(DB_PATH);
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-    _db = new BetterSqlite3(DB_PATH);
+    const nativeBinding = process.env.SNA_SQLITE_NATIVE_BINDING || void 0;
+    _db = nativeBinding ? new BetterSqlite3(DB_PATH, { nativeBinding }) : new BetterSqlite3(DB_PATH);
     _db.pragma("journal_mode = WAL");
     initSchema(_db);
   }

package/dist/electron/index.cjs

@@ -0,0 +1,172 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/electron/index.ts
+var electron_exports = {};
+__export(electron_exports, {
+  startSnaServer: () => startSnaServer
+});
+module.exports = __toCommonJS(electron_exports);
+
+// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.8_tsx@4.21.0_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+// src/electron/index.ts
+var import_child_process = require("child_process");
+var import_url = require("url");
+var import_fs = __toESM(require("fs"), 1);
+var import_path = __toESM(require("path"), 1);
+function resolveStandaloneScript() {
+  const selfPath = (0, import_url.fileURLToPath)(importMetaUrl);
+  let script = import_path.default.resolve(import_path.default.dirname(selfPath), "../server/standalone.js");
+  if (script.includes(".asar") && !script.includes(".asar.unpacked")) {
+    script = script.replace(/(\.asar)([/\\])/, ".asar.unpacked$2");
+  }
+  if (!import_fs.default.existsSync(script)) {
+    throw new Error(
+      `SNA standalone script not found: ${script}
+Ensure "@sna-sdk/core" is listed in asarUnpack in your electron-builder config.`
+    );
+  }
+  return script;
+}
+function resolveNativeBinding(override) {
+  if (override) {
+    if (!import_fs.default.existsSync(override)) {
+      console.warn(`[sna] SNA nativeBinding override not found: ${override}`);
+      return void 0;
+    }
+    return override;
+  }
+  const BINDING_REL = import_path.default.join("better-sqlite3", "build", "Release", "better_sqlite3.node");
+  const resourcesPath = process.resourcesPath;
+  if (resourcesPath) {
+    const unpackedBase = import_path.default.join(resourcesPath, "app.asar.unpacked", "node_modules");
+    const candidates = [
+      import_path.default.join(unpackedBase, BINDING_REL),
+      // nested under @sna-sdk/core if hoisting differs
+      import_path.default.join(unpackedBase, "@sna-sdk", "core", "node_modules", BINDING_REL)
+    ];
+    for (const c of candidates) {
+      if (import_fs.default.existsSync(c)) return c;
+    }
+  }
+  const selfPath = (0, import_url.fileURLToPath)(importMetaUrl);
+  const local = import_path.default.resolve(import_path.default.dirname(selfPath), "../../node_modules", BINDING_REL);
+  if (import_fs.default.existsSync(local)) return local;
+  return void 0;
+}
+function buildNodePath() {
+  const resourcesPath = process.resourcesPath;
+  if (!resourcesPath) return void 0;
+  const unpacked = import_path.default.join(resourcesPath, "app.asar.unpacked", "node_modules");
+  if (!import_fs.default.existsSync(unpacked)) return void 0;
+  const existing = process.env.NODE_PATH;
+  return existing ? `${unpacked}${import_path.default.delimiter}${existing}` : unpacked;
+}
+async function startSnaServer(options) {
+  const port = options.port ?? 3099;
+  const cwd = options.cwd ?? import_path.default.dirname(options.dbPath);
+  const readyTimeout = options.readyTimeout ?? 15e3;
+  const { onLog } = options;
+  const standaloneScript = resolveStandaloneScript();
+  const nativeBinding = resolveNativeBinding(options.nativeBinding);
+  const nodePath = buildNodePath();
+  const env = {
+    ...process.env,
+    SNA_PORT: String(port),
+    SNA_DB_PATH: options.dbPath,
+    ...options.maxSessions != null ? { SNA_MAX_SESSIONS: String(options.maxSessions) } : {},
+    ...options.permissionMode ? { SNA_PERMISSION_MODE: options.permissionMode } : {},
+    ...options.model ? { SNA_MODEL: options.model } : {},
+    ...nativeBinding ? { SNA_SQLITE_NATIVE_BINDING: nativeBinding } : {},
+    ...nodePath ? { NODE_PATH: nodePath } : {},
+    // Consumer overrides last so they can always win
+    ...options.env ?? {}
+  };
+  const proc = (0, import_child_process.fork)(standaloneScript, [], {
+    cwd,
+    env,
+    stdio: "pipe"
+  });
+  let stdoutBuf = "";
+  let isReady = false;
+  const readyListeners = [];
+  proc.stdout?.on("data", (chunk) => {
+    stdoutBuf += chunk.toString();
+    const lines = stdoutBuf.split("\n");
+    stdoutBuf = lines.pop() ?? "";
+    for (const line of lines) {
+      if (onLog) onLog(line);
+      if (!isReady && line.includes("API server ready")) {
+        isReady = true;
+        readyListeners.splice(0).forEach((cb) => cb());
+      }
+    }
+  });
+  proc.stderr?.on("data", (chunk) => {
+    if (onLog) {
+      chunk.toString().split("\n").filter(Boolean).forEach(onLog);
+    }
+  });
+  await new Promise((resolve, reject) => {
+    if (isReady) return resolve();
+    const timer = setTimeout(() => {
+      reject(new Error(`SNA server did not become ready within ${readyTimeout}ms`));
+    }, readyTimeout);
+    readyListeners.push(() => {
+      clearTimeout(timer);
+      resolve();
+    });
+    proc.on("exit", (code) => {
+      if (!isReady) {
+        clearTimeout(timer);
+        reject(new Error(`SNA server process exited (code=${code ?? "null"}) before becoming ready`));
+      }
+    });
+    proc.on("error", (err) => {
+      if (!isReady) {
+        clearTimeout(timer);
+        reject(err);
+      }
+    });
+  });
+  return {
+    process: proc,
+    port,
+    stop() {
+      proc.kill("SIGTERM");
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  startSnaServer
+});

package/dist/electron/index.d.ts

@@ -0,0 +1,99 @@
+import { ChildProcess } from 'child_process';
+
+/**
+ * @sna-sdk/core/electron — Electron launcher API
+ *
+ * Provides startSnaServer() to launch the SNA standalone server as a forked
+ * child process from an Electron main process. Handles asar path resolution,
+ * native module binding detection, env construction, and ready detection
+ * automatically.
+ *
+ * @example
+ * const { startSnaServer } = require("@sna-sdk/core/electron");
+ *
+ * const sna = await startSnaServer({
+ *   port: 3099,
+ *   dbPath: path.join(app.getPath("userData"), "sna.db"),
+ *   maxSessions: 20,
+ *   permissionMode: "acceptEdits",
+ *   onLog: (line) => console.log("[sna]", line),
+ * });
+ *
+ * // sna.process — ChildProcess ref
+ * // sna.port    — actual port
+ * // sna.stop()  — graceful shutdown
+ *
+ * @remarks
+ * **asarUnpack requirement**: for the fork to work, @sna-sdk/core must be
+ * outside the asar bundle. Add to your electron-builder config:
+ *
+ *   asarUnpack: ["node_modules/@sna-sdk/core/**"]
+ *
+ * The better-sqlite3 native binding used by the forked process must be
+ * compiled for the system Node.js (not Electron). If your app uses
+ * electron-rebuild, set options.nativeBinding to a Node.js-compiled
+ * .node file, or let SNA manage its own native install via `sna api:up`.
+ */
+
+interface SnaServerOptions {
+    /** Port for the SNA API server. Default: 3099 */
+    port?: number;
+    /** Absolute path to the SQLite database file. Required. */
+    dbPath: string;
+    /**
+     * Working directory for the server process.
+     * Default: dirname(dbPath)
+     */
+    cwd?: string;
+    /** Maximum concurrent agent sessions. Default: 5 */
+    maxSessions?: number;
+    /**
+     * Permission mode for Claude Code.
+     * Default: "acceptEdits"
+     */
+    permissionMode?: "acceptEdits" | "bypassPermissions" | "default";
+    /** Claude model to use. Default: SDK default (claude-sonnet-4-6) */
+    model?: string;
+    /**
+     * Explicit path to the better-sqlite3 native .node binding.
+     *
+     * When omitted, the launcher auto-detects from:
+     *   1. app.asar.unpacked/node_modules/better-sqlite3/build/Release/...
+     *   2. The SDK's local node_modules (dev / non-packaged)
+     *
+     * Set this if you have a custom Node.js-compiled binary at a known location.
+     */
+    nativeBinding?: string;
+    /**
+     * Extra env vars merged into the server process environment.
+     * These take precedence over the launcher's defaults.
+     */
+    env?: Record<string, string>;
+    /**
+     * How long to wait for the server to become ready, in milliseconds.
+     * Default: 15000 (15 seconds)
+     */
+    readyTimeout?: number;
+    /**
+     * Called with each log line emitted by the server process (stdout + stderr).
+     * Useful for forwarding to your app's logger.
+     */
+    onLog?: (line: string) => void;
+}
+interface SnaServerHandle {
+    /** The forked child process. */
+    process: ChildProcess;
+    /** The port the server is listening on. */
+    port: number;
+    /** Send SIGTERM to the server process for graceful shutdown. */
+    stop(): void;
+}
+/**
+ * Launch the SNA standalone API server in a forked child process.
+ *
+ * Returns a handle once the server is ready to accept requests.
+ * Throws if the server fails to start within `options.readyTimeout`.
+ */
+declare function startSnaServer(options: SnaServerOptions): Promise<SnaServerHandle>;
+
+export { type SnaServerHandle, type SnaServerOptions, startSnaServer };

package/dist/electron/index.js

@@ -0,0 +1,130 @@
+import { fork } from "child_process";
+import { fileURLToPath } from "url";
+import fs from "fs";
+import path from "path";
+function resolveStandaloneScript() {
+  const selfPath = fileURLToPath(import.meta.url);
+  let script = path.resolve(path.dirname(selfPath), "../server/standalone.js");
+  if (script.includes(".asar") && !script.includes(".asar.unpacked")) {
+    script = script.replace(/(\.asar)([/\\])/, ".asar.unpacked$2");
+  }
+  if (!fs.existsSync(script)) {
+    throw new Error(
+      `SNA standalone script not found: ${script}
+Ensure "@sna-sdk/core" is listed in asarUnpack in your electron-builder config.`
+    );
+  }
+  return script;
+}
+function resolveNativeBinding(override) {
+  if (override) {
+    if (!fs.existsSync(override)) {
+      console.warn(`[sna] SNA nativeBinding override not found: ${override}`);
+      return void 0;
+    }
+    return override;
+  }
+  const BINDING_REL = path.join("better-sqlite3", "build", "Release", "better_sqlite3.node");
+  const resourcesPath = process.resourcesPath;
+  if (resourcesPath) {
+    const unpackedBase = path.join(resourcesPath, "app.asar.unpacked", "node_modules");
+    const candidates = [
+      path.join(unpackedBase, BINDING_REL),
+      // nested under @sna-sdk/core if hoisting differs
+      path.join(unpackedBase, "@sna-sdk", "core", "node_modules", BINDING_REL)
+    ];
+    for (const c of candidates) {
+      if (fs.existsSync(c)) return c;
+    }
+  }
+  const selfPath = fileURLToPath(import.meta.url);
+  const local = path.resolve(path.dirname(selfPath), "../../node_modules", BINDING_REL);
+  if (fs.existsSync(local)) return local;
+  return void 0;
+}
+function buildNodePath() {
+  const resourcesPath = process.resourcesPath;
+  if (!resourcesPath) return void 0;
+  const unpacked = path.join(resourcesPath, "app.asar.unpacked", "node_modules");
+  if (!fs.existsSync(unpacked)) return void 0;
+  const existing = process.env.NODE_PATH;
+  return existing ? `${unpacked}${path.delimiter}${existing}` : unpacked;
+}
+async function startSnaServer(options) {
+  const port = options.port ?? 3099;
+  const cwd = options.cwd ?? path.dirname(options.dbPath);
+  const readyTimeout = options.readyTimeout ?? 15e3;
+  const { onLog } = options;
+  const standaloneScript = resolveStandaloneScript();
+  const nativeBinding = resolveNativeBinding(options.nativeBinding);
+  const nodePath = buildNodePath();
+  const env = {
+    ...process.env,
+    SNA_PORT: String(port),
+    SNA_DB_PATH: options.dbPath,
+    ...options.maxSessions != null ? { SNA_MAX_SESSIONS: String(options.maxSessions) } : {},
+    ...options.permissionMode ? { SNA_PERMISSION_MODE: options.permissionMode } : {},
+    ...options.model ? { SNA_MODEL: options.model } : {},
+    ...nativeBinding ? { SNA_SQLITE_NATIVE_BINDING: nativeBinding } : {},
+    ...nodePath ? { NODE_PATH: nodePath } : {},
+    // Consumer overrides last so they can always win
+    ...options.env ?? {}
+  };
+  const proc = fork(standaloneScript, [], {
+    cwd,
+    env,
+    stdio: "pipe"
+  });
+  let stdoutBuf = "";
+  let isReady = false;
+  const readyListeners = [];
+  proc.stdout?.on("data", (chunk) => {
+    stdoutBuf += chunk.toString();
+    const lines = stdoutBuf.split("\n");
+    stdoutBuf = lines.pop() ?? "";
+    for (const line of lines) {
+      if (onLog) onLog(line);
+      if (!isReady && line.includes("API server ready")) {
+        isReady = true;
+        readyListeners.splice(0).forEach((cb) => cb());
+      }
+    }
+  });
+  proc.stderr?.on("data", (chunk) => {
+    if (onLog) {
+      chunk.toString().split("\n").filter(Boolean).forEach(onLog);
+    }
+  });
+  await new Promise((resolve, reject) => {
+    if (isReady) return resolve();
+    const timer = setTimeout(() => {
+      reject(new Error(`SNA server did not become ready within ${readyTimeout}ms`));
+    }, readyTimeout);
+    readyListeners.push(() => {
+      clearTimeout(timer);
+      resolve();
+    });
+    proc.on("exit", (code) => {
+      if (!isReady) {
+        clearTimeout(timer);
+        reject(new Error(`SNA server process exited (code=${code ?? "null"}) before becoming ready`));
+      }
+    });
+    proc.on("error", (err) => {
+      if (!isReady) {
+        clearTimeout(timer);
+        reject(err);
+      }
+    });
+  });
+  return {
+    process: proc,
+    port,
+    stop() {
+      proc.kill("SIGTERM");
+    }
+  };
+}
+export {
+  startSnaServer
+};

package/dist/server/standalone.js

@@ -31,7 +31,8 @@ function getDb() {
     const BetterSqlite3 = loadBetterSqlite3();
     const dir = path.dirname(DB_PATH);
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-    _db = new BetterSqlite3(DB_PATH);
+    const nativeBinding = process.env.SNA_SQLITE_NATIVE_BINDING || void 0;
+    _db = nativeBinding ? new BetterSqlite3(DB_PATH, { nativeBinding }) : new BetterSqlite3(DB_PATH);
     _db.pragma("journal_mode = WAL");
     initSchema(_db);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sna-sdk/core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Skills-Native Application runtime — server, providers, session management, database, and CLI",
   "type": "module",
   "bin": {
@@ -68,6 +68,13 @@
       "source": "./src/testing/mock-api.ts",
       "types": "./dist/testing/mock-api.d.ts",
       "default": "./dist/testing/mock-api.js"
+    },
+    "./electron": {
+      "source": "./src/electron/index.ts",
+      "types": "./dist/electron/index.d.ts",
+      "require": "./dist/electron/index.cjs",
+      "import": "./dist/electron/index.js",
+      "default": "./dist/electron/index.js"
     }
   },
   "engines": {