better-supabase 0.7.1 → 0.9.0

package/dist/openapi/index.js

@@ -1,355 +1,33 @@
-import { n as PROBLEM_TYPE_BASE, t as PROBLEM_CONTENT_TYPE } from "../problem-BreOl8b8.js";
-import { t as SPEC_PINS } from "../spec-pins--j6mTok4.js";
-import { t as buildJsonSchema } from "../json-schema-CvER4kgT.js";
+import { a as toOpenApi30Schema, n as openapiFormat, r as OPENAPI_33_PREVIEW_VERSION, t as defineApi } from "../api-CFjuYKFY.js";
+import { o as PROBLEM_SCHEMA } from "../build-Cm0T5MVG.js";
 //#region src/openapi/index.ts
-/** JSON Schema for RFC 9457 Problem Details as better-supabase sends them. */
-const PROBLEM_SCHEMA = {
-	type: "object",
-	required: [
-		"type",
-		"title",
-		"status"
-	],
-	properties: {
-		type: {
-			type: "string",
-			format: "uri-reference",
-			examples: [`${PROBLEM_TYPE_BASE}not-found`]
-		},
-		title: { type: "string" },
-		status: {
-			type: "integer",
-			minimum: 100,
-			maximum: 599
-		},
-		detail: { type: "string" },
-		instance: { type: "string" },
-		kind: { type: "string" },
-		code: { type: "string" },
-		hint: { type: "string" },
-		constraint: { type: "string" },
-		column: { type: "string" },
-		columns: {
-			type: "array",
-			items: { type: "string" }
-		},
-		issues: {
-			type: "array",
-			items: {
-				type: "object",
-				required: ["message"],
-				properties: {
-					message: { type: "string" },
-					path: {
-						type: "array",
-						items: { type: ["string", "integer"] }
-					}
-				}
-			}
-		}
-	}
-};
-const ERRORS = [
-	[
-		"BadRequest",
-		400,
-		"The request is invalid."
-	],
-	[
-		"Unauthorized",
-		401,
-		"Missing or invalid credentials."
-	],
-	[
-		"Forbidden",
-		403,
-		"Row-level security or a plugin denied the request."
-	],
-	[
-		"NotFound",
-		404,
-		"No row matches."
-	],
-	[
-		"Conflict",
-		409,
-		"A unique or foreign key constraint failed."
-	],
-	[
-		"Unprocessable",
-		422,
-		"Validation or a check constraint failed."
-	]
-];
-const pascal = (value) => value.replaceAll(/(^|[_-])(\w)/g, (_, _sep, char) => char.toUpperCase());
-const ref = (name) => ({ $ref: `#/components/schemas/${name}` });
-const response = (name) => ({ $ref: `#/components/responses/${name}` });
-function errorResponses(codes) {
-	const out = {};
-	for (const [name, status] of ERRORS) if (codes.includes(status)) out[String(status)] = response(name);
-	return out;
-}
-function jsonBody(schema, description) {
-	return {
-		description,
-		content: { "application/json": { schema } }
-	};
-}
-function pageParameters(cursor, maxPageSize) {
-	return [cursor ? {
-		name: "after",
-		in: "query",
-		required: false,
-		description: "`nextCursor` of the previous page. Leave it out for the first page.",
-		schema: { type: "string" }
-	} : {
-		name: "page",
-		in: "query",
-		required: false,
-		description: "1-based page number.",
-		schema: {
-			type: "integer",
-			minimum: 1,
-			default: 1
-		}
-	}, {
-		name: "size",
-		in: "query",
-		required: false,
-		description: "Page size.",
-		schema: {
-			type: "integer",
-			minimum: 1,
-			maximum: maxPageSize,
-			default: 50
-		}
-	}];
-}
-function pageSchema(row, cursor) {
-	const items = {
-		type: "array",
-		items: row
-	};
-	return cursor ? {
-		type: "object",
-		required: [
-			"items",
-			"nextCursor",
-			"hasMore"
-		],
-		properties: {
-			items,
-			nextCursor: { type: ["string", "null"] },
-			hasMore: { type: "boolean" }
-		}
-	} : {
-		type: "object",
-		required: ["items", "page"],
-		properties: {
-			items,
-			page: {
-				type: "object",
-				required: [
-					"number",
-					"size",
-					"total",
-					"pages",
-					"hasMore"
-				],
-				properties: {
-					number: { type: "integer" },
-					size: { type: "integer" },
-					total: { type: ["integer", "null"] },
-					pages: { type: ["integer", "null"] },
-					hasMore: { type: "boolean" }
-				}
-			}
-		}
-	};
-}
 /**
-* An OpenAPI 3.1 document for REST resources over your tables, with schemas
+* An OpenAPI document for REST resources over your tables, with schemas
 * from the generated metadata, list-query parameters, Supabase security
-* schemes and Problem Details errors.
+* schemes and Problem Details errors. Throws when building or checking the
+* document finds an error; use `defineApi` to read every finding instead.
 *
 * ```ts
 * const doc = createOpenApi(betterSupabase, {
-*   info: { title: 'CRM API', version: '1.0.0' },
-*   resources: { customers: { list: customerList }, notes: { operations: ['list', 'get'] } },
+*   info: { title: "CRM API", version: "1.0.0" },
+*   resources: { customers: { list: customerList }, notes: { operations: ["list", "get"] } },
 * });
 * ```
 */
 function createOpenApi(betterSupabase, options) {
-	const defs = buildJsonSchema({
-		meta: betterSupabase.meta,
-		config: { json: options.json ?? {} }
-	})["$defs"];
-	const schemas = { Problem: PROBLEM_SCHEMA };
-	const paths = {};
-	const tags = [];
-	const base = (options.basePath ?? "").replace(/\/$/, "");
-	const security = options.security ?? ["bearer"];
-	for (const [key, raw] of Object.entries(options.resources)) {
-		const table = betterSupabase.meta.tables[key];
-		if (!table) throw new TypeError(`createOpenApi: unknown table "${key}"`);
-		const resource = raw === true ? {} : raw;
-		const operations = resource.operations ?? (table.kind === "view" ? ["list", "get"] : [
-			"list",
-			"get",
-			"create",
-			"update",
-			"delete"
-		]);
-		const name = pascal(key);
-		const tag = resource.tag ?? key;
-		if (!tags.some((entry) => entry.name === tag)) tags.push({
-			name: tag,
-			...resource.description ? { description: resource.description } : {}
-		});
-		const extensions = { "x-better-supabase-table": `${table.schema}.${table.name}` };
-		for (const variant of [
-			"Row",
-			"Insert",
-			"Update"
-		]) {
-			const schema = defs[`${key}${variant}`];
-			if (schema) schemas[`${name}${variant}`] = schema;
-		}
-		const cursor = (resource.list ? resource.list.pagination : resource.pagination) === "cursor";
-		schemas[`${name}Page`] = pageSchema(ref(`${name}Row`), cursor);
-		const collection = `${base}${resource.path ?? `/${key}`}`;
-		const keyColumn = table.primaryKey.length === 1 ? table.primaryKey[0] : void 0;
-		const idSchema = keyColumn ? (defs[`${key}Row`]?.["properties"])?.[keyColumn] ?? { type: "string" } : void 0;
-		const item = keyColumn ? `${collection}/{${keyColumn}}` : void 0;
-		const idParameter = keyColumn ? [{
-			name: keyColumn,
-			in: "path",
-			required: true,
-			schema: idSchema
-		}] : [];
-		const op = (operation, summary, body) => ({
-			operationId: `${operation}${name}`,
-			tags: [tag],
-			summary,
-			...extensions,
-			"x-better-supabase-operation": operation,
-			...body
-		});
-		for (const operation of operations) switch (operation) {
-			case "list":
-				(paths[collection] ??= {})["get"] = op("list", `List ${key}`, {
-					parameters: resource.list?.openapi ?? pageParameters(cursor, resource.maxPageSize ?? 200),
-					responses: {
-						"200": jsonBody(ref(`${name}Page`), `A page of ${key}.`),
-						...errorResponses([
-							400,
-							401,
-							403
-						])
-					}
-				});
-				break;
-			case "create":
-				(paths[collection] ??= {})["post"] = op("create", `Create a ${key} row`, {
-					requestBody: {
-						required: true,
-						content: { "application/json": { schema: ref(`${name}Insert`) } }
-					},
-					responses: {
-						"201": jsonBody(ref(`${name}Row`), "Created."),
-						...errorResponses([
-							400,
-							401,
-							403,
-							409,
-							422
-						])
-					}
-				});
-				break;
-			case "get":
-			case "update":
-			case "delete": {
-				if (!item) break;
-				const path = paths[item] ??= { parameters: idParameter };
-				if (operation === "get") path["get"] = op("get", `Get a ${key} row`, { responses: {
-					"200": jsonBody(ref(`${name}Row`), "The row."),
-					...errorResponses([
-						401,
-						403,
-						404
-					])
-				} });
-				else if (operation === "update") path["patch"] = op("update", `Update a ${key} row`, {
-					requestBody: {
-						required: true,
-						content: { "application/json": { schema: ref(`${name}Update`) } }
-					},
-					responses: {
-						"200": jsonBody(ref(`${name}Row`), "Updated."),
-						...errorResponses([
-							400,
-							401,
-							403,
-							404,
-							409,
-							422
-						])
-					}
-				});
-				else path["delete"] = op("delete", `Delete a ${key} row`, { responses: {
-					"204": { description: "Deleted." },
-					...errorResponses([
-						401,
-						403,
-						404,
-						409
-					])
-				} });
-				break;
-			}
-			default: throw new TypeError(`createOpenApi: unknown operation "${String(operation)}"`);
-		}
-	}
-	const securitySchemes = {};
-	if (security.includes("bearer")) securitySchemes["supabaseJwt"] = {
-		type: "http",
-		scheme: "bearer",
-		bearerFormat: "JWT",
-		description: "A Supabase access token. Requests run as that user under row-level security."
-	};
-	if (security.includes("oauth2")) {
-		if (!options.supabaseUrl) throw new TypeError("createOpenApi: oauth2 security needs supabaseUrl");
-		const auth = `${options.supabaseUrl.replace(/\/$/, "")}/auth/v1`;
-		securitySchemes["supabaseOAuth"] = {
-			type: "oauth2",
-			description: "The Supabase OAuth 2.1 server.",
-			flows: { authorizationCode: {
-				authorizationUrl: `${auth}/oauth/authorize`,
-				tokenUrl: `${auth}/oauth/token`,
-				scopes: {}
-			} }
-		};
-	}
-	const responses = {};
-	for (const [name, , description] of ERRORS) responses[name] = {
-		description,
-		content: { [PROBLEM_CONTENT_TYPE]: { schema: ref("Problem") } }
-	};
-	return {
-		openapi: SPEC_PINS.openapi,
-		info: options.info,
-		jsonSchemaDialect: "https://json-schema.org/draft/2020-12/schema",
-		...options.servers ? { servers: options.servers } : {},
-		tags,
-		paths,
-		components: {
-			schemas,
-			responses,
-			securitySchemes
-		},
-		security: Object.keys(securitySchemes).map((name) => ({ [name]: [] }))
-	};
+	const { version, transform, overlays, onDiagnostic, ...apiOptions } = options;
+	const api = defineApi(betterSupabase, apiOptions);
+	const engine = options.applyOverlays;
+	const result = api.openapi({
+		...version === void 0 ? {} : { version },
+		...transform === void 0 ? {} : { transform },
+		...overlays === void 0 ? {} : { overlays },
+		...engine === void 0 ? {} : { applyOverlays: engine }
+	});
+	const errors = result.diagnostics.filter((diagnostic) => diagnostic.severity === "error");
+	if (errors.length > 0) throw new TypeError(`createOpenApi: ${errors.map((error) => `${error.code}: ${error.message}${error.pointer ? ` (${error.pointer})` : ""}`).join("; ")}`);
+	if (onDiagnostic) for (const diagnostic of result.diagnostics) onDiagnostic(diagnostic);
+	return result.document;
 }
 //#endregion
