@streetjs/schema-inspector 1.0.0

package/ARCHITECTURE.md

@@ -0,0 +1,79 @@
+# Architecture — @streetjs/schema-inspector
+
+## Purpose
+
+`@streetjs/schema-inspector` turns a live database connection into a normalized,
+engine-agnostic `DatabaseSchema`. It is the introspection layer the migration
+differ and dev tooling build on. It is deliberately decoupled from any concrete
+connection pool: it speaks only the structural `QueryablePool` interface and
+routes by the pool's constructor name.
+
+## Dependencies
+
+```
+@streetjs/postgres   (the shared DbResult result type only)
+```
+
+That is the sole dependency, and it is used purely for the `DbResult` type that
+`QueryablePool.query` resolves to. No cyclic dependencies; no coupling to
+`@streetjs/pool`, the wasm SQLite module, or any MySQL driver.
+
+## Design
+
+### Structural pool interface
+
+```ts
+interface QueryablePool { query(sql: string, params?: unknown[]): Promise<DbResult> }
+```
+
+`PgPool`, `MysqlPool`, and `SqlitePool` all satisfy this structurally, so the
+inspector never imports a concrete class. Dialect selection is by
+`pool.constructor.name`:
+
+- `SqlitePool` → PRAGMA-based introspection;
+- `PgPool` → `information_schema` + `pg_indexes`;
+- anything else → MySQL/MariaDB `information_schema`.
+
+This name-based routing is what lets the package stay dependency-light: the
+concrete pools live in other packages/core, but the inspector only needs their
+runtime `query` method.
+
+### Normalization
+
+Each engine path issues a small, fixed set of catalogue queries and folds the
+rows into a `Map<tableName, TableSchema>`:
+
+- **Postgres** parses index column lists out of the `indexdef` DDL string and
+  treats `is_pk` values of `'t'`/`'true'` as primary-key membership.
+- **MySQL** groups the one-row-per-column `STATISTICS` output into composite
+  `IndexMeta` and reads `NON_UNIQUE = '0'` as unique.
+- **SQLite** reads `PRAGMA table_info` for columns/PK (sorted by the `pk`
+  position for composite keys), `foreign_key_list` for FKs, and
+  `index_list` + `index_info` for indexes.
+
+All values arrive as strings (matching the text-protocol/affinity semantics of
+`DbResult`), so parsing is uniform and every field access is defended with a
+fallback (`?? ''` / `?? null`).
+
+### Caching
+
+`inspect` caches the resulting `DatabaseSchema` per pool object (a
+`Map<object, { schema, expiresAt }>`) for a configurable TTL (default 60s).
+`invalidateCache(pool)` drops the entry to force a fresh read. The cache is keyed
+by object identity, so distinct pools never collide.
+
+## Testing
+
+The suite runs with **no live database** by supplying fake `QueryablePool`
+objects whose `constructor.name` is `PgPool`/`SqlitePool`/`MysqlPool`, driving
+each dialect path with canned catalogue rows. It covers primary keys (including
+composite and the `'t'`/`'true'` encodings), foreign keys, unique/non-unique and
+multi-column index parsing, quoted-identifier stripping, empty databases,
+per-field fallbacks for sparse rows, and the full cache/TTL/invalidation
+lifecycle. Coverage is 100% lines/functions and ≥98% branches.
+
+## Non-goals
+
+- No DDL generation or migration diffing (that is the migration layer).
+- No connection management (that is `@streetjs/pool` / the SQLite pool).
+- No data reads beyond catalogue introspection.

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to `@streetjs/schema-inspector` are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0]
+
+### Added
+
+- Initial standalone release of the StreetJS database schema introspector,
+  extracted from the `streetjs` core (`src/database/schema-inspector.ts`).
+- `SchemaInspector.inspect(pool, opts?)` returning a unified `DatabaseSchema`
+  (tables, columns, primary keys, foreign keys, indexes) for PostgreSQL,
+  MySQL/MariaDB, and SQLite, with per-pool TTL caching (default 60s).
+- `SchemaInspector.invalidateCache(pool)`.
+- Public types: `DatabaseSchema`, `TableSchema`, `ColumnMeta`, `FkMeta`,
+  `IndexMeta`, and the structural `QueryablePool` interface.
+- Decoupled from concrete pools: routes by `constructor.name` and depends only on
+  `@streetjs/postgres` for the shared `DbResult` type. ESM.
+- 14 tests (no live database required), 100% line coverage, and a runnable
+  example. During extraction the public signature was generalized from
+  `PgPool | SqlitePool | QueryablePool` to `QueryablePool`; both `PgPool` and
+  `SqlitePool` satisfy it structurally, so existing callers are unaffected.
+
+[1.0.0]: https://github.com/hassanmubiru/StreetJS/releases/tag/schema-inspector-v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 street contributors
+
+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

