better-supabase 0.8.0 → 0.9.0

package/dist/blocks/ai-chat/svelte/index.d.ts

@@ -0,0 +1,34 @@
+import { a as AiChatsActions, c as AiChatsSnapshot, d as AiModelsControllerOptions, f as AiModelsSnapshot, g as AiShareSnapshot, h as AiShareControllerOptions, i as AiChatTreeSnapshot, l as AiModelsActions, p as AiShareActions, r as AiChatTreeControllerOptions, s as AiChatsControllerOptions, t as AiChatTreeActions } from "../../../client-DdfSIZ3M.js";
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SvelteController } from "../../../svelte-controller-DxxHEHxD.js";
+//#region src/blocks/ai-chat/svelte/index.d.ts
+/**
+ * `createAiChatsController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useAiChats(options: BlockOptions<AiChatsControllerOptions>): SvelteController<AiChatsSnapshot, AiChatsActions>;
+/**
+ * `createAiChatTreeController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useAiChatTree(options: BlockOptions<AiChatTreeControllerOptions>): SvelteController<AiChatTreeSnapshot, AiChatTreeActions>;
+/**
+ * `createAiModelsController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useAiModels(options: BlockOptions<AiModelsControllerOptions>): SvelteController<AiModelsSnapshot, AiModelsActions>;
+/**
+ * `createAiShareController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useAiShare(options: BlockOptions<AiShareControllerOptions>): SvelteController<AiShareSnapshot, AiShareActions>;
+//#endregion
+export type { AiChatTreeActions, AiChatTreeControllerOptions, AiChatTreeSnapshot, AiChatsActions, AiChatsControllerOptions, AiChatsSnapshot, AiModelsActions, AiModelsControllerOptions, AiModelsSnapshot, AiShareActions, AiShareControllerOptions, AiShareSnapshot, BlockOptions, SvelteController };

package/dist/blocks/ai-chat/svelte/index.js

@@ -0,0 +1,41 @@
+import { t as useBlockController } from "../../../svelte-controller-CDAujo-_.js";
+import { i as createAiShareController, n as createAiChatsController, r as createAiModelsController, t as createAiChatTreeController } from "../../../client-BUGIS__1.js";
+//#region src/blocks/ai-chat/svelte/index.ts
+/**
+* `createAiChatsController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useAiChats(options) {
+	return useBlockController(createAiChatsController, options);
+}
+/**
+* `createAiChatTreeController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useAiChatTree(options) {
+	return useBlockController(createAiChatTreeController, options);
+}
+/**
+* `createAiModelsController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useAiModels(options) {
+	return useBlockController(createAiModelsController, options, false);
+}
+/**
+* `createAiShareController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useAiShare(options) {
+	return useBlockController(createAiShareController, options, false);
+}
+//#endregion
+export { useAiChatTree, useAiChats, useAiModels, useAiShare };

package/dist/blocks/ai-chat/vue/index.d.ts

@@ -0,0 +1,34 @@
+import { a as AiChatsActions, c as AiChatsSnapshot, d as AiModelsControllerOptions, f as AiModelsSnapshot, g as AiShareSnapshot, h as AiShareControllerOptions, i as AiChatTreeSnapshot, l as AiModelsActions, p as AiShareActions, r as AiChatTreeControllerOptions, s as AiChatsControllerOptions, t as AiChatTreeActions } from "../../../client-DdfSIZ3M.js";
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as VueController } from "../../../vue-controller-HPfMTDa2.js";
+//#region src/blocks/ai-chat/vue/index.d.ts
+/**
+ * `createAiChatsController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useAiChats(options: BlockOptions<AiChatsControllerOptions>): VueController<AiChatsSnapshot, AiChatsActions>;
+/**
+ * `createAiChatTreeController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useAiChatTree(options: BlockOptions<AiChatTreeControllerOptions>): VueController<AiChatTreeSnapshot, AiChatTreeActions>;
+/**
+ * `createAiModelsController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useAiModels(options: BlockOptions<AiModelsControllerOptions>): VueController<AiModelsSnapshot, AiModelsActions>;
+/**
+ * `createAiShareController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useAiShare(options: BlockOptions<AiShareControllerOptions>): VueController<AiShareSnapshot, AiShareActions>;
+//#endregion
+export type { AiChatTreeActions, AiChatTreeControllerOptions, AiChatTreeSnapshot, AiChatsActions, AiChatsControllerOptions, AiChatsSnapshot, AiModelsActions, AiModelsControllerOptions, AiModelsSnapshot, AiShareActions, AiShareControllerOptions, AiShareSnapshot, BlockOptions, VueController };

package/dist/blocks/ai-chat/vue/index.js

@@ -0,0 +1,41 @@
+import { t as useBlockController } from "../../../vue-controller-C9tFzqAc.js";
+import { i as createAiShareController, n as createAiChatsController, r as createAiModelsController, t as createAiChatTreeController } from "../../../client-BUGIS__1.js";
+//#region src/blocks/ai-chat/vue/index.ts
+/**
+* `createAiChatsController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function useAiChats(options) {
+	return useBlockController(createAiChatsController, options);
+}
+/**
+* `createAiChatTreeController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function useAiChatTree(options) {
+	return useBlockController(createAiChatTreeController, options);
+}
+/**
+* `createAiModelsController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function useAiModels(options) {
+	return useBlockController(createAiModelsController, options, false);
+}
+/**
+* `createAiShareController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function useAiShare(options) {
+	return useBlockController(createAiShareController, options, false);
+}
+//#endregion
+export { useAiChatTree, useAiChats, useAiModels, useAiShare };

package/dist/blocks/ai-files/index.d.ts

@@ -1,5 +1,8 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
-import { _ as NewAiFile, a as AiDocumentWithContent, c as AiFileSource, d as AiFileUpload, f as AiFiles, g as NewAiDocument, h as AiSuggestion, i as AiDocumentVersion, l as AiFileStatus, m as AiProviderFile, n as AiDocumentEdit, o as AiFile, p as AiFilesOptions, r as AiDocumentKind, s as AiFileBucket, t as AiDocument, u as AiFileStorage, v as StoredAiFile } from "../../types-Bb_4-vdW.js";
+import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
+import { _ as NewAiFile, a as AiDocumentWithContent, c as AiFileSource, d as AiFileUpload, f as AiFiles, g as NewAiDocument, h as AiSuggestion, i as AiDocumentVersion, l as AiFileStatus, m as AiProviderFile, n as AiDocumentEdit, o as AiFile, p as AiFilesOptions, r as AiDocumentKind, s as AiFileBucket, t as AiDocument, u as AiFileStorage, v as StoredAiFile } from "../../types-pNY_UpDs.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
 //#region src/blocks/ai-files/ai-files.d.ts
 /** The URL a message stores for a file: `supabase-storage://{bucket}/{path}`. */
 export declare function aiFileUrl(file: Pick<AiFile, "bucket" | "path">): string;
@@ -9,6 +12,10 @@ export declare function parseAiFileUrl(url: string | URL): {
   readonly path: string;
 } | undefined;
 /** Files and documents for AI chats, as the caller and as the service role. */
-export declare function createAiFiles(options: AiFilesOptions): AiFiles;
+export declare function createAiFiles<S extends StandardSchemaV1 | undefined = undefined>(options: AiFilesOptions<S>): AiFiles<FieldsOf<S>>;
+//#endregion
+//#region src/blocks/ai-files/manifest.d.ts
+/** The `ai-files` block's manifest (ADR 0029). */
+export declare const aiFilesBlock: BlockOf<"ai-files", typeof createAiFiles, Record<never, never>, Record<never, never>, "files">;
 //#endregion
 export { type AiDocument, type AiDocumentEdit, type AiDocumentKind, type AiDocumentVersion, type AiDocumentWithContent, type AiFile, type AiFileBucket, type AiFileSource, type AiFileStatus, type AiFileStorage, type AiFileUpload, type AiFiles, type AiFilesOptions, type AiProviderFile, type AiSuggestion, type BlockTransport, type NewAiDocument, type NewAiFile, type StoredAiFile, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/ai-files/index.js

@@ -1,3 +1,16 @@
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
-import { n as createAiFiles, r as parseAiFileUrl, t as aiFileUrl } from "../../ai-files-CioLu5du.js";
-export { aiFileUrl, createAiFiles, dbTransport, parseAiFileUrl, rpcTransport, sqlTransport };
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { n as createAiFiles, r as parseAiFileUrl, t as aiFileUrl } from "../../ai-files-D2_9YLjF.js";
+import { t as aiFilesSqlOptions } from "../../options-B5BU2Yg7.js";
+//#region src/blocks/ai-files/manifest.ts
+/** The `ai-files` block's manifest (ADR 0029). */
+const aiFilesBlock = defineBlock({
+	name: "ai-files",
+	sql: ["ai-files"],
+	options: { "ai-files": aiFilesSqlOptions },
+	provides: { files: (client) => client },
+	create: createAiFiles,
+	category: "ai"
+});
+//#endregion
+export { aiFileUrl, aiFilesBlock, createAiFiles, dbTransport, parseAiFileUrl, rpcTransport, sqlTransport };

package/dist/blocks/ai-providers/index.d.ts

@@ -1,7 +1,22 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
-import { a as AiBatchItemStatus, c as AiProviderKey, d as AiProvidersOptions, f as NewAiBatch, i as AiBatchItemInput, l as AiProviderKeyInput, n as AiBatchCounts, o as AiBatchPatch, p as ResolvedProviderKey, r as AiBatchItem, s as AiBatchStatus, t as AiBatch, u as AiProviders } from "../../types-CbOUc5IH.js";
+import { h as AiProviderKeyEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { a as AiBatchItemStatus, c as AiProviderKey, d as AiProvidersOptions, f as NewAiBatch, i as AiBatchItemInput, l as AiProviderKeyInput, n as AiBatchCounts, o as AiBatchPatch, p as ResolvedProviderKey, r as AiBatchItem, s as AiBatchStatus, t as AiBatch, u as AiProviders } from "../../types-D0W4fnsc.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
 //#region src/blocks/ai-providers/ai-providers.d.ts
 /** Per-tenant provider keys and provider batch jobs. */
 export declare function createAiProviders(options: AiProvidersOptions): AiProviders;
 //#endregion
-export { type AiBatch, type AiBatchCounts, type AiBatchItem, type AiBatchItemInput, type AiBatchItemStatus, type AiBatchPatch, type AiBatchStatus, type AiProviderKey, type AiProviderKeyInput, type AiProviders, type AiProvidersOptions, type BlockTransport, type NewAiBatch, type ResolvedProviderKey, dbTransport, rpcTransport, sqlTransport };
+//#region src/blocks/ai-providers/events.d.ts
+/** The events of the `ai-providers` block: type to data. */
+type AiProvidersEvents = {
+  readonly "ai_provider_key.saved": AiProviderKeyEventData;
+  readonly "ai_provider_key.deleted": AiProviderKeyEventData;
+};
+/** The `ai-providers` block's event types, for its manifest and `onBlockEvent`. */
+export declare const aiProvidersEvents: Events<AiProvidersEvents>;
+//#endregion
+//#region src/blocks/ai-providers/manifest.d.ts
+/** The `ai-providers` block's manifest (ADR 0029). */
+export declare const aiProvidersBlock: BlockOf<"ai-providers", typeof createAiProviders, AiProvidersEvents>;
+//#endregion
+export { type AiBatch, type AiBatchCounts, type AiBatchItem, type AiBatchItemInput, type AiBatchItemStatus, type AiBatchPatch, type AiBatchStatus, type AiProviderKey, type AiProviderKeyInput, type AiProviders, type AiProvidersEvents, type AiProvidersOptions, type BlockTransport, type NewAiBatch, type ResolvedProviderKey, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/ai-providers/index.js

@@ -1,10 +1,14 @@
-import { n as dbError } from "../../errors-2M6CKMP4.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-DEqHCMKP.js";
+import { n as dbError } from "../../errors-8i6tSICm.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-BlgnMB0H.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { n as credentialRefInTenant, r as foreignCredentialRef } from "../../provider-DxRTex4x.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
-import { C as recordOrEmpty, N as toInstant, S as recordOf, _ as optionalInstant, d as instantArg, g as oneOf, i as blockCall, j as textOf, n as applyTemporal, o as credentialRefOf, v as optionalText, w as recordsOf, y as pageOf } from "../../block-helpers-Cy3pB96I.js";
-import { n as revokeIfConfigured } from "../../compose-BHej1acw.js";
+import { n as credentialRefInTenant, r as foreignCredentialRef } from "../../provider-DKh2xFZb.js";
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { C as optionalText, D as recordOf, I as textOf, O as recordOrEmpty, S as optionalInstant, b as oneOf, h as instantOf, k as recordsOf, l as credentialRefOf, m as instantArg, n as applyTemporal, o as blockCall, w as pageOf } from "../../block-helpers-CfG_MvDR.js";
+import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { n as revokeIfConfigured } from "../../compose-Djntdacs.js";
+import { t as aiProvidersSqlOptions } from "../../options-MHhjOoWz.js";
 //#region src/blocks/ai-providers/rows.ts
 const BATCH_STATUSES = [
 	"pending",
@@ -18,7 +22,6 @@ const ITEM_STATUSES = [
 	"cancelled",
 	"expired"
 ];
-const instant = (value) => value instanceof Date ? toInstant(value) : toInstant(textOf(value));
 const numberOf = (value) => typeof value === "number" && Number.isFinite(value) ? value : 0;
 function refOf(value) {
 	const ref = credentialRefOf(value);
@@ -36,8 +39,8 @@ function keyOf(value) {
 		settings: recordOrEmpty(row["settings"]),
 		enabled: row["enabled"] !== false,
 		createdBy: optionalText(row["created_by"]),
-		createdAt: instant(row["created_at"]),
-		updatedAt: instant(row["updated_at"])
+		createdAt: instantOf(row["created_at"]),
+		updatedAt: instantOf(row["updated_at"])
 	};
 }
 function countsOf(value) {
@@ -70,8 +73,8 @@ function batchOf(value) {
 		nextPollAt: optionalInstant(row["next_poll_at"]),
 		expiresAt: optionalInstant(row["expires_at"]),
 		completedAt: optionalInstant(row["completed_at"]),
-		createdAt: instant(row["created_at"]),
-		updatedAt: instant(row["updated_at"])
+		createdAt: instantOf(row["created_at"]),
+		updatedAt: instantOf(row["updated_at"])
 	};
 }
 function itemOf(value) {
@@ -84,7 +87,7 @@ function itemOf(value) {
 		output: row["output"] ?? void 0,
 		usage: row["usage"] ?? void 0,
 		error: optionalText(row["error"]),
-		createdAt: instant(row["created_at"])
+		createdAt: instantOf(row["created_at"])
 	};
 }
 //#endregion
@@ -107,7 +110,7 @@ function createAiProviders(options) {
 		}
 		return ok(keys.length);
 	});
-	return {
+	return withBlockHooks({
 		keys: {
 			list: (organizationId) => call("list_ai_provider_keys", { tenant: organizationId }, (value) => recordsOf(value, "list_ai_provider_keys").map(keyOf)),
 			save: (organizationId, key) => call("save_ai_provider_key", {
@@ -206,7 +209,29 @@ function createAiProviders(options) {
 				})) }
 			}, (value) => Number(value ?? 0))
 		}
-	};
+	}, options.hooks, {
+		block: "ai-providers",
+		...options.logger ? { logger: options.logger } : {}
+	});
 }
 //#endregion
