@keystrokehq/snowflake 0.0.16 → 0.0.18

package/dist/status-page/index.mjs

@@ -1,261 +0,0 @@
-import { z } from "zod";
-
-//#region src/status-page/index.ts
-/**
-* Snowflake status-page client (status.snowflake.com — Statuspage.io surface).
-*
-* Covers PLAN §6.20 (7 actions). These endpoints are public, require no
-* credentials, and live on a completely different host from the SQL API,
-* so the helpers are independent of `SnowflakeClient`. Every function
-* takes a standalone options bag (`fetchImpl`, `baseUrl`, `timeoutMs`)
-* so callers can point the integration at a mirror, a fixture, or a
-* proxy without rebuilding a full Snowflake client.
-*
-* Response shapes are validated with Zod against the documented
-* Statuspage.io JSON contract; extra fields are allowed (via `catchall`)
-* so new optional metadata does not break the client.
-*/
-const DEFAULT_BASE_URL = "https://status.snowflake.com";
-const DEFAULT_TIMEOUT_MS = 15e3;
-const statusPagePageSchema = z.object({
-	id: z.string(),
-	name: z.string(),
-	url: z.string(),
-	time_zone: z.string().optional(),
-	updated_at: z.string()
-}).catchall(z.unknown());
-const statusPageIndicatorSchema = z.enum([
-	"none",
-	"minor",
-	"major",
-	"critical",
-	"maintenance"
-]);
-const statusPageOverallStatusSchema = z.object({
-	indicator: statusPageIndicatorSchema,
-	description: z.string()
-}).catchall(z.unknown());
-const statusPageComponentStatusSchema = z.enum([
-	"operational",
-	"degraded_performance",
-	"partial_outage",
-	"major_outage",
-	"under_maintenance"
-]);
-const statusPageComponentSchema = z.object({
-	id: z.string(),
-	name: z.string(),
-	status: statusPageComponentStatusSchema,
-	created_at: z.string(),
-	updated_at: z.string(),
-	position: z.number().optional(),
-	description: z.string().nullable().optional(),
-	showcase: z.boolean().optional(),
-	group_id: z.string().nullable().optional(),
-	page_id: z.string().optional(),
-	group: z.boolean().optional(),
-	only_show_if_degraded: z.boolean().optional(),
-	components: z.array(z.string()).optional()
-}).catchall(z.unknown());
-const statusPageIncidentUpdateSchema = z.object({
-	id: z.string(),
-	status: z.string(),
-	body: z.string(),
-	created_at: z.string(),
-	updated_at: z.string(),
-	display_at: z.string().optional(),
-	affected_components: z.array(z.object({
-		code: z.string().optional(),
-		name: z.string().optional(),
-		old_status: z.string().optional(),
-		new_status: z.string().optional()
-	}).catchall(z.unknown())).optional()
-}).catchall(z.unknown());
-const statusPageIncidentSchema = z.object({
-	id: z.string(),
-	name: z.string(),
-	status: z.string(),
-	impact: z.string().optional(),
-	created_at: z.string(),
-	updated_at: z.string(),
-	monitoring_at: z.string().nullable().optional(),
-	resolved_at: z.string().nullable().optional(),
-	shortlink: z.string().optional(),
-	started_at: z.string().optional(),
-	page_id: z.string().optional(),
-	incident_updates: z.array(statusPageIncidentUpdateSchema).optional(),
-	components: z.array(statusPageComponentSchema).optional()
-}).catchall(z.unknown());
-const statusPageScheduledMaintenanceSchema = z.object({
-	id: z.string(),
-	name: z.string(),
-	status: z.string(),
-	impact: z.string().optional(),
-	created_at: z.string(),
-	updated_at: z.string(),
-	monitoring_at: z.string().nullable().optional(),
-	resolved_at: z.string().nullable().optional(),
-	scheduled_for: z.string(),
-	scheduled_until: z.string(),
-	shortlink: z.string().optional(),
-	started_at: z.string().nullable().optional(),
-	page_id: z.string().optional(),
-	incident_updates: z.array(statusPageIncidentUpdateSchema).optional(),
-	components: z.array(statusPageComponentSchema).optional()
-}).catchall(z.unknown());
-const summaryResponseSchema = z.object({
-	page: statusPagePageSchema,
-	status: statusPageOverallStatusSchema,
-	components: z.array(statusPageComponentSchema),
-	incidents: z.array(statusPageIncidentSchema),
-	scheduled_maintenances: z.array(statusPageScheduledMaintenanceSchema)
-}).catchall(z.unknown());
-const rollupResponseSchema = z.object({
-	page: statusPagePageSchema,
-	status: statusPageOverallStatusSchema
-}).catchall(z.unknown());
-const componentsResponseSchema = z.object({
-	page: statusPagePageSchema,
-	components: z.array(statusPageComponentSchema)
-}).catchall(z.unknown());
-const incidentsResponseSchema = z.object({
-	page: statusPagePageSchema,
-	incidents: z.array(statusPageIncidentSchema)
-}).catchall(z.unknown());
-const maintenancesResponseSchema = z.object({
-	page: statusPagePageSchema,
-	scheduled_maintenances: z.array(statusPageScheduledMaintenanceSchema)
-}).catchall(z.unknown());
-/**
-* Error thrown when the status-page endpoint returns a non-2xx response or
-* a body that fails Zod validation.
-*/
-var SnowflakeStatusPageError = class extends Error {
-	name = "SnowflakeStatusPageError";
-	status;
-	url;
-	body;
-	constructor(input) {
-		super(input.message, input.cause !== void 0 ? { cause: input.cause } : void 0);
-		this.status = input.status;
-		this.url = input.url;
-		this.body = input.body;
-	}
-};
-function joinPath(baseUrl, path) {
-	return `${baseUrl.replace(/\/+$/u, "")}${path.startsWith("/") ? path : `/${path}`}`;
-}
-function composeSignal(timeoutMs, external) {
-	const controller = new AbortController();
-	const onExternalAbort = () => controller.abort(external?.reason);
-	if (external) if (external.aborted) controller.abort(external.reason);
-	else external.addEventListener("abort", onExternalAbort, { once: true });
-	const timer = setTimeout(() => controller.abort(/* @__PURE__ */ new Error(`status-page request timed out after ${timeoutMs}ms`)), timeoutMs);
-	return {
-		signal: controller.signal,
-		cleanup: () => {
-			clearTimeout(timer);
-			if (external) external.removeEventListener("abort", onExternalAbort);
-		}
-	};
-}
-async function fetchJson(path, schema, options) {
-	const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
-	const fetchImpl = options.fetchImpl ?? fetch;
-	const url = joinPath(baseUrl, path);
-	const { signal, cleanup } = composeSignal(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, options.signal);
-	let response;
-	try {
-		response = await fetchImpl(url, {
-			method: "GET",
-			headers: {
-				Accept: "application/json",
-				...options.headers
-			},
-			signal
-		});
-	} catch (cause) {
-		throw new SnowflakeStatusPageError({
-			message: `status-page GET ${url} failed before reading a response`,
-			status: 0,
-			url,
-			cause
-		});
-	} finally {
-		cleanup();
-	}
-	if (!response.ok) {
-		const body = await response.text().catch(() => void 0);
-		throw new SnowflakeStatusPageError({
-			message: `status-page GET ${url} returned HTTP ${response.status}`,
-			status: response.status,
-			url,
-			body
-		});
-	}
-	let payload;
-	try {
-		payload = await response.json();
-	} catch (cause) {
-		throw new SnowflakeStatusPageError({
-			message: `status-page GET ${url} returned non-JSON body`,
-			status: response.status,
-			url,
-			cause
-		});
-	}
-	const parsed = schema.safeParse(payload);
-	if (!parsed.success) throw new SnowflakeStatusPageError({
-		message: `status-page GET ${url} response failed validation: ${parsed.error.message}`,
-		status: response.status,
-		url,
-		cause: parsed.error
-	});
-	return parsed.data;
-}
-/** `GET /api/v2/summary.json` — overall page, components, active incidents, maintenances. */
-async function getStatusSummary(options = {}) {
-	return fetchJson("/api/v2/summary.json", summaryResponseSchema, options);
-}
-/** `GET /api/v2/status.json` — top-level indicator + description only. */
-async function getStatusRollup(options = {}) {
-	return fetchJson("/api/v2/status.json", rollupResponseSchema, options);
-}
-/**
-* `GET /api/v2/components.json` — returns every component. When `componentId`
-* or `name` are provided, the result is filtered client-side because the
-* Statuspage.io public endpoint does not expose a server-side filter.
-*/
-async function getComponentStatus(options = {}) {
-	const response = await fetchJson("/api/v2/components.json", componentsResponseSchema, options);
-	const { componentId, name } = options;
-	let components = response.components;
-	if (componentId) components = components.filter((c) => c.id === componentId);
-	if (name) {
-		const target = name.toLowerCase();
-		components = components.filter((c) => c.name.toLowerCase() === target);
-	}
-	return {
-		page: response.page,
-		components
-	};
-}
-/** `GET /api/v2/incidents/unresolved.json` — active, non-resolved incidents. */
-async function getUnresolvedIncidents(options = {}) {
-	return fetchJson("/api/v2/incidents/unresolved.json", incidentsResponseSchema, options);
-}
-/** `GET /api/v2/scheduled-maintenances/active.json` — maintenances currently in progress. */
-async function getActiveScheduledMaintenances(options = {}) {
-	return fetchJson("/api/v2/scheduled-maintenances/active.json", maintenancesResponseSchema, options);
-}
-/** `GET /api/v2/scheduled-maintenances.json` — every scheduled maintenance on record. */
-async function getAllScheduledMaintenances(options = {}) {
-	return fetchJson("/api/v2/scheduled-maintenances.json", maintenancesResponseSchema, options);
-}
-/** `GET /api/v2/scheduled-maintenances/upcoming.json` — maintenances not yet started. */
-async function getUpcomingScheduledMaintenances(options = {}) {
-	return fetchJson("/api/v2/scheduled-maintenances/upcoming.json", maintenancesResponseSchema, options);
-}
-
-//#endregion
-export { SnowflakeStatusPageError, getActiveScheduledMaintenances, getAllScheduledMaintenances, getComponentStatus, getStatusRollup, getStatusSummary, getUnresolvedIncidents, getUpcomingScheduledMaintenances, statusPageComponentSchema, statusPageComponentStatusSchema, statusPageIncidentSchema, statusPageIncidentUpdateSchema, statusPageIndicatorSchema, statusPageOverallStatusSchema, statusPagePageSchema, statusPageScheduledMaintenanceSchema };

