@objectstack/spec 0.3.2 → 0.3.3

package/dist/driver/driver.zod.d.ts.map

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

package/dist/{system → driver}/driver.zod.js

@@ -21,6 +21,16 @@ exports.DriverOptionsSchema = zod_1.z.object({
      * Whether to bypass cache and force a fresh read.
      */
     skipCache: zod_1.z.boolean().optional().describe('Bypass cache'),
+    /**
+     * Distributed Tracing Context.
+     * Used for passing OpenTelemetry span context or request IDs for observability.
+     */
+    traceContext: zod_1.z.record(zod_1.z.string()).optional().describe('OpenTelemetry context or request ID'),
+    /**
+     * Tenant Identifier.
+     * For multi-tenant databases (row-level security or schema-per-tenant).
+     */
+    tenantId: zod_1.z.string().optional().describe('Tenant Isolation identifier'),
 });
 /**
  * Driver Capabilities Schema
@@ -95,6 +105,15 @@ exports.DriverCapabilitiesSchema = zod_1.z.object({
      * If false, arrays will be stored as JSON strings or in separate tables.
      */
     arrayFields: zod_1.z.boolean().describe('Supports array field types'),
+    /**
+     * Whether the driver supports vector embeddings and similarity search.
+     * Required for RAG (Retrieval-Augmented Generation) and AI features.
+     */
+    vectorSearch: zod_1.z.boolean().default(false).describe('Supports vector embeddings and similarity search'),
+    /**
+     * Whether the driver supports geospatial queries.
+     */
+    geoSpatial: zod_1.z.boolean().default(false).describe('Supports geospatial queries'),
 });
 /**
  * Unified Database Driver Interface
@@ -137,6 +156,19 @@ exports.DriverInterfaceSchema = zod_1.z.object({
     checkHealth: zod_1.z.function()
         .returns(zod_1.z.promise(zod_1.z.boolean()))
         .describe('Health check'),
+    /**
+     * Get Connection Pool Statistics.
+     * Useful for monitoring database load.
+     */
+    getPoolStats: zod_1.z.function()
+        .returns(zod_1.z.object({
+        total: zod_1.z.number(),
+        idle: zod_1.z.number(),
+        active: zod_1.z.number(),
+        waiting: zod_1.z.number(),
+    }).optional())
+        .optional()
+        .describe('Get connection pool statistics'),
     // ============================================================================
     // Raw Execution (Escape Hatch)
     // ============================================================================
@@ -185,6 +217,19 @@ exports.DriverInterfaceSchema = zod_1.z.object({
         .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
         .returns(zod_1.z.promise(zod_1.z.array(zod_1.z.record(zod_1.z.any()))))
         .describe('Find records'),
+    /**
+     * Stream records matching the structured query.
+     * Optimized for large datasets to avoid memory overflow.
+     *
+     * @param object - The name of the object.
+     * @param query - The structured QueryAST.
+     * @param options - Driver options.
+     * @returns AsyncIterable/ReadableStream of records.
+     */
+    findStream: zod_1.z.function()
+        .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.any()) // Zod cannot easily represent AsyncIterable<T>
+        .describe('Stream records (AsyncIterable)'),
     /**
      * Find a single record by query.
      * Similar to find(), but returns only the first match or null.
@@ -226,6 +271,19 @@ exports.DriverInterfaceSchema = zod_1.z.object({
         .args(zod_1.z.string(), zod_1.z.string().or(zod_1.z.number()), zod_1.z.record(zod_1.z.any()), exports.DriverOptionsSchema.optional())
         .returns(zod_1.z.promise(zod_1.z.record(zod_1.z.any())))
         .describe('Update record'),
+    /**
+     * Upsert (Update or Insert) a record.
+     *
+     * @param object - The object name.
+     * @param data - The data to upsert.
+     * @param conflictKeys - Fields to check for conflict (uniqueness).
+     * @param options - Driver options.
+     * @returns The created or updated record.
+     */
+    upsert: zod_1.z.function()
+        .args(zod_1.z.string(), zod_1.z.record(zod_1.z.any()), zod_1.z.array(zod_1.z.string()).optional(), exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.record(zod_1.z.any())))
+        .describe('Upsert record'),
     /**
      * Delete a record by ID.
      *
@@ -283,14 +341,43 @@ exports.DriverInterfaceSchema = zod_1.z.object({
     bulkDelete: zod_1.z.function()
         .args(zod_1.z.string(), zod_1.z.array(zod_1.z.string().or(zod_1.z.number())), exports.DriverOptionsSchema.optional())
         .returns(zod_1.z.promise(zod_1.z.void())),
+    /**
+     * Update multiple records matching a query.
+     * Direct database push-down. DOES NOT trigger per-record hooks.
+     *
+     * @param object - The object name.
+     * @param query - The filtering criteria.
+     * @param data - The data to update.
+     * @returns Count of modified records.
+     */
+    updateMany: zod_1.z.function()
+        .args(zod_1.z.string(), query_zod_1.QuerySchema, zod_1.z.record(zod_1.z.any()), exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.number()))
+        .optional(),
+    /**
+     * Delete multiple records matching a query.
+     * Direct database push-down. DOES NOT trigger per-record hooks.
+     *
+     * @param object - The object name.
+     * @param query - The filtering criteria.
+     * @returns Count of deleted records.
+     */
+    deleteMany: zod_1.z.function()
+        .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.number()))
+        .optional(),
     // ============================================================================
     // Transaction Management
     // ============================================================================
     /**
      * Begin a new database transaction.
+     * @param options - Isolation level and other settings.
      * @returns A transaction handle to be passed to subsequent operations via `options.transaction`.
      */
     beginTransaction: zod_1.z.function()
