@groundbrick/db-core 0.0.1

package/dist/interfaces/DatabaseTransaction.d.ts

@@ -0,0 +1,31 @@
+import { QueryResult } from "./QueryResult.js";
+/**
+ * Transaction interface - common methods for all database types
+ * This interface ensures consistent transaction handling across MySQL and PostgreSQL
+ */
+export interface DatabaseTransaction {
+    /**
+     * Execute a query within the transaction
+     */
+    query<T = any>(text: string, params?: any[]): Promise<QueryResult<T>>;
+    /**
+     * Commit the transaction
+     * This method should only be called once and marks the transaction as completed
+     */
+    commit(): Promise<void>;
+    /**
+     * Rollback the transaction
+     * This method should be safe to call multiple times
+     */
+    rollback(): Promise<void>;
+    /**
+     * Check if the transaction has been completed (committed or rolled back)
+     */
+    isCompleted(): boolean;
+    getDatabaseType(): 'postgresql' | 'mysql';
+    supportsReturning(): boolean;
+    adaptSql(sql: string): string;
+    createInsertSql(tableName: string, columns: string[]): string;
+    createUpdateSql(tableName: string, columns: string[]): string;
+}
+//# sourceMappingURL=DatabaseTransaction.d.ts.map

package/dist/interfaces/DatabaseTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseTransaction.d.ts","sourceRoot":"","sources":["../../src/interfaces/DatabaseTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtE;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB,eAAe,IAAI,YAAY,GAAG,OAAO,CAAC;IAC1C,iBAAiB,IAAI,OAAO,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC9D,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;CACjE"}

package/dist/interfaces/DatabaseTransaction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DatabaseTransaction.js.map

package/dist/interfaces/DatabaseTransaction.js.map

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

package/dist/interfaces/HealthCheckResult.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    status: 'healthy' | 'unhealthy' | 'degraded';
+    timestamp: Date;
+    responseTime?: number;
+    message?: string;
+    activeConnections?: number;
+    totalConnections?: number;
+    error?: string;
+    details?: Record<string, any>;
+}
+//# sourceMappingURL=HealthCheckResult.d.ts.map

package/dist/interfaces/HealthCheckResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthCheckResult.d.ts","sourceRoot":"","sources":["../../src/interfaces/HealthCheckResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC"}

package/dist/interfaces/HealthCheckResult.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=HealthCheckResult.js.map

package/dist/interfaces/HealthCheckResult.js.map

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

package/dist/interfaces/Migration.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Migration interface
+ */
+export interface Migration {
+    id: string;
+    description: string;
+    up: string;
+    down: string;
+    checksum?: string;
+}
+//# sourceMappingURL=Migration.d.ts.map

package/dist/interfaces/Migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration.d.ts","sourceRoot":"","sources":["../../src/interfaces/Migration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/interfaces/Migration.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Migration.js.map

package/dist/interfaces/Migration.js.map

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

package/dist/interfaces/MigrationManager.d.ts

@@ -0,0 +1,31 @@
+import { MigrationStatus, Migration } from "./index.js";
+/**
+ * Migration manager interface
+ */
+export interface MigrationManager {
+    /**
+     * Apply pending migrations
+     */
+    migrate(): Promise<void>;
+    /**
+     * Rollback the last migration
+     */
+    rollback(): Promise<void>;
+    /**
+     * Rollback to a specific migration
+     */
+    rollbackTo(migrationId: string): Promise<void>;
+    /**
+     * Get migration status
+     */
+    getStatus(): Promise<MigrationStatus[]>;
+    /**
+     * Get pending migrations
+     */
+    getPending(): Promise<Migration[]>;
+    /**
+     * Reset all migrations (DANGER: drops all data)
+     */
+    reset(): Promise<void>;
+}
+//# sourceMappingURL=MigrationManager.d.ts.map

package/dist/interfaces/MigrationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationManager.d.ts","sourceRoot":"","sources":["../../src/interfaces/MigrationManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAExC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/interfaces/MigrationManager.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MigrationManager.js.map

package/dist/interfaces/MigrationManager.js.map

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

package/dist/interfaces/MigrationStatus.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Migration record (applied migration)
+ */
+export interface MigrationStatus {
+    id: string;
+    description: string;
+    applied_at: Date;
+    checksum: string;
+}
+//# sourceMappingURL=MigrationStatus.d.ts.map

package/dist/interfaces/MigrationStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationStatus.d.ts","sourceRoot":"","sources":["../../src/interfaces/MigrationStatus.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB"}

