@xemahq/biome-database-nest 0.12.1 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/biome-database-nest",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Explicit database migration ownership, least-privilege runtime verification, and schema-qualified Prisma wiring for Xema biome services.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
@@ -18,25 +18,24 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "devDependencies": {
-    "@nestjs/common": "11.1.13",
-    "@nestjs/core": "11.1.13",
+    "@nestjs/common": "11.1.18",
+    "@nestjs/core": "11.1.18",
     "@nestjs/swagger": "11.2.6",
     "@types/jest": "^30.0.0",
     "@types/node": "25.2.3",
     "@types/pg": "^8.16.0",
     "@xemahq/identity-client": "^0.9.1",
-    "@xemahq/kernel-contracts": "^8.0.0",
+    "@xemahq/kernel-contracts": "^10.0.0",
     "jest": "^30.3.0",
     "prettier": "3.6.2",
     "ts-jest": "^29.4.9",
     "typescript": "5.9.3",
-    "@xemahq/platform-common": "^0.7.4",
-    "@xemahq/xema-decorators": "0.5.3",
-    "@xemahq/service-registry-nest": "0.7.0"
+    "@xemahq/platform-common": "^0.9.0",
+    "@xemahq/service-registry-nest": "0.7.1",
+    "@xemahq/xema-decorators": "0.5.4"
   },
   "peerDependencies": {
     "@nestjs/common": "^10 || ^11",
@@ -48,7 +47,7 @@
     "@xemahq/kernel-contracts": ">=0.13.0",
     "@xemahq/service-registry-nest": ">=0.2.0",
     "@xemahq/xema-decorators": ">=0.2.0",
-    "@xemahq/platform-common": "^0.5.9 || ^0.6.0 || ^0.7.0"
+    "@xemahq/platform-common": "^0.9.0"
   },
   "dependencies": {
     "@xemahq/migration-runner-prisma": "^0.1.2",

package/src/index.ts

@@ -1,115 +0,0 @@
-export { DEFAULT_BIOME_DB_KEY, deriveBiomeSchemaName } from './lib/schema-name';
-export {
-  composeIdentifier,
-  fitIdentifier,
-  IDENTIFIER_HASH_LENGTH,
-  POSTGRES_MAX_IDENTIFIER_LENGTH,
-  sanitizeIdentifierChars,
-  sanitizeIdentifierSegment,
-  type ComposeIdentifierInput,
-  type FitIdentifierInput,
-} from './lib/identifier';
-export {
-  rolesForSchema,
-  schemaRoleBase,
-  schemaRoleName,
-  SchemaRoleKind,
-  SCHEMA_ROLE_BASE_MAX_LENGTH,
-  SCHEMA_ROLE_SUFFIX_LENGTH,
-  type SchemaRoleNames,
-} from './lib/role-names';
-export {
-  resolveBiomeDatabaseConfigFromEnv,
-  type BiomeDatabaseConfig,
-} from './lib/config';
-export {
-  createBiomePrismaAdapter,
-  createBiomePrismaAdapterFromEnv,
-} from './lib/adapter';
-export {
-  fetchSystemDatabaseConfig,
-  type SystemDatabaseConfigRequest,
-} from './lib/control-plane-client';
-export {
-  resolveControlPlaneBaseUrl,
-  ORG_DATABASE_POOL_SERVICE_NAME,
-  type ControlPlaneDiscoveryOptions,
-} from './lib/control-plane-discovery';
-export {
-  bootstrapBiomeDatabases,
-  type BiomeDatabaseDeclaration,
-  type BootstrapBiomeDatabasesOptions,
-} from './lib/bootstrap';
-export { BiomeDatabaseMigrationMode } from './lib/migration-mode';
-export {
-  BiomeDatabaseModule,
-  BIOME_DATABASE_READY,
-  type ApplicationManagedBiomeDatabaseModuleOptions,
-  type BiomeDatabaseModuleOptions,
-} from './lib/nest/biome-database.module';
-export {
-  createBiomePrismaService,
-  type BiomePrismaClient,
-  type BiomePrismaClientCtor,
-  type BiomePrismaServiceInstance,
-  type CreateBiomePrismaServiceOptions,
-  type TenantIsolationServiceOptions,
-  type TenantScopedApi,
-} from './lib/nest/prisma-service-factory';
-export {
-  TenantIsolationMode,
-  TENANT_ISOLATION_MODE_ENV_VAR,
-  resolveTenantIsolationMode,
-} from './lib/tenant-isolation/tenant-isolation-mode';
-export {
-  TenantIsolationError,
-  TenantIsolationViolationKind,
-  formatTenantIsolationViolation,
-  type TenantIsolationViolation,
-} from './lib/tenant-isolation/tenant-isolation-error';
-export {
-  PrismaModelOperation,
-  scopeArgsToOrg,
-  type OrgScopeOutcome,
-  type OrgScopeRequest,
-} from './lib/tenant-isolation/org-scope';
-export {
-  DEFAULT_ORG_FIELD,
-  collectOrgScopedModels,
-  createTenantIsolationExtension,
-  readRuntimeModels,
-  type CreateTenantIsolationExtensionOptions,
-  type RuntimeDataModelField,
-  type RuntimeDataModelModel,
-  type TenantIsolationExtensionDefinition,
-  type TenantIsolationLogger,
-  type TenantIsolationQueryContext,
-} from './lib/tenant-isolation/tenant-isolation.extension';
-export {
-  assertUnscopedModelsDeclared,
-  collectUnscopableModels,
-  formatUnscopedModelReport,
-  normalizeUnscopedModelDeclarations,
-  UndeclaredUnscopedModelsError,
-  type AssertUnscopedModelsOptions,
-  type NormalizedUnscopedModelDeclaration,
-  type UnscopedModelDeclaration,
-  type UnscopedModelDeclarations,
-} from './lib/tenant-isolation/unscoped-models';
-export {
-  assertOrgErasureMatchesModels,
-  eraseOrgData,
-  OrgErasureBlockedError,
-  OrgErasureMatchesNothingError,
-  type EraseOrgDataOptions,
-  type OrgErasureReport,
-} from './lib/tenant-isolation/org-erasure';
-export {
-  OrgErasureModule,
-  OrgErasureController,
-  ORG_ERASURE_RUNNER,
-  ORG_DATA_ERASURE_CAPABILITY,
-  ORG_ERASURE_ROUTE_PATH,
-  type OrgErasureModuleOptions,
-  type OrgErasureRunner,
-} from './lib/nest/org-erasure.module';

package/src/lib/adapter.ts

@@ -1,117 +0,0 @@
-import { PrismaPg } from '@prisma/adapter-pg';
-import {
-  composeBiomeDatabaseUrl,
-  ensureBiomeDbSearchPath,
-} from '@xemahq/platform-common';
-
-import { resolveBiomeDatabaseConfigFromEnv } from './config';
-
-import type { BiomeDatabaseConfig } from './config';
-
-const DEFAULT_POOL_MAX = 3;
-
-/**
- * Build a connection string from a {@link BiomeDatabaseConfig}, with `?schema=`
- * when a per-biome schema is set and the libpq `search_path` option applied so
- * RAW queries also resolve to the biome schema.
- *
- * @throws if the config is missing a part required to form a URL.
- */
-function buildBiomeConnectionString(config: BiomeDatabaseConfig): string {
-  const url = composeBiomeDatabaseUrl({
-    user: config.username,
-    password: config.password,
-    host: config.host,
-    port: String(config.port),
-    database: config.database,
-    ...(config.schema !== undefined ? { schema: config.schema } : {}),
-    ...(config.sslParams !== undefined ? { sslParams: config.sslParams } : {}),
-  });
-  if (url === null) {
-    throw new Error(
-      'createBiomePrismaAdapter: incomplete BiomeDatabaseConfig — ' +
-        'host/port/database/username/password are all required.',
-    );
-  }
-  return ensureBiomeDbSearchPath(url);
-}
-
-/**
- * Construct a {@link PrismaPg} driver-adapter pool whose Prisma Client qualifies
- * ORM table names with the biome schema.
- *
- * THIS IS THE CENTRALIZED FIX. `@prisma/adapter-pg` (Prisma 7) ignores BOTH the
- * URL `?schema=` and the connection `search_path` when qualifying ORM-emitted
- * SQL — it falls back to `public.<table>` unless the schema is passed as the
- * SECOND constructor argument. Passing `{ schema }` here makes Prisma emit
- * `biome_<id>.<table>`. `ensureBiomeDbSearchPath` separately fixes RAW queries.
- * Constructing the adapter correctly is the ONLY thing this function does, so
- * the correct construction is the only construction a biome can perform.
- */
-export function createBiomePrismaAdapter(
-  config: BiomeDatabaseConfig,
-): PrismaPg {
-  const connectionString = buildBiomeConnectionString(config);
-  return new PrismaPg(
-    {
-      connectionString,
-      min: 1,
-      max: config.poolMax ?? DEFAULT_POOL_MAX,
-      idleTimeoutMillis: 30_000,
-    },
-    config.schema !== undefined ? { schema: config.schema } : undefined,
-  );
-}
-
-/**
- * Construct the schema-qualified adapter from the environment — the path the
- * unchanged-shape `PrismaService` calls at construction time (post-bootstrap,
- * where `DATABASE_URL`/`DB_*` are guaranteed set).
- *
- * Resolution order:
- * 1. If `DATABASE_URL` (or `DATABASE_URL_<KEY>` for a non-default key) is set,
- *    use it directly as the connection string (still applying
- *    `ensureBiomeDbSearchPath` + the `{ schema }` second-arg from `DB_SCHEMA`).
- * 2. Otherwise compose from the discrete `DB_*` vars.
- *
- * @throws if neither a `DATABASE_URL` nor a complete `DB_*` set is present.
- */
-export function createBiomePrismaAdapterFromEnv(
-  env: NodeJS.ProcessEnv = process.env,
-  dbKey?: string,
-): PrismaPg {
-  const isDefault = dbKey === undefined || dbKey === '' || dbKey === 'primary';
-  const upperSuffix = isDefault
-    ? ''
-    : `_${dbKey.toUpperCase().replace(/[^A-Z0-9]/g, '_')}`;
-
-  const directUrl = env[`DATABASE_URL${upperSuffix}`];
-  const schema = env[`DB_SCHEMA${upperSuffix}`];
-  const poolMaxRaw = env[`DB_POOL_MAX${upperSuffix}`] ?? env.DB_POOL_MAX;
-  const poolMax =
-    poolMaxRaw !== undefined && poolMaxRaw !== ''
-      ? Number.parseInt(poolMaxRaw, 10)
-      : DEFAULT_POOL_MAX;
-
-  if (directUrl !== undefined && directUrl !== '') {
-    const connectionString = ensureBiomeDbSearchPath(directUrl);
-    return new PrismaPg(
-      {
-        connectionString,
-        min: 1,
-        max: poolMax,
-        idleTimeoutMillis: 30_000,
-      },
-      schema !== undefined && schema !== '' ? { schema } : undefined,
-    );
-  }
-
-  const config = resolveBiomeDatabaseConfigFromEnv(env, dbKey);
-  if (config === null) {
-    throw new Error(
-      `createBiomePrismaAdapterFromEnv: no DATABASE_URL${upperSuffix} and no ` +
-        `DB_HOST${upperSuffix}/DB_HOST in the environment — cannot construct an adapter.`,
-    );
-  }
-  return createBiomePrismaAdapter(config);
-}