better-supabase 0.13.0 → 0.14.0

package/dist/define-block-Dze77QTw.js

@@ -0,0 +1,56 @@
+//#region src/blocks/define-block.ts
+/** Where a block sits in the catalog and in presets, in catalog order. */
+const BLOCK_CATEGORIES = [
+	"identity",
+	"tenancy",
+	"collaboration",
+	"messaging",
+	"growth",
+	"crm",
+	"work",
+	"people",
+	"commerce",
+	"scheduling",
+	"content",
+	"ai",
+	"automation",
+	"developer",
+	"admin",
+	"database"
+];
+/** Describes a block with one manifest (ADR 0029). */
+function defineBlock(definition) {
+	const { create, consumes, provides, sections, ...rest } = definition;
+	return blockOf({
+		...rest,
+		consumes: consumes ?? {},
+		provides: provides ?? {},
+		sections: sections ?? {}
+	}, create, {});
+}
+function blockOf(parts, create, settings) {
+	return {
+		apiVersion: 1,
+		name: parts.name,
+		sql: parts.sql ?? [],
+		options: parts.options ?? {},
+		events: parts.events ?? { types: [] },
+		consumes: parts.consumes,
+		provides: parts.provides,
+		create,
+		client: parts.client,
+		category: parts.category,
+		recipes: parts.recipes ?? [],
+		schemas: parts.schemas ?? {},
+		invalidates: parts.invalidates ?? {},
+		sections: parts.sections,
+		settings,
+		with: (more) => blockOf(parts, create, {
+			...settings,
+			...more
+		}),
+		using: (next) => blockOf(parts, next, settings)
+	};
+}
+//#endregion
+export { defineBlock as n, BLOCK_CATEGORIES as t };

package/dist/delegation-CeXm9AJ3.js

