@polyglot-sql/sdk 0.3.10 → 0.4.0

package/dist/index.cjs

@@ -96,32 +96,35 @@ class WasmCaseBuilder {
     return this;
   }
   /**
-   * Generate SQL string (generic dialect).
+   * Generate SQL string for the given dialect.
+   * @param {string} dialect
    * @returns {string}
    */
-  to_sql() {
-    let deferred2_0;
-    let deferred2_1;
+  to_sql(dialect) {
+    let deferred3_0;
+    let deferred3_1;
     try {
       const retptr = wasm$3.__wbindgen_add_to_stack_pointer(-16);
-      wasm$3.wasmcasebuilder_to_sql(retptr, this.__wbg_ptr);
+      const ptr0 = passStringToWasm0(dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+      const len0 = WASM_VECTOR_LEN;
+      wasm$3.wasmcasebuilder_to_sql(retptr, this.__wbg_ptr, ptr0, len0);
       var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
       var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
       var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
       var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
-      var ptr1 = r0;
-      var len1 = r1;
+      var ptr2 = r0;
+      var len2 = r1;
       if (r3) {
-        ptr1 = 0;
-        len1 = 0;
+        ptr2 = 0;
+        len2 = 0;
         throw takeObject(r2);
       }
-      deferred2_0 = ptr1;
-      deferred2_1 = len1;
-      return getStringFromWasm0(ptr1, len1);
+      deferred3_0 = ptr2;
+      deferred3_1 = len2;
+      return getStringFromWasm0(ptr2, len2);
     } finally {
       wasm$3.__wbindgen_add_to_stack_pointer(16);
-      wasm$3.__wbindgen_export4(deferred2_0, deferred2_1, 1);
+      wasm$3.__wbindgen_export4(deferred3_0, deferred3_1, 1);
     }
   }
   /**
@@ -502,32 +505,35 @@ class WasmExpr {
     }
   }
   /**
-   * Generate SQL string (generic dialect).
+   * Generate SQL string for the given dialect.
+   * @param {string} dialect
    * @returns {string}
    */
-  to_sql() {
-    let deferred2_0;
-    let deferred2_1;
+  to_sql(dialect) {
+    let deferred3_0;
+    let deferred3_1;
     try {
       const retptr = wasm$3.__wbindgen_add_to_stack_pointer(-16);
-      wasm$3.wasmexpr_to_sql(retptr, this.__wbg_ptr);
+      const ptr0 = passStringToWasm0(dialect, wasm$3.__wbindgen_export, wasm$3.__wbindgen_export2);
+      const len0 = WASM_VECTOR_LEN;
+      wasm$3.wasmexpr_to_sql(retptr, this.__wbg_ptr, ptr0, len0);
       var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
       var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
       var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
       var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
-      var ptr1 = r0;
-      var len1 = r1;
+      var ptr2 = r0;
+      var len2 = r1;
       if (r3) {
-        ptr1 = 0;
-        len1 = 0;
+        ptr2 = 0;
+        len2 = 0;
         throw takeObject(r2);
       }
-      deferred2_0 = ptr1;
-      deferred2_1 = len1;
-      return getStringFromWasm0(ptr1, len1);
+      deferred3_0 = ptr2;
+      deferred3_1 = len2;
+      return getStringFromWasm0(ptr2, len2);
     } finally {
       wasm$3.__wbindgen_add_to_stack_pointer(16);
-      wasm$3.__wbindgen_export4(deferred2_0, deferred2_1, 1);
+      wasm$3.__wbindgen_export4(deferred3_0, deferred3_1, 1);
     }
   }
   /**
@@ -2031,6 +2037,66 @@ function lineage_sql_with_schema$1(sql, column, schema_json, dialect, trim_selec
     wasm$3.__wbindgen_export4(deferred5_0, deferred5_1, 1);
   }
 }
+function openlineage_column_lineage$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.openlineage_column_lineage(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);
+  }
+}
+function openlineage_job_event$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.openlineage_job_event(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);
+  }
+}
+function openlineage_run_event$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.openlineage_run_event(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);
+  }
+}
 function parse$2(sql, dialect) {
   let deferred3_0;
   let deferred3_1;
@@ -2944,6 +3010,9 @@ async function __polyglot_init_wasm() {
   get_dialects_value = __vite__wasmModule.get_dialects_value;
   lineage_sql = __vite__wasmModule.lineage_sql;
   lineage_sql_with_schema = __vite__wasmModule.lineage_sql_with_schema;
+  openlineage_column_lineage = __vite__wasmModule.openlineage_column_lineage;
+  openlineage_job_event = __vite__wasmModule.openlineage_job_event;
+  openlineage_run_event = __vite__wasmModule.openlineage_run_event;
   parse$1 = __vite__wasmModule.parse;
   parse_value = __vite__wasmModule.parse_value;
   plan$1 = __vite__wasmModule.plan;
@@ -3132,6 +3201,9 @@ let get_dialects;
 let get_dialects_value;
 let lineage_sql;
 let lineage_sql_with_schema;
+let openlineage_column_lineage;
+let openlineage_job_event;
+let openlineage_run_event;
 let parse$1;
 let parse_value;
 let plan$1;
@@ -3323,6 +3395,9 @@ const wasm$2 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProper
   lineage_sql,
   lineage_sql_with_schema,
   memory,
+  openlineage_column_lineage,
+  openlineage_job_event,
+  openlineage_run_event,
   parse: parse$1,
   parse_value,
   plan: plan$1,
@@ -3504,6 +3579,9 @@ const wasmModule = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePr
   get_dialects_value: get_dialects_value$1,
   lineage_sql: lineage_sql$1,
   lineage_sql_with_schema: lineage_sql_with_schema$1,
+  openlineage_column_lineage: openlineage_column_lineage$1,
+  openlineage_job_event: openlineage_job_event$1,
+  openlineage_run_event: openlineage_run_event$1,
   parse: parse$2,
   parse_value: parse_value$1,
   plan: plan$2,
@@ -4381,9 +4459,9 @@ class Expr {
     return new Expr(this._w.desc());
   }
   // -- Output --
-  /** Generate SQL string (generic dialect). */
-  toSql() {
-    return this._w.to_sql();
+  /** Generate SQL string. Defaults to generic dialect. */
+  toSql(dialect = "generic") {
+    return this._w.to_sql(dialect);
   }
   /** Return the expression AST as a plain JS object. */
   toJSON() {
@@ -4919,9 +4997,9 @@ class CaseBuilder {
   build() {
     return new Expr(this._w.build_expr());
   }
-  /** Generate SQL string (generic dialect). */
-  toSql() {
-    return this._w.to_sql();
+  /** Generate SQL string. Defaults to generic dialect. */
+  toSql(dialect = "generic") {
+    return this._w.to_sql(dialect);
   }
 }
 function caseWhen() {
@@ -5146,6 +5224,34 @@ function getSourceTables(column, sql, dialect = "generic") {
   const resultJson = source_tables$1(sql, column, dialect);
   return JSON.parse(resultJson);
 }
+function normalizeOptions(options) {
+  return {
+    dialect: "generic",
+    datasetMappings: {},
+    ...options
+  };
+}
+function openLineageColumnLineage(sql, options) {
+  const resultJson = openlineage_column_lineage$1(
+    sql,
+    JSON.stringify(normalizeOptions(options))
+  );
+  return JSON.parse(resultJson);
+}
+function openLineageJobEvent(sql, options) {
+  const resultJson = openlineage_job_event$1(
+    sql,
+    JSON.stringify(normalizeOptions(options))
+  );
+  return JSON.parse(resultJson);
+}
+function openLineageRunEvent(sql, options) {
+  const resultJson = openlineage_run_event$1(
+    sql,
+    JSON.stringify(normalizeOptions(options))
+  );
+  return JSON.parse(resultJson);
+}
 function diff(source, target, dialect = "generic", options = {}) {
   const { deltaOnly = false, f = 0.6, t = 0.6 } = options;
   const resultJson = diff_sql$1(source, target, dialect, deltaOnly, f, t);
@@ -5439,6 +5545,9 @@ const index = {
   lineage,
   lineageWithSchema,
   getSourceTables,
+  openLineageColumnLineage,
+  openLineageJobEvent,
+  openLineageRunEvent,
   diff,
   hasChanges,
   changesOnly,
@@ -5524,6 +5633,9 @@ exports.mergeInto = mergeInto;
 exports.min = min;
 exports.not = not;
 exports.nullIf = nullIf;
+exports.openLineageColumnLineage = openLineageColumnLineage;
+exports.openLineageJobEvent = openLineageJobEvent;
+exports.openLineageRunEvent = openLineageRunEvent;
 exports.or = or;
 exports.parse = parse;
 exports.plan = plan;

package/dist/index.d.cts

@@ -1384,8 +1384,8 @@ export declare class CaseBuilder {
     else_(result: ExprInput): this;
     /** Build the CASE expression as an Expr. */
     build(): Expr;
-    /** Generate SQL string (generic dialect). */
-    toSql(): string;
+    /** Generate SQL string. Defaults to generic dialect. */
+    toSql(dialect?: string): string;
 }
 
 /** Create a simple CASE builder (CASE operand WHEN value THEN ...). */
@@ -3375,6 +3375,9 @@ declare const _default: {
     lineage: typeof lineage;
     lineageWithSchema: typeof lineageWithSchema;
     getSourceTables: typeof getSourceTables;
+    openLineageColumnLineage: typeof openLineageColumnLineage;
+    openLineageJobEvent: typeof openLineageJobEvent;
+    openLineageRunEvent: typeof openLineageRunEvent;
     diff: typeof diff;
     hasChanges: typeof hasChanges;
     changesOnly: typeof changesOnly;
@@ -4219,8 +4222,8 @@ export declare class Expr {
     cast(to: string): Expr;
     asc(): Expr;
     desc(): Expr;
-    /** Generate SQL string (generic dialect). */
-    toSql(): string;
+    /** Generate SQL string. Defaults to generic dialect. */
+    toSql(dialect?: string): string;
     /** Return the expression AST as a plain JS object. */
     toJSON(): any;
     /** Free the underlying WASM handle. */
@@ -9860,6 +9863,93 @@ declare type OpenJSONColumnDef = {
     data_type?: DataType | null;
 };
 
+/**
+ * Build a standalone OpenLineage columnLineage facet with input/output datasets.
+ */
+export declare function openLineageColumnLineage(sql: string, options: OpenLineageOptions): OpenLineageColumnLineageResult;
+
+export declare interface OpenLineageColumnLineageFacet {
+    _producer: string;
+    _schemaURL: string;
+    fields: Record<string, OpenLineageColumnLineageField>;
+}
+
+export declare interface OpenLineageColumnLineageField {
+    inputFields: OpenLineageInputField[];
+}
+
+export declare interface OpenLineageColumnLineageResult {
+    success: boolean;
+    facet?: OpenLineageColumnLineageFacet;
+    inputs?: OpenLineageDataset[];
+    outputs?: OpenLineageDataset[];
+    warnings: OpenLineageWarning[];
+    error?: string;
+}
+
+export declare interface OpenLineageDataset {
+    namespace: string;
+    name: string;
+    facets?: Record<string, unknown>;
+}
+
+export declare interface OpenLineageDatasetId {
+    namespace: string;
+    name: string;
+}
+
+export declare interface OpenLineageEventResult {
+    success: boolean;
+    event?: Record<string, unknown>;
+    warnings: OpenLineageWarning[];
+    error?: string;
+}
+
+export declare interface OpenLineageInputField {
+    namespace: string;
+    name: string;
+    field: string;
+    transformations?: OpenLineageTransformation[];
+}
+
+/**
+ * Build an OpenLineage JobEvent payload. This does not send the event.
+ */
+export declare function openLineageJobEvent(sql: string, options: OpenLineageOptions): OpenLineageEventResult;
+
+export declare interface OpenLineageOptions {
+    dialect?: string;
+    producer: string;
+    datasetNamespace?: string;
+    datasetMappings?: Record<string, OpenLineageDatasetId>;
+    outputDataset?: OpenLineageDatasetId;
+    schema?: Schema;
+    jobNamespace?: string;
+    jobName?: string;
+    eventTime?: string;
+    runId?: string;
+    eventType?: OpenLineageRunEventType;
+}
+
+/**
+ * Build an OpenLineage RunEvent payload. This does not send the event.
+ */
+export declare function openLineageRunEvent(sql: string, options: OpenLineageOptions): OpenLineageEventResult;
+
+export declare type OpenLineageRunEventType = 'START' | 'RUNNING' | 'COMPLETE' | 'ABORT' | 'FAIL' | 'OTHER';
+
+export declare interface OpenLineageTransformation {
+    type: 'DIRECT' | string;
+    subtype: 'IDENTITY' | 'TRANSFORMATION' | 'AGGREGATION' | string;
+    description?: string;
+    masking?: boolean;
+}
+
+export declare interface OpenLineageWarning {
+    code: string;
+    message: string;
+}
+
 /**
  * Operator
  */
@@ -14502,9 +14592,9 @@ declare class WasmCaseBuilder {
      */
     constructor();
     /**
-     * Generate SQL string (generic dialect).
+     * Generate SQL string for the given dialect.
      */
-    to_sql(): string;
+    to_sql(dialect: string): string;
     /**
      * Add a WHEN condition THEN result branch.
      */
@@ -14648,9 +14738,9 @@ declare class WasmExpr {
      */
     to_json(): any;
     /**
-     * Generate SQL string (generic dialect).
+     * Generate SQL string for the given dialect.
      */
-    to_sql(): string;
+    to_sql(dialect: string): string;
     /**
      * Produce `self XOR other`.
      */

package/dist/index.d.ts

@@ -1384,8 +1384,8 @@ export declare class CaseBuilder {
     else_(result: ExprInput): this;
     /** Build the CASE expression as an Expr. */
     build(): Expr;
-    /** Generate SQL string (generic dialect). */
-    toSql(): string;
+    /** Generate SQL string. Defaults to generic dialect. */
+    toSql(dialect?: string): string;
 }
 
 /** Create a simple CASE builder (CASE operand WHEN value THEN ...). */
@@ -3375,6 +3375,9 @@ declare const _default: {
     lineage: typeof lineage;
     lineageWithSchema: typeof lineageWithSchema;
     getSourceTables: typeof getSourceTables;
+    openLineageColumnLineage: typeof openLineageColumnLineage;
+    openLineageJobEvent: typeof openLineageJobEvent;
+    openLineageRunEvent: typeof openLineageRunEvent;
     diff: typeof diff;
     hasChanges: typeof hasChanges;
     changesOnly: typeof changesOnly;
@@ -4219,8 +4222,8 @@ export declare class Expr {
     cast(to: string): Expr;
     asc(): Expr;
     desc(): Expr;
-    /** Generate SQL string (generic dialect). */
-    toSql(): string;
+    /** Generate SQL string. Defaults to generic dialect. */
+    toSql(dialect?: string): string;
     /** Return the expression AST as a plain JS object. */
     toJSON(): any;
     /** Free the underlying WASM handle. */
@@ -9860,6 +9863,93 @@ declare type OpenJSONColumnDef = {
     data_type?: DataType | null;
 };
 
+/**
+ * Build a standalone OpenLineage columnLineage facet with input/output datasets.
+ */
+export declare function openLineageColumnLineage(sql: string, options: OpenLineageOptions): OpenLineageColumnLineageResult;
+
+export declare interface OpenLineageColumnLineageFacet {
+    _producer: string;
+    _schemaURL: string;
+    fields: Record<string, OpenLineageColumnLineageField>;
+}
+
+export declare interface OpenLineageColumnLineageField {
+    inputFields: OpenLineageInputField[];
+}
+
+export declare interface OpenLineageColumnLineageResult {
+    success: boolean;
+    facet?: OpenLineageColumnLineageFacet;
+    inputs?: OpenLineageDataset[];
+    outputs?: OpenLineageDataset[];
+    warnings: OpenLineageWarning[];
+    error?: string;
+}
+
+export declare interface OpenLineageDataset {
+    namespace: string;
+    name: string;
+    facets?: Record<string, unknown>;
+}
+
+export declare interface OpenLineageDatasetId {
+    namespace: string;
+    name: string;
+}
+
+export declare interface OpenLineageEventResult {
+    success: boolean;
+    event?: Record<string, unknown>;
+    warnings: OpenLineageWarning[];
+    error?: string;
+}
+
+export declare interface OpenLineageInputField {
+    namespace: string;
+    name: string;
+    field: string;
+    transformations?: OpenLineageTransformation[];
+}
+
+/**
+ * Build an OpenLineage JobEvent payload. This does not send the event.
+ */
+export declare function openLineageJobEvent(sql: string, options: OpenLineageOptions): OpenLineageEventResult;
+
+export declare interface OpenLineageOptions {
+    dialect?: string;
+    producer: string;
+    datasetNamespace?: string;
+    datasetMappings?: Record<string, OpenLineageDatasetId>;
+    outputDataset?: OpenLineageDatasetId;
+    schema?: Schema;
+    jobNamespace?: string;
+    jobName?: string;
+    eventTime?: string;
+    runId?: string;
+    eventType?: OpenLineageRunEventType;
+}
+
+/**
+ * Build an OpenLineage RunEvent payload. This does not send the event.
+ */
+export declare function openLineageRunEvent(sql: string, options: OpenLineageOptions): OpenLineageEventResult;
+
+export declare type OpenLineageRunEventType = 'START' | 'RUNNING' | 'COMPLETE' | 'ABORT' | 'FAIL' | 'OTHER';
+
+export declare interface OpenLineageTransformation {
+    type: 'DIRECT' | string;
+    subtype: 'IDENTITY' | 'TRANSFORMATION' | 'AGGREGATION' | string;
+    description?: string;
+    masking?: boolean;
+}
+
+export declare interface OpenLineageWarning {
+    code: string;
+    message: string;
+}
+
 /**
  * Operator
  */
@@ -14502,9 +14592,9 @@ declare class WasmCaseBuilder {
      */
     constructor();
     /**
-     * Generate SQL string (generic dialect).
+     * Generate SQL string for the given dialect.
      */
-    to_sql(): string;
+    to_sql(dialect: string): string;
     /**
      * Add a WHEN condition THEN result branch.
      */
@@ -14648,9 +14738,9 @@ declare class WasmExpr {
      */
     to_json(): any;
     /**
-     * Generate SQL string (generic dialect).
+     * Generate SQL string for the given dialect.
      */
-    to_sql(): string;
+    to_sql(dialect: string): string;
     /**
      * Produce `self XOR other`.
      */