pgsql-deparser 16.0.0 → 17.4.0

package/deparser/deparser.d.ts

@@ -1,301 +0,0 @@
-/**
- * Auto-generated file with types stripped for better tree-shaking
- * DO NOT EDIT - Generated by strip-deparser-types.ts
- */
-import { DeparserContext, DeparserVisitor } from './visitors/base';
-export interface DeparserOptions {
-    newline?: string;
-    tab?: string;
-    functionDelimiter?: string;
-    functionDelimiterFallback?: string;
-    pretty?: boolean;
-}
-/**
- * Deparser - Converts PostgreSQL AST nodes back to SQL strings
- *
- * Entry Points:
- * 1. ParseResult (from libpg-query) - The complete parse result
- *    Structure: { version: number, stmts: RawStmt[] }
- *    Note: stmts is "repeated RawStmt" in protobuf, so array contains RawStmt
- *    objects inline (not wrapped as { RawStmt: ... } nodes)
- *    Example: { version: 170004, stmts: [{ stmt: {...}, stmt_len: 32 }] }
- *
- * 2. Wrapped ParseResult - When explicitly wrapped as a Node
- *    Structure: { ParseResult: { version: number, stmts: RawStmt[] } }
- *
- * 3. Wrapped RawStmt - When explicitly wrapped as a Node
- *    Structure: { RawStmt: { stmt: Node, stmt_len?: number } }
- *
- * 4. Array of Nodes - Multiple statements to deparse
- *    Can be: Node[] (e.g., SelectStmt, InsertStmt, etc.)
- *
- * 5. Single Node - Individual statement node
- *    Example: { SelectStmt: {...} }, { InsertStmt: {...} }, etc.
- *
- * The deparser automatically detects bare ParseResult objects for backward
- * compatibility and wraps them internally for consistent processing.
- */
-export declare class Deparser implements DeparserVisitor {
-    private formatter;
-    private tree;
-    private options;
-    constructor(tree: any | any[] | any, opts?: DeparserOptions);
-    /**
-     * Static method to deparse PostgreSQL AST nodes to SQL
-     * @param query - Can be:
-     *   - ParseResult from libpg-query (e.g., { version: 170004, stmts: [...] })
-     *   - Wrapped ParseResult node (e.g., { ParseResult: {...} })
-     *   - Wrapped RawStmt node (e.g., { RawStmt: {...} })
-     *   - Array of Nodes
-     *   - Single Node (e.g., { SelectStmt: {...} })
-     * @param opts - Deparser options for formatting
-     * @returns The deparsed SQL string
-     */
-    static deparse(query: any | any[] | any, opts?: DeparserOptions): string;
-    deparseQuery(): string;
-    /**
-     * Get the appropriate function delimiter based on the body content
-     * @param body The function body to check
-     * @returns The delimiter to use
-     */
-    private getFunctionDelimiter;
-    deparse(node: any, context?: DeparserContext): string | null;
-    visit(node: any, context?: DeparserContext): string;
-    getNodeType(node: any): string;
-    getNodeData(node: any): any;
-    ParseResult(node: any, context: DeparserContext): string;
-    RawStmt(node: any, context: DeparserContext): string;
-    SelectStmt(node: any, context: DeparserContext): string;
-    A_Expr(node: any, context: DeparserContext): string;
-    deparseOperatorName(name: any): string;
-    private getOperatorPrecedence;
-    private needsParentheses;
-    private isComplexExpression;
-    visitBetweenRange(rexpr: any, context: DeparserContext): string;
-    InsertStmt(node: any, context: DeparserContext): string;
-    UpdateStmt(node: any, context: DeparserContext): string;
-    DeleteStmt(node: any, context: DeparserContext): string;
-    WithClause(node: any, context: DeparserContext): string;
-    ResTarget(node: any, context: DeparserContext): string;
-    deparseReturningList(list: any, context: DeparserContext): string;
-    BoolExpr(node: any, context: DeparserContext): string;
-    FuncCall(node: any, context: DeparserContext): string;
-    FuncExpr(node: any, context: DeparserContext): string;
-    A_Const(node: any, context: DeparserContext): string;
-    ColumnRef(node: any, context: DeparserContext): string;
-    TypeName(node: any, context: DeparserContext): string;
-    Alias(node: any, context: DeparserContext): string;
-    RangeVar(node: any, context: DeparserContext): string;
-    formatIntervalTypeMods(typmods: any, context: DeparserContext): string | null;
-    formatTypeMods(typmods: any, context: DeparserContext): string | null;
-    formatSingleTypeMod(typemod: number, typeName: string): string | null;
-    getPgCatalogTypeName(typeName: string, size: string | null): string;
-    A_ArrayExpr(node: any, context: DeparserContext): string;
-    A_Indices(node: any, context: DeparserContext): string;
-    A_Indirection(node: any, context: DeparserContext): string;
-    A_Star(node: any, context: DeparserContext): string;
-    CaseExpr(node: any, context: DeparserContext): string;
-    CoalesceExpr(node: any, context: DeparserContext): string;
-    TypeCast(node: any, context: DeparserContext): string;
-    CollateClause(node: any, context: DeparserContext): string;
-    BooleanTest(node: any, context: DeparserContext): string;
-    NullTest(node: any, context: DeparserContext): string;
-    private static readonly RESERVED_WORDS;
-    private static needsQuotes;
-    quoteIfNeeded(value: string): string;
-    preserveOperatorDefElemCase(defName: string): string;
-    String(node: any, context: DeparserContext): string;
-    Integer(node: any, context: DeparserContext): string;
-    Float(node: any, context: DeparserContext): string;
-    Boolean(node: any, context: DeparserContext): string;
-    BitString(node: any, context: DeparserContext): string;
-    Null(node: any, context: DeparserContext): string;
-    List(node: any, context: DeparserContext): string;
-    CreateStmt(node: any, context: DeparserContext): string;
-    ColumnDef(node: any, context: DeparserContext): string;
-    Constraint(node: any, context: DeparserContext): string;
-    SubLink(node: any, context: DeparserContext): string;
-    CaseWhen(node: any, context: DeparserContext): string;
-    WindowDef(node: any, context: DeparserContext): string;
-    formatWindowFrame(node: any): string | null;
-    SortBy(node: any, context: DeparserContext): string;
-    GroupingSet(node: any, context: DeparserContext): string;
-    CommonTableExpr(node: any, context: DeparserContext): string;
-    ParamRef(node: any, context: DeparserContext): string;
-    LockingClause(node: any, context: DeparserContext): string;
-    MinMaxExpr(node: any, context: DeparserContext): string;
-    RowExpr(node: any, context: DeparserContext): string;
-    OpExpr(node: any, context: DeparserContext): string;
-    DistinctExpr(node: any, context: DeparserContext): string;
-    NullIfExpr(node: any, context: DeparserContext): string;
-    ScalarArrayOpExpr(node: any, context: DeparserContext): string;
-    Aggref(node: any, context: DeparserContext): string;
-    WindowFunc(node: any, context: DeparserContext): string;
-    FieldSelect(node: any, context: DeparserContext): string;
-    RelabelType(node: any, context: DeparserContext): string;
-    CoerceViaIO(node: any, context: DeparserContext): string;
-    ArrayCoerceExpr(node: any, context: DeparserContext): string;
-    ConvertRowtypeExpr(node: any, context: DeparserContext): string;
-    NamedArgExpr(node: any, context: DeparserContext): string;
-    ViewStmt(node: any, context: DeparserContext): string;
-    IndexStmt(node: any, context: DeparserContext): string;
-    IndexElem(node: any, context: DeparserContext): string;
-    PartitionElem(node: any, context: DeparserContext): string;
-    PartitionCmd(node: any, context: DeparserContext): string;
-    private getAggFunctionName;
-    private getWindowFunctionName;
-    private getOperatorName;
-    JoinExpr(node: any, context: DeparserContext): string;
-    FromExpr(node: any, context: DeparserContext): string;
-    TransactionStmt(node: any, context: DeparserContext): string;
-    VariableSetStmt(node: any, context: DeparserContext): string;
-    VariableShowStmt(node: any, context: DeparserContext): string;
-    CreateSchemaStmt(node: any, context: DeparserContext): string;
-    RoleSpec(node: any, context: DeparserContext): string;
-    roletype(node: any, context: DeparserContext): string;
-    DropStmt(node: any, context: DeparserContext): string;
-    TruncateStmt(node: any, context: DeparserContext): string;
-    ReturnStmt(node: any, context: DeparserContext): string;
-    PLAssignStmt(node: any, context: DeparserContext): string;
-    CopyStmt(node: any, context: DeparserContext): string;
-    AlterTableStmt(node: any, context: DeparserContext): string;
-    AlterTableCmd(node: any, context: DeparserContext): string;
-    CreateFunctionStmt(node: any, context: DeparserContext): string;
-    FunctionParameter(node: any, context: DeparserContext): string;
-    CreateEnumStmt(node: any, context: DeparserContext): string;
-    CreateDomainStmt(node: any, context: DeparserContext): string;
-    CreateRoleStmt(node: any, context: DeparserContext): string;
-    DefElem(node: any, context: DeparserContext): string;
-    CreateTableSpaceStmt(node: any, context: DeparserContext): string;
-    DropTableSpaceStmt(node: any, context: DeparserContext): string;
-    AlterTableSpaceOptionsStmt(node: any, context: DeparserContext): string;
-    CreateExtensionStmt(node: any, context: DeparserContext): string;
-    AlterExtensionStmt(node: any, context: DeparserContext): string;
-    CreateFdwStmt(node: any, context: DeparserContext): string;
-    SetOperationStmt(node: any, context: DeparserContext): string;
-    ReplicaIdentityStmt(node: any, context: DeparserContext): string;
-    AlterCollationStmt(node: any, context: DeparserContext): string;
-    AlterDomainStmt(node: any, context: DeparserContext): string;
-    PrepareStmt(node: any, context: DeparserContext): string;
-    ExecuteStmt(node: any, context: DeparserContext): string;
-    DeallocateStmt(node: any, context: DeparserContext): string;
-    NotifyStmt(node: any, context: DeparserContext): string;
-    ListenStmt(node: any, context: DeparserContext): string;
-    UnlistenStmt(node: any, context: DeparserContext): string;
-    CheckPointStmt(node: any, context: DeparserContext): string;
-    LoadStmt(node: any, context: DeparserContext): string;
-    DiscardStmt(node: any, context: DeparserContext): string;
-    CommentStmt(node: any, context: DeparserContext): string;
-    LockStmt(node: any, context: DeparserContext): string;
-    CreatePolicyStmt(node: any, context: DeparserContext): string;
-    AlterPolicyStmt(node: any, context: DeparserContext): string;
-    CreateUserMappingStmt(node: any, context: DeparserContext): string;
-    CreateStatsStmt(node: any, context: DeparserContext): string;
-    StatsElem(node: any, context: DeparserContext): string;
-    CreatePublicationStmt(node: any, context: DeparserContext): string;
-    CreateSubscriptionStmt(node: any, context: DeparserContext): string;
-    AlterPublicationStmt(node: any, context: DeparserContext): string;
-    AlterSubscriptionStmt(node: any, context: DeparserContext): string;
-    DropSubscriptionStmt(node: any, context: DeparserContext): string;
-    DoStmt(node: any, context: DeparserContext): string;
-    private generateUniqueDollarTag;
-    InlineCodeBlock(node: any, context: DeparserContext): string;
-    CallContext(node: any, context: DeparserContext): string;
-    ConstraintsSetStmt(node: any, context: DeparserContext): string;
-    AlterSystemStmt(node: any, context: DeparserContext): string;
-    VacuumRelation(node: any, context: DeparserContext): string;
-    DropOwnedStmt(node: any, context: DeparserContext): string;
-    ReassignOwnedStmt(node: any, context: DeparserContext): string;
-    AlterTSDictionaryStmt(node: any, context: DeparserContext): string;
-    AlterTSConfigurationStmt(node: any, context: DeparserContext): string;
-    ClosePortalStmt(node: any, context: DeparserContext): string;
-    FetchStmt(node: any, context: DeparserContext): string;
-    AlterStatsStmt(node: any, context: DeparserContext): string;
-    ObjectWithArgs(node: any, context: DeparserContext): string;
-    AlterOperatorStmt(node: any, context: DeparserContext): string;
-    AlterFdwStmt(node: any, context: DeparserContext): string;
-    CreateForeignServerStmt(node: any, context: DeparserContext): string;
-    AlterForeignServerStmt(node: any, context: DeparserContext): string;
-    AlterUserMappingStmt(node: any, context: DeparserContext): string;
-    DropUserMappingStmt(node: any, context: DeparserContext): string;
-    ImportForeignSchemaStmt(node: any, context: DeparserContext): string;
-    ClusterStmt(node: any, context: DeparserContext): string;
-    VacuumStmt(node: any, context: DeparserContext): string;
-    ExplainStmt(node: any, context: DeparserContext): string;
-    ReindexStmt(node: any, context: DeparserContext): string;
-    CallStmt(node: any, context: DeparserContext): string;
-    CreatedbStmt(node: any, context: DeparserContext): string;
-    DropdbStmt(node: any, context: DeparserContext): string;
-    RenameStmt(node: any, context: DeparserContext): string;
-    AlterOwnerStmt(node: any, context: DeparserContext): string;
-    GrantStmt(node: any, context: DeparserContext): string;
-    GrantRoleStmt(node: any, context: DeparserContext): string;
-    SecLabelStmt(node: any, context: DeparserContext): string;
-    AlterDefaultPrivilegesStmt(node: any, context: DeparserContext): string;
-    CreateConversionStmt(node: any, context: DeparserContext): string;
-    CreateCastStmt(node: any, context: DeparserContext): string;
-    CreatePLangStmt(node: any, context: DeparserContext): string;
-    CreateTransformStmt(node: any, context: DeparserContext): string;
-    CreateTrigStmt(node: any, context: DeparserContext): string;
-    TriggerTransition(node: any, context: DeparserContext): string;
-    CreateEventTrigStmt(node: any, context: DeparserContext): string;
-    AlterEventTrigStmt(node: any, context: DeparserContext): string;
-    CreateOpClassStmt(node: any, context: DeparserContext): string;
-    CreateOpFamilyStmt(node: any, context: DeparserContext): string;
-    AlterOpFamilyStmt(node: any, context: DeparserContext): string;
-    MergeStmt(node: any, context: DeparserContext): string;
-    AlterTableMoveAllStmt(node: any, context: DeparserContext): string;
-    CreateSeqStmt(node: any, context: DeparserContext): string;
-    AlterSeqStmt(node: any, context: DeparserContext): string;
-    CompositeTypeStmt(node: any, context: DeparserContext): string;
-    CreateRangeStmt(node: any, context: DeparserContext): string;
-    AlterEnumStmt(node: any, context: DeparserContext): string;
-    AlterTypeStmt(node: any, context: DeparserContext): string;
-    AlterRoleStmt(node: any, context: DeparserContext): string;
-    DropRoleStmt(node: any, context: DeparserContext): string;
-    targetList(node: any, context: DeparserContext): string;
-    CreateAggregateStmt(node: any, context: DeparserContext): string;
-    CreateTableAsStmt(node: any, context: DeparserContext): string;
-    RefreshMatViewStmt(node: any, context: DeparserContext): string;
-    AccessPriv(node: any, context: DeparserContext): string;
-    aliasname(node: any, context: DeparserContext): string;
-    DefineStmt(node: any, context: DeparserContext): string;
-    AlterDatabaseStmt(node: any, context: DeparserContext): string;
-    AlterDatabaseRefreshCollStmt(node: any, context: DeparserContext): string;
-    AlterDatabaseSetStmt(node: any, context: DeparserContext): string;
-    DeclareCursorStmt(node: any, context: DeparserContext): string;
-    PublicationObjSpec(node: any, context: DeparserContext): string;
-    PublicationTable(node: any, context: DeparserContext): string;
-    CreateAmStmt(node: any, context: DeparserContext): string;
-    IntoClause(node: any, context: DeparserContext): string;
-    OnConflictExpr(node: any, context: DeparserContext): string;
-    ScanToken(node: any, context: DeparserContext): string;
-    CreateOpClassItem(node: any, context: DeparserContext): string;
-    Var(node: any, context: DeparserContext): string;
-    TableFunc(node: any, context: DeparserContext): string;
-    RangeTableFunc(node: any, context: DeparserContext): string;
-    RangeTableFuncCol(node: any, context: DeparserContext): string;
-    JsonArrayQueryConstructor(node: any, context: DeparserContext): string;
-    RangeFunction(node: any, context: DeparserContext): string;
-    XmlExpr(node: any, context: DeparserContext): string;
-    schemaname(node: any, context: DeparserContext): string;
-    RangeTableSample(node: any, context: DeparserContext): string;
-    XmlSerialize(node: any, context: DeparserContext): string;
-    ctes(node: any, context: DeparserContext): string;
-    RuleStmt(node: any, context: DeparserContext): string;
-    RangeSubselect(node: any, context: DeparserContext): string;
-    relname(node: any, context: DeparserContext): string;
-    rel(node: any, context: DeparserContext): string;
-    objname(node: any, context: DeparserContext): string;
-    SQLValueFunction(node: any, context: DeparserContext): string;
-    GroupingFunc(node: any, context: DeparserContext): string;
-    MultiAssignRef(node: any, context: DeparserContext): string;
-    SetToDefault(node: any, context: DeparserContext): string;
-    CurrentOfExpr(node: any, context: DeparserContext): string;
-    TableLikeClause(node: any, context: DeparserContext): string;
-    AlterFunctionStmt(node: any, context: DeparserContext): string;
-    AlterObjectSchemaStmt(node: any, context: DeparserContext): string;
-    AlterRoleSetStmt(node: any, context: DeparserContext): string;
-    CreateForeignTableStmt(node: any, context: DeparserContext): string;
-    private containsMultilineStringLiteral;
-}

