@polyglot-sql/sdk 0.4.4 → 0.5.1

package/dist/manual.js

@@ -1552,6 +1552,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(sql, options_json) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm$2.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(sql, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(options_json, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm$2.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$2.__wbindgen_add_to_stack_pointer(16);
+        wasm$2.__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(sql, options) {
+    const ptr0 = passStringToWasm0(sql, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm$2.analyze_query_value(ptr0, len0, addHeapObject(options));
+    return takeObject(ret);
+}
+
 /**
  * Annotate types on a parsed SQL AST in-place.
  *
@@ -2217,6 +2257,46 @@ function generate$1(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(data_type_json, dialect) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm$2.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(data_type_json, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(dialect, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm$2.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$2.__wbindgen_add_to_stack_pointer(16);
+        wasm$2.__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(data_type, dialect) {
+    const ptr0 = passStringToWasm0(dialect, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm$2.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
@@ -2462,6 +2542,48 @@ function parse$1(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(sql, dialect) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm$2.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(sql, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(dialect, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        wasm$2.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$2.__wbindgen_add_to_stack_pointer(16);
+        wasm$2.__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(sql, dialect) {
+    const ptr0 = passStringToWasm0(sql, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(dialect, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm$2.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
@@ -2654,6 +2776,58 @@ function transpile_value(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(sql, read_dialect, write_dialect, options_json) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const retptr = wasm$2.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(sql, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(read_dialect, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(write_dialect, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len2 = WASM_VECTOR_LEN;
+        const ptr3 = passStringToWasm0(options_json, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+        const len3 = WASM_VECTOR_LEN;
+        wasm$2.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$2.__wbindgen_add_to_stack_pointer(16);
+        wasm$2.__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(sql, read_dialect, write_dialect, options) {
+    const ptr0 = passStringToWasm0(sql, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(read_dialect, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+    const len1 = WASM_VECTOR_LEN;
+    const ptr2 = passStringToWasm0(write_dialect, wasm$2.__wbindgen_export, wasm$2.__wbindgen_export2);
+    const len2 = WASM_VECTOR_LEN;
+    const ret = wasm$2.transpile_with_options_value(ptr0, len0, ptr1, len1, ptr2, len2, addHeapObject(options));
+    return takeObject(ret);
+}
+
 /**
  * Validate SQL syntax.
  *
@@ -3642,6 +3816,8 @@ const wasmModule = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty
     WasmSetOpBuilder,
     WasmUpdateBuilder,
     WasmWindowDefBuilder,
+    analyze_query,
+    analyze_query_value,
     annotate_types,
     annotate_types_value,
     ast_add_where,
@@ -3667,6 +3843,8 @@ const wasmModule = /*#__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,
@@ -3679,6 +3857,8 @@ const wasmModule = /*#__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,
@@ -3686,6 +3866,8 @@ const wasmModule = /*#__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,
@@ -5443,20 +5625,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$1() {
   return Promise.resolve();
 }
 function isInitialized$1() {
   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)
@@ -5481,6 +5705,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") {
@@ -5510,6 +5752,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, {});
 }
@@ -5544,6 +5801,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) : "";
@@ -5589,8 +5870,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.
@@ -5598,6 +5879,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.
    */
@@ -5610,6 +5897,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.
    */
@@ -5641,16 +5934,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 autoDefault = {
   init: init$1,
   isInitialized: isInitialized$1,
   transpile,
   parse,
+  parseDataType,
   tokenize,
   generate,
+  generateDataType,
   format,
   annotateTypes,
+  analyzeQuery,
   getDialects,
   getVersion,
   lineage: lineage,
@@ -5679,4 +5981,4 @@ const manual = {
   isInitialized
 };
 
-export { CaseBuilder, DeleteBuilder, Dialect, Expr, InsertBuilder, MergeBuilder, Polyglot, SelectBuilder, SetOpBuilder, UpdateBuilder, ValidationSeverity, WindowDefBuilder, abs, alias, and, annotateTypes, index as ast, avg, boolean, caseOf, caseWhen, cast, ceil, changesOnly, coalesce, col, concatWs, condition, count, countDistinct, currentDate, currentTime, currentTimestamp, manual 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 as ast, avg, boolean, caseOf, caseWhen, cast, ceil, changesOnly, coalesce, col, concatWs, condition, count, countDistinct, currentDate, currentTime, currentTimestamp, manual 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polyglot-sql/sdk",
-  "version": "0.4.4",
+  "version": "0.5.1",
   "description": "SQL dialect translator powered by WebAssembly",
   "type": "module",
   "main": "./dist/index.cjs",