-export { PROBLEM_SCHEMA, createOpenApi };
+export { OPENAPI_33_PREVIEW_VERSION, PROBLEM_SCHEMA, createOpenApi, openapiFormat, toOpenApi30Schema };

package/dist/operations-C9-UcReN.d.ts

@@ -0,0 +1,6 @@
+import { r as AuthorizationOperation } from "./authorization-DpRfs6Wx.js";
+//#region src/core/operations.d.ts
+/** Operations by name, as `authorization.operations` or a module's own defaults. */
+type OperationTable = Readonly<Record<string, AuthorizationOperation>>;
+//#endregion
+export { OperationTable as t };

package/dist/operations-CsIfMED7.js

@@ -0,0 +1,29 @@
+//#region src/core/operations.ts
+/** The prefixes each module looks its operations up under. */
+const OPERATION_PREFIXES = {
+	workflowNode: "workflow.node.",
+	mcpTool: "mcp.tool.",
+	aiTool: "ai.tool.",
+	inboxCommand: "inbox.command."
+};
+/**
+* The permission operation `name` needs: the provider's entry first, then
+* `fallback` (the module's own key, already renamed through
+* `blocks.<module>.permissions`). `undefined` when neither names one,
+* which a caller treats as "no permission declared" and refuses unless the
+* operation is public by design.
+*/
+function operationPermission(operations, name, fallback) {
+	if (operations !== void 0 && Object.hasOwn(operations, name)) {
+		const permission = operations[name]?.permission;
+		if (typeof permission === "string" && permission !== "") return permission;
+	}
+	return fallback;
+}
+/** The operation `name`'s `meta`, from the provider's table. */
+function operationMeta(operations, name) {
+	if (operations === void 0 || !Object.hasOwn(operations, name)) return;
+	return operations[name]?.meta;
+}
+//#endregion
+export { operationMeta as n, operationPermission as r, OPERATION_PREFIXES as t };