+        .args(zod_1.z.object({
+        isolationLevel: zod_1.z.enum(['READ UNCOMMITTED', 'READ COMMITTED', 'REPEATABLE READ', 'SERIALIZABLE', 'SNAPSHOT']).optional()
+    }).optional())
         .returns(zod_1.z.promise(zod_1.z.any()))
         .describe('Start transaction'),
     /**
@@ -334,4 +421,16 @@ exports.DriverInterfaceSchema = zod_1.z.object({
     dropTable: zod_1.z.function()
         .args(zod_1.z.string(), exports.DriverOptionsSchema.optional())
         .returns(zod_1.z.promise(zod_1.z.void())),
+    /**
+     * Analyze query performance.
+     * Returns execution plan without executing the query (where possible).
+     *
+     * @param object - The object name.
+     * @param query - The query to explain.
+     * @returns The execution plan details.
+     */
+    explain: zod_1.z.function()
+        .args(zod_1.z.string(), query_zod_1.QuerySchema, exports.DriverOptionsSchema.optional())
+        .returns(zod_1.z.promise(zod_1.z.any()))
+        .optional(),
 });

package/dist/driver/index.d.ts

@@ -0,0 +1,5 @@
+export * from './driver.zod';
+export * from './datasource.zod';
+export * from './mongo.zod';
+export * from './postgres.zod';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/driver/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/driver/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./driver.zod"), exports);
+__exportStar(require("./datasource.zod"), exports);
+__exportStar(require("./mongo.zod"), exports);
+__exportStar(require("./postgres.zod"), exports);