package/dist/streaming/index.d.mts

@@ -1,70 +0,0 @@
-import { SnowflakeClient } from "../client/index.mjs";
-
-//#region src/streaming/index.d.ts
-interface StreamingChannelRef {
-  readonly database: string;
-  readonly schema: string;
-  readonly table: string;
-  readonly channel: string;
-  /** Override the base REST path prefix. */
-  readonly pathPrefix?: string;
-}
-interface OpenChannelOptions extends StreamingChannelRef {
-  readonly role?: string;
-  readonly offsetToken?: string;
-  readonly clientSequencer?: number;
-  readonly rowSequencer?: number;
-  readonly requestId?: string;
-}
-interface OpenChannelResponse {
-  readonly channel?: string;
-  readonly continuationToken?: string;
-  readonly clientSequencer?: number;
-  readonly rowSequencer?: number;
-  readonly offsetToken?: string;
-  /** Echo of the server-side Arrow / column schema descriptor. */
-  readonly tableColumns?: readonly {
-    readonly name: string;
-    readonly type?: string;
-    readonly nullable?: boolean;
-    readonly scale?: number;
-    readonly precision?: number;
-  }[];
-}
-declare function openChannel(client: SnowflakeClient, options: OpenChannelOptions): Promise<OpenChannelResponse>;
-interface AppendRowsOptions extends StreamingChannelRef {
-  readonly rows: readonly Readonly<Record<string, unknown>>[];
-  readonly continuationToken: string;
-  readonly offsetToken?: string;
-  readonly requestId?: string;
-}
-interface AppendRowsResponse {
-  readonly nextContinuationToken?: string;
-  readonly offsetToken?: string;
-  readonly rowSequencer?: number;
-  readonly invalidRows?: readonly {
-    readonly rowIndex: number;
-    readonly message: string;
-  }[];
-}
-declare function appendRows(client: SnowflakeClient, options: AppendRowsOptions): Promise<AppendRowsResponse>;
-interface GetChannelStatusOptions extends StreamingChannelRef {
-  readonly continuationToken?: string;
-  readonly requestId?: string;
-}
-interface GetChannelStatusResponse {
-  readonly channel?: string;
-  readonly continuationToken?: string;
-  readonly lastCommittedOffsetToken?: string;
-  readonly committedClientSequencer?: number;
-  readonly committedRowSequencer?: number;
-  readonly status?: 'OPEN' | 'CLOSED' | 'INVALID' | string;
-}
-declare function getChannelStatus(client: SnowflakeClient, options: GetChannelStatusOptions): Promise<GetChannelStatusResponse>;
-interface CloseChannelOptions extends StreamingChannelRef {
-  readonly continuationToken?: string;
-  readonly requestId?: string;
-}
-declare function closeChannel(client: SnowflakeClient, options: CloseChannelOptions): Promise<void>;
-//#endregion
-export { AppendRowsOptions, AppendRowsResponse, CloseChannelOptions, GetChannelStatusOptions, GetChannelStatusResponse, OpenChannelOptions, OpenChannelResponse, StreamingChannelRef, appendRows, closeChannel, getChannelStatus, openChannel };

