@dotdo/postgres 0.1.0

package/dist/config/streaming.js

@@ -0,0 +1,132 @@
+/**
+ * Streaming Configuration Constants
+ *
+ * Centralized constants for query streaming and memory-bounded streams.
+ * These values control buffer sizes, water marks for backpressure, and
+ * batch sizes for cursor-based query streaming.
+ *
+ * ## Water Mark System
+ *
+ * The streaming system uses a dual water mark approach to prevent thrashing:
+ *
+ * ```
+ * Memory
+ *   ^
+ *   |  memoryLimit -------- Hard limit (throws OOM)
+ *   |
+ *   |  highWaterMark ------ Pause point
+ *   |       |
+ *   |       v  (paused zone)
+ *   |  lowWaterMark ------- Resume point
+ *   |       |
+ *   |       v  (normal zone)
+ *   +-------------------------> Time
+ * ```
+ *
+ * @module config/streaming
+ */
+// =============================================================================
+// Memory Limits for Streaming
+// =============================================================================
+/**
+ * Default memory limit for streaming operations (50MB).
+ *
+ * This is the hard limit that triggers StreamingOOMError when exceeded.
+ * Set lower than Worker limit to leave room for other operations.
+ *
+ * Calculation:
+ * - 128MB Worker limit
+ * - ~55MB PGLite baseline
+ * - ~23MB buffer for other operations
+ * = ~50MB available for streaming
+ */
+export const DEFAULT_STREAMING_MEMORY_LIMIT = 50 * 1024 * 1024;
+// =============================================================================
+// Water Marks for Backpressure
+// =============================================================================
+/**
+ * Default high water mark for streaming backpressure (10MB).
+ *
+ * When buffered data exceeds this threshold, the stream pauses the producer
+ * and waits for the consumer to catch up. This prevents unbounded memory growth.
+ *
+ * Set at 20% of memory limit to provide early warning without being too aggressive.
+ */
+export const DEFAULT_HIGH_WATER_MARK = 10 * 1024 * 1024;
+/**
+ * Default low water mark for streaming resume (5MB).
+ *
+ * When buffered data drops below this threshold after being paused,
+ * the stream resumes producing. The gap between high and low marks
+ * prevents rapid pause/resume oscillation (thrashing).
+ *
+ * Set at 10% of memory limit (50% of high water mark).
+ */
+export const DEFAULT_LOW_WATER_MARK = 5 * 1024 * 1024;
+// =============================================================================
+// Query Streaming Configuration
+// =============================================================================
+/**
+ * Default number of rows per cursor fetch batch (100).
+ *
+ * Balance between:
+ * - Too small: High overhead from many FETCH calls
+ * - Too large: Memory spikes, poor backpressure responsiveness
+ *
+ * 100 rows is a good default for typical row sizes (1-10KB).
+ * Adjust based on actual row sizes in your workload.
+ */
+export const DEFAULT_BATCH_SIZE = 100;
+/**
+ * Default cursor name prefix for streaming queries.
+ *
+ * Combined with a unique suffix (timestamp or counter) to create
+ * cursor names like 'pglite_cursor_1234567890'.
+ */
+export const DEFAULT_CURSOR_PREFIX = 'pglite_cursor';
+// =============================================================================
+// Row Size Estimation
+// =============================================================================
+/**
+ * Fallback row size estimate when serialization fails (1KB).
+ *
+ * Used by estimateRowsMemory() when JSON.stringify() fails due to
+ * circular references or other issues.
+ */
+export const FALLBACK_ROW_SIZE_BYTES = 1024;
+// =============================================================================
+// Buffer Pool Configuration (from buffer-pool.ts)
+// =============================================================================
+/**
+ * Base memory overhead per JavaScript object (64 bytes).
+ *
+ * Includes object header, hidden class pointer, and other V8 internals.
+ * Used for accurate memory tracking in buffer pools.
+ */
+export const OBJECT_BASE_OVERHEAD = 64;
+/**
+ * Bytes per character in JavaScript strings (2 bytes).
+ *
+ * JavaScript uses UTF-16 encoding, so each character takes 2 bytes.
+ * Used for string memory estimation.
+ */
+export const BYTES_PER_CHAR = 2;
+/**
+ * String header overhead in bytes (24 bytes).
+ *
+ * V8 string objects have a header with length, hash, and encoding info.
+ */
+export const STRING_HEADER_OVERHEAD = 24;
+/**
+ * Base overhead for JavaScript arrays (24 bytes).
+ *
+ * Includes array length and pointer to backing store.
+ */
+export const ARRAY_BASE_OVERHEAD = 24;
+/**
+ * Per-element overhead in JavaScript arrays (8 bytes).
+ *
+ * Each array element is a tagged pointer (8 bytes on 64-bit).
+ */
+export const ARRAY_ELEMENT_OVERHEAD = 8;
+//# sourceMappingURL=streaming.js.map

