rawsql-ts 0.12.0 → 0.12.1

package/dist/esm/models/SqlPrintToken.d.ts

@@ -0,0 +1,143 @@
+export declare enum SqlPrintTokenType {
+    container = 0,
+    keyword = 1,
+    value = 2,// Represents non-keyword elements such as table names
+    comma = 3,// Represents comma ','
+    parenthesis = 4,// Represents parentheses: ( ) { } [ ]
+    operator = 5,// Represents operators such as +, -, *, /
+    comment = 6,// SQL comments /* */ or --
+    parameter = 7,
+    dot = 8,
+    type = 9,
+    space = 10,// Whitespace characters
+    argumentSplitter = 11,
+    commentNewline = 12
+}
+export declare enum SqlPrintTokenContainerType {
+    ColumnReference = "ColumnReference",
+    LiteralValue = "LiteralValue",
+    IdentifierString = "IdentifierString",
+    InlineQuery = "InlineQuery",
+    StringSpecifierExpression = "StringSpecifierExpression",
+    None = "",
+    ValueList = "ValueList",
+    OrderByItem = "OrderByItem",
+    FunctionCall = "FunctionCall",
+    UnaryExpression = "UnaryExpression",
+    BinaryExpression = "BinaryExpression",
+    SwitchCaseArgument = "SwitchCaseArgument",
+    ElseClause = "ElseClause",
+    CaseKeyValuePair = "CaseKeyValuePair",
+    CaseThenValue = "CaseThenValue",
+    CaseElseValue = "CaseElseValue",
+    ParenExpression = "ParenExpression",
+    CastExpression = "CastExpression",
+    CaseExpression = "CaseExpression",
+    ArrayExpression = "ArrayExpression",
+    BetweenExpression = "BetweenExpression",
+    TypeValue = "TypeValue",
+    TupleExpression = "TupleExpression",
+    WindowFrameExpression = "WindowFrameExpression",
+    SelectItem = "SelectItem",
+    SelectClause = "SelectClause",
+    DistinctOn = "DistinctOn",
+    SourceExpression = "SourceExpression",
+    FromClause = "FromClause",
+    JoinClause = "JoinClause",
+    JoinOnClause = "JoinOnClause",
+    JoinUsingClause = "JoinUsingClause",
+    FunctionSource = "FunctionSource",
+    SourceAliasExpression = "SourceAliasExpression",
+    RawString = "RawString",
+    QualifiedName = "QualifiedName",
+    WhereClause = "WhereClause",
+    SimpleSelectQuery = "SimpleSelectQuery",
+    OrderByClause = "OrderByClause",
+    GroupByClause = "GroupByClause",
+    HavingClause = "HavingClause",
+    SubQuerySource = "SubQuerySource",
+    PartitionByClause = "PartitionByClause",
+    WindowFrameClause = "WindowFrameClause",
+    LimitClause = "LimitClause",
+    OffsetClause = "OffsetClause",
+    ForClause = "ForClause",
+    WindowClause = "WindowClause",
+    BinarySelectQueryOperator = "BinarySelectQueryOperator",
+    Values = "Values",
+    ValuesQuery = "ValuesQuery",
+    WithClause = "WithClause",
+    CommonTable = "CommonTable",
+    WindowFrameSpec = "WindowFrameSpec",
+    WindowFrameBoundStatic = "WindowFrameBoundStatic",
+    WindowFrameBoundaryValue = "WindowFrameBoundaryValue",
+    FetchClause = "FetchClause",
+    FetchExpression = "FetchExpression",
+    InsertQuery = "InsertQuery",
+    InsertClause = "InsertClause",
+    UpdateQuery = "UpdateQuery",
+    UpdateClause = "UpdateClause",
+    DeleteQuery = "DeleteQuery",
+    DeleteClause = "DeleteClause",
+    UsingClause = "UsingClause",
+    ReturningClause = "ReturningClause",
+    SetClause = "SetClause",
+    SetClauseItem = "SetClauseItem",
+    CreateTableQuery = "CreateTableQuery",
+    CreateTableDefinition = "CreateTableDefinition",
+    TableColumnDefinition = "TableColumnDefinition",
+    ColumnConstraintDefinition = "ColumnConstraintDefinition",
+    TableConstraintDefinition = "TableConstraintDefinition",
+    ReferenceDefinition = "ReferenceDefinition",
+    CreateIndexStatement = "CreateIndexStatement",
+    IndexColumnList = "IndexColumnList",
+    IndexColumnDefinition = "IndexColumnDefinition",
+    DropTableStatement = "DropTableStatement",
+    DropIndexStatement = "DropIndexStatement",
+    AlterTableStatement = "AlterTableStatement",
+    AlterTableAddConstraint = "AlterTableAddConstraint",
+    AlterTableDropConstraint = "AlterTableDropConstraint",
+    AlterTableAddColumn = "AlterTableAddColumn",
+    AlterTableDropColumn = "AlterTableDropColumn",
+    DropConstraintStatement = "DropConstraintStatement",
+    ExplainStatement = "ExplainStatement",
+    ExplainOption = "ExplainOption",
+    AnalyzeStatement = "AnalyzeStatement",
+    MergeQuery = "MergeQuery",
+    MergeWhenClause = "MergeWhenClause",
+    MergeUpdateAction = "MergeUpdateAction",
+    MergeDeleteAction = "MergeDeleteAction",
+    MergeInsertAction = "MergeInsertAction",
+    MergeDoNothingAction = "MergeDoNothingAction",
+    CommentBlock = "CommentBlock"
+}
+export declare class SqlPrintToken {
+    /**
+     * The type of this token, representing the general category (e.g. keyword, value, operator).
+     */
+    type: SqlPrintTokenType;
+    /**
+     * The actual text content of this token, following SQL syntax.
+     */
+    text: string;
+    /**
+     * The type of the container this token belongs to. Used for clauses, functions, or other groupings.
+     */
+    containerType: SqlPrintTokenContainerType;
+    /**
+     * Optional. Keywords that are part of this token, like DISTINCT in a SELECT clause.
+     * These should typically be processed before innerTokens.
+     */
+    keywordTokens?: SqlPrintToken[];
+    /**
+     * Child tokens that belong to this container.
+     */
+    innerTokens: SqlPrintToken[];
+    /**
+     * Optional marker indicating that this token originated from headerComments.
+     * This flag is only valid for CommentBlock containers and used by printers
+     * to selectively emit only header-level annotations.
+     */
+    isHeaderComment?: boolean;
+    constructor(type: SqlPrintTokenType, text?: string, containerType?: SqlPrintTokenContainerType);
+    markAsHeaderComment(): void;
+}

