@keboola/api-client 46.0.0 → 48.0.0

package/dist/sdk/configurations/index.d.ts

@@ -1,7 +1,5 @@
-import { B as registry, W as createStorageClient, rn as createDefaultBranch, z as RegisteredComponentId } from "../../index-BP3choXr.js";
-import { Mn as UpdateConfigurationInput, dn as CreateConfigurationInput, en as BaseComponentConfig, ln as ConfigurationPath } from "../../types-M9vU_ONp.js";
-import { t as createEncryptionClient } from "../../index-DCAnnlcL.js";
-import { t as Project } from "../../project-BpWTnoQ_.js";
+import { It as createDefaultBranch, Mo as BaseComponentConfig, Uo as CreateConfigurationInput, Vo as ConfigurationPath, dt as RegisteredComponentId, ft as registry, ps as UpdateConfigurationInput, t as createEncryptionClient, y as createStorageClient } from "../../index-B3QTeqfL.js";
+import { t as Project } from "../../project-nbv9yjpl.js";
 import { z } from "zod";
 //#region src/sdks/configurations/configurationsSdk.d.ts
 type ConfigurationSdkContext = {

package/dist/sdk/configurations/index.js

@@ -1,2 +1,2 @@
-import { t as createConfigurationSdk } from "../../configurations-DcpUlC8I.js";
+import { t as createConfigurationSdk } from "../../configurations-DKINmjA3.js";
 export { createConfigurationSdk };

package/dist/sdk/developerPortal/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_dedupe = require("../../dedupe-OSnnst2u.cjs");
 const require_store = require("../../store-xS-Cu_VS.cjs");
-const require_createFetchClient = require("../../createFetchClient-ClWD4ua3.cjs");
-const require_middleware = require("../../middleware-D_p5TctO.cjs");
-const require_developerPortalClient = require("../../developerPortalClient-COm7wJxS.cjs");
+const require_createFetchClient = require("../../createFetchClient-lZ_93Yrb.cjs");
+const require_middleware = require("../../middleware-CEP6uu_D.cjs");
+const require_developerPortalClient = require("../../developerPortalClient-DUerKw-7.cjs");
 //#region src/sdks/developerPortal/tokenExpiry.ts
 /**
 * Reads a JWT's `exp` claim as milliseconds, or `null` when unparseable ("expiry unknown", which the

package/dist/sdk/developerPortal/index.d.cts

@@ -1,6 +1,6 @@
-import { k as MiddlewareFn } from "../../index-BzhLY7el.cjs";
-import { A as ResetPasswordConfirmInput, E as PaginationQuery, F as UpdateAppAsAdminInput, I as UpdateAppInput, L as UpdateVendorAsAdminInput, N as SignUpInput, R as UpdateVendorInput, S as LoginSuccess, W as components, _ as GetVendorUsersQuery, b as LoginInput, c as ConfirmAccountInput, d as CreateVendorAsAdminInput, f as CreateVendorInput, g as GetChangesQuery, h as GetAppsQuery, k as RejectAppInput, l as CreateAppInput, p as DeprecateAppInput, s as ApproveVendorInput, t as AdminPaginationQuery, u as CreateServiceAccountInput } from "../../types-Csmy6qFk.cjs";
-import { t as DeveloperPortalTokens } from "../../index-CTKC-mwi.cjs";
+import { oi as MiddlewareFn } from "../../index-ChDl6ig5.cjs";
+import { A as ResetPasswordConfirmInput, E as PaginationQuery, F as UpdateAppAsAdminInput, I as UpdateAppInput, L as UpdateVendorAsAdminInput, N as SignUpInput, R as UpdateVendorInput, S as LoginSuccess, W as components, _ as GetVendorUsersQuery, b as LoginInput, c as ConfirmAccountInput, d as CreateVendorAsAdminInput, f as CreateVendorInput, g as GetChangesQuery, h as GetAppsQuery, k as RejectAppInput, l as CreateAppInput, p as DeprecateAppInput, s as ApproveVendorInput, t as AdminPaginationQuery, u as CreateServiceAccountInput } from "../../types-DMpiG2q4.cjs";
+import { t as DeveloperPortalTokens } from "../../index-CpGmmJbt.cjs";
 import { n as Listener } from "../../emitter-dLF1Fyfg.cjs";
 //#region src/sdks/developerPortal/developerPortalSdk.d.ts
 type DeveloperPortalSdkOptions = {

package/dist/sdk/developerPortal/index.d.ts

@@ -1,6 +1,6 @@
-import { k as MiddlewareFn } from "../../index-PyTPrtaL.js";
-import { A as ResetPasswordConfirmInput, E as PaginationQuery, F as UpdateAppAsAdminInput, I as UpdateAppInput, L as UpdateVendorAsAdminInput, N as SignUpInput, R as UpdateVendorInput, S as LoginSuccess, W as components, _ as GetVendorUsersQuery, b as LoginInput, c as ConfirmAccountInput, d as CreateVendorAsAdminInput, f as CreateVendorInput, g as GetChangesQuery, h as GetAppsQuery, k as RejectAppInput, l as CreateAppInput, p as DeprecateAppInput, s as ApproveVendorInput, t as AdminPaginationQuery, u as CreateServiceAccountInput } from "../../types-C4yryy-R.js";
-import { t as DeveloperPortalTokens } from "../../index-yJ0HrxY6.js";
+import { oi as MiddlewareFn } from "../../index-sDHBkJhU.js";
+import { A as ResetPasswordConfirmInput, E as PaginationQuery, F as UpdateAppAsAdminInput, I as UpdateAppInput, L as UpdateVendorAsAdminInput, N as SignUpInput, R as UpdateVendorInput, S as LoginSuccess, W as components, _ as GetVendorUsersQuery, b as LoginInput, c as ConfirmAccountInput, d as CreateVendorAsAdminInput, f as CreateVendorInput, g as GetChangesQuery, h as GetAppsQuery, k as RejectAppInput, l as CreateAppInput, p as DeprecateAppInput, s as ApproveVendorInput, t as AdminPaginationQuery, u as CreateServiceAccountInput } from "../../types-Cn8I0vcr.js";
+import { t as DeveloperPortalTokens } from "../../index-m7fX76x3.js";
 import { n as Listener } from "../../emitter-dLF1Fyfg.js";
 //#region src/sdks/developerPortal/developerPortalSdk.d.ts
 type DeveloperPortalSdkOptions = {

package/dist/sdk/developerPortal/index.js

@@ -1,8 +1,8 @@
 import { t as dedupe } from "../../dedupe-Cky1gSUu.js";
 import { t as createStore } from "../../store-C9FQCHGe.js";
-import { s as HttpHeader } from "../../createFetchClient-DITkTV2k.js";
-import { n as isUnauthorized } from "../../middleware-DmR6OhTY.js";
-import { t as createDeveloperPortalClient } from "../../developerPortalClient-loKq7X_U.js";
+import { s as HttpHeader } from "../../createFetchClient-CkHdS_IG.js";
+import { n as isUnauthorized } from "../../middleware-GOfx8Apu.js";
+import { t as createDeveloperPortalClient } from "../../developerPortalClient-Bb2suezr.js";
 //#region src/sdks/developerPortal/tokenExpiry.ts
 /**
 * Reads a JWT's `exp` claim as milliseconds, or `null` when unparseable ("expiry unknown", which the

package/dist/sdk/kaiMemory/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_kaiMemory = require("../../kaiMemory-Cf81ghNd.cjs");
+const require_kaiMemory = require("../../kaiMemory-Qch09f-m.cjs");
 exports.KAI_MEMORY_OBJECT_TYPE = require_kaiMemory.KAI_MEMORY_OBJECT_TYPE;
 exports.KAI_MEMORY_STATUSES = require_kaiMemory.KAI_MEMORY_STATUSES;
 exports.KaiMemoryReviewConflictError = require_kaiMemory.KaiMemoryReviewConflictError;

package/dist/sdk/kaiMemory/index.d.cts

@@ -1,4 +1,4 @@
-import { a as KaiMemoryStatus, c as KAI_MEMORY_STATUSES, o as MetastoreClient, r as KaiMemoryItem, s as UpdateKaiMemoryMeta, t as CreateKaiMemoryMeta } from "../../types-C05ALlV6.cjs";
+import { a as KaiMemoryStatus, c as KAI_MEMORY_STATUSES, o as MetastoreClient, r as KaiMemoryItem, s as UpdateKaiMemoryMeta, t as CreateKaiMemoryMeta } from "../../types-CNkQuWnO.cjs";
 //#region src/sdks/kaiMemory/kaiMemorySdk.d.ts
 /** The metastore object type this SDK addresses — see `SEMANTIC_OBJECT_TYPE` for the convention. */
 declare const KAI_MEMORY_OBJECT_TYPE = "kai-memory";

package/dist/sdk/kaiMemory/index.d.ts

@@ -1,4 +1,4 @@
-import { a as KaiMemoryStatus, c as KAI_MEMORY_STATUSES, o as MetastoreClient, r as KaiMemoryItem, s as UpdateKaiMemoryMeta, t as CreateKaiMemoryMeta } from "../../types-BMWeCO5M.js";
+import { a as KaiMemoryStatus, c as KAI_MEMORY_STATUSES, o as MetastoreClient, r as KaiMemoryItem, s as UpdateKaiMemoryMeta, t as CreateKaiMemoryMeta } from "../../types-1LENlL5h.js";
 //#region src/sdks/kaiMemory/kaiMemorySdk.d.ts
 /** The metastore object type this SDK addresses — see `SEMANTIC_OBJECT_TYPE` for the convention. */
 declare const KAI_MEMORY_OBJECT_TYPE = "kai-memory";

package/dist/sdk/kaiMemory/index.js

@@ -1,2 +1,2 @@
-import { a as KAI_MEMORY_STATUSES, i as createKaiMemorySdk, n as KaiMemoryReviewConflictError, r as KaiMemoryUnreadableItemsError, t as KAI_MEMORY_OBJECT_TYPE } from "../../kaiMemory-DaOh0zVn.js";
+import { a as KAI_MEMORY_STATUSES, i as createKaiMemorySdk, n as KaiMemoryReviewConflictError, r as KaiMemoryUnreadableItemsError, t as KAI_MEMORY_OBJECT_TYPE } from "../../kaiMemory-C9di17bd.js";
 export { KAI_MEMORY_OBJECT_TYPE, KAI_MEMORY_STATUSES, KaiMemoryReviewConflictError, KaiMemoryUnreadableItemsError, createKaiMemorySdk };

package/dist/sdk/kaiMemory/types.d.cts

@@ -1,2 +1,2 @@
-import { a as KaiMemoryStatus, i as KaiMemoryMeta, n as KaiMemoryData, o as MetastoreClient, r as KaiMemoryItem, s as UpdateKaiMemoryMeta, t as CreateKaiMemoryMeta } from "../../types-C05ALlV6.cjs";
+import { a as KaiMemoryStatus, i as KaiMemoryMeta, n as KaiMemoryData, o as MetastoreClient, r as KaiMemoryItem, s as UpdateKaiMemoryMeta, t as CreateKaiMemoryMeta } from "../../types-CNkQuWnO.cjs";
 export { CreateKaiMemoryMeta, KaiMemoryData, KaiMemoryItem, KaiMemoryMeta, KaiMemoryStatus, MetastoreClient, UpdateKaiMemoryMeta };

package/dist/sdk/kaiMemory/types.d.ts

@@ -1,2 +1,2 @@
-import { a as KaiMemoryStatus, i as KaiMemoryMeta, n as KaiMemoryData, o as MetastoreClient, r as KaiMemoryItem, s as UpdateKaiMemoryMeta, t as CreateKaiMemoryMeta } from "../../types-BMWeCO5M.js";
+import { a as KaiMemoryStatus, i as KaiMemoryMeta, n as KaiMemoryData, o as MetastoreClient, r as KaiMemoryItem, s as UpdateKaiMemoryMeta, t as CreateKaiMemoryMeta } from "../../types-1LENlL5h.js";
 export { CreateKaiMemoryMeta, KaiMemoryData, KaiMemoryItem, KaiMemoryMeta, KaiMemoryStatus, MetastoreClient, UpdateKaiMemoryMeta };

package/dist/sdk/queryService/index.cjs

@@ -1,91 +1,70 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_jobStatus = require("../../jobStatus-B0E-MZ9I.cjs");
-const require_QueryJobTimeoutError = require("../../QueryJobTimeoutError-CVNPdCWX.cjs");
+const require_collectByOffset = require("../../collectByOffset-DQsqtmJg.cjs");
 const require_ValidationError = require("../../ValidationError-D65QU0uq.cjs");
 //#region src/sdks/queryService/queryServiceSdk.ts
-const DEFAULT_WAIT_FOR_JOB_INTERVAL = 500;
-const DEFAULT_MAX_WAIT_TIME = 3e5;
 const DEFAULT_EXECUTE_QUERY_PAGE_SIZE = 5e3;
+const DEFAULT_POLL_INTERVAL = 500;
+const DEFAULT_TIMEOUT = 3e5;
 const assertPositiveInteger = (name, value) => {
 	if (!Number.isInteger(value) || value <= 0) throw new require_ValidationError.ValidationError(`${name} must be a positive integer, got ${value}`);
 };
 /**
 * Higher-level SDK composing queryService client calls with job polling and result-page
-* auto-pagination for orchestrated workflows — mirrors sdks/storage's `createStorageSdk`.
+* auto-pagination for orchestrated workflows.
 */
 const createQueryServiceSdk = ({ queryServiceClient }) => {
 	/**
-	* Polls a job until it reaches a terminal state (`completed`, `failed`, `canceled`).
-	* Throws {@link QueryJobError} if the job fails, {@link QueryJobTimeoutError} if it doesn't reach
-	* a terminal state within `maxWaitTime`.
+	* Fetches every page of a statement's results, merging them into a single {@link QueryResult}.
+	*
+	* - `columns`, `status`, `rowsAffected` and `message` describe the statement, so they are read off
+	*   the first page; `collectByOffset` hands back only the rows.
+	* - A second consumer that needs the envelope back is the cue for a `collectPagesByOffset`
+	*   sibling resolving `{ first, items }`, not for widening this closure.
 	*/
-	const waitForJob = async (queryJobId, { interval = DEFAULT_WAIT_FOR_JOB_INTERVAL, maxWaitTime = DEFAULT_MAX_WAIT_TIME, signal } = {}) => {
-		assertPositiveInteger("interval", interval);
-		assertPositiveInteger("maxWaitTime", maxWaitTime);
-		const status = await require_jobStatus.poll({
-			pollFn: () => queryServiceClient.getQueryJob(queryJobId),
-			until: ({ data }) => require_jobStatus.jobStatus.query.isTerminal(data.status),
-			backoff: {
-				type: "constant",
-				interval
-			},
-			timeout: maxWaitTime,
-			signal
-		}).unwrap((result) => result.state === "errored" || result.state === "aborted" ? void 0 : new require_QueryJobTimeoutError.QueryJobTimeoutError(`Job did not complete within ${maxWaitTime}ms`, queryJobId));
-		if (status.status === "failed") {
-			const failedStatements = status.statements.filter((statement) => statement.status === "failed").map((statement) => ({
-				id: statement.id,
-				error: statement.error
-			}));
-			throw new require_QueryJobTimeoutError.QueryJobError(failedStatements[0]?.error ?? "Job failed", queryJobId, { failedStatements });
-		}
-		return status;
-	};
-	/** Fetches every page of a statement's results, merging them into a single {@link QueryResult}. */
 	const fetchAllResultPages = async (queryJobId, statementId, pageSize, maxRows) => {
-		const allData = [];
-		let offset = 0;
 		let firstPage;
-		while (true) {
-			const remaining = maxRows !== void 0 ? maxRows - allData.length : void 0;
-			if (remaining !== void 0 && remaining <= 0) break;
-			const currentPageSize = remaining !== void 0 ? Math.min(pageSize, remaining) : pageSize;
-			const page = await queryServiceClient.getQueryResults(queryJobId, statementId, {
-				offset,
-				pageSize: currentPageSize
-			});
-			firstPage ??= page;
-			const pageData = page.data ?? [];
-			allData.push(...pageData);
-			if (pageData.length < currentPageSize) break;
-			offset += pageData.length;
-			if (firstPage.numberOfRows !== void 0 && allData.length >= firstPage.numberOfRows) break;
-		}
+		const data = await require_collectByOffset.collectByOffset({
+			pageSize,
+			limit: maxRows,
+			fetchFrom: async (offset, pageSize) => {
+				const page = await queryServiceClient.getQueryResults(queryJobId, statementId, {
+					offset,
+					pageSize
+				});
+				firstPage ??= page;
+				return page.data ?? [];
+			}
+		});
 		if (!firstPage) throw new Error(`No result pages returned for statement ${statementId}`);
 		return {
 			...firstPage,
-			data: allData
+			data
 		};
 	};
 	/**
 	* Submits a query job, waits for completion, and fetches results for every statement —
 	* auto-paginating each statement's results so sets larger than `pageSize` come back in full
 	* instead of being truncated at the API's default page size.
+	*
+	* - Throws {@link QueryJobError} when the job ended `failed`, carrying the failed statements.
+	* - Throws the poll's failure when the wait timed out, was aborted or ran out of attempts.
 	*/
 	const executeQuery = async (branchId, workspaceId, body, options = {}) => {
-		const { pageSize = DEFAULT_EXECUTE_QUERY_PAGE_SIZE, maxRows, ...waitOptions } = options;
+		const { pageSize = DEFAULT_EXECUTE_QUERY_PAGE_SIZE, maxRows, interval = DEFAULT_POLL_INTERVAL, timeout = DEFAULT_TIMEOUT, ...pollOptions } = options;
 		assertPositiveInteger("pageSize", pageSize);
 		if (maxRows !== void 0) assertPositiveInteger("maxRows", maxRows);
 		const { queryJobId } = await queryServiceClient.createQueryJob(branchId, workspaceId, body);
-		const status = await waitForJob(queryJobId, waitOptions);
+		const status = await queryServiceClient.poller({
+			init: { id: queryJobId },
+			interval,
+			timeout,
+			...pollOptions
+		}).wait();
 		const results = [];
 		for (const statement of status.statements) results.push(await fetchAllResultPages(queryJobId, statement.id, pageSize, maxRows));
 		return results;
 	};
-	return {
-		waitForJob,
-		executeQuery
-	};
+	return { executeQuery };
 };
 //#endregion
 exports.createQueryServiceSdk = createQueryServiceSdk;

package/dist/sdk/queryService/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["ValidationError","poll","jobStatus","QueryJobTimeoutError","QueryJobError"],"sources":["../../../src/sdks/queryService/queryServiceSdk.ts"],"sourcesContent":["import type { createQueryServiceClient } from '../../clients/queryService';\nimport type {\n  GetQueryJobPath,\n  JobStatusResponse,\n  PostQueryBody,\n  PostQueryPath,\n  QueryResult,\n} from '../../clients/queryService/types';\nimport { jobStatus } from '../../domain/jobStatus';\nimport { QueryJobError, QueryJobTimeoutError, ValidationError } from '../../errors';\nimport { poll } from '../../utils/async';\n\nconst DEFAULT_WAIT_FOR_JOB_INTERVAL = 500; // ms, the shortest wait the poll engine takes\nconst DEFAULT_MAX_WAIT_TIME = 300_000; // 5 minutes\nconst DEFAULT_EXECUTE_QUERY_PAGE_SIZE = 5000;\n\nconst assertPositiveInteger = (name: string, value: number) => {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new ValidationError(`${name} must be a positive integer, got ${value}`);\n  }\n};\n\nexport type WaitForJobOptions = {\n  /** Poll interval in ms, floored at 500 by the poll engine. Default: 500. */\n  interval?: number;\n  /** Give up and throw {@link QueryJobTimeoutError} after this many ms. Default: 300_000 (5 min). */\n  maxWaitTime?: number;\n  signal?: AbortSignal;\n};\n\nexport type ExecuteQueryOptions = WaitForJobOptions & {\n  /** Page size used internally while auto-paginating each statement's results. Default: 5000. */\n  pageSize?: number;\n  /**\n   * Caps the number of rows fetched per statement. Pagination stops once this many rows have been\n   * collected. Default: unlimited (fetch every row).\n   */\n  maxRows?: number;\n};\n\ntype QueryServiceSdkOptions = {\n  queryServiceClient: ReturnType<typeof createQueryServiceClient>;\n};\n\n/**\n * Higher-level SDK composing queryService client calls with job polling and result-page\n * auto-pagination for orchestrated workflows — mirrors sdks/storage's `createStorageSdk`.\n */\nexport const createQueryServiceSdk = ({ queryServiceClient }: QueryServiceSdkOptions) => {\n  /**\n   * Polls a job until it reaches a terminal state (`completed`, `failed`, `canceled`).\n   * Throws {@link QueryJobError} if the job fails, {@link QueryJobTimeoutError} if it doesn't reach\n   * a terminal state within `maxWaitTime`.\n   */\n  const waitForJob = async (\n    queryJobId: GetQueryJobPath['queryJobId'],\n    {\n      interval = DEFAULT_WAIT_FOR_JOB_INTERVAL,\n      maxWaitTime = DEFAULT_MAX_WAIT_TIME,\n      signal,\n    }: WaitForJobOptions = {},\n  ): Promise<JobStatusResponse> => {\n    assertPositiveInteger('interval', interval);\n    assertPositiveInteger('maxWaitTime', maxWaitTime);\n\n    const status = await poll({\n      pollFn: () => queryServiceClient.getQueryJob(queryJobId),\n      until: ({ data }) => jobStatus.query.isTerminal(data.status),\n      backoff: { type: 'constant', interval },\n      timeout: maxWaitTime,\n      signal,\n    }).unwrap((result) =>\n      result.state === 'errored' || result.state === 'aborted'\n        ? undefined\n        : new QueryJobTimeoutError(`Job did not complete within ${maxWaitTime}ms`, queryJobId),\n    );\n    if (status.status === 'failed') {\n      const failedStatements = status.statements\n        .filter((statement) => statement.status === 'failed')\n        .map((statement) => ({ id: statement.id, error: statement.error }));\n\n      throw new QueryJobError(failedStatements[0]?.error ?? 'Job failed', queryJobId, {\n        failedStatements,\n      });\n    }\n\n    return status;\n  };\n\n  /** Fetches every page of a statement's results, merging them into a single {@link QueryResult}. */\n  const fetchAllResultPages = async (\n    queryJobId: string,\n    statementId: string,\n    pageSize: number,\n    maxRows: number | undefined,\n  ): Promise<QueryResult> => {\n    const allData: NonNullable<QueryResult['data']> = [];\n    let offset = 0;\n    let firstPage: QueryResult | undefined;\n\n    while (true) {\n      const remaining = maxRows !== undefined ? maxRows - allData.length : undefined;\n      if (remaining !== undefined && remaining <= 0) break;\n\n      const currentPageSize = remaining !== undefined ? Math.min(pageSize, remaining) : pageSize;\n\n      const page = await queryServiceClient.getQueryResults(queryJobId, statementId, {\n        offset,\n        pageSize: currentPageSize,\n      });\n      firstPage ??= page;\n\n      const pageData = page.data ?? [];\n      allData.push(...pageData);\n\n      // Stop once a page is shorter than requested (end of the result set, or a statement like DDL\n      // that has no rows at all) or once `numberOfRows` — known from the first page — is reached.\n      if (pageData.length < currentPageSize) break;\n      offset += pageData.length;\n      if (firstPage.numberOfRows !== undefined && allData.length >= firstPage.numberOfRows) break;\n    }\n\n    if (!firstPage) {\n      // Unreachable: the loop always issues at least one request (pageSize/maxRows are validated as\n      // positive integers by executeQuery), assigning firstPage on the first iteration.\n      throw new Error(`No result pages returned for statement ${statementId}`);\n    }\n\n    return { ...firstPage, data: allData };\n  };\n\n  /**\n   * Submits a query job, waits for completion, and fetches results for every statement —\n   * auto-paginating each statement's results so sets larger than `pageSize` come back in full\n   * instead of being truncated at the API's default page size.\n   */\n  const executeQuery = async (\n    branchId: PostQueryPath['branchId'],\n    workspaceId: PostQueryPath['workspaceId'],\n    body: PostQueryBody,\n    options: ExecuteQueryOptions = {},\n  ): Promise<QueryResult[]> => {\n    const { pageSize = DEFAULT_EXECUTE_QUERY_PAGE_SIZE, maxRows, ...waitOptions } = options;\n    assertPositiveInteger('pageSize', pageSize);\n    if (maxRows !== undefined) assertPositiveInteger('maxRows', maxRows);\n\n    const { queryJobId } = await queryServiceClient.createQueryJob(branchId, workspaceId, body);\n    const status = await waitForJob(queryJobId, waitOptions);\n\n    const results: QueryResult[] = [];\n    for (const statement of status.statements) {\n      results.push(await fetchAllResultPages(queryJobId, statement.id, pageSize, maxRows));\n    }\n\n    return results;\n  };\n\n  return {\n    waitForJob,\n    executeQuery,\n  };\n};\n"],"mappings":";;;;;AAYA,MAAM,gCAAgC;AACtC,MAAM,wBAAwB;AAC9B,MAAM,kCAAkC;AAExC,MAAM,yBAAyB,MAAc,UAAkB;CAC7D,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GACvC,MAAM,IAAIA,wBAAAA,gBAAgB,GAAG,KAAK,mCAAmC,OAAO;AAEhF;;;;;AA4BA,MAAa,yBAAyB,EAAE,yBAAiD;;;;;;CAMvF,MAAM,aAAa,OACjB,YACA,EACE,WAAW,+BACX,cAAc,uBACd,WACqB,CAAC,MACO;EAC/B,sBAAsB,YAAY,QAAQ;EAC1C,sBAAsB,eAAe,WAAW;EAEhD,MAAM,SAAS,MAAMC,kBAAAA,KAAK;GACxB,cAAc,mBAAmB,YAAY,UAAU;GACvD,QAAQ,EAAE,WAAWC,kBAAAA,UAAU,MAAM,WAAW,KAAK,MAAM;GAC3D,SAAS;IAAE,MAAM;IAAY;GAAS;GACtC,SAAS;GACT;EACF,CAAC,CAAC,CAAC,QAAQ,WACT,OAAO,UAAU,aAAa,OAAO,UAAU,YAC3C,KAAA,IACA,IAAIC,6BAAAA,qBAAqB,+BAA+B,YAAY,KAAK,UAAU,CACzF;EACA,IAAI,OAAO,WAAW,UAAU;GAC9B,MAAM,mBAAmB,OAAO,WAC7B,QAAQ,cAAc,UAAU,WAAW,QAAQ,CAAC,CACpD,KAAK,eAAe;IAAE,IAAI,UAAU;IAAI,OAAO,UAAU;GAAM,EAAE;GAEpE,MAAM,IAAIC,6BAAAA,cAAc,iBAAiB,EAAE,EAAE,SAAS,cAAc,YAAY,EAC9E,iBACF,CAAC;EACH;EAEA,OAAO;CACT;;CAGA,MAAM,sBAAsB,OAC1B,YACA,aACA,UACA,YACyB;EACzB,MAAM,UAA4C,CAAC;EACnD,IAAI,SAAS;EACb,IAAI;EAEJ,OAAO,MAAM;GACX,MAAM,YAAY,YAAY,KAAA,IAAY,UAAU,QAAQ,SAAS,KAAA;GACrE,IAAI,cAAc,KAAA,KAAa,aAAa,GAAG;GAE/C,MAAM,kBAAkB,cAAc,KAAA,IAAY,KAAK,IAAI,UAAU,SAAS,IAAI;GAElF,MAAM,OAAO,MAAM,mBAAmB,gBAAgB,YAAY,aAAa;IAC7E;IACA,UAAU;GACZ,CAAC;GACD,cAAc;GAEd,MAAM,WAAW,KAAK,QAAQ,CAAC;GAC/B,QAAQ,KAAK,GAAG,QAAQ;GAIxB,IAAI,SAAS,SAAS,iBAAiB;GACvC,UAAU,SAAS;GACnB,IAAI,UAAU,iBAAiB,KAAA,KAAa,QAAQ,UAAU,UAAU,cAAc;EACxF;EAEA,IAAI,CAAC,WAGH,MAAM,IAAI,MAAM,0CAA0C,aAAa;EAGzE,OAAO;GAAE,GAAG;GAAW,MAAM;EAAQ;CACvC;;;;;;CAOA,MAAM,eAAe,OACnB,UACA,aACA,MACA,UAA+B,CAAC,MACL;EAC3B,MAAM,EAAE,WAAW,iCAAiC,SAAS,GAAG,gBAAgB;EAChF,sBAAsB,YAAY,QAAQ;EAC1C,IAAI,YAAY,KAAA,GAAW,sBAAsB,WAAW,OAAO;EAEnE,MAAM,EAAE,eAAe,MAAM,mBAAmB,eAAe,UAAU,aAAa,IAAI;EAC1F,MAAM,SAAS,MAAM,WAAW,YAAY,WAAW;EAEvD,MAAM,UAAyB,CAAC;EAChC,KAAK,MAAM,aAAa,OAAO,YAC7B,QAAQ,KAAK,MAAM,oBAAoB,YAAY,UAAU,IAAI,UAAU,OAAO,CAAC;EAGrF,OAAO;CACT;CAEA,OAAO;EACL;EACA;CACF;AACF"}
+{"version":3,"file":"index.cjs","names":["ValidationError","collectByOffset"],"sources":["../../../src/sdks/queryService/queryServiceSdk.ts"],"sourcesContent":["import type { createQueryServiceClient } from '../../clients/queryService';\nimport type {\n  PostQueryBody,\n  PostQueryPath,\n  QueryJobPollOptions,\n  QueryResult,\n} from '../../clients/queryService/types';\nimport { ValidationError } from '../../errors';\nimport { collectByOffset } from '../../utils/async';\n\nconst DEFAULT_EXECUTE_QUERY_PAGE_SIZE = 5000;\nconst DEFAULT_POLL_INTERVAL = 500;\nconst DEFAULT_TIMEOUT = 300_000;\n\nconst assertPositiveInteger = (name: string, value: number) => {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new ValidationError(`${name} must be a positive integer, got ${value}`);\n  }\n};\n\nexport type ExecuteQueryOptions = Omit<QueryJobPollOptions, 'interval' | 'timeout'> & {\n  /** Poll interval in ms. Default: 500. */\n  interval?: number;\n  /** Give up after this many ms. Default: 300_000 (5 min). */\n  timeout?: number;\n  /** Page size used internally while auto-paginating each statement's results. Default: 5000. */\n  pageSize?: number;\n  /**\n   * Caps the number of rows fetched per statement. Pagination stops once this many rows have been\n   * collected. Default: unlimited (fetch every row).\n   */\n  maxRows?: number;\n};\n\ntype QueryServiceSdkOptions = {\n  queryServiceClient: ReturnType<typeof createQueryServiceClient>;\n};\n\n/**\n * Higher-level SDK composing queryService client calls with job polling and result-page\n * auto-pagination for orchestrated workflows.\n */\nexport const createQueryServiceSdk = ({ queryServiceClient }: QueryServiceSdkOptions) => {\n  /**\n   * Fetches every page of a statement's results, merging them into a single {@link QueryResult}.\n   *\n   * - `columns`, `status`, `rowsAffected` and `message` describe the statement, so they are read off\n   *   the first page; `collectByOffset` hands back only the rows.\n   * - A second consumer that needs the envelope back is the cue for a `collectPagesByOffset`\n   *   sibling resolving `{ first, items }`, not for widening this closure.\n   */\n  const fetchAllResultPages = async (\n    queryJobId: string,\n    statementId: string,\n    pageSize: number,\n    maxRows: number | undefined,\n  ): Promise<QueryResult> => {\n    let firstPage: QueryResult | undefined;\n\n    const data = await collectByOffset({\n      pageSize,\n      limit: maxRows,\n      fetchFrom: async (offset, pageSize) => {\n        const page = await queryServiceClient.getQueryResults(queryJobId, statementId, {\n          offset,\n          pageSize,\n        });\n        firstPage ??= page;\n\n        return page.data ?? [];\n      },\n    });\n\n    if (!firstPage) throw new Error(`No result pages returned for statement ${statementId}`);\n\n    return { ...firstPage, data };\n  };\n\n  /**\n   * Submits a query job, waits for completion, and fetches results for every statement —\n   * auto-paginating each statement's results so sets larger than `pageSize` come back in full\n   * instead of being truncated at the API's default page size.\n   *\n   * - Throws {@link QueryJobError} when the job ended `failed`, carrying the failed statements.\n   * - Throws the poll's failure when the wait timed out, was aborted or ran out of attempts.\n   */\n  const executeQuery = async (\n    branchId: PostQueryPath['branchId'],\n    workspaceId: PostQueryPath['workspaceId'],\n    body: PostQueryBody,\n    options: ExecuteQueryOptions = {},\n  ): Promise<QueryResult[]> => {\n    const {\n      pageSize = DEFAULT_EXECUTE_QUERY_PAGE_SIZE,\n      maxRows,\n      interval = DEFAULT_POLL_INTERVAL,\n      timeout = DEFAULT_TIMEOUT,\n      ...pollOptions\n    } = options;\n    assertPositiveInteger('pageSize', pageSize);\n    if (maxRows !== undefined) assertPositiveInteger('maxRows', maxRows);\n\n    const { queryJobId } = await queryServiceClient.createQueryJob(branchId, workspaceId, body);\n    const status = await queryServiceClient\n      .poller({ init: { id: queryJobId }, interval, timeout, ...pollOptions })\n      .wait();\n    const results: QueryResult[] = [];\n    for (const statement of status.statements) {\n      results.push(await fetchAllResultPages(queryJobId, statement.id, pageSize, maxRows));\n    }\n\n    return results;\n  };\n\n  return {\n    executeQuery,\n  };\n};\n"],"mappings":";;;;AAUA,MAAM,kCAAkC;AACxC,MAAM,wBAAwB;AAC9B,MAAM,kBAAkB;AAExB,MAAM,yBAAyB,MAAc,UAAkB;CAC7D,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GACvC,MAAM,IAAIA,wBAAAA,gBAAgB,GAAG,KAAK,mCAAmC,OAAO;AAEhF;;;;;AAwBA,MAAa,yBAAyB,EAAE,yBAAiD;;;;;;;;;CASvF,MAAM,sBAAsB,OAC1B,YACA,aACA,UACA,YACyB;EACzB,IAAI;EAEJ,MAAM,OAAO,MAAMC,wBAAAA,gBAAgB;GACjC;GACA,OAAO;GACP,WAAW,OAAO,QAAQ,aAAa;IACrC,MAAM,OAAO,MAAM,mBAAmB,gBAAgB,YAAY,aAAa;KAC7E;KACA;IACF,CAAC;IACD,cAAc;IAEd,OAAO,KAAK,QAAQ,CAAC;GACvB;EACF,CAAC;EAED,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,0CAA0C,aAAa;EAEvF,OAAO;GAAE,GAAG;GAAW;EAAK;CAC9B;;;;;;;;;CAUA,MAAM,eAAe,OACnB,UACA,aACA,MACA,UAA+B,CAAC,MACL;EAC3B,MAAM,EACJ,WAAW,iCACX,SACA,WAAW,uBACX,UAAU,iBACV,GAAG,gBACD;EACJ,sBAAsB,YAAY,QAAQ;EAC1C,IAAI,YAAY,KAAA,GAAW,sBAAsB,WAAW,OAAO;EAEnE,MAAM,EAAE,eAAe,MAAM,mBAAmB,eAAe,UAAU,aAAa,IAAI;EAC1F,MAAM,SAAS,MAAM,mBAClB,OAAO;GAAE,MAAM,EAAE,IAAI,WAAW;GAAG;GAAU;GAAS,GAAG;EAAY,CAAC,CAAC,CACvE,KAAK;EACR,MAAM,UAAyB,CAAC;EAChC,KAAK,MAAM,aAAa,OAAO,YAC7B,QAAQ,KAAK,MAAM,oBAAoB,YAAY,UAAU,IAAI,UAAU,OAAO,CAAC;EAGrF,OAAO;CACT;CAEA,OAAO,EACL,aACF;AACF"}