package/dist/driver/mongo.zod.d.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+/**
+ * MongoDB Driver Configuration Schema
+ * Defines the connection settings specific to MongoDB.
+ */
+export declare const MongoConfigSchema: z.ZodObject<{
+    /**
+     * Connection URI.
+     * If provided, it takes precedence over host/port/database.
+     * Format: mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]
+     */
+    url: z.ZodOptional<z.ZodString>;
+    /**
+     * Database Name.
+     * Required to identify which database to use within the cluster.
+     */
+    database: z.ZodString;
+    /**
+     * Hostname or IP address.
+     * Defaults to localhost if not specified.
+     */
+    host: z.ZodDefault<z.ZodString>;
+    /**
+     * Port number.
+     * Defaults to 27017.
+     */
+    port: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Authentication Username.
+     */
+    username: z.ZodOptional<z.ZodString>;
+    /**
+     * Authentication Password.
+     */
+    password: z.ZodOptional<z.ZodString>;
+    /**
+     * Authentication Database.
+     * The database where the user credentials are stored (defaults to 'admin' or the target database).
+     */
+    authSource: z.ZodOptional<z.ZodString>;
+    /**
+     * Enable SSL/TLS.
+     */
+    ssl: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Replica Set Name.
+     * Required if connecting to a replica set.
+     */
+    replicaSet: z.ZodOptional<z.ZodString>;
+    /**
+     * Read Preference.
+     * Controls which members of the replica set usually receive read operations.
+     */
+    readPreference: z.ZodDefault<z.ZodEnum<["primary", "primaryPreferred", "secondary", "secondaryPreferred", "nearest"]>>;
+    /**
+     * Connection Pool Size.
+     * The maximum number of connections in the connection pool.
+     */
+    maxPoolSize: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Min Connection Pool Size.
+     * The minimum number of connections in the connection pool.
+     */
+    minPoolSize: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Connect Timeout (ms).
+     * How long to wait for a connection to be established before timing out.
+     */
+    connectTimeoutMS: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Socket Timeout (ms).
+     * How long a socket can remain idle before being closed.
+     */
+    socketTimeoutMS: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    database: string;
+    host: string;
+    port: number;
+    ssl: boolean;
+    readPreference: "primary" | "primaryPreferred" | "secondary" | "secondaryPreferred" | "nearest";
+    url?: string | undefined;
+    password?: string | undefined;
+    username?: string | undefined;
+    authSource?: string | undefined;
+    replicaSet?: string | undefined;
+    maxPoolSize?: number | undefined;
+    minPoolSize?: number | undefined;
+    connectTimeoutMS?: number | undefined;
+    socketTimeoutMS?: number | undefined;
+}, {
+    database: string;
+    url?: string | undefined;
+    password?: string | undefined;
+    host?: string | undefined;
+    port?: number | undefined;
+    username?: string | undefined;
+    authSource?: string | undefined;
+    ssl?: boolean | undefined;
+    replicaSet?: string | undefined;
+    readPreference?: "primary" | "primaryPreferred" | "secondary" | "secondaryPreferred" | "nearest" | undefined;
+    maxPoolSize?: number | undefined;
+    minPoolSize?: number | undefined;
+    connectTimeoutMS?: number | undefined;
+    socketTimeoutMS?: number | undefined;
+}>;
+export type MongoConfig = z.infer<typeof MongoConfigSchema>;
+//# sourceMappingURL=mongo.zod.d.ts.map

package/dist/driver/mongo.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.zod.d.ts","sourceRoot":"","sources":["../../src/driver/mongo.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;;OAIG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAKH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/driver/mongo.zod.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoConfigSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * MongoDB Driver Configuration Schema
+ * Defines the connection settings specific to MongoDB.
+ */
+exports.MongoConfigSchema = zod_1.z.object({
+    /**
+     * Connection URI.
+     * If provided, it takes precedence over host/port/database.
+     * Format: mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]
+     */
+    url: zod_1.z.string().optional().describe('Connection URI'),
+    /**
+     * Database Name.
+     * Required to identify which database to use within the cluster.
+     */
+    database: zod_1.z.string().describe('Database Name'),
+    /**
+     * Hostname or IP address.
+     * Defaults to localhost if not specified.
+     */
+    host: zod_1.z.string().default('127.0.0.1').describe('Host address'),
+    /**
+     * Port number.
+     * Defaults to 27017.
+     */
+    port: zod_1.z.number().default(27017).describe('Port number'),
+    /**
+     * Authentication Username.
+     */
+    username: zod_1.z.string().optional().describe('Auth User'),
+    /**
+     * Authentication Password.
+     */
+    password: zod_1.z.string().optional().describe('Auth Password'),
+    /**
+     * Authentication Database.
+     * The database where the user credentials are stored (defaults to 'admin' or the target database).
+     */
+    authSource: zod_1.z.string().optional().describe('Authentication Database'),
+    /**
+     * Enable SSL/TLS.
+     */
+    ssl: zod_1.z.boolean().default(false).describe('Enable SSL'),
+    /**
+     * Replica Set Name.
+     * Required if connecting to a replica set.
+     */
+    replicaSet: zod_1.z.string().optional().describe('Replica Set Name'),
+    /**
+     * Read Preference.
+     * Controls which members of the replica set usually receive read operations.
+     */
+    readPreference: zod_1.z.enum(['primary', 'primaryPreferred', 'secondary', 'secondaryPreferred', 'nearest'])
+        .default('primary')
+        .describe('Read Preference'),
+    /**
+     * Connection Pool Size.
+     * The maximum number of connections in the connection pool.
+     */
+    maxPoolSize: zod_1.z.number().optional().describe('Max Connection Pool Size'),
+    /**
+     * Min Connection Pool Size.
+     * The minimum number of connections in the connection pool.
+     */
+    minPoolSize: zod_1.z.number().optional().describe('Min Connection Pool Size'),
+    /**
+     * Connect Timeout (ms).
+     * How long to wait for a connection to be established before timing out.
+     */
+    connectTimeoutMS: zod_1.z.number().optional().describe('Connection Timeout (ms)'),
+    /**
+     * Socket Timeout (ms).
+     * How long a socket can remain idle before being closed.
+     */
+    socketTimeoutMS: zod_1.z.number().optional().describe('Socket Timeout (ms)'),
+});

