better-supabase 0.14.0 → 0.15.0

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

@@ -1,16 +1,16 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, b as DbError, t as AsyncResult } from "../../result-C6jDfedy.js";
-import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
-import { Ct as Events, dt as TemplateEventData, ut as TemplateApplicationEventData } from "../../events-DbLjvxDX.js";
+import { T as ErrorMapper, b as DbError, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { n as ExtraFields, r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { Ct as Events, dt as TemplateEventData, ut as TemplateApplicationEventData } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-BaugZlJV.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 import { t as ComposedEmail } from "../../email-tt2QqiSc.js";
-import { O as WorkflowStepInfo, _ as WorkflowBuilder } from "../../types-uHD9yANu.js";
-import { i as GraphStepCall } from "../../executor-DQoczQZJ.js";
+import { E as WorkflowStepInfo, x as WorkflowEditor } from "../../types-BBQLbui9.js";
+import { i as GraphStepCall } from "../../executor-_2ekNofh.js";
 //#region src/blocks/templates/merge-fields.d.ts
 /** How a rendered value is escaped: for HTML markup, or left as it is. */
 type MergeEscape = "html" | "text";
@@ -169,7 +169,7 @@ interface TemplateVersion {
   readonly publishedAt: Temporal.Instant | undefined;
   readonly createdBy: string | undefined;
   readonly createdAt: Temporal.Instant;
-  /** Set by `get`, `versions.save` and `versions.publish`; lists leave it out. */
+  /** Set by `get`, `versions.upsert` and `versions.publish`; lists leave it out. */
   readonly body?: unknown;
 }
 interface TemplateDetail<F extends object = Record<never, never>> extends Template<F> {
@@ -247,7 +247,7 @@ interface TemplateApplyResult {
   readonly runs: readonly TemplateRunStart[];
 }
 interface Templates<F extends object = Record<never, never>> {
-  save(input: TemplateInput<F>): AsyncResult<Template<F>>;
+  upsert(input: TemplateInput<F>): AsyncResult<Template<F>>;
   /**
    * The organization's templates and the system ones (only those with `null`),
    * defaults first.
@@ -280,12 +280,12 @@ interface Templates<F extends object = Record<never, never>> {
   sync(starters: readonly TemplateStarter[]): AsyncResult<number>;
   readonly versions: {
     /** Saves the draft: updates the open one, or opens the next version. */
-    save(template: string, body: unknown): AsyncResult<TemplateVersion>;
+    upsert(template: string, body: unknown): AsyncResult<TemplateVersion>;
     publish(template: string): AsyncResult<TemplateVersion>;
     /** Newest first, without bodies. */
     list(template: string): AsyncResult<readonly TemplateVersion[]>;
   };
-  /** Needs the workflow-builder module. */
+  /** Needs the workflow-editor module. */
   readonly workflows: {
     attach(input: TemplateWorkflowInput): AsyncResult<TemplateWorkflow>;
     detach(template: string, definition: string): AsyncResult<boolean>;
@@ -315,13 +315,13 @@ interface TemplatesOptions<S extends StandardSchemaV1 | undefined = undefined> e
   /**
    * A Standard Schema for the template's extra columns
    * (`blocks.templates.options.extraColumns`), keyed by database name. It types
-   * and parses them on reads, and validates them on `save`.
+   * and parses them on reads, and validates them on `upsert`.
    */
   readonly fields?: S;
   /** The template types, by name. A type without `apply` can't be applied. */
   readonly types?: Readonly<Record<string, TemplateType>>;
-  /** Starts the attached workflows; `createWorkflowBuilder` as the caller. */
-  readonly workflows?: Pick<WorkflowBuilder, "run">;
+  /** Starts the attached workflows; `createWorkflowEditor` as the caller. */
+  readonly workflows?: Pick<WorkflowEditor, "run">;
   /** `withBlockHooks` hooks around the client's methods. */
   readonly hooks?: NoInfer<BlockHooks<Templates<FieldsOf<S>>>>;
   /** Receives the errors `after` hooks throw. Default: `console`. */
@@ -336,7 +336,7 @@ interface TemplatesOptions<S extends StandardSchemaV1 | undefined = undefined> e
 export declare function createTemplates<S extends StandardSchemaV1 | undefined = undefined>(options: TemplatesOptions<S>): Templates<FieldsOf<S>>;
 //#endregion
 //#region src/blocks/templates/step.d.ts
-/** The `templates.apply` step for the workflow-builder step library. */
+/** The `templates.apply` step for the workflow-editor step library. */
 export declare const TEMPLATES_APPLY_STEP: WorkflowStepInfo;
 /** What a `templates.apply` node returns: plain data, so it serializes. */
 interface TemplatesApplyOutput {

package/dist/blocks/templates/index.js

@@ -1,14 +1,14 @@
 import { t as DbException } from "../../db-exception-Lngc1W49.js";
-import { n as dbError } from "../../errors-03ysrOt4.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-B3m7xtRY.js";
+import { n as dbError } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { n as validate } from "../../standard-DtkpFGkS.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-ntFBW2p2.js";
+import { n as validate } from "../../standard-BA3mLh6w.js";
 import { t as templatesSqlOptions } from "../../options-Fz6xqu-b.js";
-import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, O as recordOrEmpty, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall, r as asDbError } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, O as recordOrEmpty, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall, r as asDbError } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as blockFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/templates/templates.ts
 const SCOPES = ["tenant", "system"];
 /** Declares a template type with its schemas typed. */
@@ -137,7 +137,7 @@ function createTemplates(options) {
 		return runs;
 	};
 	return withBlockHooks({
-		save: (input) => AsyncResult.from(async () => {
+		upsert: (input) => AsyncResult.from(async () => {
 			const extra = await fields.args(input.fields);
 			if (!extra.ok) return extra;
 			const type = typeOf(input.type);
@@ -192,7 +192,7 @@ function createTemplates(options) {
 			return call("sync_templates", { starters: rows }, Number);
 		}),
 		versions: {
-			save: (template, body) => AsyncResult.from(async () => {
+			upsert: (template, body) => AsyncResult.from(async () => {
 				if (!Object.values(types).some((type) => type.body !== void 0)) return saveVersion(template, body);
 				const found = await get(template);
 				if (!found.ok) return found;
@@ -388,7 +388,7 @@ function composeTemplateEmail(body, values, options = {}) {
 }
 //#endregion
 //#region src/blocks/templates/step.ts
-/** The `templates.apply` step for the workflow-builder step library. */
+/** The `templates.apply` step for the workflow-editor step library. */
 const TEMPLATES_APPLY_STEP = {
 	name: "templates.apply",
 	title: "Create from template",

package/dist/blocks/time-tracking/index.d.ts

@@ -1,16 +1,16 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
-import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
-import { dt as SubjectRef } from "../../executor-CPyrQdjh.js";
-import { Ct as Events, ft as TimeEntryEventData, pt as TimesheetEventData } from "../../events-DbLjvxDX.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { n as ExtraFields, r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { $ as RecordRef } from "../../types-DFdg_4yN.js";
+import { Ct as Events, ft as TimeEntryEventData, pt as TimesheetEventData } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { a as BlockTenantOptions, r as BlockTemporalOptions } from "../../block-helpers-BaugZlJV.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
-import { t as CloudEvent } from "../../cloud-event-SPyXMdcd.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { a as BlockTenantOptions, r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 import { n as Money } from "../../money-BNRdJQzA.js";
+import { t as CloudEvent } from "../../cloud-event-CzZTJkXv.js";
 import { n as MetricDefinition } from "../../metric-definition-EAYI1r2n.js";
 //#region src/blocks/time-tracking/time-tracking.d.ts
 interface TimeTrackingOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions, BlockTenantOptions {
@@ -39,7 +39,7 @@ interface TimeEntry<F extends object = Record<never, never>> {
   readonly organizationId: string;
   readonly userId: string;
   /** The record the time is tracked on; `undefined` for an unattached entry. */
-  readonly subject: SubjectRef | undefined;
+  readonly subject: RecordRef | undefined;
   readonly startedAt: Temporal.Instant;
   /** Missing while the timer runs. */
   readonly endedAt?: Temporal.Instant;
@@ -57,7 +57,7 @@ interface TimeEntry<F extends object = Record<never, never>> {
 /** The record time is tracked on, how it bills, and the extra columns. */
 interface TimeEntryFields<F extends object = Record<never, never>> {
   /** The record the time is on. Default: none. */
-  readonly subject?: SubjectRef;
+  readonly subject?: RecordRef;
   readonly billable?: boolean;
   /** The hourly rate, in minor units of its currency. */
   readonly rate?: Money;
@@ -75,7 +75,7 @@ interface LogTimeInput<F extends object = Record<never, never>> extends TimeEntr
 interface TimeEntryPatch<F extends object = Record<never, never>> {
   readonly startedAt?: Temporal.Instant;
   readonly endedAt?: Temporal.Instant;
-  readonly subject?: SubjectRef | null;
+  readonly subject?: RecordRef | null;
   readonly billable?: boolean;
   readonly rate?: Money | null;
   readonly note?: string | null;
@@ -92,7 +92,7 @@ interface TimeEntryListOptions {
   /** Entries that start before this instant. */
   readonly to?: Temporal.Instant;
   /** Entries on this record only. */
-  readonly subject?: SubjectRef;
+  readonly subject?: RecordRef;
   readonly pageSize?: number;
 }
 type TimesheetStatus = "open" | "submitted" | "approved" | "rejected";
@@ -198,7 +198,7 @@ export declare function timeEntryMetricTime(event: CloudEvent): string | readonl
 //#region src/blocks/time-tracking/weekly-grid.d.ts
 /** The fields `toWeeklyGrid` reads from an entry. */
 type WeeklyGridEntry = Pick<TimeEntry, "id" | "startedAt" | "endedAt" | "billable"> & {
-  readonly subject?: SubjectRef | undefined;
+  readonly subject?: RecordRef | undefined;
 };
 interface WeeklyGridOptions<E extends WeeklyGridEntry> {
   /** Any day of the week; the grid starts on its Monday. */
@@ -226,7 +226,7 @@ interface WeeklyGridDay {
 interface WeeklyGridRow {
   readonly id: string;
   /** The record of the row's first entry; `undefined` when it has none. */
-  readonly subject: SubjectRef | undefined;
+  readonly subject: RecordRef | undefined;
   readonly billable: boolean;
   /** Seconds per day, Monday first. */
   readonly days: readonly number[];

package/dist/blocks/time-tracking/index.js

@@ -1,18 +1,18 @@
-import { s as nowInstant } from "../../temporal-DLZlWbOi.js";
-import { t as temporal } from "../../temporal-required-B8qQHYbI.js";
-import { t as AsyncResult } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { t as timeTrackingSqlOptions } from "../../options-HSv8R6h5.js";
+import { s as nowInstant } from "../../temporal-DLZlWbOi.js";
+import { t as temporal } from "../../temporal-required-Dy0GGD8E.js";
+import { t as AsyncResult } from "../../result-ntFBW2p2.js";
+import { t as timeTrackingSqlOptions } from "../../options-BbnPv6p7.js";
 import { r as defineMetric } from "../../metric-definition-BjxVn4R5.js";
-import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, S as optionalInstant, U as sqlTransport, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
-import { n as optionalSubjectRefOf } from "../../block-subjects-Dzq5Xn_0.js";
-import { t as requireTenant } from "../../block-tenant-C1sNV8_4.js";
+import { n as blockFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { n as optionalRecordRefOf } from "../../block-subjects-BhDKK_j7.js";
+import { t as requireOrganization } from "../../block-tenant-DHp7subc.js";
 import { s as isCurrency } from "../../money-BZl985O-.js";
-import { i as moneyOf, o as optionalMoneyOf, s as unknownCurrency, t as amountText } from "../../money-codec-jMP0PQLZ.js";
+import { i as moneyOf, o as optionalMoneyOf, s as unknownCurrency, t as amountText } from "../../money-codec-BzddguAQ.js";
 //#region src/blocks/time-tracking/time-tracking.ts
 const STATUSES = [
 	"open",
@@ -30,7 +30,7 @@ function entryOf(value, fn) {
 		id: textOf(row["id"]),
 		organizationId: textOf(row["organizationId"]),
 		userId: textOf(row["userId"]),
-		subject: optionalSubjectRefOf(row["subjectType"], row["subjectId"]),
+		subject: optionalRecordRefOf(row["subjectType"], row["subjectId"]),
 		startedAt: requiredInstant(row["startedAt"], "startedAt"),
 		billable: row["billable"] === true,
 		createdAt: requiredInstant(row["createdAt"], "createdAt"),
@@ -90,7 +90,7 @@ function createTimeTracking(options) {
 	applyTemporal(options);
 	const call = blockCall(options.transport, options.schema, options.mappers);
 	const fields = blockFields(options.fields, "time entry fields");
-	const tenant = () => requireTenant(options.tenant);
+	const tenant = () => requireOrganization(options.tenant);
 	return withBlockHooks({
 		start: (entry = {}) => {
 			const invalid = rateError(entry.rate);

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

@@ -0,0 +1,116 @@
+/// <reference lib="esnext.temporal" />
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { $ as RecordRef, O as AnyFunctions, k as AnyModels, ut as TableKey } from "../../types-DFdg_4yN.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { a as BlockTenantOptions, i as CursorPageOptions, r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { t as BetterSupabase } from "../../define-DFBnQyYg.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { i as EventSink, t as CloudEvent } from "../../cloud-event-CzZTJkXv.js";
+import { i as ListDefinition } from "../../list-query-BDVutLFr.js";
+//#region src/blocks/timeline/timeline.d.ts
+/**
+ * Where a timeline entry comes from: `event` for an `activity_entries` row that
+ * `activitySink()` wrote, `audit` for an audit log entry on the subject's row
+ * (with the `audit` and `subjects` modules), `delivery` for a notification
+ * delivery about the subject (with `notifications`) and `run` for a workflow
+ * run on it (with `workflows`).
+ */
+type ActivitySource = "event" | "audit" | "delivery" | "run";
+interface ActivityEntry {
+  /** An `activity_entries` id, or the audit entry's, delivery's or run's id. */
+  readonly id: string;
+  readonly source: ActivitySource;
+  readonly organizationId: string;
+  readonly type: string;
+  readonly actorId: string | undefined;
+  readonly subject: RecordRef | undefined;
+  readonly summary: string | undefined;
+  readonly data: Readonly<Record<string, unknown>>;
+  readonly occurredAt: Temporal.Instant;
+}
+interface ActivityListOptions extends CursorPageOptions<Temporal.Instant> {
+  /** Entries before this instant, for paging back. */
+  readonly cursor?: Temporal.Instant;
+  /** Default 50, at most 500. */
+  readonly limit?: number;
+  /** The kinds of entry to return; all of them when left out. */
+  readonly sources?: readonly ActivitySource[];
+}
+interface TimelineOptions extends BlockTemporalOptions, BlockTenantOptions {
+  readonly transport: BlockTransport;
+  /** The module schema, or its API schema. Default `better_supabase`. */
+  readonly schema?: string;
+  readonly mappers?: readonly ErrorMapper[];
+  readonly hooks?: BlockHooks<Timeline>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+}
+/** Every method acts in the block's `tenant`. */
+interface Timeline {
+  /**
+   * The activity feed of a tenant, newest first, or one subject's timeline with
+   * `subject`. Members with `activity.read` see it. With the `subjects` module,
+   * an entry on a registered subject type needs `can_subject` read, and a
+   * subject's timeline also lists its audit log entries (`source: "audit"`)
+   * when `audit` is installed with its read policy, the deliveries of
+   * notifications about it (`source: "delivery"`, for members who also hold
+   * `notifications.send`) and its workflow runs (`source: "run"`, as the runs'
+   * read policy allows).
+   */
+  list(subject?: RecordRef | null, options?: ActivityListOptions): AsyncResult<readonly ActivityEntry[]>;
+}
+/** The activity feed over the `activity` module's functions, as the caller. */
+export declare function createTimeline(options: TimelineOptions): Timeline;
+/** What an activity entry says about an event; `null` skips the event. */
+interface ActivityDescription {
+  readonly summary?: string;
+  readonly actorId?: string;
+  readonly subjectType?: string;
+  readonly subjectId?: string;
+  readonly data?: Readonly<Record<string, unknown>>;
+}
+interface ActivitySinkOptions {
+  /**
+   * A service-role transport: `record_activity()` is granted to `service_role`
+   * only.
+   */
+  readonly transport: BlockTransport;
+  readonly schema?: string;
+  /**
+   * The outbox `typePrefix`, stripped from the stored type. Default
+   * `dev.better-supabase`.
+   */
+  readonly typePrefix?: string;
+  /** Types to keep, exact or ending in `.*`. Default every event with a tenant. */
+  readonly types?: readonly string[];
+  /** Summarizes an event, or returns `null` to skip it. */
+  readonly describe?: (event: CloudEvent, type: string) => ActivityDescription | null | undefined;
+}
+/**
+ * An outbox sink that writes events into the activity feed:
+ * `outbox.relay('activity', activitySink({ transport }))`. Events without a
+ * tenant (`partitionkey`) are skipped, and a replayed event writes nothing.
+ */
+export declare function activitySink(options: ActivitySinkOptions): EventSink;
+type ActivitySort = "newest" | "oldest";
+type ActivityFacet = "type" | "actor" | "subjectType" | "subjectId";
+/**
+ * A cursor-paged list over `activity_entries` (generate types for the
+ * `better_supabase` schema to get it in your models), newest first, filtered by
+ * type, actor and subject. Members with `activity.read` see their tenants'
+ * entries, less those on a registered subject that `can_subject` doesn't let
+ * them read (with the `subjects` module). It reads the table, so it lists no
+ * audit entries; `list()` does.
+ */
+export declare function activityListQuery<M extends AnyModels, D, Fn extends AnyFunctions, E, T extends TableKey<M>>(betterSupabase: BetterSupabase<M, D, Fn, E>, table: T, options?: {
+  readonly pageSize?: number;
+  readonly maxPageSize?: number;
+}): ListDefinition<M, T, E, ActivitySort, ActivityFacet>;
+//#endregion
+//#region src/blocks/timeline/manifest.d.ts
+/** The `activity` block's manifest (ADR 0029, ADR 0063). */
+export declare const timelineBlock: BlockOf<"timeline", typeof createTimeline>;
+//#endregion
+export { type ActivityDescription, type ActivityEntry, type ActivityFacet, type ActivityListOptions, type ActivitySinkOptions, type ActivitySort, type ActivitySource, type BlockTransport, type Timeline, type TimelineOptions, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/timeline/index.js

@@ -0,0 +1,164 @@
+import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, R as toInstant, U as sqlTransport, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, w as pageOf } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { a as stripTypePrefix } from "../../cloud-event-XsM53POL.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { n as optionalRecordRefOf } from "../../block-subjects-BhDKK_j7.js";
+import { n as defineListQuery } from "../../list-query-BKy2zBaT.js";
+import { t as requireOrganization } from "../../block-tenant-DHp7subc.js";
+//#region src/blocks/timeline/timeline.ts
+const ACTIVITY_SOURCES = [
+	"event",
+	"audit",
+	"delivery",
+	"run"
+];
+function sourceOf(value) {
+	return ACTIVITY_SOURCES.find((source) => source === value) ?? "event";
+}
+function activityOf(value) {
+	const row = recordOf(value, "activity_entries");
+	return {
+		id: textOf(row["id"]),
+		source: sourceOf(row["source"]),
+		organizationId: textOf(row["organization_id"]),
+		type: textOf(row["type"]),
+		actorId: optionalText(row["actor_id"]),
+		subject: optionalRecordRefOf(row["subject_type"], row["subject_id"]),
+		summary: optionalText(row["summary"]),
+		data: isRecord(row["data"]) ? row["data"] : {},
+		occurredAt: toInstant(textOf(row["occurred_at"]))
+	};
+}
+/** The activity feed over the `activity` module's functions, as the caller. */
+function createTimeline(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const tenant = () => requireOrganization(options.tenant);
+	return withBlockHooks({ list: (subject, history = {}) => tenant().andThen((organizationId) => call("list_activity", {
+		tenant: organizationId,
+		subject_type: subject?.type,
+		subject_id: subject?.id,
+		before: instantArg(pageOf(history).cursor),
+		max_rows: history.limit,
+		sources: history.sources ? [...history.sources] : void 0
+	}, (value) => recordsOf(value, "list_activity").map(activityOf))) }, options.hooks, {
+		block: "timeline",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+const matches = (patterns, type) => patterns.some((pattern) => pattern.endsWith(".*") ? type.startsWith(pattern.slice(0, -1)) : pattern === type);
+const firstText = (data, keys) => {
+	for (const key of keys) {
+		const value = optionalText(data[key]);
+		if (value !== void 0) return value;
+	}
+};
+/** `deals/<id>` as `{ type: "deal", id }`, the shape block subjects use. */
+function subjectOf(subject) {
+	const slash = subject?.indexOf("/") ?? -1;
+	if (subject === void 0 || slash < 1) return;
+	const plural = subject.slice(0, slash);
+	return {
+		type: plural.endsWith("s") ? plural.slice(0, -1) : plural,
+		id: subject.slice(slash + 1)
+	};
+}
+/**
+* An outbox sink that writes events into the activity feed:
+* `outbox.relay('activity', activitySink({ transport }))`. Events without a
+* tenant (`partitionkey`) are skipped, and a replayed event writes nothing.
+*/
+function activitySink(options) {
+	const call = blockCall(options.transport, options.schema);
+	return { async send(events) {
+		const entries = [];
+		for (const event of events) {
+			const tenant = optionalText(event["partitionkey"]);
+			if (tenant === void 0) continue;
+			const type = stripTypePrefix(event.type, options.typePrefix);
+			if (options.types && !matches(options.types, type)) continue;
+			const described = options.describe ? options.describe(event, type) : {};
+			if (described === null) continue;
+			const data = isRecord(event.data) ? event.data : {};
+			const subject = subjectOf(event.subject);
+			entries.push({
+				event_id: event.id,
+				organization_id: tenant,
+				type,
+				actor_id: described?.actorId ?? firstText(data, [
+					"actorId",
+					"authorId",
+					"userId"
+				]),
+				subject_type: described?.subjectType ?? optionalText(data["recordType"]) ?? optionalText(data["subjectType"]) ?? subject?.type,
+				subject_id: described?.subjectId ?? optionalText(data["recordId"]) ?? optionalText(data["subjectId"]) ?? subject?.id,
+				summary: described?.summary,
+				data: described?.data ?? data,
+				occurred_at: event.time
+			});
+		}
+		if (entries.length > 0) await call("record_activity", { batch: { entries } }, () => void 0).orThrow();
+	} };
+}
+const FACETS = [
+	[
+		"type",
+		"type",
+		"type"
+	],
+	[
+		"actor",
+		"actor_id",
+		"actorId"
+	],
+	[
+		"subjectType",
+		"subject_type",
+		"subjectType"
+	],
+	[
+		"subjectId",
+		"subject_id",
+		"subjectId"
+	]
+];
+/**
+* A cursor-paged list over `activity_entries` (generate types for the
+* `better_supabase` schema to get it in your models), newest first, filtered by
+* type, actor and subject. Members with `activity.read` see their tenants'
+* entries, less those on a registered subject that `can_subject` doesn't let
+* them read (with the `subjects` module). It reads the table, so it lists no
+* audit entries; `list()` does.
+*/
+function activityListQuery(betterSupabase, table, options = {}) {
+	const meta = betterSupabase.meta.tables[table];
+	if (!meta) throw new TypeError(`activityListQuery: unknown table "${table}"`);
+	const camel = meta.columns["occurredAt"] !== void 0;
+	const facets = Object.fromEntries(FACETS.map(([key, snake, camelName]) => [key, camel ? camelName : snake]).filter(([, column]) => meta.columns[column] !== void 0));
+	const occurredAt = camel ? "occurredAt" : "occurred_at";
+	const config = {
+		facets,
+		sorts: {
+			newest: [{ [occurredAt]: "desc" }, { id: "desc" }],
+			oldest: [{ [occurredAt]: "asc" }, { id: "asc" }]
+		},
+		defaultSort: "newest",
+		pagination: "cursor",
+		...options.pageSize === void 0 ? {} : { pageSize: options.pageSize },
+		...options.maxPageSize === void 0 ? {} : { maxPageSize: options.maxPageSize }
+	};
+	return defineListQuery(betterSupabase, table, config);
+}
+//#endregion
+//#region src/blocks/timeline/manifest.ts
+/** The `activity` block's manifest (ADR 0029, ADR 0063). */
+const timelineBlock = defineBlock({
+	name: "timeline",
+	sql: ["timeline"],
+	create: createTimeline,
+	category: "collaboration",
+	recipes: []
+});
+//#endregion
+export { activityListQuery, activitySink, createTimeline, dbTransport, rpcTransport, sqlTransport, timelineBlock };

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

@@ -1,13 +1,14 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "../../result-C6jDfedy.js";
-import { t as StandardSchemaV1 } from "../../standard-DbQsD2xZ.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-3w4MZr8U.js";
-import { A as CollaborationEventData, Ct as Events } from "../../events-DbLjvxDX.js";
+import { t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { t as StandardSchemaV1 } from "../../standard-DBV730sF.js";
+import { n as ExtraFields, r as FieldsOf } from "../../block-fields-BE7pInWZ.js";
+import { Dt as HasFlag, Mt as Plugin, Pt as RepositoryExtension, Z as PrimaryKeyValue } from "../../types-DFdg_4yN.js";
+import { A as CollaborationEventData, Ct as Events } from "../../events-vcqenSYU.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { n as BlockOptions } from "../../block-helpers-BaugZlJV.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { n as BlockOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as BlockHooks } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/trash/trash.d.ts
 interface TrashOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockOptions {
   /**
@@ -63,6 +64,43 @@ interface Trash<F extends object = Record<never, never>> {
 /** The `trash` SQL module as typed calls. */
 export declare function createTrash<S extends StandardSchemaV1 | undefined = undefined>(options: TrashOptions<S>): Trash<FieldsOf<S>>;
 //#endregion
+//#region src/blocks/trash/extension.d.ts
+interface TrashFindArgs {
+  /** Include soft-deleted rows of the queried table. */
+  readonly withDeleted?: boolean;
+  /** Only return soft-deleted rows of the queried table. */
+  readonly onlyDeleted?: boolean;
+}
+interface TrashDeleteArgs {
+  /** Delete the row for real instead of setting the soft-delete column. */
+  readonly hard?: boolean;
+}
+interface TrashMethods<K> {
+  /** Clears the soft-delete column. `not_found` when the row does not exist. */
+  readonly restore: (key: K, args?: {
+    readonly signal?: AbortSignal;
+  }) => AsyncResult<void>;
+}
+interface TrashExtension extends RepositoryExtension {
+  readonly methods: HasFlag<this["M"], this["T"], "softDelete"> extends true ? TrashMethods<PrimaryKeyValue<this["M"], this["T"]>> : unknown;
+  readonly findArgs: HasFlag<this["M"], this["T"], "softDelete"> extends true ? TrashFindArgs : unknown;
+  readonly deleteArgs: HasFlag<this["M"], this["T"], "softDelete"> extends true ? TrashDeleteArgs : unknown;
+}
+/**
+ * The `trash` block's repository extension, for tables generated with
+ * `Flags.softDelete`:
+ *
+ * - Reads, updates and deletes skip deleted rows, including inside includes and
+ *   relation filters (`withDeleted` / `onlyDeleted` change the root table);
+ * - `delete` sets the column instead (`{ hard: true }` really deletes);
+ * - `restore(key)` clears it.
+ *
+ * Deletes become updates without `RETURNING`, so a SELECT policy that hides
+ * deleted rows does not make them fail. `delete({ where }, { returning: true
+ * })` keeps `RETURNING`, which needs a SELECT policy that still shows the row.
+ */
+export declare function trashExtension(): Plugin<"softDelete", TrashExtension>;
+//#endregion
 //#region src/blocks/trash/events.d.ts
 /** The events of the `trash` block: type to data. */
 type TrashEvents = {
@@ -77,4 +115,4 @@ export declare const trashEvents: Events<TrashEvents>;
 /** The `trash` block's manifest (ADR 0029). */
 export declare const trashBlock: BlockOf<"trash", typeof createTrash, TrashEvents>;
 //#endregion
-export { type BlockTransport, type Trash, type TrashBatch, type TrashEvents, type TrashItem, type TrashListOptions, type TrashOptions, dbTransport, rpcTransport, sqlTransport };
+export { type BlockTransport, type Trash, type TrashBatch, type TrashDeleteArgs, type TrashEvents, type TrashExtension, type TrashFindArgs, type TrashItem, type TrashListOptions, type TrashMethods, type TrashOptions, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/trash/index.js

@@ -1,10 +1,11 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { t as trashSqlOptions } from "../../options-CUqQ9pm7.js";
-import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { t as trashSqlOptions } from "../../options-DWbA9buW.js";
+import { A as requiredInstant, B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as blockFields } from "../../block-fields-DBSJSeaO.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as blockFields } from "../../block-fields-DE_FgpOU.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as trashExtension } from "../../extension-DzCc0IOd.js";
 //#region src/blocks/trash/trash.ts
 function batchOf(value, fn) {
 	const row = recordOf(value, fn);
@@ -72,7 +73,8 @@ const trashBlock = defineBlock({
 	events: trashEvents,
 	create: createTrash,
 	category: "content",
-	recipes: ["undo-toast", "trash-bin"]
+	recipes: ["undo-toast", "trash-bin"],
+	extension: "trashExtension"
 });
 //#endregion
-export { createTrash, dbTransport, rpcTransport, sqlTransport, trashBlock, trashEvents };
+export { createTrash, dbTransport, rpcTransport, sqlTransport, trashBlock, trashEvents, trashExtension };