package/dist/sdk/queryService/index.d.cts

@@ -1,2 +1,2 @@
-import { i as createQueryServiceSdk, n as ExecuteQueryOptions, r as WaitForJobOptions } from "../../index-syAYY5LC.cjs";
-export { ExecuteQueryOptions, WaitForJobOptions, createQueryServiceSdk };
+import { b as ExecuteQueryOptions, x as createQueryServiceSdk } from "../../index-C40Fbj-6.cjs";
+export { ExecuteQueryOptions, createQueryServiceSdk };

package/dist/sdk/queryService/index.d.ts

@@ -1,2 +1,2 @@
-import { i as createQueryServiceSdk, n as ExecuteQueryOptions, r as WaitForJobOptions } from "../../index-BP3choXr.js";
-export { ExecuteQueryOptions, WaitForJobOptions, createQueryServiceSdk };
+import { b as ExecuteQueryOptions, x as createQueryServiceSdk } from "../../index-B3QTeqfL.js";
+export { ExecuteQueryOptions, createQueryServiceSdk };

package/dist/sdk/queryService/index.js

@@ -1,90 +1,69 @@
-import { i as poll, t as jobStatus } from "../../jobStatus-BJdbZ72V.js";
-import { r as QueryJobError, t as QueryJobTimeoutError } from "../../QueryJobTimeoutError-C7JbNGOM.js";
+import { t as collectByOffset } from "../../collectByOffset-2XzJqmvr.js";
 import { t as ValidationError } from "../../ValidationError-DjhtNMfZ.js";
 //#region src/sdks/queryService/queryServiceSdk.ts
