@forgebase/database 0.0.1

package/dist/cjs/adapters/sqlite.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLiteAdapter = void 0;
+const base_1 = require("./base");
+class SQLiteAdapter {
+    buildWindowFunction(wf) {
+        // SQLite specific window function syntax
+        const fnCall = wf.type === 'row_number'
+            ? 'ROW_NUMBER()'
+            : `${wf.type}(${wf.field || '*'})`;
+        let overClause = 'OVER (';
+        if (wf.partitionBy?.length) {
+            overClause += `PARTITION BY ${wf.partitionBy.join(',')}`;
+        }
+        if (wf.orderBy?.length) {
+            overClause += ` ORDER BY ${wf.orderBy
+                .map((ob) => `${ob.field} ${ob.direction || 'ASC'}`)
+                .join(',')}`;
+        }
+        overClause += ')';
+        return `${fnCall} ${overClause} AS ${wf.alias}`;
+    }
+    buildOrderByClause(clauses) {
+        return clauses.map(({ field, direction, nulls }) => ({
+            column: field,
+            order: direction || 'asc',
+            nulls: nulls,
+        }));
+    }
+    supportsFeature(feature) {
+        const supported = {
+            [base_1.DatabaseFeature.WindowFunctions]: true, // Only in SQLite 3.25.0+
+            [base_1.DatabaseFeature.CTEs]: true,
+            [base_1.DatabaseFeature.RecursiveCTEs]: true,
+            [base_1.DatabaseFeature.NullsOrdering]: false,
+            [base_1.DatabaseFeature.JsonOperations]: false,
+            [base_1.DatabaseFeature.ArrayOperations]: false,
+        };
+        return supported[feature] || false;
+    }
+    sanitizeIdentifier(identifier) {
+        // SQLite identifier sanitization
+        return `"${identifier.replace(/"/g, '""')}"`;
+    }
+}
+exports.SQLiteAdapter = SQLiteAdapter;
+//# sourceMappingURL=sqlite.js.map

package/dist/cjs/adapters/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../src/adapters/sqlite.ts"],"names":[],"mappings":";;;AAAA,iCAA+D;AAG/D,MAAa,aAAa;IACxB,mBAAmB,CAAC,EAAkB;QACpC,yCAAyC;QACzC,MAAM,MAAM,GACV,EAAE,CAAC,IAAI,KAAK,YAAY;YACtB,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,GAAG,CAAC;QAEvC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAC1B,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;YAC3B,UAAU,IAAI,gBAAgB,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACvB,UAAU,IAAI,aAAa,EAAE,CAAC,OAAO;iBAClC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;iBACnD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,CAAC;QACD,UAAU,IAAI,GAAG,CAAC;QAElB,OAAO,GAAG,MAAM,IAAI,UAAU,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC;IAED,kBAAkB,CAChB,OAAwB;QAExB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,SAAS,IAAI,KAAK;YACzB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC,CAAC;IACN,CAAC;IAED,eAAe,CAAC,OAAwB;QACtC,MAAM,SAAS,GAAG;YAChB,CAAC,sBAAe,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,yBAAyB;YAClE,CAAC,sBAAe,CAAC,IAAI,CAAC,EAAE,IAAI;YAC5B,CAAC,sBAAe,CAAC,aAAa,CAAC,EAAE,IAAI;YACrC,CAAC,sBAAe,CAAC,aAAa,CAAC,EAAE,KAAK;YACtC,CAAC,sBAAe,CAAC,cAAc,CAAC,EAAE,KAAK;YACvC,CAAC,sBAAe,CAAC,eAAe,CAAC,EAAE,KAAK;SACzC,CAAC;QACF,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;IACrC,CAAC;IAED,kBAAkB,CAAC,UAAkB;QACnC,iCAAiC;QACjC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAC/C,CAAC;CACF;AAhDD,sCAgDC"}

package/dist/cjs/adapters/types.d.ts

@@ -0,0 +1,8 @@
+export interface RequestAdapter {
+    getBody: <T>(request: any) => Promise<T>;
+    getQuery: (request: any) => Record<string, any>;
+    getParams: (request: any) => Record<string, any>;
+    getHeaders: (request: any) => Record<string, string>;
+}
+export type SupportedFramework = 'express' | 'fastify' | 'hono';
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IACxC,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/C,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChD,UAAU,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrD;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA"}

package/dist/cjs/adapters/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/types.ts"],"names":[],"mappings":""}

package/dist/cjs/database.d.ts