package/dist/streaming/index.mjs

@@ -1,56 +0,0 @@
-//#region src/streaming/index.ts
-const DEFAULT_PATH_PREFIX = "/v1/streaming";
-function channelPath(ref) {
-	const prefix = ref.pathPrefix ?? DEFAULT_PATH_PREFIX;
-	const encode = (segment) => encodeURIComponent(segment);
-	return `${prefix}/databases/${encode(ref.database)}/schemas/${encode(ref.schema)}/tables/${encode(ref.table)}/channels/${encode(ref.channel)}`;
-}
-async function openChannel(client, options) {
-	const body = {
-		role: options.role,
-		offsetToken: options.offsetToken,
-		clientSequencer: options.clientSequencer,
-		rowSequencer: options.rowSequencer
-	};
-	return client.request(channelPath(options), {
-		method: "POST",
-		body,
-		requestId: options.requestId,
-		query: options.requestId ? { requestId: options.requestId } : void 0
-	});
-}
-async function appendRows(client, options) {
-	if (options.rows.length === 0) throw new Error("appendRows requires at least one row");
-	const query = { continuationToken: options.continuationToken };
-	if (options.offsetToken !== void 0) query.offsetToken = options.offsetToken;
-	if (options.requestId) query.requestId = options.requestId;
-	return client.request(`${channelPath(options)}/rows`, {
-		method: "POST",
-		body: { rows: options.rows },
-		requestId: options.requestId,
-		query
-	});
-}
-async function getChannelStatus(client, options) {
-	const query = {};
-	if (options.continuationToken) query.continuationToken = options.continuationToken;
-	if (options.requestId) query.requestId = options.requestId;
-	return client.request(`${channelPath(options)}/status`, {
-		method: "GET",
-		query
-	});
-}
-async function closeChannel(client, options) {
-	const query = { action: "close" };
-	if (options.continuationToken) query.continuationToken = options.continuationToken;
-	if (options.requestId) query.requestId = options.requestId;
-	await client.request(channelPath(options), {
-		method: "POST",
-		body: {},
-		query,
-		requestId: options.requestId
-	});
-}
-
-//#endregion
-export { appendRows, closeChannel, getChannelStatus, openChannel };

