@elmohq/sdk 0.2.0 → 0.2.1

package/dist/{tools-B1lVtYAr.mjs → tools-B2xqLDiH.mjs}

@@ -1,4 +1,4 @@
-//#region src/internal/core/backoff.ts
+// src/internal/core/backoff.ts
 function jitterShare(jitter) {
 	if (typeof jitter === "number") return Math.min(1, Math.max(0, jitter));
 	if (jitter === "equal") return .5;
@@ -87,8 +87,7 @@ function retryAfterDelay(response, headers = RETRY_AFTER_HEADERS, now = Date.now
 		if (delay !== void 0) return delay;
 	}
 }
-//#endregion
-//#region src/internal/core/errors.ts
+// src/internal/core/errors.ts
 /** The base of every error this SDK throws, including one from a call that never arrived. */
 var ElmoError = class extends Error {
 	/** The class's name. Compare it where `instanceof` fails, such as across two copies of this SDK. */
@@ -398,8 +397,7 @@ function unreadableValue(at, value, cause, response) {
 		value
 	});
 }
-//#endregion
-//#region src/internal/codec/registry.ts
+// src/internal/codec/registry.ts
 function charsetOf(contentType) {
 	return contentType?.match(/;\s*charset\s*=\s*"?([^";\s]+)/i)?.[1];
 }
@@ -442,16 +440,14 @@ function encodeNamedBody(codecs, mediaType, options) {
 		payload: codec.encode(options.body)
 	};
 }
-//#endregion
-//#region src/internal/core/text.ts
+// src/internal/core/text.ts
 function scalarText(value) {
 	return value instanceof Date ? value.toISOString() : void 0;
 }
 function toText(value) {
 	return typeof value === "string" ? value : scalarText(value) ?? String(value);
 }
-//#endregion
-//#region src/internal/core/metadata.ts
+// src/internal/core/metadata.ts
 function entriesOf(source) {
 	if (typeof source[Symbol.iterator] === "function") return source;
 	return Object.entries(source);
@@ -513,8 +509,7 @@ function metadataValue(value) {
 	if (value === void 0) return void 0;
 	return Array.isArray(value) ? value.join(", ") : value;
 }
-//#endregion
-//#region src/internal/core/config.ts
+// src/internal/core/config.ts
 function foldRetry(sources, merged) {
 	if (!sources.some((source) => source?.["retry"] !== void 0)) return merged;
 	let retry;
@@ -576,8 +571,7 @@ function baseURLOf(options, fallback) {
 function mergeDefaults(...sources) {
 	return merge(sources, true);
 }
-//#endregion
-//#region src/internal/core/credentials.ts
+// src/internal/core/credentials.ts
 const LAYER_ALIASES = {
 	defaultHeaders: "headers",
 	defaultPath: "path",
@@ -606,8 +600,7 @@ function applyCredentials(config, credentials) {
 	}
 	return applied ?? config;
 }
-//#endregion
-//#region src/internal/core/body.ts
+// src/internal/core/body.ts
 function discardBody(result) {
 	const { response } = result ?? {};
 	if (response && !response.bodyUsed) response.body?.cancel().catch(() => {});
@@ -650,8 +643,7 @@ async function bufferReply(response, signal) {
 		controller.close();
 	} }), response);
 }