package/deparser/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Auto-generated file with types stripped for better tree-shaking
- * DO NOT EDIT - Generated by strip-deparser-types.ts
- */
-import { Deparser, DeparserOptions } from "./deparser";
-declare const deparseMethod: typeof Deparser.deparse;
-export declare const deparseSync: typeof Deparser.deparse;
-export declare const deparse: (...args: Parameters<typeof deparseMethod>) => Promise<ReturnType<typeof deparseMethod>>;
-export { Deparser, DeparserOptions };

package/deparser/index.js

@@ -1,17 +0,0 @@
-"use strict";
-/**
- * Auto-generated file with types stripped for better tree-shaking
- * DO NOT EDIT - Generated by strip-deparser-types.ts
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Deparser = exports.deparse = exports.deparseSync = void 0;
-const deparser_1 = require("./deparser");
-Object.defineProperty(exports, "Deparser", { enumerable: true, get: function () { return deparser_1.Deparser; } });
-const deparseMethod = deparser_1.Deparser.deparse;
-// Export the original sync version as deparseSync
-exports.deparseSync = deparseMethod;
-// Create an async wrapper for deparse
-const deparse = async (...args) => {
-    return deparseMethod(...args);
-};
-exports.deparse = deparse;

package/deparser/utils/quote-utils.d.ts

@@ -1,24 +0,0 @@
-/**
- * Auto-generated file with types stripped for better tree-shaking
- * DO NOT EDIT - Generated by strip-deparser-types.ts
- */
-export declare class QuoteUtils {
-    static needsQuotes(value: string): boolean;
-    static quote(value: any): any;
-    static escape(literal: string): string;
-    /**
-     * Escapes a string value for use in E-prefixed string literals
-     * Handles both backslashes and single quotes properly
-     */
-    static escapeEString(value: string): string;
-    /**
-     * Formats a string as an E-prefixed string literal with proper escaping
-     * This wraps the complete E-prefix logic including detection and formatting
-     */
-    static formatEString(value: string): string;
-    /**
-     * Determines if a string value needs E-prefix for escaped string literals
-     * Detects backslash escape sequences that require E-prefix in PostgreSQL
-     */
-    static needsEscapePrefix(value: string): boolean;
-}

