@ai-matrx/records 0.87.32 → 0.92.0

package/dist/{types-CLP5H4Wk.d.cts → types-9Q5SHRDJ.d.cts}

@@ -1,5 +1,5 @@
-import { A as AggregateOperation, a as AggregateFilter, D as DashboardBlockKind, b as AggregateMeasure, c as AggregateBucket, S as SubscriptionCadence } from './subscription-BD9DnJxX.cjs';
-import { U as UseCase, a as UseCaseTable, b as UseCaseField, c as UseCaseRow, d as UseCaseForm, e as UseCaseFormField, f as UseCaseNotificationTrigger, N as NotificationChannel, g as UseCaseProvenance } from './types-C2uspRtf.cjs';
+import { A as AggregateOperation, a as AggregateFilter, D as DashboardBlockKind, b as AggregateMeasure, c as AggregateBucket, S as SubscriptionCadence } from './subscription-D-VEzvyy.cjs';
+import { U as UseCase, a as UseCaseTable, b as UseCaseField, c as UseCaseRow, d as UseCaseForm, e as UseCaseFormField, f as UseCaseNotificationTrigger, N as NotificationChannel, g as UseCaseProvenance } from './types-Cs2MyE3u.cjs';
 
 declare const TABLE_KERNEL_ID = "11111111-0000-4000-8000-000000000001";
 type ConfidentialLevel = "viewer" | "commenter" | "editor";

package/dist/{types-DmPkWQic.d.ts → types-CfYy-vdV.d.ts}

@@ -1,5 +1,5 @@
-import { A as AggregateOperation, a as AggregateFilter, D as DashboardBlockKind, b as AggregateMeasure, c as AggregateBucket, S as SubscriptionCadence } from './subscription-D7KQBHXN.js';
-import { U as UseCase, a as UseCaseTable, b as UseCaseField, c as UseCaseRow, d as UseCaseForm, e as UseCaseFormField, f as UseCaseNotificationTrigger, N as NotificationChannel, g as UseCaseProvenance } from './types-Dv61jStB.js';
+import { A as AggregateOperation, a as AggregateFilter, D as DashboardBlockKind, b as AggregateMeasure, c as AggregateBucket, S as SubscriptionCadence } from './subscription-5CLN3Jug.js';
+import { U as UseCase, a as UseCaseTable, b as UseCaseField, c as UseCaseRow, d as UseCaseForm, e as UseCaseFormField, f as UseCaseNotificationTrigger, N as NotificationChannel, g as UseCaseProvenance } from './types-DF-dxB_l.js';
 
 declare const TABLE_KERNEL_ID = "11111111-0000-4000-8000-000000000001";
 type ConfidentialLevel = "viewer" | "commenter" | "editor";

package/dist/{types-C2uspRtf.d.cts → types-Cs2MyE3u.d.cts}