package/dist/optional-peer-Dx8TaYXw.js

@@ -0,0 +1,29 @@
+//#region src/core/optional-peer.ts
+/**
+* Imports an optional peer package on first use, or resolves `undefined` when
+* it is not installed so the caller can say how to add it. The specifier is
+* a variable on purpose, and the bundler-ignore comments keep it a native
+* import in bundled apps: bundlers leave the peer out of apps that never reach
+* this call, and an app that externalizes the package resolves it at runtime.
+*/
+async function importOptionalPeer(specifier) {
+	try {
+		return await import(
+			/* webpackIgnore: true */
+			/* @vite-ignore */
+			specifier
+);
+	} catch {
+		return;
+	}
+}
+/** Runs `load` once and shares the promise. A rejection is not kept, so the next call tries again. */
+function memoized(load) {
+	let promise;
+	return () => promise ??= load().catch((cause) => {
+		promise = void 0;
+		throw cause;
+	});
+}
+//#endregion
+export { memoized as n, importOptionalPeer as t };

package/dist/options-B0FcEKtH.js

@@ -0,0 +1,5 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/state-machine/options.ts
+const stateMachineSqlOptions = blockOptions({ machines: option.unknown() });
+//#endregion
+export { stateMachineSqlOptions as t };

package/dist/options-B5BU2Yg7.js

