tplm-lang 0.3.1 → 0.3.3

package/README.md

@@ -84,6 +84,16 @@ const tpl = fromBigQueryTable({
   credentialsPath: "./credentials.json",
 });
 
+// Pre-built connection (any Malloy Connection instance)
+import { fromConnection } from "tplm-lang";
+import { BigQueryConnection } from "@malloydata/db-bigquery";
+const conn = new BigQueryConnection("bigquery", {}, { credentials });
+const tpl = fromConnection({
+  connection: conn,
+  table: "project.dataset.sales",
+  dialect: "bigquery",
+});
+
 // Then query the same way
 const { html } = await tpl.query("TABLE ROWS region * revenue.sum;");
 ```
@@ -184,18 +194,29 @@ COLS education * (revenue.sum ACROSS COLS | revenue.mean)
 ### Easy Connectors (Recommended)
 
 ```typescript
-import { fromCSV, fromDuckDBTable, fromBigQueryTable } from "tplm-lang";
+import {
+  fromCSV, fromDuckDBTable, fromBigQueryTable, fromConnection
+} from "tplm-lang";
 
 // CSV or Parquet files
 const tpl = fromCSV("data/sales.csv");
 const tpl = fromDuckDBTable("data/sales.parquet");
 
-// BigQuery
+// BigQuery (file-based credentials)
 const tpl = fromBigQueryTable({
   table: "project.dataset.sales",
   credentialsPath: "./credentials.json",
 });
 
+// Pre-built connection (inject any Malloy Connection instance)
+import { BigQueryConnection } from "@malloydata/db-bigquery";
+const conn = new BigQueryConnection("bigquery", {}, { credentials });
+const tpl = fromConnection({
+  connection: conn,
+  table: "project.dataset.sales",
+  dialect: "bigquery", // or "duckdb"
+});
+
 // Add computed dimensions with .extend()
 const tplWithDims = tpl.extend(`
   dimension: region is pick 'North' when region_code = 1 else 'South'

package/dist/compiler/grid-spec-builder.js

@@ -12,6 +12,58 @@
 import { collectBranches, } from "./table-spec.js";
 // Module-level reference to ordering provider for definition-order sorting
 let currentOrderingProvider;
+// ---
+// DATE NORMALIZATION
+// ---
+/**
+ * Normalize a raw data value: converts Date objects to formatted strings
+ * so they display cleanly as headers and work correctly with Set-based
+ * deduplication and value-based cell lookup.
+ *
+ * Dates at midnight UTC (date-only) become "YYYY-MM-DD".
+ * Timestamps with a time component become "YYYY-MM-DD HH:MM:SS".
+ */
+function normalizeDimValue(value) {
+    if (value instanceof Date) {
+        const iso = value.toISOString();
+        return iso.endsWith("T00:00:00.000Z")
+            ? iso.slice(0, 10)
+            : iso.slice(0, 19).replace("T", " ");
+    }
+    return value;
+}
+/**
+ * Recursively normalize all Date values in query result rows.
+ * This ensures Date objects are converted to formatted strings before
+ * any downstream processing (header extraction, cell indexing, etc.).
+ */
+function normalizeResultRow(row) {
+    const normalized = {};
+    for (const key of Object.keys(row)) {
+        const val = row[key];
+        if (Array.isArray(val)) {
+            normalized[key] = val.map((item) => item && typeof item === "object" && !Array.isArray(item) && !(item instanceof Date)
+                ? normalizeResultRow(item)
+                : normalizeDimValue(item));
+        }
+        else {
+            normalized[key] = normalizeDimValue(val);
+        }
+    }
+    return normalized;
+}
+/**
+ * Normalize all Date objects in query results to formatted strings.
+ * Applied once at the entry point so all downstream code sees
+ * consistent string values instead of raw Date objects.
+ */
+function normalizeQueryResults(results) {
+    const normalized = new Map();
+    for (const [queryId, rows] of results) {
+        normalized.set(queryId, rows.map(normalizeResultRow));
+    }
+    return normalized;
+}
 /**
  * Build a GridSpec from a TableSpec and query results.
  *
@@ -33,6 +85,10 @@ export function buildGridSpec(spec, plan, results, malloyQueriesOrOptions) {
     }
     // Set module-level ordering provider for definition-order sorting
     currentOrderingProvider = orderingProvider;
+    // Normalize Date objects in results to formatted strings before any processing.
+    // Malloy's toObject() returns JS Date objects for date/timestamp columns, which
+    // cause issues with Set-based dedup, value comparison, and display formatting.
+    results = normalizeQueryResults(results);
     try {
         // Build maps of query ID to special handling flags
         const invertedQueries = new Set();

package/dist/executor/index.d.ts

@@ -50,6 +50,12 @@ export declare function createLocalConnection(): Promise<Connection>;
  */
 export declare function getConnection(): Promise<Connection>;
 export declare function getConnectionType(): ConnectionType | null;
+/**
+ * Inject a pre-built Malloy connection directly.
+ * Use this when you already have a configured Connection instance
+ * (e.g., a BigQueryConnection with in-memory credentials).
+ */
+export declare function setConnection(conn: Connection, type: ConnectionType): void;
 export declare function listDatasets(): Promise<string[]>;
 export declare function listTables(dataset: string): Promise<{
     name: string;
@@ -80,4 +86,4 @@ export declare function executeMalloy(malloySource: string, options?: ExecuteOpt
  */
 export declare function executeSQL(sql: string): Promise<any[]>;
 export { Runtime };
-export type { DuckDBConnection, BigQueryConnection };
+export type { Connection, DuckDBConnection, BigQueryConnection };

package/dist/executor/index.js

@@ -134,6 +134,16 @@ export function getConnectionType() {
     }
     return currentConnectionType;
 }
+/**
+ * Inject a pre-built Malloy connection directly.
+ * Use this when you already have a configured Connection instance
+ * (e.g., a BigQueryConnection with in-memory credentials).
+ */
+export function setConnection(conn, type) {
+    connectionInstance = conn;
+    currentConnectionType = type;
+    pendingOptions = null;
+}
 // ---
 // SCHEMA EXPLORATION (BigQuery only)
 // ---