@plurnk/plurnk-execs-sqlite 1.3.12 → 1.4.0

package/README.md

@@ -2,30 +2,31 @@
 
 SQLite runtime executor for [plurnk-service](https://github.com/plurnk/plurnk-service)'s `exec` scheme. Runs the `sqlite` runtime tag **in-process** via Node's builtin `node:sqlite` — no subprocess.
 
-A `@plurnk/plurnk-execs-*` sibling built on the [plurnk-execs](https://github.com/plurnk/plurnk-execs) framework.
+A `@plurnk/plurnk-execs-*` sibling built on the [plurnk-execs](https://github.com/plurnk/plurnk-service/tree/main/plurnk-execs) framework.
 
 ## Runtime tag
 
-| Tag | Glyph | Engine |
-|---|---|---|
-| `sqlite` | 🗃 | `node:sqlite` (Node 25 builtin) |
+| Tag      | Glyph | Engine                                      |
+| -------- | ----- | ------------------------------------------- |
+| `sqlite` | 🗃    | `node:sqlite` in the supported Node runtime |
 
 ## Database target
 
 The EXEC target slot is the database file; with no target it defaults to an ephemeral in-memory db:
 
-```
-<<EXEC[sqlite]:SELECT * FROM users:EXEC            → :memory: (fresh per worker)
-<<EXEC[sqlite](./app.db):SELECT * FROM users:EXEC  → ./app.db (persistent)
+```plurnk
+<<EXEC[sqlite]:SELECT * FROM users:EXEC
+<<EXEC[sqlite](./app.db):SELECT * FROM users:EXEC
 ```
 
-`:memory:` is ephemeral — state does not persist across EXECs. Pass a file path for persistence.
+With no target, a fresh `:memory:` database exists for that operation only.
+State does not persist across EXECs. Pass a file path for persistence.
 
 ### Transient tabular calculations
 
 With no target, `:memory:` is a scratch calculator over ad-hoc tables — build one inline with `VALUES` and aggregate, no schema or file needed:
 
-```
+```plurnk
 <<EXEC[sqlite]:WITH t(item,qty,price) AS (VALUES ('a',3,2),('b',1,5)) SELECT sum(qty*price) AS total, sum(qty*price)*1.0/sum(qty) AS avg_price FROM t:EXEC
 ```
 
@@ -38,11 +39,22 @@ Writes to the `results` channel as `application/json`, ready for the jsonpath bo
 - **Row-returning statements** (SELECT, RETURNING, PRAGMA) → an array of row objects.
 - **Mutations** (INSERT/UPDATE/DELETE/DDL) → `{ changes, lastInsertRowid }`.
 
-The query/mutation split is decided by the prepared statement's `columns()`, never by parsing the SQL. One statement per EXEC. Errors emit a `TelemetryEvent` (`source: "exec:sqlite"`): `sqlite_open_failed`, `sqlite_error`.
+The query/mutation split is decided by the prepared statement's `columns()`,
+never by parsing the SQL. One statement per EXEC. Errors return RFC 9457
+Problems in the terminal operation result.
+
+## Configuration
+
+The framework's `PLURNK_EXECS_ERROR_DETAIL_LIMIT` bounds SQLite diagnostics and
+rejected SQL tails included in Problem facts.
 
 ## Availability & proposal gating
 
-`probe()` always reports available (`node:sqlite` is a builtin). `effect(target)` marks `:memory:` (and no target) as `pure` (auto-run) and a file-backed db as `host` (propose) — classified by the target only, never by inspecting the SQL.
+`probe()` reports available because `node:sqlite` is part of the supported Node
+>=26 runtime. `effect(target)` marks `:memory:` and no target as `pure`, while a
+file-backed database is `host`. The former bypasses the proposal gate and the
+latter requires it; both produce their result through the background stream
+path ({§executor-effect}). Classification uses only the target, never the SQL.
 
 ## Tests
 

package/dist/Sqlite.d.ts

@@ -4,6 +4,6 @@ export default class Sqlite extends BaseExecutor {
     get channels(): Readonly<Record<string, ChannelDecl>>;
     probe(): Promise<RuntimeAvailability>;
     effect(target: string | null): Effect;
-    run({ command, cwd, target, signal, write, setState, emit }: ExecArgs): Promise<ExecResult>;
+    run({ command, cwd, target, signal, write, setState }: ExecArgs): Promise<ExecResult>;
 }
 //# sourceMappingURL=Sqlite.d.ts.map

package/dist/Sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sqlite.d.ts","sourceRoot":"","sources":["../src/Sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAoC3G,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,YAAY;IAC5C,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAEpD;IAGc,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAEnD;IAIQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE7C;IAEK,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA4ChG;CACJ"}
+{"version":3,"file":"Sqlite.d.ts","sourceRoot":"","sources":["../src/Sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAwB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAkC3G,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,YAAY;IAC5C,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAEpD;IAGc,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAEnD;IAIQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE7C;IAEK,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAiH1F;CACJ"}

package/dist/Sqlite.js

@@ -1,9 +1,9 @@
 import { isAbsolute, resolve } from "node:path";
 import { DatabaseSync } from "node:sqlite";
-import { BaseExecutor } from "@plurnk/plurnk-execs";
+import { BaseExecutor, ErrorDetail, Results } from "@plurnk/plurnk-execs";
 const MEMORY = ":memory:";
 // Resolve the EXEC (target) slot to a db path: a relative target resolves
-// against cwd (the workspace, plurnk-execs#15); null — or an explicit
+// against cwd ({§executor-sinks}); null — or an explicit
 // `:memory:` — means no file target → an ephemeral in-memory db.
 const dbPath = (cwd, target) => {
     if (target === null || target === MEMORY)
@@ -28,13 +28,11 @@ const stripComments = (sql) => sql.replace(/--[^\n]*/g, "").replace(/\/\*[\s\S]*
 // objects; mutations write `{ changes, lastInsertRowid }`. The query/mutation
 // split is decided by `columns()` — never by parsing the SQL.
 //
-// NOTE: `effect()` (per-runtime proposal gating; :memory:→pure, file→host) is
-// pending the contract addition in plurnk-service#182 and lands when that does.
 export default class Sqlite extends BaseExecutor {
     get channels() {
         return { results: { mimetype: "application/json" } };
     }
-    // Always available — node:sqlite is a Node 25 builtin, in-process.
+    // Always available in the package's supported Node >=26 runtime.
     async probe() {
         return { available: true, detail: "node:sqlite" };
     }
@@ -43,40 +41,70 @@ export default class Sqlite extends BaseExecutor {
     effect(target) {
         return target === null || target === MEMORY ? "pure" : "host";
     }
-    async run({ command, cwd, target, signal, write, setState, emit }) {
+    async run({ command, cwd, target, signal, write, setState }) {
         // node:sqlite is fully synchronous — no await point to interrupt mid-query —
-        // so the only place to honor an abort is before the work starts (SPEC §6).
+        // so the only place to honor an abort is before the work starts
+        // ({§executor-cancellation}).
         // Matters for a file-backed (host) statement: a cancel/KILL that lands first
         // must not still mutate the db.
         if (signal.aborted) {
             setState("results", "errored");
-            return { status: 499 };
+            return Results.failure("executor:sqlite", "cancelled", 499, "SQLite execution was cancelled.", {}, {
+                stage: "execution",
+                retryable: false,
+            });
         }
         const path = dbPath(cwd, target);
         const sql = command.trim();
-        const fail = (kind, message, status = 500) => {
-            emit({ source: "exec:sqlite", kind, message });
+        const errorPreview = ErrorDetail.configuredLimit();
+        const fail = (kind, message, status = 500, extensions = {}) => {
             setState("results", "errored");
-            return { status };
+            return Results.failure("executor:sqlite", kind, status, message, {}, {
+                database: path,
+                ...extensions,
+            });
         };
+        if (errorPreview === null) {
+            setState("results", "errored");
+            return ErrorDetail.invalidConfiguration("executor:sqlite");
+        }
         let db;
         try {
             db = new DatabaseSync(path);
         }
         catch (err) {
-            return fail("sqlite_open_failed", `cannot open database '${path}': ${err.message}`);
+            return fail("sqlite-open-failed", `SQLite could not open '${path}': ${ErrorDetail.preview(err, errorPreview)}`, 500, {
+                stage: "open",
+                recovery: "Use an accessible SQLite database target.",
+            });
+        }
+        let stmt;
+        try {
+            stmt = db.prepare(sql);
+        }
+        catch (err) {
+            db.close();
+            return fail("sqlite-invalid-statement", `SQLite could not prepare the statement: ${ErrorDetail.preview(err, errorPreview)}`, 400, {
+                stage: "prepare",
+                recovery: "Correct the SQL statement.",
+                retryable: false,
+            });
         }
         try {
-            const stmt = db.prepare(sql);
             // One statement per op is the contract (the results channel is one JSON
             // doc) — but SQLite's prepare compiles only the FIRST statement and
             // silently ignores the rest, so a sqlite3-CLI-style script would
-            // partially execute under a 200 (#493). sourceSQL is the compiled
+            // partially execute under a 200. sourceSQL is the compiled
             // statement's own text: any real SQL left after it is a dropped tail —
             // fail-hard, never truncate silently. Trailing whitespace/comments pass.
             const tail = stripComments(sql.slice(stmt.sourceSQL.length)).trim();
             if (tail !== "") {
-                return fail("sqlite_multi_statement", `one SQL statement per op — the tail '${tail.slice(0, 60)}' would be silently dropped; split into one op per statement`, 400);
+                return fail("sqlite-multi-statement", "SQLite execution accepts exactly one statement, but the command contains a second statement.", 400, {
+                    stage: "prepare",
+                    rejectedTail: ErrorDetail.preview(tail, errorPreview),
+                    recovery: "Run each SQL statement in a separate operation.",
+                    retryable: false,
+                });
             }
             // Non-empty columns ⇒ a row-returning statement; empty ⇒ a mutation.
             const output = stmt.columns().length > 0 ? stmt.all() : stmt.run();
@@ -85,7 +113,9 @@ export default class Sqlite extends BaseExecutor {
             return { status: 200 };
         }
         catch (err) {
-            return fail("sqlite_error", `${err.message}; db='${path}'`);
+            return fail("sqlite-error", `SQLite could not execute the statement: ${ErrorDetail.preview(err, errorPreview)}`, 500, {
+                stage: "execution",
+            });
         }
         finally {
             db.close();

package/dist/Sqlite.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sqlite.js","sourceRoot":"","sources":["../src/Sqlite.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Sqlite.js","sourceRoot":"","sources":["../src/Sqlite.ts"],"names":[],"mappings":"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"}

package/docs/sqlite.md

@@ -2,11 +2,19 @@
 
 Runs **one SQL statement** in-process via `node:sqlite` and writes the result to the `results` channel as `application/json` — ready for a jsonpath body-matcher.
 
-One statement per op is **enforced**: a `sqlite3`-style multi-statement script fails with `sqlite_multi_statement` (400) naming the dropped tail — SQLite compiles only the first statement, and partial execution must never pass as success (#493). Split scripts into one op per statement. Trailing semicolons and comments are fine. Dot-commands (`.tables`, `.schema`) are sqlite3-shell features, not SQL — use their SQL equivalents (`SELECT name FROM sqlite_master`).
+One statement per operation is enforced. A multi-statement script fails with
+`sqlite_multi_statement` (400) and names the rejected tail; partial execution
+never passes as success. Trailing semicolons and comments are allowed.
+Dot-commands such as `.tables` and `.schema` belong to the sqlite3 shell rather
+than SQL. Use their SQL equivalents, such as querying `sqlite_master`.
 
 ## Database target
 
-`EXEC[sqlite](./app.db):…` runs against the file `./app.db` (created if absent) — a persistent, host-mutating database. With **no target** it runs against an ephemeral `:memory:` database that's gone when the statement finishes (pure, auto-run). A directory is never a valid target and falls back to `:memory:`.
+`EXEC[sqlite](./app.db):…` runs against the file `./app.db` (created if absent),
+a persistent host-mutating database that requires proposal review. With no
+target, it runs against a fresh `:memory:` database that is gone when the
+operation finishes and bypasses proposal review. A directory is not a database
+target; core routes it as a working directory, leaving SQLite in memory.
 
 ## Query vs mutation
 
@@ -15,4 +23,6 @@ The result shape is decided by the statement's columns, never by parsing the SQL
 - **Row-returning** (SELECT, RETURNING, PRAGMA) → an array of row objects.
 - **Mutation** (INSERT / UPDATE / DELETE / CREATE) → `{ changes, lastInsertRowid }`.
 
-Large integers come back stringified (JSON can't hold a bigint). A SQL or open error closes `results` as `errored` with status 500 and a `sqlite_error` telemetry note.
+Large integers come back stringified (JSON cannot hold a bigint). Failures close
+`results` as `errored` with an RFC 9457 Problem: invalid authored SQL is 400, a
+missing database target is 404, and runtime/open failures are 500.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-execs-sqlite",
-    "version": "1.3.12",
+    "version": "1.4.0",
     "description": "SQLite runtime executor for plurnk-service's exec scheme — runs the sqlite runtime tag in-process via node:sqlite, results as application/json.",
     "keywords": [
         "plurnk",
@@ -10,13 +10,14 @@
         "sqlite",
         "sql"
     ],
-    "homepage": "https://github.com/plurnk/plurnk-execs-sqlite#readme",
+    "homepage": "https://github.com/plurnk/plurnk-service/tree/main/plurnk-execs-sqlite#readme",
     "bugs": {
-        "url": "https://github.com/plurnk/plurnk-execs-sqlite/issues"
+        "url": "https://repo.possumtech.com/plurnk/plurnk-service/issues"
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/plurnk/plurnk-execs-sqlite.git"
+        "url": "git+https://github.com/plurnk/plurnk-service.git",
+        "directory": "plurnk-execs-sqlite"
     },
     "engines": {
         "node": ">=26"
@@ -52,14 +53,15 @@
     ],
     "scripts": {
         "test:lint": "tsc --noEmit",
-        "test:unit": "node --conditions=plurnk-dev --test \"src/**/*.test.ts\"",
+        "test:unit": "node --conditions=plurnk-dev --env-file-if-exists=../plurnk-execs/.env.defaults --test \"src/**/*.test.ts\"",
         "test": "npm run test:lint && npm run test:unit",
+        "build:clean": "rm -rf dist",
         "build:dist": "tsc -p tsconfig.build.json",
-        "build": "npm run build:dist",
+        "build": "npm run build:clean && npm run build:dist",
         "prepack": "npm run build",
         "prepublishOnly": "npm audit --audit-level=moderate && npm test"
     },
     "peerDependencies": {
-        "@plurnk/plurnk-execs": "^1.3.12"
+        "@plurnk/plurnk-execs": "^1.4.0"
     }
 }