-export { createAiProviders, dbTransport, rpcTransport, sqlTransport };
+//#region src/blocks/ai-providers/events.ts
+/** The `ai-providers` block's event types, for its manifest and `onBlockEvent`. */
+const aiProvidersEvents = defineEvents({
+	"ai_provider_key.saved": event(),
+	"ai_provider_key.deleted": event()
+});
+//#endregion
+//#region src/blocks/ai-providers/manifest.ts
+/** The `ai-providers` block's manifest (ADR 0029). */
+const aiProvidersBlock = defineBlock({
+	name: "ai-providers",
+	sql: ["ai-providers"],
+	options: { "ai-providers": aiProvidersSqlOptions },
+	events: aiProvidersEvents,
+	create: createAiProviders,
+	category: "ai",
+	recipes: ["ai-provider-settings"]
+});
+//#endregion
+export { aiProvidersBlock, aiProvidersEvents, createAiProviders, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/ai-tasks/index.d.ts

@@ -1,3 +1,10 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
-import { a as AiTaskRunStatus, c as AiTasksOptions, i as AiTaskRun, l as NewAiTask, n as AiTaskFields, o as AiTaskRunner, r as AiTaskOutcome, s as AiTasks, t as AiTask, u as createAiTasks } from "../../ai-tasks-BRQ6iQLc.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { a as AiTaskRunStatus, c as AiTasksOptions, i as AiTaskRun, l as NewAiTask, n as AiTaskFields, o as AiTaskRunner, r as AiTaskOutcome, s as AiTasks, t as AiTask, u as createAiTasks } from "../../ai-tasks-Ih5oHfyj.js";
+//#region src/blocks/ai-tasks/manifest.d.ts
+/** The `ai-tasks` block's manifest (ADR 0029). */
+export declare const aiTasksBlock: BlockOf<"ai-tasks", typeof createAiTasks, Record<never, never>, {
+  readonly notifier: "optional";
+}>;
+//#endregion
 export { type AiTask, type AiTaskFields, type AiTaskOutcome, type AiTaskRun, type AiTaskRunStatus, type AiTaskRunner, type AiTasks, type AiTasksOptions, type BlockTransport, type NewAiTask, createAiTasks, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/ai-tasks/index.js

@@ -1,12 +1,16 @@
 import { t as DbException } from "../../db-exception-CnWcYPxL.js";
-import { n as dbError } from "../../errors-2M6CKMP4.js";
-import { s as nowInstant } from "../../temporal-BJGitm-h.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-DEqHCMKP.js";
+import { n as dbError } from "../../errors-8i6tSICm.js";
+import { s as nowInstant } from "../../temporal-CB5Fpo5d.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-BlgnMB0H.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { n as nextCronRun, t as assertCron } from "../../cron-D25Ukpxy.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
-import { N as toInstant, S as recordOf, _ as optionalInstant, i as blockCall, j as textOf, l as errorText, n as applyTemporal, u as injectableOf, v as optionalText, w as recordsOf } from "../../block-helpers-Cy3pB96I.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { C as optionalText, D as recordOf, I as textOf, S as optionalInstant, f as errorText, h as instantOf, k as recordsOf, n as applyTemporal, o as blockCall, p as injectableOf } from "../../block-helpers-CfG_MvDR.js";
+import { n as nextCronRun, t as assertCron } from "../../cron-CUaKTjWC.js";
+import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { c as withFields, i as extraOf, n as blockFields, t as allWithFields } from "../../block-fields-ffD6Gxe4.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
 import { n as runStateOf } from "../../run-state-CgBKzYMW.js";
+import { t as aiTasksSqlOptions } from "../../options-C3EzJATk.js";
 //#region src/blocks/ai-tasks/ai-tasks.ts
 const STATUSES = [
 	"queued",
@@ -14,7 +18,6 @@ const STATUSES = [
 	"completed",
 	"failed"
 ];
-const instant = (value) => value instanceof Date ? toInstant(value) : toInstant(textOf(value));
 function runOf(value) {
 	const row = recordOf(value, "ai_task_runs");
 	return {
@@ -23,12 +26,12 @@ function runOf(value) {
 		organizationId: textOf(row["organization_id"]),
 		userId: textOf(row["user_id"]),
 		status: runStateOf(row["status"], STATUSES, "failed"),
-		scheduledFor: instant(row["scheduled_for"]),
+		scheduledFor: instantOf(row["scheduled_for"]),
 		chatId: optionalText(row["chat_id"]),
 		error: optionalText(row["error"]),
 		startedAt: optionalInstant(row["started_at"]),
 		finishedAt: optionalInstant(row["finished_at"]),
-		createdAt: instant(row["created_at"])
+		createdAt: instantOf(row["created_at"])
 	};
 }
 function taskOf(value) {
@@ -47,11 +50,20 @@ function taskOf(value) {
 		nextRunAt: optionalInstant(row["next_run_at"]),
 		lastRunAt: optionalInstant(row["last_run_at"]),
 		lastRun: isRecord(row["last_run"]) ? runOf(row["last_run"]) : void 0,
-		createdAt: instant(row["created_at"]),
-		updatedAt: instant(row["updated_at"])
+		createdAt: instantOf(row["created_at"]),
+		updatedAt: instantOf(row["updated_at"])
 	};
 }
 const invalid = (message) => dbError("invalid_input", message, { hint: "AI_TASK_INVALID" });
+const TASK_FIELDS = /* @__PURE__ */ new Set([
+	"title",
+	"prompt",
+	"cron",
+	"timezone",
+	"chatId",
+	"agentId",
+	"enabled"
+]);
 function fieldsArg(fields) {
 	const out = {};
 	if (fields.title !== void 0) out["title"] = fields.title;
@@ -62,10 +74,29 @@ function fieldsArg(fields) {
 	if (fields.agentId !== void 0) out["agent_id"] = fields.agentId;
 	return out;
 }
+/** Sends `notification` through `notifier` for each finished run. */
+function notifyThrough(options) {
+	const { notifier, notification } = options;
+	if (notifier === void 0 || notification === void 0) return;
+	return (outcome) => notifier.send(notification, {
+		recipients: [outcome.task.userId],
+		tenant: outcome.task.organizationId,
+		key: `ai-task-run:${outcome.run.id}`,
+		data: {
+			taskId: outcome.task.id,
+			runId: outcome.run.id,
+			ok: outcome.ok,
+			...outcome.error === void 0 ? {} : { error: outcome.error },
+			...outcome.chatId === void 0 ? {} : { chatId: outcome.chatId }
+		}
+	});
+}
 /** Prompts users schedule on a cron, and the scheduler that runs them. */
 function createAiTasks(options) {
 	applyTemporal(options);
+	const fields = blockFields(options.fields, "task fields");
 	injectableOf("ai-tasks runner", options.run);
+	const notify = options.notify ?? notifyThrough(options);
 	const call = blockCall(options.transport, options.schema, options.mappers);
 	const service = blockCall(options.service ?? options.transport, options.schema, options.mappers);
 	const now = options.now ?? nowInstant;
@@ -78,16 +109,19 @@ function createAiTasks(options) {
 			return err(invalid(errorText(cause)));
 		}
 	};
-	const save = (organizationId, taskId, fields, nextRunAt) => {
-		const args = fieldsArg(fields);
-		if (fields.enabled !== void 0) args["enabled"] = fields.enabled;
+	const save = (organizationId, taskId, task, nextRunAt) => AsyncResult.from(() => fields.write(extraOf(task, TASK_FIELDS))).andThen((extra) => {
+		const args = {
+			...extra,
+			...fieldsArg(task)
+		};
+		if (task.enabled !== void 0) args["enabled"] = task.enabled;
 		return call("save_ai_task", {
 			tenant: organizationId,
 			id: taskId,
 			fields: args,
 			next_run_at: nextRunAt?.toString()
-		}, taskOf).andThen((task) => scheduleNow(task));
-	};
+		}, (value) => value);
+	}).andThen((value) => withFields(fields, value, taskOf(value))).andThen((saved) => scheduleNow(saved));
 	const scheduleNow = (task) => {
 		if (options.service === void 0 || !task.enabled || task.nextRunAt !== void 0) return AsyncResult.ok(task);
 		const upcoming = next(task.cron, task.timezone);
@@ -156,10 +190,10 @@ function createAiTasks(options) {
 			chat_id: outcome.chatId
 		}, (done) => done === true);
 		if (!finished.ok) return finished;
-		await options.notify?.(outcome);
+		await notify?.(outcome);
 		return ok(true);
 	}));
