@motherduck/wasm-client 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motherduck/wasm-client",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Client library for MotherDuck-enabled DuckDB powered by WebAssembly (WASM)",
   "browser": "index.js",
   "types": "types/index.d.ts",

package/types/@duckdb/data-types/DuckDBType.d.ts

@@ -293,16 +293,16 @@ export declare class DuckDBAnyType extends BaseDuckDBType<DuckDBTypeId.ANY> {
     static create(alias?: string): DuckDBAnyType;
 }
 export declare const ANY: DuckDBAnyType;
-export declare class DuckDBVarIntType extends BaseDuckDBType<DuckDBTypeId.VARINT> {
+export declare class DuckDBBigNumType extends BaseDuckDBType<DuckDBTypeId.BIGNUM> {
     constructor(alias?: string);
-    static readonly instance: DuckDBVarIntType;
-    static create(alias?: string): DuckDBVarIntType;
+    static readonly instance: DuckDBBigNumType;
+    static create(alias?: string): DuckDBBigNumType;
     static readonly Max: bigint;
     static readonly Min: bigint;
     get max(): bigint;
     get min(): bigint;
 }
-export declare const VARINT: DuckDBVarIntType;
+export declare const BIGNUM: DuckDBBigNumType;
 export declare class DuckDBSQLNullType extends BaseDuckDBType<DuckDBTypeId.SQLNULL> {
     constructor(alias?: string);
     static readonly instance: DuckDBSQLNullType;
@@ -321,4 +321,4 @@ export declare class DuckDBIntegerLiteralType extends BaseDuckDBType<DuckDBTypeI
     static create(alias?: string): DuckDBIntegerLiteralType;
 }
 export declare const INTEGER_LITERAL: DuckDBIntegerLiteralType;
-export type DuckDBType = DuckDBBooleanType | DuckDBTinyIntType | DuckDBSmallIntType | DuckDBIntegerType | DuckDBBigIntType | DuckDBUTinyIntType | DuckDBUSmallIntType | DuckDBUIntegerType | DuckDBUBigIntType | DuckDBFloatType | DuckDBDoubleType | DuckDBTimestampType | DuckDBDateType | DuckDBTimeType | DuckDBIntervalType | DuckDBHugeIntType | DuckDBUHugeIntType | DuckDBVarCharType | DuckDBBlobType | DuckDBDecimalType | DuckDBTimestampSecondsType | DuckDBTimestampMillisecondsType | DuckDBTimestampNanosecondsType | DuckDBEnumType | DuckDBListType | DuckDBStructType | DuckDBMapType | DuckDBArrayType | DuckDBUUIDType | DuckDBUnionType | DuckDBBitType | DuckDBTimeTZType | DuckDBTimestampTZType | DuckDBAnyType | DuckDBVarIntType | DuckDBSQLNullType | DuckDBStringLiteralType | DuckDBIntegerLiteralType;
+export type DuckDBType = DuckDBBooleanType | DuckDBTinyIntType | DuckDBSmallIntType | DuckDBIntegerType | DuckDBBigIntType | DuckDBUTinyIntType | DuckDBUSmallIntType | DuckDBUIntegerType | DuckDBUBigIntType | DuckDBFloatType | DuckDBDoubleType | DuckDBTimestampType | DuckDBDateType | DuckDBTimeType | DuckDBIntervalType | DuckDBHugeIntType | DuckDBUHugeIntType | DuckDBVarCharType | DuckDBBlobType | DuckDBDecimalType | DuckDBTimestampSecondsType | DuckDBTimestampMillisecondsType | DuckDBTimestampNanosecondsType | DuckDBEnumType | DuckDBListType | DuckDBStructType | DuckDBMapType | DuckDBArrayType | DuckDBUUIDType | DuckDBUnionType | DuckDBBitType | DuckDBTimeTZType | DuckDBTimestampTZType | DuckDBAnyType | DuckDBBigNumType | DuckDBSQLNullType | DuckDBStringLiteralType | DuckDBIntegerLiteralType;

package/types/@duckdb/data-types/DuckDBTypeId.d.ts

@@ -34,7 +34,7 @@ export declare enum DuckDBTypeId {
     TIME_TZ = 30,
     TIMESTAMP_TZ = 31,
     ANY = 34,
-    VARINT = 35,
+    BIGNUM = 35,
     SQLNULL = 36,
     STRING_LITERAL = 37,
     INTEGER_LITERAL = 38

package/types/@duckdb/data-values/DuckDBTimestampTZValue.d.ts

@@ -5,6 +5,6 @@ export declare class DuckDBTimestampTZValue extends SpecialDuckDBValue {
     readonly microseconds: bigint;
     constructor(microseconds: bigint);
     toDuckDBString(toStringOptions?: DuckDBToStringOptions): string;
-    toSql(): string;
+    toSql(toStringOptions?: DuckDBToStringOptions): string;
     toJson(): Json;
 }

package/types/@duckdb/data-values/DuckDBToStringOptions.d.ts

@@ -1,3 +1,3 @@
 export interface DuckDBToStringOptions {
-    timezoneOffsetInMinutes?: number;
+    timeZone?: string;
 }

package/types/@duckdb/data-values/conversion/dateTimeStringConversion.d.ts

@@ -1,6 +1,9 @@
 export declare function getDuckDBDateStringFromYearMonthDay(year: number, month: number, dayOfMonth: number): string;
 export declare function getDuckDBDateStringFromDays(days: number): string;
-export declare function getTimezoneOffsetString(timezoneOffsetInMinutes?: number): string | undefined;
+export declare function getTimeZoneOffsetString(timeZoneOffsetInMinutes?: number): string | undefined;
+export declare function getFormatterForTimeZone(timeZone: string): Intl.DateTimeFormat;
+export declare function getTimeZoneName(date: Date, timeZone: string): string | undefined;
+export declare function getTimeZoneOffsetInMinutes(millisecondsSinceEpoch: number, timeZone: string): number;
 export declare function getAbsoluteOffsetStringFromParts(hoursPart: number, minutesPart: number, secondsPart: number): string;
 export declare function getOffsetStringFromAbsoluteSeconds(absoluteOffsetInSeconds: number): string;
 export declare function getOffsetStringFromSeconds(offsetInSeconds: number): string;
@@ -8,8 +11,8 @@ export declare function getDuckDBTimeStringFromParts(hoursPart: bigint, minutesP
 export declare function getDuckDBTimeStringFromPositiveMicroseconds(positiveMicroseconds: bigint): string;
 export declare function getDuckDBTimeStringFromMicrosecondsInDay(microsecondsInDay: bigint): string;
 export declare function getDuckDBTimeStringFromMicroseconds(microseconds: bigint): string;
-export declare function getDuckDBTimestampStringFromDaysAndMicroseconds(days: bigint, microsecondsInDay: bigint, timezonePart?: string): string;
-export declare function getDuckDBTimestampStringFromMicroseconds(microseconds: bigint, timezoneOffsetInMinutes?: number): string;
+export declare function getDuckDBTimestampStringFromDaysAndMicroseconds(days: bigint, microsecondsInDay: bigint, timeZonePart?: string): string;
+export declare function getDuckDBTimestampStringFromMicroseconds(microseconds: bigint, timeZone?: string): string;
 export declare function getDuckDBTimestampStringFromSeconds(seconds: bigint): string;
 export declare function getDuckDBTimestampStringFromMilliseconds(milliseconds: bigint): string;
 export declare function getDuckDBTimestampStringFromNanoseconds(nanoseconds: bigint): string;

package/types/@duckdb/data-values/conversion/getBigNumFromBytes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the JS bigint value represented by the byte array of a BIGNUM in DuckDB's internal format.
+ *
+ * DuckDB stores BIGNUMs as an array of bytes consisting of a three-byte header followed by a variable number of bytes
+ * (at least one). The header specifies the number of bytes after the header, and whether the number is positive or
+ * negative. The bytes after the header specify the absolute value of the number, in big endian format.
+ *
+ * The sign of the number is determined by the MSB of the header, which is 1 for positive and 0 for negative. Negative
+ * numbers also have all bytes of both the header and value inverted. (For negative numbers, the MSB is 0 after this
+ * inversion. Put another way: the MSB of the header is always 1, but it's inverted for negative numbers.)
+ */
+export declare function getBigNumFromBytes(bytes: Uint8Array): bigint;

package/types/@duckdb/data-values/index.d.ts

@@ -1,5 +1,5 @@
 export { duckDBValueToSql } from './conversion/duckDBValueToSql.js';
-export { getVarIntFromBytes } from './conversion/getVarIntFromBytes.js';
+export { getBigNumFromBytes } from './conversion/getBigNumFromBytes.js';
 export { jsonFromDuckDBValue } from './conversion/jsonFromDuckDBValue.js';
 export { DuckDBArrayValue } from './DuckDBArrayValue.js';
 export { DuckDBBitValue } from './DuckDBBitValue.js';

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

@@ -12,15 +12,15 @@ export interface LoadMotherDuckWasmExtensionOptions {
     /**
      * URL prefix of a custom extension repository where the MotherDuck Wasm client extension can be found.
      *
-     * Note that this should not contain either the extension version or the `/duckdb-wasm` suffix.
+     * Note that this should not contain the extension version; that will be appended.
      *
-     * Defaults to https://app.motherduck.com.
+     * Defaults to https://ext.motherduck.com/.
      */
     extensionRepositoryUrlPrefix?: URL;
     /**
-     * Version of the MotherDuck Wasm client extension, in the form `{branch}@{SHA}`.
+     * Version of the MotherDuck Wasm client extension, typically in the form `{duckdb-version}-{year}-{month}-{seq-num}`.
      *
-     * If not given, the latest version will be fetched from `{extensionRepositoryUrlPrefix}/version`.
+     * If not given, the latest version will be fetched from `{apiUrl}/extension_version`.
      */
     extensionVersion?: string;
     /**

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

@@ -0,0 +1 @@
+export declare function fetchMotherDuckExtensionVersion(apiUrl: URL, duckDBVersion: string): Promise<string>;

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

@@ -0,0 +1 @@
+export declare function fetchMotherDuckUIVersion(motherDuckUIUrlPrefix: URL): Promise<string>;

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

@@ -0,0 +1,2 @@
+import { AsyncDuckDB } from '../../@duckdb/duckdb-wasm';
+export declare function getDuckDBVersion(instance: AsyncDuckDB): Promise<string>;

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

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

package/types/MDConnectionParams.d.ts

@@ -7,6 +7,7 @@ export interface MDConnectionParams {
     useDuckDBWasmCOI?: boolean;
     logger?: ConsoleLike;
     version?: string;
+    extensionVersion?: string;
     enableDebugLogging?: boolean;
     customUserAgent?: string;
     attachMode?: 'single' | 'workspace';