package/dist/streams/index.d.mts

@@ -1,71 +0,0 @@
-import { SnowflakeClient } from "../client/index.mjs";
-import { d as HydratedRow } from "../statements-DJL0qVNA.mjs";
-import { t as OptionMap } from "../sql-options-2k5xQ-oS.mjs";
-import { CatalogResult, ShowScopedOptions, showStreams } from "../catalog/index.mjs";
-
-//#region src/streams/index.d.ts
-interface StreamRef {
-  readonly database?: string;
-  readonly schema?: string;
-  readonly name: string;
-}
-interface StreamContext {
-  readonly warehouse?: string;
-  readonly role?: string;
-}
-type StreamSource = {
-  readonly kind: 'table';
-  readonly database?: string;
-  readonly schema?: string;
-  readonly name: string;
-} | {
-  readonly kind: 'view';
-  readonly database?: string;
-  readonly schema?: string;
-  readonly name: string;
-} | {
-  readonly kind: 'externalTable';
-  readonly database?: string;
-  readonly schema?: string;
-  readonly name: string;
-} | {
-  readonly kind: 'stage';
-  readonly database?: string;
-  readonly schema?: string;
-  readonly name: string;
-};
-interface CreateStreamOptions extends StreamRef, StreamContext {
-  readonly orReplace?: boolean;
-  readonly ifNotExists?: boolean;
-  readonly copyGrants?: boolean;
-  readonly source: StreamSource;
-  /** `APPEND_ONLY = TRUE`, `SHOW_INITIAL_ROWS = TRUE`, etc. */
-  readonly options?: OptionMap;
-  readonly comment?: string;
-  /** `AT(OFFSET => -60*5)`, `AT(STATEMENT => '<uuid>')`, `BEFORE(STATEMENT => '...')`, etc. */
-  readonly atBeforeClause?: string;
-}
-declare function createStream(client: SnowflakeClient, options: CreateStreamOptions): Promise<void>;
-interface AlterStreamOptions extends StreamRef, StreamContext {
-  readonly rename?: StreamRef;
-  readonly set?: OptionMap;
-  readonly unset?: readonly string[];
-  readonly comment?: string;
-  readonly ifExists?: boolean;
-}
-declare function alterStream(client: SnowflakeClient, options: AlterStreamOptions): Promise<void>;
-interface DropStreamOptions extends StreamRef, StreamContext {
-  readonly ifExists?: boolean;
-}
-declare function dropStream(client: SnowflakeClient, options: DropStreamOptions): Promise<void>;
-interface DescribeStreamOptions extends StreamRef, StreamContext {}
-declare function describeStream(client: SnowflakeClient, options: DescribeStreamOptions): Promise<readonly HydratedRow[]>;
-interface StreamHasDataOptions extends StreamRef, StreamContext {}
-/**
- * Wraps `SELECT SYSTEM$STREAM_HAS_DATA('<fqn>')`. Returns the normalised
- * boolean value (Snowflake returns the column as "true"/"false" strings
- * for a BOOLEAN selector).
- */
-declare function streamHasData(client: SnowflakeClient, options: StreamHasDataOptions): Promise<boolean>;
-//#endregion
-export { AlterStreamOptions, type CatalogResult, CreateStreamOptions, DescribeStreamOptions, DropStreamOptions, type ShowScopedOptions, StreamContext, StreamHasDataOptions, StreamRef, StreamSource, alterStream, createStream, describeStream, dropStream, showStreams, streamHasData };

