@mark1russell7/client-sqlite 0.0.0-stage → 0.1.0

package/dist/module.js

@@ -0,0 +1,287 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for SQLite
+ *
+ * Registers database and logging procedures with the client system.
+ * This file is referenced by package.json's client.procedures field.
+ */
+import { createProcedure, zodAdapter, defineModule } from "@mark1russell7/client";
+import { z } from "zod";
+import { withConnection, query, execute, lastInsertRowId, runMigrations, } from "@mark1russell7/docker-sqlite";
+import { DEFAULT_DB_PATH, LOG_LEVELS, } from "./types.js";
+// =============================================================================
+// Schemas
+// =============================================================================
+// Real schemas (roadmap 2.1): the input is validated before the handler, and the MCP tool list
+// and the help of mark describe each field. zodAdapter<T> checks each schema against its type.
+const dbPathField = z
+    .string()
+    .optional()
+    .describe(`The SQLite database file (default: ${DEFAULT_DB_PATH}). A query does not make a missing file.`);
+const paramsField = z
+    .array(z.unknown())
+    .optional()
+    .describe("The values of the ? placeholders of the SQL, in order");
+const logLevel = z.enum(LOG_LEVELS, { error: (issue) => `Invalid log level: ${JSON.stringify(issue.input)}` });
+/** A non-negative integer: it goes into the SQL text, so the schema is strict. */
+const nonNegativeInteger = (field) => z
+    .number({ error: (issue) => `Invalid ${field}: expected a non-negative integer, got ${JSON.stringify(issue.input)}` })
+    .int({ error: `Invalid ${field}: expected a non-negative integer` })
+    .min(0, { error: `Invalid ${field}: expected a non-negative integer` });
+const dbQueryInputSchema = zodAdapter(z.object({
+    sql: z.string().describe("The SQL query (SELECT)"),
+    params: paramsField,
+    dbPath: dbPathField,
+}));
+const dbQueryOutputSchema = zodAdapter(z.looseObject({
+    columns: z.array(z.string()).describe("The column names"),
+    rows: z.array(z.record(z.string(), z.unknown())).describe("The rows, one object for each row"),
+}));
+const dbExecuteInputSchema = zodAdapter(z.object({
+    sql: z.string().describe("The SQL statement or script (INSERT, UPDATE, DELETE, CREATE TABLE, ...)"),
+    params: paramsField,
+    dbPath: dbPathField,
+}));
+const dbExecuteOutputSchema = zodAdapter(z.looseObject({ changes: z.number().describe("The number of rows that the statements changed") }));
+const logsStoreInputSchema = zodAdapter(z.object({
+    level: logLevel.describe("The level: trace, debug, info, warn or error"),
+    message: z.string().describe("The log message"),
+    sessionId: z.string().optional().describe("The session that the entry belongs to (to group entries)"),
+    command: z.string().optional().describe("The command that made the entry"),
+    context: z.string().optional().describe("More context, for example a package name"),
+    data: z.record(z.string(), z.unknown()).optional().describe("Structured data of the entry"),
+    errorStack: z.string().optional().describe("The stack trace of an error"),
+    dbPath: dbPathField,
+}));
+const logsStoreOutputSchema = zodAdapter(z.looseObject({ id: z.number().describe("The id of the new log row") }));
+const logsQueryInputSchema = zodAdapter(z.object({
+    sessionId: z.string().optional().describe("Only the entries of this session"),
+    command: z.string().optional().describe("Only the entries of this command"),
+    level: z.union([logLevel, z.array(logLevel)]).optional().describe("Only the entries of this level, or of these levels"),
+    limit: nonNegativeInteger("limit").optional().describe("The most entries to give"),
+    offset: nonNegativeInteger("offset").optional().describe("The number of entries to skip (for pages)"),
+    orderBy: z.enum(["asc", "desc"]).optional().describe("The order by time: desc (the default, newest first) or asc"),
+    dbPath: dbPathField,
+}));
+const logsQueryOutputSchema = zodAdapter(z.looseObject({
+    logs: z
+        .array(z.looseObject({
+        id: z.number().describe("The id of the log row"),
+        timestamp: z.string().describe("The time of the entry (SQLite datetime text, UTC)"),
+        level: logLevel.describe("The level of the entry"),
+        message: z.string().describe("The log message"),
+        data: z.record(z.string(), z.unknown()).nullable().describe("The structured data of the entry, or null"),
+        sessionId: z.string().nullable().describe("The session of the entry, or null"),
+        command: z.string().nullable().describe("The command that made the entry, or null"),
+        context: z.string().nullable().describe("More context, or null"),
+        errorStack: z.string().nullable().describe("The stack trace of an error, or null"),
+    }))
+        .describe("The entries that match the filters, in the order of orderBy"),
+    total: z.number().optional().describe("The number of entries that match the filters, without limit and offset"),
+}));
+// =============================================================================
+// Log Table Migrations
+// =============================================================================
+const LOG_MIGRATIONS = [
+    {
+        version: 1,
+        description: "Create logs table",
+        up: `
+      CREATE TABLE IF NOT EXISTS logs (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        timestamp TEXT NOT NULL DEFAULT (datetime('now')),
+        level TEXT NOT NULL CHECK (level IN ('trace', 'debug', 'info', 'warn', 'error')),
+        message TEXT NOT NULL,
+        data TEXT,
+        session_id TEXT,
+        command TEXT,
+        context TEXT,
+        error_stack TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+      CREATE INDEX IF NOT EXISTS idx_logs_session ON logs(session_id);
+      CREATE INDEX IF NOT EXISTS idx_logs_level ON logs(level);
+      CREATE INDEX IF NOT EXISTS idx_logs_timestamp ON logs(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_logs_command ON logs(command);
+    `,
+        down: "DROP TABLE IF EXISTS logs;",
+    },
+];
+/**
+ * Ensure the logs table exists
+ */
+async function ensureLogsTable(dbPath) {
+    await withConnection({ dbPath }, (db) => {
+        runMigrations(db, LOG_MIGRATIONS);
+    });
+}
+// =============================================================================
+// db.query Procedure
+// =============================================================================
+const dbQueryProcedure = createProcedure()
+    .path(["db", "query"])
+    .input(dbQueryInputSchema)
+    .output(dbQueryOutputSchema)
+    .meta({ description: "Execute a SQL SELECT query" })
+    .handler(async (input) => {
+    const dbPath = input.dbPath ?? DEFAULT_DB_PATH;
+    const params = input.params ?? [];
+    return withConnection({ dbPath }, (db) => {
+        const result = query(db, input.sql, params);
+        return {
+            columns: result.columns,
+            rows: result.rows,
+        };
+    });
+})
+    .build();
+// =============================================================================
+// db.execute Procedure
+// =============================================================================
+const dbExecuteProcedure = createProcedure()
+    .path(["db", "execute"])
+    .input(dbExecuteInputSchema)
+    .output(dbExecuteOutputSchema)
+    .meta({ description: "Execute a SQL statement (INSERT, UPDATE, DELETE)" })
+    .handler(async (input) => {
+    const dbPath = input.dbPath ?? DEFAULT_DB_PATH;
+    const params = input.params ?? [];
+    return withConnection({ dbPath }, (db) => {
+        const result = execute(db, input.sql, params);
+        return { changes: result.changes };
+    });
+})
+    .build();
+// =============================================================================
+// logs.store Procedure
+// =============================================================================
+const logsStoreProcedure = createProcedure()
+    .path(["logs", "store"])
+    .input(logsStoreInputSchema)
+    .output(logsStoreOutputSchema)
+    .meta({ description: "Store a log entry in the database" })
+    .handler(async (input) => {
+    const dbPath = input.dbPath ?? DEFAULT_DB_PATH;
+    // Validate log level
+    if (!LOG_LEVELS.includes(input.level)) {
+        throw new Error(`Invalid log level: ${input.level}`);
+    }
+    // Ensure table exists
+    await ensureLogsTable(dbPath);
+    return withConnection({ dbPath }, (db) => {
+        const dataJson = input.data ? JSON.stringify(input.data) : null;
+        execute(db, `INSERT INTO logs (level, message, data, session_id, command, context, error_stack)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            input.level,
+            input.message,
+            dataJson,
+            input.sessionId ?? null,
+            input.command ?? null,
+            input.context ?? null,
+            input.errorStack ?? null,
+        ]);
+        const id = lastInsertRowId(db);
+        return { id };
+    });
+})
+    .build();
+// =============================================================================
+// logs.query Procedure
+// =============================================================================
+/**
+ * Validate a value as a non-negative integer before it is interpolated into
+ * SQL. The input schema is a pass-through, so `limit`/`offset` can arrive as
+ * arbitrary values; interpolating them directly is a SQL injection / syntax
+ * hazard. Throws on anything that is not a finite, non-negative integer.
+ */
+function toNonNegativeInt(value, field) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
+        throw new Error(`Invalid ${field}: expected a non-negative integer, got ${JSON.stringify(value)}`);
+    }
+    return value;
+}
+const logsQueryProcedure = createProcedure()
+    .path(["logs", "query"])
+    .input(logsQueryInputSchema)
+    .output(logsQueryOutputSchema)
+    .meta({ description: "Query log entries from the database" })
+    .handler(async (input) => {
+    const dbPath = input.dbPath ?? DEFAULT_DB_PATH;
+    // Ensure table exists
+    await ensureLogsTable(dbPath);
+    return withConnection({ dbPath }, (db) => {
+        const conditions = [];
+        const params = [];
+        if (input.sessionId !== undefined) {
+            conditions.push("session_id = ?");
+            params.push(input.sessionId);
+        }
+        if (input.command !== undefined) {
+            conditions.push("command = ?");
+            params.push(input.command);
+        }
+        if (input.level !== undefined) {
+            const levels = Array.isArray(input.level) ? input.level : [input.level];
+            const placeholders = levels.map(() => "?").join(", ");
+            conditions.push(`level IN (${placeholders})`);
+            params.push(...levels);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+        const orderDir = input.orderBy === "asc" ? "ASC" : "DESC";
+        let limitClause = input.limit !== undefined
+            ? `LIMIT ${toNonNegativeInt(input.limit, "limit")}`
+            : "";
+        let offsetClause = "";
+        if (input.offset !== undefined) {
+            offsetClause = `OFFSET ${toNonNegativeInt(input.offset, "offset")}`;
+            // SQLite's grammar only allows OFFSET as part of a LIMIT clause; an
+            // OFFSET with no LIMIT is a syntax error. Use "LIMIT -1" (unbounded)
+            // so an offset-only query remains valid.
+            if (input.limit === undefined) {
+                limitClause = "LIMIT -1";
+            }
+        }
+        const sql = `
+        SELECT id, timestamp, level, message, data, session_id, command, context, error_stack
+        FROM logs
+        ${whereClause}
+        ORDER BY timestamp ${orderDir}
+        ${limitClause}
+        ${offsetClause}
+      `;
+        const result = query(db, sql, params);
+        const logs = result.rows.map((row) => ({
+            id: row.id,
+            timestamp: row.timestamp,
+            level: row.level,
+            message: row.message,
+            data: row.data ? JSON.parse(row.data) : null,
+            sessionId: row.session_id,
+            command: row.command,
+            context: row.context,
+            errorStack: row.error_stack,
+        }));
+        // Total number of rows matching the filters, ignoring LIMIT/OFFSET, so
+        // callers can paginate. `params` holds only the WHERE-clause bindings.
+        const countResult = query(db, `SELECT COUNT(*) AS total FROM logs ${whereClause}`, params);
+        const total = countResult.rows[0]?.total ?? 0;
+        return { logs, total };
+    });
+})
+    .build();
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export const sqliteModule = defineModule("@mark1russell7/client-sqlite", [
+    dbQueryProcedure,
+    dbExecuteProcedure,
+    logsStoreProcedure,
+    logsQueryProcedure,
+]);
+export default sqliteModule;
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Importing this file registers the procedures of @mark1russell7/client-sqlite in the global registry
+ * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
+ * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ */
+export * from "./module.js";
+export declare function registerSqliteProcedures(): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,cAAc,aAAa,CAAC;AAE5B,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/register.js

@@ -0,0 +1,14 @@
+/**
+ * Importing this file registers the procedures of @mark1russell7/client-sqlite in the global registry
+ * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
+ * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ */
+import { registerProcedures } from "@mark1russell7/client";
+import { sqliteModule } from "./module.js";
+export * from "./module.js";
+export function registerSqliteProcedures() {
+    registerProcedures(sqliteModule.procedures);
+}
+// Auto-register when this module is loaded
+registerSqliteProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,cAAc,aAAa,CAAC;AAE5B,MAAM,UAAU,wBAAwB;IACtC,kBAAkB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,2CAA2C;AAC3C,wBAAwB,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Type definitions for client-sqlite procedures
+ */
+/**
+ * Default database path for CLI logs
+ */
+export declare const DEFAULT_DB_PATH: string;
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error";
+export declare const LOG_LEVELS: readonly LogLevel[];
+export interface DbQueryInput {
+    /** SQL query to execute */
+    sql: string;
+    /** Query parameters */
+    params?: unknown[] | undefined;
+    /** Database path (defaults to CLI log database) */
+    dbPath?: string | undefined;
+}
+export interface DbQueryOutput<T = Record<string, unknown>> {
+    /** Column names */
+    columns: string[];
+    /** Query results */
+    rows: T[];
+}
+export interface DbExecuteInput {
+    /** SQL statement to execute (INSERT, UPDATE, DELETE, etc.) */
+    sql: string;
+    /** Statement parameters */
+    params?: unknown[] | undefined;
+    /** Database path (defaults to CLI log database) */
+    dbPath?: string | undefined;
+}
+export interface DbExecuteOutput {
+    /** Number of rows affected */
+    changes: number;
+}
+export interface LogsStoreInput {
+    /** Log level */
+    level: LogLevel;
+    /** Log message */
+    message: string;
+    /** Session ID for grouping logs */
+    sessionId?: string | undefined;
+    /** Command that generated this log */
+    command?: string | undefined;
+    /** Additional context (e.g., package name) */
+    context?: string | undefined;
+    /** Additional structured data */
+    data?: Record<string, unknown> | undefined;
+    /** Error stack trace if applicable */
+    errorStack?: string | undefined;
+    /** Database path (defaults to CLI log database) */
+    dbPath?: string | undefined;
+}
+export interface LogsStoreOutput {
+    /** ID of the inserted log row */
+    id: number;
+}
+export interface LogsQueryInput {
+    /** Filter by session ID */
+    sessionId?: string | undefined;
+    /** Filter by command */
+    command?: string | undefined;
+    /** Filter by log level(s) */
+    level?: LogLevel | LogLevel[] | undefined;
+    /** Maximum number of logs to return */
+    limit?: number | undefined;
+    /** Offset for pagination */
+    offset?: number | undefined;
+    /** Order by (default: timestamp DESC) */
+    orderBy?: "asc" | "desc" | undefined;
+    /** Database path (defaults to CLI log database) */
+    dbPath?: string | undefined;
+}
+export interface LogEntry {
+    id: number;
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    data: Record<string, unknown> | null;
+    sessionId: string | null;
+    command: string | null;
+    context: string | null;
+    errorStack: string | null;
+}
+export interface LogsQueryOutput {
+    /** Log entries matching the query */
+    logs: LogEntry[];
+    /** Total count (if limit was applied) */
+    total?: number | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,20 @@
+/**
+ * Type definitions for client-sqlite procedures
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+// =============================================================================
+// Configuration
+// =============================================================================
+/**
+ * Default database path for CLI logs
+ */
+export const DEFAULT_DB_PATH = join(homedir(), "logs", "cli", "cli.db");
+export const LOG_LEVELS = [
+    "trace",
+    "debug",
+    "info",
+    "warn",
+    "error",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AAQhF,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;CACC,CAAC"}

package/package.json

@@ -1,6 +1,77 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@mark1russell7/client-sqlite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "SQLite procedures with sql.js and no native build: db.query, db.execute and structured logs (logs.store, logs.query), safe for concurrent writes.",
+  "keywords": [
+    "sqlite",
+    "sql.js",
+    "database",
+    "logging",
+    "procedures"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/client-sqlite"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "dependencies": {
+    "@mark1russell7/client": "0.1.0",
+    "@mark1russell7/docker-sqlite": "^0.1.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@mark1russell7/cue": "^1.0.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }

package/src/index.ts

@@ -0,0 +1,88 @@
+/**
+ * client-sqlite
+ *
+ * SQLite database operations via client procedures.
+ * Enables database queries and logging via client.call().
+ *
+ * @example
+ * ```typescript
+ * import { Client } from "client";
+ *
+ * const client = new Client(...);
+ *
+ * // Execute a query
+ * const result = await client.call(["db", "query"], {
+ *   sql: "SELECT * FROM logs WHERE level = ?",
+ *   params: ["error"]
+ * });
+ * console.log(result.rows);
+ *
+ * // Store a log entry
+ * await client.call(["logs", "store"], {
+ *   level: "info",
+ *   message: "Task completed",
+ *   sessionId: "20241215-143052-a7b3",
+ *   command: "lib.refresh"
+ * });
+ *
+ * // Query logs
+ * const { logs } = await client.call(["logs", "query"], {
+ *   sessionId: "20241215-143052-a7b3",
+ *   level: ["error", "warn"],
+ *   limit: 100
+ * });
+ * ```
+ */
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type {
+  DbQueryInput,
+  DbQueryOutput,
+  DbExecuteInput,
+  DbExecuteOutput,
+  LogsStoreInput,
+  LogsStoreOutput,
+  LogsQueryInput,
+  LogsQueryOutput,
+  LogEntry,
+  LogLevel,
+} from "./types.js";
+
+export { DEFAULT_DB_PATH, LOG_LEVELS } from "./types.js";
+
+// =============================================================================
+// Registration
+// =============================================================================
+
+export { registerSqliteProcedures } from "./register.js";
+
+// =============================================================================
+// Re-export docker-sqlite utilities for direct use
+// =============================================================================
+
+export {
+  withConnection,
+  createConnection,
+  query,
+  execute,
+  execMultiple,
+  lastInsertRowId,
+  tableExists,
+  getMigrationStatus,
+  runMigrations,
+  rollbackMigration,
+  createMigration,
+} from "@mark1russell7/docker-sqlite";
+
+export type {
+  ConnectionConfig,
+  ConnectionCallback,
+  QueryResult,
+  ExecuteResult,
+  Migration,
+  MigrationStatus,
+  Database,
+} from "@mark1russell7/docker-sqlite";