better-supabase 0.7.1 → 0.8.0

package/dist/blocks/jobs/index.js

@@ -1,15 +1,16 @@
 import { t as DbException } from "../../db-exception-CnWcYPxL.js";
-import { n as dbError } from "../../errors-B11Duf73.js";
+import { n as dbError } from "../../errors-2M6CKMP4.js";
 import { s as nowInstant } from "../../temporal-BJGitm-h.js";
-import { t as temporal } from "../../temporal-required-BVvW7SYJ.js";
-import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-DzUbqgdW.js";
+import { t as temporal } from "../../temporal-required-BtynQtM-.js";
+import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-DEqHCMKP.js";
 import { n as allTenantsContext } from "../../plugin-tfXW1-qO.js";
-import { n as validate } from "../../standard-BK0cqJ7y.js";
-import { a as problemResponse } from "../../problem-BreOl8b8.js";
+import { n as validate } from "../../standard-DkzZUneg.js";
+import { o as problemResponse } from "../../problem-CJvFeGu7.js";
 import { o as tenantFrom, s as tenantPathsFor } from "../../claims-PqzCxaTD.js";
-import { n as nextCronRun, t as assertCron } from "../../cron-DVPUg5k3.js";
-import { A as workerId, C as run, E as sleep, c as errorText, d as isRecord, g as pageOf, i as blockCall, k as toInstant, n as applyTemporal, v as readBodyCapped, w as seconds } from "../../block-helpers-DWHxHsEQ.js";
-import { d as verifyWebhook, l as verifySharedSecret } from "../../verify-DL41hbvY.js";
+import { t as cronRoute } from "../../cron-route-D2AN9SA1.js";
+import { n as nextCronRun, t as assertCron } from "../../cron-D25Ukpxy.js";
+import { D as seconds, E as run, N as toInstant, a as budget, f as leaseHeartbeat, k as sleep, l as errorText, n as applyTemporal, y as pageOf } from "../../block-helpers-Cy3pB96I.js";
+import { i as createWebhookInbox, r as rateLimited, t as createRateLimit } from "../../rate-limit-Bw7HgmFj.js";
 import { n as withContext, t as unwrap } from "../../envelope-DqnYGRw7.js";
 //#region src/blocks/jobs/dev.ts
 function devDrainSecret(env, name = "CRON_SECRET") {
@@ -55,7 +56,7 @@ function devDrain(options) {
 	};
 }
 //#endregion
-//#region src/blocks/jobs/jobs.ts
+//#region src/blocks/jobs/idempotency.ts
 async function sha256(text) {
 	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));
 	return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
@@ -181,6 +182,8 @@ function createIdempotency(sql, options = {}) {
 		}
 	};
 }
