drizzle-multitenant 1.0.10 → 1.1.0

package/dist/migrator/index.d.ts

@@ -1,4 +1,4 @@
-import { C as Config } from '../types-B5eSRLFW.js';
+import { C as Config } from '../types-BhK96FPC.js';
 import { Pool } from 'pg';
 import 'drizzle-orm/node-postgres';
 

package/dist/{types-B5eSRLFW.d.ts → types-BhK96FPC.d.ts}

@@ -182,6 +182,116 @@ interface WarmupResult {
     durationMs: number;
     details: TenantWarmupResult[];
 }
+/**
+ * Health status for a pool
+ */
+type PoolHealthStatus = 'ok' | 'degraded' | 'unhealthy';
+/**
+ * Health information for a single pool
+ */
+interface PoolHealth {
+    /** Tenant ID */
+    tenantId: string;
+    /** Schema name */
+    schemaName: string;
+    /** Health status */
+    status: PoolHealthStatus;
+    /** Total connections in pool */
+    totalConnections: number;
+    /** Idle connections available */
+    idleConnections: number;
+    /** Waiting requests in queue */
+    waitingRequests: number;
+    /** Response time of health ping in ms */
+    responseTimeMs?: number;
+    /** Error message if unhealthy */
+    error?: string;
+}
+/**
+ * Options for health check
+ */
+interface HealthCheckOptions {
+    /** Execute ping query to verify connection (default: true) */
+    ping?: boolean;
+    /** Timeout for ping query in ms (default: 5000) */
+    pingTimeoutMs?: number;
+    /** Include shared database in check (default: true) */
+    includeShared?: boolean;
+    /** Check specific tenant IDs only */
+    tenantIds?: string[];
+}
+/**
+ * Connection metrics for a pool
+ */
+interface ConnectionMetrics {
+    /** Total connections in pool */
+    total: number;
+    /** Idle connections available */
+    idle: number;
+    /** Waiting requests in queue */
+    waiting: number;
+}
+/**
+ * Metrics for a single tenant pool
+ */
+interface TenantPoolMetrics {
+    /** Tenant ID */
+    tenantId: string;
+    /** Schema name */
+    schemaName: string;
+    /** Connection metrics */
+    connections: ConnectionMetrics;
+    /** Last access timestamp */
+    lastAccessedAt: string;
+}
+/**
+ * Aggregate metrics result
+ */
+interface MetricsResult {
+    /** Pool metrics */
+    pools: {
+        /** Total active pools */
+        total: number;
+        /** Maximum pools allowed */
+        maxPools: number;
+        /** Individual tenant pool metrics */
+        tenants: TenantPoolMetrics[];
+    };
+    /** Shared database metrics (if initialized) */
+    shared: {
+        /** Whether shared pool is initialized */
+        initialized: boolean;
+        /** Connection metrics */
+        connections: ConnectionMetrics | null;
+    };
+    /** Timestamp of metrics collection */
+    timestamp: string;
+}
+/**
+ * Health check result
+ */
+interface HealthCheckResult {
+    /** Overall health status */
+    healthy: boolean;
+    /** Health of tenant pools */
+    pools: PoolHealth[];
+    /** Health status of shared database */
+    sharedDb: PoolHealthStatus;
+    /** Response time of shared db ping in ms */
+    sharedDbResponseTimeMs?: number;
+    /** Error on shared db if any */
+    sharedDbError?: string;
+    /** Total active pools */
+    totalPools: number;
+    /** Pools with degraded status */
+    degradedPools: number;
+    /** Pools with unhealthy status */
+    unhealthyPools: number;
+    /** Timestamp of health check */
+    timestamp: string;
+    /** Total duration of health check in ms */
+    durationMs: number;
+}
 /**
  * Tenant manager interface
  */
@@ -208,6 +318,10 @@ interface TenantManager<TTenantSchema extends Record<string, unknown> = Record<s
     evictPool(tenantId: string): Promise<void>;
     /** Pre-warm pools for specified tenants to reduce cold start latency */
     warmup(tenantIds: string[], options?: WarmupOptions): Promise<WarmupResult>;
+    /** Check health of all pools and connections */
+    healthCheck(options?: HealthCheckOptions): Promise<HealthCheckResult>;
+    /** Get current metrics for all pools (zero overhead, collected on demand) */
+    getMetrics(): MetricsResult;
     /** Dispose all pools and cleanup */
     dispose(): Promise<void>;
 }
@@ -232,4 +346,4 @@ declare const DEFAULT_CONFIG: {
     };
 };
 
-export { type Config as C, type DebugConfig as D, type Hooks as H, type IsolationConfig as I, type MetricsConfig as M, type PoolEntry as P, type RetryConfig as R, type SharedDb as S, type TenantManager as T, type WarmupOptions as W, type TenantDb as a, type ConnectionConfig as b, type IsolationStrategy as c, type SchemasConfig as d, type DebugContext as e, type WarmupResult as f, type TenantWarmupResult as g, DEFAULT_CONFIG as h };
+export { type Config as C, type DebugConfig as D, type Hooks as H, type IsolationConfig as I, type MetricsConfig as M, type PoolEntry as P, type RetryConfig as R, type SharedDb as S, type TenantManager as T, type WarmupOptions as W, type TenantDb as a, type ConnectionConfig as b, type IsolationStrategy as c, type SchemasConfig as d, type DebugContext as e, type WarmupResult as f, type TenantWarmupResult as g, type HealthCheckOptions as h, type HealthCheckResult as i, type PoolHealth as j, type PoolHealthStatus as k, type MetricsResult as l, type TenantPoolMetrics as m, type ConnectionMetrics as n, DEFAULT_CONFIG as o };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drizzle-multitenant",
-  "version": "1.0.10",
+  "version": "1.1.0",
   "description": "Multi-tenancy toolkit for Drizzle ORM with schema isolation, tenant context, and parallel migrations",
   "type": "module",
   "main": "./dist/index.js",