better-supabase 0.9.0 → 0.10.0

package/dist/blocks/entitlements/vue/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as VueController } from "../../../vue-controller-HPfMTDa2.js";
-import { i as FeatureGateSnapshot, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../../client-BVZtq_rQ.js";
+import { t as VueController } from "../../../vue-controller-D_ohttBZ.js";
+import { i as FeatureGateSnapshot, r as FeatureGateControllerOptions, t as FeatureGateActions } from "../../../client-Dk8gY9hi.js";
 //#region src/blocks/entitlements/vue/index.d.ts
 /**
  * `createFeatureGateController` as a Vue composable: `state` is a shallow ref

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

@@ -1,12 +1,12 @@
 import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
-import { wt as Events, z as FlagEventData } from "../../events-CTreRrgP.js";
+import { wt as Events, z as FlagEventData } from "../../events-CtAHxPal.js";
 import { n as Logger } from "../../logger-DWVYUmwi.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 { n as BlockHooks } from "../../block-hooks-BLPWD3Jt.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { n as BlockHooks } from "../../block-hooks-C_WaodoA.js";
 import { r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
-import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
-import { C as flagDefinitionsOf, S as flagContext, _ as RequestFlagContext, a as FlagDefinition, b as evaluateFlag, c as FlagEvaluation, d as FlagResolution, f as FlagRule, g as FlagsProviderOptions, h as FlagsProvider, i as FlagContextSource, l as FlagOverride, m as FlagValue, n as FlagContext, o as FlagDetails, p as FlagType, r as FlagContextOptions, s as FlagErrorCode, t as FlagClient, u as FlagReason, v as createFlagClient, x as flagBucket, y as createFlagsProvider } from "../../flags-D_D1jAHB.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
+import { C as flagDefinitionsOf, S as flagContext, _ as RequestFlagContext, a as FlagDefinition, b as evaluateFlag, c as FlagEvaluation, d as FlagResolution, f as FlagRule, g as FlagsProviderOptions, h as FlagsProvider, i as FlagContextSource, l as FlagOverride, m as FlagValue, n as FlagContext, o as FlagDetails, p as FlagType, r as FlagContextOptions, s as FlagErrorCode, t as FlagClient, u as FlagReason, v as createFlagClient, x as flagBucket, y as createFlagsProvider } from "../../flags-Dz5PIzFU.js";
 //#region src/blocks/flags/admin.d.ts
 interface FlagsOptions<S extends StandardSchemaV1 | undefined = undefined> {
   /**

package/dist/blocks/flags/index.js

@@ -1,12 +1,12 @@
-import { a as ok, t as AsyncResult } from "../../result-BlgnMB0H.js";
+import { a as ok, t as AsyncResult } from "../../result-COkvI9t5.js";
+import { t as flagsSqlOptions } from "../../options-DDzggjN7.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 { o as blockCall } from "../../block-helpers-CfG_MvDR.js";
-import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
-import { n as blockFields } from "../../block-fields-ffD6Gxe4.js";
+import { o as blockCall } from "../../block-helpers-BfVCR5Fc.js";
+import { r as withBlockHooks } from "../../block-hooks-ByKlh8Qy.js";
+import { n as blockFields } from "../../block-fields-BANwJ9Y_.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { a as flagContext, i as flagBucket, n as createFlagsProvider, o as flagDefinitionsOf, r as evaluateFlag, t as createFlagClient } from "../../flags-XAOsdNAc.js";
-import { t as flagsSqlOptions } from "../../options-DDzggjN7.js";
+import { a as flagContext, i as flagBucket, n as createFlagsProvider, o as flagDefinitionsOf, r as evaluateFlag, t as createFlagClient } from "../../flags-CtSrkVuW.js";
 //#region src/blocks/flags/admin.ts
 const rowOf = (input, fields) => {
 	const row = {};

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

@@ -1,15 +1,15 @@
 /// <reference lib="esnext.temporal" />
 import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
-import { B as FormEventData, V as FormSubmissionEventData, it as SignatureEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { B as FormEventData, V as FormSubmissionEventData, it as SignatureEventData, wt as Events } from "../../events-CtAHxPal.js";
 import { n as Logger } from "../../logger-DWVYUmwi.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 { n as BlockOptions, r as BlockTemporalOptions } from "../../block-helpers-C86hPEjI.js";
-import { n as BlockHooks } from "../../block-hooks-BLPWD3Jt.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { n as BlockOptions, r as BlockTemporalOptions } from "../../block-helpers-7pMBVsE6.js";
+import { n as BlockHooks } from "../../block-hooks-C_WaodoA.js";
 import { n as ExtraFields, r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
-import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
 import { a as FormDefinition, c as FormJson, d as FormStep, f as formDefinitionProblems, i as FormCondition, l as FormJsonSchema, m as isFormDefinition, n as FORM_FIELD_TYPES, o as FormField, p as formSchema, r as FORM_SCHEMA_DIALECT, s as FormFieldType, t as FORM_DEFINITION_SCHEMA, u as FormOption } from "../../form-definition-sagoefQr.js";
-import { _ as visibleFields, a as createQuestionnaireController, b as answersSchema, c as QuestionnaireState, d as finishQuestionnaire, f as initialQuestionnaire, g as stepIssues, h as questionnaireSteps, i as QuestionnaireSnapshot, l as QuestionnaireStepView, m as questionnaireReducer, n as QuestionnaireController, o as QuestionnaireAction, p as pruneAnswers, r as QuestionnaireOptions, s as QuestionnaireForm, t as QuestionnaireActions, u as conditionHolds, v as visibleSteps, x as validateAnswers, y as FormAnswers } from "../../client-WHeWTNVL.js";
+import { _ as visibleFields, a as createQuestionnaireController, b as answersSchema, c as QuestionnaireState, d as finishQuestionnaire, f as initialQuestionnaire, g as stepIssues, h as questionnaireSteps, i as QuestionnaireSnapshot, l as QuestionnaireStepView, m as questionnaireReducer, n as QuestionnaireController, o as QuestionnaireAction, p as pruneAnswers, r as QuestionnaireOptions, s as QuestionnaireForm, t as QuestionnaireActions, u as conditionHolds, v as visibleSteps, x as validateAnswers, y as FormAnswers } from "../../client-DR_YEGnc.js";
 //#region src/blocks/forms/forms.d.ts
 interface FormsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
   readonly transport: BlockTransport;

package/dist/blocks/forms/index.js

@@ -1,12 +1,12 @@
-import { a as ok, t as AsyncResult } from "../../result-BlgnMB0H.js";
+import { a as ok, t as AsyncResult } from "../../result-COkvI9t5.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { a as formDefinitionProblems, c as formsSqlOptions, i as FORM_SCHEMA_DIALECT, l as signaturesSqlOptions, n as FORM_FIELD_TYPES, o as formSchema, s as isFormDefinition, t as FORM_DEFINITION_SCHEMA } from "../../form-definition-GVZTILhS.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 { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, O as recordOrEmpty, S as optionalInstant, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
-import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
-import { n as blockFields } from "../../block-fields-ffD6Gxe4.js";
+import { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, O as recordOrEmpty, S as optionalInstant, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-BfVCR5Fc.js";
+import { r as withBlockHooks } from "../../block-hooks-ByKlh8Qy.js";
+import { n as blockFields } from "../../block-fields-BANwJ9Y_.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { c as formSchema, i as FORM_FIELD_TYPES, l as isFormDefinition, n as signaturesSqlOptions, o as FORM_SCHEMA_DIALECT, r as FORM_DEFINITION_SCHEMA, s as formDefinitionProblems, t as formsSqlOptions } from "../../options-BqO9GYig.js";
 import { a as pruneAnswers, c as stepIssues, d as answersSchema, f as validateAnswers, i as initialQuestionnaire, l as visibleFields, n as conditionHolds, o as questionnaireReducer, r as finishQuestionnaire, s as questionnaireSteps, t as createQuestionnaireController, u as visibleSteps } from "../../client-pxjbgOz6.js";
 //#region src/blocks/forms/forms.ts
 const FORM_STATUSES = [

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

@@ -1,4 +1,4 @@
-import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-WHeWTNVL.js";
+import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-DR_YEGnc.js";
 //#region src/blocks/forms/react/index.d.ts
 export type UseQuestionnaireOptions = QuestionnaireOptions;
 export interface QuestionnaireView extends QuestionnaireSnapshot, QuestionnaireActions {}

package/dist/blocks/forms/solid/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as SolidController } from "../../../solid-controller-DqlvYFZa.js";
-import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-WHeWTNVL.js";
+import { t as SolidController } from "../../../solid-controller-CZrt1Tg6.js";
+import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-DR_YEGnc.js";
 //#region src/blocks/forms/solid/index.d.ts
 /**
  * `createQuestionnaireController` as a Solid primitive: `state()` reads the

package/dist/blocks/forms/svelte/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as SvelteController } from "../../../svelte-controller-DxxHEHxD.js";
-import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-WHeWTNVL.js";
+import { t as SvelteController } from "../../../svelte-controller-DDbju9CW.js";
+import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-DR_YEGnc.js";
 //#region src/blocks/forms/svelte/index.d.ts
 /**
  * `createQuestionnaireController` as a Svelte readable store of the snapshot,

package/dist/blocks/forms/vue/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as VueController } from "../../../vue-controller-HPfMTDa2.js";
-import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-WHeWTNVL.js";
+import { t as VueController } from "../../../vue-controller-D_ohttBZ.js";
+import { i as QuestionnaireSnapshot, r as QuestionnaireOptions, t as QuestionnaireActions } from "../../../client-DR_YEGnc.js";
 //#region src/blocks/forms/vue/index.d.ts
 /**
  * `createQuestionnaireController` as a Vue composable: `state` is a shallow ref

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

@@ -1,14 +1,14 @@
 /// <reference lib="esnext.temporal" />
 import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
-import { wt as Events } from "../../events-CTreRrgP.js";
-import { f as ApplicationEventData, y as JobEventData } from "../../index-BlqrGvb3.js";
+import { wt as Events } from "../../events-CtAHxPal.js";
+import { f as ApplicationEventData, y as JobEventData } from "../../index-DL8z_oDo.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
 import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-C86hPEjI.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-BLPWD3Jt.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-7pMBVsE6.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-C_WaodoA.js";
 import { r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
-import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
 //#region src/blocks/hiring/hiring.d.ts
 type JobStatus = "draft" | "open" | "closed";
 type ApplicationState = "active" | "hired" | "rejected" | "withdrawn";

package/dist/blocks/hiring/index.js

@@ -1,13 +1,13 @@
-import { t as AsyncResult } from "../../result-BlgnMB0H.js";
+import { t as AsyncResult } from "../../result-COkvI9t5.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { t as hiringSqlOptions } from "../../options-D2Gd6VfS.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 { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, S as optionalInstant, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
-import { n as blockFields } from "../../block-fields-ffD6Gxe4.js";
+import { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, S as optionalInstant, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-BfVCR5Fc.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-ByKlh8Qy.js";
+import { n as blockFields } from "../../block-fields-BANwJ9Y_.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { i as refOf, n as compact } from "../../sales-shared-SblIgCgI.js";
-import { t as hiringSqlOptions } from "../../options-D2Gd6VfS.js";
+import { i as refOf, n as compact } from "../../sales-shared-DjCuN8xG.js";
 //#region src/blocks/hiring/hiring.ts
 const JOB_STATUSES = [
 	"draft",

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

@@ -1,11 +1,11 @@
 /// <reference lib="esnext.temporal" />
 import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-C86hPEjI.js";
-import { n as BlockHooks } from "../../block-hooks-BLPWD3Jt.js";
-import { d as IdentityRef, f as IdentityTarget, p as PrincipalByIdentity } from "../../authorization-hooks-DkmrnDX7.js";
-import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-7pMBVsE6.js";
+import { n as BlockHooks } from "../../block-hooks-C_WaodoA.js";
+import { d as IdentityRef, f as IdentityTarget, p as PrincipalByIdentity } from "../../authorization-hooks-Do5djkpz.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
 //#region src/blocks/identities/identities.d.ts
 interface IdentitiesOptions extends BlockTemporalOptions {
   /**

package/dist/blocks/identities/index.js

@@ -1,9 +1,9 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { t as identitiesSqlOptions } from "../../options-CXFz0xxS.js";
 import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
-import { A as requiredInstant, D as recordOf, I as textOf, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall, y as nullableText } from "../../block-helpers-CfG_MvDR.js";
-import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { A as requiredInstant, D as recordOf, I as textOf, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall, y as nullableText } from "../../block-helpers-BfVCR5Fc.js";
+import { r as withBlockHooks } from "../../block-hooks-ByKlh8Qy.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { t as identitiesSqlOptions } from "../../options-CXFz0xxS.js";
 //#region src/blocks/identities/identities.ts
 const KINDS = ["email", "chat"];
 const SOURCES = ["link", "verified_email"];

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

@@ -1,9 +1,10 @@
 import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
-import { $ as SaasEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { B as TableMeta } from "../../types-BO8lVTun.js";
+import { $ as SaasEventData, wt as Events } from "../../events-CtAHxPal.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
-import { n as BlockHooks } from "../../block-hooks-BLPWD3Jt.js";
-import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { n as BlockHooks } from "../../block-hooks-C_WaodoA.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
 import { r as parseCsv } from "../../csv-D3eKxV1T.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/blocks/imports/define-import.d.ts
@@ -28,7 +29,7 @@ interface DryRunResult<T> {
   readonly rows: readonly T[];
   readonly errors: readonly ImportRowError[];
 }
-/** Registers an import. The jobs handler calls `insert` in batches. */
+/** Registers an import. `runImport` calls `insert` in batches. */
 export declare function defineImport<T>(definition: ImportDefinition<T>): ImportDefinition<T>;
 /**
  * Pairs CSV headers with import fields. A header matches a field when they
@@ -50,14 +51,81 @@ interface RunImportResult<T> {
 /**
  * Validates the file, skips rows whose key was already imported, inserts the
  * rest in batches and finishes the run as `import.completed` or `import.failed`.
+ * A batch that throws finishes the run as failed with the rows inserted so
+ * far, and the result says so instead of the error escaping.
  */
 export declare function runImport<T>(definition: ImportDefinition<T>, csv: string, mapping: Readonly<Record<string, string>>, hooks: {
   readonly organizationId: string;
   readonly importedKeys?: ReadonlySet<string>;
   readonly start: () => Promise<string>;
+  /** Marks the run `running` before the first batch (`mark_import_running`). */
+  readonly running?: (id: string) => Promise<void>;
   readonly finish: (id: string, status: "completed" | "failed", count: number, error: string | null) => Promise<void>;
 }): Promise<RunImportResult<T>>;
 //#endregion
+//#region src/blocks/imports/app-table-import.d.ts
+type Values = Readonly<Record<string, unknown>>;
+/**
+ * The repository methods an upsert import uses. A generated repository
+ * (`db.tasks`) fits it.
+ */
+interface AppTableImportRepository<T extends object, K extends Extract<keyof T, string>> {
+  readonly $meta: TableMeta;
+  findMany(args: {
+    readonly where: {
+      readonly OR: readonly Pick<T, K>[];
+    };
+  }): AsyncResult<readonly Values[]>;
+  upsertMany(rows: readonly T[], args: {
+    readonly onConflict: readonly K[];
+    readonly returning: false;
+  }): AsyncResult<unknown>;
+}
+/**
+ * How an import treats a row that already exists: `fill` writes only the
+ * fields that are empty in the database, `overwrite` writes every field
+ * the file has.
+ */
+type AppTableImportUpdate = "fill" | "overwrite";
+interface AppTableImportOptions<T extends object, K extends Extract<keyof T, string>> {
+  /** The app table's name, the import's `kind`. */
+  readonly table: string;
+  readonly columns: StandardSchemaV1<unknown, T>;
+  readonly repository: AppTableImportRepository<NoInfer<T>, NoInfer<K>>;
+  /** One of the table's unique sets (or its primary key) that finds an existing row. */
+  readonly key: readonly K[];
+  /** Defaults to `fill`. */
+  readonly update?: AppTableImportUpdate;
+}
+interface ImportPreview {
+  /** Rows the import inserts. */
+  readonly created: number;
+  /** Existing rows the import changes. */
+  readonly changed: number;
+  /** Existing rows the import leaves as they are. */
+  readonly unchanged: number;
+}
+/** An import that upserts into an app table; `runImport` and `previewImport` take it. */
+interface AppTableImport<T extends object> extends ImportDefinition<T> {
+  /** Counts the rows the import creates, changes and leaves; writes nothing. */
+  readonly preview: (rows: readonly T[]) => Promise<ImportPreview>;
+}
+/**
+ * An import that upserts rows into an app table on one of its unique sets.
+ * A row whose key exists updates that row (see `update`); the rest are
+ * inserted. Pass no `importedKeys` to `runImport`, so a rerun updates rows
+ * instead of skipping them.
+ */
+export declare function appTableImport<T extends object, K extends Extract<keyof T, string>>(options: AppTableImportOptions<T, K>): AppTableImport<T>;
+interface PreviewImportResult<T> extends DryRunResult<T> {
+  readonly preview: ImportPreview;
+}
+/**
+ * Validates the file like `dryRun`, then counts the valid rows the import
+ * would create, change and leave unchanged. Nothing is written.
+ */
+export declare function previewImport<T extends object>(definition: AppTableImport<T>, csv: string, mapping: Readonly<Record<string, string>>): Promise<PreviewImportResult<T>>;
+//#endregion
 //#region src/blocks/imports/imports.d.ts
 interface ImportsOptions {
   readonly transport: BlockTransport;
@@ -88,4 +156,4 @@ export declare const importsEvents: Events<ImportsEvents>;
 /** The `imports` block's manifest (ADR 0029). */
 export declare const importsBlock: BlockOf<"imports", typeof createImports, ImportsEvents>;
 //#endregion
-export { type DryRunResult, type ImportColumn, type ImportDefinition, type ImportRowError, type Imports, type ImportsEvents, type ImportsOptions, type RunImportResult, parseCsv };
+export { type AppTableImport, type AppTableImportOptions, type AppTableImportRepository, type AppTableImportUpdate, type DryRunResult, type ImportColumn, type ImportDefinition, type ImportPreview, type ImportRowError, type Imports, type ImportsEvents, type ImportsOptions, type PreviewImportResult, type RunImportResult, parseCsv };

package/dist/blocks/imports/index.js

@@ -1,11 +1,11 @@
-import { n as validate } from "../../standard-B5fe2gnW.js";
+import { n as validate } from "../../standard-DZmwmIhV.js";
 import { n as parseCsv } from "../../csv-CVfXqaAu.js";
 import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
-import { D as recordOf, I as textOf, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
-import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { D as recordOf, I as textOf, o as blockCall } from "../../block-helpers-BfVCR5Fc.js";
+import { r as withBlockHooks } from "../../block-hooks-ByKlh8Qy.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
 //#region src/blocks/imports/define-import.ts
-/** Registers an import. The jobs handler calls `insert` in batches. */
+/** Registers an import. `runImport` calls `insert` in batches. */
 function defineImport(definition) {
 	return definition;
 }
@@ -53,6 +53,8 @@ const BATCH = 100;
 /**
 * Validates the file, skips rows whose key was already imported, inserts the
 * rest in batches and finishes the run as `import.completed` or `import.failed`.
+* A batch that throws finishes the run as failed with the rows inserted so
+* far, and the result says so instead of the error escaping.
 */
 async function runImport(definition, csv, mapping, hooks) {
 	const preview = await dryRun(definition, csv, mapping);
@@ -75,7 +77,29 @@ async function runImport(definition, csv, mapping, hooks) {
 		seen.add(key);
 		return true;
 	});
-	for (let index = 0; index < fresh.length; index += BATCH) await definition.insert(fresh.slice(index, index + BATCH), { organizationId: hooks.organizationId });
+	await hooks.running?.(id);
+	let inserted = 0;
+	for (let index = 0; index < fresh.length; index += BATCH) {
+		const batch = fresh.slice(index, index + BATCH);
+		try {
+			await definition.insert(batch, { organizationId: hooks.organizationId });
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			const first = index + 1;
+			await hooks.finish(id, "failed", inserted, message);
+			return {
+				id,
+				status: "failed",
+				imported: inserted,
+				errors: [{
+					row: first,
+					message: `the batch starting at imported row ${first} failed: ${message}`
+				}],
+				rows: fresh.slice(0, inserted)
+			};
+		}
+		inserted += batch.length;
+	}
 	await hooks.finish(id, "completed", fresh.length, null);
 	return {
 		id,
@@ -89,6 +113,86 @@ function normalize(value) {
 	return value.toLowerCase().replaceAll(/[\s_]+/g, "");
 }
 //#endregion
+//#region src/blocks/imports/app-table-import.ts
+/**
+* An import that upserts rows into an app table on one of its unique sets.
+* A row whose key exists updates that row (see `update`); the rest are
+* inserted. Pass no `importedKeys` to `runImport`, so a rerun updates rows
+* instead of skipping them.
+*/
+function appTableImport(options) {
+	const { repository, key } = options;
+	const update = options.update ?? "fill";
+	assertUniqueKey(options.table, repository.$meta, key);
+	const keyOf = (row) => JSON.stringify(key.map((column) => valueOf(row, column) ?? null));
+	const existing = async (rows) => {
+		if (rows.length === 0) return /* @__PURE__ */ new Map();
+		const found = await repository.findMany({ where: { OR: rows.map((row) => pick(row, key)) } }).orThrow();
+		return new Map(found.map((row) => [keyOf(row), row]));
+	};
+	const merged = (row, current) => current === void 0 || update === "overwrite" ? row : {
+		...row,
+		...Object.fromEntries(Object.keys(row).filter((column) => !isEmpty(current[column])).map((column) => [column, current[column]]))
+	};
+	return {
+		kind: options.table,
+		columns: options.columns,
+		key: keyOf,
+		insert: async (batch) => {
+			const found = await existing(batch);
+			await repository.upsertMany(batch.map((row) => merged(row, found.get(keyOf(row)))), {
+				onConflict: key,
+				returning: false
+			}).orThrow();
+		},
+		preview: async (rows) => {
+			const found = await existing(rows);
+			let created = 0;
+			let changed = 0;
+			for (const row of rows) {
+				const current = found.get(keyOf(row));
+				if (current === void 0) created += 1;
+				else if (differs(merged(row, current), current)) changed += 1;
+			}
+			return {
+				created,
+				changed,
+				unchanged: rows.length - created - changed
+			};
+		}
+	};
+}
+/**
+* Validates the file like `dryRun`, then counts the valid rows the import
+* would create, change and leave unchanged. Nothing is written.
+*/
+async function previewImport(definition, csv, mapping) {
+	const result = await dryRun(definition, csv, mapping);
+	return {
+		...result,
+		preview: await definition.preview(result.rows)
+	};
+}
+function assertUniqueKey(table, meta, key) {
+	const sets = [meta.primaryKey, ...Object.values(meta.uniqueKeys)];
+	const wanted = [...key].toSorted().join(",");
+	if (key.length === 0 || !sets.some((set) => [...set].toSorted().join(",") === wanted)) throw new Error(`appTableImport: key (${key.join(", ")}) is not a unique set of ${table}; add it to appTables.${table}.unique`);
+}
+function valueOf(row, column) {
+	return Object.getOwnPropertyDescriptor(row, column)?.value;
+}
+function pick(row, key) {
+	const picked = {};
+	for (const column of key) picked[column] = row[column];
+	return picked;
+}
+function isEmpty(value) {
+	return value === null || value === void 0 || value === "";
+}
+function differs(next, current) {
+	return Object.entries(next).some(([column, value]) => JSON.stringify(value ?? null) !== JSON.stringify(current[column] ?? null));
+}
+//#endregion
 //#region src/blocks/imports/imports.ts
 function createImports(options) {
 	const call = blockCall(options.transport, options.schema, options.mappers);
@@ -117,7 +221,7 @@ const importsBlock = defineBlock({
 	events: importsEvents,
 	create: createImports,
 	category: "content",
-	recipes: ["csv-import-wizard"]
+	recipes: ["csv-import-wizard", "upsert-import"]
 });
 //#endregion
-export { createImports, defineImport, dryRun, importsBlock, importsEvents, parseCsv, runImport, suggestMapping };
+export { appTableImport, createImports, defineImport, dryRun, importsBlock, importsEvents, parseCsv, previewImport, runImport, suggestMapping };

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

@@ -1,8 +1,8 @@
-import { H as InboxEventData, wt as Events } from "../../events-CTreRrgP.js";
-import { a as dbTransport, i as RpcClient, 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 MessageTemplate, C as InboxCounts, D as MessageDelivery, E as MessageAttachment, M as StoredInboundEvent, O as MessageDirection, S as InboxChannel, T as InboxRow, _ as ConversationEvent, a as Inbox, b as DeliveryStatus, c as InboxPatch, d as TemplateInput, f as createInbox, g as Conversation, h as Contact, i as InboundInput, j as PurgedContact, k as MessageKind, l as MessageInput, m as BotMode, n as ConversationFilter, o as InboxHooks, p as AuthorType, r as CreateInboxInput, s as InboxOptions, t as ContactInput, u as StartConversationInput, v as ConversationPriority, w as InboxMessage, x as InboundResult, y as ConversationStatus } from "../../inbox-3ql4phyr.js";
-import { a as InboxController, c as InboxListSnapshot, d as InboxWidgetController, f as InboxWidgetControllerOptions, g as createInboxWidgetController, h as createInboxController, i as ConversationSnapshot, l as InboxSource, m as createConversationController, n as ConversationController, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../client-Lx3mlvKO.js";
+import { H as InboxEventData, wt as Events } from "../../events-CtAHxPal.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-NbUJygA7.js";
+import { s as BlockOf } from "../../define-block-BlHQxDIQ.js";
+import { A as MessageTemplate, C as InboxCounts, D as MessageDelivery, E as MessageAttachment, M as StoredInboundEvent, O as MessageDirection, S as InboxChannel, T as InboxRow, _ as ConversationEvent, a as Inbox, b as DeliveryStatus, c as InboxPatch, d as TemplateInput, f as createInbox, g as Conversation, h as Contact, i as InboundInput, j as PurgedContact, k as MessageKind, l as MessageInput, m as BotMode, n as ConversationFilter, o as InboxHooks, p as AuthorType, r as CreateInboxInput, s as InboxOptions, t as ContactInput, u as StartConversationInput, v as ConversationPriority, w as InboxMessage, x as InboundResult, y as ConversationStatus } from "../../inbox-BaUJgHOF.js";
+import { a as InboxController, c as InboxListSnapshot, d as InboxWidgetController, f as InboxWidgetControllerOptions, g as createInboxWidgetController, h as createInboxController, i as ConversationSnapshot, l as InboxSource, m as createConversationController, n as ConversationController, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../client-CpMv4-v5.js";
 //#region src/blocks/inbox/rows.d.ts
 export declare const INBOX_CHANNELS: readonly InboxChannel[];
 //#endregion

package/dist/blocks/inbox/index.js

@@ -1,11 +1,11 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { t as inboxSqlOptions } from "../../options-Dh4wu9Ks.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 { A as requiredInstant, C as optionalText, D as recordOf, F as stringsOf, I as textOf, M as seconds, O as recordOrEmpty, R as toInstant, b as oneOf, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, v as nullableInstant, w as pageOf, y as nullableText } from "../../block-helpers-CfG_MvDR.js";
-import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { A as requiredInstant, C as optionalText, D as recordOf, F as stringsOf, I as textOf, M as seconds, O as recordOrEmpty, R as toInstant, b as oneOf, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, v as nullableInstant, w as pageOf, y as nullableText } from "../../block-helpers-BfVCR5Fc.js";
+import { r as withBlockHooks } from "../../block-hooks-ByKlh8Qy.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
 import { n as createInboxController, r as createInboxWidgetController, t as createConversationController } from "../../client-WgrPIHH-.js";
-import { t as inboxSqlOptions } from "../../options-Dh4wu9Ks.js";
 //#region src/blocks/inbox/rows.ts
 const INBOX_CHANNELS = [
 	"in_app",

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

@@ -1,3 +1,3 @@
-import { l as InboxSource } from "../../../client-Lx3mlvKO.js";
-import { a as UseInboxOptions, c as useInbox, i as UseConversationOptions, l as useInboxWidget, n as InboxListState, o as UseInboxWidgetOptions, r as InboxWidgetState, s as useConversation, t as ConversationState } from "../../../index-jhqhynmh.js";
+import { l as InboxSource } from "../../../client-CpMv4-v5.js";
+import { a as UseInboxOptions, c as useInbox, i as UseConversationOptions, l as useInboxWidget, n as InboxListState, o as UseInboxWidgetOptions, r as InboxWidgetState, s as useConversation, t as ConversationState } from "../../../index-DTQbC3CW.js";
 export { ConversationState, InboxListState, type InboxSource, InboxWidgetState, UseConversationOptions, UseInboxOptions, UseInboxWidgetOptions, useConversation, useInbox, useInboxWidget };

package/dist/blocks/inbox/react/server.d.ts

@@ -1,5 +1,5 @@
-import { l as InboxSource } from "../../../client-Lx3mlvKO.js";
-import { a as UseInboxOptions, i as UseConversationOptions, n as InboxListState, o as UseInboxWidgetOptions, r as InboxWidgetState, t as ConversationState } from "../../../index-jhqhynmh.js";
+import { l as InboxSource } from "../../../client-CpMv4-v5.js";
+import { a as UseInboxOptions, i as UseConversationOptions, n as InboxListState, o as UseInboxWidgetOptions, r as InboxWidgetState, t as ConversationState } from "../../../index-DTQbC3CW.js";
 //#region src/blocks/inbox/react/server.d.ts
 /** The `react-server` build of `useInbox`: call `inbox.conversations.list()` instead. */
 export declare const useInbox: <T>(options: UseInboxOptions<T>) => InboxListState<T>;

package/dist/blocks/inbox/solid/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as SolidController } from "../../../solid-controller-DqlvYFZa.js";
-import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-Lx3mlvKO.js";
+import { t as SolidController } from "../../../solid-controller-CZrt1Tg6.js";
+import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-CpMv4-v5.js";
 //#region src/blocks/inbox/solid/index.d.ts
 /**
  * `createInboxController` as a Solid primitive: `state()` reads the snapshot.

package/dist/blocks/inbox/svelte/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as SvelteController } from "../../../svelte-controller-DxxHEHxD.js";
-import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-Lx3mlvKO.js";
+import { t as SvelteController } from "../../../svelte-controller-DDbju9CW.js";
+import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-CpMv4-v5.js";
 //#region src/blocks/inbox/svelte/index.d.ts
 /**
  * `createInboxController` as a Svelte readable store of the snapshot, with the

package/dist/blocks/inbox/vue/index.d.ts

@@ -1,6 +1,6 @@
 import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
-import { t as VueController } from "../../../vue-controller-HPfMTDa2.js";
-import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-Lx3mlvKO.js";
+import { t as VueController } from "../../../vue-controller-D_ohttBZ.js";
+import { c as InboxListSnapshot, f as InboxWidgetControllerOptions, i as ConversationSnapshot, o as InboxControllerOptions, p as InboxWidgetSnapshot, r as ConversationControllerOptions, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "../../../client-CpMv4-v5.js";
 //#region src/blocks/inbox/vue/index.d.ts
 /**
  * `createInboxController` as a Vue composable: `state` is a shallow ref of the

package/dist/blocks/index.d.ts

@@ -1,10 +1,29 @@
-import { Ct as EventSpec, Dt as event, Et as defineEvents, Ot as mergeEvents, St as EventMapOf, bt as onBlockEvent, w as BlockEmit, wt as Events, xt as EventMap } from "../events-CTreRrgP.js";
-import { a as dbTransport, i as RpcClient, n as DbTransportOptions, o as rpcTransport, r as DbTransportSource, s as sqlTransport, t as BlockTransport } from "../block-transport-DaGGXjIw.js";
-import { i as CursorPageOptions, n as BlockOptions } from "../block-helpers-C86hPEjI.js";
-import { a as BlockTransportMiddleware, c as ExtendBlockTools, d as extendBlock, f as withBlockHooks, i as BlockMethodName, l as WithBlockHooksOptions, n as BlockHooks, o as BlockTransportRequest, p as wrapTransport, r as BlockMethodHooks, s as ExtendBlockOptions, t as BlockHookInfo, u as defineTransportMiddleware } from "../block-hooks-BLPWD3Jt.js";
+import { Ct as EventSpec, Dt as event, Et as defineEvents, Ot as mergeEvents, St as EventMapOf, bt as onBlockEvent, w as BlockEmit, wt as Events, xt as EventMap } from "../events-CtAHxPal.js";
+import { a as dbTransport, i as RpcClient, n as DbTransportOptions, o as rpcTransport, r as DbTransportSource, s as sqlTransport, t as BlockTransport } from "../block-transport-NbUJygA7.js";
+import { i as CursorPageOptions, n as BlockOptions } from "../block-helpers-7pMBVsE6.js";
+import { a as BlockTransportMiddleware, c as ExtendBlockTools, d as extendBlock, f as withBlockHooks, i as BlockMethodName, l as WithBlockHooksOptions, n as BlockHooks, o as BlockTransportRequest, p as wrapTransport, r as BlockMethodHooks, s as ExtendBlockOptions, t as BlockHookInfo, u as defineTransportMiddleware } from "../block-hooks-C_WaodoA.js";
 import { a as WithExtraFields, n as ExtraFields, o as blockFields, r as FieldsOf, t as BlockFields } from "../block-fields-5UA84ZUg.js";
 import { n as FinalRunState, r as RunState, t as FINAL_RUN_STATES } from "../run-state-CPo-1X2B.js";
 import { a as OptionKind, c as blockOptions, i as OptionInput, l as option, n as NO_OPTIONS, o as OptionSpec, r as OptionBuilders, s as OptionSpecs, t as BlockOptionsSchema, u as optionsJsonSchema } from "../options-CbSOj53r.js";
-import { A as BlockNaming, C as CreateBlocksOptions, D as GeneratedBlocks, E as GeneratedBlock, O as fillTopic, S as BlocksHooks, T as defineBlocks, _ as BlockMap, a as BlockConsumes, b as Blocks, c as BlockOptionSchemas, d as ConsumedPorts, f as ProvidedPorts, g as BlockContext, h as BLOCK_EVENT_SOURCE, i as BlockCategory, j as blockNames, k as generatedOptions, l as BlockProvides, m as defineBlock, n as BLOCK_CATEGORIES, o as BlockDefinition, p as UsingOptions, r as Block, s as BlockOf, t as AnyBlock, u as ClientOf, v as BlockSet, w as createBlocks, x as BlocksEventMap, y as BlockSinks } from "../define-block-CLZMEFeK.js";
-import { i as PortName, n as Notifier, r as NotifierInput, t as BlockPorts } from "../ports-Ca63W4cW.js";
-export { type AnyBlock, BLOCK_CATEGORIES, BLOCK_EVENT_SOURCE, type Block, type BlockCategory, type BlockConsumes, type BlockContext, type BlockDefinition, type BlockEmit, type BlockFields, type BlockHookInfo, type BlockHooks, type BlockMap, type BlockMethodHooks, type BlockMethodName, type BlockNaming, type BlockOf, type BlockOptionSchemas, type BlockOptions, type BlockOptionsSchema, type BlockPorts, type BlockProvides, type BlockSet, type BlockSinks, type BlockTransport, type BlockTransportMiddleware, type BlockTransportRequest, type Blocks, type BlocksEventMap, type BlocksHooks, type ClientOf, type ConsumedPorts, type CreateBlocksOptions, type CursorPageOptions, type DbTransportOptions, type DbTransportSource, type EventMap, type EventMapOf, type EventSpec, type Events, type ExtendBlockOptions, type ExtendBlockTools, type ExtraFields, FINAL_RUN_STATES, type FieldsOf, type FinalRunState, type GeneratedBlock, type GeneratedBlocks, NO_OPTIONS, type Notifier, type NotifierInput, type OptionBuilders, type OptionInput, type OptionKind, type OptionSpec, type OptionSpecs, type PortName, type ProvidedPorts, type RpcClient, type RunState, type UsingOptions, type WithBlockHooksOptions, type WithExtraFields, blockFields, blockNames, blockOptions, createBlocks, dbTransport, defineBlock, defineBlocks, defineEvents, defineTransportMiddleware, event, extendBlock, fillTopic, generatedOptions, mergeEvents, onBlockEvent, option, optionsJsonSchema, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+import { A as BlockNaming, C as CreateBlocksOptions, D as GeneratedBlocks, E as GeneratedBlock, O as fillTopic, S as BlocksHooks, T as defineBlocks, _ as BlockMap, a as BlockConsumes, b as Blocks, c as BlockOptionSchemas, d as ConsumedPorts, f as ProvidedPorts, g as BlockContext, h as BLOCK_EVENT_SOURCE, i as BlockCategory, j as blockNames, k as generatedOptions, l as BlockProvides, m as defineBlock, n as BLOCK_CATEGORIES, o as BlockDefinition, p as UsingOptions, r as Block, s as BlockOf, t as AnyBlock, u as ClientOf, v as BlockSet, w as createBlocks, x as BlocksEventMap, y as BlockSinks } from "../define-block-BlHQxDIQ.js";
+import { i as PortName, n as Notifier, r as NotifierInput, t as BlockPorts } from "../ports-B53rB7zg.js";
+//#region src/blocks/app-table-events.d.ts
+/**
+ * The data of an app table event (ADR 0048): `<type>.created`, `.updated`
+ * and `.deleted`, written by the trigger `appTables.<table>.events` adds.
+ */
+interface AppTableEventData {
+  /** The row id. */
+  readonly id: string | number;
+  /** The row's tenant, for tables kept per tenant. */
+  readonly organizationId?: string;
+  /** Set when the table registers a subject. */
+  readonly subjectType?: string;
+  readonly subjectId?: string;
+  /** The columns an update changed, `updated_at` left out. */
+  readonly changed?: readonly string[];
+  /** The values of the columns in `events.include`. */
+  readonly [column: string]: unknown;
+}
+//#endregion
+export { type AnyBlock, type AppTableEventData, BLOCK_CATEGORIES, BLOCK_EVENT_SOURCE, type Block, type BlockCategory, type BlockConsumes, type BlockContext, type BlockDefinition, type BlockEmit, type BlockFields, type BlockHookInfo, type BlockHooks, type BlockMap, type BlockMethodHooks, type BlockMethodName, type BlockNaming, type BlockOf, type BlockOptionSchemas, type BlockOptions, type BlockOptionsSchema, type BlockPorts, type BlockProvides, type BlockSet, type BlockSinks, type BlockTransport, type BlockTransportMiddleware, type BlockTransportRequest, type Blocks, type BlocksEventMap, type BlocksHooks, type ClientOf, type ConsumedPorts, type CreateBlocksOptions, type CursorPageOptions, type DbTransportOptions, type DbTransportSource, type EventMap, type EventMapOf, type EventSpec, type Events, type ExtendBlockOptions, type ExtendBlockTools, type ExtraFields, FINAL_RUN_STATES, type FieldsOf, type FinalRunState, type GeneratedBlock, type GeneratedBlocks, NO_OPTIONS, type Notifier, type NotifierInput, type OptionBuilders, type OptionInput, type OptionKind, type OptionSpec, type OptionSpecs, type PortName, type ProvidedPorts, type RpcClient, type RunState, type UsingOptions, type WithBlockHooksOptions, type WithExtraFields, blockFields, blockNames, blockOptions, createBlocks, dbTransport, defineBlock, defineBlocks, defineEvents, defineTransportMiddleware, event, extendBlock, fillTopic, generatedOptions, mergeEvents, onBlockEvent, option, optionsJsonSchema, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };