trellis 3.1.35 → 3.2.0

package/dist/chunk-VUJ6SA55.js

@@ -0,0 +1,303 @@
+import {
+  TrellisVcsEngine,
+  init_engine
+} from "./chunk-ZMN5LUB7.js";
+import {
+  IdbOpLog
+} from "./chunk-MPXUVGT3.js";
+import {
+  JsonOpLog,
+  init_op_log
+} from "./chunk-XEN3OEYY.js";
+import {
+  PartyKitRoomTransport,
+  TrellisVcsSyncPeer
+} from "./chunk-BJ5EKCJ5.js";
+
+// src/client/vcs-client.ts
+init_engine();
+init_op_log();
+
+// src/client/reactive.ts
+var Signal = class {
+  _value;
+  _subs = /* @__PURE__ */ new Set();
+  constructor(initial) {
+    this._value = initial;
+  }
+  get value() {
+    return this._value;
+  }
+  set value(v) {
+    if (Object.is(this._value, v)) return;
+    this._value = v;
+    for (const fn of this._subs) {
+      try {
+        fn(v);
+      } catch {
+      }
+    }
+  }
+  /** Subscribe to changes. Immediately called with current value. */
+  subscribe(fn) {
+    this._subs.add(fn);
+    try {
+      fn(this._value);
+    } catch {
+    }
+    return () => {
+      this._subs.delete(fn);
+    };
+  }
+  /** Read without tracking. */
+  peek() {
+    return this._value;
+  }
+};
+var BatchSignal = class extends Signal {
+  _raf = null;
+  constructor(initial) {
+    super(initial);
+  }
+  set value(v) {
+    if (Object.is(this.peek(), v)) return;
+    if (this._raf !== null) cancelAnimationFrame(this._raf);
+    this._raf = requestAnimationFrame(() => {
+      this._raf = null;
+      super.value = v;
+    });
+  }
+};
+
+// src/client/vcs-client.ts
+var MemoryOpLog = class {
+  ops = [];
+  hashes = /* @__PURE__ */ new Set();
+  load() {
+  }
+  append(op) {
+    if (this.hashes.has(op.hash)) return;
+    this.ops.push(op);
+    this.hashes.add(op.hash);
+  }
+  readAll() {
+    return [...this.ops];
+  }
+  getLastOp() {
+    return this.ops[this.ops.length - 1];
+  }
+  count() {
+    return this.ops.length;
+  }
+};
+var TrellisClient = class _TrellisClient {
+  _engine;
+  _syncPeer;
+  _peerId = "";
+  _opLog;
+  /** Raw causal log. Updated on every local or remote op. */
+  _ops = new Signal([]);
+  /** Sync connection state. */
+  _syncStatus = new Signal({ pending: 0, synced: true });
+  _opHandlers = [];
+  _topicSubs = /* @__PURE__ */ new Map();
+  constructor() {
+  }
+  /** Factory — opens the repo, loads ops, and optionally connects to sync. */
+  static async open(opts) {
+    const client = new _TrellisClient();
+    client._peerId = opts.agentId ?? `client:${crypto.randomUUID()}`;
+    client._opLog = client._createOpLog(opts);
+    if ("load" in client._opLog && typeof client._opLog.load === "function") {
+      const maybePromise = client._opLog.load();
+      if (maybePromise instanceof Promise) await maybePromise;
+    }
+    client._engine = new TrellisVcsEngine({
+      rootPath: opts.repo,
+      agentId: client._peerId,
+      opLog: client._opLog
+    });
+    client._engine.open();
+    client._refreshState();
+    if (opts.sync) {
+      const transport = new PartyKitRoomTransport({
+        peerId: client._peerId,
+        roomUrl: opts.sync.url
+      });
+      client._syncPeer = new TrellisVcsSyncPeer({
+        peerId: client._peerId,
+        engine: client._engine,
+        transport,
+        onIntegrate: () => {
+          client._refreshState();
+          client._setSyncStatus({ synced: true });
+        }
+      });
+    }
+    return client;
+  }
+  // -------------------------------------------------------------------------
+  // Public API
+  // -------------------------------------------------------------------------
+  /** Subscribe to reactive topics. Callback receives current value immediately. */
+  subscribe(topic, callback) {
+    if (!this._topicSubs.has(topic)) {
+      this._topicSubs.set(topic, /* @__PURE__ */ new Set());
+    }
+    const subs = this._topicSubs.get(topic);
+    subs.add(callback);
+    const current = this._getTopicValue(topic);
+    if (current !== void 0) {
+      try {
+        callback(current);
+      } catch {
+      }
+    }
+    return () => {
+      subs.delete(callback);
+    };
+  }
+  /** Listen for raw op events (local or remote). */
+  on(event, handler) {
+    this._opHandlers.push(handler);
+    return () => {
+      const idx = this._opHandlers.indexOf(handler);
+      if (idx >= 0) this._opHandlers.splice(idx, 1);
+    };
+  }
+  /** Create an issue and emit reactive updates. */
+  async createIssue(title, opts) {
+    const createOpts = { ...opts };
+    if (opts?.lane) {
+      createOpts.laneId = opts.lane;
+    }
+    const op = await this._engine.createIssue(title, createOpts);
+    this._refreshState();
+    return op;
+  }
+  /** Force a push/pull sync with the PartyKit room. */
+  async sync() {
+    if (!this._syncPeer) {
+      throw new Error(
+        "No sync configured. Pass sync.url to TrellisClient.open() to enable multiplayer sync."
+      );
+    }
+    this._setSyncStatus({
+      pending: this._syncStatus.value.pending + 1,
+      synced: false
+    });
+    try {
+      await this._syncPeer.syncWith("room");
+    } finally {
+      this._setSyncStatus({
+        pending: Math.max(0, this._syncStatus.value.pending - 1),
+        synced: true
+      });
+    }
+  }
+  /** Read current ops without subscribing. */
+  getOps() {
+    return this._engine.getOps();
+  }
+  /** Read current issues without subscribing. */
+  listIssues() {
+    return this._engine.listIssues();
+  }
+  /** Clean up resources. */
+  close() {
+    this._engine.stop();
+  }
+  // -------------------------------------------------------------------------
+  // Reactive accessors (for framework adapters)
+  // -------------------------------------------------------------------------
+  /** Signal exposing the full causal op log. */
+  get opsSignal() {
+    return this._ops;
+  }
+  /** Signal exposing sync connection status. */
+  get syncStatusSignal() {
+    return this._syncStatus;
+  }
+  /** Underlying VCS engine (for advanced sync wiring and queries). */
+  get engine() {
+    return this._engine;
+  }
+  // -------------------------------------------------------------------------
+  // Private
+  // -------------------------------------------------------------------------
+  _createOpLog(opts) {
+    switch (opts.persist) {
+      case "indexeddb":
+        return new IdbOpLog({ dbName: opts.repo });
+      case "memory":
+        return new MemoryOpLog();
+      case "opfs":
+        throw new Error(
+          'OPFS persistence not yet implemented. Use "indexeddb" or "memory".'
+        );
+      default:
+        if (typeof globalThis !== "undefined" && "indexedDB" in globalThis) {
+          return new IdbOpLog({ dbName: opts.repo });
+        }
+        return new JsonOpLog(`${opts.repo}/.trellis/ops.json`);
+    }
+  }
+  _refreshState() {
+    const ops = this._engine.getOps();
+    const previousHashes = new Set(this._ops.value.map((o) => o.hash));
+    this._ops.value = ops;
+    for (const op of ops) {
+      if (!previousHashes.has(op.hash)) {
+        this._emitOp(op);
+      }
+    }
+    this._broadcastTopic("ops", ops);
+    this._broadcastTopic("issues", this._engine.listIssues());
+    this._broadcastTopic("milestones", this._engine.listMilestones());
+    this._broadcastTopic("branches", this._engine.listBranches());
+  }
+  _emitOp(op) {
+    for (const h of this._opHandlers) {
+      try {
+        h(op);
+      } catch {
+      }
+    }
+  }
+  _broadcastTopic(topic, data) {
+    const subs = this._topicSubs.get(topic);
+    if (!subs) return;
+    for (const fn of subs) {
+      try {
+        fn(data);
+      } catch {
+      }
+    }
+  }
+  _getTopicValue(topic) {
+    switch (topic) {
+      case "ops":
+        return this._ops.value;
+      case "syncStatus":
+        return this._syncStatus.value;
+      case "issues":
+        return this._engine.listIssues();
+      case "milestones":
+        return this._engine.listMilestones();
+      case "branches":
+        return this._engine.listBranches();
+      default:
+        return void 0;
+    }
+  }
+  _setSyncStatus(partial) {
+    this._syncStatus.value = { ...this._syncStatus.value, ...partial };
+    this._broadcastTopic("syncStatus", this._syncStatus.value);
+  }
+};
+
+export {
+  Signal,
+  BatchSignal,
+  TrellisClient
+};

