@keystrokehq/snowflake 0.0.16 → 0.0.18

package/dist/bulk/index.mjs

@@ -1,65 +0,0 @@
-import { executeSql } from "../sql/index.mjs";
-import { a as quoteLiteral, t as buildFqn } from "../sql-safety-BZpAPsq6.mjs";
-import { n as renderOptionGroup, t as formatOptions } from "../sql-options-D6GEa21F.mjs";
-import { stagePath } from "../stages/index.mjs";
-
-//#region src/bulk/index.ts
-function tableFqn(ref) {
-	return buildFqn(ref.database, ref.schema, ref.table);
-}
-function renderSource(source) {
-	if (source.kind === "query") return `(${source.sql})`;
-	if (source.kind === "stage") return `${stagePath(source.stage, source.pathSuffix)}${source.files && source.files.length > 0 ? ` FILES = (${source.files.map(quoteLiteral).join(", ")})` : ""}${source.pattern ? ` PATTERN = ${quoteLiteral(source.pattern)}` : ""}`;
-	const files = source.files && source.files.length > 0 ? ` FILES = (${source.files.map(quoteLiteral).join(", ")})` : "";
-	const pattern = source.pattern ? ` PATTERN = ${quoteLiteral(source.pattern)}` : "";
-	const creds = renderOptionGroup("CREDENTIALS", source.credentials);
-	const enc = renderOptionGroup("ENCRYPTION", source.encryption);
-	return `${quoteLiteral(source.url)}${creds}${enc}${files}${pattern}`;
-}
-function collectCopyOptions(opts) {
-	const merged = { ...opts.copyOptions ?? {} };
-	if (opts.onError !== void 0) merged.onError = opts.onError;
-	if (opts.force !== void 0) merged.force = opts.force;
-	if (opts.truncateColumns !== void 0) merged.truncateColumns = opts.truncateColumns;
-	return Object.keys(merged).length > 0 ? merged : void 0;
-}
-async function copyInto(client, options) {
-	const columnList = options.columns && options.columns.length > 0 ? `(${options.columns.map((c) => `"${c.replaceAll("\"", "\"\"")}"`).join(", ")})` : "";
-	const copyOpts = collectCopyOptions(options);
-	return executeSql(client, {
-		statement: `COPY INTO ${tableFqn(options)}${columnList ? ` ${columnList}` : ""} FROM ${renderSource(options.source)}` + renderOptionGroup("FILE_FORMAT", options.fileFormat) + (copyOpts ? ` ${formatOptions(copyOpts)}` : "") + (options.validationMode ? ` VALIDATION_MODE = ${options.validationMode}` : ""),
-		warehouse: options.warehouse,
-		role: options.role
-	});
-}
-async function validateCopyInto(client, options) {
-	return copyInto(client, {
-		...options,
-		validationMode: options.validationMode ?? "RETURN_ERRORS"
-	});
-}
-async function unload(client, options) {
-	const scope = stagePath(options.stage, options.pathSuffix);
-	const copyOpts = { ...options.copyOptions ?? {} };
-	if (options.overwrite !== void 0) copyOpts.overwrite = options.overwrite;
-	if (options.header !== void 0) copyOpts.header = options.header;
-	if (options.singleFile !== void 0) copyOpts.singleFile = options.singleFile;
-	if (options.maxFileSize !== void 0) copyOpts.maxFileSize = options.maxFileSize;
-	const copyOptions = Object.keys(copyOpts).length > 0 ? copyOpts : void 0;
-	const partition = options.partitionBy ? ` PARTITION BY (${options.partitionBy})` : "";
-	return executeSql(client, {
-		statement: `COPY INTO ${scope} FROM (${options.query})` + renderOptionGroup("FILE_FORMAT", options.fileFormat) + (copyOptions ? ` ${formatOptions(copyOptions)}` : "") + partition,
-		warehouse: options.warehouse,
-		role: options.role
-	});
-}
-async function truncateTable(client, options) {
-	await executeSql(client, {
-		statement: `TRUNCATE TABLE${options.ifExists ? " IF EXISTS" : ""} ${tableFqn(options)}`,
-		warehouse: options.warehouse,
-		role: options.role
-	});
-}
-
-//#endregion
-export { copyInto, truncateTable, unload, validateCopyInto };