package/dist/interfaces/MigrationStatus.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MigrationStatus.js.map

package/dist/interfaces/MigrationStatus.js.map

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

package/dist/interfaces/QueryResult.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Standard query result structure
+ */
+export interface QueryResult<T = any> {
+    rows: T[];
+    rowCount: number | null;
+    fields?: Array<{
+        name: string;
+        dataTypeID?: number;
+        dataTypeSize?: number;
+        dataTypeModifier?: number;
+    }>;
+}
+//# sourceMappingURL=QueryResult.d.ts.map

package/dist/interfaces/QueryResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryResult.d.ts","sourceRoot":"","sources":["../../src/interfaces/QueryResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAChC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;CACN"}

package/dist/interfaces/QueryResult.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QueryResult.js.map

package/dist/interfaces/QueryResult.js.map

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

package/dist/interfaces/SqlAdapter.d.ts

@@ -0,0 +1,11 @@
+export interface SqlAdapter {
+    adaptSql(sql: string): string;
+    createInsertSql(tableName: string, columns: string[]): string;
+    createUpdateSql(tableName: string, columns: string[]): string;
+    createDeleteSql(tableName: string): string;
+    getDatabaseType(): 'postgresql' | 'mysql';
+    supportsReturning(): boolean;
+    getNowFunction(): string;
+    getLimitClause(limit: number, offset?: number): string;
+}
+//# sourceMappingURL=SqlAdapter.d.ts.map

package/dist/interfaces/SqlAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlAdapter.d.ts","sourceRoot":"","sources":["../../src/interfaces/SqlAdapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC9D,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC9D,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,eAAe,IAAI,YAAY,GAAG,OAAO,CAAC;IAC1C,iBAAiB,IAAI,OAAO,CAAC;IAC7B,cAAc,IAAI,MAAM,CAAC;IACzB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1D"}

package/dist/interfaces/SqlAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SqlAdapter.js.map

package/dist/interfaces/SqlAdapter.js.map

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

package/dist/interfaces/index.d.ts

@@ -0,0 +1,14 @@
+import { BaseSqlAdapter } from "../adapters/BaseSqlAdapter.js";
+import { ConfigValidator } from "./ConfigValidator.js";
+import { DatabaseClient } from "./DatabaseClient.js";
+import { DatabaseConfig } from "./DatabaseConfig.js";
+import { DatabaseFactory } from "./DatabaseFactory.js";
+import { DatabaseTransaction } from "./DatabaseTransaction.js";
+import { HealthCheckResult } from "./HealthCheckResult.js";
+import { Migration } from "./Migration.js";
+import { MigrationManager } from "./MigrationManager.js";
+import { MigrationStatus } from "./MigrationStatus.js";
+import { QueryResult } from "./QueryResult.js";
+import { SqlAdapter } from "./SqlAdapter.js";
+export { type ConfigValidator, type DatabaseClient, type DatabaseConfig, type DatabaseFactory, type DatabaseTransaction, type HealthCheckResult, type Migration, type MigrationManager, type MigrationStatus, type QueryResult, BaseSqlAdapter, type SqlAdapter };
+//# sourceMappingURL=index.d.ts.map

package/dist/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,UAAU,EAChB,CAAC"}

package/dist/interfaces/index.js

@@ -0,0 +1,3 @@
+import { BaseSqlAdapter } from "../adapters/BaseSqlAdapter.js";
+export { BaseSqlAdapter };
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAa/D,OAAO,EAWL,cAAc,EAEf,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+    "name": "@groundbrick/db-core",
+    "version": "0.0.1",
+    "description": "Core database interfaces and types for the TypeScript microframework",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist/**/*",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "clean": "rm -rf dist *.tsbuildinfo",
+        "lint": "eslint src/**/*.ts",
+        "lint:fix": "eslint src/**/*.ts --fix"
+    },
+    "keywords": [
+        "typescript",
+        "database",
+        "interfaces",
+        "microframework",
+        "postgresql",
+        "mysql",
+        "migrations"
+    ],
+    "author": "Cleiton Marques <cleiton.marques@200.systems>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/200Systems/bitbrick-microframework.git",
+        "directory": "packages/db-core"
+    },
+    "dependencies": {
+        "@groundbrick/logger": "workspace:*"
+    },
+    "devDependencies": {
+        "@types/node": "^20.10.0",
+        "typescript": "^5.8.3"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}