@appixar/xpg 1.0.0

package/dist/pgService.js.map

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

package/dist/schemaParser.d.ts

@@ -0,0 +1,10 @@
+import type { CustomFieldDef, ParsedSchema } from './types.js';
+/**
+ * Parse YAML table columns (the raw field map from a .yml table entry)
+ * into a structured ParsedSchema with typed fields, indexes, and constraints.
+ *
+ * @param fields - Raw YAML fields: `{ column_name: "type modifier1 modifier2 ..." }`
+ * @param customFields - Custom field type definitions from config
+ */
+export declare function parseSchema(fields: Record<string, string> | null | undefined, customFields: Record<string, CustomFieldDef>): ParsedSchema;
+//# sourceMappingURL=schemaParser.d.ts.map

package/dist/schemaParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaParser.d.ts","sourceRoot":"","sources":["../src/schemaParser.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAmB,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,WAAW,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACjD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAC7C,YAAY,CA+Gd"}

package/dist/schemaParser.js

@@ -0,0 +1,118 @@
+// ─────────────────────────────────────────────
+// x-postgres — YAML schema parser
+// ─────────────────────────────────────────────
+// Parses the YAML field DSL into structured ParsedSchema.
+// Port of PHP convertField().
+/**
+ * Parse YAML table columns (the raw field map from a .yml table entry)
+ * into a structured ParsedSchema with typed fields, indexes, and constraints.
+ *
+ * @param fields - Raw YAML fields: `{ column_name: "type modifier1 modifier2 ..." }`
+ * @param customFields - Custom field type definitions from config
+ */
+export function parseSchema(fields, customFields) {
+    const result = {
+        fields: {},
+        individualIndexes: [],
+        compositeIndexes: {},
+        compositeUniqueIndexes: {},
+    };
+    if (!fields || typeof fields !== 'object')
+        return result;
+    for (const [fieldName, rawValue] of Object.entries(fields)) {
+        // Skip meta keys like ~ignore
+        if (fieldName.startsWith('~'))
+            continue;
+        if (typeof rawValue !== 'string')
+            continue;
+        const parts = rawValue.split(/\s+/);
+        const typePart = parts[0];
+        // Extract base type and optional length: "type/length" → type, length
+        const [typeAlias, lengthStr] = typePart.split('/');
+        // Resolve custom field type
+        const customDef = customFields[typeAlias];
+        let typeReal = customDef?.Type ?? typeAlias;
+        // Apply explicit length override
+        if (lengthStr) {
+            // Remove any existing (N) from the type
+            typeReal = typeReal.replace(/\(\d+(?:,\d+)?\)/, '');
+            typeReal = `${typeReal}(${lengthStr})`;
+        }
+        // ─── Default ───
+        let defaultRaw = null;
+        for (const part of parts) {
+            if (part.startsWith('default/')) {
+                defaultRaw = part.substring('default/'.length);
+                break;
+            }
+        }
+        // Fallback: default from custom field definition
+        if (defaultRaw === null && customDef?.Default) {
+            defaultRaw = customDef.Default;
+        }
+        // ─── Nullable ───
+        let nullable;
+        if (typeAlias === 'id' || typeReal.toUpperCase().includes('SERIAL')) {
+            nullable = ''; // SERIAL = implicit NOT NULL
+        }
+        else {
+            nullable = parts.includes('required') ? 'NOT NULL' : 'NULL';
+        }
+        // ─── Key ───
+        let key = '';
+        const customKey = customDef?.Key;
+        if (parts.includes('unique'))
+            key = 'UNI'; // simple unique (no group)
+        if (customKey)
+            key = customKey;
+        // ─── Extra ───
+        const extra = (customDef?.Extra ?? '').toUpperCase();
+        // ─── Build field definition ───
+        result.fields[fieldName] = {
+            field: fieldName,
+            type: typeReal.toUpperCase(),
+            nullable,
+            key,
+            defaultValue: defaultRaw,
+            extra,
+        };
+        // ─── Indexes ───
+        for (const part of parts) {
+            // "index" or "index/group1,group2"
+            if (part === 'index' || part.startsWith('index/')) {
+                const indexParts = part.split('/');
+                if (indexParts[1]) {
+                    // Composite index
+                    const groupNames = indexParts[1].split(',');
+                    for (const groupName of groupNames) {
+                        if (!result.compositeIndexes[groupName]) {
+                            result.compositeIndexes[groupName] = [];
+                        }
+                        result.compositeIndexes[groupName].push(fieldName);
+                    }
+                }
+                else {
+                    // Individual index
+                    if (!result.individualIndexes.includes(fieldName)) {
+                        result.individualIndexes.push(fieldName);
+                    }
+                }
+            }
+            // "unique/group" = composite unique
+            if (part.startsWith('unique/')) {
+                const uniqueParts = part.split('/');
+                if (uniqueParts[1]) {
+                    const groupNames = uniqueParts[1].split(',');
+                    for (const groupName of groupNames) {
+                        if (!result.compositeUniqueIndexes[groupName]) {
+                            result.compositeUniqueIndexes[groupName] = [];
+                        }
+                        result.compositeUniqueIndexes[groupName].push(fieldName);
+                    }
+                }
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=schemaParser.js.map

package/dist/schemaParser.js.map

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

package/dist/sqlGenerator.d.ts

@@ -0,0 +1,18 @@
+import type { ParsedSchema, QueuedQuery } from './types.js';
+/**
+ * Generate CREATE TABLE + all related indexes/constraints for a new table.
+ *
+ * ⚠ NOTE: Index creation uses CONCURRENTLY which **cannot run inside a transaction**.
+ * The builder executes each query individually (no BEGIN/COMMIT wrapping) to avoid this.
+ * If you call these queries programmatically, do NOT wrap them in a transaction block.
+ */
+export declare function generateCreateTable(table: string, schema: ParsedSchema, mute: boolean): QueuedQuery[];
+/**
+ * Generate DROP TABLE CASCADE statement.
+ */
+export declare function generateDropTable(table: string, mute: boolean): QueuedQuery;
+/**
+ * Generate CREATE DATABASE statement.
+ */
+export declare function generateCreateDatabase(name: string): QueuedQuery;
+//# sourceMappingURL=sqlGenerator.d.ts.map

package/dist/sqlGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlGenerator.d.ts","sourceRoot":"","sources":["../src/sqlGenerator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI5D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,OAAO,GACd,WAAW,EAAE,CAuEf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,WAAW,CAM3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAIhE"}

package/dist/sqlGenerator.js

@@ -0,0 +1,104 @@
+// ─────────────────────────────────────────────
+// x-postgres — SQL generator
+// ─────────────────────────────────────────────
+// Generates CREATE TABLE, indexes, constraints, DROP TABLE, CREATE DATABASE.
+import { buildDefaultClause } from './defaultNormalizer.js';
+import * as log from './logger.js';
+/**
+ * Generate CREATE TABLE + all related indexes/constraints for a new table.
+ *
+ * ⚠ NOTE: Index creation uses CONCURRENTLY which **cannot run inside a transaction**.
+ * The builder executes each query individually (no BEGIN/COMMIT wrapping) to avoid this.
+ * If you call these queries programmatically, do NOT wrap them in a transaction block.
+ */
+export function generateCreateTable(table, schema, mute) {
+    const queries = [];
+    if (!mute)
+        log.header(`∴ ${table}`, 'blue');
+    const { fields, individualIndexes, compositeIndexes, compositeUniqueIndexes } = schema;
+    // ─── CREATE TABLE ───
+    const colDefs = [];
+    const uniqueFields = [];
+    for (const [k, v] of Object.entries(fields)) {
+        const type = v.type;
+        const nullable = v.nullable === 'NOT NULL' ? 'NOT NULL' : v.nullable === 'NULL' ? 'NULL' : '';
+        const extra = v.extra;
+        // SERIAL auto-creates default nextval, don't force DEFAULT
+        let defaultClause = '';
+        if (!type.includes('SERIAL')) {
+            defaultClause = buildDefaultClause(v.defaultValue, type);
+        }
+        let colSql = `"${k}" ${type}`;
+        if (nullable)
+            colSql += ` ${nullable}`;
+        if (defaultClause)
+            colSql += ` ${defaultClause}`;
+        if (extra)
+            colSql += ` ${extra}`;
+        if (v.key === 'PRI')
+            colSql += ' PRIMARY KEY';
+        if (v.key === 'UNI')
+            uniqueFields.push(k);
+        colDefs.push(colSql);
+    }
+    const createSql = `CREATE TABLE "${table}" (\n${colDefs.join(',\n')}\n);`;
+    queries.push({ sql: createSql, mini: `CREATE TABLE "${table}" ...`, color: 'green' });
+    if (!mute)
+        log.say(`→ ${createSql}`, 'green');
+    // ─── UNIQUE constraints ───
+    for (const field of uniqueFields) {
+        const sql = `ALTER TABLE "${table}" ADD CONSTRAINT "${table}_${field}_unique" UNIQUE ("${field}");`;
+        const mini = `ADD UNIQUE "${table}_${field}_unique" ...`;
+        queries.push({ sql, mini, color: 'cyan' });
+        if (!mute)
+            log.say(`→ ${sql}`, 'cyan');
+    }
+    // ─── Individual indexes ───
+    for (const field of individualIndexes) {
+        const sql = `CREATE INDEX CONCURRENTLY "${table}_${field}_idx" ON "${table}" ("${field}");`;
+        const mini = `ADD INDEX "${table}_${field}_idx" ...`;
+        queries.push({ sql, mini, color: 'cyan' });
+        if (!mute)
+            log.say(`→ ${sql}`, 'cyan');
+    }
+    // ─── Composite indexes ───
+    for (const [indexName, columns] of Object.entries(compositeIndexes)) {
+        const colsStr = columns.map(c => `"${c}"`).join(', ');
+        const sql = `CREATE INDEX CONCURRENTLY "${table}_${indexName}_idx" ON "${table}" (${colsStr});`;
+        const mini = `ADD INDEX "${table}_${indexName}_idx" ...`;
+        queries.push({ sql, mini, color: 'cyan' });
+        if (!mute)
+            log.say(`→ ${sql}`, 'cyan');
+    }
+    // ─── Composite unique indexes ───
+    for (const [indexName, columns] of Object.entries(compositeUniqueIndexes)) {
+        const colsStr = columns.map(c => `"${c}"`).join(', ');
+        const sql = `CREATE UNIQUE INDEX CONCURRENTLY "${table}_${indexName}_unique_idx" ON "${table}" (${colsStr});`;
+        const mini = `ADD UNIQUE INDEX "${table}_${indexName}_unique_idx" ...`;
+        queries.push({ sql, mini, color: 'cyan' });
+        if (!mute)
+            log.say(`→ ${sql}`, 'cyan');
+    }
+    return queries;
+}
+/**
+ * Generate DROP TABLE CASCADE statement.
+ */
+export function generateDropTable(table, mute) {
+    if (!mute)
+        log.header(`∴ ${table}`, 'blue');
+    const sql = `DROP TABLE IF EXISTS "${table}" CASCADE;`;
+    const mini = `DROP TABLE "${table}" ...`;
+    if (!mute)
+        log.say(`→ ${sql}`, 'yellow');
+    return { sql, mini, color: 'yellow' };
+}
+/**
+ * Generate CREATE DATABASE statement.
+ */
+export function generateCreateDatabase(name) {
+    const sql = `CREATE DATABASE "${name}" ENCODING 'UTF8';`;
+    const mini = `CREATE DATABASE "${name}" ...`;
+    return { sql, mini, color: 'green' };
+}
+//# sourceMappingURL=sqlGenerator.js.map

package/dist/sqlGenerator.js.map

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

package/dist/typeDictionary.d.ts

@@ -0,0 +1,2 @@
+export declare const POSTGRES_TYPE_DICTIONARY: Record<string, string>;
+//# sourceMappingURL=typeDictionary.d.ts.map

package/dist/typeDictionary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeDictionary.d.ts","sourceRoot":"","sources":["../src/typeDictionary.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmB3D,CAAC"}

package/dist/typeDictionary.js

@@ -0,0 +1,27 @@
+// ─────────────────────────────────────────────
+// x-postgres — Postgres type dictionary
+// ─────────────────────────────────────────────
+// Maps YAML/config type names to their PostgreSQL
+// information_schema.columns data_type equivalents.
+// Used by the diff engine for accurate comparison.
+export const POSTGRES_TYPE_DICTIONARY = {
+    SERIAL: 'integer',
+    VARCHAR: 'character varying',
+    INT: 'integer',
+    INTEGER: 'integer',
+    TEXT: 'text',
+    TIMESTAMP: 'timestamp without time zone',
+    DATE: 'date',
+    TIME: 'time without time zone',
+    BOOLEAN: 'boolean',
+    SMALLINT: 'smallint',
+    BIGINT: 'bigint',
+    REAL: 'real',
+    DOUBLE: 'double precision',
+    NUMERIC: 'numeric',
+    DECIMAL: 'numeric',
+    JSON: 'json',
+    JSONB: 'jsonb',
+    UUID: 'uuid',
+};
+//# sourceMappingURL=typeDictionary.js.map

package/dist/typeDictionary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeDictionary.js","sourceRoot":"","sources":["../src/typeDictionary.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,wCAAwC;AACxC,gDAAgD;AAChD,kDAAkD;AAClD,oDAAoD;AACpD,mDAAmD;AAEnD,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC5D,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,mBAAmB;IAC5B,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,6BAA6B;IACxC,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+/** Parsed field definition from YAML DSL */
+export interface FieldDefinition {
+    field: string;
+    type: string;
+    nullable: string;
+    key: string;
+    defaultValue: string | null;
+    extra: string;
+}
+/** Result of parsing a full table's field list from YAML */
+export interface ParsedSchema {
+    fields: Record<string, FieldDefinition>;
+    individualIndexes: string[];
+    compositeIndexes: Record<string, string[]>;
+    compositeUniqueIndexes: Record<string, string[]>;
+}
+/** Custom field type definition (from custom_fields.yml) */
+export interface CustomFieldDef {
+    Type: string;
+    Null?: string;
+    Default?: string;
+    Key?: string;
+    Extra?: string;
+}
+/** Single node in a database cluster */
+export interface DbNodeConfig {
+    TYPE?: 'write' | 'read';
+    NAME: string;
+    HOST: string | string[];
+    USER: string;
+    PASS: string;
+    PORT: number | string;
+    PREF?: string;
+    PATH?: string | string[];
+    TENANT_KEYS?: TenantKeysConfig;
+}
+/** Tenant key resolution config */
+export interface TenantKeysConfig {
+    DBKEY?: string;
+    TABLE?: string;
+    FIELD?: string;
+    WHERE?: string;
+    CONTROLLER?: string;
+    JSON_URL?: string;
+}
+/** Top-level postgres config shape */
+export interface PostgresConfig {
+    POSTGRES: {
+        DB: Record<string, DbNodeConfig | DbNodeConfig[]>;
+        CUSTOM_FIELDS?: Record<string, CustomFieldDef>;
+    };
+}
+/** Row from information_schema.columns */
+export interface DbColumnInfo {
+    [key: string]: unknown;
+    column_name: string;
+    data_type: string;
+    is_nullable: string;
+    character_maximum_length: number | null;
+    column_default: string | null;
+    numeric_precision: number | null;
+    numeric_scale: number | null;
+}
+/** Valid colors for terminal output */
+export type LogColor = 'green' | 'yellow' | 'cyan' | 'gray' | 'red' | 'magenta' | 'blue' | 'white';
+/** A queued SQL action */
+export interface QueuedQuery {
+    sql: string;
+    mini: string;
+    color: LogColor;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpD;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE;QACN,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC,CAAC;QAClD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;KAClD,CAAC;CACL;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,uCAAuC;AACvC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnG,0BAA0B;AAC1B,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// ─────────────────────────────────────────────
+// x-postgres — TypeScript types
+// ─────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,gCAAgC;AAChC,gDAAgD"}

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "@appixar/xpg",
+    "version": "1.0.0",
+    "description": "YAML-driven PostgreSQL schema management, diff-based migrations, and query service",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "bin": {
+        "xpg": "./dist/cli.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsx src/cli.ts",
+        "start": "node dist/cli.js",
+        "test": "tsx --test src/__tests__/*.test.ts"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "dependencies": {
+        "chalk": "^5.3.0",
+        "commander": "^12.1.0",
+        "pg": "^8.13.1",
+        "yaml": "^2.6.1"
+    },
+    "devDependencies": {
+        "@types/node": "^22.10.0",
+        "@types/pg": "^8.11.10",
+        "tsx": "^4.19.0",
+        "typescript": "^5.7.0"
+    },
+    "files": [
+        "dist",
+        "xpg.config.yml-sample"
+    ],
+    "license": "MIT"
+}

package/xpg.config.yml-sample

@@ -0,0 +1,42 @@
+#────────────────────────────────────
+# xpg configuration sample.
+#────────────────────────────────────
+# Copy this file to xpg.config.yml and fill in your credentials.
+# Environment variables are interpolated with <ENV.VAR_NAME> syntax.
+
+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)'