-	return {
+	return withBlockHooks({
 		create: (organizationId, task) => schedule(task, task.timezone).andThen((nextRunAt) => save(organizationId, void 0, task, nextRunAt)),
 		update: (organizationId, taskId, fields) => schedule(fields, fields.timezone).andThen((nextRunAt) => save(organizationId, taskId, fields, nextRunAt)),
 		pause: (organizationId, taskId) => save(organizationId, taskId, { enabled: false }, void 0),
@@ -168,7 +202,7 @@ function createAiTasks(options) {
 		list: (organizationId, listOptions = {}) => call("list_ai_tasks", {
 			tenant: organizationId,
 			mine: listOptions.all !== true
-		}, (value) => recordsOf(value, "list_ai_tasks").map(taskOf)),
+		}, (value) => recordsOf(value, "list_ai_tasks").map((raw) => [raw, taskOf(raw)])).andThen((rows) => allWithFields(fields, rows)),
 		runs: (taskId, runsOptions = {}) => call("list_ai_task_runs", {
 			task_id: taskId,
 			max_rows: runsOptions.limit
@@ -198,7 +232,22 @@ function createAiTasks(options) {
 				details: `${failures.length} of ${runs.length} runs failed: ${failures.map((failure) => `${failure.runId} (${failure.error.message})`).join(", ")}`
 			});
 		}))
-	};
+	}, options.hooks, {
+		block: "ai-tasks",
+		...options.logger ? { logger: options.logger } : {}
+	});
 }
 //#endregion
-export { createAiTasks, dbTransport, rpcTransport, sqlTransport };
+//#region src/blocks/ai-tasks/manifest.ts
+/** The `ai-tasks` block's manifest (ADR 0029). */
+const aiTasksBlock = defineBlock({
+	name: "ai-tasks",
+	sql: ["ai-tasks"],
+	options: { "ai-tasks": aiTasksSqlOptions },
+	consumes: { notifier: "optional" },
+	create: createAiTasks,
+	category: "ai",
+	recipes: ["ai-task-queue"]
+});
+//#endregion
+export { aiTasksBlock, createAiTasks, dbTransport, rpcTransport, sqlTransport };

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

@@ -1,3 +1,18 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
-import { a as Announcements, c as createAnnouncements, i as AnnouncementSeverity, n as AnnouncementAudience, o as AnnouncementsOptions, r as AnnouncementInput, s as ManagedAnnouncement, t as Announcement } from "../../announcements-Bouy0Ski.js";
-export { type Announcement, type AnnouncementAudience, type AnnouncementInput, type AnnouncementSeverity, type Announcements, type AnnouncementsOptions, type BlockTransport, type ManagedAnnouncement, createAnnouncements, dbTransport, rpcTransport, sqlTransport };
+import { _ as AnnouncementEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { a as createAnnouncementsController, c as AnnouncementInput, d as AnnouncementsOptions, f as ManagedAnnouncement, i as AnnouncementsSnapshot, l as AnnouncementSeverity, n as AnnouncementsController, o as Announcement, p as createAnnouncements, r as AnnouncementsControllerOptions, s as AnnouncementAudience, t as AnnouncementsActions, u as Announcements } from "../../client-BAcILZOf.js";
+//#region src/blocks/announcements/events.d.ts
+/** The events of the `announcements` block: type to data. */
+type AnnouncementsEvents = {
+  readonly "announcement.saved": AnnouncementEventData;
+  readonly "announcement.deleted": AnnouncementEventData;
+};
+/** The `announcements` block's event types, for its manifest and `onBlockEvent`. */
+export declare const announcementsEvents: Events<AnnouncementsEvents>;
+//#endregion
+//#region src/blocks/announcements/manifest.d.ts
+/** The `announcements` block's manifest (ADR 0029). */
+export declare const announcementsBlock: BlockOf<"announcements", typeof createAnnouncements, AnnouncementsEvents>;
+//#endregion
+export { type Announcement, type AnnouncementAudience, type AnnouncementInput, type AnnouncementSeverity, type Announcements, type AnnouncementsActions, type AnnouncementsController, type AnnouncementsControllerOptions, type AnnouncementsEvents, type AnnouncementsOptions, type AnnouncementsSnapshot, type BlockTransport, type ManagedAnnouncement, createAnnouncements, createAnnouncementsController, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/announcements/index.js

@@ -1,3 +1,27 @@
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
-import { t as createAnnouncements } from "../../announcements-p_BFofiR.js";
-export { createAnnouncements, dbTransport, rpcTransport, sqlTransport };
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as createAnnouncements } from "../../announcements-BHCzraR6.js";
+import { t as createAnnouncementsController } from "../../client-DNq8xYb-.js";
+import { t as announcementsSqlOptions } from "../../options-oeAq4Ho5.js";
+//#region src/blocks/announcements/events.ts
+/** The `announcements` block's event types, for its manifest and `onBlockEvent`. */
+const announcementsEvents = defineEvents({
+	"announcement.saved": event(),
+	"announcement.deleted": event()
+});
+//#endregion
+//#region src/blocks/announcements/manifest.ts
+/** The `announcements` block's manifest (ADR 0029). */
+const announcementsBlock = defineBlock({
+	name: "announcements",
+	sql: ["announcements"],
+	options: { announcements: announcementsSqlOptions },
+	events: announcementsEvents,
+	create: createAnnouncements,
+	client: "announcements",
+	category: "growth",
+	recipes: ["announcement-banner"]
+});
+//#endregion
+export { announcementsBlock, announcementsEvents, createAnnouncements, createAnnouncementsController, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/announcements/react/index.d.ts

@@ -1,24 +1,14 @@
-import { b as DbError } from "../../../result-BchM1XZn.js";
-import { x as SubscriptionStatus } from "../../../index-BCHR4Ucl.js";
-import { t as Announcement } from "../../../announcements-Bouy0Ski.js";
+import { i as AnnouncementsSnapshot, t as AnnouncementsActions } from "../../../client-BAcILZOf.js";
 //#region src/blocks/announcements/react/index.d.ts
 export interface UseAnnouncementsOptions {
   /** The active tenant, for tenant, role and plan audiences. */
   readonly organizationId?: string | null;
-  /** The topic the module broadcasts to (`sql.modules.announcements.options.topic`); `null` loads once. */
+  /** The topic the module broadcasts to (`blockConfig.announcements.options.topic` from `blocks.generated.ts`); `null` loads once. */
   readonly topic?: string | null;
-  /** The schema the calls go to: the module schema (default `better_supabase`), or the API schema from `sql.modules.<module>.api`. */
+  /** The schema the calls go to: the module schema (default `better_supabase`), or the API schema from `blocks.<module>.api`. */
   readonly schema?: string;
 }
-export interface AnnouncementsState {
-  /** `undefined` until the first load. */
-  readonly items: readonly Announcement[] | undefined;
-  readonly status: SubscriptionStatus;
-  readonly error: DbError | undefined;
-  /** Hides one for the user, then drops it from `items`. */
-  readonly dismiss: (announcementId: string) => Promise<void>;
-  readonly refresh: () => Promise<void>;
-}
+export interface AnnouncementsState extends AnnouncementsSnapshot, AnnouncementsActions {}
 /**
  * The signed-in user's live announcements, loaded again whenever staff
  * publish, change or remove one.