better-supabase 0.5.0 → 0.6.0

package/dist/message-CaKlqdsX.js

@@ -0,0 +1,219 @@
+import { d as isRecord } from "./block-helpers-DWHxHsEQ.js";
+//#region src/blocks/ai-chat/message.ts
+/** `$id` of `schemas/ai-message-v1.json`, the JSON Schema of `AiMessage`. */
+const AI_MESSAGE_SCHEMA_ID = "https://unpkg.com/better-supabase/schemas/ai-message-v1.json";
+const AI_MESSAGE_PART_TYPES = [
+	"text",
+	"reasoning",
+	"file",
+	"tool-call",
+	"tool-result",
+	"tool-approval",
+	"source",
+	"data",
+	"step"
+];
+const ROLES = /* @__PURE__ */ new Set([
+	"system",
+	"user",
+	"assistant",
+	"tool"
+]);
+const text = {
+	kind: "string",
+	required: true
+};
+const optionalText = { kind: "string" };
+const state = {
+	kind: "string",
+	values: ["streaming", "done"]
+};
+const FIELDS = {
+	text: {
+		text,
+		state
+	},
+	reasoning: {
+		text,
+		state
+	},
+	file: {
+		mediaType: text,
+		url: text,
+		filename: optionalText
+	},
+	"tool-call": {
+		toolCallId: text,
+		toolName: text,
+		input: {
+			kind: "any",
+			required: true
+		},
+		providerExecuted: { kind: "boolean" }
+	},
+	"tool-result": {
+		toolCallId: text,
+		toolName: text,
+		output: {
+			kind: "any",
+			required: true
+		},
+		isError: { kind: "boolean" }
+	},
+	"tool-approval": {
+		toolCallId: text,
+		approvalId: text,
+		state: {
+			kind: "string",
+			required: true,
+			values: [
+				"requested",
+				"approved",
+				"denied"
+			]
+		},
+		reason: optionalText
+	},
+	source: {
+		sourceType: {
+			kind: "string",
+			required: true,
+			values: ["url", "document"]
+		},
+		id: text,
+		url: optionalText,
+		title: optionalText,
+		mediaType: optionalText
+	},
+	data: {
+		name: text,
+		id: optionalText,
+		data: {
+			kind: "any",
+			required: true
+		}
+	},
+	step: {
+		boundary: {
+			kind: "string",
+			required: true,
+			values: ["start", "finish"]
+		},
+		stepId: optionalText
+	}
+};
+const isPartType = (value) => typeof value === "string" && Object.hasOwn(FIELDS, value);
+function checkField(value, field, path, issues) {
+	switch (field.kind) {
+		case "any": return;
+		case "boolean":
+			if (typeof value !== "boolean") issues.push({
+				message: "Expected a boolean",
+				path
+			});
+			return;
+		case "object":
+			if (!isRecord(value)) issues.push({
+				message: "Expected an object",
+				path
+			});
+			return;
+		case "string":
+			if (typeof value !== "string") issues.push({
+				message: "Expected a string",
+				path
+			});
+			else if (field.values !== void 0 && !field.values.includes(value)) issues.push({
+				message: `Expected one of ${field.values.join(", ")}`,
+				path
+			});
+			return;
+		default: return field.kind;
+	}
+}
+function checkPart(value, path, issues) {
+	if (!isRecord(value)) {
+		issues.push({
+			message: "Expected a part object",
+			path
+		});
+		return;
+	}
+	const type = value["type"];
+	if (!isPartType(type)) {
+		issues.push({
+			message: `Expected a part type: ${AI_MESSAGE_PART_TYPES.join(", ")}`,
+			path: [...path, "type"]
+		});
+		return;
+	}
+	const fields = FIELDS[type];
+	for (const [key, entry] of Object.entries(value)) {
+		if (key === "type") continue;
+		if (key === "providerMetadata") {
+			checkField(entry, { kind: "object" }, [...path, key], issues);
+			continue;
+		}
+		const field = fields[key];
+		if (field === void 0) issues.push({
+			message: `Unknown ${type} part field`,
+			path: [...path, key]
+		});
+		else if (entry !== void 0) checkField(entry, field, [...path, key], issues);
+	}
+	for (const [key, field] of Object.entries(fields)) if (field.required === true && value[key] === void 0) issues.push({
+		message: "Required",
+		path: [...path, key]
+	});
+}
+function checkMessage(value) {
+	const issues = [];
+	if (!isRecord(value)) return [{ message: "Expected a message object" }];
+	for (const key of Object.keys(value)) if (![
+		"id",
+		"role",
+		"parts",
+		"metadata"
+	].includes(key)) issues.push({
+		message: "Unknown message field",
+		path: [key]
+	});
+	if (typeof value["id"] !== "string" || value["id"].length === 0) issues.push({
+		message: "Expected a non-empty id",
+		path: ["id"]
+	});
+	const role = value["role"];
+	if (typeof role !== "string" || !ROLES.has(role)) issues.push({
+		message: "Expected system, user, assistant or tool",
+		path: ["role"]
+	});
+	const parts = value["parts"];
+	if (Array.isArray(parts)) for (const [index, part] of parts.entries()) checkPart(part, ["parts", index], issues);
+	else issues.push({
+		message: "Expected a parts array",
+		path: ["parts"]
+	});
+	if (value["metadata"] !== void 0 && !isRecord(value["metadata"])) issues.push({
+		message: "Expected an object",
+		path: ["metadata"]
+	});
+	return issues;
+}
+/**
+* A Standard Schema for `AiMessage`, matching `schemas/ai-message-v1.json`.
+* Pass it to `validate()` or any library that takes a Standard Schema.
+*/
+const aiMessageSchema = { "~standard": {
+	version: 1,
+	vendor: "better-supabase",
+	validate(value) {
+		const issues = checkMessage(value);
+		return issues.length > 0 ? { issues } : { value };
+	}
+} };
+/** Whether `value` is a canonical message, without collecting the issues. */
+function isAiMessage(value) {
+	return checkMessage(value).length === 0;
+}
+//#endregion
+export { isAiMessage as i, AI_MESSAGE_SCHEMA_ID as n, aiMessageSchema as r, AI_MESSAGE_PART_TYPES as t };

