@appixar/xpg 1.0.0

package/dist/cli.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+// ─────────────────────────────────────────────
+// x-postgres — CLI entry point
+// ─────────────────────────────────────────────
+import { Command } from 'commander';
+import { writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { up } from './builder.js';
+import * as log from './logger.js';
+const program = new Command();
+program
+    .name('xpg')
+    .description('YAML-driven PostgreSQL schema management & migrations')
+    .version('1.0.0')
+    .option('--no-color', 'Disable colored output');
+// ─── up command ───
+program
+    .command('up')
+    .description('Run database migrations (create/update/drop tables from YAML schemas)')
+    .option('--create', 'Create database if it does not exist')
+    .option('--name <db>', 'Target specific database cluster by NAME')
+    .option('--tenant <key>', 'Target specific tenant key')
+    .option('--mute', 'Suppress all output')
+    .option('--dry', 'Dry run — show queries without executing')
+    .option('--drop-orphans', 'Drop tables that exist in DB but not in YAML')
+    .option('--config <path>', 'Path to config file (default: xpg.config.yml)')
+    .action(async (opts) => {
+    try {
+        await up({
+            create: opts.create,
+            name: opts.name,
+            tenant: opts.tenant,
+            mute: opts.mute,
+            dry: opts.dry,
+            dropOrphans: opts.dropOrphans,
+            config: opts.config,
+        });
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+});
+// ─── init command ───
+program
+    .command('init')
+    .description('Generate sample configuration files in the current directory')
+    .action(() => {
+    const configPath = resolve(process.cwd(), 'xpg.config.yml');
+    const dbDir = resolve(process.cwd(), 'database');
+    if (existsSync(configPath)) {
+        log.warn('xpg.config.yml already exists. Skipping.');
+    }
+    else {
+        writeFileSync(configPath, SAMPLE_CONFIG);
+        log.success('✓ Created xpg.config.yml');
+    }
+    if (!existsSync(dbDir)) {
+        mkdirSync(dbDir, { recursive: true });
+        writeFileSync(resolve(dbDir, 'example.yml'), SAMPLE_TABLE);
+        log.success('✓ Created database/example.yml');
+    }
+    else {
+        log.warn('database/ already exists. Skipping.');
+    }
+    log.say('\nEdit xpg.config.yml with your PostgreSQL credentials, then run:');
+    log.say('  npx xpg up', 'cyan');
+});
+program.parse();
+// ─── Sample templates ───
+const SAMPLE_CONFIG = `#────────────────────────────────────
+# x-postgres configuration
+#────────────────────────────────────
+POSTGRES:
+  DB:
+    "main":
+      NAME: my_database
+      HOST: <ENV.DB_HOST>
+      USER: <ENV.DB_USER>
+      PASS: <ENV.DB_PASS>
+      PORT: <ENV.DB_PORT>
+      PREF: app_
+      PATH: [database]
+
+  CUSTOM_FIELDS:
+    "id":
+      Type: serial
+      Key: PRI
+    "str":
+      Type: varchar(64)
+    "text":
+      Type: text
+    "int":
+      Type: integer
+    "float":
+      Type: real
+    "date":
+      Type: timestamp
+    "email":
+      Type: varchar(128)
+    "phone":
+      Type: varchar(11)
+    "now":
+      Type: timestamp
+      Default: now()
+    "pid":
+      Type: varchar(12)
+      Key: UNI
+      Default: '"left"(md5((random())::text), 12)'
+`;
+const SAMPLE_TABLE = `# Example table definition
+example_users:
+  user_id: id
+  user_name: str required
+  user_email: email unique index
+  user_status: str/32 default/active index
+  user_date_insert: now
+`;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/configLoader.d.ts

@@ -0,0 +1,22 @@
+import type { PostgresConfig, CustomFieldDef } from './types.js';
+export interface LoadedConfig {
+    postgres: PostgresConfig['POSTGRES'];
+    customFields: Record<string, CustomFieldDef>;
+    /** Directory where the config file lives (used to resolve relative paths) */
+    configDir: string;
+}
+/**
+ * Load configuration.
+ *
+ * Resolution order:
+ * 1. `--config <path>` CLI argument → single file
+ * 2. `xpg.config.yml` in CWD
+ * 3. `config/postgres.yml` + `config/custom_fields.yml` (PHP-compatible layout)
+ */
+export declare function loadConfig(configPath?: string): LoadedConfig;
+/**
+ * Resolve database schema paths from config.
+ * Handles both absolute paths and paths relative to configDir.
+ */
+export declare function resolveSchemaPath(pathEntry: string, configDir: string): string;
+//# sourceMappingURL=configLoader.d.ts.map

package/dist/configLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configLoader.d.ts","sourceRoot":"","sources":["../src/configLoader.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+BjE,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7C,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CA6C5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG9E"}

package/dist/configLoader.js

@@ -0,0 +1,97 @@
+// ─────────────────────────────────────────────
+// x-postgres — Config loader
+// ─────────────────────────────────────────────
+// Loads xpg.config.yml (or separate postgres.yml + custom_fields.yml)
+// with environment variable interpolation: <ENV.VAR> → process.env.VAR
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import YAML from 'yaml';
+/**
+ * Interpolate <ENV.VAR_NAME> placeholders with process.env values.
+ */
+function interpolateEnv(raw) {
+    return raw.replace(/<ENV\.([A-Za-z_][A-Za-z0-9_]*)>/g, (_match, varName) => {
+        const val = process.env[varName];
+        if (val === undefined) {
+            console.warn(`[x-postgres] ⚠ ENV var "${varName}" is not defined — using empty string`);
+        }
+        return val ?? '';
+    });
+}
+/**
+ * Recursively walk a parsed YAML object and interpolate env vars in all string values.
+ */
+function deepInterpolate(obj) {
+    if (typeof obj === 'string')
+        return interpolateEnv(obj);
+    if (Array.isArray(obj))
+        return obj.map(deepInterpolate);
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const [k, v] of Object.entries(obj)) {
+            result[k] = deepInterpolate(v);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Load configuration.
+ *
+ * Resolution order:
+ * 1. `--config <path>` CLI argument → single file
+ * 2. `xpg.config.yml` in CWD
+ * 3. `config/postgres.yml` + `config/custom_fields.yml` (PHP-compatible layout)
+ */
+export function loadConfig(configPath) {
+    let raw = {};
+    let configDir = process.cwd();
+    if (configPath) {
+        const abs = resolve(configPath);
+        if (!existsSync(abs))
+            throw new Error(`Config file not found: ${abs}`);
+        raw = YAML.parse(readFileSync(abs, 'utf-8')) ?? {};
+        configDir = dirname(abs);
+    }
+    else if (existsSync(resolve(process.cwd(), 'xpg.config.yml'))) {
+        const abs = resolve(process.cwd(), 'xpg.config.yml');
+        raw = YAML.parse(readFileSync(abs, 'utf-8')) ?? {};
+        configDir = dirname(abs);
+    }
+    else {
+        // Try PHP-compatible layout
+        const pgPath = resolve(process.cwd(), 'config/postgres.yml');
+        const cfPath = resolve(process.cwd(), 'config/custom_fields.yml');
+        if (existsSync(pgPath)) {
+            raw = YAML.parse(readFileSync(pgPath, 'utf-8')) ?? {};
+        }
+        if (existsSync(cfPath)) {
+            const cfRaw = YAML.parse(readFileSync(cfPath, 'utf-8')) ?? {};
+            // Merge custom fields into POSTGRES block
+            if (cfRaw?.POSTGRES?.CUSTOM_FIELDS && raw?.POSTGRES) {
+                raw.POSTGRES.CUSTOM_FIELDS = cfRaw.POSTGRES.CUSTOM_FIELDS;
+            }
+            else if (cfRaw?.POSTGRES?.CUSTOM_FIELDS) {
+                raw.POSTGRES = { CUSTOM_FIELDS: cfRaw.POSTGRES.CUSTOM_FIELDS };
+            }
+        }
+    }
+    // Interpolate environment variables
+    raw = deepInterpolate(raw);
+    const postgres = raw.POSTGRES;
+    if (!postgres?.DB) {
+        throw new Error('Config error: POSTGRES.DB is missing. Please create xpg.config.yml or config/postgres.yml');
+    }
+    const customFields = postgres.CUSTOM_FIELDS ?? {};
+    return { postgres, customFields, configDir };
+}
+/**
+ * Resolve database schema paths from config.
+ * Handles both absolute paths and paths relative to configDir.
+ */
+export function resolveSchemaPath(pathEntry, configDir) {
+    if (pathEntry.startsWith('/'))
+        return pathEntry;
+    return resolve(configDir, pathEntry);
+}
+//# sourceMappingURL=configLoader.js.map

package/dist/configLoader.js.map

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

package/dist/defaultNormalizer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Convert a raw default value from YAML into a safe SQL expression.
+ *
+ * Rules:
+ * - null/empty/"null" → null (no DEFAULT clause)
+ * - Numbers / booleans → as-is
+ * - SQL functions (ending with ")") or keywords (CURRENT_TIMESTAMP, etc.) → as-is
+ * - JSON/JSONB with {} or [] → cast with ::jsonb / ::json
+ * - UUID literals → single-quoted lowercase
+ * - Already single-quoted → as-is
+ * - Double-quoted → convert to single-quoted
+ * - Everything else → single-quoted string
+ */
+export declare function normalizeDefaultSql(rawDefault: string | null | undefined, typeRealUpper: string): string | null;
+/**
+ * Build the full DEFAULT clause for SQL, e.g. "DEFAULT 'value'"
+ */
+export declare function buildDefaultClause(rawDefault: string | null | undefined, typeRealUpper: string): string;
+/**
+ * Normalize a column_default value from Postgres for safe comparison.
+ *
+ * Examples:
+ * - "'0'::integer" → "0"
+ * - "true::boolean" → "true"
+ * - "now()" → "now()" (unchanged)
+ * - "nextval('tbl_id_seq'::regclass)" → kept as-is
+ */
+export declare function normalizeDbDefaultForCompare(dbDefault: string | null | undefined): string;
+//# sourceMappingURL=defaultNormalizer.d.ts.map

package/dist/defaultNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultNormalizer.d.ts","sourceRoot":"","sources":["../src/defaultNormalizer.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8D/G;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAIvG;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAkCzF"}

package/dist/defaultNormalizer.js

@@ -0,0 +1,124 @@
+// ─────────────────────────────────────────────
+// x-postgres — Default value normalizer
+// ─────────────────────────────────────────────
+// Handles all logic for converting YAML default values to SQL,
+// and normalizing database defaults for diff comparison.
+/**
+ * Convert a raw default value from YAML into a safe SQL expression.
+ *
+ * Rules:
+ * - null/empty/"null" → null (no DEFAULT clause)
+ * - Numbers / booleans → as-is
+ * - SQL functions (ending with ")") or keywords (CURRENT_TIMESTAMP, etc.) → as-is
+ * - JSON/JSONB with {} or [] → cast with ::jsonb / ::json
+ * - UUID literals → single-quoted lowercase
+ * - Already single-quoted → as-is
+ * - Double-quoted → convert to single-quoted
+ * - Everything else → single-quoted string
+ */
+export function normalizeDefaultSql(rawDefault, typeRealUpper) {
+    if (rawDefault === null || rawDefault === undefined)
+        return null;
+    let raw = String(rawDefault).trim();
+    if (raw === '')
+        return null;
+    // Explicit "null" → no default
+    if (raw.toLowerCase() === 'null')
+        return null;
+    // Strip "DEFAULT " prefix if user typed it
+    if (raw.toLowerCase().startsWith('default ')) {
+        raw = raw.substring(8).trim();
+    }
+    const upperRaw = raw.toUpperCase();
+    // SQL functions (ends with ")") or SQL keywords
+    if (/\)\s*$/.test(raw) || ['CURRENT_TIMESTAMP', 'CURRENT_DATE', 'CURRENT_TIME'].includes(upperRaw)) {
+        return raw;
+    }
+    // Boolean
+    if (['true', 'false'].includes(raw.toLowerCase())) {
+        return raw.toUpperCase();
+    }
+    // Numeric
+    if (/^-?\d+(\.\d+)?$/.test(raw)) {
+        return raw;
+    }
+    // JSON / JSONB
+    if (typeRealUpper.includes('JSONB') || typeRealUpper.includes('JSON')) {
+        const first = raw[0];
+        if (first === '{' || first === '[') {
+            const escaped = raw.replace(/'/g, "''");
+            if (typeRealUpper.includes('JSONB'))
+                return `'${escaped}'::jsonb`;
+            return `'${escaped}'::json`;
+        }
+        // Already advanced expression
+        return raw;
+    }
+    // UUID literal
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(raw)) {
+        return `'${raw.toLowerCase()}'`;
+    }
+    // Already single-quoted
+    if (/^'(.*)'$/s.test(raw)) {
+        return raw;
+    }
+    // Double-quoted → convert
+    const dqMatch = raw.match(/^"(.*)"$/s);
+    if (dqMatch) {
+        raw = dqMatch[1];
+    }
+    // Default: wrap as string
+    const escaped = raw.replace(/'/g, "''");
+    return `'${escaped}'`;
+}
+/**
+ * Build the full DEFAULT clause for SQL, e.g. "DEFAULT 'value'"
+ */
+export function buildDefaultClause(rawDefault, typeRealUpper) {
+    const sql = normalizeDefaultSql(rawDefault, typeRealUpper);
+    if (sql === null)
+        return '';
+    return `DEFAULT ${sql}`;
+}
+/**
+ * Normalize a column_default value from Postgres for safe comparison.
+ *
+ * Examples:
+ * - "'0'::integer" → "0"
+ * - "true::boolean" → "true"
+ * - "now()" → "now()" (unchanged)
+ * - "nextval('tbl_id_seq'::regclass)" → kept as-is
+ */
+export function normalizeDbDefaultForCompare(dbDefault) {
+    let d = String(dbDefault ?? '').trim();
+    if (d === '')
+        return '';
+    d = d.replace(/\s+/g, ' ');
+    // Don't touch nextval (serial/sequence)
+    if (d.toLowerCase().includes('nextval('))
+        return d;
+    // Strip trailing ::type casts (handles multiword like "timestamp without time zone")
+    let prev = '';
+    while (prev !== d) {
+        prev = d;
+        const m = d.match(/^(.*)::[a-zA-Z][a-zA-Z0-9_ ]*$/);
+        if (m)
+            d = m[1].trim();
+    }
+    // Strip outer parentheses
+    const parenMatch = d.match(/^\((.*)\)$/);
+    if (parenMatch)
+        d = parenMatch[1].trim();
+    // Strip outer single quotes
+    const quoteMatch = d.match(/^'(.*)'$/s);
+    if (quoteMatch)
+        d = quoteMatch[1];
+    // Boolean normalize
+    if (['true', 'false'].includes(d.toLowerCase())) {
+        d = d.toLowerCase();
+    }
+    // Unescape double single-quotes
+    d = d.replace(/''/g, "'");
+    return d;
+}
+//# sourceMappingURL=defaultNormalizer.js.map

package/dist/defaultNormalizer.js.map

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

package/dist/diffEngine.d.ts

@@ -0,0 +1,21 @@
+import type { ParsedSchema, DbColumnInfo, QueuedQuery } from './types.js';
+interface DbIndexRow {
+    indexname: string;
+}
+interface DbConstraintRow {
+    conname: string;
+}
+export interface DiffContext {
+    table: string;
+    schema: ParsedSchema;
+    currentColumns: Record<string, DbColumnInfo>;
+    existingIndexes: DbIndexRow[];
+    existingUniques: DbConstraintRow[];
+    mute: boolean;
+}
+/**
+ * Generate ALTER statements to bring a live table in sync with YAML schema.
+ */
+export declare function generateUpdateTable(ctx: DiffContext): QueuedQuery[];
+export {};
+//# sourceMappingURL=diffEngine.d.ts.map

package/dist/diffEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffEngine.d.ts","sourceRoot":"","sources":["../src/diffEngine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK1E,UAAU,UAAU;IAAG,SAAS,EAAE,MAAM,CAAA;CAAE;AAC1C,UAAU,eAAe;IAAG,OAAO,EAAE,MAAM,CAAA;CAAE;AAE7C,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,EAAE,CAgOnE"}