jsql-neo 4.3.0 → 4.4.0

package/package.json

@@ -1,60 +1,70 @@
 {
-    "name": "jsql-neo",
-    "version": "4.3.0",
-    "description": "JSQL-NEO — Rust-powered embedded database with WASM, REST API, B-Tree indexes, WAL, crash recovery",
-    "main": "index.js",
-    "exports": {
-        ".": {
-            "browser": "./wasm/browser.mjs",
-            "default": "./index.js"
-        },
-        "./wasm/*": "./wasm/*",
-        "./lib/*": "./lib/*",
-        "./package.json": "./package.json"
+  "name": "jsql-neo",
+  "version": "4.4.0",
+  "description": "JSQL-NEO — Rust-powered embedded database with WASM, REST API, B-Tree indexes, WAL, crash recovery",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "browser": "./wasm/browser.mjs",
+      "default": "./index.js"
     },
-    "bin": {
-        "jsql": "./bin/jsql"
+    "./wasm/browser.mjs": {
+      "types": "./wasm/browser.d.ts",
+      "default": "./wasm/browser.mjs"
     },
-    "files": [
-        "index.js",
-        "lib/",
-        "bin/",
-        "wasm/",
-        "native/",
-        "nativesrc/",
-        "!nativesrc/**/target/",
-        "postinstall.js",
-        "README.md",
-        "LICENSE"
-    ],
-    "scripts": {
-        "postinstall": "node postinstall.js"
-    },
-    "keywords": [
-        "database",
-        "sql",
-        "embedded",
-        "rust",
-        "wasm",
-        "json",
-        "javascript",
-        "jsql",
-        "nosql",
-        "rest-api",
-        "high-performance"
-    ],
-    "author": "Vexify",
-    "license": "Apache-2.0",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/vexify-org/JSQL-neo.git"
-    },
-    "bugs": "https://github.com/vexify-org/JSQL-neo/issues",
-    "homepage": "https://github.com/vexify-org/JSQL-neo#readme",
-    "engines": {
-        "node": ">=14.0.0"
-    },
-    "dependencies": {
-        "@vexify-org/yaggs": "^8.1.0"
-    }
+    "./wasm/*": "./wasm/*",
+    "./lib/*": "./lib/*",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "jsql": "./bin/jsql"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "lib/",
+    "bin/",
+    "wasm/",
+    "native/",
+    "nativesrc/",
+    "!nativesrc/**/target/",
+    "postinstall.js",
+    "test/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node postinstall.js",
+    "test": "node test/smoke.js",
+    "test:orms": "node examples/orms/run-all.js"
+  },
+  "keywords": [
+    "database",
+    "sql",
+    "embedded",
+    "rust",
+    "wasm",
+    "json",
+    "javascript",
+    "jsql",
+    "nosql",
+    "rest-api",
+    "high-performance"
+  ],
+  "author": "Vexify",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vexify-org/JSQL-neo.git"
+  },
+  "bugs": "https://github.com/vexify-org/JSQL-neo/issues",
+  "homepage": "https://github.com/vexify-org/JSQL-neo#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "@vexify-org/yaggs": "^8.1.0"
+  }
 }

package/test/smoke.js

@@ -0,0 +1,58 @@
+/*
+ * Zero-dependency smoke test for the SQL engine core.
+ *   npm test   (or: node test/smoke.js)
+ */
+const { executeSQL, parseSQL, applyParams } = require('../lib/sql.js');
+const { createMysqlServer } = require('../lib/mysql_server.js');
+
+let pass = 0, fail = 0;
+const ok = (name, cond, extra) => {
+  if (cond) { pass++; console.log('[OK]', name); }
+  else { fail++; console.log('[FAIL]', name, extra !== undefined ? '→ ' + JSON.stringify(extra) : ''); }
+};
+
+const engine = {
+  hasTable: () => true,
+  truncate: async () => {},
+  flush: async () => {},
+  find: async () => [
+    { id: 1, name: 'A', age: 30 },
+    { id: 2, name: 'B', age: 40 },
+    { id: 3, name: 'C', age: 25 },
+  ],
+  getTableSchema: async () => ({
+    id: { type: 'integer', primaryKey: true },
+    name: { type: 'string' },
+    age: { type: 'integer' },
+  }),
+};
+
+(async () => {
+  const opts = { safety: false };
+
+  const agg = await executeSQL(engine, 'SELECT COUNT(*) AS n, MAX(age) AS m, SUM(age) AS s, AVG(age) AS a FROM users', opts);
+  ok('multi-aggregate SELECT returns all columns', JSON.stringify(agg.columns) === JSON.stringify(['n', 'm', 's', 'a'])
+    && JSON.stringify(agg.rows[0]) === JSON.stringify([3, 40, 95, 31.666666666666668]), { cols: agg.columns, row: agg.rows[0] });
+
+  const w = await executeSQL(engine, 'SELECT name, age FROM users WHERE age > 29 ORDER BY age DESC', opts);
+  ok('WHERE + ORDER BY', w.rows.length === 2 && w.rows[0][1] === 40, w.rows);
+
+  const funcs = await executeSQL(engine, "SELECT CONCAT(name, '!') AS c, UPPER(name) AS u, IFNULL(age, 0) AS f FROM users LIMIT 1", opts);
+  ok('scalar functions CONCAT/UPPER/IFNULL', funcs.rows[0][0] === 'A!' && funcs.rows[0][1] === 'A', funcs.rows);
+
+  const c1 = await executeSQL(engine, 'SELECT COUNT(1) AS n FROM users', opts);
+  ok('COUNT(1) literal', c1.rows[0][0] === 3, c1.rows);
+
+  ok('parseSQL TRUNCATE', parseSQL('TRUNCATE TABLE users').type === 'truncate');
+  ok('parseSQL START TRANSACTION', parseSQL('START TRANSACTION').type === 'begin');
+  ok('parseSQL VALUES DEFAULT', parseSQL(applyParams('INSERT INTO t (id, name) VALUES (DEFAULT, ?)', ['x'])).dataRows[0].id._default === true);
+
+  const srv = createMysqlServer({ port: 0, host: '127.0.0.1', dataDir: ':memory:', noAuth: true });
+  await new Promise(r => srv.listen(r));
+  const addr = srv.address;
+  ok('createMysqlServer listens on ephemeral port', addr && addr.port > 0, addr);
+  srv.close();
+
+  console.log(fail === 0 ? '\nALL SMOKE TESTS PASSED' : `\n${fail} FAILURES`);
+  process.exit(fail === 0 ? 0 : 1);
+})().catch(e => { console.error('FATAL', e.message); process.exit(1); });

