better-supabase 0.14.0 → 0.15.0

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

@@ -1,13 +1,13 @@
 /// <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 { Ct as Events } 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 { Ct as Events } 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, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } 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, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/leave/leave.d.ts
 interface LeaveOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
   readonly transport: BlockTransport;

package/dist/blocks/leave/index.js

@@ -1,11 +1,11 @@
-import { t as temporal } from "../../temporal-required-B8qQHYbI.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { t as temporal } from "../../temporal-required-Dy0GGD8E.js";
 import { t as leaveSqlOptions } from "../../options-BesyRBnM.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, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
-import { i as wrapTransport, n as extendBlock, 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, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, 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/leave/leave.ts
 const UNITS = ["days", "hours"];
 const PARTIALS = [

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

@@ -1,12 +1,12 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-C6jDfedy.js";
-import { dt as SubjectRef } from "../../executor-CPyrQdjh.js";
-import { Ct as Events } from "../../events-DbLjvxDX.js";
+import { T as ErrorMapper, t as AsyncResult } from "../../result-DZeA5KS6.js";
+import { $ as RecordRef } from "../../types-DFdg_4yN.js";
+import { Ct as Events } 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, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
-import { Lt as Section, c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { a as BlockTenantOptions, r as BlockTemporalOptions } from "../../block-helpers-CRpAHrp_.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { c as BlockOf, rn as RecordBinding } from "../../define-block-BVcLQ3DF.js";
 import { n as Money } from "../../money-BNRdJQzA.js";
 //#region src/blocks/ledger/ledger.d.ts
 interface LedgerOptions extends BlockTemporalOptions, BlockTenantOptions {
@@ -183,7 +183,7 @@ interface Ledger {
    * A record's accounts the caller can read, such as a party's credits. The
    * record decides the tenant.
    */
-  holderAccounts(holder: SubjectRef, options?: {
+  holderAccounts(holder: RecordRef, options?: {
     readonly kind?: string;
   }): AsyncResult<readonly LedgerAccount[]>;
   /** Newest first; `before` pages back. */
@@ -268,14 +268,12 @@ type LedgerEvents = {
 /** The `ledger` block's event types, for its manifest and `onBlockEvent`. */
 export declare const ledgerEvents: Events<LedgerEvents>;
 //#endregion
-//#region src/blocks/ledger/section.d.ts
+//#region src/blocks/ledger/record-binding.d.ts
 /** A record's ledger accounts with their balances: credits, points, stock. */
-export declare const ledgerSection: Section<Ledger, readonly LedgerAccount[]>;
+export declare const ledgerBinding: RecordBinding<Ledger, readonly LedgerAccount[]>;
 //#endregion
 //#region src/blocks/ledger/manifest.d.ts
 /** The `ledger` block's manifest (ADR 0029). */
-export declare const ledgerBlock: BlockOf<"ledger", typeof createLedger, LedgerEvents, Record<never, never>, never, {
-  readonly ledger: typeof ledgerSection;
-}>;
+export declare const ledgerBlock: BlockOf<"ledger", typeof createLedger, LedgerEvents, Record<never, never>, never, typeof ledgerBinding>;
 //#endregion
 export { type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Ledger, type LedgerAccount, type LedgerAccountEntry, type LedgerAccountEventData, type LedgerAccountInput, type LedgerAccountListOptions, type LedgerCaptureInput, type LedgerEntry, type LedgerEvents, type LedgerHold, type LedgerHoldEventData, type LedgerHoldInput, type LedgerHoldStatus, type LedgerLine, type LedgerOptions, type LedgerTransaction, type LedgerTransactionEventData, type LedgerTransactionInput, type RpcClient, dbTransport, extendBlock, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/ledger/index.js

@@ -1,10 +1,10 @@
 import { n as isRecord } from "../../guards-6F2bCtQR.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, a as bigintOf, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
-import { t as defineSection } from "../../sections-DjxYmpu-.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, a as bigintOf, d as enumOrThrow, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { t as defineRecordBinding } from "../../record-bindings-DkBJpC5A.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
-import { t as requireTenant } from "../../block-tenant-C1sNV8_4.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as requireOrganization } from "../../block-tenant-DHp7subc.js";
 import { d as money, s as isCurrency } from "../../money-BZl985O-.js";
 //#region src/blocks/ledger/ledger.ts
 const HOLD_STATUSES = [
@@ -110,7 +110,7 @@ function holdOf(value, fn) {
 function createLedger(options) {
 	applyTemporal(options);
 	const call = blockCall(options.transport, options.schema, options.mappers);
-	const tenant = () => requireTenant(options.tenant);
+	const tenant = () => requireOrganization(options.tenant);
 	return withBlockHooks({
 		openAccount: (input) => tenant().andThen((organizationId) => call("open_ledger_account", {
 			tenant: organizationId,
@@ -198,9 +198,9 @@ const ledgerEvents = defineEvents({
 	"ledger_hold.released": event()
 });
 //#endregion
-//#region src/blocks/ledger/section.ts
+//#region src/blocks/ledger/record-binding.ts
 /** A record's ledger accounts with their balances: credits, points, stock. */
-const ledgerSection = defineSection({
+const ledgerBinding = defineRecordBinding({
 	permissions: {
 		read: "read",
 		write: "post"
@@ -222,8 +222,8 @@ const ledgerBlock = defineBlock({
 	options: {},
 	events: ledgerEvents,
 	create: createLedger,
-	sections: { ledger: ledgerSection },
+	record: ledgerBinding,
 	category: "commerce"
 });
 //#endregion
-export { createLedger, dbTransport, extendBlock, ledgerBlock, ledgerEvents, ledgerMoney, ledgerSection, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { createLedger, dbTransport, extendBlock, ledgerBinding, ledgerBlock, ledgerEvents, ledgerMoney, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

package/dist/blocks/mail-sync/index.d.ts

@@ -1,9 +1,9 @@
-import { Ct as Events } from "../../events-DbLjvxDX.js";
-import { _ as MailTrackingEventData, g as MailMessageEventData, h as MailAccountEventData } from "../../block-events-records-BGVyoz57.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
-import { n as mailSyncSqlOptions, t as MailSyncSqlOptions } from "../../options-CalPr6kN.js";
-import { A as createMailSync, B as MailSendInput, C as MailSubject, D as MailTemplateStats, E as MailSyncReport, F as MailListInput, G as mailProviderOf, H as buildMime, I as MailPage, J as outlookMessage, K as newMessageId, L as MailProvider, M as HttpMailOptions, N as MailAddress, O as MailThread, P as MailDraft, R as MailProviderMessage, S as MailSendDraft, T as MailSyncOptions, U as gmailMail, V as MailSent, W as gmailMessage, Y as parseAddresses, b as MailAccount, c as BlockOf, j as messageArg, k as MailThreadDetail, q as outlookMail, rn as EntitySchema, w as MailSync, x as MailMessage, z as MailReplyTarget } from "../../define-block-COpcS6aT.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
+import { D as MailMessageEventData, E as MailAccountEventData, O as MailTrackingEventData } from "../../index-CG9rA8H8.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { n as mailSyncSqlOptions, t as MailSyncSqlOptions } from "../../options-DplE18Ko.js";
+import { $ as MailDraft, B as MailMessage, G as MailSyncReport, H as MailSubject, J as MailThreadDetail, K as MailTemplateStats, Q as MailAddress, Sn as EntitySchema, U as MailSync, V as MailSendDraft, W as MailSyncOptions, X as messageArg, Y as createMailSync, Z as HttpMailOptions, at as MailSendInput, c as BlockOf, ct as gmailMail, dt as newMessageId, et as MailListInput, ft as outlookMail, it as MailReplyTarget, lt as gmailMessage, mt as parseAddresses, nt as MailProvider, ot as MailSent, pt as outlookMessage, q as MailThread, rt as MailProviderMessage, st as buildMime, tt as MailPage, ut as mailProviderOf, z as MailAccount } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/mail-sync/events.d.ts
 /** The events of the `mail-sync` block: type to data. */
 type MailSyncEvents = {

package/dist/blocks/mail-sync/index.js

@@ -1,14 +1,14 @@
-import { n as dbError } from "../../errors-03ysrOt4.js";
-import { t as temporal } from "../../temporal-required-B8qQHYbI.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 { t as temporal } from "../../temporal-required-Dy0GGD8E.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-ntFBW2p2.js";
 import { t as mailSyncSqlOptions } from "../../options-zkyhM3qi.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, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.js";
-import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
-import { n as entitySchema } from "../../entity-schema-BXXC1NnT.js";
-import { n as credentialRefInTenant, r as foreignCredentialRef } from "../../provider-EJ0-5GwJ.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, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall } from "../../block-helpers-CtBdjgO4.js";
+import { i as wrapTransport, n as extendBlock, r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as entitySchema } from "../../entity-schema-BDv6w-OQ.js";
+import { n as credentialRefInTenant, r as foreignCredentialRef } from "../../provider-B6g7rBZX.js";
 import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
 //#region src/blocks/mail-sync/providers.ts
 /** Checks the provider's `apiVersion` before the block uses it. */
 function mailProviderOf(provider) {
@@ -111,7 +111,7 @@ const wrap = (value) => (value.match(/.{1,76}/g) ?? []).join("\r\n");
 */
 function buildMime(input) {
 	const { draft, from, reply } = input;
-	const boundary = `bs-${input.messageId.replaceAll(/[^A-Za-z0-9]/g, "")}`;
+	const boundary = `bsb-${input.messageId.replaceAll(/[^A-Za-z0-9]/g, "")}`;
 	const join = (addresses) => (addresses ?? []).map(formatAddress).join(", ");
 	const headers = [
 		`From: ${formatAddress(from)}`,
@@ -892,7 +892,15 @@ const mailSyncBlock = defineBlock({
 	},
 	provides: { mailer: (client) => client },
 	create: createMailSync,
-	category: "crm"
+	category: "crm",
+	providers: [{
+		option: "providers",
+		type: "MailProvider",
+		from: "better-supabase/blocks/mail-sync",
+		required: true,
+		description: "Reads and sends each member's mailbox.",
+		example: "[gmailMail(), outlookMail()]"
+	}]
 });
 //#endregion
 export { buildMime, createMailSync, dbTransport, extendBlock, gmailMail, gmailMessage, mailAccountInputSchema, mailDraftSchema, mailProviderOf, mailSyncBlock, mailSyncEvents, mailSyncSqlOptions, messageArg, newMessageId, outlookMail, outlookMessage, parseAddresses, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };

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

@@ -0,0 +1,67 @@
+import { Dt as HasFlag, Ft as RequestContext, Mt as Plugin, Pt as RepositoryExtension, ot as SchemaMeta } from "../../types-DFdg_4yN.js";
+import { t as MembershipsSqlOptions } from "../../options-DINdgVih.js";
+import { r as Block } from "../../define-block-BVcLQ3DF.js";
+//#region src/blocks/memberships/extension.d.ts
+/**
+ * Dotted paths to the string claims of `C` (up to three levels), e.g.
+ * `'tenant_id' | 'app_metadata.tenant_id'`. Any string without a claims type.
+ */
+type ClaimPath<C> = unknown extends C ? string : StringPaths<C, [1, 2, 3]>;
+type StringPaths<T, Depth extends readonly unknown[]> = T extends object ? T extends readonly unknown[] ? never : { [K in keyof T & string]-?: (NonNullable<T[K]> extends string ? K : never) | (Depth extends readonly [unknown, ...infer Rest] ? `${K}.${StringPaths<NonNullable<T[K]>, Rest>}` : never); }[keyof T & string] : never;
+/**
+ * `C` is the claims type (`betterSupabase.claims(schema)`'s output); it types
+ * `claim`.
+ */
+interface MembershipsExtensionOptions<C = unknown> {
+  /**
+   * JWT claim path(s) holding the tenant id when `context.tenant` is not set.
+   * Dots walk into objects. Defaults to `config.auth.organization.claim`
+   * (`tenant_id`), then the same key in `app_metadata`. `user_metadata` is
+   * never a source: users can write it.
+   */
+  readonly claim?: ClaimPath<C> | readonly ClaimPath<C>[];
+  /** Custom resolution, e.g. from a header validated against memberships. */
+  readonly resolve?: (context: RequestContext) => string | undefined;
+  /**
+   * What happens on a tenant table without an organization in the context:
+   * `skip` (default) leaves it to RLS; `error` fails with `forbidden`.
+   */
+  readonly onMissing?: "error" | "skip";
+  /**
+   * The request header `resolve` reads the tenant from. The plugin does not
+   * read it; `defineApi` documents it as a parameter of tenant tables.
+   */
+  readonly header?: string;
+}
+interface MembershipsFindArgs {
+  /**
+   * Skip the tenant filter for this call (admin tooling, jobs). RLS still
+   * applies.
+   */
+  readonly allTenants?: boolean;
+}
+interface MembershipsExtension extends RepositoryExtension {
+  readonly findArgs: HasFlag<this["M"], this["T"], "tenant"> extends true ? MembershipsFindArgs : unknown;
+  readonly methods: unknown;
+  readonly deleteArgs: HasFlag<this["M"], this["T"], "tenant"> extends true ? MembershipsFindArgs : unknown;
+}
+/**
+ * The tenant for a request: `context.tenant`, then the configured claim.
+ * `schema` supplies the default claim (`config.claims.tenant`).
+ */
+export declare function resolveOrganization<C = unknown>(context: RequestContext, options?: MembershipsExtensionOptions<C>, schema?: Pick<SchemaMeta, "claims">): string | undefined;
+/**
+ * The `memberships` block's repository extension, for tables generated with
+ * `Flags.tenant`. Scopes reads, updates and deletes to the request's
+ * organization (nested includes and relation filters too), fills the
+ * organization column on insert and rejects writes that would move rows to
+ * another organization. It complements RLS; it does not replace it. `gen`
+ * installs it with `auth.organization`; `.use()` it again to replace it.
+ */
+export declare function membershipsExtension<C = unknown>(options?: MembershipsExtensionOptions<C>): Plugin<"tenant", MembershipsExtension>;
+//#endregion
+//#region src/blocks/memberships/manifest.d.ts
+/** The `memberships` block's manifest (ADR 0029). */
+export declare const membershipsBlock: Block<"memberships">;
+//#endregion
+export type { ClaimPath, MembershipsExtension, MembershipsExtensionOptions, MembershipsFindArgs, MembershipsSqlOptions };

package/dist/blocks/memberships/index.js

@@ -0,0 +1,14 @@
+import { t as membershipsSqlOptions } from "../../options-CRz8Ht_4.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { n as resolveOrganization, t as membershipsExtension } from "../../extension-DeAd_MqI.js";
+//#region src/blocks/memberships/manifest.ts
+/** The `memberships` block's manifest (ADR 0029). */
+const membershipsBlock = defineBlock({
+	name: "memberships",
+	sql: ["memberships"],
+	options: { memberships: membershipsSqlOptions },
+	category: "tenancy",
+	extension: "membershipsExtension"
+});
+//#endregion
+export { membershipsBlock, membershipsExtension, resolveOrganization };

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

@@ -1,7 +1,7 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { n as Embedder } from "../../knowledge-CFkCRxO9.js";
-import { a as MemoryHooks, c as MemoryOptions, d as MemoryView, f as RecalledMessage, i as MemoryHit, l as MemoryRecord, n as MemoryCommand, o as MemoryKind, r as MemoryDocument, s as MemoryNamespace, t as Memory, u as MemoryScope } from "../../types-QHeku_6b.js";
-import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { n as Embedder } from "../../knowledge-CtL-Vfgy.js";
+import { a as MemoryHooks, c as MemoryOptions, d as MemoryView, f as RecalledMessage, i as MemoryHit, l as MemoryRecord, n as MemoryCommand, o as MemoryKind, r as MemoryDocument, s as MemoryNamespace, t as Memory, u as MemoryScope } from "../../types-CAQBmpDx.js";
+import { c as BlockOf } from "../../define-block-BVcLQ3DF.js";
 //#region src/blocks/memory/memory.d.ts
 /** Core memory files, archival facts and recall over earlier chats. */
 export declare function createMemory(options: MemoryOptions): Memory;

package/dist/blocks/memory/index.js

@@ -1,12 +1,12 @@
-import { n as dbError } from "../../errors-03ysrOt4.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-B3m7xtRY.js";
-import { t as vectorLiteral } from "../../search-Cn_DGluL.js";
+import { n as dbError } from "../../errors-BVFgt8BZ.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
+import { a as ok, r as err, t as AsyncResult } from "../../result-ntFBW2p2.js";
+import { t as vectorLiteral } from "../../search-Cn_DGluL.js";
 import { t as memorySqlOptions } from "../../options-Bf96aVk5.js";
-import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, b as oneOf, h as instantOf, j as run, k as recordsOf, n as applyTemporal, o as blockCall, p as injectableOf } from "../../block-helpers-CiKtrb6g.js";
-import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
-import { n as defineBlock } from "../../define-block-Dze77QTw.js";
-import { t as checkVectors } from "../../knowledge-BKGrXdS_.js";
+import { B as dbTransport, C as optionalText, D as recordOf, H as rpcTransport, I as textOf, U as sqlTransport, b as oneOf, h as instantOf, j as run, k as recordsOf, n as applyTemporal, o as blockCall, p as injectableOf } from "../../block-helpers-CtBdjgO4.js";
+import { r as withBlockHooks } from "../../block-hooks-BfxX3682.js";
+import { n as defineBlock } from "../../define-block-BGqOO8B3.js";
+import { t as checkVectors } from "../../knowledge-BGbtxMP9.js";
 //#region src/blocks/memory/rows.ts
 const SCOPES = [
 	"user",
@@ -188,7 +188,7 @@ function createMemory(options) {
 		core,
 		run: runCommand,
 		archival: {
-			save: (organizationId, content, ns, saveOptions) => save(organizationId, content, ns, saveOptions),
+			upsert: (organizationId, content, ns, saveOptions) => save(organizationId, content, ns, saveOptions),
 			search: (organizationId, query, ns, searchOptions) => search(organizationId, query, ns, searchOptions),
 			list: (organizationId, ns, listOptions = {}) => call("memory_list", {
 				tenant: organizationId,

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

@@ -1,21 +1,24 @@
-import { dt as SubjectRef } from "../../executor-CPyrQdjh.js";
-import { Ct as Events } from "../../events-DbLjvxDX.js";
-import { o as ConversationEventData, v as MessageEventData } from "../../block-events-records-BGVyoz57.js";
-import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
-import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-CmjPKqQ_.js";
-import { D as MessagingSqlOptions } from "../../authorization-BuT26_sR.js";
+import { b as DbError, f as Result } from "../../result-DZeA5KS6.js";
+import { $ as RecordRef } from "../../types-DFdg_4yN.js";
+import { Ct as Events } from "../../events-vcqenSYU.js";
+import { _ as ConversationEventData, k as MessageEventData } from "../../index-CG9rA8H8.js";
+import { a as dbTransport, i as RpcClient, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DWZSJrwN.js";
+import { a as BlockTransportMiddleware, d as extendBlock, f as withBlockHooks, n as BlockHooks, p as wrapTransport } from "../../block-hooks-DZN2w69m.js";
+import { M as MessagingSqlOptions } from "../../authorization-HZdJCaVm.js";
 import { a as isFileAnchor, i as fileAnchor, n as FileAnchor, o as conversationTopic, r as FileAnchorAt, t as AnchorRegion } from "../../anchors-7F34QyHa.js";
-import { _ as NotifyLevel, a as FollowTarget, b as UnreadCount, c as MessageEdit, d as MessageKind, f as MessageListOptions, g as NewMessage, h as MessagingOptions, i as ConversationSummary, l as MessageEdition, m as Messaging, n as ConversationAccess, o as Message, p as MessageReaction, r as ConversationKind, s as MessageCursor, t as Conversation, u as MessageFile, v as OpenConversation, x as createMessaging, y as RecordMention } from "../../messaging-CZ6aWb10.js";
+import { _ as NotifyLevel, a as FollowTarget, b as UnreadCount, c as MessageEdit, d as MessageKind, f as MessageListOptions, g as NewMessage, h as MessagingOptions, i as ConversationSummary, l as MessageEdition, m as Messaging, n as ConversationAccess, o as Message, p as MessageReaction, r as ConversationKind, s as MessageCursor, t as Conversation, u as MessageFile, v as OpenConversation, x as createMessaging, y as RecordMention } from "../../messaging-C_Pr9tGx.js";
 import { a as ThreadSummary, i as ThreadSummarizer, n as SummaryMessage, o as ThreadSummaryInput, r as SummaryTarget, s as ThreadSummaryOutput, t as SummarizeOptions } from "../../summaries-8jQTELIX.js";
-import { c as BlockOf, rn as EntitySchema } from "../../define-block-COpcS6aT.js";
-import { a as MessageDraft, c as MessagesControllerOptions, d as createMessagesController, i as ConversationsSnapshot, l as MessagesSnapshot, n as ConversationsController, o as MessagesActions, r as ConversationsControllerOptions, s as MessagesController, t as ConversationsActions, u as createConversationsController } from "../../client-RoAuPQNB.js";
+import { Sn as EntitySchema, c as BlockOf } from "../../define-block-BVcLQ3DF.js";
+import { p as SubscriptionStatus } from "../../topic-CJrQZQaa.js";
+import { n as TopicPort } from "../../watch-topic-BcGfvZOE.js";
+import { n as Controller, t as AuthPort } from "../../controller-BrP0gn47.js";
 //#region src/blocks/messaging/mentions.d.ts
 type MentionScope = "channel" | "here";
 interface ParsedMentions {
   /** Mentioned user ids, lowercase, in order and without repeats. */
   readonly users: readonly string[];
   /** Mentioned records, in order and without repeats. */
-  readonly records: readonly SubjectRef[];
+  readonly records: readonly RecordRef[];
   /** `channel` wins over `here` when the body has both, as in SQL. */
   readonly scope: MentionScope | undefined;
 }
@@ -30,7 +33,7 @@ type MentionSegment = {
 } | {
   readonly kind: "record";
   readonly name: string;
-  readonly subject: SubjectRef;
+  readonly subject: RecordRef;
 } | {
   readonly kind: "scope";
   readonly scope: MentionScope;
@@ -51,7 +54,104 @@ export declare function parseMentions(body: string): ParsedMentions;
 /** `@[Name](user:<id>)`: the markup that mentions a user. */
 export declare function userMention(name: string, userId: string): string;
 /** `@[Name](subject:<type>/<id>)`: the markup that mentions a record. */
-export declare function recordMention(name: string, subject: SubjectRef): string;
+export declare function recordMention(name: string, subject: RecordRef): string;
+//#endregion
+//#region src/blocks/messaging/client.d.ts
+interface MessagesControllerOptions {
+  readonly client: Pick<Messaging, "list" | "replies" | "get" | "send" | "edit" | "remove" | "pin" | "resolve" | "markRead">;
+  readonly auth: AuthPort;
+  readonly ports: {
+    readonly topic: TopicPort;
+  };
+  /** The conversation (or channel) to follow; the view waits without one. */
+  readonly conversationId: string | null;
+  /**
+   * A thread's root message: the view shows its replies instead of the
+   * conversation's top-level messages.
+   */
+  readonly threadId?: string | null;
+  /** `blocks.messaging.options.topic`, default `messages`. */
+  readonly topic?: string;
+  /** Messages per page, default 50. */
+  readonly limit?: number;
+  /**
+   * Moves the caller's read marker on load and on each new message; default
+   * true.
+   */
+  readonly markRead?: boolean;
+  /** How long a typing indicator lasts without a new broadcast, default 6000 ms. */
+  readonly typingTimeout?: number;
+}
+interface MessagesSnapshot {
+  /** Oldest first; `undefined` until the first load. */
+  readonly messages: readonly Message[] | undefined;
+  /** Whether `loadOlder` may find more. */
+  readonly hasOlder: boolean;
+  /** The other people typing now, by user id. */
+  readonly typing: readonly string[];
+  readonly status: SubscriptionStatus;
+  readonly error: DbError | undefined;
+}
+/** A reply, a rich-text document, mentions or files for `send`. */
+type MessageDraft = Omit<NewMessage, "body">;
+interface MessagesActions {
+  /**
+   * Sends a message, or a reply in the thread view; a failure is also kept in
+   * `error`.
+   */
+  readonly send: (body: string, draft?: MessageDraft) => Promise<Result<Message>>;
+  readonly edit: (id: string, edition: MessageEdition) => Promise<Result<Message>>;
+  /** Deletes a message; it stays as a placeholder. */
+  readonly remove: (id: string) => Promise<Result<boolean>>;
+  readonly pin: (id: string, pinned?: boolean) => Promise<Result<Message>>;
+  readonly resolve: (id: string, resolved?: boolean) => Promise<Result<Message>>;
+  /** Loads the page before the oldest message shown. */
+  readonly loadOlder: () => Promise<void>;
+  /** Tells the others the caller is typing, or stopped. */
+  readonly setTyping: (typing: boolean) => void;
+  readonly markRead: () => Promise<void>;
+  readonly refresh: () => Promise<void>;
+}
+type MessagesController = Controller<MessagesSnapshot, MessagesActions>;
+/**
+ * One conversation, or one thread, for the signed-in user: loads the latest
+ * page, keeps it current from the conversation's Realtime pings, tracks who is
+ * typing, and moves the read marker as messages arrive.
+ */
+export declare function createMessagesController(options: MessagesControllerOptions): MessagesController;
+interface ConversationsControllerOptions {
+  readonly client: Pick<Messaging, "conversations">;
+  readonly auth: AuthPort;
+  readonly ports: {
+    readonly topic: TopicPort;
+  };
+  /** Whether the caller acts in a tenant; the list waits without one. */
+  readonly enabled: boolean;
+  /** Only these kinds, such as `["channel"]`. */
+  readonly kinds?: readonly ConversationKind[];
+  readonly limit?: number;
+  readonly topic?: string;
+  /**
+   * How many of the listed conversations to follow on Realtime for new
+   * messages, default 50. Unread counts of the others change on `refresh`.
+   */
+  readonly watch?: number;
+}
+interface ConversationsSnapshot {
+  /** Latest message first, with unread counts; `undefined` until loaded. */
+  readonly conversations: readonly ConversationSummary[] | undefined;
+  readonly status: SubscriptionStatus;
+  readonly error: DbError | undefined;
+}
+interface ConversationsActions {
+  readonly refresh: () => Promise<void>;
+}
+type ConversationsController = Controller<ConversationsSnapshot, ConversationsActions>;
+/**
+ * The caller's conversations with their unread and mention counts, loaded again
+ * when a message arrives in one of them.
+ */
+export declare function createConversationsController(options: ConversationsControllerOptions): ConversationsController;
 //#endregion
 //#region src/blocks/messaging/events.d.ts
 /** The events of the `messaging` block: type to data. */
@@ -83,4 +183,4 @@ export declare const messageInputSchema: EntitySchema<NewMessage>;
 /** What `edit` takes. */
 export declare const messageChangeSchema: EntitySchema<MessageEdition>;
 //#endregion
-export { type AnchorRegion, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Conversation, type ConversationAccess, type ConversationKind, type ConversationSummary, type ConversationsActions, type ConversationsController, type ConversationsControllerOptions, type ConversationsSnapshot, type FileAnchor, type FileAnchorAt, type FollowTarget, type MentionScope, type MentionSegment, type Message, type MessageCursor, type MessageDraft, type MessageEdit, type MessageEdition, type MessageFile, type MessageKind, type MessageListOptions, type MessageReaction, type MessagesActions, type MessagesController, type MessagesControllerOptions, type MessagesSnapshot, type Messaging, type MessagingEvents, type MessagingOptions, type MessagingSqlOptions, type NewMessage, type NotifyLevel, type OpenConversation, type ParsedMentions, type RecordMention, type RpcClient, type SummarizeOptions, type SummaryMessage, type SummaryTarget, type ThreadSummarizer, type ThreadSummary, type ThreadSummaryInput, type ThreadSummaryOutput, type UnreadCount, conversationTopic, createConversationsController, createMessagesController, createMessaging, dbTransport, extendBlock, fileAnchor, isFileAnchor, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };
+export { type AnchorRegion, type BlockHooks, type BlockTransport, type BlockTransportMiddleware, type Conversation, type ConversationAccess, type ConversationKind, type ConversationSummary, type ConversationsActions, type ConversationsController, type ConversationsControllerOptions, type ConversationsSnapshot, type FileAnchor, type FileAnchorAt, type FollowTarget, type MentionScope, type MentionSegment, type Message, type MessageCursor, type MessageDraft, type MessageEdit, type MessageEdition, type MessageFile, type MessageKind, type MessageListOptions, type MessageReaction, type MessagesActions, type MessagesController, type MessagesControllerOptions, type MessagesSnapshot, type Messaging, type MessagingEvents, type MessagingOptions, type MessagingSqlOptions, type NewMessage, type NotifyLevel, type OpenConversation, type ParsedMentions, type RecordMention, type RpcClient, type SummarizeOptions, type SummaryMessage, type SummaryTarget, type ThreadSummarizer, type ThreadSummary, type ThreadSummaryInput, type ThreadSummaryOutput, type UnreadCount, conversationTopic, createMessaging, dbTransport, extendBlock, fileAnchor, isFileAnchor, rpcTransport, sqlTransport, withBlockHooks, wrapTransport };