package/dist/esm/models/SqlPrintToken.js

@@ -0,0 +1,134 @@
+export var SqlPrintTokenType;
+(function (SqlPrintTokenType) {
+    SqlPrintTokenType[SqlPrintTokenType["container"] = 0] = "container";
+    SqlPrintTokenType[SqlPrintTokenType["keyword"] = 1] = "keyword";
+    SqlPrintTokenType[SqlPrintTokenType["value"] = 2] = "value";
+    SqlPrintTokenType[SqlPrintTokenType["comma"] = 3] = "comma";
+    SqlPrintTokenType[SqlPrintTokenType["parenthesis"] = 4] = "parenthesis";
+    SqlPrintTokenType[SqlPrintTokenType["operator"] = 5] = "operator";
+    SqlPrintTokenType[SqlPrintTokenType["comment"] = 6] = "comment";
+    SqlPrintTokenType[SqlPrintTokenType["parameter"] = 7] = "parameter";
+    SqlPrintTokenType[SqlPrintTokenType["dot"] = 8] = "dot";
+    SqlPrintTokenType[SqlPrintTokenType["type"] = 9] = "type";
+    SqlPrintTokenType[SqlPrintTokenType["space"] = 10] = "space";
+    SqlPrintTokenType[SqlPrintTokenType["argumentSplitter"] = 11] = "argumentSplitter";
+    SqlPrintTokenType[SqlPrintTokenType["commentNewline"] = 12] = "commentNewline";
+})(SqlPrintTokenType || (SqlPrintTokenType = {}));
+// Enum for container type, used for formatting and context
+export var SqlPrintTokenContainerType;
+(function (SqlPrintTokenContainerType) {
+    SqlPrintTokenContainerType["ColumnReference"] = "ColumnReference";
+    SqlPrintTokenContainerType["LiteralValue"] = "LiteralValue";
+    SqlPrintTokenContainerType["IdentifierString"] = "IdentifierString";
+    SqlPrintTokenContainerType["InlineQuery"] = "InlineQuery";
+    SqlPrintTokenContainerType["StringSpecifierExpression"] = "StringSpecifierExpression";
+    SqlPrintTokenContainerType["None"] = "";
+    SqlPrintTokenContainerType["ValueList"] = "ValueList";
+    SqlPrintTokenContainerType["OrderByItem"] = "OrderByItem";
+    SqlPrintTokenContainerType["FunctionCall"] = "FunctionCall";
+    SqlPrintTokenContainerType["UnaryExpression"] = "UnaryExpression";
+    SqlPrintTokenContainerType["BinaryExpression"] = "BinaryExpression";
+    SqlPrintTokenContainerType["SwitchCaseArgument"] = "SwitchCaseArgument";
+    SqlPrintTokenContainerType["ElseClause"] = "ElseClause";
+    SqlPrintTokenContainerType["CaseKeyValuePair"] = "CaseKeyValuePair";
+    SqlPrintTokenContainerType["CaseThenValue"] = "CaseThenValue";
+    SqlPrintTokenContainerType["CaseElseValue"] = "CaseElseValue";
+    SqlPrintTokenContainerType["ParenExpression"] = "ParenExpression";
+    SqlPrintTokenContainerType["CastExpression"] = "CastExpression";
+    SqlPrintTokenContainerType["CaseExpression"] = "CaseExpression";
+    SqlPrintTokenContainerType["ArrayExpression"] = "ArrayExpression";
+    SqlPrintTokenContainerType["BetweenExpression"] = "BetweenExpression";
+    SqlPrintTokenContainerType["TypeValue"] = "TypeValue";
+    SqlPrintTokenContainerType["TupleExpression"] = "TupleExpression";
+    SqlPrintTokenContainerType["WindowFrameExpression"] = "WindowFrameExpression";
+    SqlPrintTokenContainerType["SelectItem"] = "SelectItem";
+    SqlPrintTokenContainerType["SelectClause"] = "SelectClause";
+    SqlPrintTokenContainerType["DistinctOn"] = "DistinctOn";
+    SqlPrintTokenContainerType["SourceExpression"] = "SourceExpression";
+    SqlPrintTokenContainerType["FromClause"] = "FromClause";
+    SqlPrintTokenContainerType["JoinClause"] = "JoinClause";
+    SqlPrintTokenContainerType["JoinOnClause"] = "JoinOnClause";
+    SqlPrintTokenContainerType["JoinUsingClause"] = "JoinUsingClause";
+    SqlPrintTokenContainerType["FunctionSource"] = "FunctionSource";
+    SqlPrintTokenContainerType["SourceAliasExpression"] = "SourceAliasExpression";
+    SqlPrintTokenContainerType["RawString"] = "RawString";
+    SqlPrintTokenContainerType["QualifiedName"] = "QualifiedName";
+    SqlPrintTokenContainerType["WhereClause"] = "WhereClause";
+    SqlPrintTokenContainerType["SimpleSelectQuery"] = "SimpleSelectQuery";
+    SqlPrintTokenContainerType["OrderByClause"] = "OrderByClause";
+    SqlPrintTokenContainerType["GroupByClause"] = "GroupByClause";
+    SqlPrintTokenContainerType["HavingClause"] = "HavingClause";
+    SqlPrintTokenContainerType["SubQuerySource"] = "SubQuerySource";
+    SqlPrintTokenContainerType["PartitionByClause"] = "PartitionByClause";
+    SqlPrintTokenContainerType["WindowFrameClause"] = "WindowFrameClause";
+    SqlPrintTokenContainerType["LimitClause"] = "LimitClause";
+    SqlPrintTokenContainerType["OffsetClause"] = "OffsetClause";
+    SqlPrintTokenContainerType["ForClause"] = "ForClause";
+    SqlPrintTokenContainerType["WindowClause"] = "WindowClause";
+    SqlPrintTokenContainerType["BinarySelectQueryOperator"] = "BinarySelectQueryOperator";
+    SqlPrintTokenContainerType["Values"] = "Values";
+    SqlPrintTokenContainerType["ValuesQuery"] = "ValuesQuery";
+    SqlPrintTokenContainerType["WithClause"] = "WithClause";
+    SqlPrintTokenContainerType["CommonTable"] = "CommonTable";
+    SqlPrintTokenContainerType["WindowFrameSpec"] = "WindowFrameSpec";
+    SqlPrintTokenContainerType["WindowFrameBoundStatic"] = "WindowFrameBoundStatic";
+    SqlPrintTokenContainerType["WindowFrameBoundaryValue"] = "WindowFrameBoundaryValue";
+    SqlPrintTokenContainerType["FetchClause"] = "FetchClause";
+    SqlPrintTokenContainerType["FetchExpression"] = "FetchExpression";
+    SqlPrintTokenContainerType["InsertQuery"] = "InsertQuery";
+    SqlPrintTokenContainerType["InsertClause"] = "InsertClause";
+    SqlPrintTokenContainerType["UpdateQuery"] = "UpdateQuery";
+    SqlPrintTokenContainerType["UpdateClause"] = "UpdateClause";
+    SqlPrintTokenContainerType["DeleteQuery"] = "DeleteQuery";
+    SqlPrintTokenContainerType["DeleteClause"] = "DeleteClause";
+    SqlPrintTokenContainerType["UsingClause"] = "UsingClause";
+    SqlPrintTokenContainerType["ReturningClause"] = "ReturningClause";
+    SqlPrintTokenContainerType["SetClause"] = "SetClause";
+    SqlPrintTokenContainerType["SetClauseItem"] = "SetClauseItem";
+    SqlPrintTokenContainerType["CreateTableQuery"] = "CreateTableQuery";
+    SqlPrintTokenContainerType["CreateTableDefinition"] = "CreateTableDefinition";
+    SqlPrintTokenContainerType["TableColumnDefinition"] = "TableColumnDefinition";
+    SqlPrintTokenContainerType["ColumnConstraintDefinition"] = "ColumnConstraintDefinition";
+    SqlPrintTokenContainerType["TableConstraintDefinition"] = "TableConstraintDefinition";
+    SqlPrintTokenContainerType["ReferenceDefinition"] = "ReferenceDefinition";
+    SqlPrintTokenContainerType["CreateIndexStatement"] = "CreateIndexStatement";
+    SqlPrintTokenContainerType["IndexColumnList"] = "IndexColumnList";
+    SqlPrintTokenContainerType["IndexColumnDefinition"] = "IndexColumnDefinition";
+    SqlPrintTokenContainerType["DropTableStatement"] = "DropTableStatement";
+    SqlPrintTokenContainerType["DropIndexStatement"] = "DropIndexStatement";
+    SqlPrintTokenContainerType["AlterTableStatement"] = "AlterTableStatement";
+    SqlPrintTokenContainerType["AlterTableAddConstraint"] = "AlterTableAddConstraint";
+    SqlPrintTokenContainerType["AlterTableDropConstraint"] = "AlterTableDropConstraint";
+    SqlPrintTokenContainerType["AlterTableAddColumn"] = "AlterTableAddColumn";
+    SqlPrintTokenContainerType["AlterTableDropColumn"] = "AlterTableDropColumn";
+    SqlPrintTokenContainerType["DropConstraintStatement"] = "DropConstraintStatement";
+    SqlPrintTokenContainerType["ExplainStatement"] = "ExplainStatement";
+    SqlPrintTokenContainerType["ExplainOption"] = "ExplainOption";
+    SqlPrintTokenContainerType["AnalyzeStatement"] = "AnalyzeStatement";
+    SqlPrintTokenContainerType["MergeQuery"] = "MergeQuery";
+    SqlPrintTokenContainerType["MergeWhenClause"] = "MergeWhenClause";
+    SqlPrintTokenContainerType["MergeUpdateAction"] = "MergeUpdateAction";
+    SqlPrintTokenContainerType["MergeDeleteAction"] = "MergeDeleteAction";
+    SqlPrintTokenContainerType["MergeInsertAction"] = "MergeInsertAction";
+    SqlPrintTokenContainerType["MergeDoNothingAction"] = "MergeDoNothingAction";
+    SqlPrintTokenContainerType["CommentBlock"] = "CommentBlock";
+    // Add more as needed
+})(SqlPrintTokenContainerType || (SqlPrintTokenContainerType = {}));
+export class SqlPrintToken {
+    constructor(type, text = '', containerType = SqlPrintTokenContainerType.None) {
+        /**
+         * Child tokens that belong to this container.
+         */
+        this.innerTokens = [];
+        this.type = type;
+        this.text = text;
+        this.containerType = containerType;
+    }
+    markAsHeaderComment() {
+        if (this.containerType !== SqlPrintTokenContainerType.CommentBlock) {
+            throw new Error('Header comment flag must only be applied to CommentBlock containers.');
+        }
+        this.isHeaderComment = true;
+    }
+}
+//# sourceMappingURL=SqlPrintToken.js.map

package/dist/esm/models/SqlPrintToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlPrintToken.js","sourceRoot":"","sources":["../../../src/models/SqlPrintToken.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iBAcX;AAdD,WAAY,iBAAiB;IACzB,mEAAa,CAAA;IACb,+DAAO,CAAA;IACP,2DAAK,CAAA;IACL,2DAAK,CAAA;IACL,uEAAW,CAAA;IACX,iEAAQ,CAAA;IACR,+DAAO,CAAA;IACP,mEAAS,CAAA;IACT,uDAAG,CAAA;IACH,yDAAI,CAAA;IACJ,4DAAK,CAAA;IACL,kFAAgB,CAAA;IAChB,8EAAc,CAAA;AAClB,CAAC,EAdW,iBAAiB,KAAjB,iBAAiB,QAc5B;AAED,2DAA2D;AAC3D,MAAM,CAAN,IAAY,0BAiGX;AAjGD,WAAY,0BAA0B;IAClC,iEAAmC,CAAA;IACnC,2DAA6B,CAAA;IAC7B,mEAAqC,CAAA;IACrC,yDAA2B,CAAA;IAC3B,qFAAuD,CAAA;IACvD,uCAAS,CAAA;IACT,qDAAuB,CAAA;IACvB,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,iEAAmC,CAAA;IACnC,mEAAqC,CAAA;IACrC,uEAAyC,CAAA;IACzC,uDAAyB,CAAA;IACzB,mEAAqC,CAAA;IACrC,6DAA+B,CAAA;IAC/B,6DAA+B,CAAA;IAC/B,iEAAmC,CAAA;IACnC,+DAAiC,CAAA;IACjC,+DAAiC,CAAA;IACjC,iEAAmC,CAAA;IACnC,qEAAuC,CAAA;IACvC,qDAAuB,CAAA;IACvB,iEAAmC,CAAA;IACnC,6EAA+C,CAAA;IAC/C,uDAAyB,CAAA;IACzB,2DAA6B,CAAA;IAC7B,uDAAyB,CAAA;IACzB,mEAAqC,CAAA;IACrC,uDAAyB,CAAA;IACzB,uDAAyB,CAAA;IACzB,2DAA6B,CAAA;IAC7B,iEAAmC,CAAA;IACnC,+DAAiC,CAAA;IACjC,6EAA+C,CAAA;IAC/C,qDAAuB,CAAA;IACvB,6DAA+B,CAAA;IAC/B,yDAA2B,CAAA;IAC3B,qEAAuC,CAAA;IACvC,6DAA+B,CAAA;IAC/B,6DAA+B,CAAA;IAC/B,2DAA6B,CAAA;IAC7B,+DAAiC,CAAA;IACjC,qEAAuC,CAAA;IACvC,qEAAuC,CAAA;IACvC,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,qDAAuB,CAAA;IACvB,2DAA6B,CAAA;IAC7B,qFAAuD,CAAA;IACvD,+CAAiB,CAAA;IACjB,yDAA2B,CAAA;IAC3B,uDAAyB,CAAA;IACzB,yDAA2B,CAAA;IAC3B,iEAAmC,CAAA;IACnC,+EAAiD,CAAA;IACjD,mFAAqD,CAAA;IACrD,yDAA2B,CAAA;IAC3B,iEAAmC,CAAA;IACnC,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,yDAA2B,CAAA;IAC3B,2DAA6B,CAAA;IAC7B,yDAA2B,CAAA;IAC3B,iEAAmC,CAAA;IACnC,qDAAuB,CAAA;IACvB,6DAA+B,CAAA;IAC/B,mEAAqC,CAAA;IACrC,6EAA+C,CAAA;IAC/C,6EAA+C,CAAA;IAC/C,uFAAyD,CAAA;IACzD,qFAAuD,CAAA;IACvD,yEAA2C,CAAA;IAC3C,2EAA6C,CAAA;IAC7C,iEAAmC,CAAA;IACnC,6EAA+C,CAAA;IAC/C,uEAAyC,CAAA;IACzC,uEAAyC,CAAA;IACzC,yEAA2C,CAAA;IAC3C,iFAAmD,CAAA;IACnD,mFAAqD,CAAA;IACrD,yEAA2C,CAAA;IAC3C,2EAA6C,CAAA;IAC7C,iFAAmD,CAAA;IACnD,mEAAqC,CAAA;IACrC,6DAA+B,CAAA;IAC/B,mEAAqC,CAAA;IACrC,uDAAyB,CAAA;IACzB,iEAAmC,CAAA;IACnC,qEAAuC,CAAA;IACvC,qEAAuC,CAAA;IACvC,qEAAuC,CAAA;IACvC,2EAA6C,CAAA;IAC7C,2DAA6B,CAAA;IAC7B,qBAAqB;AACzB,CAAC,EAjGW,0BAA0B,KAA1B,0BAA0B,QAiGrC;AAED,MAAM,OAAO,aAAa;IAgCtB,YAAY,IAAuB,EAAE,OAAe,EAAE,EAAE,gBAA4C,0BAA0B,CAAC,IAAI;QAZnI;;WAEG;QACH,gBAAW,GAAoB,EAAE,CAAC;QAU9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED,mBAAmB;QACf,IAAI,IAAI,CAAC,aAAa,KAAK,0BAA0B,CAAC,YAAY,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAChC,CAAC;CACJ"}