package/dist/catalog/index.d.mts

@@ -1,144 +0,0 @@
-import { SnowflakeClient } from "../client/index.mjs";
-import { d as HydratedRow } from "../statements-DJL0qVNA.mjs";
-//#region src/catalog/index.d.ts
-interface ShowOptions {
-  /** Optional `LIKE '<pattern>'` filter. Escaped via {@link quoteLiteral}. */
-  readonly like?: string;
-  /** Cap results. Snowflake supports `LIMIT <n>` on SHOW. */
-  readonly limit?: number;
-  /** Runtime overrides forwarded to {@link executeSql}. */
-  readonly warehouse?: string;
-  readonly role?: string;
-  readonly database?: string;
-  readonly schema?: string;
-}
-interface ShowScopedOptions extends ShowOptions {
-  /** Restrict results to the named database. */
-  readonly inDatabase?: string;
-  /** Restrict to a `DB.SCHEMA` scope. */
-  readonly inSchema?: {
-    readonly database: string;
-    readonly schema: string;
-  };
-  /** Restrict to `SHOW X IN ACCOUNT`. */
-  readonly inAccount?: boolean;
-}
-interface CatalogResult {
-  readonly rows: readonly HydratedRow[];
-  readonly columns: readonly {
-    readonly name: string;
-    readonly type: string;
-  }[];
-}
-interface ShowDatabasesOptions extends ShowOptions {}
-declare function showDatabases(client: SnowflakeClient, options?: ShowDatabasesOptions): Promise<CatalogResult>;
-interface ShowSchemasOptions extends ShowScopedOptions {
-  /** `HISTORY` variant returns dropped schemas too. */
-  readonly history?: boolean;
-}
-declare function showSchemas(client: SnowflakeClient, options?: ShowSchemasOptions): Promise<CatalogResult>;
-interface ShowTablesOptions extends ShowScopedOptions {
-  readonly history?: boolean;
-  /** Cascading to TEMPORARY + TRANSIENT + EXTERNAL tables. */
-  readonly terse?: boolean;
-}
-declare function showTables(client: SnowflakeClient, options?: ShowTablesOptions): Promise<CatalogResult>;
-interface ShowViewsOptions extends ShowScopedOptions {
-  readonly terse?: boolean;
-}
-declare function showViews(client: SnowflakeClient, options?: ShowViewsOptions): Promise<CatalogResult>;
-interface ShowMaterializedViewsOptions extends ShowScopedOptions {}
-declare function showMaterializedViews(client: SnowflakeClient, options?: ShowMaterializedViewsOptions): Promise<CatalogResult>;
-interface ShowColumnsOptions extends ShowOptions {
-  readonly inTable?: {
-    readonly database?: string;
-    readonly schema?: string;
-    readonly table: string;
-  };
-  readonly inView?: {
-    readonly database?: string;
-    readonly schema?: string;
-    readonly view: string;
-  };
-  readonly inSchema?: {
-    readonly database: string;
-    readonly schema: string;
-  };
-  readonly inDatabase?: string;
-}
-declare function showColumns(client: SnowflakeClient, options?: ShowColumnsOptions): Promise<CatalogResult>;
-declare function showWarehouses(client: SnowflakeClient, options?: ShowOptions): Promise<CatalogResult>;
-declare function showRoles(client: SnowflakeClient, options?: ShowOptions): Promise<CatalogResult>;
-declare function showUsers(client: SnowflakeClient, options?: ShowOptions): Promise<CatalogResult>;
-declare function showStages(client: SnowflakeClient, options?: ShowScopedOptions): Promise<CatalogResult>;
-declare function showPipes(client: SnowflakeClient, options?: ShowScopedOptions): Promise<CatalogResult>;
-declare function showTasks(client: SnowflakeClient, options?: ShowScopedOptions & {
-  readonly terse?: boolean;
-}): Promise<CatalogResult>;
-declare function showStreams(client: SnowflakeClient, options?: ShowScopedOptions): Promise<CatalogResult>;
-declare function showShares(client: SnowflakeClient, options?: ShowOptions): Promise<CatalogResult>;
-declare function showFunctions(client: SnowflakeClient, options?: ShowScopedOptions): Promise<CatalogResult>;
-declare function showProcedures(client: SnowflakeClient, options?: ShowScopedOptions): Promise<CatalogResult>;
-declare function showFileFormats(client: SnowflakeClient, options?: ShowScopedOptions): Promise<CatalogResult>;
-interface ShowGrantsOptions extends ShowOptions {
-  /** `SHOW GRANTS ON <object>`. Object keyword is caller-provided (TABLE, DATABASE, etc.). */
-  readonly on?: {
-    readonly objectType: string;
-    readonly name: string;
-    readonly schema?: string;
-    readonly database?: string;
-  };
-  /** `SHOW GRANTS TO {ROLE | USER | SHARE} <name>`. */
-  readonly toRole?: string;
-  readonly toUser?: string;
-  readonly toShare?: string;
-  /** `SHOW GRANTS OF ROLE <name>`. */
-  readonly ofRole?: string;
-  readonly ofShare?: string;
-}
-declare function showGrants(client: SnowflakeClient, options?: ShowGrantsOptions): Promise<CatalogResult>;
-interface DescribeTableOptions extends Pick<ShowOptions, 'warehouse' | 'role'> {
-  readonly database?: string;
-  readonly schema?: string;
-  readonly table: string;
-  /** `DESCRIBE TABLE X TYPE = STAGE | COLUMNS` (default COLUMNS). */
-  readonly type?: 'COLUMNS' | 'STAGE';
-}
-declare function describeTable(client: SnowflakeClient, options: DescribeTableOptions): Promise<CatalogResult>;
-interface ExploreColumnsOptions extends Pick<ShowOptions, 'warehouse' | 'role'> {
-  readonly database?: string;
-  readonly schema?: string;
-  readonly table: string;
-  /** Restrict to these columns; when empty, all columns are sampled. */
-  readonly columns?: readonly string[];
-  /** Distinct-value sample cap per column (default 100). */
-  readonly limit?: number;
-}
-interface ExploreColumnsResult {
-  readonly table: string;
-  readonly samples: readonly {
-    readonly column: string;
-    readonly distinctValues: readonly unknown[];
-  }[];
-}
-/**
- * Composio `SNOWFLAKE_BASIC_EXPLORE_COLUMNS` parity — pull a small distinct
- * sample from each requested column to help LLMs disambiguate column
- * semantics.
- */
-declare function exploreColumns(client: SnowflakeClient, options: ExploreColumnsOptions): Promise<ExploreColumnsResult>;
-interface FindDatabasesOptions extends ShowOptions {
-  /** Optional case-insensitive substring match applied client-side. */
-  readonly nameContains?: string;
-}
-declare function findDatabases(client: SnowflakeClient, options?: FindDatabasesOptions): Promise<CatalogResult>;
-interface FindSchemasOptions extends ShowSchemasOptions {
-  readonly nameContains?: string;
-}
-declare function findSchemas(client: SnowflakeClient, options?: FindSchemasOptions): Promise<CatalogResult>;
-interface FindTablesOptions extends ShowTablesOptions {
-  readonly nameContains?: string;
-}
-declare function findTables(client: SnowflakeClient, options?: FindTablesOptions): Promise<CatalogResult>;
-//#endregion
-export { CatalogResult, DescribeTableOptions, ExploreColumnsOptions, ExploreColumnsResult, FindDatabasesOptions, FindSchemasOptions, FindTablesOptions, ShowColumnsOptions, ShowDatabasesOptions, ShowGrantsOptions, ShowMaterializedViewsOptions, ShowOptions, ShowSchemasOptions, ShowScopedOptions, ShowTablesOptions, ShowViewsOptions, describeTable, exploreColumns, findDatabases, findSchemas, findTables, showColumns, showDatabases, showFileFormats, showFunctions, showGrants, showMaterializedViews, showPipes, showProcedures, showRoles, showSchemas, showShares, showStages, showStreams, showTables, showTasks, showUsers, showViews, showWarehouses };