@@ -0,0 +1,11 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/ai-files/options.ts
+const aiFilesSqlOptions = blockOptions({
+	bucket: option.string({ default: "ai-files" }),
+	maxSize: option.number(),
+	allowedMimeTypes: option.strings({ default: [] }),
+	pendingTtl: option.string({ default: "1 day" }),
+	extraColumns: option.unknown()
+});
+//#endregion
+export { aiFilesSqlOptions as t };

package/dist/options-B5woz53h.js

@@ -0,0 +1,5 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/saved-views/options.ts
+const savedViewsSqlOptions = blockOptions({ extraColumns: option.unknown() });
+//#endregion
+export { savedViewsSqlOptions as t };

package/dist/options-B7EJaOX-.js

@@ -0,0 +1,5 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/service-principals/options.ts
+const servicePrincipalsSqlOptions = blockOptions({ extraColumns: option.unknown() });
+//#endregion
+export { servicePrincipalsSqlOptions as t };

package/dist/options-B9q8CROT.js

@@ -0,0 +1,9 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/usage/options.ts
+const usageSqlOptions = blockOptions({
+	meters: option.unknown(),
+	history: option.boolean({ default: false }),
+	partitioned: option.boolean({ default: false })
+});
+//#endregion
+export { usageSqlOptions as t };