package/dist/esm/models/TableDefinitionModel.d.ts

@@ -0,0 +1,39 @@
+import type { ColumnDefinition, SchemaRegistry } from '../utils/SchemaManager';
+import type { ValueComponent } from './ValueComponent';
+import type { CreateTableQuery } from './CreateTableQuery';
+/**
+ * Column metadata that augments the SchemaManager definition with
+ * type, nullability, and default information for insert simulation.
+ */
+export interface TableColumnDefinitionModel extends ColumnDefinition {
+    /** SQL type that should be used when casting inserted values. */
+    typeName?: string;
+    /** Whether a value is required in the INSERT statement (NOT NULL without default). */
+    required?: boolean;
+    /** Expression text or AST from DDL that represents the column default, if any. */
+    defaultValue?: string | ValueComponent | null;
+}
+/**
+ * A description of a table that is rich enough to drive insert simulation.
+ */
+export interface TableDefinitionModel {
+    /** The actual name of the table (including schema if provided). */
+    name: string;
+    /** Columns in the order they are defined in the table. */
+    columns: TableColumnDefinitionModel[];
+}
+/** Registry keyed by table name (case-sensitive as provided by the caller). */
+export type TableDefinitionRegistry = Record<string, TableDefinitionModel>;
+/**
+ * Helper to reformat a SchemaManager registry into the format consumed
+ * by the insert-to-select transformer.
+ */
+export declare function createTableDefinitionRegistryFromSchema(schema: SchemaRegistry): TableDefinitionRegistry;
+/**
+ * Convert a parsed CREATE TABLE query into the table definition model used by transformers.
+ */
+export declare function createTableDefinitionFromCreateTableQuery(query: CreateTableQuery): TableDefinitionModel;
+/**
+ * Build a registry of table definitions from a batch of CREATE TABLE AST results.
+ */
+export declare function createTableDefinitionRegistryFromCreateTableQueries(queries: CreateTableQuery[]): TableDefinitionRegistry;

package/dist/esm/models/TableDefinitionModel.js

@@ -0,0 +1,77 @@
+import { RawString, TypeValue } from './ValueComponent';
+/**
+ * Helper to reformat a SchemaManager registry into the format consumed
+ * by the insert-to-select transformer.
+ */
+export function createTableDefinitionRegistryFromSchema(schema) {
+    const registry = {};
+    for (const table of Object.values(schema)) {
+        registry[table.name] = {
+            name: table.name,
+            columns: Object.entries(table.columns).map(([columnName, column]) => (Object.assign(Object.assign({}, column), { name: columnName })))
+        };
+    }
+    return registry;
+}
+const NOT_NULL_KINDS = new Set(['not-null', 'primary-key']);
+const IDENTITY_KINDS = new Set([
+    'generated-always-identity',
+    'generated-by-default-identity'
+]);
+function buildTableName(query) {
+    var _a;
+    const prefixes = (_a = query.namespaces) !== null && _a !== void 0 ? _a : [];
+    if (prefixes.length === 0) {
+        return query.tableName.name;
+    }
+    // Preserve schema qualifiers so INSERT references align with qualified DDL targets.
+    return `${prefixes.join('.')}.${query.tableName.name}`;
+}
+function getColumnTypeName(column) {
+    const dataType = column.dataType;
+    if (!dataType) {
+        return undefined;
+    }
+    if (dataType instanceof TypeValue) {
+        return dataType.getTypeName();
+    }
+    if (dataType instanceof RawString) {
+        return dataType.value;
+    }
+    return undefined;
+}
+function adaptColumn(column) {
+    var _a;
+    const defaultConstraint = column.constraints.find((constraint) => constraint.kind === 'default');
+    const hasDefault = Boolean(defaultConstraint);
+    const hasIdentity = column.constraints.some((constraint) => IDENTITY_KINDS.has(constraint.kind));
+    const hasNotNull = column.constraints.some((constraint) => NOT_NULL_KINDS.has(constraint.kind));
+    // Required columns must be NOT NULL/PRIMARY KEY and lack any automatic value coverage.
+    const required = hasNotNull && !hasDefault && !hasIdentity;
+    return {
+        name: column.name.name,
+        typeName: getColumnTypeName(column),
+        required,
+        defaultValue: (_a = defaultConstraint === null || defaultConstraint === void 0 ? void 0 : defaultConstraint.defaultValue) !== null && _a !== void 0 ? _a : null
+    };
+}
+/**
+ * Convert a parsed CREATE TABLE query into the table definition model used by transformers.
+ */
+export function createTableDefinitionFromCreateTableQuery(query) {
+    const qualifiedName = buildTableName(query);
+    const columns = query.columns.map((column) => adaptColumn(column));
+    return { name: qualifiedName, columns };
+}
+/**
+ * Build a registry of table definitions from a batch of CREATE TABLE AST results.
+ */
+export function createTableDefinitionRegistryFromCreateTableQueries(queries) {
+    const registry = {};
+    for (const query of queries) {
+        const definition = createTableDefinitionFromCreateTableQuery(query);
+        registry[definition.name] = definition;
+    }
+    return registry;
+}
+//# sourceMappingURL=TableDefinitionModel.js.map

