@memberjunction/codegen-lib 5.4.1 → 5.6.0

package/dist/Database/providers/postgresql/PostgreSQLCodeGenConnection.d.ts

@@ -0,0 +1,53 @@
+/**
+ * PostgreSQL implementation of the CodeGenConnection interface.
+ * Wraps pg.Pool to provide a database-agnostic connection
+ * for CodeGen orchestration code.
+ */
+import pg from 'pg';
+import { CodeGenConnection, CodeGenQueryResult, CodeGenTransaction } from '../../codeGenDatabaseProvider.js';
+/**
+ * PostgreSQL implementation of CodeGenConnection.
+ * Wraps a pg.Pool and adapts it to the generic interface.
+ *
+ * Parameter handling:
+ * - SQL Server uses `@ParamName` for parameter placeholders
+ * - PostgreSQL uses ``, ``, etc. for positional parameters
+ * - This implementation translates `@ParamName` references to positional `` parameters
+ *
+ * @example
+ * ```typescript
+ * import pg from 'pg';
+ * const pool = new pg.Pool({ connectionString: '...', });
+ * const conn = new PostgreSQLCodeGenConnection(pool);
+ *
+ * // Simple query
+ * const result = await conn.query("SELECT id, name FROM entities");
+ *
+ * // Parameterized query (uses @-prefix notation, auto-translated to $N)
+ * const result2 = await conn.queryWithParams(
+ *     "SELECT id FROM entities WHERE name = @Name",
+ *     { Name: 'Users' }
+ * );
+ * ```
+ */
+export declare class PostgreSQLCodeGenConnection implements CodeGenConnection {
+    private _pool;
+    constructor(pool: pg.Pool);
+    /**
+     * Provides access to the underlying pg.Pool for cases where
+     * PostgreSQL-specific functionality is needed.
+     */
+    get Pool(): pg.Pool;
+    query(sql: string): Promise<CodeGenQueryResult>;
+    queryWithParams(sql: string, params: Record<string, unknown>): Promise<CodeGenQueryResult>;
+    executeStoredProcedure(name: string, params: Record<string, unknown>): Promise<CodeGenQueryResult>;
+    beginTransaction(): Promise<CodeGenTransaction>;
+    /**
+     * Translates @-prefixed parameter names to PostgreSQL positional $N parameters.
+     * @param sql SQL string with @ParamName placeholders
+     * @param params Named parameters
+     * @returns Object with translated SQL text and ordered values array
+     */
+    private translateParams;
+}
+//# sourceMappingURL=PostgreSQLCodeGenConnection.d.ts.map

package/dist/Database/providers/postgresql/PostgreSQLCodeGenConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgreSQLCodeGenConnection.d.ts","sourceRoot":"","sources":["../../../../src/Database/providers/postgresql/PostgreSQLCodeGenConnection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EACrB,MAAM,+BAA+B,CAAC;AA4BvC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,2BAA4B,YAAW,iBAAiB;IACjE,OAAO,CAAC,KAAK,CAAU;gBAEX,IAAI,EAAE,EAAE,CAAC,IAAI;IAIzB;;;OAGG;IACH,IAAW,IAAI,IAAI,EAAE,CAAC,IAAI,CAEzB;IAEK,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS/C,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAM1F,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWlG,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAMrD;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAqB1B"}

package/dist/Database/providers/postgresql/PostgreSQLCodeGenConnection.js