package/dist/message-CfDoR0Y6.d.ts

@@ -0,0 +1,94 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
+//#region src/blocks/ai-chat/message.d.ts
+/** `$id` of `schemas/ai-message-v1.json`, the JSON Schema of `AiMessage`. */
+declare const AI_MESSAGE_SCHEMA_ID = "https://unpkg.com/better-supabase/schemas/ai-message-v1.json";
+type ProviderMetadata = Readonly<Record<string, unknown>>;
+interface PartBase {
+  /** What the provider attached, kept for replay; never read for logic. */
+  readonly providerMetadata?: ProviderMetadata;
+}
+interface AiTextPart extends PartBase {
+  readonly type: "text";
+  readonly text: string;
+  readonly state?: "streaming" | "done";
+}
+interface AiReasoningPart extends PartBase {
+  readonly type: "reasoning";
+  readonly text: string;
+  readonly state?: "streaming" | "done";
+}
+interface AiFilePart extends PartBase {
+  readonly type: "file";
+  /** IANA media type, e.g. `image/png`. */
+  readonly mediaType: string;
+  /** A URL the reader can fetch: `https:`, `data:` or a storage path the app signs. */
+  readonly url: string;
+  readonly filename?: string;
+}
+interface AiToolCallPart extends PartBase {
+  readonly type: "tool-call";
+  readonly toolCallId: string;
+  readonly toolName: string;
+  readonly input: unknown;
+  /** The provider ran the tool itself (web search on the model's side). */
+  readonly providerExecuted?: boolean;
+}
+interface AiToolResultPart extends PartBase {
+  readonly type: "tool-result";
+  readonly toolCallId: string;
+  readonly toolName: string;
+  readonly output: unknown;
+  readonly isError?: boolean;
+}
+interface AiToolApprovalPart extends PartBase {
+  readonly type: "tool-approval";
+  readonly toolCallId: string;
+  readonly approvalId: string;
+  readonly state: "requested" | "approved" | "denied";
+  readonly reason?: string;
+}
+interface AiSourcePart extends PartBase {
+  readonly type: "source";
+  readonly sourceType: "url" | "document";
+  readonly id: string;
+  readonly url?: string;
+  readonly title?: string;
+  readonly mediaType?: string;
+}
+/** App data in the message (`data-weather` in the AI SDK becomes `name: "weather"`). */
+interface AiDataPart extends PartBase {
+  readonly type: "data";
+  readonly name: string;
+  readonly id?: string;
+  readonly data: unknown;
+}
+/** Where a model step starts or ends, for multi-step tool loops. */
+interface AiStepPart extends PartBase {
+  readonly type: "step";
+  readonly boundary: "start" | "finish";
+  readonly stepId?: string;
+}
+/**
+ * A part of a canonical message. Adapters map their SDK's parts onto these;
+ * a part with no counterpart becomes a `data` part rather than being lost.
+ */
+type AiMessagePart = AiTextPart | AiReasoningPart | AiFilePart | AiToolCallPart | AiToolResultPart | AiToolApprovalPart | AiSourcePart | AiDataPart | AiStepPart;
+type AiMessagePartType = AiMessagePart["type"];
+type AiMessageRole = "system" | "user" | "assistant" | "tool";
+/** A message in the SDK-neutral format `ai_messages.parts` stores (version 1). */
+interface AiMessage {
+  readonly id: string;
+  readonly role: AiMessageRole;
+  readonly parts: readonly AiMessagePart[];
+  readonly metadata?: Readonly<Record<string, unknown>>;
+}
+declare const AI_MESSAGE_PART_TYPES: readonly AiMessagePartType[];
+/**
+ * A Standard Schema for `AiMessage`, matching `schemas/ai-message-v1.json`.
+ * Pass it to `validate()` or any library that takes a Standard Schema.
+ */
+declare const aiMessageSchema: StandardSchemaV1<unknown, AiMessage>;
+/** Whether `value` is a canonical message, without collecting the issues. */
+declare function isAiMessage(value: unknown): value is AiMessage;
+//#endregion
+export { isAiMessage as _, AiMessage as a, AiMessageRole as c, AiStepPart as d, AiTextPart as f, aiMessageSchema as g, AiToolResultPart as h, AiFilePart as i, AiReasoningPart as l, AiToolCallPart as m, AI_MESSAGE_SCHEMA_ID as n, AiMessagePart as o, AiToolApprovalPart as p, AiDataPart as r, AiMessagePartType as s, AI_MESSAGE_PART_TYPES as t, AiSourcePart as u };