@rawsql-ts/testkit-sqlite 1.0.1 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MSugiura
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,67 +1,67 @@
-# @rawsql-ts/testkit-sqlite
-
-![npm version](https://img.shields.io/npm/v/@rawsql-ts/testkit-sqlite)
-![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
-
-SQLite driver adapter for running repository tests entirely in-memory by shadowing tables with fixture-backed CTEs. Built on `@rawsql-ts/testkit-core` for schema validation and SQL rewrites.
-
-## Features
-
-- In-memory testing with `better-sqlite3`
-- Transparent query interception via `wrapSqliteDriver`
-- Scenario-specific fixture overrides with `withFixtures`
-- Schema registry support for consistent large test suites
-
-## Installation
-
-```bash
-npm install @rawsql-ts/testkit-sqlite
-```
-
-## Quick Start
-
-```ts
-import Database from 'better-sqlite3';
-import { createSqliteSelectTestDriver } from '@rawsql-ts/testkit-sqlite';
-
-const driver = createSqliteSelectTestDriver({
-  connectionFactory: () => new Database(':memory:'),
-  fixtures: [
-    {
-      tableName: 'users',
-      rows: [{ id: 1, name: 'Alice', role: 'admin' }],
-      schema: { columns: { id: 'INTEGER', name: 'TEXT', role: 'TEXT' } },
-    },
-  ],
-  missingFixtureStrategy: 'error',
-});
-
-const rows = await driver.query('SELECT * FROM users');
-```
-
-Use `driver.withFixtures([...])` to derive a scoped driver with scenario-specific overrides, and `driver.close()` to dispose the connection when done.
-
-## Wrapping an Existing Connection
-
-`wrapSqliteDriver` turns any `better-sqlite3` connection into a transparent proxy that intercepts `prepare`, `exec`, `all`, `get`, and `run` — rewriting SELECT statements into fixture-backed CTEs while passing through everything else.
-
-```ts
-import Database from 'better-sqlite3';
-import { wrapSqliteDriver } from '@rawsql-ts/testkit-sqlite';
-
-const raw = new Database(':memory:');
-const intercepted = wrapSqliteDriver(raw, {
-  fixtures: [
-    { tableName: 'orders', rows: [{ id: 1 }], schema: { columns: { id: 'INTEGER' } } },
-  ],
-  missingFixtureStrategy: 'warn',
-  recordQueries: true,
-});
-
-intercepted.prepare('SELECT * FROM orders').all();
-console.log(intercepted.queries); // inspect emitted SQL
-```
-
-## License
-
-MIT
+# @rawsql-ts/testkit-sqlite
+
+![npm version](https://img.shields.io/npm/v/@rawsql-ts/testkit-sqlite)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+
+SQLite driver adapter for running repository tests entirely in-memory by shadowing tables with fixture-backed CTEs. Built on `@rawsql-ts/testkit-core` for schema validation and SQL rewrites.
+
+## Features
+
+- In-memory testing with `better-sqlite3`
+- Transparent query interception via `wrapSqliteDriver`
+- Scenario-specific fixture overrides with `withFixtures`
+- Schema registry support for consistent large test suites
+
+## Installation
+
+```bash
+npm install @rawsql-ts/testkit-sqlite
+```
+
+## Quick Start
+
+```ts
+import Database from 'better-sqlite3';
+import { createSqliteSelectTestDriver } from '@rawsql-ts/testkit-sqlite';
+
+const driver = createSqliteSelectTestDriver({
+  connectionFactory: () => new Database(':memory:'),
+  fixtures: [
+    {
+      tableName: 'users',
+      rows: [{ id: 1, name: 'Alice', role: 'admin' }],
+      schema: { columns: { id: 'INTEGER', name: 'TEXT', role: 'TEXT' } },
+    },
+  ],
+  missingFixtureStrategy: 'error',
+});
+
+const rows = await driver.query('SELECT * FROM users');
+```
+
+Use `driver.withFixtures([...])` to derive a scoped driver with scenario-specific overrides, and `driver.close()` to dispose the connection when done.
+
+## Wrapping an Existing Connection
+
+`wrapSqliteDriver` turns any `better-sqlite3` connection into a transparent proxy that intercepts `prepare`, `exec`, `all`, `get`, and `run` — rewriting SELECT statements into fixture-backed CTEs while passing through everything else.
+
+```ts
+import Database from 'better-sqlite3';
+import { wrapSqliteDriver } from '@rawsql-ts/testkit-sqlite';
+
+const raw = new Database(':memory:');
+const intercepted = wrapSqliteDriver(raw, {
+  fixtures: [
+    { tableName: 'orders', rows: [{ id: 1 }], schema: { columns: { id: 'INTEGER' } } },
+  ],
+  missingFixtureStrategy: 'warn',
+  recordQueries: true,
+});
+
+intercepted.prepare('SELECT * FROM orders').all();
+console.log(intercepted.queries); // inspect emitted SQL
+```
+
+## License
+
+MIT

package/dist/cli/generateSchema.js

@@ -225,16 +225,16 @@ function getDeclaredType(dataType) {
  * Prints the human-friendly CLI usage instructions and exits the process.
  */
 function printUsage() {
-    console.log(`
-Usage:
-  pnpm --filter @rawsql-ts/testkit-sqlite run schema:generate -- --database <path> [--output <path>] [--tables <names>]
-
-Options:
-  --per-table                Emit per-table JSON files instead of a single schema.json (output path becomes a directory).
-    --database, -d <path>      SQLite database file that hosts the CREATE TABLE statements.
-    --output, -o <path>        Path to write schema.json (defaults to schema.json in the current directory).
-    --tables, -t <names>       Comma-separated list of table names to include (case-insensitive).
-    --help, -h                 Show this message.
+    console.log(`
+Usage:
+  pnpm --filter @rawsql-ts/testkit-sqlite run schema:generate -- --database <path> [--output <path>] [--tables <names>]
+
+Options:
+  --per-table                Emit per-table JSON files instead of a single schema.json (output path becomes a directory).
+    --database, -d <path>      SQLite database file that hosts the CREATE TABLE statements.
+    --output, -o <path>        Path to write schema.json (defaults to schema.json in the current directory).
+    --tables, -t <names>       Comma-separated list of table names to include (case-insensitive).
+    --help, -h                 Show this message.
   `);
 }
 void main().catch((error) => {

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "@rawsql-ts/testkit-sqlite",
-  "version": "1.0.1",
-  "description": "SQLite driver adapters for the rawsql-ts select query test harness.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "prepack": "node -e \"const fs=require('fs');const cp=require('child_process');const npm=process.platform==='win32'?'npm.cmd':'npm';if(!fs.existsSync('dist/index.js')){process.exit(cp.spawnSync(npm,['run','build'],{stdio:'inherit'}).status??1)}\"",
-    "build": "tsc -p tsconfig.build.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src tests --ext .ts",
-    "schema:generate": "ts-node --project tsconfig.json src/cli/generateSchema.ts",
-    "postinstall": "node ./scripts/install-better-sqlite3.cjs",
-    "release": "npm run lint && npm run test && npm run build && node -e \"require('fs').mkdirSync('../../tmp', { recursive: true })\" && pnpm pack --out ../../tmp/rawsql-ts-testkit-sqlite.tgz && pnpm publish --access public"
-  },
-  "keywords": [
-    "sqlite",
-    "testing",
-    "fixtures",
-    "rawsql"
-  ],
-  "license": "MIT",
-  "author": "msugiura",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mk3008/rawsql-ts.git",
-    "directory": "packages/testkit-sqlite"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "@rawsql-ts/testkit-core": "workspace:^",
-    "rawsql-ts": "workspace:^"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "better-sqlite3": "^12.4.1",
-    "dotenv": "^16.4.7",
-    "typescript": "^5.8.2",
-    "vitest": "^4.0.7",
-    "ts-node": "^10.9.2"
-  },
-  "files": [
-    "dist"
-  ]
-}
+{
+  "name": "@rawsql-ts/testkit-sqlite",
+  "version": "1.0.2",
+  "description": "SQLite driver adapters for the rawsql-ts select query test harness.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "sqlite",
+    "testing",
+    "fixtures",
+    "rawsql"
+  ],
+  "license": "MIT",
+  "author": "msugiura",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mk3008/rawsql-ts.git",
+    "directory": "packages/testkit-sqlite"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@rawsql-ts/testkit-core": "^0.16.1",
+    "rawsql-ts": "^0.17.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.4.1",
+    "dotenv": "^16.4.7",
+    "typescript": "^5.8.2",
+    "vitest": "^4.0.7",
+    "ts-node": "^10.9.2"
+  },
+  "files": [
+    "dist",
+    "scripts"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src tests --ext .ts",
+    "schema:generate": "ts-node --project tsconfig.json src/cli/generateSchema.ts",
+    "postinstall": "node ./scripts/install-better-sqlite3.cjs",
+    "release": "npm run lint && npm run test && npm run build && node -e \"require('fs').mkdirSync('../../tmp', { recursive: true })\" && pnpm pack --out ../../tmp/rawsql-ts-testkit-sqlite.tgz && pnpm publish --access public"
+  }
+}

package/scripts/install-better-sqlite3.cjs

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+const https = require('node:https');
+const { spawnSync } = require('node:child_process');
+
+const packageRoot = path.resolve(__dirname, '..');
+let pkgJsonPath;
+try {
+  pkgJsonPath = require.resolve('better-sqlite3/package.json', { paths: [packageRoot] });
+} catch (error) {
+  console.warn('[better-sqlite3-prebuild] better-sqlite3 is not installed yet.');
+  process.exit(0);
+}
+
+const betterRoot = path.dirname(pkgJsonPath);
+const betterPkg = require(pkgJsonPath);
+const version = betterPkg.version;
+const abi = process.versions.modules;
+const platform = process.platform;
+const arch = process.arch;
+const bindingDir = path.join(betterRoot, 'lib', 'binding', `node-v${abi}-${platform}-${arch}`);
+const releaseDir = path.join(betterRoot, 'build', 'Release');
+const bindingFile = path.join(bindingDir, 'better_sqlite3.node');
+
+if (fs.existsSync(bindingFile)) {
+  process.exit(0);
+}
+
+const assetName = `better-sqlite3-v${version}-node-v${abi}-${platform}-${arch}.tar.gz`;
+const downloadUrl = `https://github.com/WiseLibs/better-sqlite3/releases/download/v${version}/${assetName}`;
+
+const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'better-sqlite3-'));
+const archivePath = path.join(tmpDir, assetName);
+
+const download = (url = downloadUrl, redirectCount = 0) =>
+  new Promise((resolve, reject) => {
+    https
+      .get(url, (response) => {
+        if (
+          response.statusCode &&
+          response.statusCode >= 300 &&
+          response.statusCode < 400 &&
+          response.headers.location
+        ) {
+          // Follow GitHub's redirector (a HEAD object would yield a 302 first).
+          if (redirectCount >= 5) {
+            reject(new Error('Too many redirects while downloading prebuilt binary'));
+            return;
+          }
+          response.resume();
+          download(response.headers.location, redirectCount + 1).then(resolve).catch(reject);
+          return;
+        }
+
+        if (response.statusCode && response.statusCode >= 400) {
+          reject(new Error(`Failed to download prebuilt binary (${response.statusCode})`));
+          response.resume();
+          return;
+        }
+
+        // Stream the payload into the archive path once we have a 200 response.
+        const file = fs.createWriteStream(archivePath);
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close(resolve);
+        });
+        file.on('error', reject);
+      })
+      .on('error', reject);
+  });
+
+(async () => {
+  try {
+    await download();
+  } catch (error) {
+    console.warn(`[better-sqlite3-prebuild] ${error.message}`);
+    process.exit(0);
+  }
+
+  const extractResult = spawnSync('tar', ['-xzf', archivePath, '-C', tmpDir], {
+    stdio: 'inherit',
+  });
+
+  if (extractResult.status !== 0) {
+    console.warn('[better-sqlite3-prebuild] Failed to extract archive, skipping.');
+    process.exit(0);
+  }
+
+  const locatePrebuilt = (searchDir) => {
+    // Depth-first search so we can handle archives that wrap binaries with additional folders.
+    for (const entry of fs.readdirSync(searchDir, { withFileTypes: true })) {
+      const fullPath = path.join(searchDir, entry.name);
+      if (entry.isDirectory()) {
+        const nested = locatePrebuilt(fullPath);
+        if (nested) {
+          return nested;
+        }
+      } else if (entry.isFile() && entry.name === 'better_sqlite3.node') {
+        return fullPath;
+      }
+    }
+    return undefined;
+  };
+
+  const prebuildRelease = locatePrebuilt(tmpDir);
+  if (!prebuildRelease) {
+    console.warn('[better-sqlite3-prebuild] Extracted archive did not contain better_sqlite3.node');
+    process.exit(0);
+  }
+
+  fs.mkdirSync(bindingDir, { recursive: true });
+  fs.mkdirSync(releaseDir, { recursive: true });
+  fs.copyFileSync(prebuildRelease, bindingFile);
+  fs.copyFileSync(prebuildRelease, path.join(releaseDir, 'better_sqlite3.node'));
+  console.log(`[better-sqlite3-prebuild] Installed ${assetName}`);
+})();