tplm-lang 0.3.2 → 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/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)
 // ---