@@ -0,0 +1,112 @@
+/**
+ * PostgreSQL transaction implementation wrapping pg.PoolClient.
+ */
+class PostgreSQLCodeGenTransaction {
+    constructor(client) {
+        this._client = client;
+    }
+    async query(sql) {
+        const result = await this._client.query(sql);
+        return { recordset: result.rows };
+    }
+    async commit() {
+        await this._client.query('COMMIT');
+        this._client.release();
+    }
+    async rollback() {
+        await this._client.query('ROLLBACK');
+        this._client.release();
+    }
+}
+/**
+ * PostgreSQL implementation of CodeGenConnection.
+ * Wraps a pg.Pool and adapts it to the generic interface.
+ *
+ * Parameter handling:
+ * - SQL Server uses `@ParamName` for parameter placeholders
+ * - PostgreSQL uses ``, ``, etc. for positional parameters
+ * - This implementation translates `@ParamName` references to positional `` parameters
+ *
+ * @example
+ * ```typescript
+ * import pg from 'pg';
+ * const pool = new pg.Pool({ connectionString: '...', });
+ * const conn = new PostgreSQLCodeGenConnection(pool);
+ *
+ * // Simple query
+ * const result = await conn.query("SELECT id, name FROM entities");
+ *
+ * // Parameterized query (uses @-prefix notation, auto-translated to $N)
+ * const result2 = await conn.queryWithParams(
+ *     "SELECT id FROM entities WHERE name = @Name",
+ *     { Name: 'Users' }
+ * );
+ * ```
+ */
+export class PostgreSQLCodeGenConnection {
+    constructor(pool) {
+        this._pool = pool;
+    }
+    /**
+     * Provides access to the underlying pg.Pool for cases where
+     * PostgreSQL-specific functionality is needed.
+     */
+    get Pool() {
+        return this._pool;
+    }
+    async query(sql) {
+        try {
+            const result = await this._pool.query(sql);
+            return { recordset: result.rows };
+        }
+        catch (e) {
+            throw e;
+        }
+    }
+    async queryWithParams(sql, params) {
+        const { text, values } = this.translateParams(sql, params);
+        const result = await this._pool.query(text, values);
+        return { recordset: result.rows };
+    }
+    async executeStoredProcedure(name, params) {
+        // PostgreSQL uses functions instead of stored procedures.
+        // Build a SELECT * FROM function_name(, , ...) call.
+        const keys = Object.keys(params);
+        const placeholders = keys.map((_, i) => `$${i + 1}`).join(', ');
+        const values = keys.map(k => params[k]);
+        const sqlText = `SELECT * FROM ${name}(${placeholders})`;
+        const result = await this._pool.query(sqlText, values);
+        return { recordset: result.rows };
+    }
+    async beginTransaction() {
+        const client = await this._pool.connect();
+        await client.query('BEGIN');
+        return new PostgreSQLCodeGenTransaction(client);
+    }
+    /**
+     * Translates @-prefixed parameter names to PostgreSQL positional $N parameters.
+     * @param sql SQL string with @ParamName placeholders
+     * @param params Named parameters
+     * @returns Object with translated SQL text and ordered values array
+     */
+    translateParams(sql, params) {
+        const keys = Object.keys(params);
+        const values = [];
+        let paramIndex = 0;
+        // Replace each @ParamName with $N in order of appearance
+        // Use word boundary to avoid replacing @ParamName inside longer identifiers
+        let text = sql;
+        for (const key of keys) {
+            const regex = new RegExp(`@${key}\\b`, 'g');
+            if (regex.test(text)) {
+                paramIndex++;
+                values.push(params[key]);
+                // Reset regex lastIndex since test() advances it
+                regex.lastIndex = 0;
+                text = text.replace(regex, `$${paramIndex}`);
+            }
+        }
+        return { text, values };
+    }
+}
+//# sourceMappingURL=PostgreSQLCodeGenConnection.js.map

package/dist/Database/providers/postgresql/PostgreSQLCodeGenConnection.js.map

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

package/dist/Database/providers/postgresql/PostgreSQLCodeGenProvider.d.ts