-const DEFAULT_WAIT_FOR_JOB_INTERVAL = 500;
-const DEFAULT_MAX_WAIT_TIME = 3e5;
 const DEFAULT_EXECUTE_QUERY_PAGE_SIZE = 5e3;
+const DEFAULT_POLL_INTERVAL = 500;
+const DEFAULT_TIMEOUT = 3e5;
 const assertPositiveInteger = (name, value) => {
 	if (!Number.isInteger(value) || value <= 0) throw new ValidationError(`${name} must be a positive integer, got ${value}`);
 };
 /**
 * Higher-level SDK composing queryService client calls with job polling and result-page
-* auto-pagination for orchestrated workflows — mirrors sdks/storage's `createStorageSdk`.
+* auto-pagination for orchestrated workflows.
 */
 const createQueryServiceSdk = ({ queryServiceClient }) => {
 	/**
-	* Polls a job until it reaches a terminal state (`completed`, `failed`, `canceled`).
-	* Throws {@link QueryJobError} if the job fails, {@link QueryJobTimeoutError} if it doesn't reach
-	* a terminal state within `maxWaitTime`.
+	* Fetches every page of a statement's results, merging them into a single {@link QueryResult}.
+	*
+	* - `columns`, `status`, `rowsAffected` and `message` describe the statement, so they are read off
+	*   the first page; `collectByOffset` hands back only the rows.
+	* - A second consumer that needs the envelope back is the cue for a `collectPagesByOffset`
+	*   sibling resolving `{ first, items }`, not for widening this closure.
 	*/
-	const waitForJob = async (queryJobId, { interval = DEFAULT_WAIT_FOR_JOB_INTERVAL, maxWaitTime = DEFAULT_MAX_WAIT_TIME, signal } = {}) => {
-		assertPositiveInteger("interval", interval);
-		assertPositiveInteger("maxWaitTime", maxWaitTime);
-		const status = await poll({
-			pollFn: () => queryServiceClient.getQueryJob(queryJobId),
-			until: ({ data }) => jobStatus.query.isTerminal(data.status),
-			backoff: {
-				type: "constant",
-				interval
-			},
-			timeout: maxWaitTime,
-			signal
-		}).unwrap((result) => result.state === "errored" || result.state === "aborted" ? void 0 : new QueryJobTimeoutError(`Job did not complete within ${maxWaitTime}ms`, queryJobId));
-		if (status.status === "failed") {
-			const failedStatements = status.statements.filter((statement) => statement.status === "failed").map((statement) => ({
-				id: statement.id,
-				error: statement.error
-			}));
-			throw new QueryJobError(failedStatements[0]?.error ?? "Job failed", queryJobId, { failedStatements });
-		}
-		return status;
-	};
-	/** Fetches every page of a statement's results, merging them into a single {@link QueryResult}. */
 	const fetchAllResultPages = async (queryJobId, statementId, pageSize, maxRows) => {
-		const allData = [];
-		let offset = 0;
 		let firstPage;
-		while (true) {
-			const remaining = maxRows !== void 0 ? maxRows - allData.length : void 0;
-			if (remaining !== void 0 && remaining <= 0) break;
-			const currentPageSize = remaining !== void 0 ? Math.min(pageSize, remaining) : pageSize;
-			const page = await queryServiceClient.getQueryResults(queryJobId, statementId, {
-				offset,
-				pageSize: currentPageSize
-			});
-			firstPage ??= page;
-			const pageData = page.data ?? [];
-			allData.push(...pageData);
-			if (pageData.length < currentPageSize) break;
-			offset += pageData.length;
-			if (firstPage.numberOfRows !== void 0 && allData.length >= firstPage.numberOfRows) break;
-		}
+		const data = await collectByOffset({
+			pageSize,
+			limit: maxRows,
+			fetchFrom: async (offset, pageSize) => {
+				const page = await queryServiceClient.getQueryResults(queryJobId, statementId, {
+					offset,
+					pageSize
+				});
+				firstPage ??= page;
+				return page.data ?? [];
+			}
+		});
 		if (!firstPage) throw new Error(`No result pages returned for statement ${statementId}`);
 		return {
 			...firstPage,
-			data: allData
+			data
 		};
 	};
 	/**
 	* Submits a query job, waits for completion, and fetches results for every statement —
 	* auto-paginating each statement's results so sets larger than `pageSize` come back in full
 	* instead of being truncated at the API's default page size.
+	*
+	* - Throws {@link QueryJobError} when the job ended `failed`, carrying the failed statements.
+	* - Throws the poll's failure when the wait timed out, was aborted or ran out of attempts.
 	*/
 	const executeQuery = async (branchId, workspaceId, body, options = {}) => {
-		const { pageSize = DEFAULT_EXECUTE_QUERY_PAGE_SIZE, maxRows, ...waitOptions } = options;
+		const { pageSize = DEFAULT_EXECUTE_QUERY_PAGE_SIZE, maxRows, interval = DEFAULT_POLL_INTERVAL, timeout = DEFAULT_TIMEOUT, ...pollOptions } = options;
 		assertPositiveInteger("pageSize", pageSize);
 		if (maxRows !== void 0) assertPositiveInteger("maxRows", maxRows);
 		const { queryJobId } = await queryServiceClient.createQueryJob(branchId, workspaceId, body);
-		const status = await waitForJob(queryJobId, waitOptions);
+		const status = await queryServiceClient.poller({
+			init: { id: queryJobId },
+			interval,
+			timeout,
+			...pollOptions
+		}).wait();
 		const results = [];
 		for (const statement of status.statements) results.push(await fetchAllResultPages(queryJobId, statement.id, pageSize, maxRows));
 		return results;
 	};
-	return {
-		waitForJob,
-		executeQuery
-	};
+	return { executeQuery };
 };
 //#endregion
 export { createQueryServiceSdk };

