@xemahq/biome-database-sdk 0.1.1

package/dist/lib/org-managed-db.module.js

@@ -0,0 +1,161 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var OrgManagedDatabaseModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrgManagedDatabaseModule = exports.OrgManagedDatabaseService = exports.ORG_MANAGED_DATABASE_OPTIONS = void 0;
+exports.hasOrgDatabaseConfig = hasOrgDatabaseConfig;
+const common_1 = require("@nestjs/common");
+exports.ORG_MANAGED_DATABASE_OPTIONS = 'ORG_MANAGED_DATABASE_OPTIONS';
+const logger = new common_1.Logger('OrgManagedDatabaseModule');
+let OrgManagedDatabaseService = class OrgManagedDatabaseService {
+    options;
+    refreshInterval;
+    currentGrant;
+    constructor(options) {
+        this.options = options;
+    }
+    async onModuleInit() {
+        if (!this.options.databaseId) {
+            logger.warn('databaseId not provided; org-managed database integration disabled');
+            return;
+        }
+        await this.refreshConnection();
+        const refreshInterval = this.options.refreshConnInterval || 30_000;
+        this.refreshInterval = setInterval(() => {
+            this.refreshConnection().catch((err) => {
+                logger.error('Failed to refresh org-managed database connection', err);
+            });
+        }, refreshInterval);
+    }
+    async onModuleDestroy() {
+        if (this.refreshInterval) {
+            clearInterval(this.refreshInterval);
+        }
+    }
+    async getConnectionGrant() {
+        if (!this.currentGrant) {
+            await this.refreshConnection();
+        }
+        const now = new Date();
+        const timeToExpiry = this.currentGrant.expiresAt.getTime() - now.getTime();
+        if (timeToExpiry < 5000) {
+            await this.refreshConnection();
+        }
+        return this.currentGrant;
+    }
+    async getDatabaseUrl() {
+        const grant = await this.getConnectionGrant();
+        return grant.databaseUrl;
+    }
+    async refreshConnection() {
+        if (!this.options.databaseId) {
+            throw new Error('databaseId is required for org-managed database');
+        }
+        try {
+            const database = await this.fetchJson(`${this.options.poolApiUrl}/databases/${this.options.databaseId}`);
+            const roleName = this.rolesForSchema(database.schemaName).rwRoleName;
+            const grant = await this.fetchJson(`${this.options.poolApiUrl}/connections/mint`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Biome-Id': this.options.biomeId || 'unknown',
+                },
+                body: JSON.stringify({
+                    databaseId: this.options.databaseId,
+                    schemaName: database.schemaName,
+                    roleName,
+                    ttlSeconds: 600,
+                }),
+            });
+            this.currentGrant = {
+                databaseUrl: this.buildPostgresUrl({
+                    host: grant.host,
+                    port: grant.port,
+                    database: grant.database,
+                    user: grant.user,
+                    password: grant.password,
+                    schema: grant.schema,
+                }),
+                host: grant.host,
+                port: grant.port,
+                database: grant.database,
+                schema: grant.schema,
+                user: grant.user,
+                password: grant.password,
+                expiresAt: new Date(grant.expiresAt),
+                databaseId: this.options.databaseId,
+                schemaName: database.schemaName,
+                roleName,
+            };
+            logger.log(`Connection grant refreshed for database ${this.options.databaseId}; expires at ${grant.expiresAt}`);
+        }
+        catch (err) {
+            logger.error(`Failed to refresh org-managed database connection: ${err instanceof Error ? err.message : String(err)}`);
+            throw err;
+        }
+    }
+    rolesForSchema(schemaName) {
+        const base = schemaName.toLowerCase().replace(/[^a-z0-9_]/g, '_').slice(0, 54);
+        return {
+            rwRoleName: `${base}_rw`,
+            roRoleName: `${base}_ro`,
+        };
+    }
+    buildPostgresUrl(input) {
+        const user = encodeURIComponent(input.user);
+        const password = encodeURIComponent(input.password);
+        const schema = encodeURIComponent(input.schema);
+        return `postgresql://${user}:${password}@${input.host}:${input.port}/${input.database}?schema=${schema}`;
+    }
+    async fetchJson(url, init) {
+        const response = await fetch(url, init);
+        if (!response.ok) {
+            throw new Error(`Request failed: ${response.status} ${response.statusText} (${url})`);
+        }
+        return (await response.json());
+    }
+};
+exports.OrgManagedDatabaseService = OrgManagedDatabaseService;
+exports.OrgManagedDatabaseService = OrgManagedDatabaseService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(exports.ORG_MANAGED_DATABASE_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], OrgManagedDatabaseService);
+let OrgManagedDatabaseModule = OrgManagedDatabaseModule_1 = class OrgManagedDatabaseModule {
+    static register(options) {
+        return {
+            module: OrgManagedDatabaseModule_1,
+            providers: [
+                {
+                    provide: exports.ORG_MANAGED_DATABASE_OPTIONS,
+                    useValue: options,
+                },
+                OrgManagedDatabaseService,
+            ],
+            exports: [OrgManagedDatabaseService],
+        };
+    }
+};
+exports.OrgManagedDatabaseModule = OrgManagedDatabaseModule;
+exports.OrgManagedDatabaseModule = OrgManagedDatabaseModule = OrgManagedDatabaseModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [OrgManagedDatabaseService],
+        exports: [OrgManagedDatabaseService],
+    })
+], OrgManagedDatabaseModule);
+function hasOrgDatabaseConfig() {
+    return Boolean(process.env.ORG_DATABASE_POOL_API_URL && process.env.ORG_DATABASE_ID);
+}
+//# sourceMappingURL=org-managed-db.module.js.map

