@ai-matrx/entity-data 0.3.44 → 0.4.1

package/dist/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,721 +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/index.ts
 var src_exports = {};
-__export(src_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,
-  createEntityDataPort: () => createEntityDataPort,
-  createEntityRealtime: () => createEntityRealtime,
-  createSeedPort: () => createSeedPort,
-  entityNoticeKey: () => entityNoticeKey,
-  entityOrgChannel: () => entityOrgChannel,
-  entityOrgChannelSpec: () => entityOrgChannelSpec,
-  entityOrgTopic: () => entityOrgTopic,
-  mapEntityError: () => mapEntityError,
-  orderOrganizationTopics: () => orderOrganizationTopics,
-  readEntityRealtimeKnobs: () => readEntityRealtimeKnobs,
-  refusal: () => refusal,
-  toColumn: () => toColumn,
-  toColumns: () => toColumns,
-  toRefs: () => toRefs,
-  toRow: () => toRow,
-  toWire: () => toWire,
-  toWireValue: () => toWireValue,
-  toWireValues: () => toWireValues,
-  wireColumn: () => wireColumn
-});
 module.exports = __toCommonJS(src_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 };
-}
-
-// src/port/port.ts
-var import_uuid = require("@ai-matrx/kit/uuid");
-var import_records2 = require("@ai-matrx/records");
-
-// src/port/rows.ts
-var IDENTITY_COLUMNS = /* @__PURE__ */ new Set(["id", "version", "organization_id"]);
-var PRESENTATION_KEYS = /* @__PURE__ */ new Set(["_state", "_k"]);
-function isRefList(value) {
-  return Array.isArray(value) && value.length > 0 && value.every((item) => item !== null && typeof item === "object" && typeof item.token === "string" && typeof item.id === "string");
-}
-function toRefs(value) {
-  if (!isRefList(value)) return [];
-  return value.map((item) => ({ token: item.token, id: item.id, label: typeof item.label === "string" ? item.label : null }));
-}
-function toRow(wire) {
-  const row = {
-    _id: wire.id,
-    _version: wire.version,
-    _organization_id: wire.organization_id,
-    _custom: wire._custom && typeof wire._custom === "object" ? { ...wire._custom } : {}
-  };
-  for (const [key, value] of Object.entries(wire)) {
-    if (IDENTITY_COLUMNS.has(key) || PRESENTATION_KEYS.has(key) || key === "_custom") continue;
-    row[key] = isRefList(value) ? toRefs(value) : value === void 0 ? null : value;
-  }
-  return row;
-}
-function toColumn(wire) {
-  const column = {
-    key: wire.key,
-    label: wire.label || wire.key,
-    type: wire.type,
-    origin: wire.origin === "custom" ? "custom" : "platform",
-    required: Boolean(wire.required),
-    readOnly: Boolean(wire.readOnly)
-  };
-  if (wire.choices && wire.choices.length > 0) column.choices = [...wire.choices];
-  if (wire.linksTo && wire.linksTo.length > 0) column.linksTo = [...wire.linksTo];
-  return column;
-}
-function toColumns(wire) {
-  return wire.filter((c) => !IDENTITY_COLUMNS.has(c.key)).map(toColumn);
-}
-
-// src/port/port.ts
-function toWireValue(value) {
-  if (isRef(value)) return value.id;
-  if (Array.isArray(value) && value.length > 0 && value.every(isRef)) {
-    return value.length === 1 ? value[0].id : value.map((ref) => ref.id);
-  }
-  return value;
-}
-function isRef(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value) && typeof value.token === "string" && typeof value.id === "string";
-}
-function toWireValues(values) {
-  const out = {};
-  for (const [key, value] of Object.entries(values)) {
-    if (value === void 0) continue;
-    if (key === "_custom" && value && typeof value === "object" && !Array.isArray(value)) {
-      out._custom = Object.fromEntries(Object.entries(value).filter(([, v]) => v !== void 0).map(([k, v]) => [k, toWireValue(v)]));
-      continue;
-    }
-    out[key] = Array.isArray(value) && value.length === 0 && key !== "_custom" ? null : toWireValue(value);
-  }
-  return out;
-}
-function createEntityDataPort(options) {
-  const client = options.client ?? createEntityClient({ dataSource: options.dataSource });
-  const activeOrganization = () => (options.activeOrganizationId ? options.activeOrganizationId() : options.organization) ?? null;
-  const gets = /* @__PURE__ */ new Map();
-  const aliases = options.aliases;
-  const shapes = /* @__PURE__ */ new Map();
-  let warnedNotLive = false;
-  const held = /* @__PURE__ */ new Map();
-  const replans = /* @__PURE__ */ new Map();
-  let memberships = null;
-  let maxOrgTopics = null;
-  function hold(alias, rows) {
-    const byId = held.get(alias) ?? /* @__PURE__ */ new Map();
-    held.set(alias, byId);
-    const before = new Set(byId.values());
-    for (const r of rows) {
-      if (typeof r.id === "string" && typeof r.organization_id === "string") byId.set(r.id, r.organization_id);
-    }
-    if ([...byId.values()].some((org) => !before.has(org))) for (const replan of replans.get(alias) ?? []) replan();
-  }
-  function heldCounts(alias) {
-    const counts = /* @__PURE__ */ new Map();
-    for (const org of held.get(alias)?.values() ?? []) counts.set(org, (counts.get(org) ?? 0) + 1);
-    return counts;
-  }
-  function membershipsOnce() {
-    memberships ??= client.memberOrganizations().then((answer) => {
-      if (answer.ok) return answer.data;
-      memberships = null;
-      console.warn(`[@ai-matrx/entity-data] Could not read your organizations for live updates: ${answer.error.message}`);
-      return null;
-    });
-    return memberships;
-  }
-  function maxOrgTopicsOnce() {
-    maxOrgTopics ??= client.knob({ key: "realtime_max_org_topics", organizationId: activeOrganization() }).then((answer) => {
-      const value = answer.ok ? Number(answer.data) : Number.NaN;
-      if (Number.isFinite(value) && value >= 0) return value;
-      console.warn(`[@ai-matrx/entity-data] knob entity_data.realtime_max_org_topics did not resolve; joining at most ${DEFAULT_MAX_ORG_TOPICS} organizations.`);
-      return DEFAULT_MAX_ORG_TOPICS;
-    });
-    return maxOrgTopics;
-  }
-  const tokenBindings = /* @__PURE__ */ new Map();
-  function bindingOf(alias) {
-    if (Object.prototype.hasOwnProperty.call(aliases, alias)) return aliases[alias];
-    if (!options.tokensAreAliases || !/^[a-z][a-z0-9_]*$/.test(alias)) return null;
-    let bound = tokenBindings.get(alias);
-    if (!bound) {
-      bound = { kind: "entity", token: alias };
-      tokenBindings.set(alias, bound);
-    }
-    return bound;
-  }
-  function noSuchAlias(alias) {
-    return refusal("not_found", `This Applet has no data source called "${alias}".`, "Use one of the aliases sources() lists.");
-  }
-  function shapeOf(alias, binding) {
-    let held2 = shapes.get(alias);
-    if (!held2) {
-      held2 = client.columns({ token: binding.token, organizationId: binding.organizationId ?? null }).then((answer) => {
-        if (!answer.ok) shapes.delete(alias);
-        return answer;
-      });
-      shapes.set(alias, held2);
-    }
-    return held2;
-  }
-  function getCoalesced(alias, token, id) {
-    return new Promise((resolve) => {
-      let batch = gets.get(alias);
-      if (!batch) {
-        batch = /* @__PURE__ */ new Map();
-        gets.set(alias, batch);
-        const asked = batch;
-        queueMicrotask(() => {
-          gets.delete(alias);
-          void flushGets(alias, token, asked);
-        });
-      }
-      const waiting = batch.get(id) ?? [];
-      waiting.push(resolve);
-      batch.set(id, waiting);
-    });
-  }
-  async function flushGets(alias, token, asked) {
-    const answer = await client.get({ token, ids: [...asked.keys()] });
-    if (answer.ok) hold(alias, answer.data.rows);
-    const byId = new Map(answer.ok ? answer.data.rows.map((r) => [r.id, r]) : []);
-    for (const [id, waiting] of asked) {
-      const found = byId.get(id);
-      const wire = found && found["_state"]?.archived === true ? void 0 : found;
-      const result = answer.ok ? { ok: true, data: wire ? toRow(wire) : null } : answer;
-      for (const resolve of waiting) resolve(result);
-    }
-  }
-  function readBack(alias, answer, what) {
-    if (!answer.ok) return answer;
-    hold(alias, answer.data.rows);
-    const wire = answer.data.rows[0];
-    if (!wire) {
-      return refusal(
-        "not_found",
-        `${what} was saved, but you cannot open it now, so it is not shown here.`,
-        "The row is in the store; who may open it decides whether it appears in this list."
-      );
-    }
-    return { ok: true, data: toRow(wire) };
-  }
-  function done(answer) {
-    return answer.ok ? { ok: true, data: void 0 } : answer;
-  }
-  return {
-    async sources() {
-      const out = [];
-      for (const [alias, binding] of Object.entries(aliases)) {
-        const shape = await shapeOf(alias, binding);
-        if (!shape.ok) return shape;
-        out.push({
-          alias,
-          label: binding.label ?? shape.data.label ?? alias,
-          kind: "entity",
-          canCreate: Boolean(shape.data.can_create),
-          canUpdate: Boolean(shape.data.can_update)
-        });
-      }
-      return { ok: true, data: out };
-    },
-    async describe(alias) {
-      const binding = bindingOf(alias);
-      if (!binding) return noSuchAlias(alias);
-      const shape = await shapeOf(alias, binding);
-      if (!shape.ok) return shape;
-      return {
-        ok: true,
-        data: {
-          token: binding.token,
-          label: binding.label ?? shape.data.label ?? binding.token,
-          canCreate: Boolean(shape.data.can_create),
-          canUpdate: Boolean(shape.data.can_update)
-        }
-      };
-    },
-    async columns(alias) {
-      const binding = bindingOf(alias);
-      if (!binding) return noSuchAlias(alias);
-      const shape = await shapeOf(alias, binding);
-      return shape.ok ? { ok: true, data: toColumns(shape.data.columns) } : shape;
-    },
-    async list(alias, q = {}, cursor) {
-      const binding = bindingOf(alias);
-      if (!binding) return noSuchAlias(alias);
-      let customKeys = /* @__PURE__ */ new Set();
-      if (q.where && q.where.length > 0 || q.sort && q.sort.length > 0) {
-        const shape = await shapeOf(alias, binding);
-        if (!shape.ok) return shape;
-        customKeys = new Set(shape.data.columns.filter((c) => c.origin === "custom").map((c) => c.key));
-      }
-      const wire = toWire(q, customKeys);
-      if (binding.organizationId) wire.scope = { ...wire.scope, organization_id: binding.organizationId };
-      const answer = await client.list({ token: binding.token, ...wire, after: cursor ?? null });
-      if (!answer.ok) return answer;
-      const { data } = answer;
-      if (data.sort_ignored.length > 0) {
-        console.warn(`[@ai-matrx/entity-data] "${alias}" sorts by one column for now; ignored: ${data.sort_ignored.join(", ")}.`);
-      }
-      hold(alias, data.rows);
-      const page = {
-        rows: data.rows.map(toRow),
-        // A count that stopped at the store's cap is a floor, not a count: unknown beats a wrong number.
-        total: data.total === null || data.total === void 0 || data.total_is_capped ? null : data.total,
-        cursor: data.has_more ? data.next_after : null
-      };
-      return { ok: true, data: page };
-    },
-    async get(alias, id) {
-      const binding = bindingOf(alias);
-      if (!binding) return noSuchAlias(alias);
-      if (!(0, import_uuid.isUuidShape)(id)) return refusal("invalid_argument", `"${String(id)}" is not a row id.`);
-      return getCoalesced(alias, binding.token, id);
-    },
-    async create(alias, values) {
-      const binding = bindingOf(alias);
-      if (!binding) return noSuchAlias(alias);
-      const organizationId = binding.organizationId ?? activeOrganization();
-      if (!organizationId) {
-        return refusal(
-          "organization_required",
-          "Choose the organization this new record belongs to.",
-          "Pick an organization, then add the row again. Nothing was saved."
-        );
-      }
-      const answer = await client.insert({ token: binding.token, organizationId, rows: [toWireValues(values)], opId: (0, import_records2.mintOpId)() });
-      return readBack(alias, answer, "The new row");
-    },
-    async update(alias, id, patch, baseVersion) {
-      const binding = bindingOf(alias);
-      if (!binding) return noSuchAlias(alias);
-      if (!(0, import_uuid.isUuidShape)(id)) return refusal("invalid_argument", `"${String(id)}" is not a row id.`);
-      const answer = await client.update({ token: binding.token, id, baseVersion, patch: toWireValues(patch), opId: (0, import_records2.mintOpId)() });
-      return readBack(alias, answer, "The change");
-    },
-    async archive(alias, id) {
-      const binding = bindingOf(alias);
-      if (!binding) return noSuchAlias(alias);
-      if (!(0, import_uuid.isUuidShape)(id)) return refusal("invalid_argument", `"${String(id)}" is not a row id.`);
-      return done(await client.archive({ token: binding.token, ids: [id], opId: (0, import_records2.mintOpId)() }));
-    },
-    async restore(alias, id) {
-      const binding = bindingOf(alias);
-      if (!binding) return noSuchAlias(alias);
-      if (!(0, import_uuid.isUuidShape)(id)) return refusal("invalid_argument", `"${String(id)}" is not a row id.`);
-      return done(await client.unarchive({ token: binding.token, ids: [id], opId: (0, import_records2.mintOpId)() }));
-    },
-    subscribe(event, listener) {
-      const alias = event.startsWith("rows:") ? event.slice(5) : null;
-      const binding = alias ? bindingOf(alias) : null;
-      if (!alias || !binding) {
-        throw new Error(`DataPort.subscribe: "${event}" is not an event this Applet's port carries. Use rows:<alias>.`);
-      }
-      const realtime = options.realtime;
-      if (!realtime) {
-        if (!warnedNotLive) {
-          warnedNotLive = true;
-          console.warn("[@ai-matrx/entity-data] This host bound no realtime layer, so other people's changes appear on the next read.");
-        }
-        return () => {
-        };
-      }
-      let stopped = false;
-      let joined = [];
-      let stopLive = null;
-      const sink = { rows: (ids) => listener({ ids: ids === null ? null : [...ids] }) };
-      const plan = async () => {
-        const organizationIds = binding.organizationId ? [binding.organizationId] : orderOrganizationTopics({
-          active: activeOrganization(),
-          held: heldCounts(alias),
-          members: await membershipsOnce(),
-          max: await maxOrgTopicsOnce()
-        });
-        if (stopped) return;
-        if (organizationIds.length === joined.length && organizationIds.every((org, i) => org === joined[i])) return;
-        const previous = stopLive;
-        joined = organizationIds;
-        stopLive = realtime.subscribe({ token: binding.token, organizationIds }, sink);
-        previous?.();
-      };
-      const replan = () => void plan();
-      const set = replans.get(alias) ?? /* @__PURE__ */ new Set();
-      replans.set(alias, set);
-      set.add(replan);
-      replan();
-      return () => {
-        stopped = true;
-        set.delete(replan);
-        stopLive?.();
-        stopLive = null;
-      };
-    }
-  };
-}
-function createSeedPort(dataSource) {
-  return createEntityDataPort({ client: createEntityClient({ dataSource }), aliases: {}, tokensAreAliases: true, activeOrganizationId: () => null });
-}
+__reExport(src_exports, require("@ai-matrx/records/entity"), module.exports);
 //# sourceMappingURL=index.cjs.map