@@ -0,0 +1,146 @@
+import { n as isRecord } from "./guards-6F2bCtQR.js";
+import { n as actorOf } from "./actor-hNajGNEK.js";
+import { n as impersonatorClaim, t as actClaim } from "./impersonation-CZD9AOAk.js";
+//#region src/auth/delegation.ts
+/**
+* The claim `forContext({ permissions })` sets: the permission keys the work
+* may use. `better_supabase.cap_allows` refuses every other key, and a job
+* queued under a cap keeps it.
+*/
+const PERMISSION_CAP_CLAIM = "bs_permission_cap";
+/**
+* The claims a delegated token adds; `contextClaims` never takes them from
+* `claimsFor`.
+*/
+const DELEGATION_CLAIMS = [
+	"act",
+	"client_id",
+	"scope",
+	"authorization_details",
+	PERMISSION_CAP_CLAIM
+];
+/**
+* `*` grants every key and `prefix.*` every key under prefix, as
+* `permission_matches` in SQL.
+*/
+function permissionMatches(granted, wanted) {
+	return granted === "*" || granted === wanted || granted.endsWith(".*") && wanted.startsWith(granted.slice(0, -1));
+}
+/**
+* The permission cap in `claims`: `undefined` without one, `false` for a cap
+* that is not a list of strings.
+*/
+function permissionCapOf(claims) {
+	const cap = claims[PERMISSION_CAP_CLAIM];
+	if (cap === void 0) return;
+	return Array.isArray(cap) && cap.every((key) => typeof key === "string") ? cap : false;
+}
+/**
+* The keys of `wanted` that `inherited` allows, so a cap only ever narrows.
+* Either side alone is the cap; neither is no cap.
+*/
+function narrowCap(inherited, wanted) {
+	if (wanted === void 0) return inherited;
+	if (inherited === void 0) return wanted;
+	return wanted.filter((key) => inherited.some((granted) => permissionMatches(granted, key)));
+}
+const INVALID = {
+	ok: false,
+	reason: "invalid-delegation"
+};
+function isDetail(value) {
+	return isRecord(value) && typeof value["type"] === "string" && value["type"] !== "";
+}
+function scopeOf(value) {
+	if (value === void 0) return;
+	const scopes = typeof value === "string" ? value.split(/\s+/u) : Array.isArray(value) && value.every((item) => typeof item === "string") ? value : void 0;
+	if (scopes === void 0) return false;
+	const joined = scopes.filter(Boolean).join(" ");
+	return joined === "" ? void 0 : joined;
+}
+/**
+* The delegation in `claims`, for a token an OAuth client or agent acts with: a
+* `client_id`, or an `act` chain that is not a support or impersonation level.
+* `{ ok: true }` without `delegation` for any other session. An invalid `act`
+* chain, a `client_id` that is not a non-empty string, a `scope` that is
+* neither a string nor a list of strings, and `authorization_details` that are
+* not objects with a `type` are `{ ok: false }`: the work must not run as the
+* user alone.
+*/
+function delegatedClaims(claims) {
+	const outcome = actorOf(claims);
+	if (!outcome.ok) return {
+		ok: false,
+		reason: "invalid-chain"
+	};
+	const client = claims["client_id"];
+	if (client !== void 0 && (typeof client !== "string" || client === "")) return INVALID;
+	const actor = outcome.actor;
+	const chain = actor?.kind === "oauth-client" || actor?.kind === "agent" ? actor.chain : void 0;
+	if (client === void 0 && chain === void 0) return { ok: true };
+	const scope = scopeOf(claims["scope"]);
+	if (scope === false) return INVALID;
+	const details = claims["authorization_details"];
+	if (details !== void 0 && !(Array.isArray(details) && details.every(isDetail))) return INVALID;
+	return {
+		ok: true,
+		delegation: {
+			...client === void 0 ? {} : { client_id: client },
+			...scope === void 0 ? {} : { scope },
+			...details === void 0 ? {} : { authorization_details: details },
+			...chain === void 0 ? {} : { act: chain }
+		}
+	};
+}
+/**
+* The SQL claims for the user in a recorded context: the user as
+* `authenticated`, the tenant as `tenant_id`, and the context's delegation, so
+* the access functions (through `cap_allows`), `token_scope_allows` and the
+* TypeScript scope checks narrow the work to what the queuing token held, and
+* to its permission cap. The `act` claim is the support session, else the OAuth
+* client chain, else the impersonating admin.
+*/
+function contextClaims(context, options = {}) {
+	const { actor, tenant } = context;
+	if (actor?.kind !== "user") return {
+		ok: false,
+		message: `forContext needs a user actor, got ${actor ? actor.kind : "none"}: use admin() for service work`
+	};
+	const claims = context.claims ?? {};
+	const recorded = actorOf(claims);
+	const delegated = delegatedClaims(claims);
+	const inherited = permissionCapOf(claims);
+	if (inherited === false) return {
+		ok: false,
+		message: "forContext got an invalid permission cap"
+	};
+	const cap = narrowCap(inherited, options.permissions);
+	if (!recorded.ok || !delegated.ok) return {
+		ok: false,
+		message: !recorded.ok || !delegated.ok && delegated.reason === "invalid-chain" ? "forContext got an invalid act claim" : "forContext got invalid delegation claims"
+	};
+	const support = recorded.actor?.kind === "support" ? recorded.actor : void 0;
+	const delegation = delegated.delegation ?? {};
+	const act = support ? impersonatorClaim(support) : delegation.act ?? (actor.impersonator ? actClaim({
+		actor: actor.impersonator,
+		reason: options.reason ?? "job"
+	}) : void 0);
+	const extra = Object.fromEntries(Object.entries(options.extra ?? {}).filter(([key]) => !DELEGATION_CLAIMS.includes(key)));
+	const impersonator = support?.id ?? actor.impersonator;
+	return {
+		ok: true,
+		claims: {
+			...extra,
+			role: "authenticated",
+			sub: actor.id,
+			...tenant === void 0 ? {} : { tenant_id: tenant },
+			...delegation,
+			...act === void 0 ? {} : { act },
+			...cap === void 0 ? {} : { [PERMISSION_CAP_CLAIM]: cap }
+		},
+		...impersonator === void 0 ? {} : { impersonator },
+		...support?.readOnly ? { readOnly: true } : {}
+	};
+}
+//#endregion
+export { narrowCap as a, delegatedClaims as i, PERMISSION_CAP_CLAIM as n, permissionCapOf as o, contextClaims as r, DELEGATION_CLAIMS as t };