-//#endregion
-//#region src/internal/core/features.ts
+// src/internal/core/features.ts
 var FeatureRunner = class {
 	features;
 	constructor(features = []) {
@@ -687,13 +679,11 @@ var FeatureRunner = class {
 		return current;
 	}
 };
-//#endregion
-//#region src/internal/core/protocol.ts
+// src/internal/core/protocol.ts
 function onlyProtocol(protocols, _interaction) {
 	return Object.values(protocols)[0];
 }
-//#endregion
-//#region src/internal/core/dispatch.ts
+// src/internal/core/dispatch.ts
 async function readReply$1(setup, sent, request, from) {
 	const { binding, ctx, runner } = sent;
 	try {
@@ -876,8 +866,7 @@ function envDefaults(base, env = {}, credentials = {}) {
 	});
 	return defaults;
 }
-//#endregion
-//#region src/internal/core/client.ts
+// src/internal/core/client.ts
 function clientOf(setup) {
 	return Object.defineProperty({
 		call(callable, options) {
@@ -919,13 +908,11 @@ function withClient(source, client, key = "client") {
 	derived[key] = client;
 	return derived;
 }
-//#endregion
-//#region src/internal/core/read-reply.ts
+// src/internal/core/read-reply.ts
 async function readReply(read, value, _response) {
 	return await read(value);
 }
-//#endregion
-//#region src/internal/feature/validate.ts
+// src/internal/feature/validate.ts
 async function runValidator(validate, value, options, response) {
 	if (!validate || options["validate"] === false) return value;
 	return await readReply(validate, value, response);
@@ -966,8 +953,7 @@ function reviving(revive) {
 		return data;
 	};
 }
-//#endregion
-//#region src/resources/shared/auth.ts
+// src/resources/shared/auth.ts
 /**
 * An instance admin key from `ADMIN_API_KEYS`, or an organization key (`elmo_…`) issued from the
 * dashboard.
@@ -977,8 +963,7 @@ const apiKeyRequirements = [{
 	scheme: "bearer",
 	type: "http"
 }];
-//#endregion
-//#region src/resources/shared/resource.ts
+// src/resources/shared/resource.ts
 var ElmoResource = class {
 	/** The client every call on this SDK dispatches through. */
 	client;
@@ -996,8 +981,7 @@ var ElmoResource = class {
 		return withClient(this, clientFor(options, this.client));
 	}
 };
-//#endregion
-//#region src/internal/core/lazy-promise.ts
+// src/internal/core/lazy-promise.ts
 var LazyPromise = class extends Promise {
 	answer;
 	constructor() {
@@ -1023,8 +1007,7 @@ function unattended(promise) {
 	promise.catch(() => {});
 	return promise;
 }
-//#endregion
-//#region src/internal/core/call-promise.ts
+// src/internal/core/call-promise.ts
 function awaitedResult(client, options, result) {
 	if ((options.errors ?? client.setup.defaults.errors) === "return") return result;
 	if (result.ok === false) throw result.error;
@@ -1115,16 +1098,266 @@ var RestCallPromise = class extends CallPromise {
 function callPromise(client, callable, options = {}) {
 	return new RestCallPromise(client, callable, options);
 }
-//#endregion
-//#region src/internal/core/callable.ts
+// src/internal/core/callable.ts
 function callable(descriptor) {
 	return {
 		interaction: "unary",
 		...descriptor
 	};
 }
-//#endregion
-//#region src/internal/core/params.ts
+// src/internal/core/page.ts
+function readPath(value, path) {
+	if (!path) return value;
+	let current = value;
+	for (const key of path.split(".")) {
+		if (current === null || typeof current !== "object") return void 0;
+		current = current[key];
+	}
+	return current;
+}
+function readItems(data, pagination) {
+	const items = readPath(data, pagination.items);
+	return Array.isArray(items) ? items : [];
+}
+function withPosition(options, pagination, value) {
+	const name = pagination.param;
+	if (!name) return options;
+	if ((pagination.in ?? "query") === "body") return {
+		...options,
+		body: {
+			...options.body,
+			[name]: value
+		}
+	};
+	return {
+		...options,
+		query: {
+			...options.query,
+			[name]: value
+		}
+	};
+}
+function resumeAt(walk, pagination, param) {
+	if (pagination.style === "link") {
+		const options = { ...walk.options };
+		delete options.query;
+		return {
+			...walk,
+			descriptor: {
+				...walk.descriptor,
+				address: param
+			},
+			options
+		};
+	}
+	const options = withPosition(walk.options, pagination, param);
+	if (pagination.style === "cursor") return {
+		...walk,
+		cursor: param,
+		options
+	};
+	return {
+		...walk,
+		options,
+		position: param
+	};
+}
+function readCount(data, path) {
+	if (!path) return void 0;
+	const value = readPath(data, path);
+	if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return void 0;
+	return value;
+}
+function startOf(pagination) {
+	return pagination.start ?? (pagination.style === "page" ? 1 : 0);
+}
+function stepCounted(walk, pagination, result, count, limit) {
+	if (!count) return void 0;
+	const size = readCount(result.data, pagination.size) ?? limit;
+	const position = walk.position + (pagination.style === "page" ? 1 : size || count);
+	const start = startOf(pagination);
+	const pages = pagination.style === "page" ? readCount(result.data, pagination.pages) : void 0;
+	const total = readCount(result.data, pagination.total);
+	if (pages === void 0 && total === void 0 && size !== void 0 && count < size) return;
+	if (pages !== void 0 && position - start >= pages) return void 0;
+	if (total !== void 0) {
+		if ((pagination.style === "page" ? (position - start) * (size ?? count) : position) >= total) return void 0;
+	}
+	return position;
+}
+const STEPPERS = { page: stepCounted };
+const SCHEME_RE = /^[a-z][a-z\d+.-]*:/i;
+function pageURL(address) {
+	if (typeof address !== "string") return void 0;
+	try {
+		const url = new URL(address, globalThis.location?.href);
+		return url.origin === "null" ? void 0 : url;
+	} catch {
+		return;
+	}
+}
+function followLink(client, walk, link) {
+	const own = pageURL(client.resolveAddress(walk.descriptor, walk.options));
+	if (!own) {
+		if (!SCHEME_RE.test(link) && !link.startsWith("//")) return link;
+		throw new ElmoError("Pagination stopped: the next page names a host, and no base URL says which host this client sends its credentials to.");
+	}
+	const target = new URL(link, own);
+	if (target.origin !== own.origin) throw new ElmoError(`Pagination stopped: the next page is on ${target.origin}, and this client sends its credentials only to ${own.origin}.`);
+	return SCHEME_RE.test(link) ? link : target.href;
+}
+function saysMore(data, pagination) {
+	return !pagination.more || readPath(data, pagination.more) !== false;
+}
+function stepWalk(client, walk, pagination, result, count, limit) {
+	const step = STEPPERS[pagination.style];
+	if (!step) throw new ElmoError(`Cannot walk "${walk.descriptor.address}": this client does not page by "${pagination.style}".`);
+	if (!saysMore(result.data, pagination)) return void 0;
+	const next = step(walk, pagination, result, count, limit);
+	return pagination.style === "link" && next !== void 0 ? followLink(client, walk, next) : next;
+}
+async function* walkFrom(page, maxPages) {
+	let current = page;
+	for (let index = 1;; index++) {
+		for (const item of current.data) yield item;
+		if (index >= maxPages || !current.hasNextPage()) return;
+		current = await current.getNextPage();
+	}
+}
+async function loadPage(client, walk, pagination, limit, maxPages) {
+	const result = await client.call(walk.descriptor, walk.options);
+	if (result.error !== void 0) throw result.error;
+	const data = readItems(result.data, pagination);
+	const param = stepWalk(client, walk, pagination, result, data.length, limit);
+	const page = {
+		[Symbol.asyncIterator]: () => walkFrom(page, maxPages),
+		body: result.data,
+		data,
+		getNextPage: () => {
+			if (param === void 0) return Promise.reject(new ElmoError(`"${walk.descriptor.address}" has no page after this one. Check \`hasNextPage()\` first.`));
+			return loadPage(client, resumeAt(walk, pagination, param), pagination, limit, maxPages);
+		},
+		hasNextPage: () => param !== void 0,
+		nextPageParam: param,
+		status: result.status
+	};
+	return page;
+}
+function maxPagesFor(client, options) {
+	return options["maxPages"] ?? client.setup.defaults["maxPages"] ?? 1e3;
+}
+function openedAt(options, pagination) {
+	if (!pagination.param) return void 0;
+	return options[pagination.in ?? "query"]?.[pagination.param];
+}
+function paginationOf(callable) {
+	if (callable.pagination) return callable.pagination;
+	throw new ElmoError(`"${callable.address}" is not a paged call, so it has no pages to walk.`);
+}
+function openWalk(callable, options) {
+	const pagination = paginationOf(callable);
+	const opened = openedAt(options, pagination);
+	return {
+		cursor: pagination.style === "cursor" ? opened : void 0,
+		descriptor: callable,
+		options: {
+			...options,
+			raw: true
+		},
+		position: typeof opened === "number" && Number.isFinite(opened) ? opened : startOf(pagination)
+	};
+}
+function pageStream(load, maxPages) {
+	return { async *[Symbol.asyncIterator]() {
+		let current = await load();
+		for (let index = 1;; index++) {
+			yield current;
+			if (index >= maxPages || !current.hasNextPage()) return;
+			current = await current.getNextPage();
+		}
+	} };
+}
+function requestedLimit(options, pagination) {
+	if (!pagination.limitParam) return void 0;
+	const layer = options[pagination.in ?? "query"];
+	const limit = Number(layer?.[pagination.limitParam]);
+	return Number.isFinite(limit) && limit > 0 ? limit : void 0;
+}
+/**
+* A paginated call. Awaiting it gives the first page, or its result envelope
+* under the `'return'` error mode. Iterating it gives every item on every page,
+* and throws on a failed page under either mode.
+*/
+var PagePromise = class extends LazyPromise {
+	envelope;
+	callable;
+	client;
+	limit;
+	maxPages;
+	options;
+	pagination;
+	project;
+	first;
+	constructor(client, callable, options, project) {
+		super();
+		this.callable = callable;
+		this.client = client;
+		this.options = options;
+		this.pagination = paginationOf(callable);
+		this.limit = requestedLimit(options, this.pagination);
+		this.maxPages = maxPagesFor(client, options);
+		this.project = project;
+		const opened = openWalk(this.callable, this.options);
+		const param = options["pageParam"];
+		this.first = unattended(loadPage(this.client, param === void 0 ? opened : resumeAt(opened, this.pagination, param), this.pagination, this.limit, this.maxPages));
+	}
+	/** Every item, page after page, up to `maxPages`. */
+	async *[Symbol.asyncIterator]() {
+		yield* walkFrom(await this.first, this.maxPages);
+	}
+	/** Every page, up to `maxPages`. */
+	iterPages() {
+		return pageStream(() => this.first, this.maxPages);
+	}
+	/**
+	* The whole result envelope. A failure of the call is returned on it, not
+	* thrown. What one of your own functions throws, such as a hook, is thrown
+	* as it is.
+	*/
+	result() {
+		return this.envelope ??= this.read();
+	}
+	/** The page alone, with a failure thrown rather than handed back. */
+	async unwrap() {
+		const result = await this.result();
+		if (result.ok === false) throw result.error;
+		return result.data;
+	}
+	async read() {
+		try {
+			const page = await this.first;
+			return {
+				data: this.project(page),
+				ok: true,
+				status: page.status
+			};
+		} catch (error) {
+			if (!(error instanceof ElmoError)) throw error;
+			return {
+				error,
+				ok: false,
+				status: error instanceof APIError ? error.status : void 0
+			};
+		}
+	}
+	settle() {
+		return this.result().then((result) => awaitedResult(this.client, this.options, result));
+	}
+};
+function pages(client, callable, options = {}) {
+	return new PagePromise(client, callable, options, (page) => page);
+}
+// src/internal/core/params.ts
 const LAYERS = ["path", "query"];
 function mergeParams(inputs, options) {
 	const merged = {
@@ -1190,8 +1423,7 @@ function groupParams(options, layer) {
 	if (!options || !Object.keys(options).length) return {};
 	return { [layer]: { ...options } };
 }
-//#endregion
-//#region src/resources/analytics.ts
+// src/resources/analytics.ts
 const getBrandAnalyticsFields = { path: ["brandId"] };
 function reviveDateRange(value) {
 	if (value.start != null) value.start = decoded("DateRange.start", value.start, (raw) => new Date(raw));
@@ -1215,6 +1447,15 @@ const listBrandCitationDomainsDescriptor = /* @__PURE__ */ callable({
 	address: "/brands/{brandId}/citations/domains",
 	auth: apiKeyRequirements,
 	method: "get",
+	pagination: {
+		items: "data",
+		limitParam: "limit",
+		pages: "pagination.totalPages",
+		param: "page",
+		size: "pagination.limit",
+		style: "page",
+		total: "pagination.total"
+	},
 	returns: "json",
 	validators: { response: /* @__PURE__ */ reviving(reviveCitationDomainList) }
 });
@@ -1226,6 +1467,15 @@ const listBrandCitationURLsDescriptor = /* @__PURE__ */ callable({
 	address: "/brands/{brandId}/citations/urls",
 	auth: apiKeyRequirements,
 	method: "get",
+	pagination: {
+		items: "data",
+		limitParam: "limit",
+		pages: "pagination.totalPages",
+		param: "page",
+		size: "pagination.limit",
+		style: "page",
+		total: "pagination.total"
+	},
 	returns: "json",
 	validators: { response: /* @__PURE__ */ reviving(reviveCitationUrlList) }
 });
@@ -1255,6 +1505,15 @@ const getBrandQueryFanoutDescriptor = /* @__PURE__ */ callable({
 	address: "/brands/{brandId}/query-fanout",
 	auth: apiKeyRequirements,
 	method: "get",
+	pagination: {
+		items: "data",
+		limitParam: "limit",
+		pages: "pagination.totalPages",
+		param: "page",
+		size: "pagination.limit",
+		style: "page",
+		total: "pagination.total"
+	},
 	returns: "json",
 	validators: { response: /* @__PURE__ */ reviving(reviveBrandQueryFanout) }
 });
@@ -1284,12 +1543,10 @@ var Domains = class extends ElmoResource {
 	* List cited domains
 	*
 	* Domains the engines cited when answering this brand's prompts, categorized and compared against
-	* the equal-length window immediately before this one.
-	*
-	* @param brandId Brand identifier.
+	* the equal-length window immediately before this one.
 	*/
 	list(brandId, params, options) {
-		return callPromise(options?.client ?? this.client, listBrandCitationDomainsDescriptor, mergeParams(placeParams({
+		return pages(options?.client ?? this.client, listBrandCitationDomainsDescriptor, mergeParams(placeParams({
 			...params,
 			brandId
 		}, listBrandCitationDomainsFields, "query"), options));
@@ -1301,11 +1558,9 @@ var URLs = class extends ElmoResource {
 	* List cited URLs
 	*
 	* Individual pages the engines cited, with their category and page type.
-	*
-	* @param brandId Brand identifier.
 	*/
 	list(brandId, params, options) {
-		return callPromise(options?.client ?? this.client, listBrandCitationURLsDescriptor, mergeParams(placeParams({
+		return pages(options?.client ?? this.client, listBrandCitationURLsDescriptor, mergeParams(placeParams({
 			...params,
 			brandId
 		}, listBrandCitationUrlsFields, "query"), options));
@@ -1350,18 +1605,15 @@ var QueryFanout = class extends ElmoResource {
 	*
 	* The searches engines ran while answering this brand's prompts. Engines that don't expose their
 	* searches still contribute runs, so `coverageRate` is the honest denominator.
-	*
-	* @param brandId Brand identifier.
 	*/
 	get(brandId, params, options) {
-		return callPromise(options?.client ?? this.client, getBrandQueryFanoutDescriptor, mergeParams(placeParams({
+		return pages(options?.client ?? this.client, getBrandQueryFanoutDescriptor, mergeParams(placeParams({
 			...params,
 			brandId
 		}, getBrandQueryFanoutFields, "query"), options));
 	}
 };
-//#endregion
-//#region src/resources/opportunities.ts
+// src/resources/opportunities.ts
 const getBrandOpportunitiesFields = { path: ["brandId"] };
 function reviveBrandOpportunities(value) {
 	if (value.generatedAt != null) value.generatedAt = decoded("BrandOpportunities.generatedAt", value.generatedAt, (raw) => new Date(raw));
@@ -1398,8 +1650,7 @@ var Opportunities = class extends ElmoResource {
 		return callPromise(options?.client ?? this.client, getBrandOpportunitiesDescriptor, mergeParams(placeParams({ brandId }, getBrandOpportunitiesFields, "query"), options));
 	}
 };
-//#endregion
-//#region src/resources/shared/rule.ts
+// src/resources/shared/rule.ts
 const nameRule = {
 	min: 1,
 	name: "name",
@@ -1420,8 +1671,7 @@ const valueRule = {
 	name: "value",
 	of: "characters"
 };
-//#endregion
-//#region src/resources/tags.ts
+// src/resources/tags.ts
 const listBrandTagsFields = { path: ["brandId"] };
 const listBrandTagsDescriptor = /* @__PURE__ */ callable({
 	address: "/brands/{brandId}/tags",
@@ -1446,261 +1696,7 @@ var Tags = class extends ElmoResource {
 		return callPromise(options?.client ?? this.client, listBrandTagsDescriptor, mergeParams(placeParams({ brandId }, listBrandTagsFields, "query"), options));
 	}
 };
-//#endregion
-//#region src/internal/core/page.ts
-function readPath(value, path) {
-	if (!path) return value;
-	let current = value;
-	for (const key of path.split(".")) {
-		if (current === null || typeof current !== "object") return void 0;
-		current = current[key];
-	}
-	return current;
-}
-function readItems(data, pagination) {
-	const items = readPath(data, pagination.items);
-	return Array.isArray(items) ? items : [];
-}
-function withPosition(options, pagination, value) {
-	const name = pagination.param;
-	if (!name) return options;
-	if ((pagination.in ?? "query") === "body") return {
-		...options,
-		body: {
-			...options.body,
-			[name]: value
-		}
-	};
-	return {
-		...options,
-		query: {
-			...options.query,
-			[name]: value
-		}
-	};
-}
-function resumeAt(walk, pagination, param) {
-	if (pagination.style === "link") {
-		const options = { ...walk.options };
-		delete options.query;
-		return {
-			...walk,
-			descriptor: {
-				...walk.descriptor,
-				address: param
-			},
-			options
-		};
-	}
-	const options = withPosition(walk.options, pagination, param);
-	if (pagination.style === "cursor") return {
-		...walk,
-		cursor: param,
-		options
-	};
-	return {
-		...walk,
-		options,
-		position: param
-	};
-}
-function readCount(data, path) {
-	if (!path) return void 0;
-	const value = readPath(data, path);
-	if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return void 0;
-	return value;
-}
-function startOf(pagination) {
-	return pagination.start ?? (pagination.style === "page" ? 1 : 0);
-}
-function stepCounted(walk, pagination, result, count, limit) {
-	if (!count) return void 0;
-	const size = readCount(result.data, pagination.size) ?? limit;
-	const position = walk.position + (pagination.style === "page" ? 1 : size || count);
-	const start = startOf(pagination);
-	const pages = pagination.style === "page" ? readCount(result.data, pagination.pages) : void 0;
-	const total = readCount(result.data, pagination.total);
-	if (pages === void 0 && total === void 0 && size !== void 0 && count < size) return;
-	if (pages !== void 0 && position - start >= pages) return void 0;
-	if (total !== void 0) {
-		if ((pagination.style === "page" ? (position - start) * (size ?? count) : position) >= total) return void 0;
-	}
-	return position;
-}
-const STEPPERS = { page: stepCounted };
-const SCHEME_RE = /^[a-z][a-z\d+.-]*:/i;
-function pageURL(address) {
-	if (typeof address !== "string") return void 0;
-	try {
-		const url = new URL(address, globalThis.location?.href);
-		return url.origin === "null" ? void 0 : url;
-	} catch {
-		return;
-	}
-}
-function followLink(client, walk, link) {
-	const own = pageURL(client.resolveAddress(walk.descriptor, walk.options));
-	if (!own) {
-		if (!SCHEME_RE.test(link) && !link.startsWith("//")) return link;
-		throw new ElmoError("Pagination stopped: the next page names a host, and no base URL says which host this client sends its credentials to.");
-	}
-	const target = new URL(link, own);
-	if (target.origin !== own.origin) throw new ElmoError(`Pagination stopped: the next page is on ${target.origin}, and this client sends its credentials only to ${own.origin}.`);
-	return SCHEME_RE.test(link) ? link : target.href;
-}
-function saysMore(data, pagination) {
-	return !pagination.more || readPath(data, pagination.more) !== false;
-}
-function stepWalk(client, walk, pagination, result, count, limit) {
-	const step = STEPPERS[pagination.style];
-	if (!step) throw new ElmoError(`Cannot walk "${walk.descriptor.address}": this client does not page by "${pagination.style}".`);
-	if (!saysMore(result.data, pagination)) return void 0;
-	const next = step(walk, pagination, result, count, limit);
-	return pagination.style === "link" && next !== void 0 ? followLink(client, walk, next) : next;
-}
-async function* walkFrom(page, maxPages) {
-	let current = page;
-	for (let index = 1;; index++) {
-		for (const item of current.data) yield item;
-		if (index >= maxPages || !current.hasNextPage()) return;
-		current = await current.getNextPage();
-	}
-}
-async function loadPage(client, walk, pagination, limit, maxPages) {
-	const result = await client.call(walk.descriptor, walk.options);
-	if (result.error !== void 0) throw result.error;
-	const data = readItems(result.data, pagination);
-	const param = stepWalk(client, walk, pagination, result, data.length, limit);
-	const page = {
-		[Symbol.asyncIterator]: () => walkFrom(page, maxPages),
-		body: result.data,
-		data,
-		getNextPage: () => {
-			if (param === void 0) return Promise.reject(new ElmoError(`"${walk.descriptor.address}" has no page after this one. Check \`hasNextPage()\` first.`));
-			return loadPage(client, resumeAt(walk, pagination, param), pagination, limit, maxPages);
-		},
-		hasNextPage: () => param !== void 0,
-		nextPageParam: param,
-		status: result.status
-	};
-	return page;
-}
-function maxPagesFor(client, options) {
-	return options["maxPages"] ?? client.setup.defaults["maxPages"] ?? 1e3;
-}
-function openedAt(options, pagination) {
-	if (!pagination.param) return void 0;
-	return options[pagination.in ?? "query"]?.[pagination.param];
-}
-function paginationOf(callable) {
-	if (callable.pagination) return callable.pagination;
-	throw new ElmoError(`"${callable.address}" is not a paged call, so it has no pages to walk.`);
-}
-function openWalk(callable, options) {
-	const pagination = paginationOf(callable);
-	const opened = openedAt(options, pagination);
-	return {
-		cursor: pagination.style === "cursor" ? opened : void 0,
-		descriptor: callable,
-		options: {
-			...options,
-			raw: true
-		},
-		position: typeof opened === "number" && Number.isFinite(opened) ? opened : startOf(pagination)
-	};
-}
-function pageStream(load, maxPages) {
-	return { async *[Symbol.asyncIterator]() {
-		let current = await load();
-		for (let index = 1;; index++) {
-			yield current;
-			if (index >= maxPages || !current.hasNextPage()) return;
-			current = await current.getNextPage();
-		}
-	} };
-}
-function requestedLimit(options, pagination) {
-	if (!pagination.limitParam) return void 0;
-	const layer = options[pagination.in ?? "query"];
-	const limit = Number(layer?.[pagination.limitParam]);
-	return Number.isFinite(limit) && limit > 0 ? limit : void 0;
-}
-/**
-* A paginated call. Awaiting it gives the first page, or its result envelope
-* under the `'return'` error mode. Iterating it gives every item on every page,
-* and throws on a failed page under either mode.
-*/
-var PagePromise = class extends LazyPromise {
-	envelope;
-	callable;
-	client;
-	limit;
-	maxPages;
-	options;
-	pagination;
-	project;
-	first;
-	constructor(client, callable, options, project) {
-		super();
-		this.callable = callable;
-		this.client = client;
-		this.options = options;
-		this.pagination = paginationOf(callable);
-		this.limit = requestedLimit(options, this.pagination);
-		this.maxPages = maxPagesFor(client, options);
-		this.project = project;
-		const opened = openWalk(this.callable, this.options);
-		const param = options["pageParam"];
-		this.first = unattended(loadPage(this.client, param === void 0 ? opened : resumeAt(opened, this.pagination, param), this.pagination, this.limit, this.maxPages));
-	}
-	/** Every item, page after page, up to `maxPages`. */
-	async *[Symbol.asyncIterator]() {
-		yield* walkFrom(await this.first, this.maxPages);
-	}
-	/** Every page, up to `maxPages`. */
-	iterPages() {
-		return pageStream(() => this.first, this.maxPages);
-	}
-	/**
-	* The whole result envelope. A failure of the call is returned on it, not
-	* thrown. What one of your own functions throws, such as a hook, is thrown
-	* as it is.
-	*/
-	result() {
-		return this.envelope ??= this.read();
-	}
-	/** The page alone, with a failure thrown rather than handed back. */
-	async unwrap() {
-		const result = await this.result();
-		if (result.ok === false) throw result.error;
-		return result.data;
-	}
-	async read() {
-		try {
-			const page = await this.first;
-			return {
-				data: this.project(page),
-				ok: true,
-				status: page.status
-			};
-		} catch (error) {
-			if (!(error instanceof ElmoError)) throw error;
-			return {
-				error,
-				ok: false,
-				status: error instanceof APIError ? error.status : void 0
-			};
-		}
-	}
-	settle() {
-		return this.result().then((result) => awaitedResult(this.client, this.options, result));
-	}
-};
-function pages(client, callable, options = {}) {
-	return new PagePromise(client, callable, options, (page) => page);
-}
-//#endregion
-//#region src/resources/brands.ts
+// src/resources/brands.ts
 function reviveBrand(value) {
 	if (value.createdAt != null) value.createdAt = decoded("Brand.createdAt", value.createdAt, (raw) => new Date(raw));
 	if (value.updatedAt != null) value.updatedAt = decoded("Brand.updatedAt", value.updatedAt, (raw) => new Date(raw));
@@ -1822,8 +1818,7 @@ var Brands = class extends ElmoResource {
 		return this._tags ??= new Tags(this.client);
 	}
 };
-//#endregion
-//#region src/resources/competitors.ts
+// src/resources/competitors.ts
 function reviveCompetitor(value) {
 	if (value.createdAt != null) value.createdAt = decoded("Competitor.createdAt", value.createdAt, (raw) => new Date(raw));
 	if (value.updatedAt != null) value.updatedAt = decoded("Competitor.updatedAt", value.updatedAt, (raw) => new Date(raw));
@@ -1928,8 +1923,7 @@ var Competitors = class extends ElmoResource {
 		}, updateCompetitorFields, "body"), options));
 	}
 };
-//#endregion
-//#region src/resources/identity.ts
+// src/resources/identity.ts
 function reviveApiKeyIdentity(value) {
 	if (value.createdAt != null) value.createdAt = decoded("ApiKeyIdentity.createdAt", value.createdAt, (raw) => new Date(raw));
 	if (value.expiresAt != null) value.expiresAt = decoded("ApiKeyIdentity.expiresAt", value.expiresAt, (raw) => new Date(raw));
@@ -1954,8 +1948,7 @@ var Me = class extends ElmoResource {
 		return callPromise(options?.client ?? this.client, getMeDescriptor, options);
 	}
 };
-//#endregion
-//#region src/resources/models.ts
+// src/resources/models.ts
 const listModelsDescriptor = /* @__PURE__ */ callable({
 	address: "/models",
 	auth: apiKeyRequirements,
@@ -1976,8 +1969,7 @@ var Models = class extends ElmoResource {
 		return callPromise(options?.client ?? this.client, listModelsDescriptor, options);
 	}
 };
-//#endregion
-//#region src/resources/organizations.ts
+// src/resources/organizations.ts
 const getOrganizationBillingFields = { path: ["organizationId"] };
 function reviveBillingPlan(value) {
 	if (value.periodEnd != null) value.periodEnd = decoded("BillingPlan.periodEnd", value.periodEnd, (raw) => new Date(raw));
@@ -2067,8 +2059,7 @@ var Organizations = class extends ElmoResource {
 		return this._billing ??= new Billing(this.client);
 	}
 };
-//#endregion
-//#region src/resources/runs.ts
+// src/resources/runs.ts
 const listPromptRunsFields = { path: ["promptId"] };
 function reviveRunSummary(value) {
 	if (value.createdAt != null) value.createdAt = decoded("RunSummary.createdAt", value.createdAt, (raw) => new Date(raw));
@@ -2134,8 +2125,7 @@ var Runs = class extends ElmoResource {
 		}, listPromptRunsFields, "query"), options));
 	}
 };
-//#endregion
-//#region src/resources/snapshots.ts
+// src/resources/snapshots.ts
 const getPromptSnapshotFields = { path: ["promptId"] };
 const getPromptSnapshotDescriptor = /* @__PURE__ */ callable({
 	address: "/prompts/{promptId}/snapshot",
@@ -2159,8 +2149,7 @@ var Snapshot = class extends ElmoResource {
 		}, getPromptSnapshotFields, "query"), options));
 	}
 };
-//#endregion
-//#region src/resources/prompts.ts
+// src/resources/prompts.ts
 function revivePrompt(value) {
 	if (value.createdAt != null) value.createdAt = decoded("Prompt.createdAt", value.createdAt, (raw) => new Date(raw));
 	if (value.updatedAt != null) value.updatedAt = decoded("Prompt.updatedAt", value.updatedAt, (raw) => new Date(raw));
@@ -2300,8 +2289,7 @@ var Prompts = class extends ElmoResource {
 		return this._snapshot ??= new Snapshot(this.client);
 	}
 };
-//#endregion
-//#region src/resources/reports.ts
+// src/resources/reports.ts
 function reviveReportSummary(value) {
 	if (value.createdAt != null) value.createdAt = decoded("ReportSummary.createdAt", value.createdAt, (raw) => new Date(raw));
 	if (value.completedAt != null) value.completedAt = decoded("ReportSummary.completedAt", value.completedAt, (raw) => new Date(raw));
@@ -2412,8 +2400,7 @@ var Reports = class extends ElmoResource {
 		return pages(options?.client ?? this.client, listReportsDescriptor, mergeParams(groupParams(params, "query"), options));
 	}
 };
-//#endregion
-//#region src/resources/tools.ts
+// src/resources/tools.ts
 const analyzeBrandDescriptor = /* @__PURE__ */ callable({
 	address: "/tools/analyze",
 	auth: apiKeyRequirements,
@@ -2453,7 +2440,6 @@ var Tools = class extends ElmoResource {
 		return callPromise(options?.client ?? this.client, analyzeBrandDescriptor, mergeParams(groupParams(params, "body"), options));
 	}
 };
-//#endregion
-export { getBrandOpportunitiesFields as $, listModelsDescriptor as A, selectCodec as At, updateCompetitorDescriptor as B, emptyPathParameter as Bt, Organizations as C, isFieldValue as Ct, getOrganizationFields as D, toText as Dt, getOrganizationDescriptor as E, scalarText as Et, deleteCompetitorDescriptor as F, MissingCredentialError as Ft, getBrandFields as G, unansweredError as Gt, Brands as H, isStructured as Ht, deleteCompetitorFields as I, TimeoutError as It, updateBrandFields as J, TIMER_LIMIT as Jt, listBrandsDescriptor as K, unsendable as Kt, getCompetitorDescriptor as L, TransportError as Lt, getMeDescriptor as M, AbortError as Mt, Competitors as N, DecodeError as Nt, listOrganizationsDescriptor as O, essenceOf as Ot, createCompetitorDescriptor as P, ElmoError as Pt, getBrandOpportunitiesDescriptor as Q, sleep as Qt, getCompetitorFields as R, calledOffWith as Rt, listPromptRunsFields as S, createConfig as St, getOrganizationBillingFields as T, metadataValue as Tt, createBrandDescriptor as U, refusedInput as Ut, updateCompetitorFields as V, failureOf as Vt, getBrandDescriptor as W, safeAddress as Wt, listBrandTagsDescriptor as X, exceedsMaxRetryAfter as Xt, pages as Y, backoffDelay as Yt, listBrandTagsFields as Z, retryAfterDelay as Zt, getPromptSnapshotDescriptor as _, createClient as _t, getReportDescriptor as a, listBrandCitationDomainsFields as at, getRunFields as b, replyWith as bt, Prompts as c, listBrandPromptPerformanceDescriptor as ct, deletePromptFields as d, mergeParams as dt, getBrandAnalyticsDescriptor as et, getPromptDescriptor as f, placeParams as ft, updatePromptFields as g, clientFor as gt, updatePromptDescriptor as h, validateFeature as ht, createReportDescriptor as i, listBrandCitationDomainsDescriptor as it, Me as j, APIError as jt, Models as k, readText as kt, createPromptDescriptor as l, listBrandPromptPerformanceFields as lt, listPromptsDescriptor as m, ElmoResource as mt, analyzeBrandDescriptor as n, getBrandQueryFanoutDescriptor as nt, getReportFields as o, listBrandCitationURLsDescriptor as ot, getPromptFields as p, callPromise as pt, updateBrandDescriptor as q, unsendableAddress as qt, Reports as r, getBrandQueryFanoutFields as rt, listReportsDescriptor as s, listBrandCitationUrlsFields as st, Tools as t, getBrandAnalyticsFields as tt, deletePromptDescriptor as u, groupParams as ut, getPromptSnapshotFields as v, discardBody as vt, getOrganizationBillingDescriptor as w, metadataHeaders as wt, listPromptRunsDescriptor as x, baseURLOf as xt, getRunDescriptor as y, isStreamed as yt, listCompetitorsDescriptor as z, classifyError as zt };
+export { getBrandAnalyticsDescriptor as $, listModelsDescriptor as A, selectCodec as At, updateCompetitorDescriptor as B, emptyPathParameter as Bt, Organizations as C, isFieldValue as Ct, getOrganizationFields as D, toText as Dt, getOrganizationDescriptor as E, scalarText as Et, deleteCompetitorDescriptor as F, MissingCredentialError as Ft, getBrandFields as G, unansweredError as Gt, Brands as H, isStructured as Ht, deleteCompetitorFields as I, TimeoutError as It, updateBrandFields as J, TIMER_LIMIT as Jt, listBrandsDescriptor as K, unsendable as Kt, getCompetitorDescriptor as L, TransportError as Lt, getMeDescriptor as M, AbortError as Mt, Competitors as N, DecodeError as Nt, listOrganizationsDescriptor as O, essenceOf as Ot, createCompetitorDescriptor as P, ElmoError as Pt, getBrandOpportunitiesFields as Q, sleep as Qt, getCompetitorFields as R, calledOffWith as Rt, listPromptRunsFields as S, createConfig as St, getOrganizationBillingFields as T, metadataValue as Tt, createBrandDescriptor as U, refusedInput as Ut, updateCompetitorFields as V, failureOf as Vt, getBrandDescriptor as W, safeAddress as Wt, listBrandTagsFields as X, exceedsMaxRetryAfter as Xt, listBrandTagsDescriptor as Y, backoffDelay as Yt, getBrandOpportunitiesDescriptor as Z, retryAfterDelay as Zt, getPromptSnapshotDescriptor as _, createClient as _t, getReportDescriptor as a, listBrandCitationURLsDescriptor as at, getRunFields as b, replyWith as bt, Prompts as c, listBrandPromptPerformanceFields as ct, deletePromptFields as d, placeParams as dt, getBrandAnalyticsFields as et, getPromptDescriptor as f, pages as ft, updatePromptFields as g, clientFor as gt, updatePromptDescriptor as h, validateFeature as ht, createReportDescriptor as i, listBrandCitationDomainsFields as it, Me as j, APIError as jt, Models as k, readText as kt, createPromptDescriptor as l, groupParams as lt, listPromptsDescriptor as m, ElmoResource as mt, analyzeBrandDescriptor as n, getBrandQueryFanoutFields as nt, getReportFields as o, listBrandCitationUrlsFields as ot, getPromptFields as p, callPromise as pt, updateBrandDescriptor as q, unsendableAddress as qt, Reports as r, listBrandCitationDomainsDescriptor as rt, listReportsDescriptor as s, listBrandPromptPerformanceDescriptor as st, Tools as t, getBrandQueryFanoutDescriptor as tt, deletePromptDescriptor as u, mergeParams as ut, getPromptSnapshotFields as v, discardBody as vt, getOrganizationBillingDescriptor as w, metadataHeaders as wt, listPromptRunsDescriptor as x, baseURLOf as xt, getRunDescriptor as y, isStreamed as yt, listCompetitorsDescriptor as z, classifyError as zt };
 
-//# sourceMappingURL=tools-B1lVtYAr.mjs.map
+//# sourceMappingURL=tools-B2xqLDiH.mjs.map