package/dist/chunk-VUJQLIML.js

@@ -0,0 +1,141 @@
+import {
+  SqliteKernelBackend
+} from "./chunk-XMQ7G77X.js";
+import {
+  TrellisKernel
+} from "./chunk-335UEHQR.js";
+
+// src/server/tenancy.ts
+import { existsSync, mkdirSync } from "fs";
+import { join, resolve } from "path";
+var DEFAULT_TENANT = "default";
+var TENANTS_DIR = "tenants";
+var TenantPool = class {
+  pool = /* @__PURE__ */ new Map();
+  dbPath;
+  agentId;
+  backendOpts;
+  constructor(dbPath, agentIdOrOpts = "trellis-db") {
+    this.dbPath = resolve(dbPath);
+    if (typeof agentIdOrOpts === "string") {
+      this.agentId = agentIdOrOpts;
+      this.backendOpts = void 0;
+    } else {
+      this.agentId = agentIdOrOpts.agentId ?? "trellis-db";
+      this.backendOpts = agentIdOrOpts.backend;
+    }
+    this._ensureDirs();
+  }
+  // -------------------------------------------------------------------------
+  // Public API
+  // -------------------------------------------------------------------------
+  /**
+   * Get (or create) the kernel for a tenant.
+   * Pass `null` or `undefined` to get the default tenant.
+   *
+   * Uses the synchronous bun:sqlite backend. To use an async backend
+   * (better-sqlite3, sql.js) call `preload(tenantId)` first; subsequent
+   * `get()` calls will return the preloaded kernel from the pool.
+   */
+  get(tenantId) {
+    const id = tenantId ?? DEFAULT_TENANT;
+    if (!this.pool.has(id)) {
+      this.pool.set(id, this._createKernelSync(id));
+    }
+    return this.pool.get(id);
+  }
+  /**
+   * Pre-create a tenant's kernel using the runtime-selected backend.
+   * Required when running with an async-only backend (sql.js / WebContainer
+   * / browser). Idempotent — safe to call multiple times.
+   *
+   * After `preload()`, subsequent `get(tenantId)` returns the same kernel
+   * synchronously from the pool.
+   */
+  async preload(tenantId) {
+    const id = tenantId ?? DEFAULT_TENANT;
+    const cached = this.pool.get(id);
+    if (cached) return cached;
+    const kernel = await this._createKernelAsync(id);
+    this.pool.set(id, kernel);
+    return kernel;
+  }
+  /**
+   * Check whether a tenant has been initialized (kernel created).
+   */
+  has(tenantId) {
+    return this.pool.has(tenantId);
+  }
+  /**
+   * List all active tenant IDs (those with open kernels).
+   */
+  activeTenants() {
+    return Array.from(this.pool.keys());
+  }
+  /**
+   * Close a specific tenant's kernel and remove it from the pool.
+   */
+  close(tenantId) {
+    const kernel = this.pool.get(tenantId);
+    if (kernel) {
+      kernel.close();
+      this.pool.delete(tenantId);
+    }
+  }
+  /**
+   * Close all kernels and clear the pool.
+   */
+  closeAll() {
+    for (const kernel of this.pool.values()) {
+      kernel.close();
+    }
+    this.pool.clear();
+  }
+  /**
+   * Return the SQLite file path for a given tenant.
+   */
+  dbFilePath(tenantId) {
+    const id = tenantId ?? DEFAULT_TENANT;
+    if (id === DEFAULT_TENANT) {
+      return join(this.dbPath, "default.sqlite");
+    }
+    return join(this.dbPath, TENANTS_DIR, `${id}.sqlite`);
+  }
+  // -------------------------------------------------------------------------
+  // Private
+  // -------------------------------------------------------------------------
+  _createKernelSync(tenantId) {
+    const sqlitePath = this.dbFilePath(tenantId);
+    const backend = new SqliteKernelBackend(sqlitePath);
+    return this._wrapKernel(backend);
+  }
+  async _createKernelAsync(tenantId) {
+    const sqlitePath = this.dbFilePath(tenantId);
+    const { createKernelBackend } = await import("./core/persist/factory.js");
+    const backend = await createKernelBackend(sqlitePath, this.backendOpts);
+    return this._wrapKernel(backend);
+  }
+  _wrapKernel(backend) {
+    const kernel = new TrellisKernel({
+      backend,
+      agentId: this.agentId,
+      snapshotThreshold: 1e3
+    });
+    kernel.boot();
+    return kernel;
+  }
+  _ensureDirs() {
+    if (!existsSync(this.dbPath)) {
+      mkdirSync(this.dbPath, { recursive: true });
+    }
+    const tenantsPath = join(this.dbPath, TENANTS_DIR);
+    if (!existsSync(tenantsPath)) {
+      mkdirSync(tenantsPath, { recursive: true });
+    }
+  }
+};
+
+export {
+  DEFAULT_TENANT,
+  TenantPool
+};