package/dist/driver/postgres.zod.d.ts

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+/**
+ * PostgreSQL Driver Configuration Schema
+ * Defines the connection settings specific to PostgreSQL.
+ */
+export declare const PostgresConfigSchema: z.ZodObject<{
+    /**
+     * Connection URI.
+     * If provided, it takes precedence over host/port/database.
+     * Format: postgresql://[user[:password]@][netloc][:port][/dbname][?param1=value1&...]
+     */
+    url: z.ZodOptional<z.ZodString>;
+    /**
+     * Database Name.
+     */
+    database: z.ZodString;
+    /**
+     * Hostname or IP address.
+     * Defaults to localhost.
+     */
+    host: z.ZodDefault<z.ZodString>;
+    /**
+     * Port number.
+     * Defaults to 5432.
+     */
+    port: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Authentication Username.
+     */
+    username: z.ZodOptional<z.ZodString>;
+    /**
+     * Authentication Password.
+     */
+    password: z.ZodOptional<z.ZodString>;
+    /**
+     * Default Schema.
+     * The schema to use for tables that do not specify a schema.
+     * Defaults to 'public'.
+     */
+    schema: z.ZodDefault<z.ZodString>;
+    /**
+     * Enable SSL/TLS.
+     * Can be a boolean or an object with specific SSL configuration (ca, cert, key, rejectUnauthorized).
+     */
+    ssl: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+        rejectUnauthorized: z.ZodOptional<z.ZodBoolean>;
+        ca: z.ZodOptional<z.ZodString>;
+        key: z.ZodOptional<z.ZodString>;
+        cert: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        rejectUnauthorized?: boolean | undefined;
+        ca?: string | undefined;
+        key?: string | undefined;
+        cert?: string | undefined;
+    }, {
+        rejectUnauthorized?: boolean | undefined;
+        ca?: string | undefined;
+        key?: string | undefined;
+        cert?: string | undefined;
+    }>]>>;
+    /**
+     * Application Name.
+     * Sets the application_name configuration parameter.
+     */
+    applicationName: z.ZodOptional<z.ZodString>;
+    /**
+     * Connection Pool: Max Clients.
+     * Maximum number of clients the pool should contain.
+     */
+    max: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Connection Pool: Min Clients.
+     * Minimum number of clients to keep in the pool.
+     */
+    min: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Idle Timeout (ms).
+     * The number of milliseconds a client must sit idle in the pool and not be checked out
+     * before it is disconnected from the backend and discarded.
+     */
+    idleTimeoutMillis: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Connection Timeout (ms).
+     * The number of milliseconds to wait before timing out when connecting a new client.
+     */
+    connectionTimeoutMillis: z.ZodOptional<z.ZodNumber>;
+    /**
+    * Statement Timeout (ms).
+    * Abort any statement that takes more than the specified number of milliseconds.
+    */
+    statementTimeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    min: number;
+    max: number;
+    database: string;
+    schema: string;
+    host: string;
+    port: number;
+    url?: string | undefined;
+    password?: string | undefined;
+    idleTimeoutMillis?: number | undefined;
+    connectionTimeoutMillis?: number | undefined;
+    username?: string | undefined;
+    ssl?: boolean | {
+        rejectUnauthorized?: boolean | undefined;
+        ca?: string | undefined;
+        key?: string | undefined;
+        cert?: string | undefined;
+    } | undefined;
+    applicationName?: string | undefined;
+    statementTimeout?: number | undefined;
+}, {
+    database: string;
+    min?: number | undefined;
+    max?: number | undefined;
+    url?: string | undefined;
+    password?: string | undefined;
+    schema?: string | undefined;
+    idleTimeoutMillis?: number | undefined;
+    connectionTimeoutMillis?: number | undefined;
+    host?: string | undefined;
+    port?: number | undefined;
+    username?: string | undefined;
+    ssl?: boolean | {
+        rejectUnauthorized?: boolean | undefined;
+        ca?: string | undefined;
+        key?: string | undefined;
+        cert?: string | undefined;
+    } | undefined;
+    applicationName?: string | undefined;
+    statementTimeout?: number | undefined;
+}>;
+export type PostgresConfig = z.infer<typeof PostgresConfigSchema>;
+//# sourceMappingURL=postgres.zod.d.ts.map

