@ai-matrx/records 0.87.32 → 0.92.0

package/dist/memory/index.d.cts

@@ -1,9 +1,10 @@
-import { b as RecordsDataSource, a as RecordsConfig } from '../ports-D8-iuY1P.cjs';
-import { T as TemplateSpec } from '../types-CLP5H4Wk.cjs';
-import { P as PgError } from '../record-DpB2QgAZ.cjs';
-import '../subscription-BD9DnJxX.cjs';
-import '../types-C2uspRtf.cjs';
-import '../field-BanTVGK2.cjs';
+import { c as RecordsDataSource, a as RecordsConfig } from '../ports-DSU2RsR6.cjs';
+import { T as TemplateSpec } from '../types-9Q5SHRDJ.cjs';
+import { P as PgError } from '../record-BQi92d4-.cjs';
+import '../subscription-D-VEzvyy.cjs';
+import '../rule-BMViCLmW.cjs';
+import '../types-Cs2MyE3u.cjs';
+import '../field-BJBnTyJ0.cjs';
 
 type Json$1 = Record<string, unknown>;
 /** One presented column, exactly as `platform.drill_describe(...).api.columns[]` says it. */

package/dist/memory/index.d.ts

@@ -1,9 +1,10 @@
-import { b as RecordsDataSource, a as RecordsConfig } from '../ports-TMWX-t9l.js';
-import { T as TemplateSpec } from '../types-DmPkWQic.js';
-import { P as PgError } from '../record-DpB2QgAZ.js';
-import '../subscription-D7KQBHXN.js';
-import '../types-Dv61jStB.js';
-import '../field-BPABOJ2Y.js';
+import { c as RecordsDataSource, a as RecordsConfig } from '../ports-BWtxAnXh.js';
+import { T as TemplateSpec } from '../types-CfYy-vdV.js';
+import { P as PgError } from '../record-BQi92d4-.js';
+import '../subscription-5CLN3Jug.js';
+import '../rule-B8kR0l01.js';
+import '../types-DF-dxB_l.js';
+import '../field-Ti5iAxFr.js';
 
 type Json$1 = Record<string, unknown>;
 /** One presented column, exactly as `platform.drill_describe(...).api.columns[]` says it. */

package/dist/port-CPVBfDxS.d.cts

@@ -0,0 +1,301 @@
+import { L as Lane, H as HostDataPort, V as Values } from './types-DTEGaxso.cjs';
+import { U as Uuid, R as RecordsResult } from './record-BQi92d4-.cjs';
+import * as _ai_matrx_realtime from '@ai-matrx/realtime';
+import { RealtimeManager, ChannelSpec } from '@ai-matrx/realtime';
+
+/** A link as the door words it: `{token, id, label}`. */
+interface EntityWireRef {
+    token: string;
+    id: Uuid;
+    label: string | null;
+}
+/** One row exactly as `platform.entity_list_scoped` / `entity_get` answer it. */
+interface EntityWireRow {
+    id: Uuid;
+    version: number;
+    organization_id: Uuid;
+    /** The row's own organization's custom fields, already masked by the store (a hidden field is null). */
+    _custom?: Record<string, unknown>;
+    /** The token's own columns; link columns are `EntityWireRef[]`. */
+    [column: string]: unknown;
+}
+interface EntitySortApplied {
+    column: string;
+    dir: "asc" | "desc";
+    nulls: "first" | "last";
+}
+interface EntityListAnswer {
+    rows: EntityWireRow[];
+    /** null when not asked for. */
+    total: number | null;
+    /** The total stopped at the store's count cap; `total` is then a floor, not a count. */
+    total_is_capped: boolean;
+    page_size: number;
+    /** The keyset cursor of the next page; opaque. */
+    next_after: string | null;
+    has_more: boolean;
+    sort_applied: EntitySortApplied[];
+    /** Sort columns the door could not use (it keeps one key today). Said back, never hidden. */
+    sort_ignored: string[];
+    feed_cursor: null;
+}
+interface EntityGetAnswer {
+    rows: EntityWireRow[];
+    /** Ids that are not there or that this person cannot open. */
+    missing: Uuid[];
+    feed_cursor: null;
+}
+interface EntityColumnWire {
+    key: string;
+    label: string;
+    type: string;
+    origin: "platform" | "custom";
+    required: boolean;
+    readOnly: boolean;
+    linksTo?: string[];
+    choices?: string[];
+    /** Custom columns only. */
+    field_id?: Uuid;
+    organization?: string;
+    organization_id?: Uuid;
+}
+interface EntityColumnsAnswer {
+    label: string;
+    token: string;
+    columns: EntityColumnWire[];
+    can_create: boolean;
+    can_update: boolean;
+    /** The type's landing lane (`platform.entity_default_list_scope`). */
+    default_scope: Lane;
+}
+/** One filter predicate as the door reads it (CONTRACT §3.2). */
+interface EntityWirePredicate {
+    column: string;
+    op: string;
+    value?: unknown;
+    values?: unknown[];
+    negated?: boolean;
+}
+interface EntityWireSort {
+    column: string;
+    dir: "asc" | "desc";
+    nulls: "last";
+}
+interface EntityWireQuery {
+    /** Absent = the type's own landing lane. `organization_id` narrows any lane and never locks it. */
+    scope?: {
+        kind?: Lane;
+        organization_id?: Uuid;
+    };
+    filter?: {
+        all: EntityWirePredicate[];
+    };
+    search?: string;
+    sort?: EntityWireSort[];
+    pageSize?: number;
+}
+/** What every write door answers (`entity_insert` / `entity_update` / `entity_archive` / `entity_unarchive`). */
+interface EntityWriteAnswer {
+    status: string;
+    /** The rows as the read door now reads them, each with its NEW `version`. */
+    rows: EntityWireRow[];
+    validation: unknown[];
+    feed_cursor: null;
+    /** Archive and restore say what they did, in the store's words (trash words on these types). */
+    message?: string;
+}
+
+/**
+ * THE ECHO HEADER (U6). The entity doors take no `_op_id` argument: the writer's op id rides the request
+ * as this header, PostgREST hands it to `request.headers`, and `platform._entity_org_notice` puts it on
+ * the notice as `op_id`, so the browser that wrote drops its own echo (`@ai-matrx/records` `isOwnOp`).
+ */
+declare const OP_ID_HEADER = "x-matrx-op-id";
+/** What a write takes beyond its arguments: the op id minted for it (`mintOpId`). */
+interface EntityWriteOptions {
+    opId?: string;
+}
+/** The schema every entity door lives in. */
+declare const ENTITY_DOOR_SCHEMA = "platform";
+interface CreateEntityClientOptions {
+    /** A supabase-js v2 client for the signed-in person, or anything with `rpc(fn, args, {schema})`. */
+    dataSource?: unknown;
+    /** Same thing, spelled the way the plan names it. Give one of the two. */
+    supabase?: unknown;
+}
+interface EntityListRequest extends EntityWireQuery {
+    token: string;
+    /** Keyset cursor from the previous answer's `next_after`. */
+    after?: string | null;
+    /** Ask the door to skip the count. Default: counted. */
+    withTotal?: boolean;
+    archived?: "active" | "archived" | "all";
+}
+interface EntityClient {
+    list(request: EntityListRequest): Promise<RecordsResult<EntityListAnswer>>;
+    get(request: {
+        token: string;
+        ids: readonly Uuid[];
+    }): Promise<RecordsResult<EntityGetAnswer>>;
+    /** `organizationId` null reads the custom fields of every organization the person belongs to. */
+    columns(request: {
+        token: string;
+        organizationId?: Uuid | null;
+    }): Promise<RecordsResult<EntityColumnsAnswer>>;
+    /** One `entity_data` knob as `platform.knob_resolve` answers it for an organization (live updates read three). */
+    knob(request: {
+        key: string;
+        organizationId?: Uuid | null;
+    }): Promise<RecordsResult<unknown>>;
+    /** `platform.entity_insert`: rows into the organization the host names (never guessed). */
+    insert(request: {
+        token: string;
+        organizationId: Uuid;
+        rows: readonly Record<string, unknown>[];
+    } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;
+    /** `platform.entity_update`: one row, refused as stale (`MX001`) unless `baseVersion` is still current. */
+    update(request: {
+        token: string;
+        id: Uuid;
+        baseVersion: number;
+        patch: Record<string, unknown>;
+    } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;
+    /** `platform.entity_archive` (on these types, the trash). */
+    archive(request: {
+        token: string;
+        ids: readonly Uuid[];
+    } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;
+    /** `platform.entity_unarchive`. */
+    unarchive(request: {
+        token: string;
+        ids: readonly Uuid[];
+    } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;
+    /** The organizations the person belongs to, as row security counts them (`iam.my_orgs()`: archived ones closed). */
+    memberOrganizations(): Promise<RecordsResult<Uuid[]>>;
+}
+declare function createEntityClient(options: CreateEntityClientOptions): EntityClient;
+
+/** The topic is a CONTRACT WITH THE DATABASE (a trigger writes it, an RLS policy parses it): built once, here. */
+declare const entityOrgChannel: _ai_matrx_realtime.ChannelNamespace;
+/** The broadcast event the database sends on an organization topic. */
+declare const ENTITY_NOTICE_EVENT = "entity_bump";
+/** Starting values of the knobs the runtime coalesces with (entity_data.realtime_batch_ms / _max_wait_ms). */
+declare const DEFAULT_BATCH_MS = 150;
+declare const DEFAULT_MAX_WAIT_MS = 1000;
+/** Starting value of knob entity_data.realtime_max_org_topics. */
+declare const DEFAULT_MAX_ORG_TOPICS = 20;
+interface EntityNotice {
+    id?: string;
+    entity_type?: string;
+    organization_id?: string;
+    op?: "created" | "updated" | "deleted";
+    /** The client operation that caused it (header `x-matrx-op-id`), or null for any other writer. */
+    op_id?: string | null;
+    /** `null` MEANS "more changed than the database lists: re-read". */
+    ids?: string[] | null;
+    at?: string;
+}
+/** A redelivered notice is the same notice: the database mints one id per send. */
+declare function entityNoticeKey(notice: EntityNotice): string | undefined;
+declare function entityOrgTopic(organizationId: string, token: string): string;
+/** The channel spec for one (organization, token): private, echo-guarded, deduped, backfilled. */
+declare function entityOrgChannelSpec(organizationId: string, token: string, onNotice: (notice: EntityNotice) => void, onBackfill: () => void): ChannelSpec;
+/**
+ * Which organization topics to join, in order, until `max`: the active organization, the alias's `org`
+ * filter, then the organizations of held rows by number of held rows (descending; organization id
+ * ascending on ties), then the person's remaining memberships by id. Only memberships are kept when they
+ * are known — any other topic is refused by the database anyway. Deterministic for the same input.
+ */
+declare function orderOrganizationTopics(input: {
+    active?: string | null;
+    filter?: string | null;
+    held?: ReadonlyMap<string, number>;
+    members?: readonly string[] | null;
+    max: number;
+}): string[];
+interface EntityNoticeSink {
+    /** `ids` to re-read, or `null` to re-read everything this reader shows. */
+    rows(ids: string[] | null): void;
+}
+interface EntityRealtime {
+    /** Hear `token` across `organizationIds`; the sink gets one coalesced call per burst. Returns the stop. */
+    subscribe(target: {
+        token: string;
+        organizationIds: readonly string[];
+    }, sink: EntityNoticeSink): () => void;
+}
+interface CreateEntityRealtimeOptions {
+    /** The host's realtime manager. Left out, the AMBIENT manager the app mounted — never a socket of our own. */
+    manager?: RealtimeManager;
+    /** Knob entity_data.realtime_batch_ms (starting value 150). */
+    batchMs?: number;
+    /** Knob entity_data.realtime_max_wait_ms (starting value 1000). */
+    maxWaitMs?: number;
+}
+/** The live-notice layer for platform lists, bound to a realtime manager. One per host is enough. */
+declare function createEntityRealtime(options?: CreateEntityRealtimeOptions): EntityRealtime;
+/** The three live-update knobs as the store answers them for an organization (starting values when unset). */
+declare function readEntityRealtimeKnobs(client: Pick<EntityClient, "knob">, organizationId?: string | null): Promise<{
+    batchMs: number;
+    maxWaitMs: number;
+    maxOrgTopics: number;
+}>;
+
+/** An alias as the Applet record declares it for an entity: one token (a `platform.entity_types` word). */
+interface EntityAlias {
+    kind: "entity";
+    token: string;
+    /** Whose custom fields `columns()` reads. Left out: every organization the person belongs to. */
+    organizationId?: Uuid;
+    /** Shown in `sources()`; the type's own name when left out. */
+    label?: string;
+}
+interface CreateEntityDataPortOptions {
+    /** A client from `createEntityClient` … */
+    client?: EntityClient;
+    /** … or the supabase-js client (or `rpc` source) to build one from. Give one of the two. */
+    dataSource?: unknown;
+    aliases: Readonly<Record<string, EntityAlias>>;
+    /**
+     * TOKEN-FIRST (the `/react` layer): an alias nobody declared is read as a type token —
+     * `list("party")` is `{kind:"entity", token:"party"}`. `sources()` still lists only the declared
+     * aliases. Off by default: an Applet's port answers only what its record declares.
+     */
+    tokensAreAliases?: boolean;
+    /**
+     * The active organization (CONTRACTS §4: `viewer().activeOrganizationId`), read at the moment it is
+     * needed: where `create` saves, and the first live topic joined. The host's own answer, never guessed;
+     * null/undefined means none is chosen and `create` is refused `organization_required`.
+     */
+    activeOrganizationId?: () => Uuid | null | undefined;
+    /** A fixed active organization, for a host whose port lives no longer than its choice. `activeOrganizationId` wins. */
+    organization?: Uuid | null;
+    /** The host's live-notice layer (`createEntityRealtime`). Left out, lists are as fresh as their last read. */
+    realtime?: EntityRealtime;
+}
+/** A value as rows carry it → as the write doors take it: a link (`EntityRef[]` or one ref) becomes its id. */
+declare function toWireValue(value: unknown): unknown;
+/** `Values` → the doors' `{column: value, _custom: {key: value}}`: links back to ids at both levels. */
+declare function toWireValues(values: Values): Record<string, unknown>;
+/** A type as the person may use it: its name and whether she may add or change rows (`entity_columns`' own answer). */
+interface EntityTypeFacts {
+    token: string;
+    label: string;
+    canCreate: boolean;
+    canUpdate: boolean;
+}
+/** The host's entity port: the DataPort, plus `describe` for a token-first screen that has no `sources()` entry. */
+interface EntityDataPort extends HostDataPort {
+    /** The type behind an alias, from the same one `entity_columns` read `columns()` uses. */
+    describe(alias: string): Promise<RecordsResult<EntityTypeFacts>>;
+}
+declare function createEntityDataPort(options: CreateEntityDataPortOptions): EntityDataPort;
+/**
+ * THE PORT A SERVER ASKS THROUGH, AND THE PAGE READS THROUGH WHILE IT HYDRATES (lane SEED-ENTITY).
+ * One construction for both, so the doors' arguments are the same on either side: a token is its own
+ * alias, nothing is bound to an organization, and nothing is live. `dataSource` is the person's own
+ * (server), a recording one, or one that answers from a page seed.
+ */
+declare function createSeedPort(dataSource: unknown): EntityDataPort;
+
+export { createEntityDataPort as A, createEntityRealtime as B, type CreateEntityDataPortOptions as C, DEFAULT_BATCH_MS as D, type EntityDataPort as E, createSeedPort as F, entityNoticeKey as G, entityOrgChannel as H, entityOrgChannelSpec as I, entityOrgTopic as J, orderOrganizationTopics as K, readEntityRealtimeKnobs as L, toWireValue as M, toWireValues as N, OP_ID_HEADER as O, type EntityWireQuery as a, type EntityColumnWire as b, type EntityWireRow as c, type CreateEntityClientOptions as d, type CreateEntityRealtimeOptions as e, DEFAULT_MAX_ORG_TOPICS as f, DEFAULT_MAX_WAIT_MS as g, ENTITY_DOOR_SCHEMA as h, ENTITY_NOTICE_EVENT as i, type EntityAlias as j, type EntityClient as k, type EntityColumnsAnswer as l, type EntityGetAnswer as m, type EntityListAnswer as n, type EntityListRequest as o, type EntityNotice as p, type EntityNoticeSink as q, type EntityRealtime as r, type EntitySortApplied as s, type EntityTypeFacts as t, type EntityWirePredicate as u, type EntityWireRef as v, type EntityWireSort as w, type EntityWriteAnswer as x, type EntityWriteOptions as y, createEntityClient as z };

package/dist/port-D2i2o7Lg.d.ts

@@ -0,0 +1,301 @@
+import { L as Lane, H as HostDataPort, V as Values } from './types-Dji5SpFS.js';
+import { U as Uuid, R as RecordsResult } from './record-BQi92d4-.js';
+import * as _ai_matrx_realtime from '@ai-matrx/realtime';
+import { RealtimeManager, ChannelSpec } from '@ai-matrx/realtime';
+
+/** A link as the door words it: `{token, id, label}`. */
+interface EntityWireRef {
+    token: string;
+    id: Uuid;
+    label: string | null;
+}
+/** One row exactly as `platform.entity_list_scoped` / `entity_get` answer it. */
+interface EntityWireRow {
+    id: Uuid;
+    version: number;
+    organization_id: Uuid;
+    /** The row's own organization's custom fields, already masked by the store (a hidden field is null). */
+    _custom?: Record<string, unknown>;
+    /** The token's own columns; link columns are `EntityWireRef[]`. */
+    [column: string]: unknown;
+}
+interface EntitySortApplied {
+    column: string;
+    dir: "asc" | "desc";
+    nulls: "first" | "last";
+}
+interface EntityListAnswer {
+    rows: EntityWireRow[];
+    /** null when not asked for. */
+    total: number | null;
+    /** The total stopped at the store's count cap; `total` is then a floor, not a count. */
+    total_is_capped: boolean;
+    page_size: number;
+    /** The keyset cursor of the next page; opaque. */
+    next_after: string | null;
+    has_more: boolean;
+    sort_applied: EntitySortApplied[];
+    /** Sort columns the door could not use (it keeps one key today). Said back, never hidden. */
+    sort_ignored: string[];
+    feed_cursor: null;
+}
+interface EntityGetAnswer {
+    rows: EntityWireRow[];
+    /** Ids that are not there or that this person cannot open. */
+    missing: Uuid[];
+    feed_cursor: null;
+}
+interface EntityColumnWire {
+    key: string;
+    label: string;
+    type: string;
+    origin: "platform" | "custom";
+    required: boolean;
+    readOnly: boolean;
+    linksTo?: string[];
+    choices?: string[];
+    /** Custom columns only. */
+    field_id?: Uuid;
+    organization?: string;
+    organization_id?: Uuid;
+}
+interface EntityColumnsAnswer {
+    label: string;
+    token: string;
+    columns: EntityColumnWire[];
+    can_create: boolean;
+    can_update: boolean;
+    /** The type's landing lane (`platform.entity_default_list_scope`). */
+    default_scope: Lane;
+}
+/** One filter predicate as the door reads it (CONTRACT §3.2). */
+interface EntityWirePredicate {
+    column: string;
+    op: string;
+    value?: unknown;
+    values?: unknown[];
+    negated?: boolean;
+}
+interface EntityWireSort {
+    column: string;
+    dir: "asc" | "desc";
+    nulls: "last";
+}
+interface EntityWireQuery {
+    /** Absent = the type's own landing lane. `organization_id` narrows any lane and never locks it. */
+    scope?: {
+        kind?: Lane;
+        organization_id?: Uuid;
+    };
+    filter?: {
+        all: EntityWirePredicate[];
+    };
+    search?: string;
+    sort?: EntityWireSort[];
+    pageSize?: number;
+}
+/** What every write door answers (`entity_insert` / `entity_update` / `entity_archive` / `entity_unarchive`). */
+interface EntityWriteAnswer {
+    status: string;
+    /** The rows as the read door now reads them, each with its NEW `version`. */
+    rows: EntityWireRow[];
+    validation: unknown[];
+    feed_cursor: null;
+    /** Archive and restore say what they did, in the store's words (trash words on these types). */
+    message?: string;
+}
+
+/**
+ * THE ECHO HEADER (U6). The entity doors take no `_op_id` argument: the writer's op id rides the request
+ * as this header, PostgREST hands it to `request.headers`, and `platform._entity_org_notice` puts it on
+ * the notice as `op_id`, so the browser that wrote drops its own echo (`@ai-matrx/records` `isOwnOp`).
+ */
+declare const OP_ID_HEADER = "x-matrx-op-id";
+/** What a write takes beyond its arguments: the op id minted for it (`mintOpId`). */
+interface EntityWriteOptions {
+    opId?: string;
+}
+/** The schema every entity door lives in. */
+declare const ENTITY_DOOR_SCHEMA = "platform";
+interface CreateEntityClientOptions {
+    /** A supabase-js v2 client for the signed-in person, or anything with `rpc(fn, args, {schema})`. */
+    dataSource?: unknown;
+    /** Same thing, spelled the way the plan names it. Give one of the two. */
+    supabase?: unknown;
+}
+interface EntityListRequest extends EntityWireQuery {
+    token: string;
+    /** Keyset cursor from the previous answer's `next_after`. */
+    after?: string | null;
+    /** Ask the door to skip the count. Default: counted. */
+    withTotal?: boolean;
+    archived?: "active" | "archived" | "all";
+}
+interface EntityClient {
+    list(request: EntityListRequest): Promise<RecordsResult<EntityListAnswer>>;
+    get(request: {
+        token: string;
+        ids: readonly Uuid[];
+    }): Promise<RecordsResult<EntityGetAnswer>>;
+    /** `organizationId` null reads the custom fields of every organization the person belongs to. */
+    columns(request: {
+        token: string;
+        organizationId?: Uuid | null;
+    }): Promise<RecordsResult<EntityColumnsAnswer>>;
+    /** One `entity_data` knob as `platform.knob_resolve` answers it for an organization (live updates read three). */
+    knob(request: {
+        key: string;
+        organizationId?: Uuid | null;
+    }): Promise<RecordsResult<unknown>>;
+    /** `platform.entity_insert`: rows into the organization the host names (never guessed). */
+    insert(request: {
+        token: string;
+        organizationId: Uuid;
+        rows: readonly Record<string, unknown>[];
+    } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;
+    /** `platform.entity_update`: one row, refused as stale (`MX001`) unless `baseVersion` is still current. */
+    update(request: {
+        token: string;
+        id: Uuid;
+        baseVersion: number;
+        patch: Record<string, unknown>;
+    } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;
+    /** `platform.entity_archive` (on these types, the trash). */
+    archive(request: {
+        token: string;
+        ids: readonly Uuid[];
+    } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;
+    /** `platform.entity_unarchive`. */
+    unarchive(request: {
+        token: string;
+        ids: readonly Uuid[];
+    } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;
+    /** The organizations the person belongs to, as row security counts them (`iam.my_orgs()`: archived ones closed). */
+    memberOrganizations(): Promise<RecordsResult<Uuid[]>>;
+}
+declare function createEntityClient(options: CreateEntityClientOptions): EntityClient;
+
+/** The topic is a CONTRACT WITH THE DATABASE (a trigger writes it, an RLS policy parses it): built once, here. */
+declare const entityOrgChannel: _ai_matrx_realtime.ChannelNamespace;
+/** The broadcast event the database sends on an organization topic. */
+declare const ENTITY_NOTICE_EVENT = "entity_bump";
+/** Starting values of the knobs the runtime coalesces with (entity_data.realtime_batch_ms / _max_wait_ms). */
+declare const DEFAULT_BATCH_MS = 150;
+declare const DEFAULT_MAX_WAIT_MS = 1000;
+/** Starting value of knob entity_data.realtime_max_org_topics. */
+declare const DEFAULT_MAX_ORG_TOPICS = 20;
+interface EntityNotice {
+    id?: string;
+    entity_type?: string;
+    organization_id?: string;
+    op?: "created" | "updated" | "deleted";
+    /** The client operation that caused it (header `x-matrx-op-id`), or null for any other writer. */
+    op_id?: string | null;
+    /** `null` MEANS "more changed than the database lists: re-read". */
+    ids?: string[] | null;
+    at?: string;
+}
+/** A redelivered notice is the same notice: the database mints one id per send. */
+declare function entityNoticeKey(notice: EntityNotice): string | undefined;
+declare function entityOrgTopic(organizationId: string, token: string): string;
+/** The channel spec for one (organization, token): private, echo-guarded, deduped, backfilled. */
+declare function entityOrgChannelSpec(organizationId: string, token: string, onNotice: (notice: EntityNotice) => void, onBackfill: () => void): ChannelSpec;
+/**
+ * Which organization topics to join, in order, until `max`: the active organization, the alias's `org`
+ * filter, then the organizations of held rows by number of held rows (descending; organization id
+ * ascending on ties), then the person's remaining memberships by id. Only memberships are kept when they
+ * are known — any other topic is refused by the database anyway. Deterministic for the same input.
+ */
+declare function orderOrganizationTopics(input: {
+    active?: string | null;
+    filter?: string | null;
+    held?: ReadonlyMap<string, number>;
+    members?: readonly string[] | null;
+    max: number;
+}): string[];
+interface EntityNoticeSink {
+    /** `ids` to re-read, or `null` to re-read everything this reader shows. */
+    rows(ids: string[] | null): void;
+}
+interface EntityRealtime {
+    /** Hear `token` across `organizationIds`; the sink gets one coalesced call per burst. Returns the stop. */
+    subscribe(target: {
+        token: string;
+        organizationIds: readonly string[];
+    }, sink: EntityNoticeSink): () => void;
+}
+interface CreateEntityRealtimeOptions {
+    /** The host's realtime manager. Left out, the AMBIENT manager the app mounted — never a socket of our own. */
+    manager?: RealtimeManager;
+    /** Knob entity_data.realtime_batch_ms (starting value 150). */
+    batchMs?: number;
+    /** Knob entity_data.realtime_max_wait_ms (starting value 1000). */
+    maxWaitMs?: number;
+}
+/** The live-notice layer for platform lists, bound to a realtime manager. One per host is enough. */
+declare function createEntityRealtime(options?: CreateEntityRealtimeOptions): EntityRealtime;
+/** The three live-update knobs as the store answers them for an organization (starting values when unset). */
+declare function readEntityRealtimeKnobs(client: Pick<EntityClient, "knob">, organizationId?: string | null): Promise<{
+    batchMs: number;
+    maxWaitMs: number;
+    maxOrgTopics: number;
+}>;
+
+/** An alias as the Applet record declares it for an entity: one token (a `platform.entity_types` word). */
+interface EntityAlias {
+    kind: "entity";
+    token: string;
+    /** Whose custom fields `columns()` reads. Left out: every organization the person belongs to. */
+    organizationId?: Uuid;
+    /** Shown in `sources()`; the type's own name when left out. */
+    label?: string;
+}
+interface CreateEntityDataPortOptions {
+    /** A client from `createEntityClient` … */
+    client?: EntityClient;
+    /** … or the supabase-js client (or `rpc` source) to build one from. Give one of the two. */
+    dataSource?: unknown;
+    aliases: Readonly<Record<string, EntityAlias>>;
+    /**
+     * TOKEN-FIRST (the `/react` layer): an alias nobody declared is read as a type token —
+     * `list("party")` is `{kind:"entity", token:"party"}`. `sources()` still lists only the declared
+     * aliases. Off by default: an Applet's port answers only what its record declares.
+     */
+    tokensAreAliases?: boolean;
+    /**
+     * The active organization (CONTRACTS §4: `viewer().activeOrganizationId`), read at the moment it is
+     * needed: where `create` saves, and the first live topic joined. The host's own answer, never guessed;
+     * null/undefined means none is chosen and `create` is refused `organization_required`.
+     */
+    activeOrganizationId?: () => Uuid | null | undefined;
+    /** A fixed active organization, for a host whose port lives no longer than its choice. `activeOrganizationId` wins. */
+    organization?: Uuid | null;
+    /** The host's live-notice layer (`createEntityRealtime`). Left out, lists are as fresh as their last read. */
+    realtime?: EntityRealtime;
+}
+/** A value as rows carry it → as the write doors take it: a link (`EntityRef[]` or one ref) becomes its id. */
+declare function toWireValue(value: unknown): unknown;
+/** `Values` → the doors' `{column: value, _custom: {key: value}}`: links back to ids at both levels. */
+declare function toWireValues(values: Values): Record<string, unknown>;
+/** A type as the person may use it: its name and whether she may add or change rows (`entity_columns`' own answer). */
+interface EntityTypeFacts {
+    token: string;
+    label: string;
+    canCreate: boolean;
+    canUpdate: boolean;
+}
+/** The host's entity port: the DataPort, plus `describe` for a token-first screen that has no `sources()` entry. */
+interface EntityDataPort extends HostDataPort {
+    /** The type behind an alias, from the same one `entity_columns` read `columns()` uses. */
+    describe(alias: string): Promise<RecordsResult<EntityTypeFacts>>;
+}
+declare function createEntityDataPort(options: CreateEntityDataPortOptions): EntityDataPort;
+/**
+ * THE PORT A SERVER ASKS THROUGH, AND THE PAGE READS THROUGH WHILE IT HYDRATES (lane SEED-ENTITY).
+ * One construction for both, so the doors' arguments are the same on either side: a token is its own
+ * alias, nothing is bound to an organization, and nothing is live. `dataSource` is the person's own
+ * (server), a recording one, or one that answers from a page seed.
+ */
+declare function createSeedPort(dataSource: unknown): EntityDataPort;
+
+export { createEntityDataPort as A, createEntityRealtime as B, type CreateEntityDataPortOptions as C, DEFAULT_BATCH_MS as D, type EntityDataPort as E, createSeedPort as F, entityNoticeKey as G, entityOrgChannel as H, entityOrgChannelSpec as I, entityOrgTopic as J, orderOrganizationTopics as K, readEntityRealtimeKnobs as L, toWireValue as M, toWireValues as N, OP_ID_HEADER as O, type EntityWireQuery as a, type EntityColumnWire as b, type EntityWireRow as c, type CreateEntityClientOptions as d, type CreateEntityRealtimeOptions as e, DEFAULT_MAX_ORG_TOPICS as f, DEFAULT_MAX_WAIT_MS as g, ENTITY_DOOR_SCHEMA as h, ENTITY_NOTICE_EVENT as i, type EntityAlias as j, type EntityClient as k, type EntityColumnsAnswer as l, type EntityGetAnswer as m, type EntityListAnswer as n, type EntityListRequest as o, type EntityNotice as p, type EntityNoticeSink as q, type EntityRealtime as r, type EntitySortApplied as s, type EntityTypeFacts as t, type EntityWirePredicate as u, type EntityWireRef as v, type EntityWireSort as w, type EntityWriteAnswer as x, type EntityWriteOptions as y, createEntityClient as z };