@@ -0,0 +1,73 @@
+import { Kysely, type Transaction } from 'kysely';
+import { PermissionService } from './permissionService';
+import { DBInspector } from './utils/inspector';
+import { KyselyHooks } from './kysely-hooks';
+import { type ForgeDatabaseConfig, type ForgeDatabaseEndpoints, type PermissionInitializationReport, type TablePermissions } from './types';
+import { RealtimeAdapter } from './websocket/RealtimeAdapter';
+export declare class ForgeDatabase {
+    private config;
+    private queryHandler;
+    private hooks;
+    private permissionService;
+    protected dbInspector: DBInspector;
+    private defaultPermissions;
+    realtimeAdapter?: RealtimeAdapter;
+    protected excludedTables: string[];
+    constructor(config?: ForgeDatabaseConfig);
+    getDbInspector(): DBInspector;
+    ready(): Promise<void>;
+    getExcludedTables(): string[];
+    getDefaultPermissions(): TablePermissions;
+    /**
+     * Initialize permissions for all tables in the database
+     * This is a non-blocking operation that runs in the background
+     */
+    private initializeTablePermissions;
+    /**
+     * Add a table to the excluded tables list
+     * @param tables List of tables to exclude
+     */
+    addExcludedTables(tables: string[]): void;
+    /**
+     * Remove a table from the excluded tables list
+     * @param tables List of tables to include
+     */
+    removeExcludedTables(tables: string[]): void;
+    /**
+     * Manually trigger permission initialization for all tables
+     * @param reportPath Optional path to save the report file
+     * @param onComplete Optional callback function to call when initialization is complete
+     */
+    initializePermissions(reportPath?: string, onComplete?: (report: PermissionInitializationReport) => void): void;
+    /**
+     * Get the database schema
+     * @returns Database schema
+     */
+    getEndpoints(): ForgeDatabaseEndpoints;
+    /**
+     * Get the knex instance
+     * @returns Knex instance
+     */
+    getDbInstance(): Kysely<any>;
+    getHooksDb(): KyselyHooks;
+    getPermissionService(): PermissionService;
+    /**
+     * Execute a function within a transaction
+     * @param callback Function to execute within the transaction
+     * @returns Result of the callback function
+     */
+    transaction<T>(callback: (trx: Transaction<any>) => Promise<T>): Promise<T>;
+    /**
+     * Get the endpoints for the database
+     * @returns Endpoints for the database
+     */
+    endpoints: ForgeDatabaseEndpoints;
+    parseQueryParams(params: Record<string, any>): Record<string, any>;
+}
+/**
+ * Create a new instance of the ForgeDatabase class
+ * @param config Configuration object for the ForgeDatabase instance
+ * @returns A new instance of the ForgeDatabase class
+ */
+export declare const createForgeDatabase: (config: ForgeDatabaseConfig) => ForgeDatabase;
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAA2B,MAAM,QAAQ,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAuB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM7C,OAAO,EAOL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAG3B,KAAK,8BAA8B,EAEnC,KAAK,gBAAgB,EACtB,MAAM,SAAS,CAAC;AAiBjB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAK9D,qBAAa,aAAa;IAgCZ,OAAO,CAAC,MAAM;IA/B1B,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;IACnC,OAAO,CAAC,kBAAkB,CAuBxB;IACK,eAAe,CAAC,EAAE,eAAe,CAAC;IACzC,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,CAAyB;gBAEvC,MAAM,GAAE,mBAAwB;IAkD7C,cAAc,IAAI,WAAW;IAIvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,iBAAiB,IAAI,MAAM,EAAE;IAIpC,qBAAqB,IAAI,gBAAgB;IAIzC;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAOlC;;;OAGG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE;IAGzC;;;OAGG;IACI,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE;IAM5C;;;;OAIG;IACI,qBAAqB,CAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,8BAA8B,KAAK,IAAI,GAC5D,IAAI;IAmBP;;;OAGG;IACI,YAAY;IAInB;;;OAGG;IACI,aAAa,IAAI,MAAM,CAAC,GAAG,CAAC;IAI5B,UAAU,IAAI,WAAW;IAIzB,oBAAoB,IAAI,iBAAiB;IAIhD;;;;OAIG;IACU,WAAW,CAAC,CAAC,EACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC9C,OAAO,CAAC,CAAC,CAAC;IASb;;;OAGG;IACI,SAAS,EAAE,sBAAsB,CA69BtC;IAEF,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAqBnE;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,mBAAmB,kBAE9D,CAAC"}