@@ -0,0 +1,90 @@
+# @streetjs/schema-inspector
+
+The StreetJS database schema introspector: produces a unified
+`DatabaseSchema` — tables, columns, primary keys, foreign keys, and indexes —
+from a live **PostgreSQL**, **MySQL/MariaDB**, or **SQLite** database, with
+per-pool TTL caching. ESM, strict-TypeScript.
+
+It talks only through a structural `QueryablePool` interface and routes by the
+pool's constructor name, so it has **no dependency on any concrete pool
+implementation** — the only dependency is `@streetjs/postgres` for the shared
+`DbResult` type.
+
+This is the standalone home of the inspector that also backs the `streetjs`
+framework. The framework re-exports this package, so there is a single source of
+truth.
+
+## Install
+
+```bash
+npm install @streetjs/schema-inspector
+```
+
+## Usage
+
+```ts
+import { SchemaInspector } from '@streetjs/schema-inspector';
+
+// `pool` can be any object with `query(sql, params?): Promise<DbResult>`
+// — PgPool, MysqlPool, and SqlitePool all qualify.
+const schema = await SchemaInspector.inspect(pool);
+
+for (const table of schema.tables) {
+  console.log(table.name, table.primaryKey, table.columns.length);
+}
+```
+
+## API
+
+### `SchemaInspector.inspect(pool, opts?): Promise<DatabaseSchema>`
+
+Introspects the database and returns its schema. Results are cached per pool for
+`opts.ttlMs` milliseconds (default `60000`). The dialect is detected from the
+pool's constructor name (`PgPool` → PostgreSQL, `SqlitePool` → SQLite, anything
+else → MySQL/MariaDB).
+
+### `SchemaInspector.invalidateCache(pool): void`
+
+Drops the cached schema for `pool` so the next `inspect` re-fetches.
+
+### Types
+
+```ts
+interface DatabaseSchema { tables: TableSchema[]; inspectedAt: Date }
+interface TableSchema {
+  name: string;
+  columns: ColumnMeta[];
+  primaryKey: string[];
+  foreignKeys: FkMeta[];
+  indexes: IndexMeta[];
+}
+interface ColumnMeta { name: string; type: string; nullable: boolean; default: string | null }
+interface FkMeta { column: string; refTable: string; refColumn: string }
+interface IndexMeta { name: string; columns: string[]; unique: boolean }
+interface QueryablePool { query(sql: string, params?: unknown[]): Promise<DbResult> }
+```
+
+## How it works
+
+- **PostgreSQL** — three round-trips against `information_schema` (columns +
+  primary keys), `referential_constraints` (foreign keys), and `pg_indexes`
+  (indexes, with the column list parsed from `indexdef`).
+- **MySQL/MariaDB** — `information_schema.COLUMNS`/`KEY_COLUMN_USAGE`/`STATISTICS`,
+  grouping the per-column `STATISTICS` rows into composite indexes.
+- **SQLite** — `sqlite_master` for the table list, then `PRAGMA table_info`,
+  `index_list`/`index_info`, and `foreign_key_list` per table.
+
+All engines normalize into the same `DatabaseSchema` shape.
+
+## Example
+
+A complete runnable example lives in
+[`src/examples/integration.ts`](./src/examples/integration.ts):
+
+```bash
+npm run example -w packages/schema-inspector
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @streetjs/schema-inspector — the StreetJS database schema introspector.
+ *
+ * Produces a unified {@link DatabaseSchema} — tables, columns, primary keys,
+ * foreign keys, and indexes — from a live PostgreSQL, MySQL/MariaDB, or SQLite
+ * database, with per-pool TTL caching. It routes by the pool's constructor name
+ * and talks only through the structural {@link QueryablePool} interface, so it
+ * has no dependency on any concrete pool implementation. Public API only.
+ *
+ * ```ts
+ * import { SchemaInspector } from '@streetjs/schema-inspector';
+ *
+ * const schema = await SchemaInspector.inspect(pool); // any queryable pool
+ * for (const table of schema.tables) console.log(table.name, table.columns.length);
+ * ```
+ *
+ * > This is the standalone home of the inspector that also backs the `streetjs`
+ * > framework; the framework re-exports it, so there is a single implementation.
+ */
+export { SchemaInspector } from './schema-inspector.js';
+export type { ColumnMeta, IndexMeta, FkMeta, TableSchema, DatabaseSchema, QueryablePool, } from './schema-inspector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EACV,UAAU,EACV,SAAS,EACT,MAAM,EACN,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * @streetjs/schema-inspector — the StreetJS database schema introspector.
+ *
+ * Produces a unified {@link DatabaseSchema} — tables, columns, primary keys,
+ * foreign keys, and indexes — from a live PostgreSQL, MySQL/MariaDB, or SQLite
+ * database, with per-pool TTL caching. It routes by the pool's constructor name
+ * and talks only through the structural {@link QueryablePool} interface, so it
+ * has no dependency on any concrete pool implementation. Public API only.
+ *
+ * ```ts
+ * import { SchemaInspector } from '@streetjs/schema-inspector';
+ *
+ * const schema = await SchemaInspector.inspect(pool); // any queryable pool
+ * for (const table of schema.tables) console.log(table.name, table.columns.length);
+ * ```
+ *
+ * > This is the standalone home of the inspector that also backs the `streetjs`
+ * > framework; the framework re-exports it, so there is a single implementation.
+ */
+export { SchemaInspector } from './schema-inspector.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/schema-inspector.d.ts

@@ -0,0 +1,80 @@
+import type { DbResult } from '@streetjs/postgres';
+export interface ColumnMeta {
+    name: string;
+    type: string;
+    nullable: boolean;
+    default: string | null;
+}
+export interface IndexMeta {
+    name: string;
+    columns: string[];
+    unique: boolean;
+}
+export interface FkMeta {
+    column: string;
+    refTable: string;
+    refColumn: string;
+}
+export interface TableSchema {
+    name: string;
+    columns: ColumnMeta[];
+    primaryKey: string[];
+    foreignKeys: FkMeta[];
+    indexes: IndexMeta[];
+}
+export interface DatabaseSchema {
+    tables: TableSchema[];
+    inspectedAt: Date;
+}
+/**
+ * Minimal interface satisfied by any Street database pool — `PgPool`,
+ * `MysqlPool`, and `SqlitePool` all match it structurally. The inspector routes
+ * by the pool's constructor name, so it never needs to import a concrete pool
+ * class (keeping this package free of engine-specific dependencies).
+ */
+export interface QueryablePool {
+    query(sql: string, params?: unknown[]): Promise<DbResult>;
+}
+interface CacheEntry {
+    schema: DatabaseSchema;
+    expiresAt: number;
+}
+export declare class SchemaInspector {
+    /** Schema cache keyed by pool object reference. */
+    static readonly _cache: Map<object, CacheEntry>;
+    /**
+     * Inspect the connected database and return its schema.
+     * Results are cached for `opts.ttlMs` milliseconds (default 60 000).
+     */
+    static inspect(pool: QueryablePool, opts?: {
+        ttlMs?: number;
+    }): Promise<DatabaseSchema>;
+    /**
+     * Remove the cached schema for `pool`, forcing the next `inspect()` call
+     * to fetch fresh data from the database.
+     */
+    static invalidateCache(pool: QueryablePool): void;
+    private static _isSqlitePool;
+    private static _isPgPool;
+    /**
+     * Inspect a PostgreSQL database.
+     * Uses 3 round-trips:
+     *   1. columns + primary keys (information_schema.columns + key_column_usage)
+     *   2. foreign keys (information_schema.referential_constraints + key_column_usage)
+     *   3. indexes (pg_indexes)
+     */
+    private static _inspectPostgres;
+    /**
+     * Inspect a MySQL/MariaDB database using information_schema catalog tables.
+     * Uses 3 parallel round-trips: columns+pk, foreign keys, indexes.
+     */
+    private static _inspectMysql;
+    /**
+     * Inspect a SQLite database using PRAGMA statements.
+     * Fetches the table list first, then issues PRAGMA queries for each table.
+     */
+    private static _inspectSqlite;
+    private static _inspectSqliteTable;
+}
+export {};
+//# sourceMappingURL=schema-inspector.d.ts.map

package/dist/schema-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-inspector.d.ts","sourceRoot":"","sources":["../src/schema-inspector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,IAAI,CAAC;CACnB;AAID;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC3D;AAID,UAAU,UAAU;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,qBAAa,eAAe;IAC1B,mDAAmD;IACnD,MAAM,CAAC,QAAQ,CAAC,MAAM,0BAAiC;IAEvD;;;OAGG;WACU,OAAO,CAClB,IAAI,EAAE,aAAa,EACnB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxB,OAAO,CAAC,cAAc,CAAC;IA4B1B;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAMjD,OAAO,CAAC,MAAM,CAAC,aAAa;IAW5B,OAAO,CAAC,MAAM,CAAC,SAAS;IAUxB;;;;;;OAMG;mBACkB,gBAAgB;IAiIrC;;;OAGG;mBACkB,aAAa;IAwGlC;;;OAGG;mBACkB,cAAc;mBAed,mBAAmB;CAgEzC"}

package/dist/schema-inspector.js

@@ -0,0 +1,351 @@
+// src/schema-inspector.ts
+// Database schema introspection for PostgreSQL, MySQL, and SQLite.
+// Provides a unified DatabaseSchema regardless of the underlying engine.
+// ─── SchemaInspector ─────────────────────────────────────────────────────────
+export class SchemaInspector {
+    /** Schema cache keyed by pool object reference. */
+    static _cache = new Map();
+    /**
+     * Inspect the connected database and return its schema.
+     * Results are cached for `opts.ttlMs` milliseconds (default 60 000).
+     */
+    static async inspect(pool, opts) {
+        const ttlMs = opts?.ttlMs ?? 60_000;
+        const now = Date.now();
+        const cached = SchemaInspector._cache.get(pool);
+        if (cached && cached.expiresAt > now) {
+            return cached.schema;
+        }
+        // Detect dialect by duck-typing the pool
+        let schema;
+        if (SchemaInspector._isSqlitePool(pool)) {
+            schema = await SchemaInspector._inspectSqlite(pool);
+        }
+        else if (SchemaInspector._isPgPool(pool)) {
+            schema = await SchemaInspector._inspectPostgres(pool);
+        }
+        else {
+            // MySQL or any other pool that satisfies QueryablePool
+            schema = await SchemaInspector._inspectMysql(pool);
+        }
+        SchemaInspector._cache.set(pool, {
+            schema,
+            expiresAt: now + ttlMs,
+        });
+        return schema;
+    }
+    /**
+     * Remove the cached schema for `pool`, forcing the next `inspect()` call
+     * to fetch fresh data from the database.
+     */
+    static invalidateCache(pool) {
+        SchemaInspector._cache.delete(pool);
+    }
+    // ── Dialect detection ───────────────────────────────────────────────────────
+    static _isSqlitePool(pool) {
+        // SqlitePool uses worker_threads and exposes a `filePath`-based constructor.
+        // We detect it by relying on the pool constructor name.
+        return (pool !== null &&
+            typeof pool === 'object' &&
+            pool['constructor'] !== undefined &&
+            pool.constructor.name === 'SqlitePool');
+    }
+    static _isPgPool(pool) {
+        return (pool !== null &&
+            typeof pool === 'object' &&
+            pool.constructor.name === 'PgPool');
+    }
+    // ── PostgreSQL introspection ────────────────────────────────────────────────
+    /**
+     * Inspect a PostgreSQL database.
+     * Uses 3 round-trips:
+     *   1. columns + primary keys (information_schema.columns + key_column_usage)
+     *   2. foreign keys (information_schema.referential_constraints + key_column_usage)
+     *   3. indexes (pg_indexes)
+     */
+    static async _inspectPostgres(pool) {
+        // Round-trip 1: columns and primary key membership
+        const colSql = `
+      SELECT
+        c.table_name,
+        c.column_name,
+        c.data_type,
+        c.is_nullable,
+        c.column_default,
+        CASE WHEN kcu.column_name IS NOT NULL THEN true ELSE false END AS is_pk
+      FROM information_schema.columns c
+      LEFT JOIN (
+        SELECT kcu.table_schema, kcu.table_name, kcu.column_name
+        FROM information_schema.key_column_usage kcu
+        JOIN information_schema.table_constraints tc
+          ON  tc.constraint_name = kcu.constraint_name
+          AND tc.table_schema    = kcu.table_schema
+          AND tc.table_name      = kcu.table_name
+        WHERE tc.constraint_type = 'PRIMARY KEY'
+          AND tc.table_schema    = current_schema()
+      ) kcu
+        ON  kcu.table_schema  = c.table_schema
+        AND kcu.table_name    = c.table_name
+        AND kcu.column_name   = c.column_name
+      WHERE c.table_schema = current_schema()
+        AND c.table_name IN (
+          SELECT table_name FROM information_schema.tables
+          WHERE table_schema = current_schema()
+            AND table_type   = 'BASE TABLE'
+        )
+      ORDER BY c.table_name, c.ordinal_position
+    `;
+        // Round-trip 2: foreign keys
+        const fkSql = `
+      SELECT
+        kcu.table_name,
+        kcu.column_name,
+        ccu.table_name  AS ref_table,
+        ccu.column_name AS ref_column
+      FROM information_schema.referential_constraints rc
+      JOIN information_schema.key_column_usage kcu
+        ON  kcu.constraint_name = rc.constraint_name
+        AND kcu.table_schema    = rc.constraint_schema
+      JOIN information_schema.constraint_column_usage ccu
+        ON  ccu.constraint_name = rc.unique_constraint_name
+        AND ccu.table_schema    = rc.unique_constraint_schema
+      WHERE rc.constraint_schema = current_schema()
+      ORDER BY kcu.table_name, kcu.column_name
+    `;
+        // Round-trip 3: indexes
+        const idxSql = `
+      SELECT
+        tablename,
+        indexname,
+        indexdef
+      FROM pg_indexes
+      WHERE schemaname = current_schema()
+      ORDER BY tablename, indexname
+    `;
+        const [colResult, fkResult, idxResult] = await Promise.all([
+            pool.query(colSql),
+            pool.query(fkSql),
+            pool.query(idxSql),
+        ]);
+        // Build table map from columns
+        const tableMap = new Map();
+        for (const row of colResult.rows) {
+            const tbl = row['table_name'] ?? '';
+            if (!tableMap.has(tbl)) {
+                tableMap.set(tbl, { name: tbl, columns: [], primaryKey: [], foreignKeys: [], indexes: [] });
+            }
+            const ts = tableMap.get(tbl);
+            const col = {
+                name: row['column_name'] ?? '',
+                type: row['data_type'] ?? '',
+                nullable: row['is_nullable'] === 'YES',
+                default: row['column_default'] ?? null,
+            };
+            ts.columns.push(col);
+            if (row['is_pk'] === 'true' || row['is_pk'] === 't') {
+                ts.primaryKey.push(col.name);
+            }
+        }
+        // Attach foreign keys
+        for (const row of fkResult.rows) {
+            const tbl = row['table_name'] ?? '';
+            const ts = tableMap.get(tbl);
+            if (!ts)
+                continue;
+            ts.foreignKeys.push({
+                column: row['column_name'] ?? '',
+                refTable: row['ref_table'] ?? '',
+                refColumn: row['ref_column'] ?? '',
+            });
+        }
+        // Parse and attach indexes
+        for (const row of idxResult.rows) {
+            const tbl = row['tablename'] ?? '';
+            const ts = tableMap.get(tbl);
+            if (!ts)
+                continue;
+            const indexDef = row['indexdef'] ?? '';
+            const indexName = row['indexname'] ?? '';
+            const unique = /CREATE UNIQUE INDEX/i.test(indexDef);
+            // Parse column list from index definition:
+            // "CREATE [UNIQUE] INDEX name ON table USING method (col1, col2)"
+            const colMatch = indexDef.match(/\(([^)]+)\)/);
+            const columns = colMatch
+                ? colMatch[1].split(',').map((s) => s.trim().replace(/^"(.+)"$/, '$1'))
+                : [];
+            ts.indexes.push({ name: indexName, columns, unique });
+        }
+        return {
+            tables: Array.from(tableMap.values()),
+            inspectedAt: new Date(),
+        };
+    }
+    // ── MySQL introspection ─────────────────────────────────────────────────────
+    /**
+     * Inspect a MySQL/MariaDB database using information_schema catalog tables.
+     * Uses 3 parallel round-trips: columns+pk, foreign keys, indexes.
+     */
+    static async _inspectMysql(pool) {
+        const colSql = `
+      SELECT
+        c.TABLE_NAME      AS table_name,
+        c.COLUMN_NAME     AS column_name,
+        c.DATA_TYPE       AS data_type,
+        c.IS_NULLABLE     AS is_nullable,
+        c.COLUMN_DEFAULT  AS column_default,
+        c.COLUMN_KEY      AS column_key
+      FROM information_schema.COLUMNS c
+      WHERE c.TABLE_SCHEMA = DATABASE()
+      ORDER BY c.TABLE_NAME, c.ORDINAL_POSITION
+    `;
+        const fkSql = `
+      SELECT
+        kcu.TABLE_NAME        AS table_name,
+        kcu.COLUMN_NAME       AS column_name,
+        kcu.REFERENCED_TABLE_NAME  AS ref_table,
+        kcu.REFERENCED_COLUMN_NAME AS ref_column
+      FROM information_schema.KEY_COLUMN_USAGE kcu
+      WHERE kcu.TABLE_SCHEMA            = DATABASE()
+        AND kcu.REFERENCED_TABLE_NAME  IS NOT NULL
+      ORDER BY kcu.TABLE_NAME, kcu.COLUMN_NAME
+    `;
+        const idxSql = `
+      SELECT
+        TABLE_NAME  AS table_name,
+        INDEX_NAME  AS index_name,
+        COLUMN_NAME AS column_name,
+        NON_UNIQUE  AS non_unique
+      FROM information_schema.STATISTICS
+      WHERE TABLE_SCHEMA = DATABASE()
+      ORDER BY TABLE_NAME, INDEX_NAME, SEQ_IN_INDEX
+    `;
+        const [colResult, fkResult, idxResult] = await Promise.all([
+            pool.query(colSql),
+            pool.query(fkSql),
+            pool.query(idxSql),
+        ]);
+        const tableMap = new Map();
+        for (const row of colResult.rows) {
+            const tbl = row['table_name'] ?? '';
+            if (!tableMap.has(tbl)) {
+                tableMap.set(tbl, { name: tbl, columns: [], primaryKey: [], foreignKeys: [], indexes: [] });
+            }
+            const ts = tableMap.get(tbl);
+            const col = {
+                name: row['column_name'] ?? '',
+                type: row['data_type'] ?? '',
+                nullable: row['is_nullable'] === 'YES',
+                default: row['column_default'] ?? null,
+            };
+            ts.columns.push(col);
+            if (row['column_key'] === 'PRI') {
+                ts.primaryKey.push(col.name);
+            }
+        }
+        for (const row of fkResult.rows) {
+            const tbl = row['table_name'] ?? '';
+            const ts = tableMap.get(tbl);
+            if (!ts)
+                continue;
+            ts.foreignKeys.push({
+                column: row['column_name'] ?? '',
+                refTable: row['ref_table'] ?? '',
+                refColumn: row['ref_column'] ?? '',
+            });
+        }
+        // Group index rows (one row per column in the index) into IndexMeta
+        const indexAccum = new Map();
+        for (const row of idxResult.rows) {
+            const tbl = row['table_name'] ?? '';
+            const idxName = row['index_name'] ?? '';
+            const key = `${tbl}::${idxName}`;
+            if (!indexAccum.has(key)) {
+                indexAccum.set(key, {
+                    tableName: tbl,
+                    name: idxName,
+                    columns: [],
+                    unique: row['non_unique'] === '0',
+                });
+            }
+            indexAccum.get(key).columns.push(row['column_name'] ?? '');
+        }
+        for (const idx of indexAccum.values()) {
+            const ts = tableMap.get(idx.tableName);
+            if (!ts)
+                continue;
+            ts.indexes.push({ name: idx.name, columns: idx.columns, unique: idx.unique });
+        }
+        return {
+            tables: Array.from(tableMap.values()),
+            inspectedAt: new Date(),
+        };
+    }
+    // ── SQLite introspection ────────────────────────────────────────────────────
+    /**
+     * Inspect a SQLite database using PRAGMA statements.
+     * Fetches the table list first, then issues PRAGMA queries for each table.
+     */
+    static async _inspectSqlite(pool) {
+        // Get all user tables (exclude internal sqlite_ tables)
+        const tablesResult = await pool.query("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name");
+        const tableNames = tablesResult.rows.map((r) => r['name'] ?? '');
+        const tables = await Promise.all(tableNames.map((name) => SchemaInspector._inspectSqliteTable(pool, name)));
+        return { tables, inspectedAt: new Date() };
+    }
+    static async _inspectSqliteTable(pool, tableName) {
+        // Run all three PRAGMAs for this table
+        const [colResult, idxListResult, fkResult] = await Promise.all([
+            pool.query(`PRAGMA table_info(${JSON.stringify(tableName)})`),
+            pool.query(`PRAGMA index_list(${JSON.stringify(tableName)})`),
+            pool.query(`PRAGMA foreign_key_list(${JSON.stringify(tableName)})`),
+        ]);
+        // Columns and primary key from table_info
+        // Columns: cid, name, type, notnull, dflt_value, pk
+        const columns = [];
+        for (const row of colResult.rows) {
+            columns.push({
+                name: row['name'] ?? '',
+                type: row['type'] ?? '',
+                nullable: row['notnull'] === '0',
+                default: row['dflt_value'] ?? null,
+            });
+        }
+        // Sort primary key columns by their pk position
+        const pkEntries = colResult.rows
+            .filter((r) => r['pk'] !== '0' && r['pk'] !== null && r['pk'] !== undefined)
+            .sort((a, b) => Number(a['pk']) - Number(b['pk']))
+            .map((r) => r['name'] ?? '');
+        // Foreign keys from foreign_key_list
+        // Columns: id, seq, table, from, to, on_update, on_delete, match
+        const foreignKeys = fkResult.rows.map((row) => ({
+            column: row['from'] ?? '',
+            refTable: row['table'] ?? '',
+            refColumn: row['to'] ?? '',
+        }));
+        // Indexes from index_list, then fetch columns for each non-partial index
+        // Columns: seq, name, unique, origin, partial
+        const indexes = [];
+        for (const idxRow of idxListResult.rows) {
+            const idxName = idxRow['name'] ?? '';
+            // Fetch columns for this index via PRAGMA index_info
+            const infoResult = await pool.query(`PRAGMA index_info(${JSON.stringify(idxName)})`);
+            // Columns: seqno, cid, name
+            const cols = infoResult.rows
+                .sort((a, b) => Number(a['seqno']) - Number(b['seqno']))
+                .map((r) => r['name'] ?? '');
+            indexes.push({
+                name: idxName,
+                columns: cols,
+                unique: idxRow['unique'] === '1',
+            });
+        }
+        return {
+            name: tableName,
+            columns,
+            primaryKey: pkEntries,
+            foreignKeys,
+            indexes,
+        };
+    }
+}
+//# sourceMappingURL=schema-inspector.js.map

package/dist/schema-inspector.js.map

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

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@streetjs/schema-inspector",
+  "version": "1.0.0",
+  "description": "StreetJS database schema introspection: a unified DatabaseSchema (tables, columns, primary keys, foreign keys, indexes) across PostgreSQL, MySQL/MariaDB, and SQLite, with TTL caching. Works with any queryable pool.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/tests/**",
+    "!dist/examples/**",
+    "README.md",
+    "ARCHITECTURE.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "c8": {
+    "include": ["dist/**/*.js"],
+    "exclude": ["dist/tests/**", "dist/examples/**"],
+    "reporter": ["text", "lcov"],
+    "all": true,
+    "check-coverage": true,
+    "lines": 90,
+    "functions": 90,
+    "branches": 90,
+    "statements": 90
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test dist/tests/*.test.js",
+    "coverage": "c8 node --test dist/tests/*.test.js",
+    "example": "node dist/examples/integration.js",
+    "lint": "tsc --noEmit",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  },
+  "keywords": [
+    "streetjs",
+    "street-framework",
+    "schema",
+    "introspection",
+    "database",
+    "postgresql",
+    "mysql",
+    "sqlite",
+    "information-schema",
+    "typescript",
+    "esm"
+  ],
+  "author": "street contributors",
+  "license": "MIT",
+  "homepage": "https://hassanmubiru.github.io/StreetJS/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hassanmubiru/StreetJS.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hassanmubiru/StreetJS/issues"
+  },
+  "dependencies": {
+    "@streetjs/postgres": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "c8": "^11.0.0",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}