@letsrunit/store 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import Database from 'better-sqlite3';
+
+declare function openStore(path?: string): Database.Database;
+
+declare function insertSession(db: Database.Database, id: string, gitCommit: string | null, startedAt: number): void;
+declare function upsertFeature(db: Database.Database, id: string, path: string, name: string): void;
+declare function upsertScenario(db: Database.Database, id: string, featureId: string, name: string): void;
+declare function upsertStep(db: Database.Database, id: string, scenarioId: string, idx: number, text: string): void;
+declare function insertRun(db: Database.Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void;
+declare function finaliseRun(db: Database.Database, id: string, status: string, failedStepId?: string, error?: string): void;
+declare function insertArtifact(db: Database.Database, id: string, runId: string, stepId: string, filename: string): void;
+
+export { finaliseRun, insertArtifact, insertRun, insertSession, openStore, upsertFeature, upsertScenario, upsertStep };

package/dist/index.js

@@ -0,0 +1,75 @@
+import Database from 'better-sqlite3';
+
+// src/db.ts
+var SCHEMA = `
+CREATE TABLE IF NOT EXISTS sessions (
+  id          TEXT PRIMARY KEY,
+  started_at  INTEGER NOT NULL,
+  git_commit  TEXT
+);
+CREATE TABLE IF NOT EXISTS features (
+  id    TEXT PRIMARY KEY,
+  path  TEXT NOT NULL,
+  name  TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS scenarios (
+  id          TEXT PRIMARY KEY,
+  feature_id  TEXT NOT NULL REFERENCES features(id),
+  name        TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS steps (
+  id          TEXT PRIMARY KEY,
+  scenario_id TEXT NOT NULL REFERENCES scenarios(id),
+  idx         INTEGER NOT NULL,
+  text        TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS runs (
+  id              TEXT PRIMARY KEY,
+  session_id      TEXT NOT NULL REFERENCES sessions(id),
+  scenario_id     TEXT NOT NULL REFERENCES scenarios(id),
+  status          TEXT NOT NULL DEFAULT 'running',
+  failed_step_id  TEXT REFERENCES steps(id),
+  error           TEXT,
+  started_at      INTEGER NOT NULL
+);
+CREATE TABLE IF NOT EXISTS artifacts (
+  id        TEXT PRIMARY KEY,
+  run_id    TEXT NOT NULL REFERENCES runs(id),
+  step_id   TEXT NOT NULL REFERENCES steps(id),
+  filename  TEXT NOT NULL
+);
+`;
+function openStore(path = ".letsrunit/letsrunit.db") {
+  const db = new Database(path);
+  db.pragma("journal_mode = WAL");
+  db.pragma("foreign_keys = ON");
+  db.exec(SCHEMA);
+  return db;
+}
+
+// src/write.ts
+function insertSession(db, id, gitCommit, startedAt) {
+  db.prepare("INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)").run(id, startedAt, gitCommit);
+}
+function upsertFeature(db, id, path, name) {
+  db.prepare("INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)").run(id, path, name);
+}
+function upsertScenario(db, id, featureId, name) {
+  db.prepare("INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)").run(id, featureId, name);
+}
+function upsertStep(db, id, scenarioId, idx, text) {
+  db.prepare("INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)").run(id, scenarioId, idx, text);
+}
+function insertRun(db, id, sessionId, scenarioId, startedAt) {
+  db.prepare("INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)").run(id, sessionId, scenarioId, startedAt);
+}
+function finaliseRun(db, id, status, failedStepId, error) {
+  db.prepare("UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?").run(status, failedStepId ?? null, error ?? null, id);
+}
+function insertArtifact(db, id, runId, stepId, filename) {
+  db.prepare("INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)").run(id, runId, stepId, filename);
+}
+
+export { finaliseRun, insertArtifact, insertRun, insertSession, openStore, upsertFeature, upsertScenario, upsertStep };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/db.ts","../src/write.ts"],"names":[],"mappings":";;;AAEA,IAAM,MAAA,GAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAuCR,SAAS,SAAA,CAAU,OAAO,yBAAA,EAA8C;AAC7E,EAAA,MAAM,EAAA,GAAK,IAAI,QAAA,CAAS,IAAI,CAAA;AAC5B,EAAA,EAAA,CAAG,OAAO,oBAAoB,CAAA;AAC9B,EAAA,EAAA,CAAG,OAAO,mBAAmB,CAAA;AAC7B,EAAA,EAAA,CAAG,KAAK,MAAM,CAAA;AACd,EAAA,OAAO,EAAA;AACT;;;AC7CO,SAAS,aAAA,CAAc,EAAA,EAAuB,EAAA,EAAY,SAAA,EAA0B,SAAA,EAAyB;AAClH,EAAA,EAAA,CAAG,QAAQ,8EAA8E,CAAA,CAAE,GAAA,CAAI,EAAA,EAAI,WAAW,SAAS,CAAA;AACzH;AAEO,SAAS,aAAA,CAAc,EAAA,EAAuB,EAAA,EAAY,IAAA,EAAc,IAAA,EAAoB;AACjG,EAAA,EAAA,CAAG,QAAQ,mEAAmE,CAAA,CAAE,GAAA,CAAI,EAAA,EAAI,MAAM,IAAI,CAAA;AACpG;AAEO,SAAS,cAAA,CAAe,EAAA,EAAuB,EAAA,EAAY,SAAA,EAAmB,IAAA,EAAoB;AACvG,EAAA,EAAA,CAAG,QAAQ,0EAA0E,CAAA,CAAE,GAAA,CAAI,EAAA,EAAI,WAAW,IAAI,CAAA;AAChH;AAEO,SAAS,UAAA,CAAW,EAAA,EAAuB,EAAA,EAAY,UAAA,EAAoB,KAAa,IAAA,EAAoB;AACjH,EAAA,EAAA,CAAG,QAAQ,+EAA+E,CAAA,CAAE,IAAI,EAAA,EAAI,UAAA,EAAY,KAAK,IAAI,CAAA;AAC3H;AAEO,SAAS,SAAA,CAAU,EAAA,EAAuB,EAAA,EAAY,SAAA,EAAmB,YAAoB,SAAA,EAAyB;AAC3H,EAAA,EAAA,CAAG,QAAQ,gFAAgF,CAAA,CAAE,IAAI,EAAA,EAAI,SAAA,EAAW,YAAY,SAAS,CAAA;AACvI;AAEO,SAAS,WAAA,CAAY,EAAA,EAAuB,EAAA,EAAY,MAAA,EAAgB,cAAuB,KAAA,EAAsB;AAC1H,EAAA,EAAA,CAAG,OAAA,CAAQ,wEAAwE,CAAA,CAAE,GAAA,CAAI,QAAQ,YAAA,IAAgB,IAAA,EAAM,KAAA,IAAS,IAAA,EAAM,EAAE,CAAA;AAC1I;AAEO,SAAS,cAAA,CAAe,EAAA,EAAuB,EAAA,EAAY,KAAA,EAAe,QAAgB,QAAA,EAAwB;AACvH,EAAA,EAAA,CAAG,QAAQ,2EAA2E,CAAA,CAAE,IAAI,EAAA,EAAI,KAAA,EAAO,QAAQ,QAAQ,CAAA;AACzH","file":"index.js","sourcesContent":["import Database from 'better-sqlite3';\n\nconst SCHEMA = `\nCREATE TABLE IF NOT EXISTS sessions (\n  id          TEXT PRIMARY KEY,\n  started_at  INTEGER NOT NULL,\n  git_commit  TEXT\n);\nCREATE TABLE IF NOT EXISTS features (\n  id    TEXT PRIMARY KEY,\n  path  TEXT NOT NULL,\n  name  TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS scenarios (\n  id          TEXT PRIMARY KEY,\n  feature_id  TEXT NOT NULL REFERENCES features(id),\n  name        TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS steps (\n  id          TEXT PRIMARY KEY,\n  scenario_id TEXT NOT NULL REFERENCES scenarios(id),\n  idx         INTEGER NOT NULL,\n  text        TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS runs (\n  id              TEXT PRIMARY KEY,\n  session_id      TEXT NOT NULL REFERENCES sessions(id),\n  scenario_id     TEXT NOT NULL REFERENCES scenarios(id),\n  status          TEXT NOT NULL DEFAULT 'running',\n  failed_step_id  TEXT REFERENCES steps(id),\n  error           TEXT,\n  started_at      INTEGER NOT NULL\n);\nCREATE TABLE IF NOT EXISTS artifacts (\n  id        TEXT PRIMARY KEY,\n  run_id    TEXT NOT NULL REFERENCES runs(id),\n  step_id   TEXT NOT NULL REFERENCES steps(id),\n  filename  TEXT NOT NULL\n);\n`;\n\nexport function openStore(path = '.letsrunit/letsrunit.db'): Database.Database {\n  const db = new Database(path);\n  db.pragma('journal_mode = WAL');\n  db.pragma('foreign_keys = ON');\n  db.exec(SCHEMA);\n  return db;\n}\n","import type Database from 'better-sqlite3';\n\nexport function insertSession(db: Database.Database, id: string, gitCommit: string | null, startedAt: number): void {\n  db.prepare('INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)').run(id, startedAt, gitCommit);\n}\n\nexport function upsertFeature(db: Database.Database, id: string, path: string, name: string): void {\n  db.prepare('INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)').run(id, path, name);\n}\n\nexport function upsertScenario(db: Database.Database, id: string, featureId: string, name: string): void {\n  db.prepare('INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)').run(id, featureId, name);\n}\n\nexport function upsertStep(db: Database.Database, id: string, scenarioId: string, idx: number, text: string): void {\n  db.prepare('INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)').run(id, scenarioId, idx, text);\n}\n\nexport function insertRun(db: Database.Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void {\n  db.prepare('INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)').run(id, sessionId, scenarioId, startedAt);\n}\n\nexport function finaliseRun(db: Database.Database, id: string, status: string, failedStepId?: string, error?: string): void {\n  db.prepare('UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?').run(status, failedStepId ?? null, error ?? null, id);\n}\n\nexport function insertArtifact(db: Database.Database, id: string, runId: string, stepId: string, filename: string): void {\n  db.prepare('INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)').run(id, runId, stepId, filename);\n}\n"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@letsrunit/store",
+  "version": "0.1.0",
+  "description": "SQLite-backed artifact store for letsrunit",
+  "keywords": [
+    "testing",
+    "store",
+    "sqlite",
+    "letsrunit"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/letsrunit-hq/letsrunit.git",
+    "directory": "packages/store"
+  },
+  "bugs": "https://github.com/letsrunit-hq/letsrunit/issues",
+  "homepage": "https://github.com/letsrunit-hq/letsrunit#readme",
+  "type": "module",
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "../../node_modules/.bin/tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "packageManager": "yarn@4.10.3",
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "uuid": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13"
+  }
+}