package/dist/sdk/queryService/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/sdks/queryService/queryServiceSdk.ts"],"sourcesContent":["import type { createQueryServiceClient } from '../../clients/queryService';\nimport type {\n  GetQueryJobPath,\n  JobStatusResponse,\n  PostQueryBody,\n  PostQueryPath,\n  QueryResult,\n} from '../../clients/queryService/types';\nimport { jobStatus } from '../../domain/jobStatus';\nimport { QueryJobError, QueryJobTimeoutError, ValidationError } from '../../errors';\nimport { poll } from '../../utils/async';\n\nconst DEFAULT_WAIT_FOR_JOB_INTERVAL = 500; // ms, the shortest wait the poll engine takes\nconst DEFAULT_MAX_WAIT_TIME = 300_000; // 5 minutes\nconst DEFAULT_EXECUTE_QUERY_PAGE_SIZE = 5000;\n\nconst assertPositiveInteger = (name: string, value: number) => {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new ValidationError(`${name} must be a positive integer, got ${value}`);\n  }\n};\n\nexport type WaitForJobOptions = {\n  /** Poll interval in ms, floored at 500 by the poll engine. Default: 500. */\n  interval?: number;\n  /** Give up and throw {@link QueryJobTimeoutError} after this many ms. Default: 300_000 (5 min). */\n  maxWaitTime?: number;\n  signal?: AbortSignal;\n};\n\nexport type ExecuteQueryOptions = WaitForJobOptions & {\n  /** Page size used internally while auto-paginating each statement's results. Default: 5000. */\n  pageSize?: number;\n  /**\n   * Caps the number of rows fetched per statement. Pagination stops once this many rows have been\n   * collected. Default: unlimited (fetch every row).\n   */\n  maxRows?: number;\n};\n\ntype QueryServiceSdkOptions = {\n  queryServiceClient: ReturnType<typeof createQueryServiceClient>;\n};\n\n/**\n * Higher-level SDK composing queryService client calls with job polling and result-page\n * auto-pagination for orchestrated workflows — mirrors sdks/storage's `createStorageSdk`.\n */\nexport const createQueryServiceSdk = ({ queryServiceClient }: QueryServiceSdkOptions) => {\n  /**\n   * Polls a job until it reaches a terminal state (`completed`, `failed`, `canceled`).\n   * Throws {@link QueryJobError} if the job fails, {@link QueryJobTimeoutError} if it doesn't reach\n   * a terminal state within `maxWaitTime`.\n   */\n  const waitForJob = async (\n    queryJobId: GetQueryJobPath['queryJobId'],\n    {\n      interval = DEFAULT_WAIT_FOR_JOB_INTERVAL,\n      maxWaitTime = DEFAULT_MAX_WAIT_TIME,\n      signal,\n    }: WaitForJobOptions = {},\n  ): Promise<JobStatusResponse> => {\n    assertPositiveInteger('interval', interval);\n    assertPositiveInteger('maxWaitTime', maxWaitTime);\n\n    const status = await poll({\n      pollFn: () => queryServiceClient.getQueryJob(queryJobId),\n      until: ({ data }) => jobStatus.query.isTerminal(data.status),\n      backoff: { type: 'constant', interval },\n      timeout: maxWaitTime,\n      signal,\n    }).unwrap((result) =>\n      result.state === 'errored' || result.state === 'aborted'\n        ? undefined\n        : new QueryJobTimeoutError(`Job did not complete within ${maxWaitTime}ms`, queryJobId),\n    );\n    if (status.status === 'failed') {\n      const failedStatements = status.statements\n        .filter((statement) => statement.status === 'failed')\n        .map((statement) => ({ id: statement.id, error: statement.error }));\n\n      throw new QueryJobError(failedStatements[0]?.error ?? 'Job failed', queryJobId, {\n        failedStatements,\n      });\n    }\n\n    return status;\n  };\n\n  /** Fetches every page of a statement's results, merging them into a single {@link QueryResult}. */\n  const fetchAllResultPages = async (\n    queryJobId: string,\n    statementId: string,\n    pageSize: number,\n    maxRows: number | undefined,\n  ): Promise<QueryResult> => {\n    const allData: NonNullable<QueryResult['data']> = [];\n    let offset = 0;\n    let firstPage: QueryResult | undefined;\n\n    while (true) {\n      const remaining = maxRows !== undefined ? maxRows - allData.length : undefined;\n      if (remaining !== undefined && remaining <= 0) break;\n\n      const currentPageSize = remaining !== undefined ? Math.min(pageSize, remaining) : pageSize;\n\n      const page = await queryServiceClient.getQueryResults(queryJobId, statementId, {\n        offset,\n        pageSize: currentPageSize,\n      });\n      firstPage ??= page;\n\n      const pageData = page.data ?? [];\n      allData.push(...pageData);\n\n      // Stop once a page is shorter than requested (end of the result set, or a statement like DDL\n      // that has no rows at all) or once `numberOfRows` — known from the first page — is reached.\n      if (pageData.length < currentPageSize) break;\n      offset += pageData.length;\n      if (firstPage.numberOfRows !== undefined && allData.length >= firstPage.numberOfRows) break;\n    }\n\n    if (!firstPage) {\n      // Unreachable: the loop always issues at least one request (pageSize/maxRows are validated as\n      // positive integers by executeQuery), assigning firstPage on the first iteration.\n      throw new Error(`No result pages returned for statement ${statementId}`);\n    }\n\n    return { ...firstPage, data: allData };\n  };\n\n  /**\n   * Submits a query job, waits for completion, and fetches results for every statement —\n   * auto-paginating each statement's results so sets larger than `pageSize` come back in full\n   * instead of being truncated at the API's default page size.\n   */\n  const executeQuery = async (\n    branchId: PostQueryPath['branchId'],\n    workspaceId: PostQueryPath['workspaceId'],\n    body: PostQueryBody,\n    options: ExecuteQueryOptions = {},\n  ): Promise<QueryResult[]> => {\n    const { pageSize = DEFAULT_EXECUTE_QUERY_PAGE_SIZE, maxRows, ...waitOptions } = options;\n    assertPositiveInteger('pageSize', pageSize);\n    if (maxRows !== undefined) assertPositiveInteger('maxRows', maxRows);\n\n    const { queryJobId } = await queryServiceClient.createQueryJob(branchId, workspaceId, body);\n    const status = await waitForJob(queryJobId, waitOptions);\n\n    const results: QueryResult[] = [];\n    for (const statement of status.statements) {\n      results.push(await fetchAllResultPages(queryJobId, statement.id, pageSize, maxRows));\n    }\n\n    return results;\n  };\n\n  return {\n    waitForJob,\n    executeQuery,\n  };\n};\n"],"mappings":";;;;AAYA,MAAM,gCAAgC;AACtC,MAAM,wBAAwB;AAC9B,MAAM,kCAAkC;AAExC,MAAM,yBAAyB,MAAc,UAAkB;CAC7D,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GACvC,MAAM,IAAI,gBAAgB,GAAG,KAAK,mCAAmC,OAAO;AAEhF;;;;;AA4BA,MAAa,yBAAyB,EAAE,yBAAiD;;;;;;CAMvF,MAAM,aAAa,OACjB,YACA,EACE,WAAW,+BACX,cAAc,uBACd,WACqB,CAAC,MACO;EAC/B,sBAAsB,YAAY,QAAQ;EAC1C,sBAAsB,eAAe,WAAW;EAEhD,MAAM,SAAS,MAAM,KAAK;GACxB,cAAc,mBAAmB,YAAY,UAAU;GACvD,QAAQ,EAAE,WAAW,UAAU,MAAM,WAAW,KAAK,MAAM;GAC3D,SAAS;IAAE,MAAM;IAAY;GAAS;GACtC,SAAS;GACT;EACF,CAAC,CAAC,CAAC,QAAQ,WACT,OAAO,UAAU,aAAa,OAAO,UAAU,YAC3C,KAAA,IACA,IAAI,qBAAqB,+BAA+B,YAAY,KAAK,UAAU,CACzF;EACA,IAAI,OAAO,WAAW,UAAU;GAC9B,MAAM,mBAAmB,OAAO,WAC7B,QAAQ,cAAc,UAAU,WAAW,QAAQ,CAAC,CACpD,KAAK,eAAe;IAAE,IAAI,UAAU;IAAI,OAAO,UAAU;GAAM,EAAE;GAEpE,MAAM,IAAI,cAAc,iBAAiB,EAAE,EAAE,SAAS,cAAc,YAAY,EAC9E,iBACF,CAAC;EACH;EAEA,OAAO;CACT;;CAGA,MAAM,sBAAsB,OAC1B,YACA,aACA,UACA,YACyB;EACzB,MAAM,UAA4C,CAAC;EACnD,IAAI,SAAS;EACb,IAAI;EAEJ,OAAO,MAAM;GACX,MAAM,YAAY,YAAY,KAAA,IAAY,UAAU,QAAQ,SAAS,KAAA;GACrE,IAAI,cAAc,KAAA,KAAa,aAAa,GAAG;GAE/C,MAAM,kBAAkB,cAAc,KAAA,IAAY,KAAK,IAAI,UAAU,SAAS,IAAI;GAElF,MAAM,OAAO,MAAM,mBAAmB,gBAAgB,YAAY,aAAa;IAC7E;IACA,UAAU;GACZ,CAAC;GACD,cAAc;GAEd,MAAM,WAAW,KAAK,QAAQ,CAAC;GAC/B,QAAQ,KAAK,GAAG,QAAQ;GAIxB,IAAI,SAAS,SAAS,iBAAiB;GACvC,UAAU,SAAS;GACnB,IAAI,UAAU,iBAAiB,KAAA,KAAa,QAAQ,UAAU,UAAU,cAAc;EACxF;EAEA,IAAI,CAAC,WAGH,MAAM,IAAI,MAAM,0CAA0C,aAAa;EAGzE,OAAO;GAAE,GAAG;GAAW,MAAM;EAAQ;CACvC;;;;;;CAOA,MAAM,eAAe,OACnB,UACA,aACA,MACA,UAA+B,CAAC,MACL;EAC3B,MAAM,EAAE,WAAW,iCAAiC,SAAS,GAAG,gBAAgB;EAChF,sBAAsB,YAAY,QAAQ;EAC1C,IAAI,YAAY,KAAA,GAAW,sBAAsB,WAAW,OAAO;EAEnE,MAAM,EAAE,eAAe,MAAM,mBAAmB,eAAe,UAAU,aAAa,IAAI;EAC1F,MAAM,SAAS,MAAM,WAAW,YAAY,WAAW;EAEvD,MAAM,UAAyB,CAAC;EAChC,KAAK,MAAM,aAAa,OAAO,YAC7B,QAAQ,KAAK,MAAM,oBAAoB,YAAY,UAAU,IAAI,UAAU,OAAO,CAAC;EAGrF,OAAO;CACT;CAEA,OAAO;EACL;EACA;CACF;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/sdks/queryService/queryServiceSdk.ts"],"sourcesContent":["import type { createQueryServiceClient } from '../../clients/queryService';\nimport type {\n  PostQueryBody,\n  PostQueryPath,\n  QueryJobPollOptions,\n  QueryResult,\n} from '../../clients/queryService/types';\nimport { ValidationError } from '../../errors';\nimport { collectByOffset } from '../../utils/async';\n\nconst DEFAULT_EXECUTE_QUERY_PAGE_SIZE = 5000;\nconst DEFAULT_POLL_INTERVAL = 500;\nconst DEFAULT_TIMEOUT = 300_000;\n\nconst assertPositiveInteger = (name: string, value: number) => {\n  if (!Number.isInteger(value) || value <= 0) {\n    throw new ValidationError(`${name} must be a positive integer, got ${value}`);\n  }\n};\n\nexport type ExecuteQueryOptions = Omit<QueryJobPollOptions, 'interval' | 'timeout'> & {\n  /** Poll interval in ms. Default: 500. */\n  interval?: number;\n  /** Give up after this many ms. Default: 300_000 (5 min). */\n  timeout?: number;\n  /** Page size used internally while auto-paginating each statement's results. Default: 5000. */\n  pageSize?: number;\n  /**\n   * Caps the number of rows fetched per statement. Pagination stops once this many rows have been\n   * collected. Default: unlimited (fetch every row).\n   */\n  maxRows?: number;\n};\n\ntype QueryServiceSdkOptions = {\n  queryServiceClient: ReturnType<typeof createQueryServiceClient>;\n};\n\n/**\n * Higher-level SDK composing queryService client calls with job polling and result-page\n * auto-pagination for orchestrated workflows.\n */\nexport const createQueryServiceSdk = ({ queryServiceClient }: QueryServiceSdkOptions) => {\n  /**\n   * Fetches every page of a statement's results, merging them into a single {@link QueryResult}.\n   *\n   * - `columns`, `status`, `rowsAffected` and `message` describe the statement, so they are read off\n   *   the first page; `collectByOffset` hands back only the rows.\n   * - A second consumer that needs the envelope back is the cue for a `collectPagesByOffset`\n   *   sibling resolving `{ first, items }`, not for widening this closure.\n   */\n  const fetchAllResultPages = async (\n    queryJobId: string,\n    statementId: string,\n    pageSize: number,\n    maxRows: number | undefined,\n  ): Promise<QueryResult> => {\n    let firstPage: QueryResult | undefined;\n\n    const data = await collectByOffset({\n      pageSize,\n      limit: maxRows,\n      fetchFrom: async (offset, pageSize) => {\n        const page = await queryServiceClient.getQueryResults(queryJobId, statementId, {\n          offset,\n          pageSize,\n        });\n        firstPage ??= page;\n\n        return page.data ?? [];\n      },\n    });\n\n    if (!firstPage) throw new Error(`No result pages returned for statement ${statementId}`);\n\n    return { ...firstPage, data };\n  };\n\n  /**\n   * Submits a query job, waits for completion, and fetches results for every statement —\n   * auto-paginating each statement's results so sets larger than `pageSize` come back in full\n   * instead of being truncated at the API's default page size.\n   *\n   * - Throws {@link QueryJobError} when the job ended `failed`, carrying the failed statements.\n   * - Throws the poll's failure when the wait timed out, was aborted or ran out of attempts.\n   */\n  const executeQuery = async (\n    branchId: PostQueryPath['branchId'],\n    workspaceId: PostQueryPath['workspaceId'],\n    body: PostQueryBody,\n    options: ExecuteQueryOptions = {},\n  ): Promise<QueryResult[]> => {\n    const {\n      pageSize = DEFAULT_EXECUTE_QUERY_PAGE_SIZE,\n      maxRows,\n      interval = DEFAULT_POLL_INTERVAL,\n      timeout = DEFAULT_TIMEOUT,\n      ...pollOptions\n    } = options;\n    assertPositiveInteger('pageSize', pageSize);\n    if (maxRows !== undefined) assertPositiveInteger('maxRows', maxRows);\n\n    const { queryJobId } = await queryServiceClient.createQueryJob(branchId, workspaceId, body);\n    const status = await queryServiceClient\n      .poller({ init: { id: queryJobId }, interval, timeout, ...pollOptions })\n      .wait();\n    const results: QueryResult[] = [];\n    for (const statement of status.statements) {\n      results.push(await fetchAllResultPages(queryJobId, statement.id, pageSize, maxRows));\n    }\n\n    return results;\n  };\n\n  return {\n    executeQuery,\n  };\n};\n"],"mappings":";;;AAUA,MAAM,kCAAkC;AACxC,MAAM,wBAAwB;AAC9B,MAAM,kBAAkB;AAExB,MAAM,yBAAyB,MAAc,UAAkB;CAC7D,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,SAAS,GACvC,MAAM,IAAI,gBAAgB,GAAG,KAAK,mCAAmC,OAAO;AAEhF;;;;;AAwBA,MAAa,yBAAyB,EAAE,yBAAiD;;;;;;;;;CASvF,MAAM,sBAAsB,OAC1B,YACA,aACA,UACA,YACyB;EACzB,IAAI;EAEJ,MAAM,OAAO,MAAM,gBAAgB;GACjC;GACA,OAAO;GACP,WAAW,OAAO,QAAQ,aAAa;IACrC,MAAM,OAAO,MAAM,mBAAmB,gBAAgB,YAAY,aAAa;KAC7E;KACA;IACF,CAAC;IACD,cAAc;IAEd,OAAO,KAAK,QAAQ,CAAC;GACvB;EACF,CAAC;EAED,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,0CAA0C,aAAa;EAEvF,OAAO;GAAE,GAAG;GAAW;EAAK;CAC9B;;;;;;;;;CAUA,MAAM,eAAe,OACnB,UACA,aACA,MACA,UAA+B,CAAC,MACL;EAC3B,MAAM,EACJ,WAAW,iCACX,SACA,WAAW,uBACX,UAAU,iBACV,GAAG,gBACD;EACJ,sBAAsB,YAAY,QAAQ;EAC1C,IAAI,YAAY,KAAA,GAAW,sBAAsB,WAAW,OAAO;EAEnE,MAAM,EAAE,eAAe,MAAM,mBAAmB,eAAe,UAAU,aAAa,IAAI;EAC1F,MAAM,SAAS,MAAM,mBAClB,OAAO;GAAE,MAAM,EAAE,IAAI,WAAW;GAAG;GAAU;GAAS,GAAG;EAAY,CAAC,CAAC,CACvE,KAAK;EACR,MAAM,UAAyB,CAAC;EAChC,KAAK,MAAM,aAAa,OAAO,YAC7B,QAAQ,KAAK,MAAM,oBAAoB,YAAY,UAAU,IAAI,UAAU,OAAO,CAAC;EAGrF,OAAO;CACT;CAEA,OAAO,EACL,aACF;AACF"}