package/dist/catalog/index.mjs

@@ -1,158 +0,0 @@
-import { executeSql } from "../sql/index.mjs";
-import { i as quoteIdentifier, n as inClause, r as likeClause, t as buildFqn } from "../sql-safety-BZpAPsq6.mjs";
-
-//#region src/catalog/index.ts
-function limitClause(limit) {
-	return limit && limit > 0 ? ` LIMIT ${Math.floor(limit)}` : "";
-}
-function toScope(options) {
-	if (options.inAccount) return " IN ACCOUNT";
-	if (options.inSchema) return inClause("SCHEMA", buildFqn(options.inSchema.database, options.inSchema.schema));
-	if (options.inDatabase) return inClause("DATABASE", quoteIdentifier(options.inDatabase));
-	return "";
-}
-async function runShow(client, sql, ctx) {
-	const result = await executeSql(client, {
-		statement: sql,
-		warehouse: ctx.warehouse,
-		role: ctx.role,
-		database: ctx.database,
-		schema: ctx.schema
-	});
-	return {
-		rows: result.rows,
-		columns: result.columns.map((c) => ({
-			name: c.name,
-			type: c.type
-		}))
-	};
-}
-async function showDatabases(client, options = {}) {
-	return runShow(client, `SHOW DATABASES${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showSchemas(client, options = {}) {
-	return runShow(client, `SHOW${options.history ? " HISTORY" : ""} SCHEMAS${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showTables(client, options = {}) {
-	return runShow(client, `SHOW${options.terse ? " TERSE" : ""}${options.history ? " HISTORY" : ""} TABLES${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showViews(client, options = {}) {
-	return runShow(client, `SHOW${options.terse ? " TERSE" : ""} VIEWS${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showMaterializedViews(client, options = {}) {
-	return runShow(client, `SHOW MATERIALIZED VIEWS${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showColumns(client, options = {}) {
-	let scope = "";
-	if (options.inTable) scope = ` IN TABLE ${buildFqn(options.inTable.database, options.inTable.schema, options.inTable.table)}`;
-	else if (options.inView) scope = ` IN VIEW ${buildFqn(options.inView.database, options.inView.schema, options.inView.view)}`;
-	else if (options.inSchema) scope = ` IN SCHEMA ${buildFqn(options.inSchema.database, options.inSchema.schema)}`;
-	else if (options.inDatabase) scope = ` IN DATABASE ${quoteIdentifier(options.inDatabase)}`;
-	return runShow(client, `SHOW COLUMNS${scope}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showWarehouses(client, options = {}) {
-	return runShow(client, `SHOW WAREHOUSES${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showRoles(client, options = {}) {
-	return runShow(client, `SHOW ROLES${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showUsers(client, options = {}) {
-	return runShow(client, `SHOW USERS${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showStages(client, options = {}) {
-	return runShow(client, `SHOW STAGES${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showPipes(client, options = {}) {
-	return runShow(client, `SHOW PIPES${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showTasks(client, options = {}) {
-	return runShow(client, `SHOW${options.terse ? " TERSE" : ""} TASKS${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showStreams(client, options = {}) {
-	return runShow(client, `SHOW STREAMS${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showShares(client, options = {}) {
-	return runShow(client, `SHOW SHARES${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showFunctions(client, options = {}) {
-	return runShow(client, `SHOW FUNCTIONS${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showProcedures(client, options = {}) {
-	return runShow(client, `SHOW PROCEDURES${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showFileFormats(client, options = {}) {
-	return runShow(client, `SHOW FILE FORMATS${toScope(options)}${likeClause(options.like)}${limitClause(options.limit)}`, options);
-}
-async function showGrants(client, options = {}) {
-	let tail = "";
-	if (options.on) {
-		const fqn = buildFqn(options.on.database, options.on.schema, options.on.name);
-		tail = ` ON ${options.on.objectType.toUpperCase()} ${fqn}`;
-	} else if (options.toRole) tail = ` TO ROLE ${quoteIdentifier(options.toRole)}`;
-	else if (options.toUser) tail = ` TO USER ${quoteIdentifier(options.toUser)}`;
-	else if (options.toShare) tail = ` TO SHARE ${quoteIdentifier(options.toShare)}`;
-	else if (options.ofRole) tail = ` OF ROLE ${quoteIdentifier(options.ofRole)}`;
-	else if (options.ofShare) tail = ` OF SHARE ${quoteIdentifier(options.ofShare)}`;
-	return runShow(client, `SHOW GRANTS${tail}${likeClause(options.like)}`, options);
-}
-async function describeTable(client, options) {
-	return runShow(client, `DESCRIBE TABLE ${buildFqn(options.database, options.schema, options.table)}${options.type ? ` TYPE = ${options.type}` : ""}`, options);
-}
-/**
-* Composio `SNOWFLAKE_BASIC_EXPLORE_COLUMNS` parity — pull a small distinct
-* sample from each requested column to help LLMs disambiguate column
-* semantics.
-*/
-async function exploreColumns(client, options) {
-	const fqn = buildFqn(options.database, options.schema, options.table);
-	const columns = options.columns && options.columns.length > 0 ? options.columns : (await describeTable(client, options)).rows.map((row) => row.name ?? row.NAME).filter((name) => Boolean(name));
-	const limit = options.limit ?? 100;
-	const samples = [];
-	for (const column of columns) {
-		const distinctValues = (await executeSql(client, {
-			statement: `SELECT DISTINCT ${quoteIdentifier(column)} AS v FROM ${fqn} LIMIT ${Math.max(1, Math.floor(limit))}`,
-			warehouse: options.warehouse,
-			role: options.role
-		})).rows.map((row) => row.V ?? row.v);
-		samples.push({
-			column,
-			distinctValues
-		});
-	}
-	return {
-		table: fqn,
-		samples
-	};
-}
-function applyNameFilter(rows, substring) {
-	if (!substring) return [...rows];
-	const needle = substring.toLowerCase();
-	return rows.filter((row) => {
-		const name = row.name ?? row.NAME;
-		return typeof name === "string" && name.toLowerCase().includes(needle);
-	});
-}
-async function findDatabases(client, options = {}) {
-	const result = await showDatabases(client, options);
-	return {
-		columns: result.columns,
-		rows: applyNameFilter(result.rows, options.nameContains)
-	};
-}
-async function findSchemas(client, options = {}) {
-	const result = await showSchemas(client, options);
-	return {
-		columns: result.columns,
-		rows: applyNameFilter(result.rows, options.nameContains)
-	};
-}
-async function findTables(client, options = {}) {
-	const result = await showTables(client, options);
-	return {
-		columns: result.columns,
-		rows: applyNameFilter(result.rows, options.nameContains)
-	};
-}
-
-//#endregion
-export { describeTable, exploreColumns, findDatabases, findSchemas, findTables, showColumns, showDatabases, showFileFormats, showFunctions, showGrants, showMaterializedViews, showPipes, showProcedures, showRoles, showSchemas, showShares, showStages, showStreams, showTables, showTasks, showUsers, showViews, showWarehouses };

package/dist/client/index.d.mts

@@ -1,44 +0,0 @@
-import { n as SnowflakeCredentials } from "../snowflake.credential-set-BxT7Gf3A.mjs";
-import { t as RetryPolicy } from "../retry-w7cTp1QL.mjs";
-
-//#region src/client/index.d.ts
-type SnowflakeAuthTokenType = 'KEYPAIR_JWT' | 'OAUTH' | 'PROGRAMMATIC_ACCESS_TOKEN' | 'BASIC';
-type SnowflakeHttpMethod = 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
-type QueryPrimitive = string | number | boolean;
-type SnowflakeQueryValue = QueryPrimitive | readonly QueryPrimitive[] | null | undefined;
-interface SnowflakeQuery {
-  readonly [key: string]: SnowflakeQueryValue;
-}
-interface SnowflakeRequestInit {
-  readonly method?: SnowflakeHttpMethod;
-  readonly body?: unknown;
-  readonly query?: SnowflakeQuery;
-  readonly headers?: Readonly<Record<string, string>>;
-  readonly timeoutMs?: number;
-  readonly requestId?: string;
-  /** Raw body; when true the response object is returned verbatim. */
-  readonly raw?: boolean;
-  /** Disable retries for this call (statement cancel, etc.). */
-  readonly retry?: boolean | RetryPolicy;
-}
-interface SnowflakeClientOptions {
-  readonly fetchImpl?: typeof fetch;
-  readonly timeoutMs?: number;
-  readonly retry?: RetryPolicy;
-  readonly sleep?: (ms: number) => Promise<void>;
-  readonly now?: () => number;
-  readonly userAgent?: string;
-  readonly randomUUID?: () => string;
-}
-interface SnowflakeClient {
-  readonly host: string;
-  readonly account: string;
-  readonly credentials: SnowflakeCredentials;
-  request<T = unknown>(path: string, init?: SnowflakeRequestInit): Promise<T>;
-  requestRaw(path: string, init?: SnowflakeRequestInit): Promise<Response>;
-  buildUrl(path: string, query?: SnowflakeQuery): string;
-}
-declare function createSnowflakeClient(rawCredentials: SnowflakeCredentials | unknown, options?: SnowflakeClientOptions): SnowflakeClient;
-declare function resolveHost(credentials: SnowflakeCredentials): string;
-//#endregion
-export { SnowflakeAuthTokenType, SnowflakeClient, SnowflakeClientOptions, SnowflakeHttpMethod, SnowflakeQuery, SnowflakeQueryValue, SnowflakeRequestInit, createSnowflakeClient, resolveHost };

package/dist/client/index.mjs

@@ -1,273 +0,0 @@
-import { t as parseSnowflakeCredentials } from "../snowflake.credential-set-DE3gXf-a.mjs";
-import { a as extractSnowflakeMessage, c as parseRetryAfterHeader, i as extractSnowflakeCode, n as SnowflakeSqlError, o as extractSnowflakeSqlState, r as classifySnowflakeHttpStatus, s as extractSnowflakeStatementHandle, t as SnowflakeApiError } from "../errors-60AsF7Su.mjs";
-import { a as createSnowflakeJwt, i as shouldRetry, n as computeBackoffMs, r as defaultSleep, t as DEFAULT_RETRY_POLICY } from "../retry-B4-9MZIp.mjs";
-
-//#region src/client/index.ts
-/**
-* Core HTTP client for the Snowflake integration.
-*
-* Shape — kept intentionally generic so the same client backs every domain
-* module (SQL API v2, Snowpipe REST, org-admin REST). Higher-level helpers
-* (`sql.ts`, `pipes.ts`, ...) consume `SnowflakeClient.request` and layer
-* their own schemas on top.
-*
-* Responsibilities:
-*  - resolve credentials -> `Authorization` header + auth-token-type header
-*  - sign JWTs for `mode=keypair` and cache them until expiry
-*  - apply default retry policy with exponential backoff + `Retry-After`
-*  - classify non-2xx responses into structured errors (see `errors.ts`)
-*  - attach a deterministic `requestId` for idempotent statement submission
-*/
-const DEFAULT_TIMEOUT_MS = 3e4;
-const JWT_REFRESH_SKEW_SECONDS = 60;
-const USER_AGENT = "keystroke-snowflake/0.0.0";
-function createSnowflakeClient(rawCredentials, options = {}) {
-	const credentials = isSnowflakeCredentials(rawCredentials) ? rawCredentials : parseSnowflakeCredentials(rawCredentials);
-	const fetchImpl = options.fetchImpl ?? fetch;
-	const sleep = options.sleep ?? defaultSleep;
-	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-	const retryPolicy = options.retry ?? DEFAULT_RETRY_POLICY;
-	const now = options.now ?? (() => Date.now());
-	const userAgent = options.userAgent ?? USER_AGENT;
-	const randomUUID = options.randomUUID ?? (() => typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : pseudoRandomUuid());
-	const host = resolveHost(credentials);
-	const account = credentials.SNOWFLAKE_ACCOUNT.trim();
-	let cachedJwt;
-	async function authorization() {
-		if (credentials.mode === "keypair") {
-			const nowMs = now();
-			if (!cachedJwt || cachedJwt.expiresAtMs - JWT_REFRESH_SKEW_SECONDS * 1e3 <= nowMs) {
-				if (!credentials.SNOWFLAKE_USER || !credentials.SNOWFLAKE_PRIVATE_KEY) throw new SnowflakeApiError({
-					kind: "auth",
-					status: 0,
-					message: "SNOWFLAKE_USER and SNOWFLAKE_PRIVATE_KEY are required for keypair mode"
-				});
-				const jwt = await createSnowflakeJwt({
-					account,
-					user: credentials.SNOWFLAKE_USER,
-					privateKeyPem: credentials.SNOWFLAKE_PRIVATE_KEY,
-					publicKeyFingerprint: credentials.SNOWFLAKE_PUBLIC_KEY_FP,
-					now: () => nowMs
-				});
-				cachedJwt = {
-					token: jwt.token,
-					expiresAtMs: jwt.expiresAt * 1e3
-				};
-			}
-			return {
-				header: `Bearer ${cachedJwt.token}`,
-				tokenType: "KEYPAIR_JWT"
-			};
-		}
-		if (credentials.mode === "oauth") {
-			if (!credentials.SNOWFLAKE_OAUTH_ACCESS_TOKEN) throw new SnowflakeApiError({
-				kind: "auth",
-				status: 0,
-				message: "SNOWFLAKE_OAUTH_ACCESS_TOKEN is required for oauth mode"
-			});
-			return {
-				header: `Bearer ${credentials.SNOWFLAKE_OAUTH_ACCESS_TOKEN}`,
-				tokenType: "OAUTH"
-			};
-		}
-		if (credentials.mode === "pat") {
-			if (!credentials.SNOWFLAKE_PAT) throw new SnowflakeApiError({
-				kind: "auth",
-				status: 0,
-				message: "SNOWFLAKE_PAT is required for pat mode"
-			});
-			return {
-				header: `Bearer ${credentials.SNOWFLAKE_PAT}`,
-				tokenType: "PROGRAMMATIC_ACCESS_TOKEN"
-			};
-		}
-		if (!credentials.SNOWFLAKE_USER || !credentials.SNOWFLAKE_PASSWORD) throw new SnowflakeApiError({
-			kind: "auth",
-			status: 0,
-			message: "SNOWFLAKE_USER and SNOWFLAKE_PASSWORD are required for basic mode"
-		});
-		return {
-			header: `Basic ${base64EncodeString(`${credentials.SNOWFLAKE_USER}:${credentials.SNOWFLAKE_PASSWORD}`)}`,
-			tokenType: "BASIC"
-		};
-	}
-	function buildUrl(path, query) {
-		return `${path.startsWith("http://") || path.startsWith("https://") ? path : `https://${host}${path.startsWith("/") ? path : `/${path}`}`}${toQueryString(query)}`;
-	}
-	async function requestRaw(path, init = {}) {
-		const method = init.method ?? "GET";
-		const policy = resolveRetryPolicy(init.retry, retryPolicy);
-		const attemptTimeoutMs = init.timeoutMs ?? timeoutMs;
-		const requestId = init.requestId ?? randomUUID();
-		const url = buildUrl(path, {
-			...init.query ?? {},
-			...method === "POST" && path.includes("/api/v2/statements") ? { requestId } : {}
-		});
-		let body;
-		const headers = {
-			Accept: "application/json",
-			"User-Agent": userAgent,
-			...init.headers
-		};
-		if (init.body !== void 0) {
-			headers["Content-Type"] = "application/json";
-			body = JSON.stringify(init.body);
-		}
-		let attempt = 0;
-		for (;;) {
-			const auth = await authorization();
-			headers.Authorization = auth.header;
-			headers["X-Snowflake-Authorization-Token-Type"] = auth.tokenType;
-			const controller = new AbortController();
-			const timer = setTimeout(() => controller.abort(), attemptTimeoutMs);
-			let response;
-			try {
-				response = await fetchImpl(url, {
-					method,
-					headers,
-					...body !== void 0 ? { body } : {},
-					signal: controller.signal
-				});
-			} catch (error) {
-				clearTimeout(timer);
-				const isAbort = error instanceof Error && (error.name === "AbortError" || /aborted|abort/iu.test(error.message));
-				const kind = isAbort ? "timeout" : "network";
-				if (policy && shouldRetry(kind, attempt, policy)) {
-					attempt += 1;
-					await sleep(computeBackoffMs({
-						attempt,
-						policy
-					}));
-					continue;
-				}
-				throw new SnowflakeApiError({
-					kind,
-					status: 0,
-					message: isAbort ? `Request to \`${path}\` timed out after ${attemptTimeoutMs}ms` : `Request to \`${path}\` failed: ${error?.message ?? String(error)}`,
-					requestId,
-					cause: error
-				});
-			}
-			clearTimeout(timer);
-			if (response.ok || response.status === 202) return response;
-			const parsed = await readResponseBody(response);
-			const retryAfterMs = parseRetryAfterHeader(response.headers.get("retry-after"));
-			const kind = classifySnowflakeHttpStatus(response.status);
-			if (policy && shouldRetry(kind, attempt, policy)) {
-				attempt += 1;
-				await sleep(computeBackoffMs({
-					attempt,
-					retryAfterMs,
-					policy
-				}));
-				continue;
-			}
-			throw toStructuredError({
-				response,
-				body: parsed,
-				requestId,
-				retryAfterMs
-			});
-		}
-	}
-	async function request(path, init = {}) {
-		const response = await requestRaw(path, init);
-		if (init.raw) return response;
-		if (response.status === 204) return void 0;
-		return await readResponseBody(response);
-	}
-	return {
-		host,
-		account,
-		credentials,
-		request,
-		requestRaw,
-		buildUrl
-	};
-}
-function resolveRetryPolicy(override, fallback) {
-	if (override === false) return void 0;
-	if (override === true || override === void 0) return fallback;
-	return override;
-}
-async function readResponseBody(response) {
-	if ((response.headers.get("content-type") ?? "").includes("application/json")) return response.json().catch(() => void 0);
-	return response.text().catch(() => void 0);
-}
-function toStructuredError(args) {
-	const { response, body, requestId, retryAfterMs } = args;
-	const kind = classifySnowflakeHttpStatus(response.status);
-	const message = extractSnowflakeMessage(body) ?? `Snowflake HTTP ${response.status} (${response.statusText})`;
-	const providerCode = extractSnowflakeCode(body);
-	const snowflakeRequestId = response.headers.get("x-snowflake-request-id") ?? void 0;
-	if (response.status === 422) return new SnowflakeSqlError({
-		kind: "sql",
-		status: response.status,
-		message,
-		body,
-		providerCode,
-		requestId: snowflakeRequestId ?? requestId,
-		retryAfterMs,
-		sqlState: extractSnowflakeSqlState(body),
-		code: providerCode,
-		statementHandle: extractSnowflakeStatementHandle(body)
-	});
-	return new SnowflakeApiError({
-		kind,
-		status: response.status,
-		message,
-		body,
-		providerCode,
-		requestId: snowflakeRequestId ?? requestId,
-		retryAfterMs
-	});
-}
-function resolveHost(credentials) {
-	if (credentials.SNOWFLAKE_HOST) return stripProtocol(credentials.SNOWFLAKE_HOST).replace(/\/+$/u, "");
-	const account = credentials.SNOWFLAKE_ACCOUNT.trim();
-	const region = credentials.SNOWFLAKE_REGION?.trim();
-	if (region && !account.includes(".") && !account.includes("-")) return `${account}.${region}.snowflakecomputing.com`;
-	if (/snowflakecomputing\.com$/u.test(account)) return account;
-	return `${account}.snowflakecomputing.com`;
-}
-function stripProtocol(host) {
-	return host.replace(/^https?:\/\//u, "");
-}
-function toQueryString(query) {
-	if (!query) return "";
-	const params = new URLSearchParams();
-	for (const [key, value] of Object.entries(query)) {
-		if (value === void 0 || value === null) continue;
-		if (Array.isArray(value)) {
-			for (const item of value) params.append(key, String(item));
-			continue;
-		}
-		params.set(key, String(value));
-	}
-	const qs = params.toString();
-	return qs.length > 0 ? `?${qs}` : "";
-}
-function isSnowflakeCredentials(value) {
-	if (typeof value !== "object" || value === null) return false;
-	const mode = value.mode;
-	return mode === "keypair" || mode === "oauth" || mode === "pat" || mode === "basic";
-}
-function base64EncodeString(input) {
-	if (typeof btoa === "function") return btoa(unescape(encodeURIComponent(input)));
-	/* c8 ignore next */
-	return Buffer.from(input, "utf8").toString("base64");
-}
-function pseudoRandomUuid() {
-	/* c8 ignore start */
-	const bytes = new Uint8Array(16);
-	for (let i = 0; i < 16; i += 1) bytes[i] = Math.floor(Math.random() * 256);
-	bytes[6] = (bytes[6] ?? 0) & 15 | 64;
-	bytes[8] = (bytes[8] ?? 0) & 63 | 128;
-	const hex = [];
-	for (const b of bytes) hex.push(b.toString(16).padStart(2, "0"));
-	return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10, 16).join("")}`;
-	/* c8 ignore end */
-}
-
-//#endregion
-export { createSnowflakeClient, resolveHost };