better-supabase 0.12.0 → 0.13.0

package/dist/edge/index.d.ts

@@ -1,25 +1,28 @@
-import { f as Result } from "../result-BREt7qOh.js";
-import { a as AnyModels, i as AnyFunctions } from "../types-BrpW5ixT.js";
-import { t as StandardSchemaV1 } from "../standard-BcUQuUgu.js";
-import { s as PermissionRef, t as AnyAuthorizer } from "../authorizer-eiOjo-3l.js";
-import { t as BetterSupabase } from "../define-DYZnvAbs.js";
-import { a as ServerContext, c as ServerOptions, n as BetterServer } from "../server-types-fLdep4gb.js";
-import { t as AuthSession } from "../view-KQhe6eNc.js";
-import { i as MiddlewareOptions, r as GuardOptions } from "../respond-BSL36dQp.js";
-import { s as BlockRequireOptions } from "../kit-De-EVRhw.js";
-import { n as FunctionContract, t as DescribedFunction } from "../function-contract-DWqFl_QO.js";
-import { t as Validated } from "../shared-DDSjEGDR.js";
+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 { 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 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-LW1i5-h3.js";
-import { t as ResourceMap } from "../resources-D3_FAz_H.js";
-import { t as defineAction } from "../resource-execute-Bxvgmx-n.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 { AnyEntry, Contributions } from "@supabase/middleware";
 //#region src/bridges/edge.d.ts
 /** The platform context Workers pass as the third `fetch` argument. */
 interface EdgeExecutionContext {
   waitUntil(promise: Promise<unknown>): void;
 }
-/** `Deno.serve` passes `(request, info)`, Workers `fetch` passes `(request, env, ctx)`. */
+/**
+ * `Deno.serve` passes `(request, info)`, Workers `fetch` passes `(request, env,
+ * ctx)`.
+ */
 type EdgeHandler = (request: Request, env?: unknown, executionContext?: EdgeExecutionContext) => Promise<Response>;
 /**
  * Runs an entry array around `handler` as a fetch handler for Supabase Edge
@@ -27,14 +30,20 @@ type EdgeHandler = (request: Request, env?: unknown, executionContext?: EdgeExec
  * context, so on Workers `getEnv` inside the entries reads the bindings.
  *
  * ```ts
- * Deno.serve(toEdge([withBetterSupabase(server)], async (req, ctx) =>
- *   Response.json(await ctx.db.notes.findMany().orThrow())))
+ * Deno.serve(
+ *   toEdge([withBetterSupabase(server)], async (req, ctx) =>
+ *     Response.json(await ctx.db.notes.findMany().orThrow()),
+ *   ),
+ * );
  * ```
  */
 export declare function toEdge<const Entries extends readonly AnyEntry[]>(entries: Entries & Validated<Entries>, handler: (request: Request, ctx: Contributions<Entries>, executionContext: EdgeExecutionContext | undefined, env: unknown) => Response | Promise<Response>): EdgeHandler;
 //#endregion
 //#region src/edge/function.d.ts
-/** A fetch handler that carries its contract in its type and its schemas at runtime. */
+/**
+ * A fetch handler that carries its contract in its type and its schemas at
+ * runtime.
+ */
 type TypedFunction<In, Out> = EdgeHandler & DescribedFunction & {
   /** Type-only: never set at runtime. */
   readonly "~contract"?: FunctionContract<In, Out>;
@@ -53,7 +62,10 @@ interface FunctionDefinition<I extends StandardSchemaV1, Out, M extends AnyModel
    * answers 500, so a function never sends data its contract doesn't promise.
    */
   readonly output?: StandardSchemaV1<unknown, Out>;
-  /** A one-line summary for the operation `functionRoute` describes in `better-supabase/spec`. */
+  /**
+   * A one-line summary for the operation `functionRoute` describes in
+   * `better-supabase/spec`.
+   */
   readonly summary?: string;
   /** Runs as the caller with the parsed input. Returns data or a `Result`. */
   readonly handler: (input: StandardSchemaV1.InferOutput<I>, ctx: ServerContext<M, F, E, C, P, B> & {
@@ -81,7 +93,10 @@ export declare function defineFunction<I extends StandardSchemaV1, Out, M extend
 export interface EdgeOptions extends ServerOptions {
   /** Answer preflights and add CORS headers. `true` uses Supabase's defaults. */
   readonly cors?: boolean | CorsOptions;
-  /** Include error details in problem responses. Defaults to `NODE_ENV === 'development'`. */
+  /**
+   * Include error details in problem responses. Defaults to `NODE_ENV ===
+   * 'development'`.
+   */
   readonly exposeErrors?: boolean;
   /**
    * Keeps the invocation alive for event sink sends a handler started, e.g.
@@ -96,9 +111,9 @@ export interface ResourcesOptions extends MiddlewareOptions {
 }
 type ParamNames<K extends string> = K extends `${string}:${infer Name}/${infer Rest}` ? Name | ParamNames<Rest> : K extends `${string}:${infer Name}` ? Name : never;
 /**
- * The params a route key declares: one per `:name` segment, and `*` for a
- * final wildcard. `RouteParams<"GET /orgs/:org/files/*">` is
- * `{ org: string; "*": string }`.
+ * The params a route key declares: one per `:name` segment, and `*` for a final
+ * wildcard. `RouteParams<"GET /orgs/:org/files/*">` is `{ org: string; "*":
+ * string }`.
  */
 export type RouteParams<K extends string> = { readonly [N in ParamNames<K> | (K extends `${string}/*` ? "*" : never)]: string; };
 /** A route handler: the request, the caller's context and the path params. */
@@ -107,13 +122,16 @@ export type EdgeRouteHandler<M extends AnyModels, F extends AnyFunctions, E, C =
   readonly session: AuthSession<C, P>;
   readonly tenant: string | undefined;
 }) => unknown;
-/** 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> {
+/**
+ * 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>> {
   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.
+ * 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 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> {
@@ -124,23 +142,32 @@ export interface BetterEdge<M extends AnyModels, F extends AnyFunctions, E, C =
   handler(fn: (request: Request, ctx: ServerContext<M, F, E, C, P, B>) => unknown, options?: MiddlewareOptions): EdgeHandler;
   /**
    * A router: each route runs as the caller, behind the shared guard in
-   * `options` and its own. An unknown path answers 404 and a known path
-   * with another method 405, both before auth resolves. `ctx.params` is
-   * typed from the key: `"GET /customers/:id"` gets `params.id`.
+   * `options` and its own. An unknown path answers 404 and a known path with
+   * another method 405, both before auth resolves. `ctx.params` is typed from
+   * the key: `"GET /customers/:id"` gets `params.id`.
    *
    * ```ts
-   * Deno.serve(bs.routes({
-   *   'GET /customers': (req, ctx) => ctx.db.customers.findMany(),
-   *   'GET /customers/:id': (req, ctx) => ctx.db.customers.find(ctx.params.id),
-   *   'POST /invites': { requireTenant: true, handler: (req, ctx) => invite(req, ctx) },
-   * }, { basePath: '/api' }))
+   * Deno.serve(
+   *   bs.routes(
+   *     {
+   *       "GET /customers": (req, ctx) => ctx.db.customers.findMany(),
+   *       "GET /customers/:id": (req, ctx) =>
+   *         ctx.db.customers.find(ctx.params.id),
+   *       "POST /invites": {
+   *         requireTenant: true,
+   *         handler: (req, ctx) => invite(req, ctx),
+   *       },
+   *     },
+   *     { basePath: "/api" },
+   *   ),
+   * );
    * ```
    */
   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;
   /**
-   * REST resources matching the API model, e.g.
-   * `Deno.serve(bs.resources({ customers: true }))`: collection, item and
-   * action paths. An unknown path answers 404 before auth resolves.
+   * REST resources matching the API model, e.g. `Deno.serve(bs.resources({
+   * customers: true }))`: collection, item and action paths. An unknown path
+   * answers 404 before auth resolves.
    */
   resources(map: ResourceMap<M, Ref, ServerContext<M, F, E, C, P, B>["db"]>, options?: ResourcesOptions): EdgeHandler;
 }

package/dist/edge/index.js

@@ -1,17 +1,17 @@
-import { n as dbError } from "../errors-BV1SKTVs.js";
-import { a as ok, r as err } from "../result-DIeYscA3.js";
-import { n as validate } from "../standard-B1BigegP.js";
-import { o as problemResponse } from "../problem-JRCohp1j.js";
-import { a as unexpectedResponse, c as extendServer, o as withFlush, s as createServer } from "../adapter-CRNH2aX_.js";
-import { a as respond, o as settle, t as defaultExpose } from "../respond-Bhp3G__q.js";
-import { t as withBetterSupabase } from "../composite-1kPAxXto.js";
-import { r as defineAction } from "../resource-Bdkqi8jo.js";
-import { i as requireCaller } from "../kit-LTbHrWWD.js";
+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 { t as withExtra } from "../extra-CGQ2_q3S.js";
-import { n as resourceRouter } from "../resources-Ck7itNeX.js";
+import { n as resourceRouter } from "../resources-CIi7sw1T.js";
 import { n as corsConfig, t as SUPABASE_CORS_HEADERS } from "../cors-h_v7TPxl.js";
-import { t as EVERY_CALLER } from "../framework-C6PKBgme.js";
-import { t as FUNCTION_DESCRIPTOR } from "../function-contract-DmkBg19r.js";
+import { t as EVERY_CALLER } from "../framework-BpEnOfAo.js";
+import { t as FUNCTION_DESCRIPTOR } from "../function-contract-pEmsaUIf.js";
 import { bufferRequest, pipeline, seedContext } from "@supabase/middleware";
 import { withCors } from "@supabase/middleware/cors";
 //#region src/bridges/edge.ts
@@ -21,8 +21,11 @@ import { withCors } from "@supabase/middleware/cors";
 * context, so on Workers `getEnv` inside the entries reads the bindings.
 *
 * ```ts
-* Deno.serve(toEdge([withBetterSupabase(server)], async (req, ctx) =>
-*   Response.json(await ctx.db.notes.findMany().orThrow())))
+* Deno.serve(
+*   toEdge([withBetterSupabase(server)], async (req, ctx) =>
+*     Response.json(await ctx.db.notes.findMany().orThrow()),
+*   ),
+* );
 * ```
 */
 function toEdge(entries, handler) {
@@ -80,8 +83,8 @@ function paramsOf(segments, rest, parts) {
 	return params;
 }
 /**
-* The route for `method` and `path`: a match, the allowed methods when the
-* path matches under another method (`HEAD` falls back to `GET`), or `"none"`.
+* The route for `method` and `path`: a match, the allowed methods when the path
+* matches under another method (`HEAD` falls back to `GET`), or `"none"`.
 */
 function matchRoute(routes, method, path) {
 	const parts = split(path);
@@ -221,7 +224,7 @@ function createEdge(betterSupabase, options = {}) {
 				const caller = await requireCaller(ctx.auth, {
 					...shared,
 					...route.options
-				}, tenant, options.authorizer);
+				}, tenant, options.authorizer, ctx);
 				if ("kind" in caller) return err(caller);
 				return route.handler(request, withExtra(ctx, {
 					params,

package/dist/elysia/index.d.ts

@@ -1,25 +1,25 @@
-import { n as RouteGuardOptions } from "../refusal-C7geIBRl.js";
-import { t as Validated } from "../shared-DDSjEGDR.js";
+import { n as RouteGuardOptions } from "../refusal-BEyNVFy7.js";
+import { t as Validated } from "../shared-CRRfQAKG.js";
 import { AnyEntry, Contributions } from "@supabase/middleware";
 //#region src/bridges/elysia.d.ts
 interface ElysiaBridge<Entries extends readonly AnyEntry[]> {
   /**
-   * Runs the entries around the app's fetch (`app.handle`), so short
-   * circuits answer before Elysia routes and the route's response passes
-   * back through the entries.
+   * Runs the entries around the app's fetch (`app.handle`), so short circuits
+   * answer before Elysia routes and the route's response passes back through
+   * the entries.
    */
   wrap(handle: (request: Request) => Promise<Response>): (request: Request, env?: unknown) => Promise<Response>;
   /**
    * The contributions for a request `wrap` is serving. Throws for any other
-   * request, so a route reached without the entries fails closed.
-   * Expose it with `.derive(({ request }) => bridge.context(request))`.
+   * request, so a route reached without the entries fails closed. Expose it
+   * with `.derive(({ request }) => bridge.context(request))`.
    */
   context(request: Request): Contributions<Entries>;
 }
 /**
- * Runs an entry array around an Elysia app. Elysia has no middleware slot
- * that sees the response it produces, so the bridge wraps the app's fetch
- * and hands the contributions to routes through `context(request)`.
+ * Runs an entry array around an Elysia app. Elysia has no middleware slot that
+ * sees the response it produces, so the bridge wraps the app's fetch and hands
+ * the contributions to routes through `context(request)`.
  *
  * ```ts
  * const bridge = toElysia([withBetterSupabase(server)])
@@ -35,18 +35,20 @@ export declare function toElysia<const Entries extends readonly AnyEntry[]>(entr
  * Details, or a redirect to `signIn` or `mfa`.
  *
  * ```ts
- * app.get('/admin', handler, { beforeHandle: guard(bridge, { roles: ['admin'] }) })
+ * app.get("/admin", handler, {
+ *   beforeHandle: guard(bridge, { roles: ["admin"] }),
+ * });
  * ```
  */
 export declare function guard<Entries extends readonly AnyEntry[]>(bridge: ElysiaBridge<Entries>, options?: RouteGuardOptions): (context: {
   readonly request: Request;
 }) => Promise<Response | undefined>;
 /**
- * An `onError` hook that answers thrown `DbException`s (from `.orThrow()`)
- * with Problem Details and leaves every other error to Elysia.
+ * An `onError` hook that answers thrown `DbException`s (from `.orThrow()`) with
+ * Problem Details and leaves every other error to Elysia.
  *
  * ```ts
- * new Elysia().onError(problemOnError())
+ * new Elysia().onError(problemOnError());
  * ```
  */
 export declare function problemOnError(options?: {

package/dist/elysia/index.js

@@ -1,11 +1,11 @@
-import { t as around } from "../shared-BmMcMoW9.js";
-import { a as routeRefusal, n as guardedLocals, t as errorResponse } from "../refusal-CFpfmjcS.js";
+import { t as around } from "../shared-Bf-I13Ht.js";
+import { a as routeRefusal, n as guardedLocals, t as errorResponse } from "../refusal-Ce2p81VW.js";
 import { bufferRequest } from "@supabase/middleware";
 //#region src/bridges/elysia.ts
 /**
-* Runs an entry array around an Elysia app. Elysia has no middleware slot
-* that sees the response it produces, so the bridge wraps the app's fetch
-* and hands the contributions to routes through `context(request)`.
+* Runs an entry array around an Elysia app. Elysia has no middleware slot that
+* sees the response it produces, so the bridge wraps the app's fetch and hands
+* the contributions to routes through `context(request)`.
 *
 * ```ts
 * const bridge = toElysia([withBetterSupabase(server)])
@@ -38,7 +38,9 @@ function toElysia(entries) {
 * Details, or a redirect to `signIn` or `mfa`.
 *
 * ```ts
-* app.get('/admin', handler, { beforeHandle: guard(bridge, { roles: ['admin'] }) })
+* app.get("/admin", handler, {
+*   beforeHandle: guard(bridge, { roles: ["admin"] }),
+* });
 * ```
 */
 function guard(bridge, options = {}) {
@@ -48,11 +50,11 @@ function guard(bridge, options = {}) {
 	};
 }
 /**
-* An `onError` hook that answers thrown `DbException`s (from `.orThrow()`)
-* with Problem Details and leaves every other error to Elysia.
+* An `onError` hook that answers thrown `DbException`s (from `.orThrow()`) with
+* Problem Details and leaves every other error to Elysia.
 *
 * ```ts
-* new Elysia().onError(problemOnError())
+* new Elysia().onError(problemOnError());
 * ```
 */
 function problemOnError(options = {}) {

package/dist/email-tt2QqiSc.d.ts

@@ -0,0 +1,42 @@
+import { n as NotificationMessage, t as NotificationChannel } from "./channel-BjvGO39m.js";
+import { a as DeliveryTransport, c as UnsubscribeTarget, s as MailCategory } from "./delivery-n6lZGuGx.js";
+//#region src/blocks/notifications/email.d.ts
+/** The mail for one delivery. */
+interface ComposedEmail {
+  readonly subject: string;
+  readonly text?: string;
+  readonly html?: string;
+  readonly replyTo?: string;
+  /** Defaults to `notification`. */
+  readonly category?: MailCategory;
+  /**
+   * Names the template this mail came from, e.g. `task-assigned-v2`. The
+   * delivery keeps it, so a record's sent emails show which one went out.
+   */
+  readonly templateKey?: string;
+}
+interface EmailChannelOptions {
+  readonly transport: DeliveryTransport;
+  /** `Name <address>` or an address the provider has verified. */
+  readonly from: string;
+  readonly replyTo?: string;
+  /**
+   * The mail for a delivery. Defaults to the rendered title as the subject and
+   * the rendered body (or the title) as the text, so it needs
+   * `createNotifications({ render })`.
+   */
+  readonly compose?: (message: NotificationMessage) => ComposedEmail | Promise<ComposedEmail>;
+  /**
+   * Where the reader unsubscribes from this mail, such as a signed link to your
+   * preferences route. Only `notification` mail carries it.
+   */
+  readonly unsubscribe?: (message: NotificationMessage) => UnsubscribeTarget | undefined | Promise<UnsubscribeTarget | undefined>;
+}
+/**
+ * A `NotificationChannel` named `email` that sends through `transport`, with
+ * the delivery id as the idempotency key. A recipient without an address is
+ * skipped.
+ */
+declare function emailChannel(options: EmailChannelOptions): NotificationChannel;
+//#endregion
+export { EmailChannelOptions as n, emailChannel as r, ComposedEmail as t };

package/dist/embeddings-DRGIc8ti.js

@@ -0,0 +1,128 @@
+import { t as DbException } from "./db-exception-CnWcYPxL.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 };

package/dist/embeddings-Deusi99x.d.ts

@@ -0,0 +1,78 @@
+import { d as KnowledgeSearchOptions, n as Embedder, o as KnowledgeHit, r as Knowledge } from "./knowledge-CYdNJasZ.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 };