@@ -1,5 +1,5 @@
-import { T as TableType, a as TableDisplay, S as StorageMode, F as FieldSource, C as ComputeOn, b as FieldSensitivity, c as ContextPolicy, d as RelationFlavor, e as RelationCardinality, O as OnDelete } from './record-DpB2QgAZ.cjs';
-import { F as FieldTypeWord, a as FieldRule } from './field-BanTVGK2.cjs';
+import { g as TableType, h as TableDisplay, S as StorageMode, F as FieldSource, C as ComputeOn, i as FieldSensitivity, j as ContextPolicy, b as RelationFlavor, d as RelationCardinality, O as OnDelete } from './record-BQi92d4-.cjs';
+import { F as FieldTypeWord, a as FieldRule } from './field-BJBnTyJ0.cjs';
 
 /**
  * Who the data belongs to. A test organization is created under this name — the

package/dist/{types-Dv61jStB.d.ts → types-DF-dxB_l.d.ts}

@@ -1,5 +1,5 @@
-import { T as TableType, a as TableDisplay, S as StorageMode, F as FieldSource, C as ComputeOn, b as FieldSensitivity, c as ContextPolicy, d as RelationFlavor, e as RelationCardinality, O as OnDelete } from './record-DpB2QgAZ.js';
-import { F as FieldTypeWord, a as FieldRule } from './field-BPABOJ2Y.js';
+import { g as TableType, h as TableDisplay, S as StorageMode, F as FieldSource, C as ComputeOn, i as FieldSensitivity, j as ContextPolicy, b as RelationFlavor, d as RelationCardinality, O as OnDelete } from './record-BQi92d4-.js';
+import { F as FieldTypeWord, a as FieldRule } from './field-Ti5iAxFr.js';
 
 /**
  * Who the data belongs to. A test organization is created under this name — the

package/dist/types-DTEGaxso.d.cts

@@ -0,0 +1,139 @@
+import { E as EntityRefWithWords } from './relation-DMwkmzgN.cjs';
+import { U as Uuid, R as RecordsResult } from './record-BQi92d4-.cjs';
+
+/** §0. A link to any thing: `{token, id, label}`. A custom row's token is `record`. Every link reads as `EntityRef[]`. */
+type EntityRef = EntityRefWithWords;
+/** The token a custom table's row carries (platform.entity_types maps `record` → `custom.record`). */
+declare const CUSTOM_ROW_TOKEN = "record";
+/** §0. One column, read live — never from a generated file. */
+interface Column {
+    /** The store's stable field key — never derived from the label. No platform key starts with "_". */
+    key: string;
+    label: string;
+    /** The store's word for what the value is: text, number, date, datetime, boolean, list, relation, formula, … */
+    type: string;
+    origin: "platform" | "custom";
+    required: boolean;
+    /** For a choice column: the words a person picks from (what a cell reads as and a write takes). */
+    choices?: string[];
+    /** For a link column: what it may point at (a custom table's id, or entity tokens). */
+    linksTo?: string[];
+    /**
+     * For a link column: the alias, in the SAME port, that serves the table it points at — so a form can list
+     * the linked rows to pick from. Absent when no source of this Applet serves that table.
+     */
+    linksToSource?: string;
+    /**
+     * The store's own answer to "does this column hold more than one value" (`custom.field.multi`). A choice
+     * column's type is `list` whether it takes one word or many — only this tells them apart (Status, one
+     * value, drew as four switches and the store refused the list it sent: social planner, 2026-10-08).
+     */
+    multi?: boolean;
+    /** The column a row is named by (the table's `title_field`) — what a link to the row reads as. */
+    title?: boolean;
+    readOnly: boolean;
+}
+/** §0. One row, keyed by `Column.key`. Underscore keys are the runtime's own. */
+interface Row {
+    _id: Uuid;
+    _version: number;
+    _organization_id: Uuid;
+    /** On a platform row only: the organization's custom fields (a real column may be named `custom`). */
+    _custom?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** §0. What a write carries, keyed by `Column.key`; `_custom` on platform sources. */
+type Values = Record<string, unknown> & {
+    _custom?: Record<string, unknown>;
+};
+type WhereOp = "eq" | "neq" | "lt" | "lte" | "gt" | "gte" | "contains" | "in" | "empty";
+interface WhereClause {
+    column: string;
+    op: WhereOp;
+    value?: unknown;
+}
+type Lane = "all" | "mine" | "team" | "orgs" | "shared" | "public" | "system";
+/** §4. A question of one source. Every clause must hold. */
+interface Query {
+    where?: WhereClause[];
+    search?: string;
+    sort?: {
+        column: string;
+        direction?: "asc" | "desc";
+    }[];
+    pageSize?: number;
+    /** Default: the type's "Shown to by default" knob. A custom table has one lane: what row security shows. */
+    lane?: Lane;
+    /** A filter, never a lock. Default "all". */
+    org?: Uuid | "all";
+}
+/** §4. One page; `cursor` is null on the last one. */
+interface Page {
+    rows: Row[];
+    total: number | null;
+    cursor: string | null;
+}
+interface DataSource {
+    alias: string;
+    label: string;
+    kind: "table" | "entity";
+    canCreate: boolean;
+    canUpdate: boolean;
+}
+/** The one event stream a source has: these ids moved — re-read only them. `null`: cannot tell which. */
+interface RowsEvent {
+    ids: Uuid[] | null;
+    /** The table's columns moved (one added, retired or changed): re-read `columns()` too. */
+    shape?: true;
+}
+type DataPortEventName = `rows:${string}`;
+/** §4. The host's data port, scoped to ONE mounted Applet's aliases. Every call answers, never throws. */
+interface DataPort {
+    sources(): Promise<RecordsResult<DataSource[]>>;
+    columns(alias: string): Promise<RecordsResult<Column[]>>;
+    list(alias: string, q: Query, cursor?: string): Promise<RecordsResult<Page>>;
+    get(alias: string, id: Uuid): Promise<RecordsResult<Row | null>>;
+    create(alias: string, values: Values): Promise<RecordsResult<Row>>;
+    update(alias: string, id: Uuid, patch: Values, baseVersion: number): Promise<RecordsResult<Row>>;
+    archive(alias: string, id: Uuid): Promise<RecordsResult<void>>;
+    restore(alias: string, id: Uuid): Promise<RecordsResult<void>>;
+}
+/**
+ * The frame's side of the §1 event stream `rows:<alias>` (the AppletHost's `host.events`). The listener
+ * stays in the frame; only the event payload `{ids, shape?}` crosses the channel.
+ */
+interface DataEvents {
+    on(event: DataPortEventName, listener: (event: RowsEvent) => void): () => void;
+}
+/**
+ * The HOST's DataPort (contracts amendment 2.2): the port plus the producer of its event streams.
+ * `subscribe` never crosses the frame/host channel — the AppletHost turns it into `rows:<alias>`.
+ */
+interface HostDataPort extends DataPort {
+    subscribe(event: DataPortEventName, listener: (event: RowsEvent) => void): () => void;
+}
+/** An alias as the Applet record declares it: one table plus its organization (an entity token is phase B). */
+interface TableAlias {
+    kind: "table";
+    tableId: Uuid;
+    organizationId: Uuid;
+    /** Shown in `sources()`; the table's own name when left out. */
+    label?: string;
+}
+/**
+ * An alias bound to one PLATFORM entity type (contacts, projects, tasks…), served by `@ai-matrx/entity-data`'s port.
+ * `organizationId` is an assumed organization FILTER for its lists, never a lock; writes carry the active organization.
+ */
+interface EntityAlias {
+    kind: "entity";
+    /** The type's token in `platform.entity_types` (`party`, `project`, `task`, …). */
+    token: string;
+    organizationId?: Uuid;
+    label?: string;
+}
+/** Every alias an Applet record can declare. A host routes each kind to the port that serves it. */
+type AnyAlias = TableAlias | EntityAlias;
+/** What the table port takes (it serves `table` aliases only). */
+type AliasBinding = TableAlias;
+
+export { type AliasBinding as A, type Column as C, type DataEvents as D, type EntityAlias as E, type HostDataPort as H, type Lane as L, type Page as P, type Query as Q, type Row as R, type TableAlias as T, type Values as V, type WhereClause as W, type AnyAlias as a, CUSTOM_ROW_TOKEN as b, type DataPort as c, type DataPortEventName as d, type DataSource as e, type EntityRef as f, type RowsEvent as g, type WhereOp as h };

package/dist/types-Dji5SpFS.d.ts

@@ -0,0 +1,139 @@
+import { E as EntityRefWithWords } from './relation-DlcqV_W5.js';
+import { U as Uuid, R as RecordsResult } from './record-BQi92d4-.js';
+
+/** §0. A link to any thing: `{token, id, label}`. A custom row's token is `record`. Every link reads as `EntityRef[]`. */
+type EntityRef = EntityRefWithWords;
+/** The token a custom table's row carries (platform.entity_types maps `record` → `custom.record`). */
+declare const CUSTOM_ROW_TOKEN = "record";
+/** §0. One column, read live — never from a generated file. */
+interface Column {
+    /** The store's stable field key — never derived from the label. No platform key starts with "_". */
+    key: string;
+    label: string;
+    /** The store's word for what the value is: text, number, date, datetime, boolean, list, relation, formula, … */
+    type: string;
+    origin: "platform" | "custom";
+    required: boolean;
+    /** For a choice column: the words a person picks from (what a cell reads as and a write takes). */
+    choices?: string[];
+    /** For a link column: what it may point at (a custom table's id, or entity tokens). */
+    linksTo?: string[];
+    /**
+     * For a link column: the alias, in the SAME port, that serves the table it points at — so a form can list
+     * the linked rows to pick from. Absent when no source of this Applet serves that table.
+     */
+    linksToSource?: string;
+    /**
+     * The store's own answer to "does this column hold more than one value" (`custom.field.multi`). A choice
+     * column's type is `list` whether it takes one word or many — only this tells them apart (Status, one
+     * value, drew as four switches and the store refused the list it sent: social planner, 2026-10-08).
+     */
+    multi?: boolean;
+    /** The column a row is named by (the table's `title_field`) — what a link to the row reads as. */
+    title?: boolean;
+    readOnly: boolean;
+}
+/** §0. One row, keyed by `Column.key`. Underscore keys are the runtime's own. */
+interface Row {
+    _id: Uuid;
+    _version: number;
+    _organization_id: Uuid;
+    /** On a platform row only: the organization's custom fields (a real column may be named `custom`). */
+    _custom?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** §0. What a write carries, keyed by `Column.key`; `_custom` on platform sources. */
+type Values = Record<string, unknown> & {
+    _custom?: Record<string, unknown>;
+};
+type WhereOp = "eq" | "neq" | "lt" | "lte" | "gt" | "gte" | "contains" | "in" | "empty";
+interface WhereClause {
+    column: string;
+    op: WhereOp;
+    value?: unknown;
+}
+type Lane = "all" | "mine" | "team" | "orgs" | "shared" | "public" | "system";
+/** §4. A question of one source. Every clause must hold. */
+interface Query {
+    where?: WhereClause[];
+    search?: string;
+    sort?: {
+        column: string;
+        direction?: "asc" | "desc";
+    }[];
+    pageSize?: number;
+    /** Default: the type's "Shown to by default" knob. A custom table has one lane: what row security shows. */
+    lane?: Lane;
+    /** A filter, never a lock. Default "all". */
+    org?: Uuid | "all";
+}
+/** §4. One page; `cursor` is null on the last one. */
+interface Page {
+    rows: Row[];
+    total: number | null;
+    cursor: string | null;
+}
+interface DataSource {
+    alias: string;
+    label: string;
+    kind: "table" | "entity";
+    canCreate: boolean;
+    canUpdate: boolean;
+}
+/** The one event stream a source has: these ids moved — re-read only them. `null`: cannot tell which. */
+interface RowsEvent {
+    ids: Uuid[] | null;
+    /** The table's columns moved (one added, retired or changed): re-read `columns()` too. */
+    shape?: true;
+}
+type DataPortEventName = `rows:${string}`;
+/** §4. The host's data port, scoped to ONE mounted Applet's aliases. Every call answers, never throws. */
+interface DataPort {
+    sources(): Promise<RecordsResult<DataSource[]>>;
+    columns(alias: string): Promise<RecordsResult<Column[]>>;
+    list(alias: string, q: Query, cursor?: string): Promise<RecordsResult<Page>>;
+    get(alias: string, id: Uuid): Promise<RecordsResult<Row | null>>;
+    create(alias: string, values: Values): Promise<RecordsResult<Row>>;
+    update(alias: string, id: Uuid, patch: Values, baseVersion: number): Promise<RecordsResult<Row>>;
+    archive(alias: string, id: Uuid): Promise<RecordsResult<void>>;
+    restore(alias: string, id: Uuid): Promise<RecordsResult<void>>;
+}
+/**
+ * The frame's side of the §1 event stream `rows:<alias>` (the AppletHost's `host.events`). The listener
+ * stays in the frame; only the event payload `{ids, shape?}` crosses the channel.
+ */
+interface DataEvents {
+    on(event: DataPortEventName, listener: (event: RowsEvent) => void): () => void;
+}
+/**
+ * The HOST's DataPort (contracts amendment 2.2): the port plus the producer of its event streams.
+ * `subscribe` never crosses the frame/host channel — the AppletHost turns it into `rows:<alias>`.
+ */
+interface HostDataPort extends DataPort {
+    subscribe(event: DataPortEventName, listener: (event: RowsEvent) => void): () => void;
+}
+/** An alias as the Applet record declares it: one table plus its organization (an entity token is phase B). */
+interface TableAlias {
+    kind: "table";
+    tableId: Uuid;
+    organizationId: Uuid;
+    /** Shown in `sources()`; the table's own name when left out. */
+    label?: string;
+}
+/**
+ * An alias bound to one PLATFORM entity type (contacts, projects, tasks…), served by `@ai-matrx/entity-data`'s port.
+ * `organizationId` is an assumed organization FILTER for its lists, never a lock; writes carry the active organization.
+ */
+interface EntityAlias {
+    kind: "entity";
+    /** The type's token in `platform.entity_types` (`party`, `project`, `task`, …). */
+    token: string;
+    organizationId?: Uuid;
+    label?: string;
+}
+/** Every alias an Applet record can declare. A host routes each kind to the port that serves it. */
+type AnyAlias = TableAlias | EntityAlias;
+/** What the table port takes (it serves `table` aliases only). */
+type AliasBinding = TableAlias;
+
+export { type AliasBinding as A, type Column as C, type DataEvents as D, type EntityAlias as E, type HostDataPort as H, type Lane as L, type Page as P, type Query as Q, type Row as R, type TableAlias as T, type Values as V, type WhereClause as W, type AnyAlias as a, CUSTOM_ROW_TOKEN as b, type DataPort as c, type DataPortEventName as d, type DataSource as e, type EntityRef as f, type RowsEvent as g, type WhereOp as h };

package/dist/use-cases/index.d.cts

@@ -1,8 +1,8 @@
-import { U as UseCase, h as UseCaseSummary } from '../types-C2uspRtf.cjs';
-export { B as BusinessIdentity, F as FormAudience, N as NotificationChannel, P as PostalAddress, i as UseCaseDashboardQuestion, j as UseCaseDocumentTemplate, b as UseCaseField, d as UseCaseForm, e as UseCaseFormField, k as UseCaseMergeField, l as UseCaseNotificationRule, f as UseCaseNotificationTrigger, m as UseCasePipeline, n as UseCasePipelineStage, g as UseCaseProvenance, o as UseCaseRelationship, c as UseCaseRow, a as UseCaseTable } from '../types-C2uspRtf.cjs';
-export { M as MIN_ROWS_IN_PRIMARY_TABLE, R as RESOLVABLE_FIELD_TYPE_WORDS, U as UseCaseProblem, a as UseCaseVerdict, b as assertUseCase, v as validateUseCase } from '../validate-DEB_mn4Y.cjs';
-import '../record-DpB2QgAZ.cjs';
-import '../field-BanTVGK2.cjs';
+import { U as UseCase, h as UseCaseSummary } from '../types-Cs2MyE3u.cjs';
+export { B as BusinessIdentity, F as FormAudience, N as NotificationChannel, P as PostalAddress, i as UseCaseDashboardQuestion, j as UseCaseDocumentTemplate, b as UseCaseField, d as UseCaseForm, e as UseCaseFormField, k as UseCaseMergeField, l as UseCaseNotificationRule, f as UseCaseNotificationTrigger, m as UseCasePipeline, n as UseCasePipelineStage, g as UseCaseProvenance, o as UseCaseRelationship, c as UseCaseRow, a as UseCaseTable } from '../types-Cs2MyE3u.cjs';
+export { M as MIN_ROWS_IN_PRIMARY_TABLE, R as RESOLVABLE_FIELD_TYPE_WORDS, U as UseCaseProblem, a as UseCaseVerdict, b as assertUseCase, v as validateUseCase } from '../validate-CqJakTKk.cjs';
+import '../record-BQi92d4-.cjs';
+import '../field-BJBnTyJ0.cjs';
 
 /** One banned pattern, with the reason and what to do instead. */
 interface PlaceholderPattern {

package/dist/use-cases/index.d.ts

@@ -1,8 +1,8 @@
-import { U as UseCase, h as UseCaseSummary } from '../types-Dv61jStB.js';
-export { B as BusinessIdentity, F as FormAudience, N as NotificationChannel, P as PostalAddress, i as UseCaseDashboardQuestion, j as UseCaseDocumentTemplate, b as UseCaseField, d as UseCaseForm, e as UseCaseFormField, k as UseCaseMergeField, l as UseCaseNotificationRule, f as UseCaseNotificationTrigger, m as UseCasePipeline, n as UseCasePipelineStage, g as UseCaseProvenance, o as UseCaseRelationship, c as UseCaseRow, a as UseCaseTable } from '../types-Dv61jStB.js';
-export { M as MIN_ROWS_IN_PRIMARY_TABLE, R as RESOLVABLE_FIELD_TYPE_WORDS, U as UseCaseProblem, a as UseCaseVerdict, b as assertUseCase, v as validateUseCase } from '../validate-CWVToe1T.js';
-import '../record-DpB2QgAZ.js';
-import '../field-BPABOJ2Y.js';
+import { U as UseCase, h as UseCaseSummary } from '../types-DF-dxB_l.js';
+export { B as BusinessIdentity, F as FormAudience, N as NotificationChannel, P as PostalAddress, i as UseCaseDashboardQuestion, j as UseCaseDocumentTemplate, b as UseCaseField, d as UseCaseForm, e as UseCaseFormField, k as UseCaseMergeField, l as UseCaseNotificationRule, f as UseCaseNotificationTrigger, m as UseCasePipeline, n as UseCasePipelineStage, g as UseCaseProvenance, o as UseCaseRelationship, c as UseCaseRow, a as UseCaseTable } from '../types-DF-dxB_l.js';
+export { M as MIN_ROWS_IN_PRIMARY_TABLE, R as RESOLVABLE_FIELD_TYPE_WORDS, U as UseCaseProblem, a as UseCaseVerdict, b as assertUseCase, v as validateUseCase } from '../validate-BydKd-Le.js';
+import '../record-BQi92d4-.js';
+import '../field-Ti5iAxFr.js';
 
 /** One banned pattern, with the reason and what to do instead. */
 interface PlaceholderPattern {

package/dist/{validate-CWVToe1T.d.ts → validate-BydKd-Le.d.ts}

@@ -1,4 +1,4 @@
-import { U as UseCase } from './types-Dv61jStB.js';
+import { U as UseCase } from './types-DF-dxB_l.js';
 
 /**
  * Every word a `parityType` may be: the parity types, every kind the declaration door

package/dist/{validate-DEB_mn4Y.d.cts → validate-CqJakTKk.d.cts}

@@ -1,4 +1,4 @@
-import { U as UseCase } from './types-C2uspRtf.cjs';
+import { U as UseCase } from './types-Cs2MyE3u.cjs';
 
 /**
  * Every word a `parityType` may be: the parity types, every kind the declaration door