@ai-matrx/entity-data 0.3.44 → 0.4.0

package/CHANGELOG.md

@@ -6,6 +6,21 @@ Automatic changed-only republish (docs/metadata drift since the last tag — see
 `git diff npm/entity-data/v0.3.43..npm/entity-data/v0.3.44 -- apps/shared/entity-data`).
 No source changes intended and no consumer action required.
 
+## 0.4.0
+
+**Deprecated — moved into `@ai-matrx/records` as `records/entity`.** This version only re-exports
+`@ai-matrx/records/entity` (from `.`, `/core`, `/port`) and `@ai-matrx/records/entity/react` (from `/react`).
+Same API, no behaviour change.
+
+**Consumer action:** import `@ai-matrx/records/entity` / `@ai-matrx/records/entity/react` instead and
+remove this dependency.
+
+## 0.3.43
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/entity-data/v0.3.42..npm/entity-data/v0.3.43 -- apps/shared/entity-data`).
+No source changes intended and no consumer action required.
+
 ## 0.3.42
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/README.md

@@ -1,54 +1,10 @@
-# @ai-matrx/entity-data
+# @ai-matrx/entity-data — deprecated
 
-Platform records (contacts, projects, tasks…) through the same `DataPort` an Applet reads a custom
-table with. A thin typed client over the store's entity doors, and a host `DataPort` for entity
-aliases, and token-first React hooks over records' one data engine (`@ai-matrx/records/data/react`).
+Moved into `@ai-matrx/records` as the `entity` section. Same API; change the import:
 
-**Reads and writes.** `create` saves into the active organization the host names (none → refused
-`organization_required`), `update` sends the version the person saw (a stale one is refused with the
-store's sentence), `archive` / `restore` move a row to the trash and back. **Lists are live** when the host passes `realtime: createEntityRealtime({ manager })`
-(and `organization`, the active one): other people's changes arrive as `rows:<alias>` events naming the ids.
-
-```ts
-import { createEntityDataPort } from "@ai-matrx/entity-data/port";
-import { DataPortProvider, hostEvents, useDataRows } from "@ai-matrx/records/data/react";
-
-const port = createEntityDataPort({
-  dataSource: supabase, // the signed-in person's supabase-js client
-  aliases: { contacts: { kind: "entity", token: "party", organizationId } },
-});
-
-// in React:
-// <DataPortProvider port={port} events={hostEvents(port)} portKey="applet-1" queryClient={qc}>
-//   const { rows, hasMore, loadMore, error } = useDataRows("contacts", { org: organizationId, sort: [{ column: "display_name" }] });
-```
-
-In a React app, name the type and let the engine do the rest:
-
-```tsx
-import { EntityDataProvider, useEntityList, useEntityWrite } from "@ai-matrx/entity-data/react";
-
-// once, high: <EntityDataProvider dataSource={supabase} activeOrganizationId={activeOrg}>…
-const contacts = useEntityList("party", { where: [{ column: "last_name", op: "eq", value: "Ellis" }] });
-const write = useEntityWrite("party");
-await write.update(contacts.rows[0]._id, { first_name: "Ada" }); // drawn at once, rolled back on refusal
-```
-
-## Entries
-
-| Entry | What |
+| Was | Now |
 |---|---|
-| `@ai-matrx/entity-data/core` | `createEntityClient({ dataSource })` → `list`, `get`, `columns`, `insert`, `update`, `archive`, `unarchive`; `toWire`; `mapEntityError` |
-| `@ai-matrx/entity-data/port` | `createEntityDataPort({ client \| dataSource, aliases, activeOrganizationId })` → `HostDataPort` + `describe` |
-| `@ai-matrx/entity-data/react` | `EntityDataProvider`, `useEntityList`, `useEntityColumns`, `useEntityType`, `useEntityRow`, `useEntityWrite` |
-| `@ai-matrx/entity-data` | both of the above |
-
-## Behaviour worth knowing
-
-- The lane defaults to the type's own landing lane, decided by the store; `org` is a filter and never a lock.
-- Paging is keyset: the cursor is the store's `next_after`.
-- A filter or sort the store does not offer yet is refused by name with the store's sentence, never emulated in the browser.
-- Custom fields read from `row._custom` and filter as `_custom.<key>`; a field the person may not read arrives `null`.
-- A total that stopped at the store's count cap is reported as `null` (unknown), never as a wrong number.
+| `@ai-matrx/entity-data`, `/core`, `/port` | `@ai-matrx/records/entity` |
+| `@ai-matrx/entity-data/react` | `@ai-matrx/records/entity/react` |
 
-See `FEATURE.md` for the local mechanics.
+This package only re-exports those sections and will be marked deprecated on npm.

package/dist/core/index.cjs

@@ -3,10 +3,6 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -15,381 +11,11 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/core/index.ts
 var core_exports = {};
-__export(core_exports, {
-  CUSTOM_PREFIX: () => CUSTOM_PREFIX,
-  DEFAULT_BATCH_MS: () => DEFAULT_BATCH_MS,
-  DEFAULT_MAX_ORG_TOPICS: () => DEFAULT_MAX_ORG_TOPICS,
-  DEFAULT_MAX_WAIT_MS: () => DEFAULT_MAX_WAIT_MS,
-  ENTITY_DOOR_SCHEMA: () => ENTITY_DOOR_SCHEMA,
-  ENTITY_NOTICE_EVENT: () => ENTITY_NOTICE_EVENT,
-  ENTITY_REFUSALS: () => ENTITY_REFUSALS,
-  OP_ID_HEADER: () => OP_ID_HEADER,
-  createEntityClient: () => createEntityClient,
-  createEntityRealtime: () => createEntityRealtime,
-  entityNoticeKey: () => entityNoticeKey,
-  entityOrgChannel: () => entityOrgChannel,
-  entityOrgChannelSpec: () => entityOrgChannelSpec,
-  entityOrgTopic: () => entityOrgTopic,
-  mapEntityError: () => mapEntityError,
-  orderOrganizationTopics: () => orderOrganizationTopics,
-  readEntityRealtimeKnobs: () => readEntityRealtimeKnobs,
-  refusal: () => refusal,
-  toWire: () => toWire,
-  wireColumn: () => wireColumn
-});
 module.exports = __toCommonJS(core_exports);
-
-// src/core/client.ts
-var import_core2 = require("@ai-matrx/records/core");
-
-// src/core/errors.ts
-var import_core = require("@ai-matrx/records/core");
-var ENTITY_REFUSALS = {
-  /** conflict_version: somebody else's write won. */
-  MX001: "stale_write",
-  /** organization_required: the call needs an organization and carried none. */
-  MX002: "organization_required",
-  /** forbidden. */
-  MX003: "door",
-  /** not_found (also: not visible to this person). */
-  MX004: "not_found",
-  /** validation_refused (detail.reason required / bad_value / ambiguous_word / constraint; `not_supported` is read apart below). */
-  MX005: "invalid_argument",
-  /** system_column: a write named a column the store owns. */
-  MX008: "invalid_argument",
-  /** unknown_identifier: a column that is not there or not usable here. */
-  MX012: "invalid_argument",
-  /** cursor_invalid: the page cursor belongs to another list; the engine restarts the page. */
-  MX013: "invalid_argument",
-  /** view_not_offered. */
-  MX015: "invalid_argument",
-  /** invalid_argument: a parameter the door refuses by name. */
-  MX016: "invalid_argument"
-};
-function mapEntityError(error, where) {
-  const mapped = (0, import_core.mapPgError)(error, where);
-  const state = mapped.sqlstate;
-  if (state && /^MX\d{3}$/.test(state)) {
-    const code = ENTITY_REFUSALS[state];
-    if (code) {
-      const reason = mapped.detail?.reason;
-      const known = { ...mapped, code: state === "MX005" && reason === "not_supported" ? "not_supported" : code };
-      delete known.unmapped;
-      delete known.diagnostic;
-      return known;
-    }
-  }
-  return mapped;
-}
-function refusal(code, message, hint) {
-  return { ok: false, error: { code, message, ...hint ? { hint } : {} } };
-}
-
-// src/core/client.ts
-var OP_ID_HEADER = "x-matrx-op-id";
-var ENTITY_DOOR_SCHEMA = "platform";
-function createEntityClient(options) {
-  const source = (0, import_core2.asRecordsDataSource)(options.dataSource ?? options.supabase);
-  let warnedHeaderless = false;
-  function withHeaders(pending, headers) {
-    if (!headers) return;
-    const builder = pending;
-    if (typeof builder.setHeader === "function") {
-      for (const [name, value] of Object.entries(headers)) builder.setHeader(name, value);
-      return;
-    }
-    if (!warnedHeaderless) {
-      warnedHeaderless = true;
-      console.warn(
-        `[@ai-matrx/entity-data] This data source cannot carry a per-call header (${Object.keys(headers).join(", ")}), so this browser re-reads the notice of its own writes once.`
-      );
-    }
-  }
-  async function call(fn, args, schema = ENTITY_DOOR_SCHEMA, headers) {
-    try {
-      const pending = source.rpc(fn, args, { schema });
-      withHeaders(pending, headers);
-      const answer = await pending;
-      if (answer.error) return { ok: false, error: mapEntityError(answer.error, `${schema}.${fn}`) };
-      return { ok: true, data: answer.data };
-    } catch (thrown) {
-      return {
-        ok: false,
-        error: mapEntityError({ code: "", message: thrown instanceof Error ? thrown.message : String(thrown) }, `${schema}.${fn}`)
-      };
-    }
-  }
-  return {
-    list(request) {
-      const args = {
-        p_entity_type: request.token,
-        p_scope: request.scope ?? null,
-        p_filter: request.filter ?? {},
-        p_search: request.search ?? null,
-        p_sort: request.sort ?? null,
-        p_archived: request.archived ?? "active",
-        p_page_size: request.pageSize ?? null,
-        p_after: request.after ?? null,
-        p_with_total: request.withTotal ?? true
-      };
-      return call("entity_list_scoped", args);
-    },
-    get(request) {
-      return call("entity_get", { p_entity_type: request.token, p_ids: [...request.ids] });
-    },
-    columns(request) {
-      return call("entity_columns", { p_organization_id: request.organizationId ?? null, p_token: request.token });
-    },
-    insert(request) {
-      return call(
-        "entity_insert",
-        { p_entity_type: request.token, p_organization_id: request.organizationId, p_rows: request.rows.map((r) => ({ ...r })) },
-        ENTITY_DOOR_SCHEMA,
-        opHeader(request.opId)
-      );
-    },
-    update(request) {
-      return call(
-        "entity_update",
-        { p_entity_type: request.token, p_id: request.id, p_base_version: request.baseVersion, p_patch: request.patch },
-        ENTITY_DOOR_SCHEMA,
-        opHeader(request.opId)
-      );
-    },
-    archive(request) {
-      return call("entity_archive", { p_entity_type: request.token, p_ids: [...request.ids] }, ENTITY_DOOR_SCHEMA, opHeader(request.opId));
-    },
-    unarchive(request) {
-      return call("entity_unarchive", { p_entity_type: request.token, p_ids: [...request.ids] }, ENTITY_DOOR_SCHEMA, opHeader(request.opId));
-    },
-    knob(request) {
-      return call("knob_resolve", { p_feature: "entity_data", p_key: request.key, p_organization_id: request.organizationId ?? null });
-    },
-    async memberOrganizations() {
-      const answer = await call("my_orgs", {}, "iam");
-      if (!answer.ok) return answer;
-      const rows = Array.isArray(answer.data) ? answer.data : [];
-      const ids = rows.map((row) => typeof row === "string" ? row : row && typeof row === "object" ? Object.values(row)[0] : null).filter((id) => typeof id === "string");
-      return { ok: true, data: ids };
-    }
-  };
-}
-function opHeader(opId) {
-  return opId ? { [OP_ID_HEADER]: opId } : void 0;
-}
-
-// src/core/wire.ts
-var IDENTITY = {
-  _id: "id",
-  _version: "version",
-  _organization_id: "organization_id"
-};
-var CUSTOM_PREFIX = "_custom.";
-function wireColumn(column, customKeys) {
-  const identity = IDENTITY[column];
-  if (identity) return identity;
-  if (column.startsWith(CUSTOM_PREFIX)) return column;
-  return customKeys.has(column) ? `${CUSTOM_PREFIX}${column}` : column;
-}
-function predicate(clause, customKeys) {
-  const column = wireColumn(clause.column, customKeys);
-  const v = clause.value;
-  switch (clause.op) {
-    case "eq":
-      return v === null || v === void 0 ? { column, op: "empty" } : { column, op: "eq", value: v };
-    case "neq":
-      return v === null || v === void 0 ? { column, op: "empty", negated: true } : { column, op: "neq", value: v };
-    case "lt":
-    case "lte":
-    case "gt":
-    case "gte":
-      return { column, op: clause.op, value: v };
-    case "in":
-      return { column, op: "in", values: Array.isArray(v) ? v : [] };
-    case "empty":
-      return v === false ? { column, op: "empty", negated: true } : { column, op: "empty" };
-    case "contains":
-      return { column, op: "contains", value: v };
-    default:
-      return { column, op: String(clause.op), value: v };
-  }
-}
-function toWire(query, customKeys = /* @__PURE__ */ new Set()) {
-  const q = query ?? {};
-  const out = {};
-  const scope = {};
-  if (q.lane) scope.kind = q.lane;
-  if (q.org && q.org !== "all") scope.organization_id = q.org;
-  if (scope.kind || scope.organization_id) out.scope = scope;
-  if (q.where && q.where.length > 0) out.filter = { all: q.where.map((c) => predicate(c, customKeys)) };
-  const search = q.search?.trim();
-  if (search) out.search = search;
-  if (q.sort && q.sort.length > 0) {
-    out.sort = q.sort.map((s) => ({
-      column: wireColumn(s.column, customKeys),
-      dir: s.direction === "desc" ? "desc" : "asc",
-      nulls: "last"
-    }));
-  }
-  if (typeof q.pageSize === "number" && Number.isFinite(q.pageSize)) out.pageSize = Math.max(1, Math.floor(q.pageSize));
-  return out;
-}
-
-// src/core/realtime.ts
-var import_realtime = require("@ai-matrx/realtime");
-var import_records = require("@ai-matrx/records");
-var entityOrgChannel = (0, import_realtime.defineChannelNamespace)({
-  namespace: "entity-org",
-  foreignTopic: "mx:entity-org",
-  parts: ["organizationId", "token"],
-  description: "One organization's changes to one platform type (contacts, deals, projects, tasks, employees). Carries NOTICES written by platform.entity_org_notice_stmt \u2014 which ids moved, never a value. Admitted by the one RLS policy on realtime.messages to members of that organization."
-});
-var ENTITY_NOTICE_EVENT = "entity_bump";
-var DEFAULT_BATCH_MS = 150;
-var DEFAULT_MAX_WAIT_MS = 1e3;
-var DEFAULT_MAX_ORG_TOPICS = 20;
-function entityNoticeKey(notice) {
-  return notice.id ?? (notice.at ? `${notice.organization_id ?? ""}:${notice.entity_type ?? ""}:${notice.at}` : void 0);
-}
-function entityOrgTopic(organizationId, token) {
-  return entityOrgChannel.topic({ organizationId, token });
-}
-function entityOrgChannelSpec(organizationId, token, onNotice, onBackfill) {
-  return {
-    topic: entityOrgTopic(organizationId, token),
-    // Database Broadcast is authorized by RLS on realtime.messages; the manager awaits setAuth() first.
-    private: true,
-    // The sender is Postgres: no Matrx envelope. Our own write is known by the op id it carried.
-    wire: { mode: "raw", isOwnMessage: (payload) => (0, import_records.isOwnOp)(payload?.op_id) },
-    eventKey: (_source, payload) => entityNoticeKey(payload ?? {}),
-    broadcast: [
-      {
-        event: ENTITY_NOTICE_EVENT,
-        onMessage: (message) => {
-          const notice = message.data ?? {};
-          if ((0, import_records.isOwnOp)(notice.op_id)) return;
-          onNotice(notice);
-        }
-      }
-    ],
-    // Realtime has no replay: a channel back from a gap re-reads.
-    onBackfill: () => onBackfill()
-  };
-}
-function orderOrganizationTopics(input) {
-  const members = input.members ? new Set(input.members) : null;
-  const out = [];
-  const push = (org) => {
-    if (!org || out.includes(org)) return;
-    if (members && !members.has(org)) return;
-    out.push(org);
-  };
-  push(input.active);
-  push(input.filter);
-  const held = [...(input.held ?? /* @__PURE__ */ new Map()).entries()].sort((a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0));
-  for (const [org] of held) push(org);
-  for (const org of [...input.members ?? []].sort()) push(org);
-  return out.slice(0, Math.max(0, input.max));
-}
-function createEntityRealtime(options = {}) {
-  const batchMs = options.batchMs ?? DEFAULT_BATCH_MS;
-  const maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
-  const channels = /* @__PURE__ */ new Map();
-  const open = (organizationId, token) => {
-    const channel = { listeners: /* @__PURE__ */ new Set(), stop: null };
-    const spec = entityOrgChannelSpec(
-      organizationId,
-      token,
-      (notice) => {
-        for (const listener of channel.listeners) listener.notice(notice);
-      },
-      () => {
-        for (const listener of channel.listeners) listener.backfill();
-      }
-    );
-    if (options.manager) {
-      const handle = options.manager.open(spec);
-      channel.stop = () => handle.close();
-    } else {
-      channel.stop = (0, import_realtime.subscribeToRealtimeManager)(() => spec);
-    }
-    return channel;
-  };
-  return {
-    subscribe({ token, organizationIds }, sink) {
-      let timer = null;
-      let firstAt = 0;
-      let pending = /* @__PURE__ */ new Set();
-      let wholeList = false;
-      const flush = () => {
-        if (timer !== null) clearTimeout(timer);
-        timer = null;
-        const ids = [...pending];
-        const all = wholeList;
-        pending = /* @__PURE__ */ new Set();
-        wholeList = false;
-        if (all) sink.rows(null);
-        else if (ids.length > 0) sink.rows(ids);
-      };
-      const nudge = () => {
-        const now = Date.now();
-        if (timer === null) firstAt = now;
-        else clearTimeout(timer);
-        const wait = Math.max(0, Math.min(batchMs, firstAt + maxWaitMs - now));
-        timer = setTimeout(flush, wait);
-      };
-      const listener = {
-        notice(notice) {
-          if (notice.entity_type && notice.entity_type !== token) return;
-          if (notice.ids == null) wholeList = true;
-          else for (const id of notice.ids) pending.add(id);
-          nudge();
-        },
-        backfill() {
-          wholeList = true;
-          flush();
-        }
-      };
-      const keys = [...new Set(organizationIds)].map((org) => {
-        const key = entityOrgTopic(org, token);
-        const channel = channels.get(key) ?? open(org, token);
-        channels.set(key, channel);
-        channel.listeners.add(listener);
-        return key;
-      });
-      return () => {
-        if (timer !== null) clearTimeout(timer);
-        for (const key of keys) {
-          const channel = channels.get(key);
-          if (!channel) continue;
-          channel.listeners.delete(listener);
-          if (channel.listeners.size > 0) continue;
-          channel.stop?.();
-          channels.delete(key);
-        }
-      };
-    }
-  };
-}
-async function readEntityRealtimeKnobs(client, organizationId) {
-  const read = async (key, fallback) => {
-    const answer = await client.knob({ key, organizationId: organizationId ?? null });
-    const value = answer.ok ? Number(answer.data) : Number.NaN;
-    if (!Number.isFinite(value)) {
-      console.warn(`[@ai-matrx/entity-data] knob entity_data.${key} did not resolve; using its starting value ${fallback}.`);
-      return fallback;
-    }
-    return value;
-  };
-  const [batchMs, maxWaitMs, maxOrgTopics] = await Promise.all([
-    read("realtime_batch_ms", DEFAULT_BATCH_MS),
-    read("realtime_max_wait_ms", DEFAULT_MAX_WAIT_MS),
-    read("realtime_max_org_topics", DEFAULT_MAX_ORG_TOPICS)
-  ]);
-  return { batchMs, maxWaitMs, maxOrgTopics };
-}
+__reExport(core_exports, require("@ai-matrx/records/entity"), module.exports);
 //# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/index.ts","../../src/core/client.ts","../../src/core/errors.ts","../../src/core/wire.ts","../../src/core/realtime.ts"],"sourcesContent":["// src/core/index.ts — @ai-matrx/entity-data/core\nexport * from \"./types\";\nexport {\n  createEntityClient,\n  ENTITY_DOOR_SCHEMA,\n  OP_ID_HEADER,\n  type CreateEntityClientOptions,\n  type EntityClient,\n  type EntityListRequest,\n  type EntityWriteOptions,\n} from \"./client\";\nexport { mapEntityError, refusal, ENTITY_REFUSALS } from \"./errors\";\nexport { toWire, wireColumn, CUSTOM_PREFIX } from \"./wire\";\nexport {\n  createEntityRealtime,\n  entityOrgChannel,\n  entityOrgChannelSpec,\n  entityOrgTopic,\n  entityNoticeKey,\n  orderOrganizationTopics,\n  readEntityRealtimeKnobs,\n  ENTITY_NOTICE_EVENT,\n  DEFAULT_BATCH_MS,\n  DEFAULT_MAX_WAIT_MS,\n  DEFAULT_MAX_ORG_TOPICS,\n  type CreateEntityRealtimeOptions,\n  type EntityNotice,\n  type EntityNoticeSink,\n  type EntityRealtime,\n} from \"./realtime\";\n","// src/core/client.ts — @ai-matrx/entity-data/core\n//\n// THE THIN TYPED CLIENT over the live INVOKER doors in `platform`: reads (`entity_list_scoped`,\n// `entity_get`, `entity_columns`) and, since 0.3, writes (`entity_insert`, `entity_update`,\n// `entity_archive`, `entity_unarchive`). Every call answers a `RecordsResult` and\n// never throws; every refusal is the store's own sentence (see `errors.ts`). The caller's seat is the\n// one on the supabase client handed in — nothing here widens or narrows what the store lets her see.\n\nimport { asRecordsDataSource } from \"@ai-matrx/records/core\";\nimport type { RecordsDataSource, RecordsResult, Uuid } from \"@ai-matrx/records\";\nimport { mapEntityError } from \"./errors\";\nimport type { EntityColumnsAnswer, EntityGetAnswer, EntityListAnswer, EntityWireQuery, EntityWriteAnswer } from \"./types\";\n\n/**\n * THE ECHO HEADER (U6). The entity doors take no `_op_id` argument: the writer's op id rides the request\n * as this header, PostgREST hands it to `request.headers`, and `platform._entity_org_notice` puts it on\n * the notice as `op_id`, so the browser that wrote drops its own echo (`@ai-matrx/records` `isOwnOp`).\n */\nexport const OP_ID_HEADER = \"x-matrx-op-id\";\n\n/** What a write takes beyond its arguments: the op id minted for it (`mintOpId`). */\nexport interface EntityWriteOptions {\n  opId?: string;\n}\n\n/** The schema every entity door lives in. */\nexport const ENTITY_DOOR_SCHEMA = \"platform\";\n\nexport interface CreateEntityClientOptions {\n  /** A supabase-js v2 client for the signed-in person, or anything with `rpc(fn, args, {schema})`. */\n  dataSource?: unknown;\n  /** Same thing, spelled the way the plan names it. Give one of the two. */\n  supabase?: unknown;\n}\n\nexport interface EntityListRequest extends EntityWireQuery {\n  token: string;\n  /** Keyset cursor from the previous answer's `next_after`. */\n  after?: string | null;\n  /** Ask the door to skip the count. Default: counted. */\n  withTotal?: boolean;\n  archived?: \"active\" | \"archived\" | \"all\";\n}\n\nexport interface EntityClient {\n  list(request: EntityListRequest): Promise<RecordsResult<EntityListAnswer>>;\n  get(request: { token: string; ids: readonly Uuid[] }): Promise<RecordsResult<EntityGetAnswer>>;\n  /** `organizationId` null reads the custom fields of every organization the person belongs to. */\n  columns(request: { token: string; organizationId?: Uuid | null }): Promise<RecordsResult<EntityColumnsAnswer>>;\n  /** One `entity_data` knob as `platform.knob_resolve` answers it for an organization (live updates read three). */\n  knob(request: { key: string; organizationId?: Uuid | null }): Promise<RecordsResult<unknown>>;\n  /** `platform.entity_insert`: rows into the organization the host names (never guessed). */\n  insert(request: { token: string; organizationId: Uuid; rows: readonly Record<string, unknown>[] } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;\n  /** `platform.entity_update`: one row, refused as stale (`MX001`) unless `baseVersion` is still current. */\n  update(request: { token: string; id: Uuid; baseVersion: number; patch: Record<string, unknown> } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;\n  /** `platform.entity_archive` (on these types, the trash). */\n  archive(request: { token: string; ids: readonly Uuid[] } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;\n  /** `platform.entity_unarchive`. */\n  unarchive(request: { token: string; ids: readonly Uuid[] } & EntityWriteOptions): Promise<RecordsResult<EntityWriteAnswer>>;\n  /** The organizations the person belongs to, as row security counts them (`iam.my_orgs()`: archived ones closed). */\n  memberOrganizations(): Promise<RecordsResult<Uuid[]>>;\n}\n\nexport function createEntityClient(options: CreateEntityClientOptions): EntityClient {\n  const source: RecordsDataSource = asRecordsDataSource(options.dataSource ?? options.supabase);\n\n  let warnedHeaderless = false;\n\n  /**\n   * A per-call header rides the request builder supabase-js hands back (`PostgrestBuilder.setHeader`, set\n   * before the builder is awaited). `@ai-matrx/records`' adapter returns that builder unwrapped, so the\n   * header reaches PostgREST on this one call only — never on the client every other caller shares.\n   * A data seam whose answer has no `setHeader` (a host's own adapter, a test double) cannot carry it:\n   * the write still lands, the writer re-reads its own echo once, and the console says why.\n   */\n  function withHeaders(pending: PromiseLike<unknown>, headers: Record<string, string> | undefined): void {\n    if (!headers) return;\n    const builder = pending as { setHeader?: (name: string, value: string) => unknown };\n    if (typeof builder.setHeader === \"function\") {\n      for (const [name, value] of Object.entries(headers)) builder.setHeader(name, value);\n      return;\n    }\n    if (!warnedHeaderless) {\n      warnedHeaderless = true;\n      console.warn(\n        `[@ai-matrx/entity-data] This data source cannot carry a per-call header (${Object.keys(headers).join(\", \")}), so this browser re-reads the notice of its own writes once.`,\n      );\n    }\n  }\n\n  async function call<T>(\n    fn: string,\n    args: Record<string, unknown>,\n    schema: string = ENTITY_DOOR_SCHEMA,\n    headers?: Record<string, string>,\n  ): Promise<RecordsResult<T>> {\n    try {\n      const pending = source.rpc(fn, args, { schema });\n      withHeaders(pending, headers);\n      const answer = await pending;\n      if (answer.error) return { ok: false, error: mapEntityError(answer.error, `${schema}.${fn}`) };\n      return { ok: true, data: answer.data as T };\n    } catch (thrown) {\n      // supabase-js answers failures; a throw here is a transport that never reached the store.\n      return {\n        ok: false,\n        error: mapEntityError({ code: \"\", message: thrown instanceof Error ? thrown.message : String(thrown) }, `${schema}.${fn}`),\n      };\n    }\n  }\n\n  return {\n    list(request) {\n      const args: Record<string, unknown> = {\n        p_entity_type: request.token,\n        p_scope: request.scope ?? null,\n        p_filter: request.filter ?? {},\n        p_search: request.search ?? null,\n        p_sort: request.sort ?? null,\n        p_archived: request.archived ?? \"active\",\n        p_page_size: request.pageSize ?? null,\n        p_after: request.after ?? null,\n        p_with_total: request.withTotal ?? true,\n      };\n      return call<EntityListAnswer>(\"entity_list_scoped\", args);\n    },\n    get(request) {\n      return call<EntityGetAnswer>(\"entity_get\", { p_entity_type: request.token, p_ids: [...request.ids] });\n    },\n    columns(request) {\n      return call<EntityColumnsAnswer>(\"entity_columns\", { p_organization_id: request.organizationId ?? null, p_token: request.token });\n    },\n    insert(request) {\n      return call<EntityWriteAnswer>(\n        \"entity_insert\",\n        { p_entity_type: request.token, p_organization_id: request.organizationId, p_rows: request.rows.map((r) => ({ ...r })) },\n        ENTITY_DOOR_SCHEMA,\n        opHeader(request.opId),\n      );\n    },\n    update(request) {\n      return call<EntityWriteAnswer>(\n        \"entity_update\",\n        { p_entity_type: request.token, p_id: request.id, p_base_version: request.baseVersion, p_patch: request.patch },\n        ENTITY_DOOR_SCHEMA,\n        opHeader(request.opId),\n      );\n    },\n    archive(request) {\n      return call<EntityWriteAnswer>(\"entity_archive\", { p_entity_type: request.token, p_ids: [...request.ids] }, ENTITY_DOOR_SCHEMA, opHeader(request.opId));\n    },\n    unarchive(request) {\n      return call<EntityWriteAnswer>(\"entity_unarchive\", { p_entity_type: request.token, p_ids: [...request.ids] }, ENTITY_DOOR_SCHEMA, opHeader(request.opId));\n    },\n    knob(request) {\n      return call<unknown>(\"knob_resolve\", { p_feature: \"entity_data\", p_key: request.key, p_organization_id: request.organizationId ?? null });\n    },\n    async memberOrganizations() {\n      const answer = await call<unknown>(\"my_orgs\", {}, \"iam\");\n      if (!answer.ok) return answer;\n      const rows = Array.isArray(answer.data) ? answer.data : [];\n      // A SETOF uuid comes back as bare strings; a row shape (`{my_orgs}`) is read the same way.\n      const ids = rows\n        .map((row) => (typeof row === \"string\" ? row : row && typeof row === \"object\" ? Object.values(row as Record<string, unknown>)[0] : null))\n        .filter((id): id is string => typeof id === \"string\");\n      return { ok: true, data: ids };\n    },\n  };\n}\n\nfunction opHeader(opId: string | undefined): Record<string, string> | undefined {\n  return opId ? { [OP_ID_HEADER]: opId } : undefined;\n}\n","// src/core/errors.ts — @ai-matrx/entity-data/core\n//\n// THE ERROR MAP (PHASE-B-APPLETS §4). The entity doors raise their own `MX0xx` class; this turns it\n// into the `RecordsError` every other door of the records package answers, carrying THE STORE'S\n// SENTENCE VERBATIM (message and hint are never rewritten here). Anything that is not an `MX` code\n// (a timeout, a dropped connection, a revoked schema) goes through records' own `mapPgError`.\n\nimport { mapPgError } from \"@ai-matrx/records/core\";\nimport type { PgError, RecordsError, RecordsErrorCode } from \"@ai-matrx/records\";\n\n/**\n * Every MX code a read door raises, and the engine code a screen branches on. A code the doors learn\n * later and this map lacks comes back `internal` with `unmapped: true` (never silently \"handled\").\n */\nexport const ENTITY_REFUSALS: Readonly<Record<string, RecordsErrorCode>> = {\n  /** conflict_version: somebody else's write won. */\n  MX001: \"stale_write\",\n  /** organization_required: the call needs an organization and carried none. */\n  MX002: \"organization_required\",\n  /** forbidden. */\n  MX003: \"door\",\n  /** not_found (also: not visible to this person). */\n  MX004: \"not_found\",\n  /** validation_refused (detail.reason required / bad_value / ambiguous_word / constraint; `not_supported` is read apart below). */\n  MX005: \"invalid_argument\",\n  /** system_column: a write named a column the store owns. */\n  MX008: \"invalid_argument\",\n  /** unknown_identifier: a column that is not there or not usable here. */\n  MX012: \"invalid_argument\",\n  /** cursor_invalid: the page cursor belongs to another list; the engine restarts the page. */\n  MX013: \"invalid_argument\",\n  /** view_not_offered. */\n  MX015: \"invalid_argument\",\n  /** invalid_argument: a parameter the door refuses by name. */\n  MX016: \"invalid_argument\",\n};\n\nexport function mapEntityError(error: PgError, where: string): RecordsError {\n  const mapped = mapPgError(error, where);\n  const state = mapped.sqlstate;\n  if (state && /^MX\\d{3}$/.test(state)) {\n    const code = ENTITY_REFUSALS[state];\n    if (code) {\n      // MX005 that says the store does not offer this yet is a different question for a screen than a bad value.\n      const reason = (mapped.detail as { reason?: unknown } | undefined)?.reason;\n      const known: RecordsError = { ...mapped, code: state === \"MX005\" && reason === \"not_supported\" ? \"not_supported\" : code };\n      delete known.unmapped;\n      delete known.diagnostic;\n      return known;\n    }\n  }\n  return mapped;\n}\n\n/** A refusal this package itself raises (an alias nobody declared, a write not offered yet). */\nexport function refusal(code: RecordsErrorCode, message: string, hint?: string): { ok: false; error: RecordsError } {\n  return { ok: false, error: { code, message, ...(hint ? { hint } : {}) } };\n}\n","// src/core/wire.ts — @ai-matrx/entity-data/core\n//\n// `toWire`: the Applets `Query` (§4) → the door's arguments (scope, filter, sort). Pure.\n//\n// What the doors do not offer yet is NOT filtered, reordered or emulated here: the clause is sent as\n// asked and the door refuses it BY NAME (`\"contains\" filters are not offered yet.`), so the day the\n// door learns it the port already speaks it, and until then the person reads the store's sentence.\n// A browser-side filter would silently drop everything the browser was not shown.\n\nimport type { Query, WhereClause } from \"@ai-matrx/records/data\";\nimport type { EntityWirePredicate, EntityWireQuery, EntityWireSort } from \"./types\";\n\n/** The runtime's underscore names for the three identity columns the doors call `id`, `version`, `organization_id`. */\nconst IDENTITY: Readonly<Record<string, string>> = {\n  _id: \"id\",\n  _version: \"version\",\n  _organization_id: \"organization_id\",\n};\n\nexport const CUSTOM_PREFIX = \"_custom.\";\n\n/**\n * Applets column key → the door's identifier. A custom field is `_custom.<key>` (the key as\n * `columns()` answered it — the same plain key for every viewer; `<key>@<organization_id>` is accepted, never produced).\n */\nexport function wireColumn(column: string, customKeys: ReadonlySet<string>): string {\n  const identity = IDENTITY[column];\n  if (identity) return identity;\n  if (column.startsWith(CUSTOM_PREFIX)) return column;\n  return customKeys.has(column) ? `${CUSTOM_PREFIX}${column}` : column;\n}\n\nfunction predicate(clause: WhereClause, customKeys: ReadonlySet<string>): EntityWirePredicate {\n  const column = wireColumn(clause.column, customKeys);\n  const v = clause.value;\n  switch (clause.op) {\n    case \"eq\":\n      // The store reads \"equals nothing\" as empty (the table port's rule, so both kinds of source agree).\n      return v === null || v === undefined ? { column, op: \"empty\" } : { column, op: \"eq\", value: v };\n    case \"neq\":\n      return v === null || v === undefined ? { column, op: \"empty\", negated: true } : { column, op: \"neq\", value: v };\n    case \"lt\":\n    case \"lte\":\n    case \"gt\":\n    case \"gte\":\n      return { column, op: clause.op, value: v };\n    case \"in\":\n      return { column, op: \"in\", values: Array.isArray(v) ? v : [] };\n    case \"empty\":\n      return v === false ? { column, op: \"empty\", negated: true } : { column, op: \"empty\" };\n    case \"contains\":\n      return { column, op: \"contains\", value: v };\n    default:\n      // An op this version does not know is still SENT, so the door names it, instead of vanishing here.\n      return { column, op: String((clause as WhereClause).op), value: v };\n  }\n}\n\nexport function toWire(query: Query | undefined, customKeys: ReadonlySet<string> = new Set()): EntityWireQuery {\n  const q = query ?? {};\n  const out: EntityWireQuery = {};\n  const scope: NonNullable<EntityWireQuery[\"scope\"]> = {};\n  if (q.lane) scope.kind = q.lane; // absent = the type's own landing lane, decided by the door\n  if (q.org && q.org !== \"all\") scope.organization_id = q.org; // a filter, never a lock\n  if (scope.kind || scope.organization_id) out.scope = scope;\n  if (q.where && q.where.length > 0) out.filter = { all: q.where.map((c) => predicate(c, customKeys)) };\n  const search = q.search?.trim();\n  if (search) out.search = search;\n  if (q.sort && q.sort.length > 0) {\n    out.sort = q.sort.map<EntityWireSort>((s) => ({\n      column: wireColumn(s.column, customKeys),\n      dir: s.direction === \"desc\" ? \"desc\" : \"asc\",\n      nulls: \"last\",\n    }));\n  }\n  if (typeof q.pageSize === \"number\" && Number.isFinite(q.pageSize)) out.pageSize = Math.max(1, Math.floor(q.pageSize));\n  return out;\n}\n","// src/core/realtime.ts — @ai-matrx/entity-data/core\n//\n// LIVE NOTICES FOR PLATFORM LISTS (PHASE-B-APPLETS R4 / U6).\n//\n// The database announces every statement on the five Table-API tables (party, crm_deal, project, task,\n// hr_employee) with ONE broadcast per organization it touched, on the PRIVATE topic\n// `mx:entity-org:<organization>:<token>`, event `entity_bump`, payload\n// `{id, entity_type, organization_id, op, op_id, ids | null, at}` — ids, never values. It is written by\n// `platform.entity_org_notice_stmt` and admitted by `platform.entity_org_topic_admits` through the one RLS\n// policy on `realtime.messages`: a signed-in member of that organization (her own memberships, never the\n// admin route) whose role may read the table. The subscriber re-reads the ids through the read door, so\n// row security decides what she sees at read time.\n//\n// This file joins those topics through `@ai-matrx/realtime` — the ONE realtime layer, never a hand-written\n// `.channel(` — so the socket, `setAuth` before a private join, backoff, dedupe and wake backfill are the\n// manager's.\n//\n//   · ONE CHANNEL PER (organization, token), HOWEVER MANY READERS — opened by the first, closed by the last.\n//   · BURSTS COALESCED per reader: the first notice starts a `batchMs` timer, later ones join it, and\n//     `maxWaitMs` caps how long a steady stream can hold a re-read back (knobs entity_data.realtime_batch_ms\n//     / realtime_max_wait_ms).\n//   · `ids: null` PASSES THROUGH — above knob entity_data.realtime_max_ids the database stops naming ids.\n//   · ECHO DROPPED — a write that carried header `x-matrx-op-id` comes back with that `op_id`; a notice whose\n//     op id this client minted (`@ai-matrx/records` `isOwnOp`) is our own write and is dropped.\n//   · NO REPLAY ON A WAKE OR RECONNECT — the answer is `ids: null` (read again).\n\nimport {\n  defineChannelNamespace,\n  subscribeToRealtimeManager,\n  type ChannelSpec,\n  type RealtimeManager,\n} from \"@ai-matrx/realtime\";\nimport { isOwnOp } from \"@ai-matrx/records\";\n\nimport type { EntityClient } from \"./client\";\n\n/** The topic is a CONTRACT WITH THE DATABASE (a trigger writes it, an RLS policy parses it): built once, here. */\nexport const entityOrgChannel = defineChannelNamespace({\n  namespace: \"entity-org\",\n  foreignTopic: \"mx:entity-org\",\n  parts: [\"organizationId\", \"token\"],\n  description:\n    \"One organization's changes to one platform type (contacts, deals, projects, tasks, employees). Carries NOTICES written by platform.entity_org_notice_stmt — which ids moved, never a value. Admitted by the one RLS policy on realtime.messages to members of that organization.\",\n});\n\n/** The broadcast event the database sends on an organization topic. */\nexport const ENTITY_NOTICE_EVENT = \"entity_bump\";\n\n/** Starting values of the knobs the runtime coalesces with (entity_data.realtime_batch_ms / _max_wait_ms). */\nexport const DEFAULT_BATCH_MS = 150;\nexport const DEFAULT_MAX_WAIT_MS = 1000;\n/** Starting value of knob entity_data.realtime_max_org_topics. */\nexport const DEFAULT_MAX_ORG_TOPICS = 20;\n\nexport interface EntityNotice {\n  id?: string;\n  entity_type?: string;\n  organization_id?: string;\n  op?: \"created\" | \"updated\" | \"deleted\";\n  /** The client operation that caused it (header `x-matrx-op-id`), or null for any other writer. */\n  op_id?: string | null;\n  /** `null` MEANS \"more changed than the database lists: re-read\". */\n  ids?: string[] | null;\n  at?: string;\n}\n\n/** A redelivered notice is the same notice: the database mints one id per send. */\nexport function entityNoticeKey(notice: EntityNotice): string | undefined {\n  return notice.id ?? (notice.at ? `${notice.organization_id ?? \"\"}:${notice.entity_type ?? \"\"}:${notice.at}` : undefined);\n}\n\nexport function entityOrgTopic(organizationId: string, token: string): string {\n  return entityOrgChannel.topic({ organizationId, token });\n}\n\n/** The channel spec for one (organization, token): private, echo-guarded, deduped, backfilled. */\nexport function entityOrgChannelSpec(\n  organizationId: string,\n  token: string,\n  onNotice: (notice: EntityNotice) => void,\n  onBackfill: () => void,\n): ChannelSpec {\n  return {\n    topic: entityOrgTopic(organizationId, token),\n    // Database Broadcast is authorized by RLS on realtime.messages; the manager awaits setAuth() first.\n    private: true,\n    // The sender is Postgres: no Matrx envelope. Our own write is known by the op id it carried.\n    wire: { mode: \"raw\", isOwnMessage: (payload) => isOwnOp((payload as EntityNotice | null)?.op_id) },\n    eventKey: (_source, payload) => entityNoticeKey((payload ?? {}) as EntityNotice),\n    broadcast: [\n      {\n        event: ENTITY_NOTICE_EVENT,\n        onMessage: (message) => {\n          const notice = (message.data ?? {}) as EntityNotice;\n          if (isOwnOp(notice.op_id)) return; // belt and braces: the manager's test ran first\n          onNotice(notice);\n        },\n      },\n    ],\n    // Realtime has no replay: a channel back from a gap re-reads.\n    onBackfill: () => onBackfill(),\n  };\n}\n\n/**\n * Which organization topics to join, in order, until `max`: the active organization, the alias's `org`\n * filter, then the organizations of held rows by number of held rows (descending; organization id\n * ascending on ties), then the person's remaining memberships by id. Only memberships are kept when they\n * are known — any other topic is refused by the database anyway. Deterministic for the same input.\n */\nexport function orderOrganizationTopics(input: {\n  active?: string | null;\n  filter?: string | null;\n  held?: ReadonlyMap<string, number>;\n  members?: readonly string[] | null;\n  max: number;\n}): string[] {\n  const members = input.members ? new Set(input.members) : null;\n  const out: string[] = [];\n  const push = (org: string | null | undefined) => {\n    if (!org || out.includes(org)) return;\n    if (members && !members.has(org)) return;\n    out.push(org);\n  };\n  push(input.active);\n  push(input.filter);\n  const held = [...(input.held ?? new Map<string, number>()).entries()].sort((a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0));\n  for (const [org] of held) push(org);\n  for (const org of [...(input.members ?? [])].sort()) push(org);\n  return out.slice(0, Math.max(0, input.max));\n}\n\nexport interface EntityNoticeSink {\n  /** `ids` to re-read, or `null` to re-read everything this reader shows. */\n  rows(ids: string[] | null): void;\n}\n\nexport interface EntityRealtime {\n  /** Hear `token` across `organizationIds`; the sink gets one coalesced call per burst. Returns the stop. */\n  subscribe(target: { token: string; organizationIds: readonly string[] }, sink: EntityNoticeSink): () => void;\n}\n\nexport interface CreateEntityRealtimeOptions {\n  /** The host's realtime manager. Left out, the AMBIENT manager the app mounted — never a socket of our own. */\n  manager?: RealtimeManager;\n  /** Knob entity_data.realtime_batch_ms (starting value 150). */\n  batchMs?: number;\n  /** Knob entity_data.realtime_max_wait_ms (starting value 1000). */\n  maxWaitMs?: number;\n}\n\ninterface OrgListener {\n  notice(notice: EntityNotice): void;\n  backfill(): void;\n}\n\ninterface OrgChannel {\n  listeners: Set<OrgListener>;\n  stop: (() => void) | null;\n}\n\n/** The live-notice layer for platform lists, bound to a realtime manager. One per host is enough. */\nexport function createEntityRealtime(options: CreateEntityRealtimeOptions = {}): EntityRealtime {\n  const batchMs = options.batchMs ?? DEFAULT_BATCH_MS;\n  const maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;\n  const channels = new Map<string, OrgChannel>();\n\n  const open = (organizationId: string, token: string): OrgChannel => {\n    const channel: OrgChannel = { listeners: new Set(), stop: null };\n    const spec = entityOrgChannelSpec(\n      organizationId,\n      token,\n      (notice) => {\n        for (const listener of channel.listeners) listener.notice(notice);\n      },\n      () => {\n        for (const listener of channel.listeners) listener.backfill();\n      },\n    );\n    if (options.manager) {\n      const handle = options.manager.open(spec);\n      channel.stop = () => handle.close();\n    } else {\n      channel.stop = subscribeToRealtimeManager(() => spec);\n    }\n    return channel;\n  };\n\n  return {\n    subscribe({ token, organizationIds }, sink) {\n      let timer: ReturnType<typeof setTimeout> | null = null;\n      let firstAt = 0;\n      let pending = new Set<string>();\n      let wholeList = false;\n\n      const flush = () => {\n        if (timer !== null) clearTimeout(timer);\n        timer = null;\n        const ids = [...pending];\n        const all = wholeList;\n        pending = new Set();\n        wholeList = false;\n        // THE IDS ARE USED AS IDS. `null` costs a whole re-read; three ids re-read three rows.\n        if (all) sink.rows(null);\n        else if (ids.length > 0) sink.rows(ids);\n      };\n      const nudge = () => {\n        const now = Date.now();\n        if (timer === null) firstAt = now;\n        else clearTimeout(timer);\n        // Wait `batchMs` after the latest notice, never past `maxWaitMs` after the first one.\n        const wait = Math.max(0, Math.min(batchMs, firstAt + maxWaitMs - now));\n        timer = setTimeout(flush, wait);\n      };\n\n      const listener: OrgListener = {\n        notice(notice) {\n          if (notice.entity_type && notice.entity_type !== token) return;\n          if (notice.ids == null) wholeList = true;\n          else for (const id of notice.ids) pending.add(id);\n          nudge();\n        },\n        backfill() {\n          wholeList = true;\n          flush();\n        },\n      };\n\n      const keys = [...new Set(organizationIds)].map((org) => {\n        const key = entityOrgTopic(org, token);\n        const channel = channels.get(key) ?? open(org, token);\n        channels.set(key, channel);\n        channel.listeners.add(listener);\n        return key;\n      });\n\n      return () => {\n        if (timer !== null) clearTimeout(timer);\n        for (const key of keys) {\n          const channel = channels.get(key);\n          if (!channel) continue;\n          channel.listeners.delete(listener);\n          if (channel.listeners.size > 0) continue;\n          // The last reader of this (organization, token) left: its one subscription goes with it.\n          channel.stop?.();\n          channels.delete(key);\n        }\n      };\n    },\n  };\n}\n\n/** The three live-update knobs as the store answers them for an organization (starting values when unset). */\nexport async function readEntityRealtimeKnobs(\n  client: Pick<EntityClient, \"knob\">,\n  organizationId?: string | null,\n): Promise<{ batchMs: number; maxWaitMs: number; maxOrgTopics: number }> {\n  const read = async (key: string, fallback: number) => {\n    const answer = await client.knob({ key, organizationId: organizationId ?? null });\n    const value = answer.ok ? Number(answer.data) : Number.NaN;\n    if (!Number.isFinite(value)) {\n      // SAID OUT LOUD: the starting value stands in for a knob the store did not answer.\n      console.warn(`[@ai-matrx/entity-data] knob entity_data.${key} did not resolve; using its starting value ${fallback}.`);\n      return fallback;\n    }\n    return value;\n  };\n  const [batchMs, maxWaitMs, maxOrgTopics] = await Promise.all([\n    read(\"realtime_batch_ms\", DEFAULT_BATCH_MS),\n    read(\"realtime_max_wait_ms\", DEFAULT_MAX_WAIT_MS),\n    read(\"realtime_max_org_topics\", DEFAULT_MAX_ORG_TOPICS),\n  ]);\n  return { batchMs, maxWaitMs, maxOrgTopics };\n}\n"],"mappings":"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","names":["import_core"]}
+{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["// @ai-matrx/entity-data — DEPRECATED: this package now lives inside records as `@ai-matrx/records/entity`.\n// A thin re-export until no published @ai-matrx package imports it (check-tarball-sibling-imports).\nexport * from \"@ai-matrx/records/entity\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,yBAAc,qCAFd;","names":[]}

package/dist/core/index.d.cts

@@ -1,27 +1 @@
-import { p as EntityWireQuery } from '../realtime-DL-bfUFj.cjs';
-export { C as CreateEntityClientOptions, a as CreateEntityRealtimeOptions, D as DEFAULT_BATCH_MS, b as DEFAULT_MAX_ORG_TOPICS, c as DEFAULT_MAX_WAIT_MS, E as ENTITY_DOOR_SCHEMA, d as ENTITY_NOTICE_EVENT, e as EntityClient, f as EntityColumnWire, g as EntityColumnsAnswer, h as EntityGetAnswer, i as EntityListAnswer, j as EntityListRequest, k as EntityNotice, l as EntityNoticeSink, m as EntityRealtime, n as EntitySortApplied, o as EntityWirePredicate, q as EntityWireRef, r as EntityWireRow, s as EntityWireSort, t as EntityWriteAnswer, u as EntityWriteOptions, O as OP_ID_HEADER, v as createEntityClient, w as createEntityRealtime, x as entityNoticeKey, y as entityOrgChannel, z as entityOrgChannelSpec, A as entityOrgTopic, B as orderOrganizationTopics, F as readEntityRealtimeKnobs } from '../realtime-DL-bfUFj.cjs';
-import { RecordsErrorCode, PgError, RecordsError } from '@ai-matrx/records';
-import { Query } from '@ai-matrx/records/data';
-import '@ai-matrx/realtime';
-
-/**
- * Every MX code a read door raises, and the engine code a screen branches on. A code the doors learn
- * later and this map lacks comes back `internal` with `unmapped: true` (never silently "handled").
- */
-declare const ENTITY_REFUSALS: Readonly<Record<string, RecordsErrorCode>>;
-declare function mapEntityError(error: PgError, where: string): RecordsError;
-/** A refusal this package itself raises (an alias nobody declared, a write not offered yet). */
-declare function refusal(code: RecordsErrorCode, message: string, hint?: string): {
-    ok: false;
-    error: RecordsError;
-};
-
-declare const CUSTOM_PREFIX = "_custom.";
-/**
- * Applets column key → the door's identifier. A custom field is `_custom.<key>` (the key as
- * `columns()` answered it — the same plain key for every viewer; `<key>@<organization_id>` is accepted, never produced).
- */
-declare function wireColumn(column: string, customKeys: ReadonlySet<string>): string;
-declare function toWire(query: Query | undefined, customKeys?: ReadonlySet<string>): EntityWireQuery;
-
-export { CUSTOM_PREFIX, ENTITY_REFUSALS, EntityWireQuery, mapEntityError, refusal, toWire, wireColumn };
+export * from '@ai-matrx/records/entity';

package/dist/core/index.d.ts

@@ -1,27 +1 @@
-import { p as EntityWireQuery } from '../realtime-DL-bfUFj.js';
-export { C as CreateEntityClientOptions, a as CreateEntityRealtimeOptions, D as DEFAULT_BATCH_MS, b as DEFAULT_MAX_ORG_TOPICS, c as DEFAULT_MAX_WAIT_MS, E as ENTITY_DOOR_SCHEMA, d as ENTITY_NOTICE_EVENT, e as EntityClient, f as EntityColumnWire, g as EntityColumnsAnswer, h as EntityGetAnswer, i as EntityListAnswer, j as EntityListRequest, k as EntityNotice, l as EntityNoticeSink, m as EntityRealtime, n as EntitySortApplied, o as EntityWirePredicate, q as EntityWireRef, r as EntityWireRow, s as EntityWireSort, t as EntityWriteAnswer, u as EntityWriteOptions, O as OP_ID_HEADER, v as createEntityClient, w as createEntityRealtime, x as entityNoticeKey, y as entityOrgChannel, z as entityOrgChannelSpec, A as entityOrgTopic, B as orderOrganizationTopics, F as readEntityRealtimeKnobs } from '../realtime-DL-bfUFj.js';
-import { RecordsErrorCode, PgError, RecordsError } from '@ai-matrx/records';
-import { Query } from '@ai-matrx/records/data';
-import '@ai-matrx/realtime';
-
-/**
- * Every MX code a read door raises, and the engine code a screen branches on. A code the doors learn
- * later and this map lacks comes back `internal` with `unmapped: true` (never silently "handled").
- */
-declare const ENTITY_REFUSALS: Readonly<Record<string, RecordsErrorCode>>;
-declare function mapEntityError(error: PgError, where: string): RecordsError;
-/** A refusal this package itself raises (an alias nobody declared, a write not offered yet). */
-declare function refusal(code: RecordsErrorCode, message: string, hint?: string): {
-    ok: false;
-    error: RecordsError;
-};
-
-declare const CUSTOM_PREFIX = "_custom.";
-/**
- * Applets column key → the door's identifier. A custom field is `_custom.<key>` (the key as
- * `columns()` answered it — the same plain key for every viewer; `<key>@<organization_id>` is accepted, never produced).
- */
-declare function wireColumn(column: string, customKeys: ReadonlySet<string>): string;
-declare function toWire(query: Query | undefined, customKeys?: ReadonlySet<string>): EntityWireQuery;
-
-export { CUSTOM_PREFIX, ENTITY_REFUSALS, EntityWireQuery, mapEntityError, refusal, toWire, wireColumn };
+export * from '@ai-matrx/records/entity';