package/wasm/browser.d.ts

@@ -0,0 +1,88 @@
+/**
+ * JSQL-NEO browser (WASM + IndexedDB) — ESM entry `jsql-neo/wasm/browser.mjs`.
+ */
+
+export type FieldType =
+  | 'string' | 'integer' | 'float' | 'boolean' | 'date' | 'datetime' | 'timestamp'
+  | 'object' | 'array' | 'any';
+
+export interface FieldDef {
+  type: FieldType;
+  primaryKey?: boolean;
+  autoIncrement?: boolean;
+  unique?: boolean;
+  required?: boolean;
+  length?: number;
+  default?: unknown;
+  computed?: boolean;
+}
+
+export type Schema = Record<string, FieldDef>;
+
+export interface Row {
+  id: number | string;
+  fields?: Record<string, unknown>;
+  created_at?: string;
+  updated_at?: string;
+  [key: string]: unknown;
+}
+
+export interface FindOptions {
+  limit?: number;
+  offset?: number;
+}
+
+export type JSQLHook =
+  | 'beforeInsert' | 'afterInsert'
+  | 'beforeUpdate' | 'afterUpdate'
+  | 'beforeDelete' | 'afterDelete'
+  | 'beforeFind' | 'afterFind'
+  | 'beforeCreateTable' | 'afterCreateTable'
+  | 'beforeDropTable' | 'afterDropTable'
+  | 'beforeFlush' | 'afterFlush'
+  | 'beforeCount' | 'afterCount'
+  | 'onStart' | 'onStop';
+
+export interface JSQLOptions {
+  dbName?: string;
+  persistence?: boolean;
+  flushThreshold?: number;
+  pageSize?: number;
+}
+
+export class JSQL {
+  constructor(opts?: JSQLOptions);
+  on(event: JSQLHook, fn: (...args: any[]) => unknown): this;
+  onEvent(fn: (event: string, data: unknown) => void): this;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  flush(): Promise<void>;
+  createTable(name: string, schema: Schema): Promise<unknown>;
+  dropTable(name: string): Promise<unknown>;
+  insert(table: string, data: Record<string, unknown> | Record<string, unknown>[]): Promise<unknown>;
+  findById(table: string, id: number | string): Promise<Row | null>;
+  findByIds(table: string, ids: Array<number | string>): Promise<Row[] | null>;
+  find(table: string, filter?: Record<string, unknown>, opts?: FindOptions): Promise<Row[]>;
+  count(table: string): Promise<number>;
+  updateById(table: string, id: number | string, data: Record<string, unknown>): Promise<unknown>;
+  updateByIds(table: string, entries: Array<[number | string, Record<string, unknown>]>): Promise<unknown>;
+  removeById(table: string, id: number | string): Promise<unknown>;
+  removeByIds(table: string, ids: Array<number | string>): Promise<unknown>;
+  hasTable(name: string): Promise<boolean>;
+  getTables(): Promise<string[]>;
+  getTableSchema(name: string): Promise<Schema | null>;
+  beginTx(): Promise<void>;
+  commitTx(): Promise<void>;
+  rollbackTx(): Promise<void>;
+  begin(): Promise<void>;
+  commit(): Promise<void>;
+  rollback(): Promise<void>;
+  listDatabases(): Promise<string[]>;
+  createDatabase(name: string): Promise<void>;
+  dropDatabase(name: string): Promise<void>;
+  useDatabase(name: string): Promise<void>;
+  executeSQL(sql: string, params?: unknown[]): Promise<unknown>;
+  export default?: never;
+}
+
+export function init(input?: Uint8Array | ArrayBuffer | Response | WebAssembly.Module | URL | string): Promise<JSQL | void>;