package/dist/streams/index.mjs

@@ -1,78 +0,0 @@
-import { executeSql } from "../sql/index.mjs";
-import { a as quoteLiteral, t as buildFqn } from "../sql-safety-BZpAPsq6.mjs";
-import { t as formatOptions } from "../sql-options-D6GEa21F.mjs";
-import { showStreams } from "../catalog/index.mjs";
-
-//#region src/streams/index.ts
-function streamFqn(ref) {
-	return buildFqn(ref.database, ref.schema, ref.name);
-}
-function renderStreamSource(source) {
-	const fqn = buildFqn(source.database, source.schema, source.name);
-	switch (source.kind) {
-		case "table": return `ON TABLE ${fqn}`;
-		case "view": return `ON VIEW ${fqn}`;
-		case "externalTable": return `ON EXTERNAL TABLE ${fqn}`;
-		case "stage": return `ON STAGE ${fqn}`;
-	}
-}
-async function createStream(client, options) {
-	const prefix = `CREATE${options.orReplace ? " OR REPLACE" : ""} STREAM${options.ifNotExists ? " IF NOT EXISTS" : ""}`;
-	const copyGrants = options.copyGrants ? " COPY GRANTS" : "";
-	const source = renderStreamSource(options.source);
-	const atBefore = options.atBeforeClause ? ` ${options.atBeforeClause}` : "";
-	const body = options.options && Object.keys(options.options).length > 0 ? ` ${formatOptions(options.options)}` : "";
-	const comment = options.comment ? ` COMMENT = ${quoteLiteral(options.comment)}` : "";
-	await executeSql(client, {
-		statement: `${prefix} ${streamFqn(options)}${copyGrants} ${source}${atBefore}${body}${comment}`,
-		warehouse: options.warehouse,
-		role: options.role
-	});
-}
-async function alterStream(client, options) {
-	let tail;
-	if (options.rename) tail = `RENAME TO ${streamFqn(options.rename)}`;
-	else if (options.set && Object.keys(options.set).length > 0) tail = `SET ${formatOptions(options.set)}`;
-	else if (options.unset && options.unset.length > 0) tail = `UNSET ${options.unset.map((k) => k.toUpperCase()).join(", ")}`;
-	else if (options.comment !== void 0) tail = `SET COMMENT = ${quoteLiteral(options.comment)}`;
-	else throw new Error("alterStream requires one of: rename / set / unset / comment");
-	await executeSql(client, {
-		statement: `ALTER STREAM${options.ifExists ? " IF EXISTS" : ""} ${streamFqn(options)} ${tail}`,
-		warehouse: options.warehouse,
-		role: options.role
-	});
-}
-async function dropStream(client, options) {
-	await executeSql(client, {
-		statement: `DROP STREAM${options.ifExists ? " IF EXISTS" : ""} ${streamFqn(options)}`,
-		warehouse: options.warehouse,
-		role: options.role
-	});
-}
-async function describeStream(client, options) {
-	return (await executeSql(client, {
-		statement: `DESCRIBE STREAM ${streamFqn(options)}`,
-		warehouse: options.warehouse,
-		role: options.role
-	})).rows;
-}
-/**
-* Wraps `SELECT SYSTEM$STREAM_HAS_DATA('<fqn>')`. Returns the normalised
-* boolean value (Snowflake returns the column as "true"/"false" strings
-* for a BOOLEAN selector).
-*/
-async function streamHasData(client, options) {
-	const row = (await executeSql(client, {
-		statement: `SELECT SYSTEM$STREAM_HAS_DATA(${quoteLiteral(streamFqn(options))}) AS HAS_DATA`,
-		warehouse: options.warehouse,
-		role: options.role
-	})).rows[0];
-	if (!row) return false;
-	const value = Array.isArray(row) ? row[0] : row.HAS_DATA ?? row.has_data;
-	if (typeof value === "boolean") return value;
-	if (typeof value === "string") return value.toLowerCase() === "true";
-	return Boolean(value);
-}
-
-//#endregion
-export { alterStream, createStream, describeStream, dropStream, showStreams, streamHasData };