package/esm/deparser/index.js

@@ -1,13 +0,0 @@
-/**
- * Auto-generated file with types stripped for better tree-shaking
- * DO NOT EDIT - Generated by strip-deparser-types.ts
- */
-import { Deparser } from "./deparser";
-const deparseMethod = Deparser.deparse;
-// Export the original sync version as deparseSync
-export const deparseSync = deparseMethod;
-// Create an async wrapper for deparse
-export const deparse = async (...args) => {
-    return deparseMethod(...args);
-};
-export { Deparser };

package/esm/deparser/utils/sql-formatter.js

@@ -1,36 +0,0 @@
-/**
- * Auto-generated file with types stripped for better tree-shaking
- * DO NOT EDIT - Generated by strip-deparser-types.ts
- */
-export class SqlFormatter {
-    newlineChar;
-    tabChar;
-    prettyMode;
-    constructor(newlineChar = '\n', tabChar = '  ', prettyMode = false) {
-        this.newlineChar = newlineChar;
-        this.tabChar = tabChar;
-        this.prettyMode = prettyMode;
-    }
-    format(parts, separator = ' ') {
-        return parts.filter(part => part !== null && part !== undefined && part !== '').join(separator);
-    }
-    indent(text, count = 1) {
-        if (!this.prettyMode) {
-            return text;
-        }
-        const indentation = this.tabChar.repeat(count);
-        return text.split(this.newlineChar).map(line => line.trim() ? indentation + line : line).join(this.newlineChar);
-    }
-    parens(content) {
-        return `(${content})`;
-    }
-    newline() {
-        return this.newlineChar;
-    }
-    tab() {
-        return this.tabChar;
-    }
-    isPretty() {
-        return this.prettyMode;
-    }
-}