+//#endregion
+//#region src/blocks/jobs/lease.ts
 /**
 * Runs `fn` while holding the lease on `key`, one holder at a time, and
 * releases it afterwards, also when `fn` throws. `{ acquired: false }` while
@@ -224,194 +227,6 @@ function withLease(sql, key, fn, options = {}) {
 		}
 	});
 }
-function defaultType(payload) {
-	if (typeof payload !== "object" || payload === null) return null;
-	const type = payload.type;
-	return typeof type === "string" ? type : null;
-}
-/** Store-then-process webhooks: acknowledge fast, process with retries, never twice. */
-function createWebhookInbox(sql, options) {
-	applyTemporal(options);
-	const worker = options.worker ?? workerId();
-	const format = options.problem;
-	const maxAttempts = options.maxAttempts ?? 8;
-	if (!Number.isInteger(maxAttempts) || maxAttempts < 1) throw new TypeError(`createWebhookInbox maxAttempts must be a positive integer, not ${String(maxAttempts)}`);
-	const maxBodyBytes = options.maxBodyBytes ?? 1048576;
-	if (!Number.isInteger(maxBodyBytes) || maxBodyBytes < 1) throw new TypeError(`createWebhookInbox maxBodyBytes must be a positive integer, not ${String(maxBodyBytes)}`);
-	const verified = async (request, body) => {
-		if (options.verify) return options.verify(request, body);
-		const result = await verifyWebhook({
-			headers: request.headers,
-			body
-		}, options.secrets ?? []);
-		return result.ok ? ok({
-			id: result.data.id,
-			payload: result.data.payload
-		}) : result;
-	};
-	const save = (event) => run(async () => {
-		const [row] = await sql.queryRaw("select * from better_supabase.receive_webhook($1, $2, $3, $4, $5, $6, $7)", [
-			options.source,
-			event.id,
-			event.type === void 0 ? (options.typeOf ?? defaultType)(event.payload) : event.type,
-			JSON.stringify(event.payload),
-			JSON.stringify(event.headers ?? {}),
-			(event.tenant === void 0 ? options.tenantOf?.(event.payload) : event.tenant) ?? null,
-			maxAttempts
-		]);
-		return {
-			id: Number(row.id),
-			duplicate: row.duplicate
-		};
-	});
-	return {
-		store: save,
-		list: (listOptions) => run(async () => {
-			return (await sql.queryRaw("select * from better_supabase.list_webhooks($1, $2, $3, $4)", [
-				listOptions.tenant,
-				options.source,
-				listOptions.status ?? null,
-				listOptions.limit ?? 100
-			])).map((row) => ({
-				id: Number(row.id),
-				messageId: row.message_id,
-				type: row.event_type,
-				status: row.status ?? "pending",
-				attempts: row.attempts,
-				maxAttempts: row.max_attempts ?? maxAttempts,
-				lastError: row.last_error ?? null,
-				tenant: row.tenant ?? null,
-				receivedAt: toInstant(row.received_at),
-				processedAt: row.processed_at === null || row.processed_at === void 0 ? null : toInstant(row.processed_at)
-			}));
-		}),
-		purge: (purgeOptions = {}) => run(async () => {
-			const [row] = await sql.queryRaw("select better_supabase.purge_webhooks($1::interval, $2, $3, $4) as purged", [
-				seconds(purgeOptions.olderThan ?? "30 days"),
-				purgeOptions.includeDead ?? false,
-				purgeOptions.batch ?? 1e4,
-				purgeOptions.tenant ?? null
-			]);
-			return row?.purged ?? 0;
-		}),
-		async receive(request) {
-			const instance = new URL(request.url).pathname;
-			if (request.method !== "POST") return new Response(null, {
-				status: 405,
-				headers: { allow: "POST" }
-			});
-			if (!options.verify && !options.secrets) throw new TypeError(`The inbox for "${options.source}" has no \`secrets\` or \`verify\`, so it only stores events through \`store\``);
-			const body = await readBodyCapped(request.clone(), maxBodyBytes);
-			if (body === void 0) return problemResponse({
-				...dbError("invalid_input", "The body is too large", { code: "WEBHOOK_TOO_LARGE" }),
-				status: 413
-			}, {
-				instance,
-				format
-			});
-			const message = await verified(request, body);
-			if (!message.ok) return problemResponse(message.error, {
-				instance,
-				format
-			});
-			const headers = Object.fromEntries((options.keepHeaders ?? []).flatMap((name) => {
-				const value = request.headers.get(name);
-				return value === null ? [] : [[name.toLowerCase(), value]];
-			}));
-			const stored = await save({
-				id: message.data.id,
-				payload: message.data.payload,
-				headers,
-				...message.data.tenant === void 0 ? {} : { tenant: message.data.tenant }
-			});
-			if (!stored.ok) return problemResponse(stored.error, {
-				instance,
-				format
-			});
-			return Response.json(stored.data, { status: stored.data.duplicate ? 200 : 202 });
-		},
-		async process(handler, processOptions = {}) {
-			let succeeded = 0;
-			let failed = 0;
-			const lease = seconds(processOptions.lease ?? 300);
-			const deadline = processOptions.budgetMs === void 0 ? void 0 : Date.now() + processOptions.budgetMs;
-			for (;;) {
-				if (deadline !== void 0 && Date.now() >= deadline) return {
-					succeeded,
-					failed
-				};
-				const rows = await sql.queryRaw("select * from better_supabase.claim_webhooks($1, $2, $3, $4::interval)", [
-					options.source,
-					worker,
-					processOptions.batch ?? 10,
-					lease
-				]);
-				if (rows.length === 0) return {
-					succeeded,
-					failed
-				};
-				for (const row of rows) {
-					const id = Number(row.id);
-					const attempt = row.attempts;
-					const extend = async () => {
-						const [held] = await sql.queryRaw("select better_supabase.extend_webhook($1, $2, $3, $4::interval) as lease", [
-							id,
-							worker,
-							attempt,
-							lease
-						]);
-						return held?.lease ?? void 0;
-					};
-					const leaseSeconds = await extend();
-					if (leaseSeconds === void 0) continue;
-					const message = {
-						id,
-						source: row.source,
-						messageId: row.message_id,
-						type: row.event_type,
-						payload: row.payload,
-						headers: row.headers,
-						attempts: row.attempts,
-						maxAttempts: row.max_attempts ?? maxAttempts,
-						receivedAt: toInstant(row.received_at),
-						tenant: row.tenant ?? null,
-						progress: row.checkpoint ?? {},
-						async checkpoint(fields) {
-							const [saved] = await sql.queryRaw("select better_supabase.checkpoint_webhook($1, $2, $3, $4) as saved", [
-								id,
-								worker,
-								JSON.stringify(fields),
-								attempt
-							]);
-							return saved?.saved ?? false;
-						}
-					};
-					const heartbeat = setInterval(() => void extend().catch(() => void 0), Math.max(1e3, leaseSeconds * 500));
-					try {
-						const outcome = await handler(message);
-						if (typeof outcome === "object" && outcome !== null && "ok" in outcome && outcome.ok === false) throw new Error(errorText(outcome.error ?? "The handler failed"));
-						const [done] = await sql.queryRaw("select better_supabase.complete_webhook($1, $2, $3) as done", [
-							message.id,
-							worker,
-							attempt
-						]);
-						if (done?.done !== false) succeeded += 1;
-					} catch (cause) {
-						await sql.queryRaw("select better_supabase.fail_webhook($1, $2, $3, null, $4)", [
-							message.id,
-							worker,
-							errorText(cause),
-							attempt
-						]);
-						failed += 1;
-					} finally {
-						clearInterval(heartbeat);
-					}
-				}
-			}
-		}
-	};
-}
 //#endregion
 //#region src/blocks/jobs/backends.ts
 const instantOrNull = (value) => value === null ? null : toInstant(value);
