@polyglot-sql/sdk 0.4.4 → 0.5.1

package/dist/index.js

@@ -1592,6 +1592,46 @@ class WasmWindowDefBuilder {
 }
 if (Symbol.dispose) WasmWindowDefBuilder.prototype[Symbol.dispose] = WasmWindowDefBuilder.prototype.free;
 
+/**
+ * Return compact query analysis facts for a SELECT or set operation.
+ * @param {string} sql
+ * @param {string} options_json
+ * @returns {string}
+ */
+function analyze_query$1(sql, options_json) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm$3.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(sql, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(options_json, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm$3.analyze_query(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred3_0 = r0;
+        deferred3_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm$3.__wbindgen_add_to_stack_pointer(16);
+        wasm$3.__wbindgen_export4(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Return compact query analysis facts as a structured JS value.
+ * @param {string} sql
+ * @param {any} options
+ * @returns {any}
+ */
+function analyze_query_value$1(sql, options) {
+    const ptr0 = passStringToWasm0(sql, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm$3.analyze_query_value(ptr0, len0, addHeapObject(options));
+    return takeObject(ret);
+}
+
 /**
  * Annotate types on a parsed SQL AST in-place.
  *
@@ -2257,6 +2297,46 @@ function generate$2(ast_json, dialect) {
     }
 }
 
+/**
+ * Generate SQL from a standalone DataType JSON object.
+ * @param {string} data_type_json
+ * @param {string} dialect
+ * @returns {string}
+ */
+function generate_data_type$1(data_type_json, dialect) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm$3.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(data_type_json, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm$3.generate_data_type(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred3_0 = r0;
+        deferred3_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm$3.__wbindgen_add_to_stack_pointer(16);
+        wasm$3.__wbindgen_export4(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Generate SQL from a standalone DataType represented as a structured JS value.
+ * @param {any} data_type
+ * @param {string} dialect
+ * @returns {any}
+ */
+function generate_data_type_value$1(data_type, dialect) {
+    const ptr0 = passStringToWasm0(dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm$3.generate_data_type_value(addHeapObject(data_type), ptr0, len0);
+    return takeObject(ret);
+}
+
 /**
  * Generate SQL from an AST represented as a structured JS value.
  * @param {any} ast
@@ -2502,6 +2582,48 @@ function parse$2(sql, dialect) {
     }
 }
 
+/**
+ * Parse a standalone SQL data type and return a JSON string payload.
+ * @param {string} sql
+ * @param {string} dialect
+ * @returns {string}
+ */
+function parse_data_type$1(sql, dialect) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm$3.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(sql, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm$3.parse_data_type(retptr, ptr0, len0, ptr1, len1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred3_0 = r0;
+        deferred3_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm$3.__wbindgen_add_to_stack_pointer(16);
+        wasm$3.__wbindgen_export4(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Parse a standalone SQL data type and return a structured JS value payload.
+ * @param {string} sql
+ * @param {string} dialect
+ * @returns {any}
+ */
+function parse_data_type_value$1(sql, dialect) {
+    const ptr0 = passStringToWasm0(sql, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm$3.parse_data_type_value(ptr0, len0, ptr1, len1);
+    return takeObject(ret);
+}
+
 /**
  * Parse SQL and return a structured JS object with AST values.
  * @param {string} sql
@@ -2694,6 +2816,58 @@ function transpile_value$1(sql, read_dialect, write_dialect) {
     return takeObject(ret);
 }
 
+/**
+ * Transpile SQL with explicit options encoded as a JSON string.
+ * @param {string} sql
+ * @param {string} read_dialect
+ * @param {string} write_dialect
+ * @param {string} options_json
+ * @returns {string}
+ */
+function transpile_with_options$1(sql, read_dialect, write_dialect, options_json) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const retptr = wasm$3.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(sql, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(read_dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(write_dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passStringToWasm0(options_json, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+        const len3 = WASM_VECTOR_LEN;
+        wasm$3.transpile_with_options(retptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred5_0 = r0;
+        deferred5_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm$3.__wbindgen_add_to_stack_pointer(16);
+        wasm$3.__wbindgen_export4(deferred5_0, deferred5_1, 1);
+    }
+}
+
+/**
+ * Transpile SQL with explicit options and return a structured JS object.
+ * @param {string} sql
+ * @param {string} read_dialect
+ * @param {string} write_dialect
+ * @param {any} options
+ * @returns {any}
+ */
+function transpile_with_options_value$1(sql, read_dialect, write_dialect, options) {
+    const ptr0 = passStringToWasm0(sql, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(read_dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(write_dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm$3.transpile_with_options_value(ptr0, len0, ptr1, len1, ptr2, len2, addHeapObject(options));
+    return takeObject(ret);
+}
+
 /**
  * Validate SQL syntax.
  *
@@ -3626,6 +3800,8 @@ const __wbg_wasmselectbuilder_free = __vite__wasmModule.__wbg_wasmselectbuilder_
 const __wbg_wasmsetopbuilder_free = __vite__wasmModule.__wbg_wasmsetopbuilder_free;
 const __wbg_wasmupdatebuilder_free = __vite__wasmModule.__wbg_wasmupdatebuilder_free;
 const __wbg_wasmwindowdefbuilder_free = __vite__wasmModule.__wbg_wasmwindowdefbuilder_free;
+const analyze_query = __vite__wasmModule.analyze_query;
+const analyze_query_value = __vite__wasmModule.analyze_query_value;
 const annotate_types = __vite__wasmModule.annotate_types;
 const annotate_types_value = __vite__wasmModule.annotate_types_value;
 const ast_add_where = __vite__wasmModule.ast_add_where;
@@ -3651,6 +3827,8 @@ const format_sql_value = __vite__wasmModule.format_sql_value;
 const format_sql_with_options = __vite__wasmModule.format_sql_with_options;
 const format_sql_with_options_value = __vite__wasmModule.format_sql_with_options_value;
 const generate$1 = __vite__wasmModule.generate;
+const generate_data_type = __vite__wasmModule.generate_data_type;
+const generate_data_type_value = __vite__wasmModule.generate_data_type_value;
 const generate_value = __vite__wasmModule.generate_value;
 const get_dialects = __vite__wasmModule.get_dialects;
 const get_dialects_value = __vite__wasmModule.get_dialects_value;
@@ -3660,6 +3838,8 @@ const openlineage_column_lineage = __vite__wasmModule.openlineage_column_lineage
 const openlineage_job_event = __vite__wasmModule.openlineage_job_event;
 const openlineage_run_event = __vite__wasmModule.openlineage_run_event;
 const parse$1 = __vite__wasmModule.parse;
+const parse_data_type = __vite__wasmModule.parse_data_type;
+const parse_data_type_value = __vite__wasmModule.parse_data_type_value;
 const parse_value = __vite__wasmModule.parse_value;
 const plan$1 = __vite__wasmModule.plan;
 const source_tables = __vite__wasmModule.source_tables;
@@ -3667,6 +3847,8 @@ const tokenize$1 = __vite__wasmModule.tokenize;
 const tokenize_value = __vite__wasmModule.tokenize_value;
 const transpile$1 = __vite__wasmModule.transpile;
 const transpile_value = __vite__wasmModule.transpile_value;
+const transpile_with_options = __vite__wasmModule.transpile_with_options;
+const transpile_with_options_value = __vite__wasmModule.transpile_with_options_value;
 const validate$1 = __vite__wasmModule.validate;
 const validate_with_options = __vite__wasmModule.validate_with_options;
 const validate_with_schema = __vite__wasmModule.validate_with_schema;
@@ -3820,6 +4002,8 @@ const wasm$2 = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     __wbindgen_export2,
     __wbindgen_export3,
     __wbindgen_export4,
+    analyze_query,
+    analyze_query_value,
     annotate_types,
     annotate_types_value,
     ast_add_where,
@@ -3845,6 +4029,8 @@ const wasm$2 = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     format_sql_with_options,
     format_sql_with_options_value,
     generate: generate$1,
+    generate_data_type,
+    generate_data_type_value,
     generate_value,
     get_dialects,
     get_dialects_value,
@@ -3855,6 +4041,8 @@ const wasm$2 = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     openlineage_job_event,
     openlineage_run_event,
     parse: parse$1,
+    parse_data_type,
+    parse_data_type_value,
     parse_value,
     plan: plan$1,
     source_tables,
@@ -3862,6 +4050,8 @@ const wasm$2 = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     tokenize_value,
     transpile: transpile$1,
     transpile_value,
+    transpile_with_options,
+    transpile_with_options_value,
     validate: validate$1,
     validate_with_options,
     validate_with_schema,
@@ -4010,6 +4200,8 @@ const wasmModule = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty
     WasmSetOpBuilder,
     WasmUpdateBuilder,
     WasmWindowDefBuilder,
+    analyze_query: analyze_query$1,
+    analyze_query_value: analyze_query_value$1,
     annotate_types: annotate_types$1,
     annotate_types_value: annotate_types_value$1,
     ast_add_where: ast_add_where$1,
@@ -4035,6 +4227,8 @@ const wasmModule = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty
     format_sql_with_options: format_sql_with_options$1,
     format_sql_with_options_value: format_sql_with_options_value$1,
     generate: generate$2,
+    generate_data_type: generate_data_type$1,
+    generate_data_type_value: generate_data_type_value$1,
     generate_value: generate_value$1,
     get_dialects: get_dialects$1,
     get_dialects_value: get_dialects_value$1,
@@ -4044,6 +4238,8 @@ const wasmModule = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty
     openlineage_job_event: openlineage_job_event$1,
     openlineage_run_event: openlineage_run_event$1,
     parse: parse$2,
+    parse_data_type: parse_data_type$1,
+    parse_data_type_value: parse_data_type_value$1,
     parse_value: parse_value$1,
     plan: plan$2,
     source_tables: source_tables$1,
@@ -4051,6 +4247,8 @@ const wasmModule = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty
     tokenize_value: tokenize_value$1,
     transpile: transpile$2,
     transpile_value: transpile_value$1,
+    transpile_with_options: transpile_with_options$1,
+    transpile_with_options_value: transpile_with_options_value$1,
     validate: validate$2,
     validate_with_options: validate_with_options$1,
     validate_with_schema: validate_with_schema$1,
@@ -5808,20 +6006,62 @@ function parseFailure(context, error) {
     errorColumn: void 0
   };
 }
+function dataTypeFailure(context, error) {
+  return {
+    success: false,
+    dataType: void 0,
+    error: `WASM ${context} failed: ${errorMessage(error)}`,
+    errorLine: void 0,
+    errorColumn: void 0
+  };
+}
+function generateDataTypeFailure(context, error) {
+  return {
+    success: false,
+    sql: void 0,
+    error: `WASM ${context} failed: ${errorMessage(error)}`,
+    errorLine: void 0,
+    errorColumn: void 0
+  };
+}
 function decodeWasmPayload(payload) {
   if (typeof payload === "string") {
     return JSON.parse(payload);
   }
   return payload;
 }
+function queryAnalysisFailure(context, error) {
+  return {
+    success: false,
+    analysis: void 0,
+    error: `WASM ${context} failed: ${errorMessage(error)}`
+  };
+}
 async function init() {
   return Promise.resolve();
 }
 function isInitialized() {
   return true;
 }
-function transpile(sql, read, write) {
+function transpile(sql, read, write, options) {
   try {
+    if (options && Object.keys(options).length > 0) {
+      if (typeof wasm.transpile_with_options_value === "function") {
+        return decodeWasmPayload(
+          wasm.transpile_with_options_value(sql, read, write, options)
+        );
+      }
+      if (typeof wasm.transpile_with_options === "function") {
+        return JSON.parse(
+          wasm.transpile_with_options(sql, read, write, JSON.stringify(options))
+        );
+      }
+      return {
+        success: false,
+        sql: void 0,
+        error: "WASM transpile options are not available in this build"
+      };
+    }
     if (typeof wasm.transpile_value === "function") {
       return decodeWasmPayload(
         wasm.transpile_value(sql, read, write)
@@ -5846,6 +6086,24 @@ function parse(sql, dialect = "generic" /* Generic */) {
     return parseFailure("parse", error);
   }
 }
+function parseDataType(sql, dialect = "generic" /* Generic */) {
+  try {
+    if (typeof wasm.parse_data_type_value === "function") {
+      return decodeWasmPayload(
+        wasm.parse_data_type_value(sql, dialect)
+      );
+    }
+    const result = JSON.parse(
+      wasm.parse_data_type(sql, dialect)
+    );
+    if (result.success && typeof result.dataType === "string") {
+      result.dataType = JSON.parse(result.dataType);
+    }
+    return result;
+  } catch (error) {
+    return dataTypeFailure("parseDataType", error);
+  }
+}
 function tokenize(sql, dialect = "generic" /* Generic */) {
   try {
     if (typeof wasm.tokenize_value === "function") {
@@ -5875,6 +6133,21 @@ function generate(ast2, dialect = "generic" /* Generic */) {
     return transpileFailure("generate", error);
   }
 }
+function generateDataType(dataType, dialect = "generic" /* Generic */) {
+  try {
+    if (typeof wasm.generate_data_type_value === "function") {
+      return decodeWasmPayload(
+        wasm.generate_data_type_value(dataType, dialect)
+      );
+    }
+    const dataTypeJson = JSON.stringify(dataType);
+    return JSON.parse(
+      wasm.generate_data_type(dataTypeJson, dialect)
+    );
+  } catch (error) {
+    return generateDataTypeFailure("generateDataType", error);
+  }
+}
 function format(sql, dialect = "generic" /* Generic */) {
   return formatWithOptions(sql, dialect, {});
 }
@@ -5909,6 +6182,30 @@ function getDialects() {
 function getVersion() {
   return wasm.version();
 }
+function analyzeQuery(sql, options = {}) {
+  try {
+    const normalized = {
+      dialect: "generic" /* Generic */,
+      ...options
+    };
+    if (typeof wasm.analyze_query_value === "function") {
+      return decodeWasmPayload(
+        wasm.analyze_query_value(sql, normalized)
+      );
+    }
+    if (typeof wasm.analyze_query === "function") {
+      return JSON.parse(
+        wasm.analyze_query(sql, JSON.stringify(normalized))
+      );
+    }
+    return {
+      success: false,
+      error: "analyze_query not available in this WASM build"
+    };
+  } catch (error) {
+    return queryAnalysisFailure("analyzeQuery", error);
+  }
+}
 function annotateTypes(sql, dialect = "generic" /* Generic */, schema) {
   try {
     const schemaJson = schema ? JSON.stringify(schema) : "";
@@ -5954,8 +6251,8 @@ class Polyglot {
    * Per-dialect builds only support same-dialect and to/from Generic transpilation.
    * Use {@link Polyglot.getDialects} to check available dialects.
    */
-  transpile(sql, read, write) {
-    return transpile(sql, read, write);
+  transpile(sql, read, write, options) {
+    return transpile(sql, read, write, options);
   }
   /**
    * Parse SQL into an AST.
@@ -5963,6 +6260,12 @@ class Polyglot {
   parse(sql, dialect = "generic" /* Generic */) {
     return parse(sql, dialect);
   }
+  /**
+   * Parse a standalone SQL data type.
+   */
+  parseDataType(sql, dialect = "generic" /* Generic */) {
+    return parseDataType(sql, dialect);
+  }
   /**
    * Tokenize SQL into a token stream.
    */
@@ -5975,6 +6278,12 @@ class Polyglot {
   generate(ast2, dialect = "generic" /* Generic */) {
     return generate(ast2, dialect);
   }
+  /**
+   * Generate SQL from a standalone DataType AST node.
+   */
+  generateDataType(dataType, dialect = "generic" /* Generic */) {
+    return generateDataType(dataType, dialect);
+  }
   /**
    * Format SQL.
    */
@@ -6006,16 +6315,25 @@ class Polyglot {
   annotateTypes(sql, dialect = "generic" /* Generic */, schema) {
     return annotateTypes(sql, dialect, schema);
   }
+  /**
+   * Return compact query analysis facts for a SELECT or set operation.
+   */
+  analyzeQuery(sql, options = {}) {
+    return analyzeQuery(sql, options);
+  }
 }
 const index = {
   init,
   isInitialized,
   transpile,
   parse,
+  parseDataType,
   tokenize,
   generate,
+  generateDataType,
   format,
   annotateTypes,
+  analyzeQuery,
   getDialects,
   getVersion,
   lineage: lineage,
@@ -6032,4 +6350,4 @@ const index = {
   Polyglot
 };
 
-export { CaseBuilder, DeleteBuilder, Dialect, Expr, InsertBuilder, MergeBuilder, Polyglot, SelectBuilder, SetOpBuilder, UpdateBuilder, ValidationSeverity, WindowDefBuilder, abs, alias, and, annotateTypes, index$1 as ast, avg, boolean, caseOf, caseWhen, cast, ceil, changesOnly, coalesce, col, concatWs, condition, count, countDistinct, currentDate, currentTime, currentTimestamp, index as default, del, deleteFrom, denseRank, diff, except, exp, extract, findAll, floor, format, formatWithOptions, func, generate, getColumns, getDialects, getInferredType, getSourceTables, getVersion, greatest, hasChanges, ifNull, init, initcap, insert, insertInto, intersect, isColumn, isFunction, isInitialized, isLiteral, isSelect, least, length, lineage, lineageWithSchema, lit, ln, lower, ltrim, max, mergeInto, min, not, nullIf, openLineageColumnLineage, openLineageJobEvent, openLineageRunEvent, or, parse, plan, power, rank, renameColumns, replace, reverse, round, rowNumber, rtrim, select, sign, sqlExpr, sqlNull, sqrt, star, subquery, substring, sum, table, tokenize, transform, transpile, trim, union, unionAll, update, upper, validate, validateWithSchema, walk };
+export { CaseBuilder, DeleteBuilder, Dialect, Expr, InsertBuilder, MergeBuilder, Polyglot, SelectBuilder, SetOpBuilder, UpdateBuilder, ValidationSeverity, WindowDefBuilder, abs, alias, analyzeQuery, and, annotateTypes, index$1 as ast, avg, boolean, caseOf, caseWhen, cast, ceil, changesOnly, coalesce, col, concatWs, condition, count, countDistinct, currentDate, currentTime, currentTimestamp, index as default, del, deleteFrom, denseRank, diff, except, exp, extract, findAll, floor, format, formatWithOptions, func, generate, generateDataType, getColumns, getDialects, getInferredType, getSourceTables, getVersion, greatest, hasChanges, ifNull, init, initcap, insert, insertInto, intersect, isColumn, isFunction, isInitialized, isLiteral, isSelect, least, length, lineage, lineageWithSchema, lit, ln, lower, ltrim, max, mergeInto, min, not, nullIf, openLineageColumnLineage, openLineageJobEvent, openLineageRunEvent, or, parse, parseDataType, plan, power, rank, renameColumns, replace, reverse, round, rowNumber, rtrim, select, sign, sqlExpr, sqlNull, sqrt, star, subquery, substring, sum, table, tokenize, transform, transpile, trim, union, unionAll, update, upper, validate, validateWithSchema, walk };