package/dist/esm/models/TableDefinitionModel.js.map

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

package/dist/esm/models/UpdateQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateQuery.js","sourceRoot":"","sources":["../../../src/models/UpdateQuery.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,4DAA4D;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAA+B,SAAS,EAA+C,MAAM,UAAU,CAAC;AAG/G,MAAM,OAAO,WAAY,SAAQ,YAAY;IASzC;;;;;;OAMG;IAEH,YAAY,MAOX;;QACG,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,MAAA,MAAM,CAAC,UAAU,mCAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,YAAY,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5G,IAAI,CAAC,WAAW,GAAG,MAAA,MAAM,CAAC,WAAW,mCAAI,IAAI,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,MAAA,MAAM,CAAC,UAAU,mCAAI,IAAI,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,MAAA,MAAM,CAAC,SAAS,mCAAI,IAAI,CAAC;IACpD,CAAC;;AA/BM,gBAAI,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/dist/esm/models/ValueComponent.d.ts

@@ -0,0 +1,225 @@
+import { PartitionByClause, OrderByClause } from "./Clause";
+import { SelectQuery } from "./SelectQuery";
+import { SqlComponent } from "./SqlComponent";
+export type ValueComponent = ValueList | ColumnReference | FunctionCall | UnaryExpression | BinaryExpression | LiteralValue | ParameterExpression | SwitchCaseArgument | CaseKeyValuePair | RawString | IdentifierString | ParenExpression | CastExpression | CaseExpression | ArrayExpression | ArrayQueryExpression | ArraySliceExpression | ArrayIndexExpression | BetweenExpression | InlineQuery | StringSpecifierExpression | TypeValue | TupleExpression;
+export declare class InlineQuery extends SqlComponent {
+    static kind: symbol;
+    selectQuery: SelectQuery;
+    constructor(selectQuery: SelectQuery);
+}
+export declare class ValueList extends SqlComponent {
+    static kind: symbol;
+    values: ValueComponent[];
+    constructor(values: ValueComponent[]);
+}
+export declare class ColumnReference extends SqlComponent {
+    /**
+     * For backward compatibility: returns the namespaces as IdentifierString[] | null (readonly)
+     */
+    get namespaces(): IdentifierString[] | null;
+    /**
+     * For backward compatibility: returns the column name as IdentifierString (readonly)
+     */
+    get column(): IdentifierString;
+    static kind: symbol;
+    qualifiedName: QualifiedName;
+    constructor(namespaces: string | string[] | IdentifierString[] | null, column: string | IdentifierString);
+    toString(): string;
+    getNamespace(): string;
+}
+export declare class FunctionCall extends SqlComponent {
+    static kind: symbol;
+    qualifiedName: QualifiedName;
+    argument: ValueComponent | null;
+    over: OverExpression | null;
+    withinGroup: OrderByClause | null;
+    withOrdinality: boolean;
+    internalOrderBy: OrderByClause | null;
+    filterCondition: ValueComponent | null;
+    constructor(namespaces: string | string[] | IdentifierString[] | null, name: string | RawString | IdentifierString, argument: ValueComponent | null, over: OverExpression | null, withinGroup?: OrderByClause | null, withOrdinality?: boolean, internalOrderBy?: OrderByClause | null, filterCondition?: ValueComponent | null);
+    /**
+     * For backward compatibility: returns the namespaces as IdentifierString[] | null (readonly)
+     */
+    get namespaces(): IdentifierString[] | null;
+    /**
+     * For backward compatibility: returns the function name as RawString | IdentifierString (readonly)
+     */
+    get name(): RawString | IdentifierString;
+}
+export type OverExpression = WindowFrameExpression | IdentifierString;
+export declare enum WindowFrameType {
+    Rows = "rows",
+    Range = "range",
+    Groups = "groups"
+}
+export declare enum WindowFrameBound {
+    UnboundedPreceding = "unbounded preceding",
+    UnboundedFollowing = "unbounded following",
+    CurrentRow = "current row"
+}
+export type FrameBoundaryComponent = WindowFrameBoundStatic | WindowFrameBoundaryValue;
+export declare class WindowFrameBoundStatic extends SqlComponent {
+    static kind: symbol;
+    bound: WindowFrameBound;
+    constructor(bound: WindowFrameBound);
+}
+export declare class WindowFrameBoundaryValue extends SqlComponent {
+    static kind: symbol;
+    value: ValueComponent;
+    isFollowing: boolean;
+    constructor(value: ValueComponent, isFollowing: boolean);
+}
+export declare class WindowFrameSpec extends SqlComponent {
+    static kind: symbol;
+    frameType: WindowFrameType;
+    startBound: FrameBoundaryComponent;
+    endBound: FrameBoundaryComponent | null;
+    constructor(frameType: WindowFrameType, startBound: FrameBoundaryComponent, endBound: FrameBoundaryComponent | null);
+}
+export declare class WindowFrameExpression extends SqlComponent {
+    static kind: symbol;
+    partition: PartitionByClause | null;
+    order: OrderByClause | null;
+    frameSpec: WindowFrameSpec | null;
+    constructor(partition: PartitionByClause | null, order: OrderByClause | null, frameSpec?: WindowFrameSpec | null);
+}
+export declare class UnaryExpression extends SqlComponent {
+    static kind: symbol;
+    operator: RawString;
+    expression: ValueComponent;
+    constructor(operator: string, expression: ValueComponent);
+}
+export declare class BinaryExpression extends SqlComponent {
+    static kind: symbol;
+    left: ValueComponent;
+    operator: RawString;
+    right: ValueComponent;
+    constructor(left: ValueComponent, operator: string, right: ValueComponent);
+}
+export declare class LiteralValue extends SqlComponent {
+    static kind: symbol;
+    value: string | number | boolean | null;
+    isStringLiteral?: boolean;
+    constructor(value: string | number | boolean | null, _deprecated?: boolean, isStringLiteral?: boolean);
+}
+export type SqlParameterValue = string | number | boolean | Date | null | undefined | (string | number | Date)[];
+export declare class ParameterExpression extends SqlComponent {
+    static kind: symbol;
+    name: RawString;
+    value: SqlParameterValue;
+    /**
+     * The index assigned by the formatter when generating parameterized queries.
+     * Used for naming parameters like $1, $2, etc.
+     */
+    index: number | null;
+    constructor(name: string, value?: SqlParameterValue);
+}
+export declare class SwitchCaseArgument extends SqlComponent {
+    static kind: symbol;
+    cases: CaseKeyValuePair[];
+    elseValue: ValueComponent | null;
+    constructor(cases: CaseKeyValuePair[], elseValue?: ValueComponent | null);
+}
+export declare class CaseKeyValuePair extends SqlComponent {
+    static kind: symbol;
+    key: ValueComponent;
+    value: ValueComponent;
+    constructor(key: ValueComponent, value: ValueComponent);
+}
+export declare class RawString extends SqlComponent {
+    static kind: symbol;
+    value: string;
+    constructor(value: string);
+}
+export declare class IdentifierString extends SqlComponent {
+    static kind: symbol;
+    name: string;
+    constructor(alias: string);
+}
+export declare class ParenExpression extends SqlComponent {
+    static kind: symbol;
+    expression: ValueComponent;
+    constructor(expression: ValueComponent);
+}
+export declare class CastExpression extends SqlComponent {
+    static kind: symbol;
+    input: ValueComponent;
+    castType: TypeValue;
+    constructor(input: ValueComponent, castType: TypeValue);
+}
+export declare class CaseExpression extends SqlComponent {
+    static kind: symbol;
+    condition: ValueComponent | null;
+    switchCase: SwitchCaseArgument;
+    constructor(condition: ValueComponent | null, switchCase: SwitchCaseArgument);
+}
+export declare class ArrayExpression extends SqlComponent {
+    static kind: symbol;
+    expression: ValueComponent;
+    constructor(expression: ValueComponent);
+}
+export declare class ArrayQueryExpression extends SqlComponent {
+    static kind: symbol;
+    query: SelectQuery;
+    constructor(query: SelectQuery);
+}
+export declare class BetweenExpression extends SqlComponent {
+    static kind: symbol;
+    expression: ValueComponent;
+    lower: ValueComponent;
+    upper: ValueComponent;
+    negated: boolean;
+    constructor(expression: ValueComponent, lower: ValueComponent, upper: ValueComponent, negated: boolean);
+}
+export declare class StringSpecifierExpression extends SqlComponent {
+    static kind: symbol;
+    specifier: RawString;
+    value: LiteralValue;
+    constructor(specifier: string, value: string);
+}
+export declare class TypeValue extends SqlComponent {
+    static kind: symbol;
+    qualifiedName: QualifiedName;
+    argument: ValueComponent | null;
+    constructor(namespaces: string[] | IdentifierString[] | null, name: string | RawString | IdentifierString, argument?: ValueComponent | null);
+    /**
+     * For backward compatibility: returns the namespaces as IdentifierString[] | null (readonly)
+     */
+    get namespaces(): IdentifierString[] | null;
+    /**
+     * For backward compatibility: returns the type name as RawString | IdentifierString (readonly)
+     */
+    get name(): RawString | IdentifierString;
+    getTypeName(): string;
+}
+export declare class TupleExpression extends SqlComponent {
+    static kind: symbol;
+    values: ValueComponent[];
+    constructor(values: ValueComponent[]);
+}
+export declare class ArraySliceExpression extends SqlComponent {
+    static kind: symbol;
+    array: ValueComponent;
+    startIndex: ValueComponent | null;
+    endIndex: ValueComponent | null;
+    constructor(array: ValueComponent, startIndex: ValueComponent | null, endIndex: ValueComponent | null);
+}
+export declare class ArrayIndexExpression extends SqlComponent {
+    static kind: symbol;
+    array: ValueComponent;
+    index: ValueComponent;
+    constructor(array: ValueComponent, index: ValueComponent);
+}
+/**
+ * Represents a qualified name with optional namespaces (e.g. schema.table, db.schema.function)
+ */
+export declare class QualifiedName extends SqlComponent {
+    static kind: symbol;
+    /** List of namespaces (e.g. schema, database) */
+    namespaces: IdentifierString[] | null;
+    /** The actual name (e.g. table, function, type, column) */
+    name: RawString | IdentifierString;
+    constructor(namespaces: string | string[] | IdentifierString[] | null, name: string | RawString | IdentifierString);
+    /** Returns the full qualified name as a string (dot-separated) */
+    toString(): string;
+}