tplm-lang 0.3.2 → 0.3.4

package/dist/index.d.ts

@@ -34,9 +34,10 @@ export { buildTableSpec, generateQueryPlan, generateMalloyQueries, buildGridSpec
 export type { TableSpec, QueryPlan, GridSpec, HeaderNode, QueryResults, MalloyQuerySpec, } from './compiler/index.js';
 export { renderGridToHTML } from './renderer/index.js';
 export type { GridRenderOptions } from './renderer/index.js';
-export { createConnection, createLocalConnection, getConnection, getConnectionType, getDefaultSource, executeMalloy, executeSQL, setPendingConnection, } from './executor/index.js';
-export type { ConnectionType, ConnectionOptions, BigQueryConnectionOptions, DuckDBConnectionOptions, ExecuteOptions, } from './executor/index.js';
+export { createConnection, createLocalConnection, getConnection, getConnectionType, getDefaultSource, executeMalloy, executeSQL, setPendingConnection, setConnection, } from './executor/index.js';
+export type { Connection, ConnectionType, ConnectionOptions, BigQueryConnectionOptions, DuckDBConnectionOptions, ExecuteOptions, } from './executor/index.js';
 import type { TableSpec, QueryPlan, GridSpec, MalloyQuerySpec } from './compiler/index.js';
+import type { Connection } from './executor/index.js';
 import type { DimensionOrderingProvider } from './compiler/dimension-utils.js';
 /**
  * Options for creating a TPL instance
@@ -186,6 +187,33 @@ export declare function fromBigQueryTable(options: {
     credentialsPath?: string;
     projectId?: string;
 } & TPLOptions): EasyTPL;
+/**
+ * Query a table using a pre-built Malloy connection.
+ * Use this when you have an existing Connection instance (e.g., a
+ * BigQueryConnection constructed with in-memory credentials).
+ *
+ * @example
+ * ```typescript
+ * import { BigQueryConnection } from '@malloydata/db-bigquery';
+ * import { fromConnection } from 'tplm-lang';
+ *
+ * const connection = new BigQueryConnection('bigquery', undefined, {
+ *   projectId: 'my-project',
+ *   credentials: { client_email, private_key },
+ * });
+ *
+ * const tpl = fromConnection({
+ *   connection,
+ *   table: 'my-project.my_dataset.sales',
+ * });
+ * const { html } = await tpl.query('TABLE ROWS region * revenue.sum COLS quarter;');
+ * ```
+ */
+export declare function fromConnection(options: {
+    connection: Connection;
+    table: string;
+    dialect?: SqlDialect;
+} & TPLOptions): EasyTPL;
 /**
  * Extended options for EasyTPL that include percentile support metadata.
  */

package/dist/index.js

@@ -34,11 +34,11 @@ export { buildTableSpec, generateQueryPlan, generateMalloyQueries, buildGridSpec
 // renderer
 export { renderGridToHTML } from './renderer/index.js';
 // executor
-export { createConnection, createLocalConnection, getConnection, getConnectionType, getDefaultSource, executeMalloy, executeSQL, setPendingConnection, } from './executor/index.js';
+export { createConnection, createLocalConnection, getConnection, getConnectionType, getDefaultSource, executeMalloy, executeSQL, setPendingConnection, setConnection, } from './executor/index.js';
 // --- internal imports ---
 import { parse } from './parser/index.js';
 import { buildTableSpec, generateQueryPlan, generateMalloyQueries, buildGridSpec } from './compiler/index.js';
-import { executeMalloy, setPendingConnection, } from './executor/index.js';
+import { executeMalloy, setPendingConnection, setConnection, } from './executor/index.js';
 import { renderGridToHTML } from './renderer/index.js';
 /**
  * High-level TPL API for parsing, compiling, executing, and rendering.
@@ -185,6 +185,41 @@ export function fromBigQueryTable(options) {
         dialect: 'bigquery',
     });
 }
+/**
+ * Query a table using a pre-built Malloy connection.
+ * Use this when you have an existing Connection instance (e.g., a
+ * BigQueryConnection constructed with in-memory credentials).
+ *
+ * @example
+ * ```typescript
+ * import { BigQueryConnection } from '@malloydata/db-bigquery';
+ * import { fromConnection } from 'tplm-lang';
+ *
+ * const connection = new BigQueryConnection('bigquery', undefined, {
+ *   projectId: 'my-project',
+ *   credentials: { client_email, private_key },
+ * });
+ *
+ * const tpl = fromConnection({
+ *   connection,
+ *   table: 'my-project.my_dataset.sales',
+ * });
+ * const { html } = await tpl.query('TABLE ROWS region * revenue.sum COLS quarter;');
+ * ```
+ */
+export function fromConnection(options) {
+    const dialect = options.dialect ?? 'bigquery';
+    const connType = dialect === 'duckdb' ? 'duckdb' : 'bigquery';
+    setConnection(options.connection, connType);
+    const sourceName = 'data';
+    const prefix = dialect === 'duckdb' ? 'duckdb' : 'bigquery';
+    const model = `source: ${sourceName} is ${prefix}.table('${options.table}')`;
+    return new EasyTPL(model, sourceName, {
+        ...options,
+        tablePath: options.table,
+        dialect,
+    });
+}
 // Import dimension utilities from compiler
 import { parseDimensionMappings, detectDimensionOrdering, } from './compiler/dimension-utils.js';
 /**

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "tplm-lang",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "TPLm - Table Producing Language backed by Malloy.",
   "type": "module",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     }
   },
   "files": [
     "dist/**/*.js",
+    "dist/**/*.cjs",
     "dist/**/*.d.ts",
     "packages/parser/tpl.pegjs",
     "packages/renderer/tpl-table.css",
@@ -21,7 +24,7 @@
   ],
   "scripts": {
     "build:parser": "peggy --format es packages/parser/tpl.pegjs -o packages/parser/parser.js && mkdir -p dist/parser && cp packages/parser/parser.js packages/parser/parser.d.ts dist/parser/",
-    "build": "npm run build:parser && tsc",
+    "build": "npm run build:parser && tsc && tsup",
     "test": "vitest",
     "test:run": "vitest run",
     "docs:dev": "cd docs-site && npm run docs:dev",
@@ -33,6 +36,7 @@
     "@malloydata/db-duckdb": "^0.0.326",
     "@types/node": "^20.0.0",
     "peggy": "^4.0.0",
+    "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.0.16"
   },