@appixar/xpg 1.0.0

package/dist/diffEngine.js

@@ -0,0 +1,233 @@
+// ─────────────────────────────────────────────
+// x-postgres — Diff engine
+// ─────────────────────────────────────────────
+// Compares live DB state vs YAML schema and generates
+// minimal ALTER statements. Port of PHP updateTable().
+import { POSTGRES_TYPE_DICTIONARY } from './typeDictionary.js';
+import { buildDefaultClause, normalizeDbDefaultForCompare } from './defaultNormalizer.js';
+import * as log from './logger.js';
+/**
+ * Generate ALTER statements to bring a live table in sync with YAML schema.
+ */
+export function generateUpdateTable(ctx) {
+    const { table, schema, currentColumns, existingIndexes, existingUniques, mute } = ctx;
+    const queries = [];
+    if (!mute)
+        log.header(`∴ ${table}`, 'blue');
+    const { fields, individualIndexes, compositeIndexes, compositeUniqueIndexes } = schema;
+    // ─── Existing index/constraint names ───
+    const existingIndexNames = existingIndexes.map(i => i.indexname);
+    const existingUniqueNames = existingUniques.map(u => u.conname);
+    // ─── Expected index/constraint names ───
+    const expectedIndexes = [];
+    const expectedUniqueNames = [];
+    for (const field of individualIndexes) {
+        expectedIndexes.push(`${table}_${field}_idx`);
+    }
+    for (const indexName of Object.keys(compositeIndexes)) {
+        expectedIndexes.push(`${table}_${indexName}_idx`);
+    }
+    for (const indexName of Object.keys(compositeUniqueIndexes)) {
+        expectedIndexes.push(`${table}_${indexName}_unique_idx`);
+    }
+    for (const [k, v] of Object.entries(fields)) {
+        if (v.key === 'UNI') {
+            expectedUniqueNames.push(`${table}_${k}_unique`);
+            expectedIndexes.push(`${table}_${k}_unique`);
+        }
+        if (v.key === 'PRI') {
+            expectedIndexes.push(`${table}_pkey`);
+        }
+    }
+    // ─── 1. DROP columns no longer in YAML ───
+    for (const column of Object.keys(currentColumns)) {
+        if (!fields[column]) {
+            const sql = `ALTER TABLE "${table}" DROP COLUMN "${column}";`;
+            queries.push({ sql, mini: `DROP COLUMN "${table}"."${column}" ...`, color: 'yellow' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'yellow');
+        }
+    }
+    // ─── 2. DROP orphaned UNIQUE constraints ───
+    for (const uniqueName of existingUniqueNames) {
+        if (!expectedUniqueNames.includes(uniqueName)) {
+            const sql = `ALTER TABLE "${table}" DROP CONSTRAINT "${uniqueName}";`;
+            queries.push({ sql, mini: `DROP CONSTRAINT "${uniqueName}" ...`, color: 'yellow' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'yellow');
+        }
+    }
+    // ─── 3. DROP orphaned indexes ───
+    for (const indexName of existingIndexNames) {
+        if (!expectedIndexes.includes(indexName)) {
+            const sql = `DROP INDEX IF EXISTS "${indexName}";`;
+            queries.push({ sql, mini: `DROP INDEX "${indexName}" ...`, color: 'yellow' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'yellow');
+        }
+    }
+    // ─── 4. ADD new columns ───
+    for (const [k, v] of Object.entries(fields)) {
+        if (!currentColumns[k]) {
+            const typeUpper = v.type;
+            let defaultClause = '';
+            if (!typeUpper.includes('SERIAL')) {
+                defaultClause = buildDefaultClause(v.defaultValue, typeUpper);
+            }
+            const sql = `ALTER TABLE "${table}" ADD COLUMN "${k}" ${typeUpper} ${v.nullable} ${defaultClause} ${v.extra};`.replace(/\s+/g, ' ').trim();
+            queries.push({ sql, mini: `ADD COLUMN "${table}"."${k}" ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+        }
+    }
+    // ─── 5. ALTER column TYPE if changed ───
+    for (const [k, v] of Object.entries(fields)) {
+        if (!currentColumns[k])
+            continue;
+        const typeMatch = v.type.match(/^(\w+)(?:\((\d+(?:,\d+)?)\))?$/);
+        const configBaseType = typeMatch ? typeMatch[1] : v.type.split('(')[0];
+        const configLength = typeMatch && typeMatch[2] ? typeMatch[2] : null;
+        const mappedConfigType = POSTGRES_TYPE_DICTIONARY[configBaseType] ?? configBaseType.toLowerCase();
+        const dbType = currentColumns[k].data_type.toLowerCase();
+        const dbLength = currentColumns[k].character_maximum_length;
+        if (mappedConfigType !== dbType) {
+            const sql = `ALTER TABLE "${table}" ALTER COLUMN "${k}" TYPE ${v.type};`;
+            queries.push({ sql, mini: `ALTER TYPE "${table}"."${k}" → ${v.type} ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+        }
+        else if (configLength !== null) {
+            // For numeric/decimal, compare precision+scale from numeric_precision/numeric_scale
+            const isNumericType = ['numeric', 'decimal'].includes(dbType) || ['NUMERIC', 'DECIMAL'].includes(configBaseType);
+            if (isNumericType) {
+                const dbPrecision = currentColumns[k].numeric_precision;
+                const dbScale = currentColumns[k].numeric_scale;
+                const [cfgPrecision, cfgScale] = configLength.split(',');
+                const precisionMismatch = dbPrecision !== null && String(dbPrecision) !== cfgPrecision;
+                const scaleMismatch = cfgScale && dbScale !== null && String(dbScale) !== cfgScale;
+                if (precisionMismatch || scaleMismatch) {
+                    const sql = `ALTER TABLE "${table}" ALTER COLUMN "${k}" TYPE ${v.type};`;
+                    queries.push({ sql, mini: `ALTER TYPE "${table}"."${k}" → ${v.type} ...`, color: 'cyan' });
+                    if (!mute)
+                        log.say(`→ ${sql}`, 'cyan');
+                }
+            }
+            else if (dbLength !== null && String(dbLength) !== configLength.split(',')[0]) {
+                const sql = `ALTER TABLE "${table}" ALTER COLUMN "${k}" TYPE ${v.type};`;
+                queries.push({ sql, mini: `ALTER TYPE "${table}"."${k}" → ${v.type} ...`, color: 'cyan' });
+                if (!mute)
+                    log.say(`→ ${sql}`, 'cyan');
+            }
+        }
+    }
+    // ─── 6. SET/DROP DEFAULT ───
+    for (const [k, v] of Object.entries(fields)) {
+        if (!currentColumns[k])
+            continue;
+        const typeUpper = v.type;
+        const dbDefaultRaw = currentColumns[k].column_default ?? '';
+        // Skip SERIAL defaults (auto nextval)
+        if (typeUpper.includes('SERIAL'))
+            continue;
+        // Skip PRI fields that have nextval (legacy serial)
+        if (v.key === 'PRI' && dbDefaultRaw.toLowerCase().includes('nextval('))
+            continue;
+        const configDefaultClause = buildDefaultClause(v.defaultValue, typeUpper);
+        let configDefaultSql = '';
+        if (configDefaultClause) {
+            configDefaultSql = configDefaultClause.substring('DEFAULT '.length).trim();
+        }
+        const dbDefaultNorm = normalizeDbDefaultForCompare(dbDefaultRaw);
+        const cfgDefaultNorm = normalizeDbDefaultForCompare(configDefaultSql);
+        // YAML has no default but DB does → DROP
+        if (cfgDefaultNorm === '' && dbDefaultNorm !== '') {
+            const sql = `ALTER TABLE "${table}" ALTER COLUMN "${k}" DROP DEFAULT;`;
+            queries.push({ sql, mini: `DROP DEFAULT "${table}"."${k}" ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+            continue;
+        }
+        // YAML has default but differs from DB → SET
+        if (cfgDefaultNorm !== '' && dbDefaultNorm !== cfgDefaultNorm) {
+            const sql = `ALTER TABLE "${table}" ALTER COLUMN "${k}" SET DEFAULT ${configDefaultSql};`;
+            queries.push({ sql, mini: `SET DEFAULT "${table}"."${k}" ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+        }
+    }
+    // ─── 6b. ALTER NULL/NOT NULL if changed ───
+    for (const [k, v] of Object.entries(fields)) {
+        if (!currentColumns[k])
+            continue;
+        // Skip SERIAL (always NOT NULL implicitly)
+        if (v.type.includes('SERIAL'))
+            continue;
+        if (v.nullable === '')
+            continue; // no constraint specified (e.g. id)
+        const dbNullable = currentColumns[k].is_nullable; // 'YES' or 'NO'
+        const yamlWantsNotNull = v.nullable === 'NOT NULL';
+        const dbIsNotNull = dbNullable === 'NO';
+        if (yamlWantsNotNull && !dbIsNotNull) {
+            const sql = `ALTER TABLE "${table}" ALTER COLUMN "${k}" SET NOT NULL;`;
+            queries.push({ sql, mini: `SET NOT NULL "${table}"."${k}" ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+        }
+        else if (!yamlWantsNotNull && dbIsNotNull) {
+            const sql = `ALTER TABLE "${table}" ALTER COLUMN "${k}" DROP NOT NULL;`;
+            queries.push({ sql, mini: `DROP NOT NULL "${table}"."${k}" ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+        }
+    }
+    // ─── 7. CREATE missing individual indexes ───
+    for (const field of individualIndexes) {
+        const indexName = `${table}_${field}_idx`;
+        if (!existingIndexNames.includes(indexName)) {
+            const sql = `CREATE INDEX CONCURRENTLY "${indexName}" ON "${table}" ("${field}");`;
+            queries.push({ sql, mini: `ADD INDEX "${indexName}" ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+        }
+    }
+    // ─── 8. CREATE missing composite indexes ───
+    for (const [indexName, columns] of Object.entries(compositeIndexes)) {
+        const fullName = `${table}_${indexName}_idx`;
+        if (!existingIndexNames.includes(fullName)) {
+            const colsStr = columns.map(c => `"${c}"`).join(', ');
+            const sql = `CREATE INDEX CONCURRENTLY "${fullName}" ON "${table}" (${colsStr});`;
+            queries.push({ sql, mini: `ADD INDEX "${fullName}" ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+        }
+    }
+    // ─── 9. CREATE missing composite unique indexes ───
+    for (const [indexName, columns] of Object.entries(compositeUniqueIndexes)) {
+        const fullName = `${table}_${indexName}_unique_idx`;
+        if (!existingIndexNames.includes(fullName)) {
+            const colsStr = columns.map(c => `"${c}"`).join(', ');
+            const sql = `CREATE UNIQUE INDEX CONCURRENTLY "${fullName}" ON "${table}" (${colsStr});`;
+            queries.push({ sql, mini: `ADD UNIQUE INDEX "${fullName}" ...`, color: 'cyan' });
+            if (!mute)
+                log.say(`→ ${sql}`, 'cyan');
+        }
+    }
+    // ─── 10. CREATE missing UNIQUE constraints ───
+    for (const [k, v] of Object.entries(fields)) {
+        if (v.key === 'UNI') {
+            const uniqueName = `${table}_${k}_unique`;
+            if (!existingUniqueNames.includes(uniqueName)) {
+                const sql = `ALTER TABLE "${table}" ADD CONSTRAINT "${uniqueName}" UNIQUE ("${k}");`;
+                queries.push({ sql, mini: `ADD UNIQUE "${uniqueName}" ...`, color: 'cyan' });
+                if (!mute)
+                    log.say(`→ ${sql}`, 'cyan');
+            }
+        }
+    }
+    // ─── Status ───
+    if (queries.length === 0 && !mute) {
+        log.say('✓ Table is up to date');
+    }
+    return queries;
+}
+//# sourceMappingURL=diffEngine.js.map

package/dist/diffEngine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { PgService } from './pgService.js';
+export { up, up as migrate, type BuilderOptions, type MigrationResult } from './builder.js';
+export { parseSchema } from './schemaParser.js';
+export { loadConfig } from './configLoader.js';
+export { generateCreateTable, generateDropTable, generateCreateDatabase } from './sqlGenerator.js';
+export { generateUpdateTable } from './diffEngine.js';
+export { normalizeDefaultSql, buildDefaultClause, normalizeDbDefaultForCompare } from './defaultNormalizer.js';
+export { POSTGRES_TYPE_DICTIONARY } from './typeDictionary.js';
+export * as logger from './logger.js';
+export type { FieldDefinition, ParsedSchema, DbNodeConfig, CustomFieldDef, PostgresConfig, DbColumnInfo, QueuedQuery, TenantKeysConfig, LogColor, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC/G,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAGtC,YAAY,EACR,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,QAAQ,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// ─────────────────────────────────────────────
+// x-postgres — Public API exports
+// ─────────────────────────────────────────────
+// Use these exports when importing x-postgres as
+// a library in Next.js or other Node.js projects.
+export { PgService } from './pgService.js';
+export { up, up as migrate } from './builder.js';
+export { parseSchema } from './schemaParser.js';
+export { loadConfig } from './configLoader.js';
+export { generateCreateTable, generateDropTable, generateCreateDatabase } from './sqlGenerator.js';
+export { generateUpdateTable } from './diffEngine.js';
+export { normalizeDefaultSql, buildDefaultClause, normalizeDbDefaultForCompare } from './defaultNormalizer.js';
+export { POSTGRES_TYPE_DICTIONARY } from './typeDictionary.js';
+export * as logger from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,kCAAkC;AAClC,gDAAgD;AAChD,iDAAiD;AACjD,kDAAkD;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,OAAO,EAA6C,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC/G,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,22 @@
+import type { LogColor } from './types.js';
+/**
+ * Print a section header with a separator line.
+ */
+export declare function header(text: string, color?: LogColor): void;
+/**
+ * Print a message, optionally colored.
+ */
+export declare function say(text: string, color?: LogColor): void;
+/**
+ * Print a success message (green).
+ */
+export declare function success(text: string): void;
+/**
+ * Print a warning message (yellow).
+ */
+export declare function warn(text: string): void;
+/**
+ * Print an error message (red).
+ */
+export declare function error(text: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqB3C;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,QAAkB,GAAG,IAAI,CAMpE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAMxD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExC"}

package/dist/logger.js

@@ -0,0 +1,63 @@
+// ─────────────────────────────────────────────
+// x-postgres — Logger
+// ─────────────────────────────────────────────
+// Terminal output utilities with color support.
+// Respects NO_COLOR env and --no-color flag.
+import chalk from 'chalk';
+/**
+ * Check if color output is disabled.
+ * Respects NO_COLOR standard (https://no-color.org/) and --no-color CLI flag.
+ */
+function isColorDisabled() {
+    return 'NO_COLOR' in process.env || process.argv.includes('--no-color');
+}
+const colorFns = {
+    green: (s) => isColorDisabled() ? s : chalk.green(s),
+    yellow: (s) => isColorDisabled() ? s : chalk.yellow(s),
+    cyan: (s) => isColorDisabled() ? s : chalk.cyan(s),
+    gray: (s) => isColorDisabled() ? s : chalk.gray(s),
+    red: (s) => isColorDisabled() ? s : chalk.red(s),
+    magenta: (s) => isColorDisabled() ? s : chalk.magenta(s),
+    blue: (s) => isColorDisabled() ? s : chalk.blue(s),
+    white: (s) => isColorDisabled() ? s : chalk.white(s),
+};
+/**
+ * Print a section header with a separator line.
+ */
+export function header(text, color = 'green') {
+    const line = '━'.repeat(50);
+    const colorize = colorFns[color] ?? colorFns.green;
+    console.log(colorize(line));
+    console.log(colorize(text));
+    console.log(colorize(line));
+}
+/**
+ * Print a message, optionally colored.
+ */
+export function say(text, color) {
+    if (color && colorFns[color]) {
+        console.log(colorFns[color](text));
+    }
+    else {
+        console.log(text);
+    }
+}
+/**
+ * Print a success message (green).
+ */
+export function success(text) {
+    say(text, 'green');
+}
+/**
+ * Print a warning message (yellow).
+ */
+export function warn(text) {
+    say(text, 'yellow');
+}
+/**
+ * Print an error message (red).
+ */
+export function error(text) {
+    say(text, 'red');
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/pgService.d.ts

@@ -0,0 +1,42 @@
+import pg from 'pg';
+import type { DbNodeConfig } from './types.js';
+interface PgServiceOptions {
+    /** Cluster name (key in POSTGRES.DB config) */
+    cluster?: string;
+    /** Force primary (write) node */
+    primary?: boolean;
+}
+export declare class PgService {
+    private clusterName;
+    private writeNode;
+    private readNodes;
+    private forcePrimary;
+    error: string | null;
+    constructor(clusterConf: DbNodeConfig | DbNodeConfig[], clusterName: string, options?: PgServiceOptions);
+    private getWritePool;
+    private getReadPool;
+    /**
+     * Create a barebone admin connection (without database name).
+     * Used for CREATE DATABASE operations.
+     */
+    getAdminPool(): pg.Pool;
+    /**
+     * Execute a SQL query with optional named parameters.
+     * Automatically routes to read or write pool.
+     */
+    query<T extends Record<string, unknown> = Record<string, unknown>>(sql: string, params?: Record<string, unknown>): Promise<T[]>;
+    /**
+     * Insert a row into a table. Returns the last insert id (if available).
+     */
+    insert(table: string, data: Record<string, unknown>): Promise<string | null>;
+    /**
+     * Update rows in a table. Returns the number of affected rows.
+     */
+    update(table: string, data: Record<string, unknown>, condition: Record<string, unknown> | string): Promise<number>;
+    /**
+     * Close all connection pools.
+     */
+    static closeAll(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=pgService.d.ts.map

package/dist/pgService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgService.d.ts","sourceRoot":"","sources":["../src/pgService.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,UAAU,gBAAgB;IACtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAuED,qBAAa,SAAS;IAClB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,YAAY,CAAU;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAG/B,WAAW,EAAE,YAAY,GAAG,YAAY,EAAE,EAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB;IASlC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAOnB;;;OAGG;IACH,YAAY,IAAI,EAAE,CAAC,IAAI;IAuBvB;;;OAGG;IACG,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,CAAC,EAAE,CAAC;IA+Bf;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsBlF;;OAEG;IACG,MAAM,CACR,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAC5C,OAAO,CAAC,MAAM,CAAC;IAuClB;;OAEG;WACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOzC"}

package/dist/pgService.js

@@ -0,0 +1,219 @@
+// ─────────────────────────────────────────────
+// x-postgres — PgService
+// ─────────────────────────────────────────────
+// PostgreSQL connection & query service.
+// Port of PHP PgService with read/write splitting,
+// multi-cluster, and connection pooling via pg.Pool.
+import pg from 'pg';
+const { Pool } = pg;
+// Pool registry — keyed by connection string to avoid duplicates
+// while still being manageable per PgService instance.
+const poolRegistry = new Map();
+/**
+ * Resolve the read and write node configs from a cluster config entry.
+ */
+function resolveCluster(clusterConf) {
+    // Single-node cluster
+    if (!Array.isArray(clusterConf)) {
+        return { writeNode: clusterConf, readNodes: [clusterConf] };
+    }
+    let writeNode = null;
+    const readNodes = [];
+    for (const node of clusterConf) {
+        if (node.TYPE === 'write') {
+            writeNode = node;
+        }
+        else if (node.TYPE === 'read') {
+            // Support multiple hosts per read node
+            const hosts = Array.isArray(node.HOST) ? node.HOST : [node.HOST];
+            for (const host of hosts) {
+                readNodes.push({ ...node, HOST: host });
+            }
+        }
+    }
+    if (!writeNode)
+        throw new Error('No write node found in cluster');
+    if (readNodes.length === 0)
+        readNodes.push(writeNode);
+    return { writeNode, readNodes };
+}
+/**
+ * Get or create a connection pool for a specific node.
+ */
+function getPool(node, key) {
+    if (poolRegistry.has(key))
+        return poolRegistry.get(key);
+    const host = Array.isArray(node.HOST) ? node.HOST[0] : node.HOST;
+    const pool = new Pool({
+        host,
+        port: typeof node.PORT === 'string' ? parseInt(node.PORT, 10) : node.PORT,
+        database: node.NAME,
+        user: node.USER,
+        password: node.PASS,
+        max: 10,
+        idleTimeoutMillis: 30000,
+    });
+    pool.on('error', (err) => {
+        console.error(`[x-postgres] Pool error (${key}):`, err.message);
+    });
+    poolRegistry.set(key, pool);
+    return pool;
+}
+const READ_COMMANDS = ['SELECT', 'SHOW', 'EXPLAIN', 'WITH'];
+function isReadOnly(sql) {
+    const first = sql.trim().split(/\s+/)[0].toUpperCase();
+    return READ_COMMANDS.includes(first);
+}
+export class PgService {
+    constructor(clusterConf, clusterName, options = {}) {
+        this.error = null;
+        this.clusterName = clusterName;
+        this.forcePrimary = options.primary ?? false;
+        const { writeNode, readNodes } = resolveCluster(clusterConf);
+        this.writeNode = writeNode;
+        this.readNodes = readNodes;
+    }
+    getWritePool() {
+        return getPool(this.writeNode, `${this.clusterName}:write`);
+    }
+    getReadPool() {
+        if (this.forcePrimary)
+            return this.getWritePool();
+        // Random read replica selection
+        const idx = Math.floor(Math.random() * this.readNodes.length);
+        return getPool(this.readNodes[idx], `${this.clusterName}:read:${idx}`);
+    }
+    /**
+     * Create a barebone admin connection (without database name).
+     * Used for CREATE DATABASE operations.
+     */
+    getAdminPool() {
+        const node = this.writeNode;
+        const key = `${this.clusterName}:admin`;
+        if (poolRegistry.has(key))
+            return poolRegistry.get(key);
+        const host = Array.isArray(node.HOST) ? node.HOST[0] : node.HOST;
+        const pool = new Pool({
+            host,
+            port: typeof node.PORT === 'string' ? parseInt(node.PORT, 10) : node.PORT,
+            database: 'postgres', // connect to default db for admin
+            user: node.USER,
+            password: node.PASS,
+            max: 2,
+        });
+        pool.on('error', (err) => {
+            console.error(`[x-postgres] Admin pool error:`, err.message);
+        });
+        poolRegistry.set(key, pool);
+        return pool;
+    }
+    /**
+     * Execute a SQL query with optional named parameters.
+     * Automatically routes to read or write pool.
+     */
+    async query(sql, params) {
+        const pool = isReadOnly(sql) && !this.forcePrimary
+            ? this.getReadPool()
+            : this.getWritePool();
+        try {
+            // Convert named params :key to $N positional params
+            let pgSql = sql;
+            const values = [];
+            if (params && Object.keys(params).length > 0) {
+                let paramIndex = 0;
+                // Use negative lookbehind to avoid matching ::typecast syntax
+                pgSql = sql.replace(/(?<!:):([a-zA-Z_]\w*)/g, (_match, key) => {
+                    if (params[key] !== undefined) {
+                        paramIndex++;
+                        values.push(params[key]);
+                        return `$${paramIndex}`;
+                    }
+                    return _match;
+                });
+            }
+            const result = await pool.query(pgSql, values.length > 0 ? values : undefined);
+            return result.rows;
+        }
+        catch (err) {
+            this.error = err.message;
+            throw err;
+        }
+    }
+    /**
+     * Insert a row into a table. Returns the last insert id (if available).
+     */
+    async insert(table, data) {
+        const pool = this.getWritePool();
+        const keys = Object.keys(data);
+        const cols = keys.map(k => `"${k}"`).join(', ');
+        const placeholders = keys.map((_, i) => `$${i + 1}`).join(', ');
+        const values = keys.map(k => {
+            const v = data[k];
+            if (v === 'NULL' || v === 'null' || v === '')
+                return null;
+            return v;
+        });
+        const sql = `INSERT INTO "${table}" (${cols}) VALUES (${placeholders}) RETURNING *`;
+        try {
+            const result = await pool.query(sql, values);
+            return result.rows[0]?.id ?? null;
+        }
+        catch (err) {
+            this.error = err.message;
+            throw err;
+        }
+    }
+    /**
+     * Update rows in a table. Returns the number of affected rows.
+     */
+    async update(table, data, condition) {
+        const pool = this.getWritePool();
+        const vals = [];
+        let idx = 0;
+        // SET clause
+        const setClauses = Object.entries(data).map(([k, v]) => {
+            if (v === 'NULL' || v === 'null' || v === '')
+                return `"${k}" = NULL`;
+            idx++;
+            vals.push(v);
+            return `"${k}" = $${idx}`;
+        });
+        // WHERE clause
+        let whereClause;
+        if (typeof condition === 'string') {
+            whereClause = condition;
+        }
+        else {
+            const whereParts = Object.entries(condition).map(([k, v]) => {
+                if (v === 'NULL')
+                    return `"${k}" IS NULL`;
+                if (v === '')
+                    return `"${k}" = ''`;
+                idx++;
+                vals.push(v);
+                return `"${k}" = $${idx}`;
+            });
+            whereClause = whereParts.join(' AND ');
+        }
+        const sql = `UPDATE "${table}" SET ${setClauses.join(', ')} WHERE ${whereClause}`;
+        try {
+            const result = await pool.query(sql, vals);
+            return result.rowCount ?? 0;
+        }
+        catch (err) {
+            this.error = err.message;
+            throw err;
+        }
+    }
+    /**
+     * Close all connection pools.
+     */
+    static async closeAll() {
+        const entries = Array.from(poolRegistry.entries());
+        for (const [key, pool] of entries) {
+            await pool.end();
+            poolRegistry.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=pgService.js.map