package/dist/options-BA6jV6py.js

@@ -0,0 +1,10 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/connectors/options.ts
+const connectorsSqlOptions = blockOptions({
+	allowHttp: option.boolean({ default: false }),
+	trustFirstUse: option.boolean({ default: true }),
+	sessionTtl: option.string({ default: "1 hour" }),
+	extraColumns: option.unknown()
+});
+//#endregion
+export { connectorsSqlOptions as t };

package/dist/options-BAW2ZlZ8.js

@@ -0,0 +1,8 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/engagements/options.ts
+const engagementsSqlOptions = blockOptions({
+	types: option.strings(),
+	extraColumns: option.unknown()
+});
+//#endregion
+export { engagementsSqlOptions as t };

package/dist/options-BMjcVuaI.js

@@ -0,0 +1,82 @@
+import { n as isRecord } from "./guards-6F2bCtQR.js";
+//#region src/blocks/options.ts
+function spec(kind, input = {}) {
+	return {
+		kind,
+		...input.default === void 0 ? {} : { default: input.default },
+		client: input.client ?? false
+	};
+}
+const option = {
+	string: (input) => spec("string", input),
+	boolean: (input) => spec("boolean", input),
+	number: (input) => spec("number", input),
+	strings: (input) => spec("strings", input),
+	unknown: (input) => spec("unknown", input)
+};
+function kindOf(value) {
+	if (typeof value === "string") return "string";
+	if (typeof value === "boolean") return "boolean";
+	if (typeof value === "number") return "number";
+	if (Array.isArray(value) && value.every((entry) => typeof entry === "string")) return "strings";
+}
+const KIND_LABEL = {
+	string: "a string",
+	boolean: "a boolean",
+	number: "a number",
+	strings: "a list of strings",
+	unknown: "a value"
+};
+/** Describes a SQL module's options, typed by `T` (`blocks.<module>.options`). */
+function blockOptions(options) {
+	const specs = options;
+	return {
+		specs,
+		"~standard": {
+			version: 1,
+			vendor: "better-supabase",
+			validate: (value) => {
+				if (!isRecord(value)) return { issues: [{ message: "Expected an object" }] };
+				const issues = [];
+				for (const [key, entry] of Object.entries(value)) {
+					const known = specs[key];
+					if (known === void 0) issues.push({
+						message: `Unknown option "${key}"`,
+						path: [key]
+					});
+					else if (known.kind !== "unknown" && entry !== void 0 && kindOf(entry) !== known.kind) issues.push({
+						message: `"${key}" must be ${KIND_LABEL[known.kind]}`,
+						path: [key]
+					});
+				}
+				if (issues.length > 0) return { issues };
+				return { value };
+			}
+		}
+	};
+}
+/** The options of a module that has none. */
+const NO_OPTIONS = blockOptions({});
+const JSON_KIND = {
+	string: { type: "string" },
+	boolean: { type: "boolean" },
+	number: { type: "number" },
+	strings: {
+		type: "array",
+		items: { type: "string" }
+	},
+	unknown: {}
+};
+/** The JSON Schema of a module's options, for `schemas/config-v1.json`. */
+function optionsJsonSchema(schema) {
+	return {
+		type: "object",
+		additionalProperties: false,
+		properties: Object.fromEntries(Object.entries(schema.specs).map(([key, entry]) => [key, entry.default === void 0 ? JSON_KIND[entry.kind] : {
+			...JSON_KIND[entry.kind],
+			default: entry.default
+		}]))
+	};
+}
+//#endregion
+export { optionsJsonSchema as i, blockOptions as n, option as r, NO_OPTIONS as t };