package/dist/sdk/semanticLayer/index.d.cts

@@ -1,4 +1,4 @@
-import { A as CONSTRAINT_TYPES, D as UpdateSemanticObjectMeta, F as SQL_DIALECTS, M as RELATIONSHIP_JOIN_TYPES, N as RULE_OPERATORS, O as CONSTRAINT_SCOPES, P as SEMANTIC_OBJECT_SCOPES, T as SemanticUnreadableObjectRef, _ as SemanticObject, a as SemanticChildObjectType, b as SemanticObjectType, g as SemanticModelData, h as SemanticModelChildRef, i as SemanticChildObjectDataMap, j as FIELD_ROLES, k as CONSTRAINT_SEVERITIES, m as SemanticMetricData, n as MetastoreClient, o as SemanticConstraintData, p as SemanticGlossaryData, t as CreateSemanticObjectMeta, u as SemanticDatasetData, x as SemanticRelationshipData } from "../../types-C8oZX0oP.cjs";
+import { A as CONSTRAINT_TYPES, D as UpdateSemanticObjectMeta, F as SQL_DIALECTS, M as RELATIONSHIP_JOIN_TYPES, N as RULE_OPERATORS, O as CONSTRAINT_SCOPES, P as SEMANTIC_OBJECT_SCOPES, T as SemanticUnreadableObjectRef, _ as SemanticObject, a as SemanticChildObjectType, b as SemanticObjectType, g as SemanticModelData, h as SemanticModelChildRef, i as SemanticChildObjectDataMap, j as FIELD_ROLES, k as CONSTRAINT_SEVERITIES, m as SemanticMetricData, n as MetastoreClient, o as SemanticConstraintData, p as SemanticGlossaryData, t as CreateSemanticObjectMeta, u as SemanticDatasetData, x as SemanticRelationshipData } from "../../types-C_raqbl-.cjs";
 import { z } from "zod";
 //#region src/sdks/semanticLayer/errorMessage.d.ts
 /**

package/dist/sdk/semanticLayer/index.d.ts

@@ -1,4 +1,4 @@
-import { A as CONSTRAINT_TYPES, D as UpdateSemanticObjectMeta, F as SQL_DIALECTS, M as RELATIONSHIP_JOIN_TYPES, N as RULE_OPERATORS, O as CONSTRAINT_SCOPES, P as SEMANTIC_OBJECT_SCOPES, T as SemanticUnreadableObjectRef, _ as SemanticObject, a as SemanticChildObjectType, b as SemanticObjectType, g as SemanticModelData, h as SemanticModelChildRef, i as SemanticChildObjectDataMap, j as FIELD_ROLES, k as CONSTRAINT_SEVERITIES, m as SemanticMetricData, n as MetastoreClient, o as SemanticConstraintData, p as SemanticGlossaryData, t as CreateSemanticObjectMeta, u as SemanticDatasetData, x as SemanticRelationshipData } from "../../types-DiE081mn.js";
+import { A as CONSTRAINT_TYPES, D as UpdateSemanticObjectMeta, F as SQL_DIALECTS, M as RELATIONSHIP_JOIN_TYPES, N as RULE_OPERATORS, O as CONSTRAINT_SCOPES, P as SEMANTIC_OBJECT_SCOPES, T as SemanticUnreadableObjectRef, _ as SemanticObject, a as SemanticChildObjectType, b as SemanticObjectType, g as SemanticModelData, h as SemanticModelChildRef, i as SemanticChildObjectDataMap, j as FIELD_ROLES, k as CONSTRAINT_SEVERITIES, m as SemanticMetricData, n as MetastoreClient, o as SemanticConstraintData, p as SemanticGlossaryData, t as CreateSemanticObjectMeta, u as SemanticDatasetData, x as SemanticRelationshipData } from "../../types-Vu09EUZs.js";
 import { z } from "zod";
 //#region src/sdks/semanticLayer/errorMessage.d.ts
 /**

package/dist/sdk/semanticLayer/types.d.cts

@@ -1,2 +1,2 @@
-import { C as SemanticRuleExpression, D as UpdateSemanticObjectMeta, E as SemanticValidationQuery, S as SemanticRelationshipJoinType, T as SemanticUnreadableObjectRef, _ as SemanticObject, a as SemanticChildObjectType, b as SemanticObjectType, c as SemanticConstraintSeverity, d as SemanticFieldData, f as SemanticFieldRole, g as SemanticModelData, h as SemanticModelChildRef, i as SemanticChildObjectDataMap, l as SemanticConstraintType, m as SemanticMetricData, n as MetastoreClient, o as SemanticConstraintData, p as SemanticGlossaryData, r as SemanticAiMetadata, s as SemanticConstraintScope, t as CreateSemanticObjectMeta, u as SemanticDatasetData, v as SemanticObjectMeta, w as SemanticRuleOperator, x as SemanticRelationshipData, y as SemanticObjectScope } from "../../types-C8oZX0oP.cjs";
+import { C as SemanticRuleExpression, D as UpdateSemanticObjectMeta, E as SemanticValidationQuery, S as SemanticRelationshipJoinType, T as SemanticUnreadableObjectRef, _ as SemanticObject, a as SemanticChildObjectType, b as SemanticObjectType, c as SemanticConstraintSeverity, d as SemanticFieldData, f as SemanticFieldRole, g as SemanticModelData, h as SemanticModelChildRef, i as SemanticChildObjectDataMap, l as SemanticConstraintType, m as SemanticMetricData, n as MetastoreClient, o as SemanticConstraintData, p as SemanticGlossaryData, r as SemanticAiMetadata, s as SemanticConstraintScope, t as CreateSemanticObjectMeta, u as SemanticDatasetData, v as SemanticObjectMeta, w as SemanticRuleOperator, x as SemanticRelationshipData, y as SemanticObjectScope } from "../../types-C_raqbl-.cjs";
 export { CreateSemanticObjectMeta, MetastoreClient, SemanticAiMetadata, SemanticChildObjectDataMap, SemanticChildObjectType, SemanticConstraintData, SemanticConstraintScope, SemanticConstraintSeverity, SemanticConstraintType, SemanticDatasetData, SemanticFieldData, SemanticFieldRole, SemanticGlossaryData, SemanticMetricData, SemanticModelChildRef, SemanticModelData, SemanticObject, SemanticObjectMeta, SemanticObjectScope, SemanticObjectType, SemanticRelationshipData, SemanticRelationshipJoinType, SemanticRuleExpression, SemanticRuleOperator, SemanticUnreadableObjectRef, SemanticValidationQuery, UpdateSemanticObjectMeta };

package/dist/sdk/semanticLayer/types.d.ts

@@ -1,2 +1,2 @@
-import { C as SemanticRuleExpression, D as UpdateSemanticObjectMeta, E as SemanticValidationQuery, S as SemanticRelationshipJoinType, T as SemanticUnreadableObjectRef, _ as SemanticObject, a as SemanticChildObjectType, b as SemanticObjectType, c as SemanticConstraintSeverity, d as SemanticFieldData, f as SemanticFieldRole, g as SemanticModelData, h as SemanticModelChildRef, i as SemanticChildObjectDataMap, l as SemanticConstraintType, m as SemanticMetricData, n as MetastoreClient, o as SemanticConstraintData, p as SemanticGlossaryData, r as SemanticAiMetadata, s as SemanticConstraintScope, t as CreateSemanticObjectMeta, u as SemanticDatasetData, v as SemanticObjectMeta, w as SemanticRuleOperator, x as SemanticRelationshipData, y as SemanticObjectScope } from "../../types-DiE081mn.js";
+import { C as SemanticRuleExpression, D as UpdateSemanticObjectMeta, E as SemanticValidationQuery, S as SemanticRelationshipJoinType, T as SemanticUnreadableObjectRef, _ as SemanticObject, a as SemanticChildObjectType, b as SemanticObjectType, c as SemanticConstraintSeverity, d as SemanticFieldData, f as SemanticFieldRole, g as SemanticModelData, h as SemanticModelChildRef, i as SemanticChildObjectDataMap, l as SemanticConstraintType, m as SemanticMetricData, n as MetastoreClient, o as SemanticConstraintData, p as SemanticGlossaryData, r as SemanticAiMetadata, s as SemanticConstraintScope, t as CreateSemanticObjectMeta, u as SemanticDatasetData, v as SemanticObjectMeta, w as SemanticRuleOperator, x as SemanticRelationshipData, y as SemanticObjectScope } from "../../types-Vu09EUZs.js";
 export { CreateSemanticObjectMeta, MetastoreClient, SemanticAiMetadata, SemanticChildObjectDataMap, SemanticChildObjectType, SemanticConstraintData, SemanticConstraintScope, SemanticConstraintSeverity, SemanticConstraintType, SemanticDatasetData, SemanticFieldData, SemanticFieldRole, SemanticGlossaryData, SemanticMetricData, SemanticModelChildRef, SemanticModelData, SemanticObject, SemanticObjectMeta, SemanticObjectScope, SemanticObjectType, SemanticRelationshipData, SemanticRelationshipJoinType, SemanticRuleExpression, SemanticRuleOperator, SemanticUnreadableObjectRef, SemanticValidationQuery, UpdateSemanticObjectMeta };