package/dist/lib/org-managed-db.module.js.map

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

package/dist/lib/prisma-factory.d.ts

@@ -0,0 +1,13 @@
+import type { CreateBiomePrismaClientOptions } from './types';
+interface PrismaClientLike {
+    $on(event: 'error' | 'warn', handler: (event: {
+        message: string;
+        stack?: string;
+    }) => void): void;
+    $connect(): Promise<void>;
+    $disconnect(): Promise<void>;
+}
+export declare function createBiomePrismaClient(options: CreateBiomePrismaClientOptions): PrismaClientLike;
+export declare function disconnectBiomePrismaClient(client: PrismaClientLike, biomeId?: string): Promise<void>;
+export {};
+//# sourceMappingURL=prisma-factory.d.ts.map

package/dist/lib/prisma-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-factory.d.ts","sourceRoot":"","sources":["../../src/lib/prisma-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAI9D,UAAU,gBAAgB;IACxB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAClG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAmBD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,gBAAgB,CAsDlB;AAKD,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,MAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/lib/prisma-factory.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBiomePrismaClient = createBiomePrismaClient;
+exports.disconnectBiomePrismaClient = disconnectBiomePrismaClient;
+const common_1 = require("@nestjs/common");
+const logger = new common_1.Logger('BiomePrismaFactory');
+const { PrismaClient } = require('@prisma/client');
+function createBiomePrismaClient(options) {
+    const { databaseUrl, biomeId = 'unknown', schema, logLevel = 'warn' } = options;
+    if (!databaseUrl) {
+        throw new Error('[BiomePrismaFactory] databaseUrl is required');
+    }
+    let finalUrl = databaseUrl;
+    if (schema && !databaseUrl.includes(`schema=${schema}`)) {
+        const separator = databaseUrl.includes('?') ? '&' : '?';
+        finalUrl = `${databaseUrl}${separator}schema=${schema}`;
+    }
+    const client = new PrismaClient({
+        datasources: {
+            db: {
+                url: finalUrl,
+            },
+        },
+        log: [
+            {
+                emit: 'event',
+                level: logLevel,
+            },
+        ],
+    });
+    client.$on('error', (event) => {
+        logger.error(`[${biomeId}] Prisma error: ${event.message}`, event.stack);
+    });
+    client.$on('warn', (event) => {
+        logger.warn(`[${biomeId}] Prisma warn: ${event.message}`);
+    });
+    client.$connect()
+        .then(() => {
+        const schemaLabel = schema ? `${schema} schema` : 'default schema';
+        logger.log(`[${biomeId}] Prisma client connected to ${schemaLabel}`);
+    })
+        .catch((err) => {
+        logger.error(`[${biomeId}] Failed to connect Prisma client: ${err.message}`, err.stack);
+    });
+    return client;
+}
+async function disconnectBiomePrismaClient(client, biomeId = 'unknown') {
+    try {
+        await client.$disconnect();
+        logger.log(`[${biomeId}] Prisma client disconnected`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(`[${biomeId}] Failed to disconnect Prisma client: ${message}`);
+    }
+}
+//# sourceMappingURL=prisma-factory.js.map

package/dist/lib/prisma-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-factory.js","sourceRoot":"","sources":["../../src/lib/prisma-factory.ts"],"names":[],"mappings":";;AA4BA,0DAwDC;AAKD,kEAWC;AApGD,2CAAwC;AAGxC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,oBAAoB,CAAC,CAAC;AAQhD,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAYhD,CAAC;AAKF,SAAgB,uBAAuB,CACrC,OAAuC;IAEvC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAEhF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAGD,IAAI,QAAQ,GAAG,WAAW,CAAC;IAC3B,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,MAAM,EAAE,CAAC,EAAE,CAAC;QACxD,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACxD,QAAQ,GAAG,GAAG,WAAW,GAAG,SAAS,UAAU,MAAM,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,WAAW,EAAE;YACX,EAAE,EAAE;gBACF,GAAG,EAAE,QAAQ;aACd;SACF;QACD,GAAG,EAAE;YACH;gBACE,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,QAAe;aACvB;SACF;KACF,CAAC,CAAC;IAGH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5B,MAAM,CAAC,KAAK,CACV,IAAI,OAAO,mBAAmB,KAAK,CAAC,OAAO,EAAE,EAC7C,KAAK,CAAC,KAAK,CACZ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;QAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAGH,MAAM,CAAC,QAAQ,EAAE;SACd,IAAI,CAAC,GAAG,EAAE;QACT,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACnE,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,gCAAgC,WAAW,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,CAAC,KAAK,CACV,IAAI,OAAO,sCAAsC,GAAG,CAAC,OAAO,EAAE,EAC9D,GAAG,CAAC,KAAK,CACV,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,OAAO,MAAM,CAAC;AAChB,CAAC;AAKM,KAAK,UAAU,2BAA2B,CAC/C,MAAwB,EACxB,UAAkB,SAAS;IAE3B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,8BAA8B,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,yCAAyC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,69 @@
+export type MigrationType = 'prisma' | 'flyway' | 'drizzle' | 'custom';
+export interface DatabaseConfig {
+    name: string;
+    schema?: string;
+}
+export interface EnsureDatabaseUrlsOptions {
+    singleDatabase?: boolean;
+    dbName?: string;
+    dbSchema?: string;
+    databases?: Record<string, DatabaseConfig>;
+}
+export interface CreateBiomePrismaClientOptions {
+    databaseUrl: string;
+    biomeId?: string;
+    schema?: string;
+    logLevel?: 'error' | 'warn' | 'info' | 'debug';
+}
+export interface DiscoverMigrationsOptions {
+    searchPaths: string[];
+    migrationType: MigrationType;
+}
+export interface DiscoveredMigrations {
+    applied: MigrationRecord[];
+    pending: MigrationRecord[];
+    errors?: string[];
+}
+export interface MigrationRecord {
+    name: string;
+    checksum?: string;
+    appliedAt?: Date;
+    path: string;
+}
+export interface BiomeMigrationOptions {
+    databaseUrl: string;
+    migrationsPath: string;
+    migrationType: MigrationType;
+    dryRun?: boolean;
+    backupBeforeRun?: boolean;
+    biomeId?: string;
+    orgDatabasePoolApiUrl?: string;
+    databaseId?: string;
+}
+export interface BiomeMigrationResult {
+    success: boolean;
+    migrationsRun: string[];
+    errors?: string[];
+    backupId?: string;
+    duration: number;
+}
+export interface OrgManagedDatabaseOptions {
+    poolApiUrl: string;
+    refreshConnInterval?: number;
+    databaseId?: string;
+    biomeId?: string;
+}
+export interface ConnectionGrant {
+    databaseUrl: string;
+    host: string;
+    port: number;
+    database: string;
+    schema: string;
+    user: string;
+    password: string;
+    expiresAt: Date;
+    databaseId: string;
+    schemaName: string;
+    roleName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAKvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAKD,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAKD,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAKD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAKD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/lib/types.js

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

package/dist/lib/types.js.map

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

package/dist/lib/url-builder.d.ts

@@ -0,0 +1,3 @@
+import type { EnsureDatabaseUrlsOptions } from './types';
+export declare function ensureDatabaseUrls(options?: EnsureDatabaseUrlsOptions): void;
+//# sourceMappingURL=url-builder.d.ts.map

package/dist/lib/url-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../src/lib/url-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAUzE,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,IAAI,CAahF"}

package/dist/lib/url-builder.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDatabaseUrls = ensureDatabaseUrls;
+function ensureDatabaseUrls(options = {}) {
+    const { singleDatabase = true, dbName, dbSchema, databases, } = options;
+    if (singleDatabase) {
+        ensureSingleDatabase(dbName, dbSchema);
+    }
+    else {
+        ensureMultiDatabase(databases || {});
+    }
+}
+function ensureSingleDatabase(dbName, dbSchema) {
+    if (process.env.DATABASE_URL) {
+        return;
+    }
+    const { DB_USER, DB_PASSWORD, DB_HOST, DB_PORT, DB_NAME, DB_SCHEMA, DB_SSL_PARAMS, } = process.env;
+    const user = DB_USER;
+    const password = DB_PASSWORD;
+    const host = DB_HOST;
+    const port = DB_PORT;
+    const name = DB_NAME || dbName || 'xema';
+    const schema = DB_SCHEMA || dbSchema;
+    const ssl = DB_SSL_PARAMS;
+    if (!user || !password || !host || !port) {
+        throw new Error('[BiomeDatabase] DATABASE_URL not set and incomplete DB_* env vars. ' +
+            'Set DATABASE_URL or provide DB_USER, DB_PASSWORD, DB_HOST, DB_PORT');
+    }
+    const base = `postgresql://${user}:${encodeURIComponent(password)}@${host}:${port}/${name}`;
+    const schemaPart = schema ? `schema=${schema}` : null;
+    const params = [schemaPart, ssl].filter(Boolean).join('&');
+    process.env.DATABASE_URL = params ? `${base}?${params}` : base;
+}
+function ensureMultiDatabase(databases) {
+    for (const [key, config] of Object.entries(databases)) {
+        const envKey = key === 'main' ? 'DATABASE_URL' : `DATABASE_URL_${key.toUpperCase()}`;
+        if (process.env[envKey]) {
+            continue;
+        }
+        const { DB_USER, DB_PASSWORD, DB_HOST, DB_PORT, DB_SSL_PARAMS, } = process.env;
+        if (!DB_USER || !DB_PASSWORD || !DB_HOST || !DB_PORT) {
+            throw new Error(`[BiomeDatabase] ${envKey} not set and incomplete DB_* env vars. ` +
+                'Set DATABASE_URL or provide DB_USER, DB_PASSWORD, DB_HOST, DB_PORT');
+        }
+        const base = `postgresql://${DB_USER}:${encodeURIComponent(DB_PASSWORD)}@${DB_HOST}:${DB_PORT}/${config.name}`;
+        const schemaPart = config.schema ? `schema=${config.schema}` : null;
+        const params = [schemaPart, DB_SSL_PARAMS].filter(Boolean).join('&');
+        process.env[envKey] = params ? `${base}?${params}` : base;
+    }
+}
+//# sourceMappingURL=url-builder.js.map

package/dist/lib/url-builder.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@xemahq/biome-database-sdk",
+  "version": "0.1.1",
+  "description": "Shared utilities for biome API services: database URL construction, migration discovery (Prisma/Flyway/Drizzle), org-managed database attachment, Prisma client factory, and migration runner. Eliminates code duplication across biomes.",
+  "license": "Proprietary",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./dist/lib/*": {
+      "types": "./dist/lib/*.d.ts",
+      "default": "./dist/lib/*.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@xemahq/platform-common": "^0.1.3"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=10",
+    "@nestjs/core": ">=10",
+    "@prisma/client": ">=5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "@nestjs/common": "11.1.13",
+    "@nestjs/core": "11.1.13",
+    "@nestjs/testing": "11.1.13",
+    "@prisma/client": "^5.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0"
+  },
+  "keywords": [
+    "xema",
+    "biome",
+    "database",
+    "prisma",
+    "migrations",
+    "org-managed"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "test": "jest --passWithNoTests"
+  }
+}

package/src/index.ts

@@ -0,0 +1,51 @@
+/**
+ * @xemahq/biome-database-sdk
+ *
+ * Shared utilities for biome API services to initialize, discover, and manage databases.
+ * Eliminates code duplication across biomes while supporting single/multi-database setups,
+ * org-managed database attachment, and multiple migration systems.
+ *
+ * @example
+ * // In a biome's main.ts
+ * import { ensureDatabaseUrls } from '@xemahq/biome-database-sdk';
+ *
+ * ensureDatabaseUrls({ singleDatabase: true });
+ * await NestFactory.create(AppModule);
+ *
+ * @example
+ * // In a biome's app.module.ts
+ * import { OrgManagedDatabaseModule } from '@xemahq/biome-database-sdk';
+ *
+ * @Module({
+ *   imports: [
+ *     OrgManagedDatabaseModule.register({
+ *       poolApiUrl: process.env.ORG_DATABASE_POOL_API_URL,
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ */
+
+export { ensureDatabaseUrls } from './lib/url-builder';
+export { discoverMigrations } from './lib/migration-discovery';
+export { createBiomePrismaClient, disconnectBiomePrismaClient } from './lib/prisma-factory';
+export { runBiomeMigration } from './lib/migration-runner';
+export {
+  OrgManagedDatabaseModule,
+  OrgManagedDatabaseService,
+  hasOrgDatabaseConfig,
+} from './lib/org-managed-db.module';
+
+export type {
+  MigrationType,
+  DatabaseConfig,
+  EnsureDatabaseUrlsOptions,
+  CreateBiomePrismaClientOptions,
+  DiscoverMigrationsOptions,
+  DiscoveredMigrations,
+  MigrationRecord,
+  BiomeMigrationOptions,
+  BiomeMigrationResult,
+  OrgManagedDatabaseOptions,
+  ConnectionGrant,
+} from './lib/types';

package/src/lib/migration-discovery.ts

@@ -0,0 +1,134 @@
+import { promises as fs } from 'node:fs';
+import { join, resolve } from 'node:path';
+import type { DiscoveredMigrations, DiscoverMigrationsOptions, MigrationRecord, MigrationType } from './types';
+
+/**
+ * Discovers migrations in the given search paths.
+ * Supports Prisma, Flyway, Drizzle, and custom migration structures.
+ *
+ * Returns applied and pending migrations based on the migration system.
+ */
+export async function discoverMigrations(
+  options: DiscoverMigrationsOptions,
+): Promise<DiscoveredMigrations> {
+  const { searchPaths, migrationType } = options;
+  const errors: string[] = [];
+  const allMigrations: MigrationRecord[] = [];
+
+  for (const searchPath of searchPaths) {
+    try {
+      const absolutePath = resolve(searchPath);
+      const migrations = await discoverMigrationsInPath(absolutePath, migrationType);
+      allMigrations.push(...migrations);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      errors.push(`Failed to discover migrations in ${searchPath}: ${message}`);
+    }
+  }
+
+  // For now, we return all discovered as "pending" since we can't determine
+  // applied status without a database connection. The calling code can refine
+  // this by comparing against `_prisma_migrations` or equivalent.
+  return {
+    applied: [],
+    pending: allMigrations,
+    ...(errors.length > 0 ? { errors } : {}),
+  };
+}
+
+/**
+ * Discover migrations in a single directory.
+ */
+async function discoverMigrationsInPath(
+  searchPath: string,
+  migrationType: MigrationType,
+): Promise<MigrationRecord[]> {
+  try {
+    await fs.access(searchPath);
+  } catch {
+    return [];  // path doesn't exist
+  }
+
+  switch (migrationType) {
+    case 'prisma':
+      return discoverPrismaMigrations(searchPath);
+    case 'flyway':
+      return discoverFlywayMigrations(searchPath);
+    case 'drizzle':
+      return discoverDrizzleMigrations(searchPath);
+    default:
+      return [];
+  }
+}
+
+/**
+ * Discover Prisma migrations (numeric directory naming convention).
+ * Example: 20240101120000_init, 20240102150000_add_users_table
+ */
+async function discoverPrismaMigrations(searchPath: string): Promise<MigrationRecord[]> {
+  const entries = await fs.readdir(searchPath, { withFileTypes: true });
+  const migrations: MigrationRecord[] = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+
+    const name = entry.name;
+    // Prisma format: numeric timestamp + underscore + description
+    if (/^\d{14}_/.test(name)) {
+      migrations.push({
+        name,
+        path: join(searchPath, name),
+      });
+    }
+  }
+
+  return migrations.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+/**
+ * Discover Flyway migrations (V/U/R + numeric version + optional description).
+ * Example: V1__init.sql, V2__add_users.sql
+ */
+async function discoverFlywayMigrations(searchPath: string): Promise<MigrationRecord[]> {
+  const entries = await fs.readdir(searchPath, { withFileTypes: true });
+  const migrations: MigrationRecord[] = [];
+
+  for (const entry of entries) {
+    if (entry.isDirectory()) continue;
+
+    const name = entry.name;
+    // Flyway format: V<version>__<description>.sql or similar
+    if (/^[VUR]\d+__.+\.sql$/i.test(name)) {
+      migrations.push({
+        name,
+        path: join(searchPath, name),
+      });
+    }
+  }
+
+  return migrations.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+/**
+ * Discover Drizzle migrations (epoch + underscore + description).
+ * Example: 0001_init.sql, 0002_add_users.sql
+ */
+async function discoverDrizzleMigrations(searchPath: string): Promise<MigrationRecord[]> {
+  const entries = await fs.readdir(searchPath, { withFileTypes: true });
+  const migrations: MigrationRecord[] = [];
+
+  for (const entry of entries) {
+    if (entry.isDirectory()) continue;
+
+    const name = entry.name;
+    // Drizzle format: <epoch>_<description>.sql
+    if (/^\d+_.+\.sql$/i.test(name)) {
+      migrations.push({
+        name,
+        path: join(searchPath, name),
+      });
+    }
+  }
+
+  return migrations.sort((a, b) => a.name.localeCompare(b.name));
+}