package/dist/options-BOOEzor9.js

@@ -0,0 +1,5 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/collections/options.ts
+const collectionsSqlOptions = blockOptions({ extraColumns: option.unknown() });
+//#endregion
+export { collectionsSqlOptions as t };

package/dist/options-BQ07tTYr.js

@@ -0,0 +1,11 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/shared-signals/methods.ts
+/** RFC 8935 push delivery, as SSF names it in `delivery.method`. */
+const SSF_PUSH = "urn:ietf:rfc:8935";
+/** RFC 8936 poll delivery. */
+const SSF_POLL = "urn:ietf:rfc:8936";
+//#endregion
+//#region src/blocks/shared-signals/options.ts
+const sharedSignalsSqlOptions = blockOptions({ retention: option.string({ default: "7 days" }) });
+//#endregion
+export { SSF_POLL as n, SSF_PUSH as r, sharedSignalsSqlOptions as t };

package/dist/options-BZsoPJGX.js

@@ -0,0 +1,5 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/promotions/options.ts
+const promotionsSqlOptions = blockOptions({ extraColumns: option.unknown() });
+//#endregion
+export { promotionsSqlOptions as t };

package/dist/options-BesyRBnM.js

@@ -0,0 +1,16 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/leave/options.ts
+const leaveSqlOptions = blockOptions({
+	policy: option.unknown(),
+	workingDays: option.strings({ default: [
+		"mon",
+		"tue",
+		"wed",
+		"thu",
+		"fri"
+	] }),
+	allowNegative: option.boolean({ default: false }),
+	extraColumns: option.unknown()
+});
+//#endregion
+export { leaveSqlOptions as t };

package/dist/options-Bf96aVk5.js

@@ -0,0 +1,10 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/memory/options.ts
+const memorySqlOptions = blockOptions({
+	dimensions: option.unknown(),
+	type: option.unknown(),
+	textSearch: option.unknown(),
+	maxContent: option.number({ default: 1e5 })
+});
+//#endregion
+export { memorySqlOptions as t };

package/dist/options-BlOPivzq.js

@@ -0,0 +1,8 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/ai-cache/options.ts
+const aiCacheSqlOptions = blockOptions({
+	maxTtl: option.number(),
+	maxBytes: option.number()
+});
+//#endregion
+export { aiCacheSqlOptions as t };

package/dist/options-Blg8lAkz.js

@@ -0,0 +1,9 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/sla/options.ts
+const slaSqlOptions = blockOptions({
+	businessHours: option.unknown(),
+	subjects: option.unknown(),
+	extraColumns: option.unknown()
+});
+//#endregion
+export { slaSqlOptions as t };

package/dist/options-Bn4cu0gt.js

@@ -0,0 +1,5 @@
+import { n as blockOptions, r as option } from "./options-BMjcVuaI.js";
+//#region src/blocks/number-sequences/options.ts
+const numberSequencesSqlOptions = blockOptions({ entities: option.unknown() });
+//#endregion
+export { numberSequencesSqlOptions as t };