package/dist/documents-kgDOHUfn.d.ts

@@ -0,0 +1,152 @@
+/// <reference lib="esnext.temporal" />
+import { T as ErrorMapper, t as AsyncResult } from "./result-C6jDfedy.js";
+import { n as Logger } from "./logger-DWVYUmwi.js";
+import { r as BlockTemporalOptions } from "./block-helpers-BaugZlJV.js";
+import { t as BlockTransport } from "./block-transport-d53POsem.js";
+import { n as BlockHooks } from "./block-hooks-CmjPKqQ_.js";
+//#region src/blocks/documents/documents.d.ts
+interface DocumentsOptions extends BlockTemporalOptions {
+  readonly transport: BlockTransport;
+  /**
+   * The module schema, or its API schema: `defineBlocks` passes it from
+   * `blocks.generated.ts`.
+   */
+  readonly schema?: string;
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: BlockHooks<Documents>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+/** Which document to open: one per subject and name. */
+interface DocumentRef {
+  readonly organizationId: string;
+  readonly subjectType: string;
+  readonly subjectId: string;
+  /** Default: `body`. */
+  readonly name?: string;
+}
+/** A Yjs update and its place in the document's log. */
+interface DocumentUpdate {
+  readonly seq: number;
+  readonly update: Uint8Array;
+}
+interface DocumentInfo {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly subjectType: string;
+  readonly subjectId: string;
+  readonly name: string;
+  /** The private realtime topic for updates and presence. */
+  readonly topic: string;
+  readonly createdAt: Temporal.Instant;
+  readonly updatedAt: Temporal.Instant;
+}
+/** What a client needs to rebuild the document. */
+interface DocumentState {
+  /** The compacted state; unset before the first compaction. */
+  readonly snapshot?: Uint8Array;
+  /** The last update the snapshot contains, `0` without one. */
+  readonly snapshotSeq: number;
+  /** The updates after the snapshot, oldest first. */
+  readonly updates: readonly DocumentUpdate[];
+}
+interface OpenedDocument extends DocumentInfo, DocumentState {
+  /** Whether the caller may push updates. */
+  readonly canWrite: boolean;
+  /**
+   * Whether the caller may suggest changes: editors, and readers who hold
+   * `documents.suggest`.
+   */
+  readonly canSuggest: boolean;
+}
+interface DocumentVersion {
+  readonly id: string;
+  readonly number: number;
+  /** The version's name; a named version is kept out of retention. */
+  readonly label?: string;
+  /** `manual` for a saved version, `auto` for one the app took. */
+  readonly source: string;
+  /** A frozen version keeps its name. */
+  readonly frozen: boolean;
+  readonly createdBy?: string;
+  readonly createdAt: Temporal.Instant;
+}
+type DocumentSuggestionStatus = "open" | "accepted" | "rejected" | "withdrawn";
+/** A suggested change: a Yjs update that is not in the log yet. */
+interface DocumentSuggestion {
+  readonly id: string;
+  readonly documentId: string;
+  readonly update: Uint8Array;
+  readonly summary?: string;
+  readonly status: DocumentSuggestionStatus;
+  readonly createdBy?: string;
+  readonly createdAt: Temporal.Instant;
+  readonly decidedBy?: string;
+  readonly decidedAt?: Temporal.Instant;
+  readonly note?: string;
+}
+interface DecidedSuggestion extends DocumentSuggestion {
+  /** The update's place in the log, when the suggestion was accepted. */
+  readonly seq?: number;
+}
+type SuggestionDecision = "accepted" | "rejected" | "withdrawn";
+interface Documents {
+  /** The document's state; creates it on first open for an editor. */
+  open(ref: DocumentRef): AsyncResult<OpenedDocument>;
+  /** Appends an update and returns its sequence number. */
+  push(documentId: string, update: Uint8Array): AsyncResult<number>;
+  /**
+   * Updates after `afterSeq`. When compaction dropped some of them, the result
+   * carries the snapshot to start from instead.
+   */
+  pull(documentId: string, afterSeq: number): AsyncResult<DocumentState>;
+  /**
+   * Stores `state` as the snapshot through `throughSeq` and drops those
+   * updates. Returns false when a newer snapshot exists. The service role or
+   * `documents.manage`.
+   */
+  compact(documentId: string, state: Uint8Array, throughSeq: number): AsyncResult<boolean>;
+  /** Saves the merged state as a version; needs the versions module. */
+  saveVersion(documentId: string, state: Uint8Array, label?: string): AsyncResult<{
+    readonly id: string;
+    readonly number: number;
+  }>;
+  /**
+   * Newest first; needs the versions module. `named: true` keeps the versions
+   * with a name.
+   */
+  versions(documentId: string, options?: {
+    readonly named?: boolean;
+  }): AsyncResult<readonly DocumentVersion[]>;
+  /**
+   * Names a version, or removes its name with `null`. A named version is kept
+   * out of retention. Editors; needs the versions module.
+   */
+  nameVersion(documentId: string, versionId: string, label: string | null): AsyncResult<boolean>;
+  /**
+   * Stores an update as a suggestion instead of appending it. Editors, and
+   * readers who hold `documents.suggest`.
+   */
+  suggest(documentId: string, update: Uint8Array, summary?: string): AsyncResult<DocumentSuggestion>;
+  /** Oldest first. Default status: `open`. */
+  suggestions(documentId: string, options?: {
+    readonly status?: DocumentSuggestionStatus | "all";
+  }): AsyncResult<readonly DocumentSuggestion[]>;
+  /**
+   * Accepts or rejects a suggestion (editors), or withdraws it (its author).
+   * Accepting appends the update to the log.
+   */
+  decideSuggestion(suggestionId: string, decision: SuggestionDecision, note?: string): AsyncResult<DecidedSuggestion>;
+  /** A saved state; needs the versions module. */
+  version(documentId: string, versionId: string): AsyncResult<Uint8Array>;
+  /** Documents with at least `minUpdates` uncompacted updates. Service role. */
+  toCompact(options?: {
+    readonly minUpdates?: number;
+    readonly limit?: number;
+  }): AsyncResult<readonly string[]>;
+}
+/** The `documents` SQL module as typed calls, with updates as bytes. */
+declare function createDocuments(options: DocumentsOptions): Documents;
+//#endregion
+export { DocumentSuggestion as a, DocumentVersion as c, OpenedDocument as d, SuggestionDecision as f, DocumentState as i, Documents as l, DocumentInfo as n, DocumentSuggestionStatus as o, createDocuments as p, DocumentRef as r, DocumentUpdate as s, DecidedSuggestion as t, DocumentsOptions as u };

package/dist/edge/index.d.ts

@@ -1,18 +1,18 @@
-import { f as Result } from "../result-mijqfoJN.js";
-import { t as StandardSchemaV1 } from "../standard-16AIDny5.js";
-import { a as AnyModels, i as AnyFunctions } from "../types-DmshMaXz.js";
+import { f as Result } from "../result-C6jDfedy.js";
+import { t as StandardSchemaV1 } from "../standard-DbQsD2xZ.js";
+import { M as AnyFunctions, N as AnyModels } from "../executor-CPyrQdjh.js";
 import { s as PermissionRef, t as AnyAuthorizer } from "../authorizer-DFP3gHv8.js";
-import { t as BetterSupabase } from "../define-D0LSXmUP.js";
-import { t as AuthSession } from "../view-CKzCp8FW.js";
-import { a as ServerContext, c as ServerOptions, n as BetterServer } from "../server-types-D_cQ6OxZ.js";
-import { i as MiddlewareOptions, r as GuardOptions } from "../respond-QW-f1yio.js";
-import { c as ResourceLoaderContext, s as BlockRequireOptions } from "../kit-LeQGMzLH.js";
-import { n as FunctionContract, t as DescribedFunction } from "../function-contract-4vfi93Y5.js";
+import { t as BetterSupabase } from "../define-Dw7pRO4h.js";
+import { t as AuthSession } from "../view-2_I-2ukO.js";
+import { a as ServerContext, c as ServerOptions, n as BetterServer } from "../server-types-BOs-eFpo.js";
+import { i as MiddlewareOptions, r as GuardOptions } from "../respond-CZYibxUx.js";
+import { c as ResourceLoaderContext, s as BlockRequireOptions } from "../kit-DKfbNTAA.js";
+import { n as FunctionContract, t as DescribedFunction } from "../function-contract-vPqwt1j4.js";
 import { t as Validated } from "../shared-CRRfQAKG.js";
 import { n as SUPABASE_CORS_HEADERS, r as corsConfig, t as CorsOptions } from "../cors-kLq6VM06.js";
-import { i as ResourceContext, l as ResourceRouteOptions, o as ResourceHooks, r as ResourceAction, t as ActionArgs } from "../resource-types-NXau9LJE.js";
-import { t as ResourceMap } from "../resources-CZ60Vqwq.js";
-import { t as defineAction } from "../resource-execute-BbjuiXwD.js";
+import { i as ResourceContext, l as ResourceRouteOptions, o as ResourceHooks, r as ResourceAction, t as ActionArgs } from "../resource-types-Bzt_bpR5.js";
+import { t as ResourceMap } from "../resources-Du5wcL3f.js";
+import { t as defineAction } from "../resource-execute-bT9ltHVT.js";
 import { AnyEntry, Contributions } from "@supabase/middleware";
 //#region src/bridges/edge.d.ts
 /** The platform context Workers pass as the third `fetch` argument. */
@@ -126,14 +126,14 @@ export type EdgeRouteHandler<M extends AnyModels, F extends AnyFunctions, E, C =
  * A route with its own guard: `allow`, `aal`, `scopes`, `requireTenant`,
  * `authorize`.
  */
-export interface EdgeRoute<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown, Params = Readonly<Record<string, string>>, B = unknown> extends BlockRequireOptions<C, P, boolean, unknown, ServerContext<M, F, E, C, P, B> & ResourceLoaderContext<C, P>> {
+export interface EdgeRoute<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown, Params = Readonly<Record<string, string>>, B = unknown, Ref = unknown> extends BlockRequireOptions<C, P, boolean, Ref, ServerContext<M, F, E, C, P, B> & ResourceLoaderContext<C, P>> {
   readonly handler: EdgeRouteHandler<M, F, E, C, P, Params, B>;
 }
 /**
  * Routes by `"METHOD /path"` (or `"/path"` for every method). `:name` segments
  * are params, a final `*` matches the rest of the path.
  */
-export type EdgeRoutes<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown, B = unknown> = Readonly<Record<string, EdgeRouteHandler<M, F, E, C, P, Readonly<Record<string, string>>, B> | EdgeRoute<M, F, E, C, P, Readonly<Record<string, string>>, B>>>;
+export type EdgeRoutes<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown, B = unknown, Ref = unknown> = Readonly<Record<string, EdgeRouteHandler<M, F, E, C, P, Readonly<Record<string, string>>, B> | EdgeRoute<M, F, E, C, P, Readonly<Record<string, string>>, B, Ref>>>;
 export interface BetterEdge<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown, Ref = string, B = unknown> extends BetterServer<M, F, E, C, P, B> {
   /**
    * A fetch handler (`Deno.serve`, Workers `fetch`) running as the caller.
@@ -163,7 +163,7 @@ export interface BetterEdge<M extends AnyModels, F extends AnyFunctions, E, C =
    * );
    * ```
    */
-  routes<K extends string>(routes: { readonly [Key in K]: EdgeRouteHandler<M, F, E, C, P, RouteParams<Key>, B> | EdgeRoute<M, F, E, C, P, RouteParams<Key>, B>; }, options?: ResourcesOptions): EdgeHandler;
+  routes<K extends string>(routes: { readonly [Key in K]: EdgeRouteHandler<M, F, E, C, P, RouteParams<Key>, B> | EdgeRoute<M, F, E, C, P, RouteParams<Key>, B, Ref>; }, options?: ResourcesOptions): EdgeHandler;
   /**
    * REST resources matching the API model, e.g. `Deno.serve(bs.resources({
    * customers: true }))`: collection, item and action paths. An unknown path

package/dist/edge/index.js

@@ -1,16 +1,16 @@
-import { n as dbError } from "../errors-D7u24ZJH.js";
-import { a as ok, r as err } from "../result-DIT_qp4G.js";
-import { n as validate } from "../standard-l10kE0yS.js";
-import { o as problemResponse } from "../problem-D0KDiYPk.js";
-import { a as unexpectedResponse, c as extendServer, o as withFlush, s as createServer } from "../adapter-D8dW6p2A.js";
-import { a as respond, o as settle, t as defaultExpose } from "../respond-DjEmE_DN.js";
-import { t as withBetterSupabase } from "../composite-BgSdL5tk.js";
-import { r as defineAction } from "../resource-BVvIiuX_.js";
-import { i as requireCaller } from "../kit-BeXTrlZn.js";
+import { n as dbError } from "../errors-03ysrOt4.js";
+import { a as ok, r as err } from "../result-B3m7xtRY.js";
+import { n as validate } from "../standard-DtkpFGkS.js";
+import { o as problemResponse } from "../problem-BWElIgIb.js";
+import { a as unexpectedResponse, c as extendServer, o as withFlush, s as createServer } from "../adapter-BCFAg58A.js";
+import { a as respond, o as settle, t as defaultExpose } from "../respond-z_yfyitp.js";
+import { t as withBetterSupabase } from "../composite-Dv6o2BSw.js";
+import { r as defineAction } from "../resource-Dk_JYsOt.js";
+import { i as requireCaller } from "../kit-Ct4Z6GIO.js";
 import { t as withExtra } from "../extra-CGQ2_q3S.js";
-import { n as resourceRouter } from "../resources-CIi7sw1T.js";
+import { n as resourceRouter } from "../resources-BV6j5TTD.js";
 import { n as corsConfig, t as SUPABASE_CORS_HEADERS } from "../cors-h_v7TPxl.js";
-import { t as EVERY_CALLER } from "../framework-BpEnOfAo.js";
+import { t as EVERY_CALLER } from "../framework-CXoyWGgd.js";
 import { t as FUNCTION_DESCRIPTOR } from "../function-contract-pEmsaUIf.js";
 import { bufferRequest, pipeline, seedContext } from "@supabase/middleware";
 import { withCors } from "@supabase/middleware/cors";

package/dist/elysia/index.d.ts

@@ -1,4 +1,4 @@
-import { n as RouteGuardOptions } from "../refusal-BEyNVFy7.js";
+import { n as RouteGuardOptions } from "../refusal-efy5bZMd.js";
 import { t as Validated } from "../shared-CRRfQAKG.js";
 import { AnyEntry, Contributions } from "@supabase/middleware";
 //#region src/bridges/elysia.d.ts

package/dist/elysia/index.js

@@ -1,5 +1,5 @@
 import { t as around } from "../shared-Bf-I13Ht.js";
-import { a as routeRefusal, n as guardedLocals, t as errorResponse } from "../refusal-Ce2p81VW.js";
+import { a as routeRefusal, n as guardedLocals, t as errorResponse } from "../refusal-DXydjgsS.js";
 import { bufferRequest } from "@supabase/middleware";
 //#region src/bridges/elysia.ts
 /**

package/dist/embeddings-CcRP-cMN.d.ts

@@ -0,0 +1,78 @@
+import { d as KnowledgeSearchOptions, n as Embedder, o as KnowledgeHit, r as Knowledge } from "./knowledge-CFkCRxO9.js";
+import { EmbeddingModel, RerankingModel, SourceDocumentUIPart, Tool, embedMany } from "ai";
+//#region src/ai-sdk/embeddings/embeddings.d.ts
+type ProviderOptions = Parameters<typeof embedMany>[0]["providerOptions"];
+interface EmbedWithOptions {
+  /** Concurrent calls when the values need more than one. Default 4. */
+  readonly maxParallelCalls?: number;
+  readonly providerOptions?: ProviderOptions;
+  /** The name stored with each embedding; the provider and model id by default. */
+  readonly name?: string;
+}
+/** The name of an SDK model: the string itself, or `provider/modelId`. */
+declare function modelName(model: string | {
+  readonly provider: string;
+  readonly modelId: string;
+}): string;
+/** An `Embedder` for the knowledge and memory blocks over `embedMany`. */
+declare function embedWith(model: EmbeddingModel, options?: EmbedWithOptions): Embedder;
+type Reranker = (query: string, hits: readonly KnowledgeHit[], options?: {
+  readonly signal?: AbortSignal;
+}) => Promise<readonly KnowledgeHit[]>;
+/** Reorders search hits with a reranking model, keeping the best `topN`. */
+declare function rerankWith(model: RerankingModel, options?: {
+  readonly topN?: number;
+}): Reranker;
+/**
+ * Keeps the items of a search the caller may read. A tool applies it before
+ * anything else sees the items: the reranker, `onHits` and the model. A throw
+ * fails the tool call, so no items reach the model.
+ */
+type ResultsFilter<T, C = {
+  readonly query: string;
+}> = (items: readonly T[], context: C) => readonly T[] | PromiseLike<readonly T[]>;
+interface SearchToolOptions extends Omit<KnowledgeSearchOptions, "signal"> {
+  readonly description?: string;
+  /** Drops the hits the caller may not read, such as by a permission. */
+  readonly results?: ResultsFilter<KnowledgeHit>;
+  /** Reranks the hits before the model sees them. */
+  readonly rerank?: Reranker;
+  /** Called with the hits, to stream them as source parts. */
+  readonly onHits?: (hits: readonly KnowledgeHit[]) => void;
+}
+interface SearchToolResult {
+  readonly results: readonly {
+    readonly id: string;
+    readonly title: string;
+    readonly content: string;
+  }[];
+}
+/**
+ * A tool that searches the knowledge base as the caller. Each result id is
+ * `documentId#index`, the `sourceId` that `toSourceParts` gives it.
+ */
+declare function searchTool(knowledge: Knowledge, organizationId: string, options?: SearchToolOptions): Tool<{
+  query: string;
+}, SearchToolResult>;
+/** One `source-document` part per document among the hits, in hit order. */
+declare function toSourceParts(hits: readonly KnowledgeHit[]): SourceDocumentUIPart[];
+/** `Supabase.ai.Session` in Supabase Edge Functions, typed structurally. */
+interface SupabaseAiSession {
+  run(input: string, options: {
+    readonly mean_pool: boolean;
+    readonly normalize: boolean;
+  }): Promise<unknown>;
+}
+interface SupabaseEmbedOptions {
+  /** The built-in model. Default `gte-small` (384 dimensions). */
+  readonly model?: string;
+  /** A session to use instead of `new Supabase.ai.Session(model)`. */
+  readonly session?: SupabaseAiSession;
+}
+/**
+ * An `Embedder` over the model built into Supabase Edge Functions. Set the
+ * module's `dimensions` option to the model's size (384 for `gte-small`).
+ */
+declare function supabaseEmbed(options?: SupabaseEmbedOptions): Embedder;
+//#endregion
+export { SearchToolResult as a, embedWith as c, searchTool as d, supabaseEmbed as f, SearchToolOptions as i, modelName as l, Reranker as n, SupabaseAiSession as o, toSourceParts as p, ResultsFilter as r, SupabaseEmbedOptions as s, EmbedWithOptions as t, rerankWith as u };

package/dist/embeddings-vVzseUw0.js

@@ -0,0 +1,128 @@
+import { t as DbException } from "./db-exception-Lngc1W49.js";
+import { embedMany, jsonSchema, rerank, tool } from "ai";
+//#region src/ai-sdk/embeddings/embeddings.ts
+/** The name of an SDK model: the string itself, or `provider/modelId`. */
+function modelName(model) {
+	return typeof model === "string" ? model : `${model.provider}/${model.modelId}`;
+}
+/** An `Embedder` for the knowledge and memory blocks over `embedMany`. */
+function embedWith(model, options = {}) {
+	return {
+		apiVersion: 1,
+		model: options.name ?? modelName(model),
+		embed: async (values, embedOptions) => {
+			if (values.length === 0) return [];
+			const { embeddings } = await embedMany({
+				model,
+				values: [...values],
+				maxParallelCalls: options.maxParallelCalls ?? 4,
+				...options.providerOptions === void 0 ? {} : { providerOptions: options.providerOptions },
+				...embedOptions?.signal === void 0 ? {} : { abortSignal: embedOptions.signal }
+			});
+			return embeddings;
+		}
+	};
+}
+/** Reorders search hits with a reranking model, keeping the best `topN`. */
+function rerankWith(model, options = {}) {
+	return async (query, hits, rerankOptions) => {
+		if (hits.length <= 1) return hits;
+		const { ranking } = await rerank({
+			model,
+			query,
+			documents: hits.map((hit) => hit.content),
+			...options.topN === void 0 ? {} : { topN: options.topN },
+			...rerankOptions?.signal === void 0 ? {} : { abortSignal: rerankOptions.signal }
+		});
+		return ranking.flatMap((entry) => {
+			const hit = hits[entry.originalIndex];
+			return hit === void 0 ? [] : [{
+				...hit,
+				score: entry.score
+			}];
+		});
+	};
+}
+/**
+* A tool that searches the knowledge base as the caller. Each result id is
+* `documentId#index`, the `sourceId` that `toSourceParts` gives it.
+*/
+function searchTool(knowledge, organizationId, options = {}) {
+	const { description, results, rerank: reorder, onHits, ...search } = options;
+	return tool({
+		description: description ?? "Search the knowledge base for passages relevant to a query. Cite results by their id.",
+		inputSchema: jsonSchema({
+			type: "object",
+			properties: { query: {
+				type: "string",
+				description: "What to look for"
+			} },
+			required: ["query"],
+			additionalProperties: false
+		}),
+		execute: async ({ query }, { abortSignal }) => {
+			const found = await knowledge.search(organizationId, query, {
+				...search,
+				...abortSignal === void 0 ? {} : { signal: abortSignal }
+			});
+			if (!found.ok) throw new DbException(found.error);
+			const readable = results ? await results(found.data, { query }) : found.data;
+			const hits = reorder ? await reorder(query, readable, abortSignal === void 0 ? void 0 : { signal: abortSignal }) : readable;
+			onHits?.(hits);
+			return { results: hits.map((hit) => ({
+				id: sourceId(hit),
+				title: hit.title,
+				content: hit.content
+			})) };
+		}
+	});
+}
+const sourceId = (hit) => `${hit.documentId}#${String(hit.index)}`;
+/** One `source-document` part per document among the hits, in hit order. */
+function toSourceParts(hits) {
+	const seen = /* @__PURE__ */ new Set();
+	const parts = [];
+	for (const hit of hits) {
+		if (seen.has(hit.documentId)) continue;
+		seen.add(hit.documentId);
+		parts.push({
+			type: "source-document",
+			sourceId: sourceId(hit),
+			mediaType: "text/plain",
+			title: hit.title
+		});
+	}
+	return parts;
+}
+function supabaseSession(model) {
+	const Session = globalThis.Supabase?.ai?.Session;
+	if (typeof Session !== "function") throw new TypeError("supabaseEmbed runs in Supabase Edge Functions, where Supabase.ai.Session exists; pass session elsewhere");
+	return new Session(model);
+}
+/**
+* An `Embedder` over the model built into Supabase Edge Functions. Set the
+* module's `dimensions` option to the model's size (384 for `gte-small`).
+*/
+function supabaseEmbed(options = {}) {
+	const name = options.model ?? "gte-small";
+	let session = options.session;
+	return {
+		apiVersion: 1,
+		model: `supabase/${name}`,
+		embed: async (values) => {
+			session ??= supabaseSession(name);
+			const vectors = [];
+			for (const value of values) {
+				const output = await session.run(value, {
+					mean_pool: true,
+					normalize: true
+				});
+				if (!Array.isArray(output) || !output.every((x) => typeof x === "number")) throw new TypeError(`Supabase.ai.Session returned no vector for ${name}`);
+				vectors.push(output);
+			}
+			return vectors;
+		}
+	};
+}
+//#endregion
+export { supabaseEmbed as a, searchTool as i, modelName as n, toSourceParts as o, rerankWith as r, embedWith as t };