package/dist/config/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/config/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAE9D,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAEvD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;AAErD,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAErC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAA;AAEpD,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAA;AAE3C,gFAAgF;AAChF,kDAAkD;AAClD,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAA;AAE/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAA;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAA"}

package/dist/config/timeouts.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Timeout Configuration Constants
+ *
+ * Centralized timeout values used throughout the postgres package.
+ * These constants define standard wait times for various operations
+ * including monitoring, recovery, connection, and shutdown.
+ *
+ * ## Timeout Categories
+ *
+ * - **Check Intervals**: How often to poll for state changes
+ * - **Grace Periods**: Time allowed for operations to complete
+ * - **Connection Timeouts**: Maximum wait for network operations
+ * - **Recovery Timeouts**: Time before retrying after failures
+ *
+ * @module config/timeouts
+ */
+/**
+ * Default interval for memory pressure checks (5 seconds).
+ *
+ * How often the MemoryPressureManager samples heap usage and
+ * evaluates pressure thresholds. Lower values provide faster
+ * response but use more CPU.
+ */
+export declare const DEFAULT_CHECK_INTERVAL_MS = 5000;
+/**
+ * Minimum interval between GC hint triggers (5 seconds).
+ *
+ * Prevents GC thrashing by rate-limiting garbage collection hints.
+ * Allows the runtime to stabilize between collections.
+ */
+export declare const DEFAULT_GC_HINT_MIN_INTERVAL_MS = 5000;
+/**
+ * Default interval for memory pressure recovery hysteresis (2 seconds).
+ *
+ * Time to wait at normal pressure before considering recovery complete.
+ * Prevents oscillation when pressure hovers near thresholds.
+ */
+export declare const DEFAULT_RECOVERY_HYSTERESIS_MS = 2000;
+/**
+ * Default interval between recovery steps (1 second).
+ *
+ * When gradually re-enabling features after recovery, this controls
+ * how long to wait between enabling each feature.
+ */
+export declare const DEFAULT_RECOVERY_STEP_INTERVAL_MS = 1000;
+/**
+ * Default time at elevated pressure before alert (5 seconds).
+ *
+ * Triggers sustained pressure callback when pressure level remains
+ * elevated for this duration. Helps distinguish transient spikes
+ * from persistent memory issues.
+ */
+export declare const DEFAULT_SUSTAINED_PRESSURE_THRESHOLD_MS = 5000;
+/**
+ * Default timeout for paused queries (30 seconds).
+ *
+ * Maximum time a query can be paused due to memory pressure before
+ * being cancelled with a timeout error. Prevents indefinite waiting.
+ */
+export declare const DEFAULT_QUERY_PAUSE_TIMEOUT_MS = 30000;
+/**
+ * Default request timeout for tenant router (30 seconds).
+ *
+ * Maximum time to wait for a routed request to complete before
+ * returning a timeout error to the client.
+ */
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+/**
+ * Default grace period before forced shutdown (30 seconds).
+ *
+ * Allows in-flight queries to complete before termination.
+ * After this period, any remaining queries are forcibly cancelled.
+ */
+export declare const DEFAULT_GRACE_PERIOD_MS = 30000;
+/**
+ * Default interval for checking if queries have drained (100ms).
+ *
+ * Frequent checks ensure responsive shutdown when queries complete.
+ * Lower values provide faster shutdown at the cost of more CPU.
+ */
+export declare const DEFAULT_DRAIN_CHECK_INTERVAL_MS = 100;
+/**
+ * Default timeout for PGlite close operation (5 seconds).
+ *
+ * Prevents shutdown from hanging if PGlite fails to close cleanly.
+ * After this timeout, shutdown proceeds anyway.
+ */
+export declare const DEFAULT_CLOSE_TIMEOUT_MS = 5000;
+/**
+ * Default WebSocket connect timeout (5 seconds).
+ *
+ * Maximum time to wait for WebSocket handshake to complete.
+ */
+export declare const DEFAULT_WS_CONNECT_TIMEOUT_MS = 5000;
+/**
+ * Default WebSocket ping interval (30 seconds).
+ *
+ * How often to send ping frames to keep the connection alive
+ * and detect stale connections.
+ */
+export declare const DEFAULT_WS_PING_INTERVAL_MS = 30000;
+/**
+ * Default SSE connect timeout (10 seconds).
+ *
+ * Maximum time to wait for SSE connection to establish.
+ * Longer than WebSocket because SSE is often used over HTTP/1.1.
+ */
+export declare const DEFAULT_SSE_CONNECT_TIMEOUT_MS = 10000;
+/**
+ * Default SSE retry delay (3 seconds).
+ *
+ * Time to wait before attempting to reconnect after SSE connection drops.
+ */
+export declare const DEFAULT_SSE_RETRY_MS = 3000;
+/**
+ * Default SSE heartbeat interval (30 seconds).
+ *
+ * How often to send comment heartbeats to keep the connection alive.
+ */
+export declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000;
+/**
+ * Default circuit breaker reset timeout (30 seconds).
+ *
+ * Time before an open circuit transitions to half-open state.
+ * Already exported from storage.ts as DEFAULT_CIRCUIT_BREAKER_RESET_TIMEOUT_MS.
+ * Re-exported here for convenience in timeout-focused imports.
+ */
+export { DEFAULT_CIRCUIT_BREAKER_RESET_TIMEOUT_MS } from './storage';
+/**
+ * Default migration lock timeout (5 seconds).
+ *
+ * Maximum time to wait for migration advisory lock.
+ * Prevents deadlocks when multiple instances try to migrate.
+ */
+export declare const DEFAULT_MIGRATION_LOCK_TIMEOUT_MS = 5000;
+/**
+ * Default migration execution timeout (30 seconds).
+ *
+ * Maximum time for a single migration to complete.
+ * Long-running migrations should be broken into smaller steps.
+ */
+export declare const DEFAULT_MIGRATION_TIMEOUT_MS = 30000;
+/**
+ * Default rate limit window (60 seconds).
+ *
+ * Duration over which rate limit counters are tracked.
+ */
+export declare const DEFAULT_RATE_LIMIT_WINDOW_MS = 60000;
+/**
+ * Default rate limit cleanup interval (5 minutes).
+ *
+ * How often to purge expired rate limit entries.
+ */
+export declare const DEFAULT_RATE_LIMIT_CLEANUP_INTERVAL_MS = 300000;
+/**
+ * Default maximum number of event listeners.
+ *
+ * Prevents memory leaks from uncleaned listener registrations.
+ * Applies to shutdown events, memory pressure events, etc.
+ */
+export declare const DEFAULT_MAX_LISTENERS = 100;
+/**
+ * Threshold percentage for listener count warning (80%).
+ *
+ * Warns when listener count reaches this percentage of max.
+ */
+export declare const LISTENER_WARNING_THRESHOLD = 0.8;
+//# sourceMappingURL=timeouts.d.ts.map

package/dist/config/timeouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.d.ts","sourceRoot":"","sources":["../../src/config/timeouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,OAAO,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,OAAO,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,OAAO,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,uCAAuC,OAAO,CAAA;AAM3D;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,QAAQ,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAQ,CAAA;AAM/C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAM5C;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAQ,CAAA;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,QAAQ,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAExC;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QAAQ,CAAA;AAMlD;;;;;;GAMG;AACH,OAAO,EAAE,wCAAwC,EAAE,MAAM,WAAW,CAAA;AAMpE;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,OAAO,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,QAAQ,CAAA;AAMjD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,QAAQ,CAAA;AAEjD;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,SAAS,CAAA;AAM5D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,MAAM,CAAA"}

package/dist/config/timeouts.js

@@ -0,0 +1,192 @@
+/**
+ * Timeout Configuration Constants
+ *
+ * Centralized timeout values used throughout the postgres package.
+ * These constants define standard wait times for various operations
+ * including monitoring, recovery, connection, and shutdown.
+ *
+ * ## Timeout Categories
+ *
+ * - **Check Intervals**: How often to poll for state changes
+ * - **Grace Periods**: Time allowed for operations to complete
+ * - **Connection Timeouts**: Maximum wait for network operations
+ * - **Recovery Timeouts**: Time before retrying after failures
+ *
+ * @module config/timeouts
+ */
+// =============================================================================
+// Memory Pressure Monitoring Intervals
+// =============================================================================
+/**
+ * Default interval for memory pressure checks (5 seconds).
+ *
+ * How often the MemoryPressureManager samples heap usage and
+ * evaluates pressure thresholds. Lower values provide faster
+ * response but use more CPU.
+ */
+export const DEFAULT_CHECK_INTERVAL_MS = 5000;
+/**
+ * Minimum interval between GC hint triggers (5 seconds).
+ *
+ * Prevents GC thrashing by rate-limiting garbage collection hints.
+ * Allows the runtime to stabilize between collections.
+ */
+export const DEFAULT_GC_HINT_MIN_INTERVAL_MS = 5000;
+/**
+ * Default interval for memory pressure recovery hysteresis (2 seconds).
+ *
+ * Time to wait at normal pressure before considering recovery complete.
+ * Prevents oscillation when pressure hovers near thresholds.
+ */
+export const DEFAULT_RECOVERY_HYSTERESIS_MS = 2000;
+/**
+ * Default interval between recovery steps (1 second).
+ *
+ * When gradually re-enabling features after recovery, this controls
+ * how long to wait between enabling each feature.
+ */
+export const DEFAULT_RECOVERY_STEP_INTERVAL_MS = 1000;
+/**
+ * Default time at elevated pressure before alert (5 seconds).
+ *
+ * Triggers sustained pressure callback when pressure level remains
+ * elevated for this duration. Helps distinguish transient spikes
+ * from persistent memory issues.
+ */
+export const DEFAULT_SUSTAINED_PRESSURE_THRESHOLD_MS = 5000;
+// =============================================================================
+// Query Management Timeouts
+// =============================================================================
+/**
+ * Default timeout for paused queries (30 seconds).
+ *
+ * Maximum time a query can be paused due to memory pressure before
+ * being cancelled with a timeout error. Prevents indefinite waiting.
+ */
+export const DEFAULT_QUERY_PAUSE_TIMEOUT_MS = 30000;
+/**
+ * Default request timeout for tenant router (30 seconds).
+ *
+ * Maximum time to wait for a routed request to complete before
+ * returning a timeout error to the client.
+ */
+export const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+// =============================================================================
+// Shutdown Manager Timeouts
+// =============================================================================
+/**
+ * Default grace period before forced shutdown (30 seconds).
+ *
+ * Allows in-flight queries to complete before termination.
+ * After this period, any remaining queries are forcibly cancelled.
+ */
+export const DEFAULT_GRACE_PERIOD_MS = 30000;
+/**
+ * Default interval for checking if queries have drained (100ms).
+ *
+ * Frequent checks ensure responsive shutdown when queries complete.
+ * Lower values provide faster shutdown at the cost of more CPU.
+ */
+export const DEFAULT_DRAIN_CHECK_INTERVAL_MS = 100;
+/**
+ * Default timeout for PGlite close operation (5 seconds).
+ *
+ * Prevents shutdown from hanging if PGlite fails to close cleanly.
+ * After this timeout, shutdown proceeds anyway.
+ */
+export const DEFAULT_CLOSE_TIMEOUT_MS = 5000;
+// =============================================================================
+// WebSocket/SSE Transport Timeouts
+// =============================================================================
+/**
+ * Default WebSocket connect timeout (5 seconds).
+ *
+ * Maximum time to wait for WebSocket handshake to complete.
+ */
+export const DEFAULT_WS_CONNECT_TIMEOUT_MS = 5000;
+/**
+ * Default WebSocket ping interval (30 seconds).
+ *
+ * How often to send ping frames to keep the connection alive
+ * and detect stale connections.
+ */
+export const DEFAULT_WS_PING_INTERVAL_MS = 30000;
+/**
+ * Default SSE connect timeout (10 seconds).
+ *
+ * Maximum time to wait for SSE connection to establish.
+ * Longer than WebSocket because SSE is often used over HTTP/1.1.
+ */
+export const DEFAULT_SSE_CONNECT_TIMEOUT_MS = 10000;
+/**
+ * Default SSE retry delay (3 seconds).
+ *
+ * Time to wait before attempting to reconnect after SSE connection drops.
+ */
+export const DEFAULT_SSE_RETRY_MS = 3000;
+/**
+ * Default SSE heartbeat interval (30 seconds).
+ *
+ * How often to send comment heartbeats to keep the connection alive.
+ */
+export const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000;
+// =============================================================================
+// Circuit Breaker Timeouts
+// =============================================================================
+/**
+ * Default circuit breaker reset timeout (30 seconds).
+ *
+ * Time before an open circuit transitions to half-open state.
+ * Already exported from storage.ts as DEFAULT_CIRCUIT_BREAKER_RESET_TIMEOUT_MS.
+ * Re-exported here for convenience in timeout-focused imports.
+ */
+export { DEFAULT_CIRCUIT_BREAKER_RESET_TIMEOUT_MS } from './storage';
+// =============================================================================
+// Migration Timeouts
+// =============================================================================
+/**
+ * Default migration lock timeout (5 seconds).
+ *
+ * Maximum time to wait for migration advisory lock.
+ * Prevents deadlocks when multiple instances try to migrate.
+ */
+export const DEFAULT_MIGRATION_LOCK_TIMEOUT_MS = 5000;
+/**
+ * Default migration execution timeout (30 seconds).
+ *
+ * Maximum time for a single migration to complete.
+ * Long-running migrations should be broken into smaller steps.
+ */
+export const DEFAULT_MIGRATION_TIMEOUT_MS = 30000;
+// =============================================================================
+// Rate Limiting Timeouts
+// =============================================================================
+/**
+ * Default rate limit window (60 seconds).
+ *
+ * Duration over which rate limit counters are tracked.
+ */
+export const DEFAULT_RATE_LIMIT_WINDOW_MS = 60000;
+/**
+ * Default rate limit cleanup interval (5 minutes).
+ *
+ * How often to purge expired rate limit entries.
+ */
+export const DEFAULT_RATE_LIMIT_CLEANUP_INTERVAL_MS = 300000;
+// =============================================================================
+// Listener Limits (Not timeouts, but related capacity limits)
+// =============================================================================
+/**
+ * Default maximum number of event listeners.
+ *
+ * Prevents memory leaks from uncleaned listener registrations.
+ * Applies to shutdown events, memory pressure events, etc.
+ */
+export const DEFAULT_MAX_LISTENERS = 100;
+/**
+ * Threshold percentage for listener count warning (80%).
+ *
+ * Warns when listener count reaches this percentage of max.
+ */
+export const LISTENER_WARNING_THRESHOLD = 0.8;
+//# sourceMappingURL=timeouts.js.map

package/dist/config/timeouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.js","sourceRoot":"","sources":["../../src/config/timeouts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAAA;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,CAAA;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,IAAI,CAAA;AAE3D,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAA;AAE/C,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAA;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAA;AAE5C,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAA;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAA;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAA;AAElD,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;;GAMG;AACH,OAAO,EAAE,wCAAwC,EAAE,MAAM,WAAW,CAAA;AAEpE,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,CAAA;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAA;AAEjD,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAA;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,MAAM,CAAA;AAE5D,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAA"}

package/dist/extensions/config.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Extension Configuration API
+ *
+ * Provides configuration utilities for enabling and managing PostgreSQL extensions
+ * with support for presets, validation, and merging.
+ */
+/**
+ * Options for configuring a specific extension
+ */
+export interface ExtensionOptions {
+    /** Whether the extension is enabled */
+    enabled: boolean;
+    /** Whether to auto-create the extension via CREATE EXTENSION */
+    autoCreate?: boolean;
+}
+/**
+ * Extension configuration value - can be boolean or options object
+ */
+export type ExtensionValue = boolean | ExtensionOptions;
+/**
+ * Configuration for PostgreSQL extensions
+ */
+export interface PostgresExtensionsConfig {
+    extensions?: {
+        [name: string]: ExtensionValue;
+    };
+}
+/**
+ * Result of config validation
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Create an extension configuration
+ */
+export declare function createExtensionConfig(extensions?: Record<string, ExtensionValue>): PostgresExtensionsConfig;
+/**
+ * Merge two extension configurations, with the second taking precedence
+ */
+export declare function mergeExtensionConfigs(base: PostgresExtensionsConfig | undefined, override: PostgresExtensionsConfig | undefined): PostgresExtensionsConfig;
+/**
+ * Validate an extension configuration
+ */
+export declare function validateExtensionConfig(config: PostgresExtensionsConfig): ValidationResult;
+/**
+ * Extension configuration presets for common use cases
+ */
+export declare const PRESETS: {
+    /**
+     * Minimal preset - no extensions enabled
+     */
+    readonly MINIMAL: PostgresExtensionsConfig;
+    /**
+     * Vector search preset - for AI/ML embeddings
+     */
+    readonly VECTOR_SEARCH: PostgresExtensionsConfig;
+    /**
+     * Full-text search preset - for text search applications
+     */
+    readonly FULL_TEXT_SEARCH: PostgresExtensionsConfig;
+    /**
+     * Common preset - popular extensions for general use
+     */
+    readonly COMMON: PostgresExtensionsConfig;
+    /**
+     * Full preset - all commonly used extensions
+     */
+    readonly FULL: PostgresExtensionsConfig;
+};
+/**
+ * Helper to check if an extension is enabled in config
+ */
+export declare function isExtensionEnabled(config: PostgresExtensionsConfig, name: string): boolean;
+/**
+ * Helper to check if an extension should be auto-created
+ */
+export declare function shouldAutoCreate(config: PostgresExtensionsConfig, name: string): boolean;
+/**
+ * Get list of enabled extension names from config
+ */
+export declare function getEnabledExtensions(config: PostgresExtensionsConfig): string[];
+/**
+ * Get list of extension names that should be auto-created
+ */
+export declare function getAutoCreateExtensions(config: PostgresExtensionsConfig): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/extensions/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/extensions/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,gBAAgB,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE;QACX,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAA;KAC/B,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AA8CD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAC1C,wBAAwB,CAI1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,wBAAwB,GAAG,SAAS,EAC1C,QAAQ,EAAE,wBAAwB,GAAG,SAAS,GAC7C,wBAAwB,CAuB1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,wBAAwB,GAC/B,gBAAgB,CAqClB;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB;;OAEG;;IAGH;;OAEG;;IAKH;;OAEG;;IAOH;;OAEG;;IAQH;;OAEG;;CAgBK,CAAA;AAEV;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,wBAAwB,EAChC,IAAI,EAAE,MAAM,GACX,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,wBAAwB,EAChC,IAAI,EAAE,MAAM,GACX,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,EAAE,CAS/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,EAAE,CASlF"}