@@ -0,0 +1,344 @@
+import { EntityInfo, EntityFieldInfo } from '@memberjunction/core';
+import { CodeGenDatabaseProvider, CRUDType, BaseViewGenerationContext, CascadeDeleteContext, FullTextSearchResult } from '../../codeGenDatabaseProvider.js';
+import { DatabasePlatform, SQLDialect } from '@memberjunction/sql-dialect';
+/**
+ * PostgreSQL implementation of the CodeGen database provider.
+ * Generates PostgreSQL-native DDL for views, CRUD functions, triggers, indexes,
+ * full-text search, permissions, and other database objects.
+ */
+export declare class PostgreSQLCodeGenProvider extends CodeGenDatabaseProvider {
+    /** @inheritdoc */
+    get Dialect(): SQLDialect;
+    /** @inheritdoc */
+    get PlatformKey(): DatabasePlatform;
+    /**
+     * Generates a PostgreSQL `DROP ... IF EXISTS ... CASCADE` statement as a guard before
+     * creating or replacing a database object. For triggers, PostgreSQL relies on
+     * `CREATE OR REPLACE` on the trigger function, so a comment is emitted instead.
+     */
+    generateDropGuard(objectType: 'VIEW' | 'PROCEDURE' | 'FUNCTION' | 'TRIGGER', schema: string, name: string): string;
+    /**
+     * Generates a PostgreSQL `CREATE OR REPLACE VIEW` statement for an entity's base view.
+     * Includes all base table columns, parent/related field joins, and root field lateral
+     * joins. Applies a soft-delete `WHERE` filter when the entity uses soft deletes.
+     */
+    generateBaseView(context: BaseViewGenerationContext): string;
+    /**
+     * Generates a PostgreSQL `CREATE OR REPLACE FUNCTION` for inserting a new record.
+     * The function accepts typed parameters for each writable field, performs an `INSERT`
+     * into the base table, and returns the newly created row from the base view via
+     * `RETURN QUERY SELECT`. Handles auto-increment PKs (using `RETURNING ... INTO`),
+     * UUID PKs (with `COALESCE` to gen_random_uuid()), and composite PKs. Also emits
+     * `GRANT EXECUTE` permissions for authorized roles.
+     */
+    generateCRUDCreate(entity: EntityInfo): string;
+    /**
+     * Generates a PostgreSQL `CREATE OR REPLACE FUNCTION` for updating an existing record.
+     * The function accepts typed parameters for all updatable fields plus primary key(s),
+     * performs an `UPDATE ... SET ... WHERE PK = param`, checks `ROW_COUNT` to detect
+     * missing rows, and returns the updated record from the base view via `RETURN QUERY
+     * SELECT`. Also generates the `__mj_UpdatedAt` timestamp trigger for the entity
+     * and emits `GRANT EXECUTE` permissions.
+     */
+    generateCRUDUpdate(entity: EntityInfo): string;
+    /**
+     * Generates a PostgreSQL `CREATE OR REPLACE FUNCTION` for deleting a record.
+     * Supports both hard deletes (`DELETE FROM`) and soft deletes (`UPDATE ... SET
+     * __mj_DeletedAt`). Prepends any cascade SQL for dependent records, uses
+     * `#variable_conflict use_column` to avoid PL/pgSQL naming conflicts, and returns
+     * the affected primary key(s) or NULLs if no row was found. Emits `GRANT EXECUTE`
+     * permissions for authorized roles.
+     */
+    generateCRUDDelete(entity: EntityInfo, cascadeSQL: string): string;
+    /**
+     * Generates a PL/pgSQL trigger function and a `BEFORE UPDATE` trigger that
+     * automatically sets the `__mj_UpdatedAt` column to the current UTC time on every
+     * row update. Uses `CREATE OR REPLACE FUNCTION` for the trigger function and
+     * `DROP TRIGGER IF EXISTS` + `CREATE TRIGGER` for idempotent trigger creation.
+     * Returns an empty string if the entity has no `__mj_UpdatedAt` field.
+     */
+    generateTimestampTrigger(entity: EntityInfo): string;
+    /**
+     * Generates `CREATE INDEX IF NOT EXISTS` statements for each foreign key column
+     * on the entity's base table. Index names follow the `idx_auto_mj_fkey_<table>_<column>`
+     * convention and are truncated to 63 characters (PostgreSQL's maximum identifier length).
+     * Skips primary key columns and virtual fields.
+     */
+    generateForeignKeyIndexes(entity: EntityInfo): string[];
+    /**
+     * Generates a complete PostgreSQL full-text search infrastructure for an entity.
+     * This includes:
+     * 1. A `tsvector` column (`__mj_fts_vector`) added via conditional `ALTER TABLE`
+     * 2. A PL/pgSQL trigger function that concatenates search fields into a `tsvector`
+     * 3. A `BEFORE INSERT OR UPDATE` trigger to keep the vector column in sync
+     * 4. A GIN index on the `tsvector` column for fast lookups
+     * 5. A SQL `STABLE` search function that joins the base view with a `plainto_tsquery` match
+     * 6. A backfill `UPDATE` to populate existing rows where the vector is NULL
+     *
+     * @returns A {@link FullTextSearchResult} with the generated SQL and the search function name.
+     */
+    generateFullTextSearch(entity: EntityInfo, searchFields: EntityFieldInfo[], _primaryKeyIndexName: string): FullTextSearchResult;
+    /**
+     * Generates a PostgreSQL SQL `STABLE` function that walks a self-referencing hierarchy
+     * (e.g., ParentCategoryID) using a recursive CTE to find the root ancestor record.
+     * The CTE starts from `COALESCE(p_parent_id, p_record_id)` as the anchor and follows
+     * the parent FK upward, capped at 100 levels to prevent infinite loops. Returns the
+     * root record's primary key value.
+     */
+    generateRootIDFunction(entity: EntityInfo, field: EntityFieldInfo): string;
+    /** @inheritdoc */
+    generateRootFieldSelect(_entity: EntityInfo, field: EntityFieldInfo, alias: string): string;
+    /**
+     * Generates a `LEFT JOIN LATERAL` clause that invokes the root ID function for a
+     * self-referencing field. PostgreSQL uses `LATERAL` joins (rather than SQL Server's
+     * `OUTER APPLY`) to call scalar functions inline within a view definition.
+     */
+    generateRootFieldJoin(entity: EntityInfo, field: EntityFieldInfo, alias: string): string;
+    /** @inheritdoc */
+    generateViewPermissions(entity: EntityInfo): string;
+    /**
+     * Generates `GRANT EXECUTE ON FUNCTION` statements for the given CRUD function,
+     * granting access to each role that has the corresponding permission (Create, Update,
+     * or Delete) on the entity.
+     */
+    generateCRUDPermissions(entity: EntityInfo, routineName: string, type: CRUDType): string;
+    /** @inheritdoc */
+    generateFullTextSearchPermissions(entity: EntityInfo, functionName: string): string;
+    /** @inheritdoc */
+    generateSingleCascadeOperation(context: CascadeDeleteContext): string;
+    /**
+     * Generates a PL/pgSQL `DO $$` block that conditionally adds `__mj_CreatedAt` and
+     * `__mj_UpdatedAt` columns to a table using `TIMESTAMPTZ` type with a UTC default.
+     * Uses `information_schema` checks to skip columns that already exist.
+     */
+    generateTimestampColumns(schema: string, tableName: string): string;
+    /**
+     * Builds the parameter declaration list for a PostgreSQL CRUD function signature.
+     * Each parameter is prefixed with `p_` and uses the PostgreSQL-mapped type. For
+     * CREATE functions, parameters with default values or primary keys get `DEFAULT NULL`
+     * to allow optional arguments, and PostgreSQL's requirement that all subsequent
+     * parameters also have defaults once the first default appears is respected.
+     */
+    generateCRUDParamString(entityFields: EntityFieldInfo[], isUpdate: boolean): string;
+    /**
+     * Builds either the column name list or the value expression list for an INSERT
+     * statement, depending on whether {@link prefix} is empty (column names) or set
+     * (parameter values with `p_` prefix). Handles special date fields
+     * (`__mj_CreatedAt`, `__mj_UpdatedAt`) by substituting `NOW() AT TIME ZONE 'UTC'`
+     * and applies default-value COALESCE wrappers for fields with non-null defaults.
+     */
+    generateInsertFieldString(entity: EntityInfo, entityFields: EntityFieldInfo[], prefix: string, excludePrimaryKey?: boolean): string;
+    /** @inheritdoc */
+    generateUpdateFieldString(entityFields: EntityFieldInfo[]): string;
+    /** @inheritdoc */
+    getCRUDRoutineName(entity: EntityInfo, type: CRUDType): string;
+    /** @inheritdoc */
+    generateSQLFileHeader(entity: EntityInfo, itemName: string): string;
+    /** @inheritdoc */
+    generateAllEntitiesSQLFileHeader(): string;
+    /**
+     * Maps a SQL default value expression to its PostgreSQL equivalent. Translates
+     * SQL Server built-in functions (e.g., `NEWID()` to `gen_random_uuid()`,
+     * `GETUTCDATE()` to `NOW() AT TIME ZONE 'UTC'`), strips outer parentheses and
+     * surrounding single quotes, and re-applies quoting based on the {@link needsQuotes}
+     * flag. Returns `'NULL'` for empty or whitespace-only input.
+     */
+    formatDefaultValue(defaultValue: string, needsQuotes: boolean): string;
+    /**
+     * Builds a set of PL/pgSQL components for working with an entity's primary key(s)
+     * in cascade operations: variable declarations, SELECT field list, FETCH INTO
+     * variable list, and named routine parameter assignments. Used by cascade delete
+     * and update-to-NULL generators to construct cursor-based loops.
+     */
+    buildPrimaryKeyComponents(entity: EntityInfo, prefix?: string): {
+        varDeclarations: string;
+        selectFields: string;
+        fetchInto: string;
+        routineParams: string;
+    };
+    /** @inheritdoc */
+    callRoutineSQL(schema: string, routineName: string, params: string[], _paramNames?: string[]): string;
+    /** @inheritdoc */
+    conditionalInsertSQL(checkQuery: string, insertSQL: string): string;
+    /** @inheritdoc */
+    wrapInsertWithConflictGuard(_conflictCheckSQL: string): {
+        prefix: string;
+        suffix: string;
+    };
+    /** @inheritdoc */
+    addColumnSQL(schema: string, tableName: string, columnName: string, dataType: string, nullable: boolean, defaultExpression?: string): string;
+    /** @inheritdoc */
+    alterColumnTypeAndNullabilitySQL(schema: string, tableName: string, columnName: string, dataType: string, nullable: boolean): string;
+    /** @inheritdoc */
+    addDefaultConstraintSQL(schema: string, tableName: string, columnName: string, defaultExpression: string): string;
+    /**
+     * Generates a PL/pgSQL `DO $$` block that drops both a named CHECK constraint (if one
+     * exists on the column, found via `pg_catalog.pg_constraint`) and the column's default
+     * value. Uses dynamic SQL (`EXECUTE format(...)`) to drop the constraint by name,
+     * then unconditionally runs `ALTER COLUMN ... DROP DEFAULT`.
+     */
+    dropDefaultConstraintSQL(schema: string, tableName: string, columnName: string): string;
+    /** @inheritdoc */
+    dropObjectSQL(objectType: 'VIEW' | 'PROCEDURE' | 'FUNCTION', schema: string, name: string): string;
+    /** @inheritdoc */
+    getViewExistsSQL(): string;
+    /** @inheritdoc */
+    getViewColumnsSQL(schema: string, viewName: string): string;
+    /** @inheritdoc */
+    get TimestampType(): string;
+    /**
+     * Compares two PostgreSQL data type strings for equivalence, accounting for common
+     * aliases. For example, `'timestamptz'` and `'timestamp with time zone'` are
+     * considered equal. Returns `true` if the types match directly or via alias lookup.
+     */
+    compareDataTypes(reported: string, expected: string): boolean;
+    /** @inheritdoc */
+    getSystemSchemasToExclude(): string[];
+    /**
+     * PostgreSQL does not require view refresh after creation. Unlike SQL Server's
+     * `sp_refreshview`, PostgreSQL views automatically reflect column changes, so
+     * this always returns `false`.
+     */
+    get NeedsViewRefresh(): boolean;
+    /** @inheritdoc */
+    generateViewRefreshSQL(_schema: string, _viewName: string): string;
+    /** @inheritdoc */
+    generateViewTestQuerySQL(schema: string, viewName: string): string;
+    /**
+     * PostgreSQL requires a nullability fix for virtual (computed) fields in views.
+     * View columns derived from expressions may report incorrect nullability in
+     * `information_schema.columns`, so CodeGen must correct these after view creation.
+     */
+    get NeedsVirtualFieldNullabilityFix(): boolean;
+    /**
+     * SQL keywords that should NOT be quoted even when they match PascalCase patterns.
+     */
+    private static readonly _SQL_KEYWORDS;
+    /**
+     * Quotes mixed-case identifiers in a SQL string for PostgreSQL compatibility.
+     * Uses a tokenizer approach to skip string literals, already-quoted identifiers,
+     * dollar-quoted blocks, and SQL keywords. Any remaining PascalCase word gets
+     * double-quoted to preserve case.
+     */
+    quoteSQLForExecution(sql: string): string;
+    /**
+     * Parses a PostgreSQL column default value by stripping PG-specific type cast syntax
+     * (e.g., `'2024-01-01'::timestamp` becomes `'2024-01-01'`). Returns `null` for
+     * auto-increment sequences (`nextval(...)`) and for null/undefined input, indicating
+     * no meaningful default.
+     */
+    parseColumnDefaultValue(sqlDefaultValue: string): string | null;
+    /** @inheritdoc */
+    getPendingEntityFieldsSQL(mjCoreSchema: string): string;
+    /** @inheritdoc */
+    getCheckConstraintsSchemaFilter(_excludeSchemas: string[]): string;
+    /** @inheritdoc */
+    getEntitiesWithMissingBaseTablesFilter(): string;
+    /** @inheritdoc */
+    getFixVirtualFieldNullabilitySQL(mjCoreSchema: string): string;
+    /**
+     * Executes a SQL file against the PostgreSQL database using the `psql` CLI tool.
+     * Reads connection parameters from environment variables (`PG_HOST`, `PG_PORT`,
+     * `PG_DATABASE`, `PG_USERNAME`, `PG_PASSWORD`) with fallback to `configInfo` values.
+     * Resolves the file path to an absolute path before passing it to psql.
+     */
+    executeSQLFileViaShell(filePath: string): Promise<boolean>;
+    /**
+     * Converts a PascalCase or camelCase string to snake_case.
+     * Handles consecutive uppercase letters (e.g., "ID" → "id", "HTMLParser" → "html_parser").
+     */
+    private toSnakeCase;
+    /**
+     * Maps a SQL Server type string to its PostgreSQL equivalent.
+     */
+    private mapSQLType;
+    /** Gets the base view name for an entity */
+    private getBaseViewName;
+    /** Builds the WHERE clause for soft-delete filtering */
+    private buildSoftDeleteWhereClause;
+    /** Assembles the SELECT parts for a base view */
+    private buildBaseViewSelectParts;
+    /** Assembles the FROM/JOIN parts for a base view */
+    private buildBaseViewFromParts;
+    /** Determines whether a field should be included in CRUD parameters */
+    private shouldIncludeFieldInParams;
+    /** Determines whether a field should be skipped for INSERT */
+    private shouldSkipFieldForInsert;
+    /** Gets the INSERT value for a special date field */
+    private getSpecialDateInsertValue;
+    /** Gets the parameter insert value, handling defaults */
+    private getParameterInsertValue;
+    /** Builds a WHERE clause using primary key fields with a parameter prefix */
+    private buildPrimaryKeyWhereClause;
+    /** Builds the INSERT strategy for CREATE function based on PK type */
+    private buildCreateInsertStrategy;
+    /** Builds the DELETE body and return type based on entity delete type */
+    private buildDeleteStrategy;
+    /** Generates cascade update-to-NULL SQL for nullable FK */
+    private generateCascadeUpdateToNull;
+    /** Generates cascade cursor-based DELETE SQL for non-nullable FK */
+    private generateCascadeCursorDelete;
+    /** Collects unique role SQL names from permissions that have a role name */
+    private collectPermissionRoles;
+    /** @inheritdoc */
+    getViewDefinitionSQL(schema: string, viewName: string): string;
+    /**
+     * Generates a query against `pg_index`, `pg_class`, and `pg_namespace` to retrieve
+     * the index name for a table's primary key constraint. Used by CodeGen to reference
+     * the PK index in full-text search and other operations.
+     */
+    getPrimaryKeyIndexNameSQL(schema: string, tableName: string): string;
+    /**
+     * Generates a query against `pg_index`, `pg_class`, `pg_namespace`, and `pg_attribute`
+     * to check whether a column participates in a multi-column unique constraint. Returns
+     * rows only when the unique index contains more than one column and includes the
+     * specified column.
+     */
+    getCompositeUniqueConstraintCheckSQL(schema: string, tableName: string, columnName: string): string;
+    /** @inheritdoc */
+    getForeignKeyIndexExistsSQL(schema: string, tableName: string, indexName: string): string;
+    /** Skips a single-quoted string literal, handling escaped quotes ('') */
+    private skipSingleQuotedString;
+    /** Skips a dollar-quoted block ($$ ... $$ or $tag$ ... $tag$) */
+    private skipDollarQuotedBlock;
+    /** Skips an already double-quoted identifier */
+    private skipDoubleQuotedIdentifier;
+    /** Skips a square-bracketed identifier (SQL Server style) */
+    private skipBracketedIdentifier;
+    /** Skips an @-prefixed parameter */
+    private skipAtParameter;
+    /** Processes a word token - quotes it if it's a PascalCase identifier, not a keyword */
+    private processWord;
+    /**
+     * Builds the full pending entity fields query for PostgreSQL.
+     * Uses CTEs for FK, PK, and UK caches, then joins against entity metadata
+     * to find fields that exist in the database but not in MJ metadata.
+     */
+    private buildPendingEntityFieldsQuery;
+    /**
+     * Builds the CASE expression for AllowUpdateAPI in the pending entity fields query.
+     */
+    private buildAllowUpdateAPICase;
+    /**
+     * Builds the UPDATE SQL to fix virtual field nullability.
+     * Updates AllowsNull for virtual fields based on the FK column's nullability.
+     */
+    private buildFixVirtualFieldNullabilityUpdateSQL;
+    /**
+     * Executes a SQL file using the psql CLI.
+     */
+    private executePsqlCommand;
+    /**
+     * Spawns a psql child process and returns its output.
+     */
+    private spawnPsql;
+    /**
+     * Logs psql stdout/stderr output, filtering out informational NOTICE messages.
+     */
+    private logPsqlOutput;
+    /**
+     * Logs psql execution errors with password masking.
+     */
+    private logPsqlError;
+}
+//# sourceMappingURL=PostgreSQLCodeGenProvider.d.ts.map