@@ -421,9 +236,9 @@ const millis = (instant) => instant.round({
 	roundingMode: "floor"
 });
 /** The first run of a schedule written without one, or undefined for a cron the drain can't read. */
-function firstRun(row) {
+function firstRun(row, now) {
 	try {
-		return millis(nextCronRun(row.schedule, row.timezone, row.first_after ? toInstant(row.first_after) : nowInstant()));
+		return millis(nextCronRun(row.schedule, row.timezone, row.first_after ? toInstant(row.first_after) : now()));
 	} catch {
 		return;
 	}
@@ -431,9 +246,9 @@ function firstRun(row) {
 /**
 * The `jobs` SQL module over a service SQL connection. The same
 * functions back both `sql.modules.jobs.options.backend` values (pgmq and table)
-* and both schedulers.
+* and both schedulers. `now` dates a schedule's first run.
 */
-function sqlQueueBackend(sql) {
+function sqlQueueBackend(sql, now = nowInstant) {
 	return {
 		apiVersion: 1,
 		name: "sql",
@@ -558,9 +373,9 @@ function sqlQueueBackend(sql) {
 					});
 					continue;
 				}
-				const first = firstRun(row);
+				const first = firstRun(row, now);
 				if (first === void 0) continue;
-				if (temporal().Instant.compare(first, nowInstant()) <= 0) due.push({
+				if (temporal().Instant.compare(first, now()) <= 0) due.push({
 					...schedule,
 					nextRun: first
 				});
@@ -680,9 +495,9 @@ function isBackend(source) {
 function isSqlClient(source) {
 	return typeof source.queryRaw === "function";
 }
-function backendOf(source) {
+function backendOf(source, now) {
 	if (isBackend(source)) return source;
-	return isSqlClient(source) ? sqlQueueBackend(source) : pgmqPublicBackend(source);
+	return isSqlClient(source) ? sqlQueueBackend(source, now) : pgmqPublicBackend(source);
 }
 const later = (a, b) => temporal().Instant.compare(a, b) >= 0 ? a : b;
 /**
@@ -696,8 +511,9 @@ const later = (a, b) => temporal().Instant.compare(a, b) >= 0 ? a : b;
 */
 function createJobs(source, queues, options = {}) {
 	applyTemporal(options);
+	const now = options.now ?? nowInstant;
 	for (const name of Object.keys(queues)) if (!QUEUE_NAME.test(name)) throw new TypeError(`Queue "${name}": pgmq queue names are lowercase letters, digits and underscores (at most 47)`);
-	const transport = backendOf(source);
+	const transport = backendOf(source, now);
 	const schemaOf = (queue) => {
 		const schema = queues[queue];
 		if (!schema) throw new TypeError(`Unknown queue "${queue}". Queues: ${Object.keys(queues).join(", ")}`);
@@ -713,9 +529,9 @@ function createJobs(source, queues, options = {}) {
 	* Extends the lease of every job in `held` at half the lease, so jobs
 	* waiting their turn in a claimed batch don't expire before they run.
 	*/
-	const heartbeat = (held, lease) => transport.leases ? setInterval(() => {
+	const heartbeat = (held, lease) => transport.leases ? leaseHeartbeat(lease, () => {
 		for (const job of held) run(() => transport.extend(job, lease));
-	}, Math.max(1e3, lease * 1e3 / 2)) : void 0;
+	}) : void 0;
 	const handle = async (job, handler, workOptions) => {
 		const controller = new AbortController();
 		try {
@@ -741,7 +557,7 @@ function createJobs(source, queues, options = {}) {
 			return false;
 		}
 	};
-	const loop = async (queue, handler, workOptions, forever, deadline) => {
+	const loop = async (queue, handler, workOptions, forever, spent = budget(void 0)) => {
 		const concurrency = Math.max(1, workOptions.concurrency ?? 1);
 		const lease = workOptions.lease ?? 300;
 		const firstWait = workOptions.pollInterval ?? 1e3;
@@ -754,7 +570,7 @@ function createJobs(source, queues, options = {}) {
 			let wait = firstWait;
 			let misses = 0;
 			while (!signal.aborted) {
-				if (deadline !== void 0 && Date.now() >= deadline) return;
+				if (spent.expired()) return;
 				const claimed = await claim(queue, {
 					...workOptions,
 					batch: workOptions.batch ?? 1
@@ -765,8 +581,7 @@ function createJobs(source, queues, options = {}) {
 						stop.abort();
 						throw new TypeError(claimed.error.message, { cause: claimed.error });
 					}
-					const left = deadline === void 0 ? Infinity : deadline - Date.now();
-					await sleep(Math.min(firstWait * 2 ** (misses - 1), left), signal);
+					await sleep(Math.min(firstWait * 2 ** (misses - 1), spent.remaining()), signal);
 					continue;
 				}
 				misses = 0;
@@ -778,7 +593,7 @@ function createJobs(source, queues, options = {}) {
 				}
 				wait = firstWait;
 				const held = new Set(claimed.data);
-				const timer = heartbeat(held, lease);
+				const stopHeartbeat = heartbeat(held, lease);
 				try {
 					for (const job of claimed.data) {
 						if (await handle(job, handler, workOptions)) succeeded += 1;
@@ -786,7 +601,7 @@ function createJobs(source, queues, options = {}) {
 						held.delete(job);
 					}
 				} finally {
-					clearInterval(timer);
+					stopHeartbeat?.();
 				}
 			}
 		});
@@ -803,7 +618,7 @@ function createJobs(source, queues, options = {}) {
 		let ran = 0;
 		for (const schedule of due) {
 			await transport.send(schedule.queue, schedule.payload, 0, 5, `schedule:${schedule.name}:${schedule.nextRun.toString()}`);
-			const next = millis(nextCronRun(schedule.cron, schedule.timeZone, later(nowInstant(), schedule.nextRun)));
+			const next = millis(nextCronRun(schedule.cron, schedule.timeZone, later(now(), schedule.nextRun)));
 			if (await transport.advanceSchedule(schedule.name, schedule.nextRun, next)) ran += 1;
 		}
 		return ran;
@@ -813,7 +628,7 @@ function createJobs(source, queues, options = {}) {
 		if (!valid.ok) return valid;
 		const timeZone = scheduleOptions.timeZone ?? "UTC";
 		try {
-			nextCronRun(cron, timeZone, nowInstant());
+			nextCronRun(cron, timeZone, now());
 		} catch (cause) {
 			return err(dbError("validation", errorText(cause), { issues: [{
 				message: errorText(cause),
@@ -829,13 +644,13 @@ function createJobs(source, queues, options = {}) {
 			tenant: scheduleOptions.tenant ?? (scheduleOptions.context ? tenantFrom(scheduleOptions.context, tenantPathsFor(void 0)) : void 0) ?? tenantDefault
 		});
 	};
-	const write = (prepared) => transport.schedule(prepared.name, prepared.cron, prepared.queue, prepared.payload, prepared.timeZone, millis(nextCronRun(prepared.cron, prepared.timeZone, nowInstant())), prepared.tenant);
+	const write = (prepared) => transport.schedule(prepared.name, prepared.cron, prepared.queue, prepared.payload, prepared.timeZone, millis(nextCronRun(prepared.cron, prepared.timeZone, now())), prepared.tenant);
 	return {
 		enqueue(queue, payload, enqueueOptions = {}) {
 			return AsyncResult.from(async () => {
 				const valid = await validate(schemaOf(queue), payload, "payload");
 				if (!valid.ok) return valid;
-				const delay = enqueueOptions.delay ?? (enqueueOptions.runAt ? Math.max(0, Math.ceil((enqueueOptions.runAt.epochMilliseconds - nowInstant().epochMilliseconds) / 1e3)) : 0);
+				const delay = enqueueOptions.delay ?? (enqueueOptions.runAt ? Math.max(0, Math.ceil((enqueueOptions.runAt.epochMilliseconds - now().epochMilliseconds) / 1e3)) : 0);
 				return run(() => transport.send(queue, withContext(valid.data, enqueueOptions.context), delay, enqueueOptions.maxAttempts ?? 5, enqueueOptions.dedupeKey, enqueueOptions.dedupe));
 			});
 		},
@@ -929,23 +744,16 @@ function createJobs(source, queues, options = {}) {
 			return transport.unscheduleTenant(filter.tenant);
 		}),
 		runSchedules: (scheduleOptions = {}) => run(() => runSchedules(scheduleOptions)),
-		drain: (queue, handler, drainOptions = {}) => loop(queue, handler, drainOptions, false, drainOptions.budgetMs === void 0 ? void 0 : Date.now() + drainOptions.budgetMs),
+		drain: (queue, handler, drainOptions = {}) => loop(queue, handler, drainOptions, false, budget(drainOptions.budgetMs)),
 		work: (queue, handler, workOptions = {}) => loop(queue, handler, workOptions, true),
 		drainRoute(routeOptions) {
-			const secret = routeOptions.secret;
-			if (!secret) throw new TypeError("drainRoute needs a secret, such as process.env.CRON_SECRET");
 			for (const queue of Object.keys(routeOptions.handlers)) schemaOf(queue);
-			return async (request) => {
-				const instance = new URL(request.url).pathname;
-				if (request.method !== "GET" && request.method !== "POST") return new Response(null, {
-					status: 405,
-					headers: { allow: "GET, POST" }
-				});
-				if (!verifySharedSecret(request, secret)) return problemResponse(dbError("unauthorized", "The drain route needs its bearer secret"), {
-					instance,
-					format: routeOptions.problem
-				});
-				const deadline = Date.now() + (routeOptions.budgetMs ?? 5e4);
+			return cronRoute({
+				name: "drain",
+				secret: routeOptions.secret,
+				problem: routeOptions.problem
+			}, async (request) => {
+				const spent = budget(routeOptions.budgetMs ?? 5e4);
 				const monitor = routeOptions.monitor;
 				let errors = 0;
 				const report = (cause) => {
@@ -973,9 +781,9 @@ function createJobs(source, queues, options = {}) {
 				const results = {};
 				for (const [queue, handler] of Object.entries(routeOptions.handlers)) {
 					if (handler === void 0) continue;
-					if (Date.now() >= deadline) break;
+					if (spent.expired()) break;
 					try {
-						results[queue] = await loop(queue, handler, routeOptions, false, deadline);
+						results[queue] = await loop(queue, handler, routeOptions, false, spent);
 					} catch (cause) {
 						report(cause);
 						results[queue] = {
@@ -987,65 +795,14 @@ function createJobs(source, queues, options = {}) {
 				const result = {
 					schedules: scheduled,
 					queues: results,
-					budgetExhausted: Date.now() >= deadline,
+					budgetExhausted: spent.expired(),
 					errors
 				};
 				if (monitor?.onFinish) await watch(() => monitor.onFinish?.(result, started));
 				return Response.json(result);
-			};
+			});
 		}
 	};
 }
 //#endregion
-//#region src/blocks/jobs/rate-limit.ts
-const isTransport = (source) => "call" in source;
-/**
-* Fixed-window limits for keys that aren't claims, over the `rate-limit`
-* module's counters. Pass a service SQL connection (`ctx.postgresAdmin`,
-* `postgres.admin`), or a service-role `BlockTransport` such as
-* `rpcTransport(adminClient)`.
-*/
-function createRateLimit(source, options = {}) {
-	applyTemporal(options);
-	const hit = isTransport(source) ? overTransport(blockCall(source, void 0, options.mappers)) : overSql(source);
-	return { check: (scope, key, rule) => {
-		if (rule !== void 0 && (!Number.isInteger(rule.max) || rule.max < 1)) return AsyncResult.err(dbError("invalid_input", "A rate limit's max must be a positive integer"));
-		return hit(scope, key, rule?.max ?? null, rule === void 0 ? null : seconds(rule.period));
-	} };
-}
-const overTransport = (call) => (scope, key, max, period) => call("check_rate_limit", {
-	scope,
-	key,
-	max_requests: max ?? void 0,
-	period: period ?? void 0
-}, (value) => {
-	const row = isRecord(value) ? value : {};
-	return {
-		allowed: row["allowed"] === true,
-		remaining: Number(row["remaining"] ?? 0),
-		retryAfter: Number(row["retry_after"] ?? 0)
-	};
-});
-const overSql = (sql) => (scope, key, max, period) => run(async () => {
-	const [row] = await sql.queryRaw("select * from better_supabase.hit_rate_limit($1, $2, $3, $4::interval)", [
-		scope,
-		key,
-		max,
-		period
-	]);
-	return {
-		allowed: row?.allowed ?? false,
-		remaining: row?.remaining ?? 0,
-		retryAfter: row?.retry_after ?? 0
-	};
-});
-/** A `problem+json` 429 with `Retry-After`, for a refused `check`. */
-function rateLimited(decision, options = {}) {
-	const retryAfter = Math.max(1, Math.ceil(decision.retryAfter));
-	return problemResponse(dbError("rate_limited", options.detail ?? `Too many requests. Retry after ${retryAfter} seconds.`, { retryAfter }), {
-		...options.instance === void 0 ? {} : { instance: options.instance },
-		format: options.problem
-	});
-}
-//#endregion
 export { assertCron, createIdempotency, createJobs, createRateLimit, createWebhookInbox, devDrain, devDrainSecret, nextCronRun, pgmqPublicBackend, rateLimited, sqlQueueBackend, withLease };

package/dist/blocks/knowledge/index.d.ts

@@ -1,3 +1,3 @@
-import { i as sqlTransport, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
-import { a as KnowledgeDocument, c as KnowledgeQuery, d as KnowledgeStatus, f as NewKnowledgeDocument, i as KnowledgeChunk, l as KnowledgeScope, m as createKnowledge, n as Embedder, o as KnowledgeHit, p as chunk, r as Knowledge, s as KnowledgeOptions, t as ChunkOptions, u as KnowledgeSearchOptions } from "../../knowledge-BXBbT0Tr.js";
-export { type BlockTransport, type ChunkOptions, type Embedder, type Knowledge, type KnowledgeChunk, type KnowledgeDocument, type KnowledgeHit, type KnowledgeOptions, type KnowledgeQuery, type KnowledgeScope, type KnowledgeSearchOptions, type KnowledgeStatus, type NewKnowledgeDocument, chunk, createKnowledge, rpcTransport, sqlTransport };
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
+import { a as KnowledgeDocument, c as KnowledgeQuery, d as KnowledgeStatus, f as NewKnowledgeDocument, i as KnowledgeChunk, l as KnowledgeScope, m as createKnowledge, n as Embedder, o as KnowledgeHit, p as chunk, r as Knowledge, s as KnowledgeOptions, t as ChunkOptions, u as KnowledgeSearchOptions } from "../../knowledge-CAReFpRA.js";
+export { type BlockTransport, type ChunkOptions, type Embedder, type Knowledge, type KnowledgeChunk, type KnowledgeDocument, type KnowledgeHit, type KnowledgeOptions, type KnowledgeQuery, type KnowledgeScope, type KnowledgeSearchOptions, type KnowledgeStatus, type NewKnowledgeDocument, chunk, createKnowledge, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/knowledge/index.js

@@ -1,3 +1,3 @@
-import { n as rpcTransport, r as sqlTransport } from "../../block-transport-BLr-ZgLc.js";
-import { n as chunk, r as createKnowledge } from "../../knowledge-CDmiMLew.js";
-export { chunk, createKnowledge, rpcTransport, sqlTransport };
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
+import { n as chunk, r as createKnowledge } from "../../knowledge-DnHtb64A.js";
+export { chunk, createKnowledge, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/memory/index.d.ts

@@ -1,8 +1,8 @@
-import { i as sqlTransport, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
-import { n as Embedder } from "../../knowledge-BXBbT0Tr.js";
-import { a as MemoryKind, c as MemoryRecord, d as RecalledMessage, i as MemoryHit, l as MemoryScope, n as MemoryCommand, o as MemoryNamespace, r as MemoryDocument, s as MemoryOptions, t as Memory, u as MemoryView } from "../../types-DGs5L0VN.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
+import { n as Embedder } from "../../knowledge-CAReFpRA.js";
+import { a as MemoryKind, c as MemoryRecord, d as RecalledMessage, i as MemoryHit, l as MemoryScope, n as MemoryCommand, o as MemoryNamespace, r as MemoryDocument, s as MemoryOptions, t as Memory, u as MemoryView } from "../../types-DSJ3-m9X.js";
 //#region src/blocks/memory/memory.d.ts
 /** Core memory files, archival facts and recall over earlier chats. */
 export declare function createMemory(options: MemoryOptions): Memory;
 //#endregion
-export { type BlockTransport, type Embedder, type Memory, type MemoryCommand, type MemoryDocument, type MemoryHit, type MemoryKind, type MemoryNamespace, type MemoryOptions, type MemoryRecord, type MemoryScope, type MemoryView, type RecalledMessage, rpcTransport, sqlTransport };
+export { type BlockTransport, type Embedder, type Memory, type MemoryCommand, type MemoryDocument, type MemoryHit, type MemoryKind, type MemoryNamespace, type MemoryOptions, type MemoryRecord, type MemoryScope, type MemoryView, type RecalledMessage, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/memory/index.js

@@ -1,9 +1,10 @@
-import { n as dbError } from "../../errors-B11Duf73.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-DzUbqgdW.js";
+import { n as dbError } from "../../errors-2M6CKMP4.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-DEqHCMKP.js";
 import { t as vectorLiteral } from "../../search-CUWCRYKL.js";
-import { n as rpcTransport, r as sqlTransport } from "../../block-transport-BLr-ZgLc.js";
-import { C as run, O as textOf, d as isRecord, h as optionalText, i as blockCall, k as toInstant, l as injectableOf, n as applyTemporal, p as oneOf, x as recordsOf, y as recordOf } from "../../block-helpers-DWHxHsEQ.js";
-import { t as checkVectors } from "../../knowledge-CDmiMLew.js";
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
+import { E as run, N as toInstant, S as recordOf, g as oneOf, i as blockCall, j as textOf, n as applyTemporal, u as injectableOf, v as optionalText, w as recordsOf } from "../../block-helpers-Cy3pB96I.js";
+import { t as checkVectors } from "../../knowledge-DnHtb64A.js";
 //#region src/blocks/memory/rows.ts
 const SCOPES = [
 	"user",
@@ -286,4 +287,4 @@ function createMemory(options) {
 	};
 }
 //#endregion
-export { createMemory, rpcTransport, sqlTransport };
+export { createMemory, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/notifications/index.d.ts

@@ -1,14 +1,14 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult, w as ErrorMapper } from "../../result-D7y2fT87.js";
-import { i as sqlTransport, n as RpcClient, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
-import { m as RequestContext } from "../../plugin-FGY8UhYm.js";
-import { a as EventHub } from "../../events-DWDhx77e.js";
-import { i as CursorPageOptions, r as BlockTemporalOptions } from "../../block-helpers-CKtbFcRv.js";
-import { r as EventSink, t as CloudEvent } from "../../cloud-event-C1JCc1bH.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-plbZ0AbJ.js";
+import { t as AsyncResult, w as ErrorMapper } from "../../result-BchM1XZn.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
+import { m as RequestContext } from "../../plugin-CPK2HsbY.js";
+import { a as EventHub } from "../../events-D1BOCll8.js";
+import { i as CursorPageOptions, r as BlockTemporalOptions } from "../../block-helpers-C0Xj8War.js";
+import { i as EventSink, t as CloudEvent } from "../../cloud-event-Dune0KI7.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DaOVC7SC.js";
 import { a as NotificationSubject, i as NotificationItem, n as NotificationMessage, o as RenderedText, r as NotificationSendResult, t as NotificationChannel } from "../../channel-_2Mx1Oyu.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
-//#region src/blocks/notifications/notifications.d.ts
+//#region src/blocks/notifications/api-types.d.ts
 /** Notification type to the Standard Schema of its `data`. */
 type NotificationTypes = Readonly<Record<string, StandardSchemaV1>>;
 type TypeName<K extends NotificationTypes> = keyof K & string;
@@ -292,6 +292,8 @@ interface NotificationSinkOptions<K extends NotificationTypes> {
   /** Stripped from each event type before `map`. Defaults to `dev.better-supabase.`. */
   readonly typePrefix?: string;
 }
+//#endregion
+//#region src/blocks/notifications/notifications.d.ts
 export declare function createNotifications<const K extends NotificationTypes, H = undefined>(options: NotificationsOptions<K, H>): Notifications<K>;
 //#endregion
-export { type AvatarUrls, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type DeliverOptions, type DeliverResult, type ListOptions, type NotificationActor, type NotificationChannel, type NotificationCounts, type NotificationItem, type NotificationMessage, type NotificationOf, type NotificationPage, type NotificationPreference, type NotificationSendResult, type NotificationSinkOptions, type NotificationSubject, type NotificationSubscription, type NotificationTypes, type NotificationUpdate, type Notifications, type NotificationsOptions, type PageOptions, type Rendered, type RenderedText, type RpcClient, type SendInput, type SentNotification, type SinkNotification, type SubscriptionLevel, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { type AvatarUrls, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type DeliverOptions, type DeliverResult, type ListOptions, type NotificationActor, type NotificationChannel, type NotificationCounts, type NotificationItem, type NotificationMessage, type NotificationOf, type NotificationPage, type NotificationPreference, type NotificationSendResult, type NotificationSinkOptions, type NotificationSubject, type NotificationSubscription, type NotificationTypes, type NotificationUpdate, type Notifications, type NotificationsOptions, type PageOptions, type Rendered, type RenderedText, type RpcClient, type SendInput, type SentNotification, type SinkNotification, type SubscriptionLevel, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };