better-supabase 0.12.0 → 0.14.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-BREt7qOh.js";
-import { dt as TemplateEventData, ut as TemplateApplicationEventData, wt as Events } from "../../events-P3raDX2E.js";
+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 { n as Logger } from "../../logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "../../standard-BcUQuUgu.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 { n as BlockHooks } from "../../block-hooks-DcPJHztl.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-DnaDbgZS.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
-import { t as ComposedEmail } from "../../email-BcmbIWOX.js";
-import { O as WorkflowStepInfo, _ as WorkflowBuilder } from "../../types-Bels39_u.js";
-import { i as GraphStepCall } from "../../executor-BWgJNbGh.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 { 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";
 //#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";
@@ -29,13 +29,15 @@ type MergeValues<K extends string = string> = { readonly [P in K]?: unknown; } &
 interface RenderMergeFieldsOptions {
   /** Default `text`. `{{{ name }}}` is never escaped. */
   readonly escape?: MergeEscape;
-  /** What a field without a value renders as: `empty` (default) or the `{{ name }}` it was. */
+  /**
+   * What a field without a value renders as: `empty` (default) or the `{{ name
+   * }}` it was.
+   */
   readonly missing?: "empty" | "keep";
   /**
-   * Turns a value into text. The default prints strings, numbers and
-   * booleans as they are, Temporal values and other objects with their own
-   * `toString`, a `Date` as ISO 8601, arrays joined by `, `, and plain
-   * objects as JSON.
+   * Turns a value into text. The default prints strings, numbers and booleans
+   * as they are, Temporal values and other objects with their own `toString`, a
+   * `Date` as ISO 8601, arrays joined by `, `, and plain objects as JSON.
    */
   readonly format?: (value: unknown, name: string) => string;
 }