package/dist/tables/index.d.mts

@@ -1,2 +0,0 @@
-import { CatalogResult, DescribeTableOptions, ExploreColumnsOptions, ExploreColumnsResult, FindTablesOptions, ShowColumnsOptions, ShowTablesOptions, describeTable, exploreColumns, findTables, showColumns, showTables } from "../catalog/index.mjs";
-export { type CatalogResult, type DescribeTableOptions, type ExploreColumnsOptions, type ExploreColumnsResult, type FindTablesOptions, type ShowColumnsOptions, type ShowTablesOptions, describeTable, exploreColumns, findTables, showColumns, showTables };

package/dist/tables/index.mjs

@@ -1,3 +0,0 @@
-import { describeTable, exploreColumns, findTables, showColumns, showTables } from "../catalog/index.mjs";
-
-export { describeTable, exploreColumns, findTables, showColumns, showTables };

package/dist/tasks/index.d.mts

@@ -1,79 +0,0 @@
-import { SnowflakeClient } from "../client/index.mjs";
-import { d as HydratedRow } from "../statements-DJL0qVNA.mjs";
-import { t as OptionMap } from "../sql-options-2k5xQ-oS.mjs";
-import { CatalogResult, ShowScopedOptions, showTasks } from "../catalog/index.mjs";
-
-//#region src/tasks/index.d.ts
-interface TaskRef {
-  readonly database?: string;
-  readonly schema?: string;
-  readonly name: string;
-}
-interface TaskContext {
-  readonly warehouse?: string;
-  readonly role?: string;
-}
-interface CreateTaskOptions extends TaskRef, TaskContext {
-  readonly orReplace?: boolean;
-  readonly ifNotExists?: boolean;
-  readonly copyGrants?: boolean;
-  /** Task options: `SCHEDULE = '...'`, `WAREHOUSE = '...'`, `USER_TASK_TIMEOUT_MS = 60000`, etc. */
-  readonly options?: OptionMap;
-  /** `AFTER <predecessorFqn>[, ...]`. */
-  readonly after?: readonly TaskRef[];
-  /** `WHEN <boolean expression>`. */
-  readonly when?: string;
-  readonly comment?: string;
-  /** The SQL body the task executes (required). */
-  readonly as: string;
-}
-declare function createTask(client: SnowflakeClient, options: CreateTaskOptions): Promise<void>;
-interface AlterTaskOptions extends TaskRef, TaskContext {
-  readonly ifExists?: boolean;
-  readonly rename?: TaskRef;
-  readonly set?: OptionMap;
-  readonly unset?: readonly string[];
-  readonly addAfter?: readonly TaskRef[];
-  readonly removeAfter?: readonly TaskRef[];
-  readonly modifyAs?: string;
-  readonly modifyWhen?: string;
-  readonly comment?: string;
-}
-declare function alterTask(client: SnowflakeClient, options: AlterTaskOptions): Promise<void>;
-interface DropTaskOptions extends TaskRef, TaskContext {
-  readonly ifExists?: boolean;
-}
-declare function dropTask(client: SnowflakeClient, options: DropTaskOptions): Promise<void>;
-interface DescribeTaskOptions extends TaskRef, TaskContext {}
-declare function describeTask(client: SnowflakeClient, options: DescribeTaskOptions): Promise<readonly HydratedRow[]>;
-interface ExecuteTaskOptions extends TaskRef, TaskContext {
-  readonly retryLast?: boolean;
-}
-declare function executeTask(client: SnowflakeClient, options: ExecuteTaskOptions): Promise<void>;
-interface ResumeTaskOptions extends TaskRef, TaskContext {
-  readonly ifExists?: boolean;
-}
-declare function resumeTask(client: SnowflakeClient, options: ResumeTaskOptions): Promise<void>;
-interface SuspendTaskOptions extends TaskRef, TaskContext {
-  readonly ifExists?: boolean;
-}
-declare function suspendTask(client: SnowflakeClient, options: SuspendTaskOptions): Promise<void>;
-interface TaskHistoryOptions extends TaskContext {
-  readonly taskName?: TaskRef;
-  readonly rootTaskName?: TaskRef;
-  /** ISO-8601 timestamp. */
-  readonly scheduledTimeRangeStart?: string;
-  /** ISO-8601 timestamp. */
-  readonly scheduledTimeRangeEnd?: string;
-  /** Max rows returned (Snowflake default: 10,000). */
-  readonly resultLimit?: number;
-  /** `ERROR_ONLY => TRUE` filters to failed runs. */
-  readonly errorOnly?: boolean;
-}
-declare function showTaskHistory(client: SnowflakeClient, options?: TaskHistoryOptions): Promise<readonly HydratedRow[]>;
-interface TaskDependentsOptions extends TaskRef, TaskContext {
-  readonly recursive?: boolean;
-}
-declare function showTaskDependents(client: SnowflakeClient, options: TaskDependentsOptions): Promise<readonly HydratedRow[]>;
-//#endregion
-export { AlterTaskOptions, type CatalogResult, CreateTaskOptions, DescribeTaskOptions, DropTaskOptions, ExecuteTaskOptions, ResumeTaskOptions, type ShowScopedOptions, SuspendTaskOptions, TaskContext, TaskDependentsOptions, TaskHistoryOptions, TaskRef, alterTask, createTask, describeTask, dropTask, executeTask, resumeTask, showTaskDependents, showTaskHistory, showTasks, suspendTask };