@engjts/nexus 0.1.0

package/dist/database/optimizer.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryOptimizer = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+class QueryOptimizer {
+    options;
+    trackedQueries = new Map();
+    hints = [];
+    tablesByName;
+    constructor(schema, options = {}) {
+        this.options = options;
+        this.tablesByName = schema;
+    }
+    analyze(metrics) {
+        this.detectSlowQuery(metrics);
+        this.detectNPlusOne(metrics);
+        this.detectMissingIndexes(metrics);
+    }
+    detectSlowQuery(metrics) {
+        const threshold = this.options.slowQueryThresholdMs ?? 25;
+        if (metrics.duration > threshold) {
+            this.hints.push({
+                type: 'slow-query',
+                table: metrics.table,
+                message: `Query exceeded ${threshold}ms (${metrics.duration.toFixed(2)}ms)`,
+                context: { sql: metrics.sql }
+            });
+        }
+    }
+    detectNPlusOne(metrics) {
+        const hash = this.hashSql(metrics.sql);
+        const existing = this.trackedQueries.get(hash);
+        const threshold = this.options.nPlusOneThreshold ?? 5;
+        if (!existing) {
+            this.trackedQueries.set(hash, {
+                pattern: metrics.sql,
+                occurrences: 1,
+                lastParams: metrics.params,
+                lastTimestamp: Date.now(),
+                table: metrics.table
+            });
+            return;
+        }
+        existing.occurrences += 1;
+        existing.lastParams = metrics.params;
+        existing.lastTimestamp = Date.now();
+        if (existing.occurrences >= threshold) {
+            this.hints.push({
+                type: 'n-plus-one',
+                table: metrics.table,
+                message: `Potential N+1 detected for query "${metrics.sql.slice(0, 60)}..."`,
+                context: { occurrences: existing.occurrences }
+            });
+            existing.occurrences = 0;
+        }
+    }
+    detectMissingIndexes(metrics) {
+        const table = this.tablesByName[metrics.table];
+        if (!table)
+            return;
+        const whereMatches = metrics.sql.match(/where\s+([a-zA-Z0-9_." =<>$]+)/i);
+        if (!whereMatches)
+            return;
+        const columns = table.indexes.flatMap((idx) => idx.columns);
+        const missingColumns = [];
+        whereMatches[1]
+            .split(/\s+and\s+/i)
+            .map((condition) => condition.trim().replace(/["`]/g, ''))
+            .forEach((condition) => {
+            const column = condition.split(/\s+/)[0];
+            if (!columns.includes(column)) {
+                missingColumns.push(column);
+            }
+        });
+        if (missingColumns.length > 0) {
+            this.hints.push({
+                type: 'missing-index',
+                table: table.name,
+                message: `Consider adding index on columns: ${missingColumns.join(', ')}`,
+                context: { whereClause: whereMatches[0] }
+            });
+        }
+    }
+    consumeHints() {
+        const hints = [...this.hints];
+        this.hints.length = 0;
+        return hints;
+    }
+    hashSql(sql) {
+        return crypto_1.default.createHash('sha1').update(sql).digest('hex');
+    }
+}
+exports.QueryOptimizer = QueryOptimizer;
+//# sourceMappingURL=optimizer.js.map

package/dist/database/optimizer.js.map

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

package/dist/database/query-builder.d.ts

@@ -0,0 +1,49 @@
+import { DatabaseAdapter } from './adapter';
+import { SQLDialect } from './dialect';
+import { QueryOptimizer } from './optimizer';
+import { RealtimeDatabase } from './realtime';
+import { InferRow, QueryContext, SchemaDefinition, TableDefinition } from './types';
+interface QueryBuilderOptions<TSchema extends SchemaDefinition> {
+    schema: TSchema;
+    table: TableDefinition;
+    adapter: DatabaseAdapter;
+    optimizer?: QueryOptimizer;
+    realtime?: RealtimeDatabase;
+    dialect?: SQLDialect;
+}
+type Direction = 'asc' | 'desc';
+export declare class QueryBuilder<TSchema extends SchemaDefinition, TName extends keyof TSchema & string, TResult = InferRow<TSchema[TName]>, TSelection extends InferRow<TSchema[TName]> = InferRow<TSchema[TName]>> {
+    private readonly table;
+    private readonly adapter;
+    private readonly schema;
+    private readonly optimizer?;
+    private readonly realtime?;
+    private readonly dialect;
+    private state;
+    private latestHints;
+    constructor(options: QueryBuilderOptions<TSchema>);
+    select<K extends readonly (keyof InferRow<TSchema[TName]>)[]>(...columns: K): QueryBuilder<TSchema, TName, TResult, Pick<InferRow<TSchema[TName]>, K[number]>>;
+    alias(name: string): this;
+    where(column: keyof InferRow<TSchema[TName]> | string, operatorOrValue: unknown, value?: unknown): this;
+    whereIn(column: keyof InferRow<TSchema[TName]> | string, values: unknown[]): this;
+    whereRaw(sql: string, params?: unknown[]): this;
+    join(table: string, localKey: string, foreignKey: string, type?: 'inner' | 'left'): this;
+    orderBy(column: keyof InferRow<TSchema[TName]> | string, direction?: Direction): this;
+    limit(limit: number): this;
+    offset(offset: number): this;
+    withRelations(...relations: string[]): this;
+    execute(context?: QueryContext): Promise<TSelection[]>;
+    first(context?: QueryContext): Promise<TSelection | null>;
+    insert(data: Partial<InferRow<TSchema[TName]>> | Array<Partial<InferRow<TSchema[TName]>>>, context?: QueryContext): Promise<import("./adapter").QueryResult<unknown>>;
+    update(values: Partial<InferRow<TSchema[TName]>>, context?: QueryContext): Promise<import("./adapter").QueryResult<unknown>>;
+    delete(context?: QueryContext): Promise<import("./adapter").QueryResult<unknown>>;
+    getOptimizerHints(): import("./optimizer").OptimizationHint[];
+    private buildSelectQuery;
+    private buildWhereClause;
+    private quote;
+    private eagerLoad;
+    private createBuilderForTable;
+    private recordQuery;
+}
+export {};
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/database/query-builder.d.ts.map

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

package/dist/database/query-builder.js

@@ -0,0 +1,319 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryBuilder = void 0;
+const perf_hooks_1 = require("perf_hooks");
+const dialect_1 = require("./dialect");
+class QueryBuilder {
+    table;
+    adapter;
+    schema;
+    optimizer;
+    realtime;
+    dialect;
+    state = {
+        selects: [],
+        joins: [],
+        where: [],
+        params: [],
+        orderBy: [],
+        relations: []
+    };
+    latestHints = [];
+    constructor(options) {
+        this.table = options.table;
+        this.adapter = options.adapter;
+        this.schema = options.schema;
+        this.optimizer = options.optimizer;
+        this.realtime = options.realtime;
+        this.dialect = options.dialect ?? (0, dialect_1.detectDialect)(options.adapter.name);
+    }
+    select(...columns) {
+        this.state.selects = columns.map((column) => this.quote(column));
+        return this;
+    }
+    alias(name) {
+        this.state.alias = name;
+        return this;
+    }
+    where(column, operatorOrValue, value) {
+        const operator = value === undefined ? '=' : operatorOrValue;
+        const val = value === undefined ? operatorOrValue : value;
+        const paramIndex = this.state.params.length + 1;
+        const clause = `${this.quote(column)} ${operator} ${this.dialect.paramPlaceholder(paramIndex)}`;
+        this.state.where.push(clause);
+        this.state.params.push(val);
+        return this;
+    }
+    whereIn(column, values) {
+        if (!values || values.length === 0) {
+            return this;
+        }
+        const placeholders = values.map((_, idx) => this.dialect.paramPlaceholder(this.state.params.length + idx + 1));
+        this.state.where.push(`${this.quote(column)} IN (${placeholders.join(', ')})`);
+        this.state.params.push(...values);
+        return this;
+    }
+    whereRaw(sql, params = []) {
+        this.state.where.push(sql);
+        this.state.params.push(...params);
+        return this;
+    }
+    join(table, localKey, foreignKey, type = 'inner') {
+        const clause = `${type.toUpperCase()} JOIN ${this.quote(table)} ON ${this.quote(localKey)} = ${this.quote(foreignKey)}`;
+        this.state.joins.push(clause);
+        return this;
+    }
+    orderBy(column, direction = 'asc') {
+        this.state.orderBy.push(`${this.quote(column)} ${direction.toUpperCase()}`);
+        return this;
+    }
+    limit(limit) {
+        this.state.limit = limit;
+        return this;
+    }
+    offset(offset) {
+        this.state.offset = offset;
+        return this;
+    }
+    withRelations(...relations) {
+        relations.forEach((relation) => {
+            if (!this.table.relations[relation]) {
+                throw new Error(`Relation "${relation}" is not defined on table "${this.table.name}"`);
+            }
+            if (!this.state.relations.includes(relation)) {
+                this.state.relations.push(relation);
+            }
+        });
+        return this;
+    }
+    async execute(context) {
+        const { sql, params } = this.buildSelectQuery();
+        const start = perf_hooks_1.performance.now();
+        const result = await this.adapter.query(sql, params, context);
+        const duration = perf_hooks_1.performance.now() - start;
+        this.recordQuery({
+            sql,
+            params,
+            duration,
+            timestamp: Date.now(),
+            table: this.table.name
+        });
+        let rows = result.rows;
+        if (this.state.relations.length > 0) {
+            rows = (await this.eagerLoad(rows, context));
+        }
+        return rows;
+    }
+    async first(context) {
+        const rows = await this.limit(1).execute(context);
+        return rows[0] ?? null;
+    }
+    async insert(data, context) {
+        const rows = Array.isArray(data) ? data : [data];
+        if (rows.length === 0) {
+            throw new Error('Insert requires at least one row');
+        }
+        const columns = Object.keys(rows[0]);
+        const columnList = columns.map((col) => this.quote(col)).join(', ');
+        const valueGroups = rows.map((_row, rowIndex) => {
+            const placeholders = columns.map((_, colIndex) => this.dialect.paramPlaceholder(rowIndex * columns.length + colIndex + 1));
+            return `(${placeholders.join(', ')})`;
+        });
+        const params = rows.flatMap((row) => columns.map((column) => row[column]));
+        const returning = this.dialect.returning();
+        const sql = `INSERT INTO ${this.quote(this.table.name)} (${columnList}) VALUES ${valueGroups.join(', ')}${returning ? ' ' + returning : ''}`;
+        const start = perf_hooks_1.performance.now();
+        const result = await this.adapter.query(sql, params, context);
+        const duration = perf_hooks_1.performance.now() - start;
+        this.recordQuery({
+            sql,
+            params,
+            duration,
+            timestamp: Date.now(),
+            table: this.table.name
+        });
+        result.rows.forEach((row) => {
+            this.realtime?.emit({
+                table: this.table.name,
+                type: 'insert',
+                payload: row,
+                timestamp: Date.now()
+            });
+        });
+        return result;
+    }
+    async update(values, context) {
+        if (Object.keys(values).length === 0) {
+            throw new Error('Update requires at least one value');
+        }
+        const setClauses = Object.keys(values).map((key, idx) => `${this.quote(key)} = ${this.dialect.paramPlaceholder(idx + 1)}`);
+        const params = Object.values(values);
+        const whereClause = this.buildWhereClause(params.length + 1);
+        const returning = this.dialect.returning();
+        const sql = [
+            `UPDATE ${this.quote(this.table.name)}`,
+            `SET ${setClauses.join(', ')}`,
+            whereClause ? `WHERE ${whereClause}` : '',
+            returning
+        ]
+            .filter(Boolean)
+            .join(' ');
+        const start = perf_hooks_1.performance.now();
+        const result = await this.adapter.query(sql, [...params, ...this.state.params], context);
+        const duration = perf_hooks_1.performance.now() - start;
+        this.recordQuery({
+            sql,
+            params: [...params, ...this.state.params],
+            duration,
+            timestamp: Date.now(),
+            table: this.table.name
+        });
+        result.rows.forEach((row) => {
+            this.realtime?.emit({
+                table: this.table.name,
+                type: 'update',
+                payload: row,
+                timestamp: Date.now()
+            });
+        });
+        return result;
+    }
+    async delete(context) {
+        const whereClause = this.buildWhereClause(1);
+        const returning = this.dialect.returning();
+        const sql = [
+            `DELETE FROM ${this.quote(this.table.name)}`,
+            whereClause ? `WHERE ${whereClause}` : '',
+            returning
+        ]
+            .filter(Boolean)
+            .join(' ');
+        const start = perf_hooks_1.performance.now();
+        const result = await this.adapter.query(sql, this.state.params, context);
+        const duration = perf_hooks_1.performance.now() - start;
+        this.recordQuery({
+            sql,
+            params: this.state.params,
+            duration,
+            timestamp: Date.now(),
+            table: this.table.name
+        });
+        result.rows.forEach((row) => {
+            this.realtime?.emit({
+                table: this.table.name,
+                type: 'delete',
+                payload: row,
+                timestamp: Date.now()
+            });
+        });
+        return result;
+    }
+    getOptimizerHints() {
+        return this.latestHints;
+    }
+    buildSelectQuery() {
+        const columns = this.state.selects.length ? this.state.selects.join(', ') : '*';
+        const alias = this.state.alias ? ` AS ${this.state.alias}` : '';
+        let sql = `SELECT ${columns} FROM ${this.quote(this.table.name)}${alias}`;
+        if (this.state.joins.length) {
+            sql += ` ${this.state.joins.join(' ')}`;
+        }
+        if (this.state.where.length) {
+            sql += ` WHERE ${this.state.where.join(' AND ')}`;
+        }
+        if (this.state.orderBy.length) {
+            sql += ` ORDER BY ${this.state.orderBy.join(', ')}`;
+        }
+        const limitOffset = this.dialect.limitOffset(this.state.limit, this.state.offset);
+        if (limitOffset) {
+            sql += ` ${limitOffset}`;
+        }
+        return { sql, params: [...this.state.params] };
+    }
+    buildWhereClause(offset) {
+        if (this.state.where.length === 0)
+            return '';
+        return this.state.where
+            .map((clause) => {
+            // Replace parameter placeholders with offset-adjusted ones
+            let paramIndex = 0;
+            return clause.replace(/\$(\d+)|\?(\d+)?|\?/g, () => {
+                paramIndex++;
+                return this.dialect.paramPlaceholder(paramIndex + offset - 1);
+            });
+        })
+            .join(' AND ');
+    }
+    quote(identifier) {
+        return this.dialect.quoteIdentifier(identifier);
+    }
+    async eagerLoad(rows, context) {
+        if (rows.length === 0) {
+            return rows;
+        }
+        for (const relationName of this.state.relations) {
+            const relation = this.table.relations[relationName];
+            if (!relation)
+                continue;
+            const relatedTable = this.schema[relation.relatedTable];
+            if (!relatedTable) {
+                throw new Error(`Related table "${relation.relatedTable}" not found for relation "${relationName}"`);
+            }
+            const localKey = (relation.localKey ?? this.table.primaryKey);
+            const foreignKey = relation.foreignKey;
+            const localValues = Array.from(new Set(rows
+                .map((row) => row[localKey])
+                .filter((value) => value !== undefined && value !== null)));
+            if (localValues.length === 0)
+                continue;
+            const relatedRows = await this.createBuilderForTable(relation.relatedTable, relatedTable)
+                .whereIn(foreignKey, localValues)
+                .execute(context);
+            const grouped = relatedRows.reduce((acc, row) => {
+                const key = row[foreignKey];
+                if (key === undefined || key === null)
+                    return acc;
+                acc[key] = acc[key] || [];
+                acc[key].push(row);
+                return acc;
+            }, {});
+            rows.forEach((row) => {
+                const key = row[localKey];
+                if (key === undefined || key === null) {
+                    if (relation.type === 'hasOne' || relation.type === 'belongsTo') {
+                        row[relationName] = null;
+                    }
+                    else {
+                        row[relationName] = [];
+                    }
+                    return;
+                }
+                if (relation.type === 'hasOne' || relation.type === 'belongsTo') {
+                    row[relationName] = grouped[key]?.[0] ?? null;
+                }
+                else {
+                    row[relationName] = grouped[key] ?? [];
+                }
+            });
+        }
+        return rows;
+    }
+    createBuilderForTable(_name, table) {
+        return new QueryBuilder({
+            schema: this.schema,
+            table,
+            adapter: this.adapter,
+            optimizer: this.optimizer,
+            realtime: this.realtime,
+            dialect: this.dialect
+        });
+    }
+    recordQuery(metrics) {
+        if (!this.optimizer)
+            return;
+        this.optimizer.analyze(metrics);
+        this.latestHints = this.optimizer.consumeHints();
+    }
+}
+exports.QueryBuilder = QueryBuilder;
+//# sourceMappingURL=query-builder.js.map

package/dist/database/query-builder.js.map

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

package/dist/database/realtime.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from 'events';
+export interface RealtimeChange<TPayload = unknown> {
+    table: string;
+    type: 'insert' | 'update' | 'delete';
+    payload: TPayload;
+    timestamp: number;
+}
+export interface RealtimeConfig {
+    enabled?: boolean;
+    bufferSize?: number;
+}
+export declare class RealtimeDatabase<TPayload = unknown> {
+    private readonly emitter;
+    private readonly bufferSize;
+    private readonly buffer;
+    private enabled;
+    constructor(config?: RealtimeConfig);
+    onChange(listener: (change: RealtimeChange<TPayload>) => void): () => EventEmitter<[never]>;
+    emit(change: RealtimeChange<TPayload>): void;
+    history(): RealtimeChange<TPayload>[];
+    pause(): void;
+    resume(): void;
+}
+//# sourceMappingURL=realtime.d.ts.map

package/dist/database/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/database/realtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,cAAc,CAAC,QAAQ,GAAG,OAAO;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,OAAO,EAAE,QAAQ,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,gBAAgB,CAAC,QAAQ,GAAG,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,GAAE,cAAmB;IAKvC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,KAAK,IAAI;IAK7D,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC;IAUrC,OAAO,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE;IAIrC,KAAK;IAIL,MAAM;CAGT"}

package/dist/database/realtime.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeDatabase = void 0;
+const events_1 = require("events");
+class RealtimeDatabase {
+    emitter = new events_1.EventEmitter();
+    bufferSize;
+    buffer = [];
+    enabled;
+    constructor(config = {}) {
+        this.enabled = config.enabled ?? true;
+        this.bufferSize = config.bufferSize ?? 100;
+    }
+    onChange(listener) {
+        this.emitter.on('change', listener);
+        return () => this.emitter.off('change', listener);
+    }
+    emit(change) {
+        if (!this.enabled)
+            return;
+        this.buffer.push(change);
+        if (this.buffer.length > this.bufferSize) {
+            this.buffer.shift();
+        }
+        this.emitter.emit('change', change);
+    }
+    history() {
+        return [...this.buffer];
+    }
+    pause() {
+        this.enabled = false;
+    }
+    resume() {
+        this.enabled = true;
+    }
+}
+exports.RealtimeDatabase = RealtimeDatabase;
+//# sourceMappingURL=realtime.js.map

package/dist/database/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../src/database/realtime.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AActC,MAAa,gBAAgB;IACR,OAAO,GAAG,IAAI,qBAAY,EAAE,CAAC;IAC7B,UAAU,CAAS;IACnB,MAAM,GAA+B,EAAE,CAAC;IACjD,OAAO,CAAU;IAEzB,YAAY,SAAyB,EAAE;QACnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,QAAoD;QACzD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACpC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,MAAgC;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,OAAO;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,MAAM;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;CACJ;AArCD,4CAqCC"}

package/dist/database/schema.d.ts

@@ -0,0 +1,27 @@
+import { z, ZodRawShape } from 'zod';
+import { IndexDefinition, RelationDefinition, SchemaDefinition, TableDefinition } from './types';
+export interface DefineTableOptions<TName extends string, TShape extends ZodRawShape, TRelations extends Record<string, RelationDefinition> = Record<string, RelationDefinition>> {
+    name: TName;
+    schema: z.ZodObject<TShape>;
+    primaryKey?: keyof TShape & string;
+    timestamps?: boolean;
+    indexes?: IndexDefinition<keyof TShape & string>[];
+    relations?: TRelations;
+    meta?: Record<string, unknown>;
+}
+export declare function defineTable<TName extends string, TShape extends ZodRawShape, TRelations extends Record<string, RelationDefinition> = Record<string, RelationDefinition>>(options: DefineTableOptions<TName, TShape, TRelations>): TableDefinition<TName, TShape, TRelations>;
+export declare function defineSchema<TTables extends SchemaDefinition>(tables: TTables): TTables;
+export declare class SchemaInspector<TSchema extends SchemaDefinition> {
+    private readonly schema;
+    constructor(schema: TSchema);
+    table<TName extends keyof TSchema & string>(name: TName): TSchema[TName];
+    listTables(): Array<[string, TableDefinition]>;
+    describe(tableName: keyof TSchema & string): {
+        name: string;
+        columns: never;
+        primaryKey: string;
+        relations: Record<string, RelationDefinition<string, string, string>>;
+        indexes: IndexDefinition<string>[];
+    };
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/database/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/database/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,EACH,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,kBAAkB,CAC/B,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,WAAW,EAC1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAE1F,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,eAAe,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACnD,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,wBAAgB,WAAW,CACvB,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,WAAW,EAC1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAE1F,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,GACvD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAU5C;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAS,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAEvF;AAED,qBAAa,eAAe,CAAC,OAAO,SAAS,gBAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO;IAE5C,KAAK,CAAC,KAAK,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAQxE,UAAU,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAI9C,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,GAAG,MAAM;;;;;;;CAU7C"}

package/dist/database/schema.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaInspector = void 0;
+exports.defineTable = defineTable;
+exports.defineSchema = defineSchema;
+function defineTable(options) {
+    return {
+        name: options.name,
+        schema: options.schema,
+        primaryKey: (options.primaryKey || 'id'),
+        timestamps: options.timestamps ?? true,
+        relations: options.relations ?? {},
+        indexes: options.indexes ?? [],
+        meta: options.meta
+    };
+}
+function defineSchema(tables) {
+    return tables;
+}
+class SchemaInspector {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    table(name) {
+        const table = this.schema[name];
+        if (!table) {
+            throw new Error(`Table "${name}" is not defined in the schema`);
+        }
+        return table;
+    }
+    listTables() {
+        return Object.entries(this.schema);
+    }
+    describe(tableName) {
+        const table = this.table(tableName);
+        return {
+            name: table.name,
+            columns: table.schema.keyof().options,
+            primaryKey: table.primaryKey,
+            relations: table.relations,
+            indexes: table.indexes
+        };
+    }
+}
+exports.SchemaInspector = SchemaInspector;
+//# sourceMappingURL=schema.js.map