package/esm/v16-to-v17-direct.js

@@ -1,44 +0,0 @@
-/**
- * Auto-generated file with types stripped for better tree-shaking
- * DO NOT EDIT - Generated by strip-direct-transformer-types.ts
- */
-import { V16ToV17Transformer } from "./v16-to-v17";
-/**
- * Direct transformer from PG16 to PG17
- * This transformer only includes the necessary code for v16->v17 transformation
- */
-export class PG16ToPG17Transformer {
-    transformer = new V16ToV17Transformer();
-    transform(node) {
-        // If it's a ParseResult, handle it specially
-        if (this.isParseResult(node)) {
-            const transformedStmts = node.stmts.map((stmtWrapper) => {
-                if (stmtWrapper.stmt) {
-                    const transformedStmt = this.transformer.transform(stmtWrapper.stmt, { parentNodeTypes: [] });
-                    return { ...stmtWrapper, stmt: transformedStmt };
-                }
-                return stmtWrapper;
-            });
-            return {
-                ...node,
-                version: 170004, // PG17 version
-                stmts: transformedStmts
-            };
-        }
-        // Otherwise, transform as a regular node
-        return this.transformer.transform(node, { parentNodeTypes: [] });
-    }
-    /**
-     * Transform a single statement from PG16 to PG17
-     * @deprecated Use transform() instead, which handles all node types
-     */
-    transformStatement(stmt) {
-        return this.transformer.transform(stmt, { parentNodeTypes: [] });
-    }
-    /**
-     * Type guard to check if a node is a ParseResult
-     */
-    isParseResult(node) {
-        return node && typeof node === 'object' && 'version' in node && 'stmts' in node;
-    }
-}