@motherduck/wasm-client 0.8.1 → 1.5.2-r.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motherduck/wasm-client",
-  "version": "0.8.1",
+  "version": "1.5.2-r.2",
   "description": "Client library for MotherDuck-enabled DuckDB powered by WebAssembly (WASM)",
   "license": "MIT",
   "browser": "index.js",

package/types/@motherduck/wasm-extension/LoadMotherDuckWasmExtensionOptions.d.ts

@@ -41,6 +41,12 @@ export interface LoadMotherDuckWasmExtensionOptions {
      * Default: 'workspace' (attaches all available MotherDuck databases)
      */
     attachMode?: 'single' | 'workspace';
+    /**
+     * Set the MotherDuck session_name.
+     *
+     * See https://motherduck.com/docs/key-tasks/authenticating-and-connecting-to-motherduck/connecting-to-motherduck/#annotating-queries-with-session-names
+     */
+    sessionName?: string;
     /**
      * Skip the "welcome pack", the first message exchange between the MotherDuck client and server.
      */

package/types/@motherduck/wasm-extension/index.d.ts

@@ -1,5 +1,4 @@
 export * from './fetchMotherDuckExtensionVersion.js';
-export * from './fetchMotherDuckUIVersion.js';
 export * from './loadMotherDuckWasmExtension.js';
 export * from './LoadMotherDuckWasmExtensionOptions.js';
 export * from './MotherDuckEvent.js';

package/types/DuckDBInstance.d.ts

@@ -1,3 +1,9 @@
 import { AsyncDuckDB } from '././@duckdb/duckdb-wasm';
 export declare function getDuckDBInstance(): Promise<AsyncDuckDB> | AsyncDuckDB | null;
 export declare function setDuckDBInstance(instance: Promise<AsyncDuckDB> | AsyncDuckDB): void;
+export declare function clearDuckDBInstance(): void;
+/**
+ * Terminate the DuckDB WASM instance (kills the Web Worker + frees WASM memory)
+ * and clear the singleton so the next call to getAsyncDuckDb() re-initializes.
+ */
+export declare function terminateDuckDB(): Promise<void>;

package/types/MDConnection.d.ts

@@ -1,6 +1,6 @@
 import { AsyncPreparedStatement, ScriptTokens, TokenType } from '././@duckdb/duckdb-wasm';
-import { MDConnectionParams } from './MDConnectionParams';
-import { MaterializedQueryResult, SafePrepareResult, SafeQueryResult, StreamingQueryResult } from './QueryTypes';
+import { MDConnectionParams } from './MDConnectionParams.js';
+import { MaterializedQueryResult, SafePrepareResult, SafeQueryResult, StreamingQueryResult } from './QueryTypes.js';
 export { AsyncPreparedStatement, ScriptTokens, TokenType };
 export declare class MDConnection {
     readonly params: MDConnectionParams;
@@ -11,18 +11,18 @@ export declare class MDConnection {
     isInitialized(): Promise<boolean>;
     tokenize(text: string): Promise<ScriptTokens>;
     incompleteQueryCount(): number;
-    enqueueQuery(query: string, args?: any[]): string;
+    enqueueQuery(query: string, args?: unknown[]): string;
     safePrepareQuery(query: string): Promise<SafePrepareResult>;
     safeEvaluateQuery(query: string): Promise<SafeQueryResult<MaterializedQueryResult>>;
-    safeEvaluatePreparedStatement(query: string, ...args: any[]): Promise<SafeQueryResult<MaterializedQueryResult>>;
+    safeEvaluatePreparedStatement(query: string, ...args: unknown[]): Promise<SafeQueryResult<MaterializedQueryResult>>;
     safeEvaluateStreamingQuery(query: string): Promise<SafeQueryResult<StreamingQueryResult>>;
-    safeEvaluateStreamingPreparedStatement(query: string, args: any[]): Promise<SafeQueryResult<StreamingQueryResult>>;
+    safeEvaluateStreamingPreparedStatement(query: string, args: unknown[]): Promise<SafeQueryResult<StreamingQueryResult>>;
     safeEvaluateQueuedQuery(queryId: string): Promise<SafeQueryResult<MaterializedQueryResult>>;
     prepareQuery(query: string): Promise<AsyncPreparedStatement>;
     evaluateQuery(query: string): Promise<MaterializedQueryResult>;
-    evaluatePreparedStatement(query: string, args: any[]): Promise<MaterializedQueryResult>;
+    evaluatePreparedStatement(query: string, args: unknown[]): Promise<MaterializedQueryResult>;
     evaluateStreamingQuery(query: string): Promise<StreamingQueryResult>;
-    evaluateStreamingPreparedStatement(query: string, args: any[]): Promise<StreamingQueryResult>;
+    evaluateStreamingPreparedStatement(query: string, args: unknown[]): Promise<StreamingQueryResult>;
     private evaluateExclusive;
     evaluateQueuedQuery(queryId: string): Promise<MaterializedQueryResult>;
     cancelQuery(queryId: string, errorMessage?: string): Promise<boolean>;

package/types/MDConnectionParams.d.ts

@@ -1,4 +1,5 @@
 import { ConsoleLike } from '././@motherduck/task-sequencer';
+import { MDWasmEnvironement } from './environment.js';
 export { ConsoleLike };
 export interface MDConnectionParams {
     mdToken: string;
@@ -10,6 +11,10 @@ export interface MDConnectionParams {
     extensionVersion?: string;
     enableDebugLogging?: boolean;
     customUserAgent?: string;
+    databasePath?: string;
+    accessMode?: 'automatic' | 'read_only' | 'read_write';
     attachMode?: 'single' | 'workspace';
+    sessionName?: string;
     skipWelcomePack?: boolean;
+    mdWasmEnvironment?: MDWasmEnvironement;
 }

package/types/MaterializedQueryTask.d.ts

@@ -1,12 +1,12 @@
 import { AsyncDuckDBConnection } from '././@duckdb/duckdb-wasm';
 import { Task } from '././@motherduck/task-sequencer';
-import { MaterializedQueryResult } from './QueryTypes';
+import { MaterializedQueryResult } from './QueryTypes.js';
 export declare class MaterializedQueryTask implements Task<MaterializedQueryResult> {
     private connection;
     private deferredConnection;
     private query;
     private args?;
-    constructor(connection: Promise<AsyncDuckDBConnection>, query: string, args?: any[]);
+    constructor(connection: Promise<AsyncDuckDBConnection>, query: string, args?: unknown[]);
     run(): Promise<MaterializedQueryResult>;
     cancel(): Promise<boolean>;
     private getConnection;

package/types/StreamingQueryTask.d.ts

@@ -1,12 +1,12 @@
 import { AsyncDuckDBConnection } from '././@duckdb/duckdb-wasm';
 import { Task } from '././@motherduck/task-sequencer';
-import { StreamingQueryResult } from './QueryTypes';
+import { StreamingQueryResult } from './QueryTypes.js';
 export declare class StreamingQueryTask implements Task<StreamingQueryResult> {
     private connection;
     private deferredConnection;
     private query;
     private args?;
-    constructor(connection: Promise<AsyncDuckDBConnection>, query: string, args?: any[]);
+    constructor(connection: Promise<AsyncDuckDBConnection>, query: string, args?: unknown[]);
     run(): Promise<StreamingQueryResult>;
     cancel(): Promise<boolean>;
     private getConnection;

package/types/buildDuckDBBundleURLs.d.ts

@@ -0,0 +1,9 @@
+import { DuckDBBundles } from '././@duckdb/duckdb-wasm';
+/**
+ * Constructs DuckDB bundle URLs using the duckdb-wasm package version.
+ *
+ * Assets are served from the persistent store at
+ * `{baseUrl}/duckdb-wasm-assets/{version}/` with original filenames
+ * (e.g. `duckdb-eh.wasm`, `duckdb-browser-eh.worker.js`).
+ */
+export declare function buildDuckDBBundleURLs(baseUrl: string, includeCOI: boolean | undefined): DuckDBBundles;

package/types/createDuckDbConnection.d.ts

@@ -1,3 +1,3 @@
 import { AsyncDuckDBConnection } from '././@duckdb/duckdb-wasm';
-import { MDConnectionParams } from './MDConnectionParams';
+import { MDConnectionParams } from './MDConnectionParams.js';
 export declare function createDuckDbConnection(params: MDConnectionParams): Promise<AsyncDuckDBConnection>;

package/types/duckdbAccessModeFromString.d.ts

@@ -0,0 +1,2 @@
+import { DuckDBAccessMode } from '././@duckdb/duckdb-wasm';
+export declare function duckdbAccessModeFromString(input: string | undefined): DuckDBAccessMode | undefined;

package/types/environment.d.ts

@@ -0,0 +1,6 @@
+export type MDWasmEnvironmentVariable = 'MDWasmUseCooperativeNetwork';
+export type MDWasmEnvironement = Partial<Record<MDWasmEnvironmentVariable, string>>;
+export declare function createFragmentURLFromEnvironment(environment: MDWasmEnvironement): string;
+export declare function parseFragmentURLToEnvironment(fragment: string): {
+    [key: string]: string;
+};

package/types/getAsyncDuckDb.d.ts

@@ -1,4 +1,4 @@
 import { AsyncDuckDB } from '././@duckdb/duckdb-wasm';
-import { MDConnectionParams } from './MDConnectionParams';
+import { MDConnectionParams } from './MDConnectionParams.js';
 export { AsyncDuckDB };
 export declare function getAsyncDuckDb(params: MDConnectionParams): Promise<AsyncDuckDB>;

package/types/index.d.ts

@@ -1,10 +1,12 @@
 export * from '././@duckdb/data-reader';
 export * from '././@duckdb/data-types';
 export * from '././@duckdb/data-values';
-export { MotherDuckCatalogChangeEvent, MotherDuckCatalogChangeEventDetail, MotherDuckEvent, MotherDuckEventBase, MotherDuckEventType } from '././@motherduck/wasm-extension';
-export * from './getAsyncDuckDb';
-export * from './MDConnection';
-export * from './MDConnectionParams';
-export * from './QueryTypes';
-export * from './readLocalFS';
-export * from './registerFiles';
+export { MotherDuckCatalogChangeEvent, MotherDuckCatalogChangeEventDetail, MotherDuckEvent, MotherDuckEventBase, MotherDuckEventType, } from '././@motherduck/wasm-extension';
+export { terminateDuckDB } from './DuckDBInstance.js';
+export * from './getAsyncDuckDb.js';
+export * from './MDConnection.js';
+export * from './MDConnectionParams.js';
+export * from './QueryTypes.js';
+export * from './readLocalFS.js';
+export * from './registerFiles.js';
+export * from './environment.js';

package/types/instantiateDB.d.ts

@@ -1,3 +1,3 @@
 import { AsyncDuckDB } from '././@duckdb/duckdb-wasm';
-import { MDConnectionParams } from './MDConnectionParams';
+import { MDConnectionParams } from './MDConnectionParams.js';
 export declare function instantiateDB(params: MDConnectionParams): Promise<AsyncDuckDB>;

package/types/readLocalFS.d.ts

@@ -1,5 +1,5 @@
 import { DuckDBDataProtocol, WebFile } from '././@duckdb/duckdb-wasm';
-import { MDConnectionParams } from './MDConnectionParams';
+import { MDConnectionParams } from './MDConnectionParams.js';
 export { DuckDBDataProtocol, WebFile };
 /**
  * Read local data files from wasm db

package/types/registerFiles.d.ts

@@ -1,4 +1,4 @@
-import { MDConnectionParams } from './MDConnectionParams';
+import { MDConnectionParams } from './MDConnectionParams.js';
 /**
  * Register the files within DuckDB WASM
  */

package/types/fetchDuckDBBundlesFromDuckDBAssets.d.ts

@@ -1,2 +0,0 @@
-import { DuckDBBundles } from '././@duckdb/duckdb-wasm';
-export declare function fetchDuckDBBundlesFromDuckDBAssets(duckDBAssetsURLPrefix: string, version: string | undefined, includeCOI: boolean | undefined): Promise<DuckDBBundles>;

package/types/getVersionSuffix.d.ts

@@ -1 +0,0 @@
-export declare function getVersionSuffix(version?: string): string;

package/types/isDuckDBBundles.d.ts

@@ -1,2 +0,0 @@
-import { DuckDBBundles } from '././@duckdb/duckdb-wasm';
-export declare function isDuckDBBundles(input: unknown): input is DuckDBBundles;

package/types/prefixDuckDBBundles.d.ts

@@ -1,2 +0,0 @@
-import { DuckDBBundles } from '././@duckdb/duckdb-wasm';
-export declare function prefixDuckDBBundles(prefix: string, bundles: DuckDBBundles, includeCOI: boolean | undefined): DuckDBBundles;