package/dist/driver/postgres.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.zod.d.ts","sourceRoot":"","sources":["../../src/driver/postgres.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;OAIG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;IAWH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;IAGF;;;MAGE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/driver/postgres.zod.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresConfigSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * PostgreSQL Driver Configuration Schema
+ * Defines the connection settings specific to PostgreSQL.
+ */
+exports.PostgresConfigSchema = zod_1.z.object({
+    /**
+     * Connection URI.
+     * If provided, it takes precedence over host/port/database.
+     * Format: postgresql://[user[:password]@][netloc][:port][/dbname][?param1=value1&...]
+     */
+    url: zod_1.z.string().optional().describe('Connection URI'),
+    /**
+     * Database Name.
+     */
+    database: zod_1.z.string().describe('Database Name'),
+    /**
+     * Hostname or IP address.
+     * Defaults to localhost.
+     */
+    host: zod_1.z.string().default('localhost').describe('Host address'),
+    /**
+     * Port number.
+     * Defaults to 5432.
+     */
+    port: zod_1.z.number().default(5432).describe('Port number'),
+    /**
+     * Authentication Username.
+     */
+    username: zod_1.z.string().optional().describe('Auth User'),
+    /**
+     * Authentication Password.
+     */
+    password: zod_1.z.string().optional().describe('Auth Password'),
+    /**
+     * Default Schema.
+     * The schema to use for tables that do not specify a schema.
+     * Defaults to 'public'.
+     */
+    schema: zod_1.z.string().default('public').describe('Default Schema'),
+    /**
+     * Enable SSL/TLS.
+     * Can be a boolean or an object with specific SSL configuration (ca, cert, key, rejectUnauthorized).
+     */
+    ssl: zod_1.z.union([
+        zod_1.z.boolean(),
+        zod_1.z.object({
+            rejectUnauthorized: zod_1.z.boolean().optional(),
+            ca: zod_1.z.string().optional(),
+            key: zod_1.z.string().optional(),
+            cert: zod_1.z.string().optional(),
+        })
+    ]).optional().describe('Enable SSL'),
+    /**
+     * Application Name.
+     * Sets the application_name configuration parameter.
+     */
+    applicationName: zod_1.z.string().optional().describe('Application Name'),
+    /**
+     * Connection Pool: Max Clients.
+     * Maximum number of clients the pool should contain.
+     */
+    max: zod_1.z.number().default(10).describe('Max Pool Size'),
+    /**
+     * Connection Pool: Min Clients.
+     * Minimum number of clients to keep in the pool.
+     */
+    min: zod_1.z.number().default(0).describe('Min Pool Size'),
+    /**
+     * Idle Timeout (ms).
+     * The number of milliseconds a client must sit idle in the pool and not be checked out
+     * before it is disconnected from the backend and discarded.
+     */
+    idleTimeoutMillis: zod_1.z.number().optional().describe('Idle Timeout (ms)'),
+    /**
+     * Connection Timeout (ms).
+     * The number of milliseconds to wait before timing out when connecting a new client.
+     */
+    connectionTimeoutMillis: zod_1.z.number().optional().describe('Connection Timeout (ms)'),
+    /**
+    * Statement Timeout (ms).
+    * Abort any statement that takes more than the specified number of milliseconds.
+    */
+    statementTimeout: zod_1.z.number().optional().describe('Statement Timeout (ms)'),
+});