@effectuate/cubejs-mongosql-driver 1.0.0

package/dist/config.js

@@ -0,0 +1,298 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveUriConfig = resolveUriConfig;
+exports.parseDurationToMillis = parseDurationToMillis;
+const TLS_ENV = {
+    envVar: 'CUBEJS_DB_SSL',
+    uriParam: 'tls',
+    parse: parseBoolToString,
+};
+/**
+ * Mongo-specific tunables. The mongodb Rust crate matches URI keys
+ * case-insensitively (`options.rs:2262` `key.to_lowercase()`), but we
+ * emit standard MongoDB camelCase per
+ * https://www.mongodb.com/docs/manual/reference/connection-string-options/
+ * for readability and to match what users find in MongoDB docs.
+ */
+const URI_PARAM_SPECS = [
+    TLS_ENV,
+    { envVar: 'CUBEJS_DB_MAX_POOL', uriParam: 'maxPoolSize', parse: parsePositiveInteger },
+    { envVar: 'CUBEJS_DB_MIN_POOL', uriParam: 'minPoolSize', parse: parseNonNegativeInteger },
+    { envVar: 'CUBEJS_DB_IDLE_TIMEOUT', uriParam: 'maxIdleTimeMS', parse: parseDurationToMillisString },
+    { envVar: 'CUBEJS_MONGOSQL_MAX_CONNECTING', uriParam: 'maxConnecting', parse: parsePositiveInteger },
+    { envVar: 'CUBEJS_MONGOSQL_WAIT_QUEUE_TIMEOUT_MS', uriParam: 'waitQueueTimeoutMS', parse: parseNonNegativeInteger },
+    { envVar: 'CUBEJS_MONGOSQL_CONNECT_TIMEOUT_MS', uriParam: 'connectTimeoutMS', parse: parseNonNegativeInteger },
+    { envVar: 'CUBEJS_MONGOSQL_SOCKET_TIMEOUT_MS', uriParam: 'socketTimeoutMS', parse: parseNonNegativeInteger },
+    {
+        envVar: 'CUBEJS_MONGOSQL_SERVER_SELECTION_TIMEOUT_MS',
+        uriParam: 'serverSelectionTimeoutMS',
+        parse: parseNonNegativeInteger,
+    },
+    {
+        envVar: 'CUBEJS_MONGOSQL_HEARTBEAT_FREQUENCY_MS',
+        uriParam: 'heartbeatFrequencyMS',
+        parse: parseNonNegativeInteger,
+    },
+    { envVar: 'CUBEJS_MONGOSQL_APP_NAME', uriParam: 'appName', parse: parseNonEmpty },
+    { envVar: 'CUBEJS_MONGOSQL_RETRY_WRITES', uriParam: 'retryWrites', parse: parseBoolToString },
+    { envVar: 'CUBEJS_MONGOSQL_RETRY_READS', uriParam: 'retryReads', parse: parseBoolToString },
+    { envVar: 'CUBEJS_MONGOSQL_COMPRESSORS', uriParam: 'compressors', parse: parseNonEmpty },
+];
+/**
+ * Resolve `(uri, queryTimeoutMs)` from constructor overrides + env.
+ *
+ * Throws `MONGOSQL_CONFIG_INVALID` when:
+ *   - neither explicit uri / `CUBEJS_DB_URL` / `CUBEJS_DB_URI` is set
+ *     AND `CUBEJS_DB_HOST` is also unset;
+ *   - a duration env var is malformed (e.g. `"forever"`);
+ *   - a numeric env var fails to parse.
+ */
+function resolveUriConfig(overrideUri, env) {
+    // Step 1: pick the base URI.
+    const baseUri = overrideUri ?? env.CUBEJS_DB_URL ?? env.CUBEJS_DB_URI ?? composeUriFromParts(env);
+    // Step 2: enrich with env-driven URI params (only if not already in URI).
+    const finalUri = applyUriParams(baseUri, env);
+    // Step 3: resolve effective query-timeout-ms. CUBEJS_DB_QUERY_TIMEOUT
+    // (duration-aware) wins over the legacy CUBEJS_MONGOSQL_QUERY_TIMEOUT_MS
+    // (bare number). Both still recognised for back-compat.
+    const cubeStandardTimeout = env.CUBEJS_DB_QUERY_TIMEOUT;
+    const queryTimeoutMs = cubeStandardTimeout !== undefined && cubeStandardTimeout !== ''
+        ? parseDurationToMillis(cubeStandardTimeout, 'CUBEJS_DB_QUERY_TIMEOUT')
+        : parseLegacyTimeoutMs(env.CUBEJS_MONGOSQL_QUERY_TIMEOUT_MS);
+    return { uri: finalUri, queryTimeoutMs };
+}
+/**
+ * Build `mongodb://[user:pass@]host[:port]/[db]` from discrete env
+ * pieces. Used when neither `CUBEJS_DB_URL` nor `CUBEJS_DB_URI` is set.
+ *
+ * - `CUBEJS_DB_HOST` is required (clear error if missing).
+ * - `CUBEJS_DB_PORT` appended if set.
+ * - `CUBEJS_DB_USER` / `CUBEJS_DB_PASS` URL-encoded so `@` `:` `/`
+ *   `?` `#` in passwords don't break the userinfo parser.
+ * - `CUBEJS_DB_NAME` appended as the path segment. Not load-bearing
+ *   (the driver also reads it separately into `MongoSqlConfig.database`),
+ *   but the mongodb crate parses it so we include it for consistency
+ *   with the URL/URI shape — and any auth-database fallback the crate
+ *   does.
+ *
+ * Host strings with commas (replica-set seed lists like `a:27017,b:27017`)
+ * pass through verbatim.
+ */
+function composeUriFromParts(env) {
+    const host = env.CUBEJS_DB_HOST;
+    if (!host) {
+        throw configInvalid('missing required config: uri (set CUBEJS_DB_URL / CUBEJS_DB_URI or pass `uri` to the constructor; or set CUBEJS_DB_HOST to compose one)');
+    }
+    const port = env.CUBEJS_DB_PORT;
+    const user = env.CUBEJS_DB_USER;
+    const pass = env.CUBEJS_DB_PASS;
+    const db = env.CUBEJS_DB_NAME;
+    let userinfo = '';
+    if (user !== undefined && user !== '') {
+        userinfo = encodeURIComponent(user);
+        if (pass !== undefined && pass !== '') {
+            userinfo += `:${encodeURIComponent(pass)}`;
+        }
+        userinfo += '@';
+    }
+    else if (pass !== undefined && pass !== '') {
+        throw configInvalid('CUBEJS_DB_PASS is set but CUBEJS_DB_USER is not — credentials require both');
+    }
+    // host may itself be a seed list ("h1,h2:27017") or a hostname.
+    // Port is only meaningful when host is a single hostname; we append
+    // it conservatively if the host string has no ':' AND no ','.
+    let hostPart = host;
+    if (port !== undefined && port !== '' && !host.includes(':') && !host.includes(',')) {
+        hostPart = `${host}:${port}`;
+    }
+    const dbPart = db !== undefined && db !== '' ? `/${encodeURIComponent(db)}` : '/';
+    return `mongodb://${userinfo}${hostPart}${dbPart}`;
+}
+/**
+ * Append env-driven URI params to the base URI, skipping any key that
+ * already appears in the URI's query string.
+ *
+ * Implemented via `new URL` — Node's parser handles both `mongodb://`
+ * and `mongodb+srv://` schemes correctly (verified: see commit message).
+ * We reconstruct the URI by string concatenation rather than reading
+ * `URL.href` back because Node's URL normalisation otherwise drops
+ * authentication-related characters (e.g. `+` in passwords) and we
+ * want byte-identical pass-through of any URI the user provides.
+ */
+function applyUriParams(baseUri, env) {
+    const existingKeys = extractExistingParamKeys(baseUri);
+    const additions = [];
+    for (const spec of URI_PARAM_SPECS) {
+        const raw = env[spec.envVar];
+        if (raw === undefined || raw === '')
+            continue;
+        if (existingKeys.has(spec.uriParam.toLowerCase()))
+            continue;
+        const value = spec.parse ? spec.parse(raw) : raw;
+        if (value === undefined) {
+            throw configInvalid(`${spec.envVar} has invalid value: '${raw}'`);
+        }
+        additions.push([spec.uriParam, value]);
+    }
+    if (additions.length === 0)
+        return baseUri;
+    // Determine separator: `?` if URI has no query, else `&`.
+    // `existingKeys.size > 0` is equivalent to "URI has a `?`" except for
+    // the empty-query-string edge case (`mongodb://h/db?`) which is not
+    // produced by us and would be parsed as a query by `new URL` anyway.
+    const queryStart = findQueryStart(baseUri);
+    const separator = queryStart === -1 ? '?' : '&';
+    const tail = additions.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join('&');
+    // Insert before any URL fragment (`#...`), although MongoDB URIs do
+    // not normally have one — defensive only.
+    const hashAt = baseUri.indexOf('#');
+    if (hashAt === -1)
+        return `${baseUri}${separator}${tail}`;
+    return `${baseUri.slice(0, hashAt)}${separator}${tail}${baseUri.slice(hashAt)}`;
+}
+/**
+ * Pull the set of param keys (lowercased) already present in the URI's
+ * query string. Returns an empty set for URIs with no query.
+ */
+function extractExistingParamKeys(uri) {
+    const start = findQueryStart(uri);
+    if (start === -1)
+        return new Set();
+    const end = uri.indexOf('#', start + 1);
+    const query = uri.slice(start + 1, end === -1 ? undefined : end);
+    if (!query)
+        return new Set();
+    const keys = new Set();
+    for (const part of query.split('&')) {
+        if (!part)
+            continue;
+        const eq = part.indexOf('=');
+        const rawKey = eq === -1 ? part : part.slice(0, eq);
+        // URI keys aren't expected to be percent-encoded, but be tolerant.
+        try {
+            keys.add(decodeURIComponent(rawKey).toLowerCase());
+        }
+        catch {
+            keys.add(rawKey.toLowerCase());
+        }
+    }
+    return keys;
+}
+function findQueryStart(uri) {
+    // Skip the protocol-relative `//` — those are not the query.
+    return uri.indexOf('?');
+}
+// ---------- value parsers ----------
+/**
+ * Accepts `"true"` / `"false"` (case-insensitive) or `"1"` / `"0"`.
+ * Returns the canonical `"true"` / `"false"` MongoDB URI form.
+ */
+function parseBoolToString(raw) {
+    const v = raw.trim().toLowerCase();
+    if (v === 'true' || v === '1')
+        return 'true';
+    if (v === 'false' || v === '0')
+        return 'false';
+    return undefined;
+}
+function parseNonEmpty(raw) {
+    const v = raw.trim();
+    return v === '' ? undefined : v;
+}
+function parsePositiveInteger(raw) {
+    const n = parseStrictInteger(raw);
+    if (n === undefined || n <= 0)
+        return undefined;
+    return String(n);
+}
+function parseNonNegativeInteger(raw) {
+    const n = parseStrictInteger(raw);
+    if (n === undefined || n < 0)
+        return undefined;
+    return String(n);
+}
+function parseStrictInteger(raw) {
+    const v = raw.trim();
+    if (!/^-?\d+$/.test(v))
+        return undefined;
+    const n = Number(v);
+    if (!Number.isFinite(n) || !Number.isInteger(n))
+        return undefined;
+    return n;
+}
+/**
+ * Convert a duration-or-number string to a millisecond integer string.
+ *
+ * Accepts a bare number (treated as **milliseconds**) or a unit
+ * suffix: `ms`, `s`, `m`, `h`. Whitespace inside is trimmed.
+ *
+ * Returns the canonical `"<N>"` ms representation as a string (URI
+ * param values are strings). Returns `undefined` for unparseable
+ * input so the caller can produce a `MONGOSQL_CONFIG_INVALID` error
+ * naming the offending env var.
+ */
+function parseDurationToMillisString(raw) {
+    const ms = parseDurationToMillisOrUndefined(raw);
+    return ms === undefined ? undefined : String(ms);
+}
+/** Same as `parseDurationToMillisString` but returns the integer directly. Throws on malformed input. */
+function parseDurationToMillis(raw, envVarName) {
+    const ms = parseDurationToMillisOrUndefined(raw);
+    if (ms === undefined) {
+        throw configInvalid(`${envVarName} has invalid duration: '${raw}'. Accepted: bare ms (e.g. '60000'), or with unit suffix '<N>ms' / '<N>s' / '<N>m' / '<N>h'`);
+    }
+    return ms;
+}
+function parseDurationToMillisOrUndefined(raw) {
+    const v = raw.trim();
+    if (v === '')
+        return undefined;
+    // Most specific suffix first so `"500ms"` doesn't match the `s`
+    // branch — `ms` must be tested before bare `s`.
+    const match = v.match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h)?$/i);
+    if (!match)
+        return undefined;
+    const n = Number(match[1]);
+    if (!Number.isFinite(n) || n < 0)
+        return undefined;
+    const unit = (match[2] ?? 'ms').toLowerCase();
+    let multiplier;
+    switch (unit) {
+        case 'ms':
+            multiplier = 1;
+            break;
+        case 's':
+            multiplier = 1_000;
+            break;
+        case 'm':
+            multiplier = 60_000;
+            break;
+        case 'h':
+            multiplier = 3_600_000;
+            break;
+        default:
+            return undefined;
+    }
+    // Round to nearest ms to keep fractional inputs (`0.5s`) usable.
+    return Math.round(n * multiplier);
+}
+/**
+ * Legacy `CUBEJS_MONGOSQL_QUERY_TIMEOUT_MS` is documented as a bare
+ * number-of-milliseconds. Preserve the old behaviour: empty/invalid
+ * returns `undefined` (so the native default takes over) — we do NOT
+ * throw on invalid here, matching the pre-this-change behaviour where
+ * `numEnv` silently returned `undefined`.
+ */
+function parseLegacyTimeoutMs(raw) {
+    if (raw === undefined || raw === '')
+        return undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : undefined;
+}
+function configInvalid(detail) {
+    const err = new Error(`MONGOSQL_CONFIG_INVALID: ${detail}`);
+    err.code = 'MONGOSQL_CONFIG_INVALID';
+    err.name = 'MongoSqlError';
+    return err;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Public exports for mongosql-cubejs-driver.
+ * See SPEC.md §5.1.
+ */
+export { MongoSqlDriver } from './MongoSqlDriver.js';
+export { MongoSqlQuery } from './MongoSqlQuery.js';
+export type { MongoSqlConfig, SchemaSource, ErrorCode, MongoSqlError } from './types.js';
+export { ERROR_CODES } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_CODES = exports.MongoSqlQuery = exports.MongoSqlDriver = void 0;
+/**
+ * Public exports for mongosql-cubejs-driver.
+ * See SPEC.md §5.1.
+ */
+var MongoSqlDriver_js_1 = require("./MongoSqlDriver.js");
+Object.defineProperty(exports, "MongoSqlDriver", { enumerable: true, get: function () { return MongoSqlDriver_js_1.MongoSqlDriver; } });
+var MongoSqlQuery_js_1 = require("./MongoSqlQuery.js");
+Object.defineProperty(exports, "MongoSqlQuery", { enumerable: true, get: function () { return MongoSqlQuery_js_1.MongoSqlQuery; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "ERROR_CODES", { enumerable: true, get: function () { return types_js_1.ERROR_CODES; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AACvB,uDAAmD;AAA1C,iHAAA,aAAa,OAAA;AAEtB,uCAAyC;AAAhC,uGAAA,WAAW,OAAA"}

package/dist/native.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Type-safe wrapper around the napi-rs `.node` module.
+ *
+ * Native errors carry the SPEC §6 code prefixed in the message, e.g.
+ * `"MONGOSQL_CONFIG_INVALID: ..."`. This wrapper parses that prefix and
+ * rethrows as `MongoSqlError` with `code`/`name` set. Errors without a
+ * recognised prefix are passed through unchanged.
+ */
+import type { MongoSqlConfig } from './types.js';
+interface NativeAbortHandle {
+    abort(): void;
+    aborted(): boolean;
+}
+interface NativeMongoSqlClient {
+    testConnection(signal?: NativeAbortHandle | null): Promise<void>;
+    query(sql: string, signal?: NativeAbortHandle | null): Promise<unknown>;
+    tablesSchema(signal?: NativeAbortHandle | null): Promise<unknown>;
+    close(): Promise<void>;
+}
+/**
+ * Authoritative `(name, type)` column descriptor produced by the native
+ * layer from `mongosql::Translation::{select_order, result_set_schema}`.
+ * Used by `downloadQueryResults` to drive Cube Store's LOAD ROWS column
+ * list, replacing the old value-sniffing heuristic.
+ */
+export interface ColumnType {
+    name: string;
+    /** Cube generic-type string: `timestamp` | `int` | `bigint` | `decimal` | `boolean` | `string` | `text`. */
+    type: string;
+}
+/** Shape returned by the native `query()` napi binding. */
+export interface NativeQueryResult {
+    rows: unknown[];
+    types: ColumnType[];
+}
+interface NativeModule {
+    MongoSqlClient: new (config: MongoSqlConfig) => NativeMongoSqlClient;
+    AbortHandle?: new () => NativeAbortHandle;
+}
+/** Column descriptor returned by `tablesSchema()`. Mirrors the Rust shape. */
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    attributes: string[];
+}
+/** `tablesSchema()` shape: `{ <db>: { <coll>: ColumnInfo[] } }`. */
+export type TablesSchema = Record<string, Record<string, ColumnInfo[]>>;
+/** Test hook: reset the cached native-module reference. */
+export declare function _resetNativeModuleForTests(): void;
+/** Test hook: inject a mock native module. */
+export declare function _setNativeModuleForTests(mod: NativeModule): void;
+/**
+ * Type-safe TypeScript wrapper around the napi-rs `MongoSqlClient`.
+ * One-to-one method mapping; errors are normalised into `MongoSqlError`.
+ *
+ * **Cancellation contract.** Each cancellable method takes an optional
+ * `AbortSignal`. Internally we lazily allocate a native `AbortHandle` and
+ * wire `signal.addEventListener('abort', () => handle.abort())`. The
+ * native side races the work future against the handle's
+ * `CancelToken::cancelled()` future and rejects with
+ * `MONGOSQL_CANCELLED` if it fires first. Pre-aborted signals are
+ * special-cased so they reject immediately without crossing the napi
+ * boundary at all.
+ *
+ * napi-rs 2.16's first-class `AbortSignal` only integrates with
+ * `AsyncTask` (libuv async-work pattern), not `#[napi] async fn`. The
+ * Rust side therefore exposes its own opaque `AbortHandle` class
+ * (`crates/native/src/cancel.rs`) and we bridge here.
+ */
+export declare class MongoSqlClient {
+    private readonly inner;
+    private readonly nativeAbortHandleCtor;
+    constructor(config: MongoSqlConfig);
+    testConnection(signal?: AbortSignal): Promise<void>;
+    query<R = Record<string, unknown>>(sql: string, signal?: AbortSignal): Promise<R[]>;
+    /**
+     * Like `query()` but returns the authoritative `(name, type)` list
+     * alongside the rows. Used by `downloadQueryResults` to drive Cube
+     * Store's column-list payload; replaces the value-sniffed inference
+     * the driver used pre-fix.
+     *
+     * The shape mirrors the native binding exactly:
+     *   `{ rows: R[], types: Array<{name, type}> }`.
+     * `types` is empty when (and only when) `mongosql::select_order` is
+     * empty — a degenerate case in practice but possible if upstream
+     * doesn't parse a projection list.
+     */
+    queryWithTypes<R = Record<string, unknown>>(sql: string, signal?: AbortSignal): Promise<{
+        rows: R[];
+        types: ColumnType[];
+    }>;
+    tablesSchema(signal?: AbortSignal): Promise<TablesSchema>;
+    close(): Promise<void>;
+    /**
+     * Bridge a JS `AbortSignal` to a native `AbortHandle` for the duration
+     * of one call. If `signal` is undefined, the call runs un-cancelled
+     * (the native side still wires the parent close-token, so `close()`
+     * can still cancel it). If `signal` is already aborted, we throw
+     * `MONGOSQL_CANCELLED` synchronously without invoking the native side.
+     */
+    private runCancellable;
+}
+export {};
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,YAAY,CAAC;AAG3E,UAAU,iBAAiB;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,OAAO,CAAC;CACpB;AAED,UAAU,oBAAoB;IAC5B,cAAc,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,4GAA4G;IAC5G,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,cAAc,EAAE,KAAK,MAAM,EAAE,cAAc,KAAK,oBAAoB,CAAC;IAIrE,WAAW,CAAC,EAAE,UAAU,iBAAiB,CAAC;CAC3C;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AAiBxE,2DAA2D;AAC3D,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,8CAA8C;AAC9C,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAEhE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA4C;gBAEtE,MAAM,EAAE,cAAc;IAc5B,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQzF;;;;;;;;;;;OAWG;IACG,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAWxC,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAKzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;;OAMG;YACW,cAAc;CA6B7B"}

package/dist/native.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Type-safe wrapper around the napi-rs `.node` module.
+ *
+ * Native errors carry the SPEC §6 code prefixed in the message, e.g.
+ * `"MONGOSQL_CONFIG_INVALID: ..."`. This wrapper parses that prefix and
+ * rethrows as `MongoSqlError` with `code`/`name` set. Errors without a
+ * recognised prefix are passed through unchanged.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoSqlClient = void 0;
+exports._resetNativeModuleForTests = _resetNativeModuleForTests;
+exports._setNativeModuleForTests = _setNativeModuleForTests;
+const types_js_1 = require("./types.js");
+let nativeModule;
+function loadNative() {
+    if (nativeModule)
+        return nativeModule;
+    // napi-rs's `index.js` lives at project root. From `src/native.ts` (vitest)
+    // it's `../index.js`; from `dist/src/native.js` (built consumer) it's
+    // `../../index.js`. Try both.
+    try {
+        nativeModule = require('../index.js');
+    }
+    catch {
+        nativeModule = require('../../index.js');
+    }
+    return nativeModule;
+}
+/** Test hook: reset the cached native-module reference. */
+function _resetNativeModuleForTests() {
+    nativeModule = undefined;
+}
+/** Test hook: inject a mock native module. */
+function _setNativeModuleForTests(mod) {
+    nativeModule = mod;
+}
+/**
+ * Type-safe TypeScript wrapper around the napi-rs `MongoSqlClient`.
+ * One-to-one method mapping; errors are normalised into `MongoSqlError`.
+ *
+ * **Cancellation contract.** Each cancellable method takes an optional
+ * `AbortSignal`. Internally we lazily allocate a native `AbortHandle` and
+ * wire `signal.addEventListener('abort', () => handle.abort())`. The
+ * native side races the work future against the handle's
+ * `CancelToken::cancelled()` future and rejects with
+ * `MONGOSQL_CANCELLED` if it fires first. Pre-aborted signals are
+ * special-cased so they reject immediately without crossing the napi
+ * boundary at all.
+ *
+ * napi-rs 2.16's first-class `AbortSignal` only integrates with
+ * `AsyncTask` (libuv async-work pattern), not `#[napi] async fn`. The
+ * Rust side therefore exposes its own opaque `AbortHandle` class
+ * (`crates/native/src/cancel.rs`) and we bridge here.
+ */
+class MongoSqlClient {
+    inner;
+    nativeAbortHandleCtor;
+    constructor(config) {
+        const native = loadNative();
+        this.nativeAbortHandleCtor = native.AbortHandle;
+        this.inner = new native.MongoSqlClient({
+            uri: config.uri,
+            database: config.database,
+            schemaSource: config.schemaSource,
+            schemaRefreshSec: config.schemaRefreshSec,
+            schemaFailOpen: config.schemaFailOpen,
+            queryTimeoutMs: config.queryTimeoutMs,
+            maxRows: config.maxRows,
+        });
+    }
+    async testConnection(signal) {
+        return this.runCancellable(signal, (handle) => this.inner.testConnection(handle));
+    }
+    async query(sql, signal) {
+        // `query()` keeps its historical `R[]` signature for ergonomic
+        // consumption — pre-aggregation paths that need the type list call
+        // `queryWithTypes` instead and pay the extra unwrap.
+        const { rows } = await this.queryWithTypes(sql, signal);
+        return rows;
+    }
+    /**
+     * Like `query()` but returns the authoritative `(name, type)` list
+     * alongside the rows. Used by `downloadQueryResults` to drive Cube
+     * Store's column-list payload; replaces the value-sniffed inference
+     * the driver used pre-fix.
+     *
+     * The shape mirrors the native binding exactly:
+     *   `{ rows: R[], types: Array<{name, type}> }`.
+     * `types` is empty when (and only when) `mongosql::select_order` is
+     * empty — a degenerate case in practice but possible if upstream
+     * doesn't parse a projection list.
+     */
+    async queryWithTypes(sql, signal) {
+        const result = await this.runCancellable(signal, (handle) => this.inner.query(sql, handle));
+        if (!isQueryResult(result)) {
+            throw createError('MONGOSQL_EXECUTE_FAILED', `expected query result to be an object with rows + types arrays, got ${describe(result)}`);
+        }
+        return { rows: result.rows, types: result.types };
+    }
+    async tablesSchema(signal) {
+        const result = await this.runCancellable(signal, (handle) => this.inner.tablesSchema(handle));
+        return result;
+    }
+    async close() {
+        return wrapErrors(() => this.inner.close());
+    }
+    /**
+     * Bridge a JS `AbortSignal` to a native `AbortHandle` for the duration
+     * of one call. If `signal` is undefined, the call runs un-cancelled
+     * (the native side still wires the parent close-token, so `close()`
+     * can still cancel it). If `signal` is already aborted, we throw
+     * `MONGOSQL_CANCELLED` synchronously without invoking the native side.
+     */
+    async runCancellable(signal, op) {
+        if (signal === undefined) {
+            return wrapErrors(() => op(null));
+        }
+        if (signal.aborted) {
+            // Pre-aborted: skip the napi round-trip entirely. Mirror the
+            // wire-format of MONGOSQL_CANCELLED that the Rust side produces
+            // so callers see one consistent error shape.
+            throw createError('MONGOSQL_CANCELLED', 'signal was aborted before call');
+        }
+        if (!this.nativeAbortHandleCtor) {
+            // Defensive: production builds always export AbortHandle; this
+            // branch only fires under test mocks that didn't stub it. Run
+            // un-cancellable rather than crashing — the caller still gets
+            // their result.
+            return wrapErrors(() => op(null));
+        }
+        const handle = new this.nativeAbortHandleCtor();
+        const onAbort = () => handle.abort();
+        signal.addEventListener('abort', onAbort, { once: true });
+        try {
+            return await wrapErrors(() => op(handle));
+        }
+        finally {
+            signal.removeEventListener('abort', onAbort);
+        }
+    }
+}
+exports.MongoSqlClient = MongoSqlClient;
+const ERROR_CODE_RE = /^(MONGOSQL_[A-Z_]+):\s*(.*)$/s;
+async function wrapErrors(op) {
+    try {
+        return await op();
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            const match = ERROR_CODE_RE.exec(err.message);
+            if (match) {
+                const [, code, message] = match;
+                if (types_js_1.ERROR_CODES.includes(code)) {
+                    throw createError(code, message);
+                }
+            }
+        }
+        throw err;
+    }
+}
+function createError(code, message) {
+    const err = new Error(message);
+    err.code = code;
+    err.name = 'MongoSqlError';
+    return err;
+}
+function isQueryResult(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    if (!Array.isArray(v.rows))
+        return false;
+    if (!Array.isArray(v.types))
+        return false;
+    for (const t of v.types) {
+        if (typeof t !== 'object' || t === null)
+            return false;
+        const ct = t;
+        if (typeof ct.name !== 'string' || typeof ct.type !== 'string')
+            return false;
+    }
+    return true;
+}
+function describe(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value;
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"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"}