@@ -44,7 +46,10 @@ interface MergeFieldCatalog<K extends string = string> {
   readonly subjectType: string;
   readonly fields: Readonly<Record<K, MergeFieldSpec>>;
   readonly names: readonly K[];
-  /** The fields `text` uses that the catalog doesn't define, in order of first use. */
+  /**
+   * The fields `text` uses that the catalog doesn't define, in order of first
+   * use.
+   */
   unknown(text: string): readonly string[];
   /** `renderMergeFields` with values typed by the catalog. */
   render(text: string, values: MergeValues<K>, options?: RenderMergeFieldsOptions): string;
@@ -55,14 +60,14 @@ interface MergeFieldCatalog<K extends string = string> {
 export declare function mergeFieldsIn(text: string): readonly string[];
 /**
  * Replaces each `{{ name }}` in `text` with its value, escaped for HTML with
- * `escape: "html"`, and each `{{{ name }}}` with its value unescaped. It
- * has no dependencies and runs on every WinterTC runtime.
+ * `escape: "html"`, and each `{{{ name }}}` with its value unescaped. It has no
+ * dependencies and runs on every WinterTC runtime.
  */
 export declare function renderMergeFields(text: string, values: Readonly<Record<string, unknown>>, options?: RenderMergeFieldsOptions): string;
 /**
- * The merge fields a record type offers, such as an invoice's
- * `customer.name` and `total`. The catalog types `render` and lists the
- * fields a template uses that it doesn't define.
+ * The merge fields a record type offers, such as an invoice's `customer.name`
+ * and `total`. The catalog types `render` and lists the fields a template uses
+ * that it doesn't define.
  */
 export declare function defineMergeFields<const K extends string>(subjectType: string, fields: Readonly<Record<K, MergeFieldSpec>>): MergeFieldCatalog<K>;
 /** An email body with merge fields, as an email template stores it. */
@@ -76,8 +81,8 @@ interface TemplateEmailOptions extends Pick<RenderMergeFieldsOptions, "missing"
   readonly templateKey?: string;
 }
 /**
- * Renders an email template for the notifications email channel's
- * `compose`: the subject and text as text, the HTML escaped for HTML.
+ * Renders an email template for the notifications email channel's `compose`:
+ * the subject and text as text, the HTML escaped for HTML.
  */
 export declare function composeTemplateEmail(body: EmailTemplateBody, values: Readonly<Record<string, unknown>>, options?: TemplateEmailOptions): ComposedEmail;
 //#endregion
@@ -94,8 +99,8 @@ interface TemplateType<Settings = unknown, Body = unknown> {
   readonly body?: StandardSchemaV1<unknown, Body>;
   readonly mergeFields?: MergeFieldCatalog;
   /**
-   * Creates the record from the published snapshot and names it. A method,
-   * so a type with typed settings is still a `TemplateType` in `types`.
+   * Creates the record from the published snapshot and names it. A method, so a
+   * type with typed settings is still a `TemplateType` in `types`.
    */
   apply?(call: TemplateApplyCall<Settings, Body>): TemplateApplied | Promise<TemplateApplied>;
 }
@@ -109,9 +114,9 @@ interface TemplateApplyCall<Settings = unknown, Body = unknown> {
   /** The values `apply` was called with, such as merge field values. */
   readonly values: Readonly<Record<string, unknown>>;
   /**
-   * The caller's idempotency key, when it has one (the `templates.apply`
-   * step passes `<runKey>:<node>`), so a retried apply can find the record
-   * it created.
+   * The caller's idempotency key, when it has one (the `templates.apply` step
+   * passes `<runKey>:<node>`), so a retried apply can find the record it
+   * created.
    */
   readonly key?: string;
 }
@@ -243,25 +248,34 @@ interface TemplateApplyResult {
 }
 interface Templates<F extends object = Record<never, never>> {
   save(input: TemplateInput<F>): AsyncResult<Template<F>>;
-  /** The organization's templates and the system ones (only those with `null`), defaults first. */
+  /**
+   * The organization's templates and the system ones (only those with `null`),
+   * defaults first.
+   */
   list(organizationId: string | null, filter?: {
     readonly type?: string;
     readonly language?: string;
   }): AsyncResult<readonly Template<F>[]>;
-  /** With its newest published version and its draft; `undefined` when the caller can't read it. */
+  /**
+   * With its newest published version and its draft; `undefined` when the
+   * caller can't read it.
+   */
   get(id: string): AsyncResult<TemplateDetail<F> | undefined>;
   remove(id: string): AsyncResult<boolean>;
-  /** Makes it the default for its organization, type and language (or stops it being one). */
+  /**
+   * Makes it the default for its organization, type and language (or stops it
+   * being one).
+   */
   setDefault(id: string, isDefault?: boolean): AsyncResult<boolean>;
   /**
-   * Copies the newest published version of a system template (or one of
-   * the organization's) into a new template there, published as version 1,
-   * with its workflow attachments.
+   * Copies the newest published version of a system template (or one of the
+   * organization's) into a new template there, published as version 1, with its
+   * workflow attachments.
    */
   fork(source: string, organizationId: string): AsyncResult<Template<F>>;
   /**
-   * Upserts the system templates by key and publishes a new version of
-   * each whose body changed. Service role. Returns how many it published.
+   * Upserts the system templates by key and publishes a new version of each
+   * whose body changed. Service role. Returns how many it published.
    */
   sync(starters: readonly TemplateStarter[]): AsyncResult<number>;
   readonly versions: {
@@ -278,9 +292,9 @@ interface Templates<F extends object = Record<never, never>> {
     list(template: string): AsyncResult<readonly TemplateWorkflow[]>;
   };
   /**
-   * Creates a record from the template's newest published version through
-   * its type's `apply`, records the application and starts the attached
-   * workflows on the new record. `templates.apply` in `into`.
+   * Creates a record from the template's newest published version through its
+   * type's `apply`, records the application and starts the attached workflows
+   * on the new record. `templates.apply` in `into`.
    */
   apply(template: string, options: ApplyOptions): AsyncResult<TemplateApplyResult>;
   readonly applications: {
@@ -293,12 +307,15 @@ interface Templates<F extends object = Record<never, never>> {
 }
 interface TemplatesOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
   readonly transport: BlockTransport;
-  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. */
+  /**
+   * The module schema, or its API schema: `defineBlocks` passes it from
+   * `blocks.generated.ts`.
+   */
   readonly schema?: string;
   /**
    * 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`.
+   * (`blocks.templates.options.extraColumns`), keyed by database name. It types
+   * and parses them on reads, and validates them on `save`.
    */
   readonly fields?: S;
   /** The template types, by name. A type without `apply` can't be applied. */
@@ -312,9 +329,9 @@ interface TemplatesOptions<S extends StandardSchemaV1 | undefined = undefined> e
   readonly mappers?: readonly ErrorMapper[];
 }
 /**
- * The `templates` SQL module as typed calls: typed, versioned templates
- * that create records, system starters and forks, and the workflows each
- * record starts.
+ * The `templates` SQL module as typed calls: typed, versioned templates that
+ * create records, system starters and forks, and the workflows each record
+ * starts.
  */
 export declare function createTemplates<S extends StandardSchemaV1 | undefined = undefined>(options: TemplatesOptions<S>): Templates<FieldsOf<S>>;
 //#endregion
@@ -338,11 +355,10 @@ interface TemplatesApplyOutput {
 }
 /**
  * Runs a `templates.apply` node: applies `config.template` in the run's
- * organization, with `config.values`, and keys the apply on
- * `<runKey>:<node>` so the type's `apply` can find the record a retry
- * already created. Pass the client, or a function that builds one for the
- * call (for example as the run's actor). Throws a `DbException` on error,
- * which fails the node.
+ * organization, with `config.values`, and keys the apply on `<runKey>:<node>`
+ * so the type's `apply` can find the record a retry already created. Pass the
+ * client, or a function that builds one for the call (for example as the run's
+ * actor). Throws a `DbException` on error, which fails the node.
  */
 export declare function templatesApplyStep(templates: Templates | ((call: GraphStepCall) => Templates | Promise<Templates>)): (call: GraphStepCall) => Promise<TemplatesApplyOutput>;
 //#endregion

package/dist/blocks/templates/index.js

@@ -1,15 +1,14 @@
-import { t as DbException } from "../../db-exception-CnWcYPxL.js";
-import { n as dbError } from "../../errors-BV1SKTVs.js";
-import { a as ok, r as err, t as AsyncResult } from "../../result-DIeYscA3.js";
+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 isRecord } from "../../guards-6F2bCtQR.js";
-import { n as validate } from "../../standard-B1BigegP.js";
+import { n as validate } from "../../standard-DtkpFGkS.js";
 import { t as templatesSqlOptions } from "../../options-Fz6xqu-b.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 { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, O as recordOrEmpty, S as optionalInstant, d as enumOrThrow, k as recordsOf, n as applyTemporal, o as blockCall, r as asDbError } from "../../block-helpers-DkVZNDrj.js";
-import { r as withBlockHooks } from "../../block-hooks-C22vuIUd.js";
-import { n as blockFields } from "../../block-fields-Bv1hV855.js";
-import { n as defineBlock } from "../../define-block-B6Gjs57G.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 { 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";
 //#region src/blocks/templates/templates.ts
 const SCOPES = ["tenant", "system"];
 /** Declares a template type with its schemas typed. */
@@ -98,9 +97,9 @@ async function checked(schema, value, label) {
 	return schema === void 0 ? ok(value) : validate(schema, value, label);
 }
 /**
-* The `templates` SQL module as typed calls: typed, versioned templates
-* that create records, system starters and forks, and the workflows each
-* record starts.
+* The `templates` SQL module as typed calls: typed, versioned templates that
+* create records, system starters and forks, and the workflows each record
+* starts.
 */
 function createTemplates(options) {
 	applyTemporal(options);
@@ -326,8 +325,8 @@ function mergeFieldsIn(text) {
 }
 /**
 * Replaces each `{{ name }}` in `text` with its value, escaped for HTML with
-* `escape: "html"`, and each `{{{ name }}}` with its value unescaped. It
-* has no dependencies and runs on every WinterTC runtime.
+* `escape: "html"`, and each `{{{ name }}}` with its value unescaped. It has no
+* dependencies and runs on every WinterTC runtime.
 */
 function renderMergeFields(text, values, options = {}) {
 	const html = options.escape === "html";
@@ -341,9 +340,9 @@ function renderMergeFields(text, values, options = {}) {
 	});
 }
 /**
-* The merge fields a record type offers, such as an invoice's
-* `customer.name` and `total`. The catalog types `render` and lists the
-* fields a template uses that it doesn't define.
+* The merge fields a record type offers, such as an invoice's `customer.name`
+* and `total`. The catalog types `render` and lists the fields a template uses
+* that it doesn't define.
 */
 function defineMergeFields(subjectType, fields) {
 	const names = Object.keys(fields);
@@ -367,8 +366,8 @@ function defineMergeFields(subjectType, fields) {
 	};
 }
 /**
-* Renders an email template for the notifications email channel's
-* `compose`: the subject and text as text, the HTML escaped for HTML.
+* Renders an email template for the notifications email channel's `compose`:
+* the subject and text as text, the HTML escaped for HTML.
 */
 function composeTemplateEmail(body, values, options = {}) {
 	const shared = {
@@ -430,11 +429,10 @@ const TEMPLATES_APPLY_STEP = {
 };
 /**
 * Runs a `templates.apply` node: applies `config.template` in the run's
-* organization, with `config.values`, and keys the apply on
-* `<runKey>:<node>` so the type's `apply` can find the record a retry
-* already created. Pass the client, or a function that builds one for the
-* call (for example as the run's actor). Throws a `DbException` on error,
-* which fails the node.
+* organization, with `config.values`, and keys the apply on `<runKey>:<node>`
+* so the type's `apply` can find the record a retry already created. Pass the
+* client, or a function that builds one for the call (for example as the run's
+* actor). Throws a `DbException` on error, which fails the node.
 */
 function templatesApplyStep(templates) {
 	return async (call) => {

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

@@ -1,26 +1,30 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, t as AsyncResult } from "../../result-BREt7qOh.js";
-import { ft as TimeEntryEventData, pt as TimesheetEventData, wt as Events } from "../../events-P3raDX2E.js";
+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 { n as Logger } from "../../logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "../../standard-BcUQuUgu.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 { n as BlockHooks } from "../../block-hooks-DcPJHztl.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-DnaDbgZS.js";
-import { t as CloudEvent } from "../../cloud-event-DXkNoI6v.js";
-import { s as BlockOf } from "../../define-block-BHxLHLys.js";
-import { n as Money } from "../../money-DFpWzQvk.js";
-import { n as MetricDefinition } from "../../metric-definition-95HFoW1V.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 { n as Money } from "../../money-BNRdJQzA.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 {
+interface TimeTrackingOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions, BlockTenantOptions {
   readonly transport: BlockTransport;
-  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. */
+  /**
+   * The module schema, or its API schema: `defineBlocks` passes it from
+   * `blocks.generated.ts`.
+   */
   readonly schema?: string;
   /**
    * A Standard Schema for the entry's extra columns
-   * (`blocks.time-tracking.options.extraColumns`), keyed by database name.
-   * It types and parses them on reads, and validates them on `start`, `log`
-   * and `update`.
+   * (`blocks.time-tracking.options.extraColumns`), keyed by database name. It
+   * types and parses them on reads, and validates them on `start`, `log` and
+   * `update`.
    */
   readonly fields?: S;
   /** `withBlockHooks` hooks around the client's methods. */
@@ -34,8 +38,8 @@ interface TimeEntry<F extends object = Record<never, never>> {
   readonly id: string;
   readonly organizationId: string;
   readonly userId: string;
-  readonly subjectType?: string;
-  readonly subjectId?: string;
+  /** The record the time is tracked on; `undefined` for an unattached entry. */
+  readonly subject: SubjectRef | undefined;
   readonly startedAt: Temporal.Instant;
   /** Missing while the timer runs. */
   readonly endedAt?: Temporal.Instant;
@@ -52,8 +56,8 @@ 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>> {
-  readonly subjectType?: string;
-  readonly subjectId?: string;
+  /** The record the time is on. Default: none. */
+  readonly subject?: SubjectRef;
   readonly billable?: boolean;
   /** The hourly rate, in minor units of its currency. */
   readonly rate?: Money;
@@ -71,10 +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?: {
-    readonly subjectType: string;
-    readonly subjectId: string;
-  } | null;
+  readonly subject?: SubjectRef | null;
   readonly billable?: boolean;
   readonly rate?: Money | null;
   readonly note?: string | null;
@@ -90,8 +91,8 @@ interface TimeEntryListOptions {
   readonly from?: Temporal.Instant;
   /** Entries that start before this instant. */
   readonly to?: Temporal.Instant;
-  readonly subjectType?: string;
-  readonly subjectId?: string;
+  /** Entries on this record only. */
+  readonly subject?: SubjectRef;
   readonly pageSize?: number;
 }
 type TimesheetStatus = "open" | "submitted" | "approved" | "rejected";
@@ -131,25 +132,33 @@ interface TimesheetListOptions {
   /** Weeks before this one, for the next page. */
   readonly before?: Temporal.PlainDate;
 }
+/**
+ * `F` is the extra fields `options.fields` describes. The methods that don't
+ * take an entry or timesheet id act in the block's `tenant`.
+ */
 interface TimeTracking<F extends object = Record<never, never>> {
-  /** Starts a timer for the caller and stops the one that runs. */
-  start(organizationId: string, fields?: TimeEntryFields<F>): AsyncResult<TimeEntry<F>>;
-  stop(organizationId: string): AsyncResult<TimeEntry<F>>;
+  /**
+   * Starts a timer for the caller, on `fields.subject` when set, and stops the
+   * one that runs.
+   */
+  start(fields?: TimeEntryFields<F>): AsyncResult<TimeEntry<F>>;
+  stop(): AsyncResult<TimeEntry<F>>;
   /** The caller's running timer. */
-  running(organizationId: string): AsyncResult<TimeEntry<F> | undefined>;
-  log(organizationId: string, input: LogTimeInput<F>): AsyncResult<TimeEntry<F>>;
+  running(): AsyncResult<TimeEntry<F> | undefined>;
+  /** Records a finished entry, on `input.subject` when set. */
+  log(input: LogTimeInput<F>): AsyncResult<TimeEntry<F>>;
   update(entryId: string, patch: TimeEntryPatch<F>): AsyncResult<TimeEntry<F>>;
   remove(entryId: string): AsyncResult<TimeEntry<F>>;
   /** Newest first. */
-  list(organizationId: string, options?: TimeEntryListOptions): AsyncResult<readonly TimeEntry<F>[]>;
+  list(options?: TimeEntryListOptions): AsyncResult<readonly TimeEntry<F>[]>;
   /** A member's week (the caller's by default) with its entries and totals. */
-  timesheet(organizationId: string, week: Temporal.PlainDate, userId?: string): AsyncResult<TimesheetDetail<F>>;
+  timesheet(week: Temporal.PlainDate, userId?: string): AsyncResult<TimesheetDetail<F>>;
   /** Sends the caller's week for approval; it locks until a rejection. */
-  submit(organizationId: string, week: Temporal.PlainDate, note?: string): AsyncResult<Timesheet>;
+  submit(week: Temporal.PlainDate, note?: string): AsyncResult<Timesheet>;
   /** Unlocks an approved week; needs `time_tracking.manage`. */
   reopen(timesheetId: string): AsyncResult<Timesheet>;
   /** Newest week first. */
-  timesheets(organizationId: string, options?: TimesheetListOptions): AsyncResult<readonly Timesheet[]>;
+  timesheets(options?: TimesheetListOptions): AsyncResult<readonly Timesheet[]>;
 }
 /** The `time-tracking` SQL module as typed calls. */
 export declare function createTimeTracking<S extends StandardSchemaV1 | undefined = undefined>(options: TimeTrackingOptions<S>): TimeTracking<FieldsOf<S>>;
@@ -168,7 +177,10 @@ type TimeTrackingMetrics = readonly [MetricDefinition<"time_tracked", "billable"
  * `subject_type`. Running timers count once they stop.
  */
 export declare function timeTrackingMetrics(options?: TimeTrackingMetricsOptions): TimeTrackingMetrics;
-/** The events that change `timeTrackingMetrics`, for `metricsSink` or `createBlocks({ metricEvents })`. */
+/**
+ * The events that change `timeTrackingMetrics`, for `metricsSink` or
+ * `createBlocks({ metricEvents })`.
+ */
 export declare const TIME_TRACKING_METRIC_EVENTS: {
   readonly "time_entry.recorded": readonly ["time_tracked"];
   readonly "time_entry.updated": readonly ["time_tracked"];
@@ -177,19 +189,25 @@ export declare const TIME_TRACKING_METRIC_EVENTS: {
 /**
  * The entry's `startedAt`, the time its seconds are bucketed by, for
  * `metricsSink({ time })` or `createBlocks({ metricTime })`. An update that
- * moves the entry to another day also returns its `previousStartedAt`, so
- * the old day's total drops. Undefined for other events, so they keep
- * their own time.
+ * moves the entry to another day also returns its `previousStartedAt`, so the
+ * old day's total drops. Undefined for other events, so they keep their own
+ * time.
  */
 export declare function timeEntryMetricTime(event: CloudEvent): string | readonly string[] | undefined;
 //#endregion
 //#region src/blocks/time-tracking/weekly-grid.d.ts
 /** The fields `toWeeklyGrid` reads from an entry. */
-type WeeklyGridEntry = Pick<TimeEntry, "id" | "subjectType" | "subjectId" | "startedAt" | "endedAt" | "billable">;
+type WeeklyGridEntry = Pick<TimeEntry, "id" | "startedAt" | "endedAt" | "billable"> & {
+  readonly subject?: SubjectRef | undefined;
+};
 interface WeeklyGridOptions<E extends WeeklyGridEntry> {
   /** Any day of the week; the grid starts on its Monday. */
   readonly week: Temporal.PlainDate;
-  /** The IANA zone days start in: `blockConfig["time-tracking"].options.timeZone` from `blocks.generated.ts`. */
+  /**
+   * The IANA zone days start in:
+   * `blockConfig["time-tracking"].options.timeZone` from
+   * `blocks.generated.ts`.
+   */
   readonly timeZone: string;
   /** Where a running entry ends. Default: now. */
   readonly now?: Temporal.Instant;
@@ -207,8 +225,8 @@ interface WeeklyGridDay {
 /** One row of the grid: the time one record (or key) took each day. */
 interface WeeklyGridRow {
   readonly id: string;
-  readonly subjectType?: string;
-  readonly subjectId?: string;
+  /** The record of the row's first entry; `undefined` when it has none. */
+  readonly subject: SubjectRef | undefined;
   readonly billable: boolean;
   /** Seconds per day, Monday first. */
   readonly days: readonly number[];
@@ -224,8 +242,8 @@ interface WeeklyGrid {
 }
 /**
  * Time entries as a weekly grid: one row per record (or `rowKey`) with the
- * seconds of each day, the shape of a weekly timesheet Data Grid. An entry
- * that crosses midnight counts on each day it covers.
+ * seconds of each day, the shape of a weekly timesheet Data Grid. An entry that
+ * crosses midnight counts on each day it covers.
  */
 export declare function toWeeklyGrid<E extends WeeklyGridEntry>(entries: readonly E[], options: WeeklyGridOptions<E>): WeeklyGrid;
 //#endregion