better-supabase 0.12.0 → 0.14.0

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

@@ -1,11 +1,11 @@
 /// <reference lib="esnext.temporal" />
-import { f as Result } from "../../result-BREt7qOh.js";
-import { X as OrganizationDomainEventData, Z as OrganizationEventData, at as SsoProviderEventData, nt as ScimEventData, wt as Events } from "../../events-P3raDX2E.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { r as BlockTemporalOptions } from "../../block-helpers-CjcQM1yA.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
-import { l as ApiKeys } from "../../api-keys-AgDXbcql.js";
-import { _ as dohResolver, a as SamlProviderInput, c as SsoAdmin, d as SsoDomain, f as SsoOptions, g as createSsoAdmin, h as createSso, i as SamlMetadata, l as SsoAdminOptions, m as TxtResolver, n as DomainRecord, o as Sso, p as SsoProvider, r as OrganizationDomain, s as SsoActor, t as DohResolverOptions, u as SsoAuthAdmin } from "../../sso-Bu0mVh0V.js";
+import { f as Result } from "../../result-C6jDfedy.js";
+import { Ct as Events, X as OrganizationDomainEventData, Z as OrganizationEventData, at as SsoProviderEventData, nt as ScimEventData } from "../../events-DbLjvxDX.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 { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { l as ApiKeys } from "../../api-keys-CboAenU8.js";
+import { _ as dohResolver, a as SamlProviderInput, c as SsoAdmin, d as SsoDomain, f as SsoOptions, g as createSsoAdmin, h as createSso, i as SamlMetadata, l as SsoAdminOptions, m as TxtResolver, n as DomainRecord, o as Sso, p as SsoProvider, r as OrganizationDomain, s as SsoActor, t as DohResolverOptions, u as SsoAuthAdmin } from "../../sso-B744gHeS.js";
 //#region src/blocks/sso/scim-filter.d.ts
 type CompareOp = "eq" | "ne" | "co" | "sw" | "ew" | "gt" | "ge" | "lt" | "le";
 type ScimFilter = {
@@ -33,7 +33,10 @@ export declare class ScimFilterError extends Error {
 }
 /** Parses a SCIM filter; throws `ScimFilterError`. */
 declare function parseFilter(input: string): ScimFilter;
-/** Whether `resource` matches; a multi-valued attribute matches when any value does. */
+/**
+ * Whether `resource` matches; a multi-valued attribute matches when any value
+ * does.
+ */
 declare function matches(resource: Record<string, unknown>, filter: ScimFilter): boolean;
 //#endregion
 //#region src/blocks/sso/scim-store.d.ts
@@ -61,9 +64,9 @@ interface ScimListQuery {
 interface ScimListPage {
   readonly resources: readonly ScimStoredResource[];
   /**
-   * Set when the store applied `filter`, `startIndex` and `count` itself:
-   * the handler then pages nothing and reports this total. Leave it out to
-   * return every resource of the tenant for the handler to filter and page.
+   * Set when the store applied `filter`, `startIndex` and `count` itself: the
+   * handler then pages nothing and reports this total. Leave it out to return
+   * every resource of the tenant for the handler to filter and page.
    */
   readonly totalResults?: number;
 }
@@ -71,24 +74,24 @@ interface ScimSaveInput {
   /** `undefined` creates the resource. */
   readonly id: string | undefined;
   /**
-   * The resource the client sent, or the result of a PATCH, without
-   * `meta`. Extension schemas and their attributes are left in.
+   * The resource the client sent, or the result of a PATCH, without `meta`.
+   * Extension schemas and their attributes are left in.
    */
   readonly resource: Doc;
   /**
-   * The core attributes the handler validated. Users: `userName`,
-   * `externalId`, `displayName`, `givenName`, `familyName`, `emails` and
-   * `active`. Groups: `displayName`, `externalId` and `members` (ids).
+   * The core attributes the handler validated. Users: `userName`, `externalId`,
+   * `displayName`, `givenName`, `familyName`, `emails` and `active`. Groups:
+   * `displayName`, `externalId` and `members` (ids).
    */
   readonly data: Doc;
   /** The version an `If-Match` (or the read before a PUT or PATCH) requires. */
   readonly version: number | undefined;
 }
 /**
- * Where the SCIM handler keeps users and groups. `sqlScimStore` is the
- * default; another store can relay to a directory or a provider. Errors are
- * `DbError`s: `not_found` answers 404, `stale` 412, `conflict` 409, and
- * `invalid_input` or `validation` 400.
+ * Where the SCIM handler keeps users and groups. `sqlScimStore` is the default;
+ * another store can relay to a directory or a provider. Errors are `DbError`s:
+ * `not_found` answers 404, `stale` 412, `conflict` 409, and `invalid_input` or
+ * `validation` 400.
  */
 interface ScimStore {
   readonly apiVersion: 1;
@@ -103,10 +106,9 @@ interface SqlScimStoreOptions {
   readonly schema?: string | undefined;
 }
 /**
- * The SCIM store over the sso module's `scim_*` functions. Needs a
- * service-role transport. It keeps the core attributes only, so extension
- * attributes are not stored; the handler leaves the filter and paging to
- * itself.
+ * The SCIM store over the sso module's `scim_*` functions. Needs a service-role
+ * transport. It keeps the core attributes only, so extension attributes are not
+ * stored; the handler leaves the filter and paging to itself.
  */
 export declare function sqlScimStore(transport: BlockTransport, options?: SqlScimStoreOptions): ScimStore;
 type ScimSyncOperation = "create" | "replace" | "patch" | "delete";
@@ -124,8 +126,8 @@ interface ScimSyncEntry {
   readonly requestId: string | undefined;
 }
 /**
- * Records SCIM writes. The handler waits for `record` but ignores its
- * failures, so a log can never change an answer.
+ * Records SCIM writes. The handler waits for `record` but ignores its failures,
+ * so a log can never change an answer.
  */
 interface ScimSyncLog {
   readonly apiVersion: 1;
@@ -168,14 +170,17 @@ type ScimHandlerOptions = ScimHandlerBaseOptions & ({
 });
 /**
  * A SCIM 2.0 service provider (RFC 7644) as a web handler: `/Users` and
- * `/Groups` with filters, PATCH and ETags, plus the discovery endpoints.
- * Each request authenticates with an organization API key that has the
- * `scim` scope, and only touches that organization.
+ * `/Groups` with filters, PATCH and ETags, plus the discovery endpoints. Each
+ * request authenticates with an organization API key that has the `scim` scope,
+ * and only touches that organization.
  */
 export declare function scimHandler(options: ScimHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion
 //#region src/blocks/sso/scim-schema.d.ts
-/** SCIM 2.0 schema URIs and the attributes this service provider supports (RFC 7643). */
+/**
+ * SCIM 2.0 schema URIs and the attributes this service provider supports (RFC
+ * 7643).
+ */
 export declare const SCIM_USER = "urn:ietf:params:scim:schemas:core:2.0:User";
 export declare const SCIM_GROUP = "urn:ietf:params:scim:schemas:core:2.0:Group";
 interface ScimAttribute {

package/dist/blocks/sso/index.js

@@ -1,11 +1,10 @@
-import { a as ok } from "../../result-DIeYscA3.js";
+import { a as ok } from "../../result-B3m7xtRY.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
 import { t as ssoSqlOptions } from "../../options-CK5WiFwG.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-J7ZepTq2.js";
-import { C as optionalText, D as recordOf, I as textOf, R as toInstant, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-DkVZNDrj.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { n as createSsoAdmin, r as dohResolver, t as createSso } from "../../sso-BaU_6ePE.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, n as applyTemporal, o as blockCall } from "../../block-helpers-CiKtrb6g.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 createSsoAdmin, r as dohResolver, t as createSso } from "../../sso-Bt9HocgW.js";
 //#region src/blocks/sso/scim-filter.ts
 /** SCIM filters (RFC 7644 §3.4.2.2): parsing and evaluation over resource JSON. */
 /** A filter the service provider can't parse or apply: 400 `invalidFilter`. */
@@ -183,7 +182,10 @@ function lookup(record, name) {
 	const lower = name.toLowerCase();
 	for (const [key, value] of Object.entries(record)) if (key.toLowerCase() === lower) return value;
 }
-/** The URN prefix of `path` when it names one of the resource's schemas, and the rest. */
+/**
+* The URN prefix of `path` when it names one of the resource's schemas, and the
+* rest.
+*/
 function relative(resource, path) {
 	const colon = path.lastIndexOf(":");
 	if (colon === -1) return path;
@@ -250,7 +252,10 @@ function order(op, difference) {
 		default: throw new ScimFilterError(`Unknown operator ${String(op)}`);
 	}
 }
-/** Whether `resource` matches; a multi-valued attribute matches when any value does. */
+/**
+* Whether `resource` matches; a multi-valued attribute matches when any value
+* does.
+*/
 function matches(resource, filter) {
 	switch (filter.op) {
 		case "and": return matches(resource, filter.left) && matches(resource, filter.right);
@@ -434,7 +439,10 @@ function applyPatch(resource, body, urn, attributes, patchUrn) {
 }
 //#endregion
 //#region src/blocks/sso/scim-schema.ts
-/** SCIM 2.0 schema URIs and the attributes this service provider supports (RFC 7643). */
+/**
+* SCIM 2.0 schema URIs and the attributes this service provider supports (RFC
+* 7643).
+*/
 const SCIM_USER = "urn:ietf:params:scim:schemas:core:2.0:User";
 const SCIM_GROUP = "urn:ietf:params:scim:schemas:core:2.0:Group";
 const SCIM_LIST = "urn:ietf:params:scim:api:messages:2.0:ListResponse";
@@ -714,10 +722,9 @@ function stored(type, value) {
 	};
 }
 /**
-* The SCIM store over the sso module's `scim_*` functions. Needs a
-* service-role transport. It keeps the core attributes only, so extension
-* attributes are not stored; the handler leaves the filter and paging to
-* itself.
+* The SCIM store over the sso module's `scim_*` functions. Needs a service-role
+* transport. It keeps the core attributes only, so extension attributes are not
+* stored; the handler leaves the filter and paging to itself.
 */
 function sqlScimStore(transport, options = {}) {
 	const call = blockCall(transport, options.schema);
@@ -815,7 +822,10 @@ const refs = (value, base, endpoint) => Array.isArray(value) ? value.map((item)
 	...item,
 	$ref: `${base}/${endpoint}/${item["value"]}`
 } : item) : value;
-/** The resource as served: `$ref`s for the URL and `meta` from the store's fields. */
+/**
+* The resource as served: `$ref`s for the URL and `meta` from the store's
+* fields.
+*/
 function present(kind, stored, base) {
 	const { resource } = stored;
 	const endpoint = KINDS[kind].endpoint;
@@ -898,7 +908,10 @@ function groupData(input) {
 		members: members.map((member) => String(member["value"]))
 	};
 }
-/** `attributes` and `excludedAttributes` (RFC 7644 §3.4.2.5); `id` and `schemas` always stay. */
+/**
+* `attributes` and `excludedAttributes` (RFC 7644 §3.4.2.5); `id` and `schemas`
+* always stay.
+*/
 function project(doc, attributes, excluded) {
 	const always = /* @__PURE__ */ new Set(["id", "schemas"]);
 	const top = (path) => {
@@ -964,9 +977,9 @@ const KINDS = {
 };
 /**
 * A SCIM 2.0 service provider (RFC 7644) as a web handler: `/Users` and
-* `/Groups` with filters, PATCH and ETags, plus the discovery endpoints.
-* Each request authenticates with an organization API key that has the
-* `scim` scope, and only touches that organization.
+* `/Groups` with filters, PATCH and ETags, plus the discovery endpoints. Each
+* request authenticates with an organization API key that has the `scim` scope,
+* and only touches that organization.
 */
 function scimHandler(options) {
 	applyTemporal(options);

package/dist/blocks/state-machine/index.d.ts

@@ -1,10 +1,11 @@
 /// <reference lib="esnext.temporal" />
-import { t as AsyncResult } from "../../result-BREt7qOh.js";
-import { et as SaasSubjectEventData, wt as Events } from "../../events-P3raDX2E.js";
+import { t as AsyncResult } from "../../result-C6jDfedy.js";
+import { dt as SubjectRef } from "../../executor-CPyrQdjh.js";
+import { Ct as Events, et as SaasSubjectEventData } from "../../events-DbLjvxDX.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { i as CursorPageOptions, n as BlockOptions } from "../../block-helpers-CjcQM1yA.js";
-import { n as BlockHooks } from "../../block-hooks-DcPJHztl.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
+import { i as CursorPageOptions, n as BlockOptions } from "../../block-helpers-BaugZlJV.js";
+import { n as BlockHooks } from "../../block-hooks-CmjPKqQ_.js";
+import { c as BlockOf } from "../../define-block-COpcS6aT.js";
 //#region src/blocks/state-machine/state-machine.d.ts
 interface StateMachineOptions<S extends string = string> extends BlockOptions {
   /** `withBlockHooks` hooks around the client's methods. */
@@ -15,8 +16,7 @@ interface StateMachineOptions<S extends string = string> extends BlockOptions {
 /** Where a record is in its machine, from `state()`. */
 interface StatusState {
   readonly organizationId: string;
-  readonly subjectType: string;
-  readonly subjectId: string;
+  readonly subject: SubjectRef;
   readonly status: string;
   /** The machine's `order`, empty when it sets none. */
   readonly order: readonly string[];
@@ -60,29 +60,38 @@ interface StatusStage {
 }
 interface StateMachine<S extends string = string> {
   /**
-   * Sets the status as the caller: the record table's policies decide
-   * whether they may update it, and the trigger rejects a change the
-   * machine does not allow. `not_found` for a record they can't see.
+   * Sets the status as the caller: the record table's policies decide whether
+   * they may update it, and the trigger rejects a change the machine does not
+   * allow. `not_found` for a record they can't see.
    */
-  transition(subjectType: S, subjectId: string, to: string, reason?: string): AsyncResult<boolean>;
+  transition(subject: SubjectRef<S>, to: string, reason?: string): AsyncResult<boolean>;
   /**
-   * Pauses the record (`lifecycle: true`): transitions fail with
-   * `STATE_PAUSED` until `until` passes, or until `resume()` without one.
+   * Pauses the record (`lifecycle: true`): transitions fail with `STATE_PAUSED`
+   * until `until` passes, or until `resume()` without one.
    */
-  pause(subjectType: S, subjectId: string, options?: {
+  pause(subject: SubjectRef<S>, options?: {
     readonly until?: Temporal.Instant;
     readonly reason?: string;
   }): AsyncResult<boolean>;
   /** Ends a pause; `false` when the record wasn't paused. */
-  resume(subjectType: S, subjectId: string): AsyncResult<boolean>;
-  /** Turns a flag the machine lists in `flags` on or off; `false` when it already was. */
-  setFlag(subjectType: S, subjectId: string, flag: string, enabled: boolean): AsyncResult<boolean>;
+  resume(subject: SubjectRef<S>): AsyncResult<boolean>;
+  /**
+   * Turns a flag the machine lists in `flags` on or off; `false` when it
+   * already was.
+   */
+  setFlag(subject: SubjectRef<S>, flag: string, enabled: boolean): AsyncResult<boolean>;
   /** The record's status, progress, flags, pause and pinned version. */
-  state(subjectType: S, subjectId: string): AsyncResult<StatusState>;
-  /** Status changes, newest first; page with the last `createdAt` as `cursor`. Default 50, at most 500. */
-  history(subjectType: S, subjectId: string, page?: CursorPageOptions<Temporal.Instant>): AsyncResult<readonly StatusChange[]>;
-  /** The stages timeline in display order; empty for a machine without `stages: true`. */
-  stages(subjectType: S, subjectId: string): AsyncResult<readonly StatusStage[]>;
+  state(subject: SubjectRef<S>): AsyncResult<StatusState>;
+  /**
+   * Status changes, newest first; page with the last `createdAt` as `cursor`.
+   * Default 50, at most 500.
+   */
+  history(subject: SubjectRef<S>, page?: CursorPageOptions<Temporal.Instant>): AsyncResult<readonly StatusChange[]>;
+  /**
+   * The stages timeline in display order; empty for a machine without `stages:
+   * true`.
+   */
+  stages(subject: SubjectRef<S>): AsyncResult<readonly StatusStage[]>;
 }
 /** The `state-machine` SQL module as typed calls. */
 export declare function createStateMachine<S extends string = string>(options: StateMachineOptions<S>): StateMachine<S>;

package/dist/blocks/state-machine/index.js

@@ -1,16 +1,16 @@
 import { t as stateMachineSqlOptions } from "../../options-B0FcEKtH.js";
-import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
-import { A as requiredInstant, C as optionalText, D as recordOf, F as stringsOf, I as textOf, S as optionalInstant, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, w as pageOf } from "../../block-helpers-DkVZNDrj.js";
-import { r as withBlockHooks } from "../../block-hooks-C22vuIUd.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { A as requiredInstant, C as optionalText, D as recordOf, F as stringsOf, I as textOf, S as optionalInstant, k as recordsOf, m as instantArg, n as applyTemporal, o as blockCall, w as pageOf } from "../../block-helpers-CiKtrb6g.js";
+import { r as withBlockHooks } from "../../block-hooks-BymdcD0V.js";
+import { n as event, t as defineEvents } from "../../event-map-CtPFhcOp.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { i as subjectRefOf } from "../../block-subjects-Dzq5Xn_0.js";
 //#region src/blocks/state-machine/state-machine.ts
 const optionalNumber = (value) => value === null || value === void 0 ? void 0 : Number(value);
 function stateOf(value) {
 	const row = recordOf(value, "status_state");
 	return {
 		organizationId: textOf(row["organizationId"]),
-		subjectType: textOf(row["subjectType"]),
-		subjectId: textOf(row["subjectId"]),
+		subject: subjectRefOf(row["subjectType"], row["subjectId"]),
 		status: textOf(row["status"]),
 		order: stringsOf(row["order"]),
 		step: optionalNumber(row["step"]),
@@ -50,41 +50,41 @@ function createStateMachine(options) {
 	const call = blockCall(options.transport, options.schema, options.mappers);
 	const isTrue = (value) => value === true;
 	return withBlockHooks({
-		transition: (subjectType, subjectId, to, reason) => call("transition", {
-			subject_type: subjectType,
-			subject_id: subjectId,
+		transition: (subject, to, reason) => call("transition", {
+			subject_type: subject.type,
+			subject_id: subject.id,
 			to_status: to,
 			reason: reason ?? null
 		}, isTrue),
-		pause: (subjectType, subjectId, pause = {}) => call("pause_lifecycle", {
-			subject_type: subjectType,
-			subject_id: subjectId,
+		pause: (subject, pause = {}) => call("pause_lifecycle", {
+			subject_type: subject.type,
+			subject_id: subject.id,
 			until: instantArg(pause.until) ?? null,
 			reason: pause.reason ?? null
 		}, isTrue),
-		resume: (subjectType, subjectId) => call("resume_lifecycle", {
-			subject_type: subjectType,
-			subject_id: subjectId
+		resume: (subject) => call("resume_lifecycle", {
+			subject_type: subject.type,
+			subject_id: subject.id
 		}, isTrue),
-		setFlag: (subjectType, subjectId, flag, enabled) => call("set_lifecycle_flag", {
-			subject_type: subjectType,
-			subject_id: subjectId,
+		setFlag: (subject, flag, enabled) => call("set_lifecycle_flag", {
+			subject_type: subject.type,
+			subject_id: subject.id,
 			flag,
 			enabled
 		}, isTrue),
-		state: (subjectType, subjectId) => call("status_state", {
-			subject_type: subjectType,
-			subject_id: subjectId
+		state: (subject) => call("status_state", {
+			subject_type: subject.type,
+			subject_id: subject.id
 		}, stateOf),
-		history: (subjectType, subjectId, page) => call("list_status_history", {
-			subject_type: subjectType,
-			subject_id: subjectId,
+		history: (subject, page) => call("list_status_history", {
+			subject_type: subject.type,
+			subject_id: subject.id,
 			before: instantArg(pageOf(page).cursor),
 			max_rows: page?.limit
 		}, (value) => recordsOf(value, "list_status_history").map(changeOf)),
-		stages: (subjectType, subjectId) => call("list_status_stages", {
-			subject_type: subjectType,
-			subject_id: subjectId
+		stages: (subject) => call("list_status_stages", {
+			subject_type: subject.type,
+			subject_id: subject.id
 		}, (value) => recordsOf(value, "list_status_stages").map(stageOf))
 	}, options.hooks, {
 		block: "state-machine",

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

@@ -0,0 +1,11 @@
+import { dt as SubjectRef } from "../../executor-CPyrQdjh.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-d53POsem.js";
+import { c as BlockOf } from "../../define-block-COpcS6aT.js";
+import { t as subjectKey } from "../../block-subjects-FHwLlIHU.js";
+import { c as Subjects, d as MY_WORK_KINDS, f as MyWorkKind, l as SubjectsOptions, n as MyWorkItem, o as ResolvedSubject, r as MyWorkOptions, s as SUBJECT_TITLES_LIMIT, t as MY_WORK_LIMIT, u as createSubjects } from "../../subjects-DXFmanh5.js";
+import { a as batchSubjects, i as SubjectsSnapshot, n as SubjectsController, o as createSubjectsController, r as SubjectsControllerOptions, t as SubjectsActions } from "../../client-Do5hykMK.js";
+//#region src/blocks/subjects/manifest.d.ts
+/** The `subjects` block's manifest (ADR 0029). */
+export declare const subjectsBlock: BlockOf<"subjects", typeof createSubjects>;
+//#endregion
+export { type BlockTransport, MY_WORK_KINDS, MY_WORK_LIMIT, type MyWorkItem, type MyWorkKind, type MyWorkOptions, type ResolvedSubject, SUBJECT_TITLES_LIMIT, type SubjectRef, type Subjects, type SubjectsActions, type SubjectsController, type SubjectsControllerOptions, type SubjectsOptions, type SubjectsSnapshot, batchSubjects, createSubjects, createSubjectsController, dbTransport, rpcTransport, sqlTransport, subjectKey };

package/dist/blocks/subjects/index.js

@@ -0,0 +1,21 @@
+import { B as dbTransport, H as rpcTransport, U as sqlTransport } from "../../block-helpers-CiKtrb6g.js";
+import { t as MY_WORK_KINDS } from "../../my-work-kinds-BU3SlA-6.js";
+import { n as defineBlock } from "../../define-block-Dze77QTw.js";
+import { r as subjectKey } from "../../block-subjects-Dzq5Xn_0.js";
+import { n as SUBJECT_TITLES_LIMIT, r as createSubjects, t as MY_WORK_LIMIT } from "../../subjects-DevU_atb.js";
+import { n as createSubjectsController, t as batchSubjects } from "../../client-CVToJ4uI.js";
+//#region src/blocks/subjects/manifest.ts
+/** The `subjects` block's manifest (ADR 0029). */
+const subjectsBlock = defineBlock({
+	name: "subjects",
+	sql: ["subjects"],
+	create: createSubjects,
+	category: "identity",
+	recipes: [
+		"subject-link",
+		"subject-chip",
+		"my-work"
+	]
+});
+//#endregion
+export { MY_WORK_KINDS, MY_WORK_LIMIT, SUBJECT_TITLES_LIMIT, batchSubjects, createSubjects, createSubjectsController, dbTransport, rpcTransport, sqlTransport, subjectKey, subjectsBlock };

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

@@ -0,0 +1,31 @@
+import { dt as SubjectRef } from "../../../executor-CPyrQdjh.js";
+import { o as ResolvedSubject } from "../../../subjects-DXFmanh5.js";
+import { i as SubjectsSnapshot, t as SubjectsActions } from "../../../client-Do5hykMK.js";
+//#region src/blocks/subjects/react/index.d.ts
+export interface SubjectsState extends SubjectsSnapshot, SubjectsActions {
+  /** The resolved subject of `ref`, or `undefined` while loading or unreadable. */
+  readonly get: (ref: SubjectRef) => ResolvedSubject | undefined;
+}
+/**
+ * Titles and paths of `refs` from `config.subjects`. The hooks rendered in the
+ * same tick share one `subject_titles` call, so a list of rows that each show a
+ * subject link costs one round trip.
+ *
+ * ```tsx
+ * const { get } = useSubjects(rows.map((row) => row.subject));
+ * ```
+ */
+export declare function useSubjects(refs: readonly SubjectRef[]): SubjectsState;
+export interface SubjectState {
+  /** `undefined` while loading, `null` when the caller can't read it. */
+  readonly subject: ResolvedSubject | null | undefined;
+  readonly error: SubjectsSnapshot["error"];
+  readonly refresh: SubjectsActions["refresh"];
+}
+/**
+ * One subject's title and path, batched with the other `useSubject` and
+ * `useSubjects` calls of the same render.
+ */
+export declare function useSubject(ref: SubjectRef | null | undefined): SubjectState;
+//#endregion
+export type { ResolvedSubject };

package/dist/blocks/subjects/react/index.js

@@ -0,0 +1,60 @@
+"use client";
+import { t as useController } from "../../../react-controller-CKSdtJ10.js";
+import { t as useBlockEnv } from "../../../react-env-CfA3EdBH.js";
+import { r as subjectKey } from "../../../block-subjects-Dzq5Xn_0.js";
+import { t as envBlockOptions } from "../../../block-env-options-2e6IQrSw.js";
+import { r as createSubjects } from "../../../subjects-DevU_atb.js";
+import { n as createSubjectsController, t as batchSubjects } from "../../../client-CVToJ4uI.js";
+//#region src/blocks/subjects/react/index.ts
+const sources = /* @__PURE__ */ new WeakMap();
+/** One batched subjects client per supabase-js client, shared by its hooks. */
+function sourceOf(env) {
+	let source = sources.get(env.supabase);
+	if (source === void 0) {
+		source = batchSubjects(createSubjects(envBlockOptions(env, "subjects")));
+		sources.set(env.supabase, source);
+	}
+	return source;
+}
+/**
+* Titles and paths of `refs` from `config.subjects`. The hooks rendered in the
+* same tick share one `subject_titles` call, so a list of rows that each show a
+* subject link costs one round trip.
+*
+* ```tsx
+* const { get } = useSubjects(rows.map((row) => row.subject));
+* ```
+*/
+function useSubjects(refs) {
+	const env = useBlockEnv();
+	const key = [...new Set(refs.map((ref) => JSON.stringify([ref.type, ref.id])))].toSorted().join("\n");
+	const { view } = useController(() => createSubjectsController({
+		client: sourceOf(env),
+		auth: env.auth,
+		refs: key === "" ? [] : key.split("\n").map((line) => {
+			const [type, id] = JSON.parse(line);
+			return {
+				type,
+				id
+			};
+		})
+	}), [env, key]);
+	return {
+		...view,
+		get: (ref) => view.subjects?.[subjectKey(ref)]
+	};
+}
+/**
+* One subject's title and path, batched with the other `useSubject` and
+* `useSubjects` calls of the same render.
+*/
+function useSubject(ref) {
+	const { subjects, error, get, refresh } = useSubjects(ref ? [ref] : []);
+	return {
+		subject: ref === null || ref === void 0 ? null : subjects === void 0 ? void 0 : get(ref) ?? null,
+		error,
+		refresh
+	};
+}
+//#endregion
+export { useSubject, useSubjects };

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

@@ -0,0 +1,9 @@
+import { o as ResolvedSubject } from "../../../subjects-DXFmanh5.js";
+import { SubjectState, SubjectsState, useSubject as useSubject$1, useSubjects as useSubjects$1 } from "./index.js";
+//#region src/blocks/subjects/react/server.d.ts
+/** The `react-server` build of `useSubjects`. */
+export declare const useSubjects: typeof useSubjects$1;
+/** The `react-server` build of `useSubject`. */
+export declare const useSubject: typeof useSubject$1;
+//#endregion
+export type { ResolvedSubject, SubjectState, SubjectsState };

package/dist/blocks/subjects/react/server.js

@@ -0,0 +1,12 @@
+//#region src/blocks/subjects/react/server.ts
+const clientOnly = (name) => /* @__PURE__ */ new Error(`better-supabase: ${name} runs in Client Components only. In Server Components call \`createBlockClient(db, subjectsBlock).resolve(refs)\` instead.`);
+/** The `react-server` build of `useSubjects`. */
+const useSubjects = () => {
+	throw clientOnly("useSubjects()");
+};
+/** The `react-server` build of `useSubject`. */
+const useSubject = () => {
+	throw clientOnly("useSubject()");
+};
+//#endregion
+export { useSubject, useSubjects };

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

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as SolidController } from "../../../solid-bind-C1jeq4Qm.js";
+import { i as SubjectsSnapshot, r as SubjectsControllerOptions, t as SubjectsActions } from "../../../client-Do5hykMK.js";
+//#region src/blocks/subjects/solid/index.d.ts
+/**
+ * `createSubjectsController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useSubjects(options: BlockOptions<SubjectsControllerOptions>): SolidController<SubjectsSnapshot, SubjectsActions>;
+//#endregion
+export type { BlockOptions, SolidController, SubjectsActions, SubjectsControllerOptions, SubjectsSnapshot };

package/dist/blocks/subjects/solid/index.js

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../solid-controller-DGuv7V8a.js";
+import { n as createSubjectsController } from "../../../client-CVToJ4uI.js";
+//#region src/blocks/subjects/solid/index.ts
+/**
+* `createSubjectsController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useSubjects(options) {
+	return useBlockController(createSubjectsController, options);
+}
+//#endregion
+export { useSubjects };

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

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as SvelteController } from "../../../svelte-bind-Ja6CtQGp.js";
+import { i as SubjectsSnapshot, r as SubjectsControllerOptions, t as SubjectsActions } from "../../../client-Do5hykMK.js";
+//#region src/blocks/subjects/svelte/index.d.ts
+/**
+ * `createSubjectsController` as a Svelte readable store of the snapshot, with
+ * the actions on `.actions`. Call it in a component's script; the work starts
+ * on mount and the controller is disposed with the component. `auth` and
+ * `ports` default to the client of `setBetterSupabase(bs)`.
+ */
+export declare function useSubjects(options: BlockOptions<SubjectsControllerOptions>): SvelteController<SubjectsSnapshot, SubjectsActions>;
+//#endregion
+export type { BlockOptions, SubjectsActions, SubjectsControllerOptions, SubjectsSnapshot, SvelteController };

package/dist/blocks/subjects/svelte/index.js

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../svelte-controller-oFKC9AYu.js";
+import { n as createSubjectsController } from "../../../client-CVToJ4uI.js";
+//#region src/blocks/subjects/svelte/index.ts
+/**
+* `createSubjectsController` as a Svelte readable store of the snapshot, with
+* the actions on `.actions`. Call it in a component's script; the work starts
+* on mount and the controller is disposed with the component. `auth` and
+* `ports` default to the client of `setBetterSupabase(bs)`.
+*/
+function useSubjects(options) {
+	return useBlockController(createSubjectsController, options);
+}
+//#endregion
+export { useSubjects };

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

@@ -0,0 +1,13 @@
+import { t as BlockOptions } from "../../../block-env-kFcaaJLM.js";
+import { t as VueController } from "../../../vue-bind-TPkbLl4z.js";
+import { i as SubjectsSnapshot, r as SubjectsControllerOptions, t as SubjectsActions } from "../../../client-Do5hykMK.js";
+//#region src/blocks/subjects/vue/index.d.ts
+/**
+ * `createSubjectsController` as a Vue composable: `state` is a shallow ref of
+ * the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+ * and the controller is disposed with the scope. `auth` and `ports` default to
+ * the client of `app.use(betterSupabase(bs))`.
+ */
+export declare function useSubjects(options: BlockOptions<SubjectsControllerOptions>): VueController<SubjectsSnapshot, SubjectsActions>;
+//#endregion
+export type { BlockOptions, SubjectsActions, SubjectsControllerOptions, SubjectsSnapshot, VueController };

package/dist/blocks/subjects/vue/index.js

@@ -0,0 +1,14 @@
+import { t as useBlockController } from "../../../vue-controller-WtbuT-Ux.js";
+import { n as createSubjectsController } from "../../../client-CVToJ4uI.js";
+//#region src/blocks/subjects/vue/index.ts
+/**
+* `createSubjectsController` as a Vue composable: `state` is a shallow ref of
+* the snapshot. Call it in `setup` or an effect scope; the work starts on mount
+* and the controller is disposed with the scope. `auth` and `ports` default to
+* the client of `app.use(betterSupabase(bs))`.
+*/
+function useSubjects(options) {
+	return useBlockController(createSubjectsController, options);
+}
+//#endregion
+export { useSubjects };