package/dist/Database/providers/postgresql/PostgreSQLCodeGenProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgreSQLCodeGenProvider.d.ts","sourceRoot":"","sources":["../../../../src/Database/providers/postgresql/PostgreSQLCodeGenProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAwB,MAAM,sBAAsB,CAAC;AAEzF,OAAO,EACH,uBAAuB,EACvB,QAAQ,EACR,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACvB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAqB,gBAAgB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAM9F;;;;GAIG;AACH,qBACa,yBAA0B,SAAQ,uBAAuB;IAClE,kBAAkB;IAClB,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,kBAAkB;IAClB,IAAI,WAAW,IAAI,gBAAgB,CAElC;IAID;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAoBlH;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM;IA6B5D;;;;;;;OAOG;IACH,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IA4C9C;;;;;;;OAOG;IACH,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAgD9C;;;;;;;OAOG;IACH,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IA+BlE;;;;;;OAMG;IACH,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAgCpD;;;;;OAKG;IACH,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE;IAkBvD;;;;;;;;;;;OAWG;IACH,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,oBAAoB,EAAE,MAAM,GAAG,oBAAoB;IAuE/H;;;;;;OAMG;IACH,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM;IAkD1E,kBAAkB;IAClB,uBAAuB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAK3F;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAUxF,kBAAkB;IAClB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IASnD;;;;OAIG;IACH,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM;IAkBxF,kBAAkB;IAClB,iCAAiC,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAUnF,kBAAkB;IAClB,8BAA8B,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IAYrE;;;;OAIG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAmBnE;;;;;;OAMG;IACH,uBAAuB,CAAC,YAAY,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM;IA0BnF;;;;;;OAMG;IACH,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAE,OAAe,GAAG,MAAM;IAoB1I,kBAAkB;IAClB,yBAAyB,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,MAAM;IAWlE,kBAAkB;IAClB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM;IAc9D,kBAAkB;IAClB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IASnE,kBAAkB;IAClB,gCAAgC,IAAI,MAAM;IAU1C;;;;;;OAMG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM;IA2CtE;;;;;OAKG;IACH,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG;QAC5D,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACzB;IA2BD,kBAAkB;IAClB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAQrG,kBAAkB;IAClB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAInE,kBAAkB;IAClB,2BAA2B,CAAC,iBAAiB,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAM1F,kBAAkB;IAClB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ5I,kBAAkB;IAClB,gCAAgC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM;IAOpI,kBAAkB;IAClB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM;IAMjH;;;;;OAKG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IA2BvF,kBAAkB;IAClB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAUlG,kBAAkB;IAClB,gBAAgB,IAAI,MAAM;IAI1B,kBAAkB;IAClB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAgB3D,kBAAkB;IAClB,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAW7D,kBAAkB;IAClB,yBAAyB,IAAI,MAAM,EAAE;IAIrC;;;;OAIG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,kBAAkB;IAClB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAIlE,kBAAkB;IAClB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIlE;;;;OAIG;IACH,IAAI,+BAA+B,IAAI,OAAO,CAE7C;IAID;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAmDlC;IAEH;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IA0CzC;;;;;OAKG;IACH,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAuB/D,kBAAkB;IAClB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAKvD,kBAAkB;IAClB,+BAA+B,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM;IAKlE,kBAAkB;IAClB,sCAAsC,IAAI,MAAM;IAKhD,kBAAkB;IAClB,gCAAgC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAO9D;;;;;OAKG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBhE;;;OAGG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB,4CAA4C;IAC5C,OAAO,CAAC,eAAe;IAIvB,wDAAwD;IACxD,OAAO,CAAC,0BAA0B;IAOlC,iDAAiD;IACjD,OAAO,CAAC,wBAAwB;IAUhC,oDAAoD;IACpD,OAAO,CAAC,sBAAsB;IAQ9B,uEAAuE;IACvE,OAAO,CAAC,0BAA0B;IAUlC,8DAA8D;IAC9D,OAAO,CAAC,wBAAwB;IAUhC,qDAAqD;IACrD,OAAO,CAAC,yBAAyB;IAKjC,yDAAyD;IACzD,OAAO,CAAC,uBAAuB;IAa/B,6EAA6E;IAC7E,OAAO,CAAC,0BAA0B;IAMlC,sEAAsE;IACtE,OAAO,CAAC,yBAAyB;IA6CjC,yEAAyE;IACzE,OAAO,CAAC,mBAAmB;IAkD3B,2DAA2D;IAC3D,OAAO,CAAC,2BAA2B;IAsBnC,oEAAoE;IACpE,OAAO,CAAC,2BAA2B;IAmBnC,4EAA4E;IAC5E,OAAO,CAAC,sBAAsB;IAY9B,kBAAkB;IAClB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI9D;;;;OAIG;IACH,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAiBpE;;;;;OAKG;IACH,oCAAoC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAoBnG,kBAAkB;IAClB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAUzF,yEAAyE;IACzE,OAAO,CAAC,sBAAsB;IAgB9B,iEAAiE;IACjE,OAAO,CAAC,qBAAqB;IA4B7B,gDAAgD;IAChD,OAAO,CAAC,0BAA0B;IAQlC,6DAA6D;IAC7D,OAAO,CAAC,uBAAuB;IAQ/B,oCAAoC;IACpC,OAAO,CAAC,eAAe;IAOvB,wFAAwF;IACxF,OAAO,CAAC,WAAW;IAoBnB;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA6ErC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;;OAGG;IACH,OAAO,CAAC,wCAAwC;IA4BhD;;OAEG;YACW,kBAAkB;IA6BhC;;OAEG;IACH,OAAO,CAAC,SAAS;IA+BjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,YAAY;CAcvB"}