package/src/db.ts

@@ -0,0 +1,48 @@
+import Database from 'better-sqlite3';
+
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS sessions (
+  id          TEXT PRIMARY KEY,
+  started_at  INTEGER NOT NULL,
+  git_commit  TEXT
+);
+CREATE TABLE IF NOT EXISTS features (
+  id    TEXT PRIMARY KEY,
+  path  TEXT NOT NULL,
+  name  TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS scenarios (
+  id          TEXT PRIMARY KEY,
+  feature_id  TEXT NOT NULL REFERENCES features(id),
+  name        TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS steps (
+  id          TEXT PRIMARY KEY,
+  scenario_id TEXT NOT NULL REFERENCES scenarios(id),
+  idx         INTEGER NOT NULL,
+  text        TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS runs (
+  id              TEXT PRIMARY KEY,
+  session_id      TEXT NOT NULL REFERENCES sessions(id),
+  scenario_id     TEXT NOT NULL REFERENCES scenarios(id),
+  status          TEXT NOT NULL DEFAULT 'running',
+  failed_step_id  TEXT REFERENCES steps(id),
+  error           TEXT,
+  started_at      INTEGER NOT NULL
+);
+CREATE TABLE IF NOT EXISTS artifacts (
+  id        TEXT PRIMARY KEY,
+  run_id    TEXT NOT NULL REFERENCES runs(id),
+  step_id   TEXT NOT NULL REFERENCES steps(id),
+  filename  TEXT NOT NULL
+);
+`;
+
+export function openStore(path = '.letsrunit/letsrunit.db'): Database.Database {
+  const db = new Database(path);
+  db.pragma('journal_mode = WAL');
+  db.pragma('foreign_keys = ON');
+  db.exec(SCHEMA);
+  return db;
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { openStore } from './db.js';
+export { insertSession, upsertFeature, upsertScenario, upsertStep, insertRun, finaliseRun, insertArtifact } from './write.js';

package/src/read.ts

@@ -0,0 +1,2 @@
+// Read queries will be added when CLI/MCP integration is implemented.
+export {};

package/src/write.ts

@@ -0,0 +1,29 @@
+import type Database from 'better-sqlite3';
+
+export function insertSession(db: Database.Database, id: string, gitCommit: string | null, startedAt: number): void {
+  db.prepare('INSERT OR IGNORE INTO sessions (id, started_at, git_commit) VALUES (?, ?, ?)').run(id, startedAt, gitCommit);
+}
+
+export function upsertFeature(db: Database.Database, id: string, path: string, name: string): void {
+  db.prepare('INSERT OR REPLACE INTO features (id, path, name) VALUES (?, ?, ?)').run(id, path, name);
+}
+
+export function upsertScenario(db: Database.Database, id: string, featureId: string, name: string): void {
+  db.prepare('INSERT OR REPLACE INTO scenarios (id, feature_id, name) VALUES (?, ?, ?)').run(id, featureId, name);
+}
+
+export function upsertStep(db: Database.Database, id: string, scenarioId: string, idx: number, text: string): void {
+  db.prepare('INSERT OR REPLACE INTO steps (id, scenario_id, idx, text) VALUES (?, ?, ?, ?)').run(id, scenarioId, idx, text);
+}
+
+export function insertRun(db: Database.Database, id: string, sessionId: string, scenarioId: string, startedAt: number): void {
+  db.prepare('INSERT INTO runs (id, session_id, scenario_id, started_at) VALUES (?, ?, ?, ?)').run(id, sessionId, scenarioId, startedAt);
+}
+
+export function finaliseRun(db: Database.Database, id: string, status: string, failedStepId?: string, error?: string): void {
+  db.prepare('UPDATE runs SET status = ?, failed_step_id = ?, error = ? WHERE id = ?').run(status, failedStepId ?? null, error ?? null, id);
+}
+
+export function insertArtifact(db: Database.Database, id: string, runId: string, stepId: string, filename: string): void {
+  db.prepare('INSERT INTO artifacts (id, run_id, step_id, filename) VALUES (?, ?, ?, ?)').run(id, runId, stepId, filename);
+}