package/dist/chunk-VWKLKLYB.js

@@ -0,0 +1,267 @@
+import {
+  __require
+} from "./chunk-2ESYSVXG.js";
+
+// src/core/persist/sqljs-backend.ts
+var SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS ops (
+  hash TEXT PRIMARY KEY,
+  kind TEXT NOT NULL,
+  timestamp TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  previous_hash TEXT,
+  payload TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS snapshots (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  last_op_hash TEXT NOT NULL,
+  data TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE TABLE IF NOT EXISTS blobs (
+  hash TEXT PRIMARY KEY,
+  content BLOB NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_ops_kind ON ops(kind);
+CREATE INDEX IF NOT EXISTS idx_ops_timestamp ON ops(timestamp);
+CREATE INDEX IF NOT EXISTS idx_ops_agent ON ops(agent_id);
+CREATE INDEX IF NOT EXISTS idx_ops_previous ON ops(previous_hash);
+CREATE INDEX IF NOT EXISTS idx_snapshots_op ON snapshots(last_op_hash);
+`;
+var SqlJsKernelBackend = class _SqlJsKernelBackend {
+  constructor(opts) {
+    this.opts = opts;
+    this.flushEvery = opts.autoFlushEvery ?? 50;
+  }
+  db;
+  stmts;
+  writes = 0;
+  flushEvery;
+  initialized = false;
+  /**
+   * Async factory — sql.js WASM init is async, but the resulting backend
+   * exposes the synchronous KernelBackend surface, so it slots into the
+   * existing kernel without interface changes.
+   */
+  static async create(opts) {
+    const backend = new _SqlJsKernelBackend(opts);
+    await backend.bootstrap();
+    return backend;
+  }
+  async bootstrap() {
+    let initSqlJs;
+    try {
+      const mod = await import("sql.js");
+      initSqlJs = mod.default ?? mod;
+    } catch (e) {
+      throw new Error(
+        'SqlJsKernelBackend requires the optional dependency "sql.js". Install it: npm install sql.js'
+      );
+    }
+    let sqljsDistDir = null;
+    if (typeof window === "undefined") {
+      try {
+        const moduleMod = await import("module");
+        const pathMod = await import("path");
+        const req = moduleMod.createRequire(import.meta.url);
+        const sqlJsEntry = req.resolve("sql.js");
+        sqljsDistDir = pathMod.dirname(sqlJsEntry);
+      } catch {
+        sqljsDistDir = null;
+      }
+    }
+    const SQL = await initSqlJs({
+      locateFile: (file) => {
+        if (typeof window !== "undefined") return `/sql-wasm/${file}`;
+        if (sqljsDistDir) return `${sqljsDistDir}/${file}`;
+        return file;
+      }
+    });
+    const existing = this.loadFromDisk();
+    this.db = existing ? new SQL.Database(existing) : new SQL.Database();
+  }
+  loadFromDisk() {
+    if (this.opts.dbPath === ":memory:") return null;
+    try {
+      const fs = __require("fs");
+      if (!fs.existsSync(this.opts.dbPath)) return null;
+      return new Uint8Array(fs.readFileSync(this.opts.dbPath));
+    } catch {
+      return null;
+    }
+  }
+  flushToDisk() {
+    if (this.opts.dbPath === ":memory:") return;
+    try {
+      const fs = __require("fs");
+      const path = __require("path");
+      const data = this.db.export();
+      fs.mkdirSync(path.dirname(this.opts.dbPath), { recursive: true });
+      const tmp = `${this.opts.dbPath}.tmp`;
+      fs.writeFileSync(tmp, Buffer.from(data));
+      fs.renameSync(tmp, this.opts.dbPath);
+    } catch {
+    }
+  }
+  init() {
+    if (this.initialized) return;
+    this.db.exec(SCHEMA_SQL);
+    this.prepareStatements();
+    this.initialized = true;
+  }
+  prepareStatements() {
+    this.stmts = {
+      insert: this.db.prepare(
+        `INSERT OR IGNORE INTO ops (hash, kind, timestamp, agent_id, previous_hash, payload)
+         VALUES ($hash, $kind, $timestamp, $agentId, $previousHash, $payload)`
+      ),
+      readAll: this.db.prepare(
+        `SELECT hash, kind, timestamp, agent_id, previous_hash, payload
+         FROM ops ORDER BY rowid ASC`
+      ),
+      readUntil: this.db.prepare(
+        `SELECT hash, kind, timestamp, agent_id, previous_hash, payload
+         FROM ops WHERE rowid <= (SELECT rowid FROM ops WHERE hash = $hash)
+         ORDER BY rowid ASC`
+      ),
+      readAfter: this.db.prepare(
+        `SELECT hash, kind, timestamp, agent_id, previous_hash, payload
+         FROM ops WHERE rowid > (SELECT rowid FROM ops WHERE hash = $hash)
+         ORDER BY rowid ASC`
+      ),
+      getByHash: this.db.prepare(
+        `SELECT hash, kind, timestamp, agent_id, previous_hash, payload
+         FROM ops WHERE hash = $hash`
+      ),
+      getLast: this.db.prepare(
+        `SELECT hash, kind, timestamp, agent_id, previous_hash, payload
+         FROM ops ORDER BY rowid DESC LIMIT 1`
+      ),
+      count: this.db.prepare(`SELECT COUNT(*) AS cnt FROM ops`),
+      saveSnapshot: this.db.prepare(
+        `INSERT INTO snapshots (last_op_hash, data) VALUES ($lastOpHash, $data)`
+      ),
+      loadSnapshot: this.db.prepare(
+        `SELECT last_op_hash, data FROM snapshots ORDER BY id DESC LIMIT 1`
+      )
+    };
+  }
+  append(op) {
+    const payload = JSON.stringify({
+      facts: op.facts,
+      links: op.links,
+      ...op.deleteFacts?.length ? { deleteFacts: op.deleteFacts } : {},
+      ...op.deleteLinks?.length ? { deleteLinks: op.deleteLinks } : {},
+      ...op.vcs ? { vcs: op.vcs } : {},
+      ...op.signature ? { signature: op.signature } : {}
+    });
+    this.stmts.insert.run({
+      $hash: op.hash,
+      $kind: op.kind,
+      $timestamp: op.timestamp,
+      $agentId: op.agentId,
+      $previousHash: op.previousHash ?? null,
+      $payload: payload
+    });
+    this.stmts.insert.reset();
+    this.tickFlush();
+  }
+  readAll() {
+    return this.runAll(this.stmts.readAll);
+  }
+  readUntil(hash) {
+    return this.runAll(this.stmts.readUntil, { $hash: hash });
+  }
+  readAfter(hash) {
+    return this.runAll(this.stmts.readAfter, { $hash: hash });
+  }
+  readUntilTimestamp(iso) {
+    const stmt = this.db.prepare(
+      `SELECT hash, kind, timestamp, agent_id, previous_hash, payload
+       FROM ops WHERE timestamp <= $ts ORDER BY rowid ASC`
+    );
+    const rows = this.runAll(stmt, { $ts: iso });
+    stmt.free();
+    return rows;
+  }
+  getByHash(hash) {
+    return this.runOne(this.stmts.getByHash, { $hash: hash });
+  }
+  getLastOp() {
+    return this.runOne(this.stmts.getLast);
+  }
+  getOpCount() {
+    this.stmts.count.bind({});
+    const has = this.stmts.count.step();
+    const row = has ? this.stmts.count.getAsObject() : { cnt: 0 };
+    this.stmts.count.reset();
+    return Number(row.cnt ?? 0);
+  }
+  saveSnapshot(lastOpHash, data) {
+    this.stmts.saveSnapshot.run({
+      $lastOpHash: lastOpHash,
+      $data: typeof data === "string" ? data : JSON.stringify(data)
+    });
+    this.stmts.saveSnapshot.reset();
+    this.tickFlush();
+  }
+  loadLatestSnapshot() {
+    this.stmts.loadSnapshot.bind({});
+    const has = this.stmts.loadSnapshot.step();
+    if (!has) {
+      this.stmts.loadSnapshot.reset();
+      return void 0;
+    }
+    const row = this.stmts.loadSnapshot.getAsObject();
+    this.stmts.loadSnapshot.reset();
+    return { lastOpHash: row.last_op_hash, data: row.data };
+  }
+  close() {
+    try {
+      this.flushToDisk();
+    } finally {
+      for (const s of Object.values(this.stmts ?? {})) s?.free?.();
+      this.db?.close?.();
+    }
+  }
+  /** Force a write of the in-memory DB image to disk. */
+  flush() {
+    this.flushToDisk();
+  }
+  runAll(stmt, params = {}) {
+    stmt.bind(params);
+    const rows = [];
+    while (stmt.step()) rows.push(rowToOp(stmt.getAsObject()));
+    stmt.reset();
+    return rows;
+  }
+  runOne(stmt, params = {}) {
+    stmt.bind(params);
+    const has = stmt.step();
+    const row = has ? stmt.getAsObject() : void 0;
+    stmt.reset();
+    return row ? rowToOp(row) : void 0;
+  }
+  tickFlush() {
+    if (this.flushEvery === 0) return;
+    if (++this.writes % this.flushEvery === 0) this.flushToDisk();
+  }
+};
+function rowToOp(row) {
+  const payload = JSON.parse(row.payload);
+  return {
+    hash: row.hash,
+    kind: row.kind,
+    timestamp: row.timestamp,
+    agentId: row.agent_id,
+    previousHash: row.previous_hash ?? void 0,
+    facts: payload.facts,
+    links: payload.links,
+    deleteFacts: payload.deleteFacts,
+    deleteLinks: payload.deleteLinks
+  };
+}
+
+export {
+  SqlJsKernelBackend
+};