@ai-matrx/records 0.97.4 → 0.97.6

package/dist/{declareTable-B6ps9KX8.d.cts → declareTable-BE423RBb.d.cts}

@@ -1,4 +1,4 @@
-import { R as RecordsClient } from './client-BSe721CI.cjs';
+import { R as RecordsClient } from './client-ijtYioVl.cjs';
 import { a as FieldTypeWord, N as NewFieldDeclaration } from './field-CSNfZsJ3.cjs';
 import { U as Uuid, a as RecordsError } from './record-fC6s1Xc8.cjs';
 import { F as FieldDrift } from './table-kind-CzaNpjv1.cjs';

package/dist/{declareTable-C_ZguQb4.d.ts → declareTable-W3aD-9fQ.d.ts}

@@ -1,4 +1,4 @@
-import { R as RecordsClient } from './client-C6_v0Jnq.js';
+import { R as RecordsClient } from './client-B1PjSTav.js';
 import { a as FieldTypeWord, N as NewFieldDeclaration } from './field-Do135FdJ.js';
 import { U as Uuid, a as RecordsError } from './record-fC6s1Xc8.js';
 import { F as FieldDrift } from './table-kind-DT5EYraJ.js';

package/dist/{doors-DEvCdeYB.d.cts → doors-Bopr9YVf.d.cts}

@@ -191,9 +191,41 @@ interface ScopePage {
     total: number;
     next_offset: number | null;
 }
-/** A System Context item (`context.system_context_item`), as `custom.context_system_items` answers it. */
-interface SystemContextItem {
-    [key: string]: unknown;
+/**
+ * The pseudo scope-type id a System Context field carries. System Context (what is simply TRUE on the
+ * platform) has no scope type; its fields share this sentinel so a holder can keep them beside a
+ * type's fields. A client-side key only — a binding to one of these carries `scope_type_id: null`.
+ */
+declare const SYSTEM_CONTEXT_TYPE_ID = "__system__";
+/** What a System Context item is: a curated fact, an ambient fact of the moment, or a dataset. */
+type SystemContextItemClass = "curated" | "ambient" | "dataset" | (string & {});
+/**
+ * A System Context item (`custom.context_system_items`), as a `ContextField` of the
+ * `SYSTEM_CONTEXT_TYPE_ID` pseudo-type, plus its class.
+ */
+interface SystemContextField extends ContextField {
+    item_class: SystemContextItemClass | null;
+}
+/** One column of a table template. */
+interface TableTemplateField {
+    field_name: string;
+    display_name: string;
+    data_type: string;
+    field_order: number;
+    is_required: boolean;
+}
+/**
+ * A table template (a `custom.template` of kind `table`) a scope's dataset field may lock its
+ * table's columns to: the organization's own or a platform one, as `custom.table_templates` answers it.
+ */
+interface TableTemplate {
+    id: Uuid;
+    organization_id: Uuid | null;
+    name: string;
+    description: string;
+    version: number;
+    is_platform: boolean;
+    fields: TableTemplateField[];
 }
 /** One scope template of the gallery, as `custom.context_templates` answers it. */
 interface ScopeTemplate {
@@ -380,6 +412,19 @@ declare const FILE_KERNEL_ID = "11111111-0000-4000-8000-000000000006";
 /** What a Field holds, as a person thinks of it. */
 declare function contextFieldKind(doc: Pick<StoreFieldDoc, "type" | "multi" | "format" | "display_format" | "config" | "relation_target">, carried?: StoreCarried | null): ContextFieldKind;
 declare function contextFieldFromStore(row: StoreItemRow): ContextField;
+/** A System Context item, as `custom.context_system_items` answers it (the door's own words). */
+interface StoreSystemItemRow {
+    id?: string | null;
+    key?: string | null;
+    display_name?: string | null;
+    description?: string | null;
+    item_class?: string | null;
+    value_type?: string | null;
+    sensitivity?: string | null;
+    sort_order?: number | null;
+}
+/** A System Context item as a field of the `SYSTEM_CONTEXT_TYPE_ID` pseudo-type, with its class. */
+declare function systemContextFieldFromStore(row: StoreSystemItemRow, index: number): SystemContextField;
 /** A reference / document cell's targets, with the names and files the door gave this caller. */
 declare function referencesOf(row: Pick<StoreValueRow, "value" | "field" | "labels" | "files">): ContextReference[];
 /** One cell, as a `ContextValue` (its whole text not yet read — see `completeWholeValues`). */
@@ -448,7 +493,9 @@ interface ScopeDoors {
     /** Of these scope ids, the ones that are ARCHIVED scopes of this type. */
     archivedScopesOfType(organizationId: Uuid, scopeTypeId: Uuid, wanted: ReadonlySet<Uuid>): Promise<RecordsResult<ArchivedScope[]>>;
     /** The System Context items (not scopes: the platform's own ambient context). */
-    systemItems(): Promise<RecordsResult<SystemContextItem[]>>;
+    systemItems(): Promise<RecordsResult<SystemContextField[]>>;
+    /** The table templates an organization's scope dataset fields may use (its own and the platform's). */
+    tableTemplates(organizationId: Uuid): Promise<RecordsResult<TableTemplate[]>>;
     /** The scope templates of the gallery. */
     templates(): Promise<RecordsResult<ScopeTemplate[]>>;
     /** A new scope type in `organizationId`. */
@@ -486,4 +533,4 @@ interface ScopeDoors {
 }
 declare function createScopeDoors(call: ScopeDoorCall): ScopeDoors;
 
-export { ARCHIVED_SCOPES_PAGE as A, type StoreWholeValue as B, type ContextValue as C, type SystemContextItem as D, completeWholeValues as E, FILE_KERNEL_ID as F, contextFieldFromStore as G, contextFieldKind as H, INCOMPLETE_SAVE_REFUSAL as I, contextValueFromStore as J, createScopeDoors as K, incompleteSaveRefusal as L, referenceFence as M, referencesOf as N, scopeFromStore as O, scopeTypeFromStore as P, scopeWithTypeFromStore as Q, type ReadContextFileText as R, type Scope as S, TYPE_SCOPES_PAGE as T, settingFromStore as U, type ContextField as a, type ContextFieldKind as b, type ContextReference as c, type ArchivedScope as d, type ArchivedScopeType as e, CONTEXT_FIELD_KINDS as f, type ContextFieldSpec as g, type ContextPolicy as h, type ContextSensitivity as i, type ContextValueWrite as j, type ContextValueWritten as k, type IncompleteValue as l, SCOPES_PER_CALL as m, SCOPES_PER_VALUES_CALL as n, SCOPE_TYPES_PER_FIELDS_CALL as o, type ScopeDoorCall as p, type ScopeDoors as q, type ScopePage as r, type ScopeSpec as s, type ScopeTemplate as t, type ScopeType as u, type ScopeTypeLabel as v, type ScopeTypeSkeleton as w, type ScopeTypeSpec as x, type ScopeTypeWithScopes as y, type ScopeWithType as z };
+export { ARCHIVED_SCOPES_PAGE as A, type ScopeWithType as B, type ContextValue as C, type StoreSystemItemRow as D, type StoreWholeValue as E, FILE_KERNEL_ID as F, type SystemContextField as G, type SystemContextItemClass as H, INCOMPLETE_SAVE_REFUSAL as I, type TableTemplate as J, type TableTemplateField as K, completeWholeValues as L, contextFieldFromStore as M, contextFieldKind as N, contextValueFromStore as O, createScopeDoors as P, incompleteSaveRefusal as Q, type ReadContextFileText as R, type Scope as S, TYPE_SCOPES_PAGE as T, referenceFence as U, referencesOf as V, scopeFromStore as W, scopeTypeFromStore as X, scopeWithTypeFromStore as Y, settingFromStore as Z, systemContextFieldFromStore as _, type ContextField as a, type ContextFieldKind as b, type ContextReference as c, type ArchivedScope as d, type ArchivedScopeType as e, CONTEXT_FIELD_KINDS as f, type ContextFieldSpec as g, type ContextPolicy as h, type ContextSensitivity as i, type ContextValueWrite as j, type ContextValueWritten as k, type IncompleteValue as l, SCOPES_PER_CALL as m, SCOPES_PER_VALUES_CALL as n, SCOPE_TYPES_PER_FIELDS_CALL as o, SYSTEM_CONTEXT_TYPE_ID as p, type ScopeDoorCall as q, type ScopeDoors as r, type ScopePage as s, type ScopeSpec as t, type ScopeTemplate as u, type ScopeType as v, type ScopeTypeLabel as w, type ScopeTypeSkeleton as x, type ScopeTypeSpec as y, type ScopeTypeWithScopes as z };

package/dist/{doors-DnHM_tkC.d.ts → doors-DfHUqP7j.d.ts}

@@ -191,9 +191,41 @@ interface ScopePage {
     total: number;
     next_offset: number | null;
 }
-/** A System Context item (`context.system_context_item`), as `custom.context_system_items` answers it. */
-interface SystemContextItem {
-    [key: string]: unknown;
+/**
+ * The pseudo scope-type id a System Context field carries. System Context (what is simply TRUE on the
+ * platform) has no scope type; its fields share this sentinel so a holder can keep them beside a
+ * type's fields. A client-side key only — a binding to one of these carries `scope_type_id: null`.
+ */
+declare const SYSTEM_CONTEXT_TYPE_ID = "__system__";
+/** What a System Context item is: a curated fact, an ambient fact of the moment, or a dataset. */
+type SystemContextItemClass = "curated" | "ambient" | "dataset" | (string & {});
+/**
+ * A System Context item (`custom.context_system_items`), as a `ContextField` of the
+ * `SYSTEM_CONTEXT_TYPE_ID` pseudo-type, plus its class.
+ */
+interface SystemContextField extends ContextField {
+    item_class: SystemContextItemClass | null;
+}
+/** One column of a table template. */
+interface TableTemplateField {
+    field_name: string;
+    display_name: string;
+    data_type: string;
+    field_order: number;
+    is_required: boolean;
+}
+/**
+ * A table template (a `custom.template` of kind `table`) a scope's dataset field may lock its
+ * table's columns to: the organization's own or a platform one, as `custom.table_templates` answers it.
+ */
+interface TableTemplate {
+    id: Uuid;
+    organization_id: Uuid | null;
+    name: string;
+    description: string;
+    version: number;
+    is_platform: boolean;
+    fields: TableTemplateField[];
 }
 /** One scope template of the gallery, as `custom.context_templates` answers it. */
 interface ScopeTemplate {
@@ -380,6 +412,19 @@ declare const FILE_KERNEL_ID = "11111111-0000-4000-8000-000000000006";
 /** What a Field holds, as a person thinks of it. */
 declare function contextFieldKind(doc: Pick<StoreFieldDoc, "type" | "multi" | "format" | "display_format" | "config" | "relation_target">, carried?: StoreCarried | null): ContextFieldKind;
 declare function contextFieldFromStore(row: StoreItemRow): ContextField;
+/** A System Context item, as `custom.context_system_items` answers it (the door's own words). */
+interface StoreSystemItemRow {
+    id?: string | null;
+    key?: string | null;
+    display_name?: string | null;
+    description?: string | null;
+    item_class?: string | null;
+    value_type?: string | null;
+    sensitivity?: string | null;
+    sort_order?: number | null;
+}
+/** A System Context item as a field of the `SYSTEM_CONTEXT_TYPE_ID` pseudo-type, with its class. */
+declare function systemContextFieldFromStore(row: StoreSystemItemRow, index: number): SystemContextField;
 /** A reference / document cell's targets, with the names and files the door gave this caller. */
 declare function referencesOf(row: Pick<StoreValueRow, "value" | "field" | "labels" | "files">): ContextReference[];
 /** One cell, as a `ContextValue` (its whole text not yet read — see `completeWholeValues`). */
@@ -448,7 +493,9 @@ interface ScopeDoors {
     /** Of these scope ids, the ones that are ARCHIVED scopes of this type. */
     archivedScopesOfType(organizationId: Uuid, scopeTypeId: Uuid, wanted: ReadonlySet<Uuid>): Promise<RecordsResult<ArchivedScope[]>>;
     /** The System Context items (not scopes: the platform's own ambient context). */
-    systemItems(): Promise<RecordsResult<SystemContextItem[]>>;
+    systemItems(): Promise<RecordsResult<SystemContextField[]>>;
+    /** The table templates an organization's scope dataset fields may use (its own and the platform's). */
+    tableTemplates(organizationId: Uuid): Promise<RecordsResult<TableTemplate[]>>;
     /** The scope templates of the gallery. */
     templates(): Promise<RecordsResult<ScopeTemplate[]>>;
     /** A new scope type in `organizationId`. */
@@ -486,4 +533,4 @@ interface ScopeDoors {
 }
 declare function createScopeDoors(call: ScopeDoorCall): ScopeDoors;
 
-export { ARCHIVED_SCOPES_PAGE as A, type StoreWholeValue as B, type ContextValue as C, type SystemContextItem as D, completeWholeValues as E, FILE_KERNEL_ID as F, contextFieldFromStore as G, contextFieldKind as H, INCOMPLETE_SAVE_REFUSAL as I, contextValueFromStore as J, createScopeDoors as K, incompleteSaveRefusal as L, referenceFence as M, referencesOf as N, scopeFromStore as O, scopeTypeFromStore as P, scopeWithTypeFromStore as Q, type ReadContextFileText as R, type Scope as S, TYPE_SCOPES_PAGE as T, settingFromStore as U, type ContextField as a, type ContextFieldKind as b, type ContextReference as c, type ArchivedScope as d, type ArchivedScopeType as e, CONTEXT_FIELD_KINDS as f, type ContextFieldSpec as g, type ContextPolicy as h, type ContextSensitivity as i, type ContextValueWrite as j, type ContextValueWritten as k, type IncompleteValue as l, SCOPES_PER_CALL as m, SCOPES_PER_VALUES_CALL as n, SCOPE_TYPES_PER_FIELDS_CALL as o, type ScopeDoorCall as p, type ScopeDoors as q, type ScopePage as r, type ScopeSpec as s, type ScopeTemplate as t, type ScopeType as u, type ScopeTypeLabel as v, type ScopeTypeSkeleton as w, type ScopeTypeSpec as x, type ScopeTypeWithScopes as y, type ScopeWithType as z };
+export { ARCHIVED_SCOPES_PAGE as A, type ScopeWithType as B, type ContextValue as C, type StoreSystemItemRow as D, type StoreWholeValue as E, FILE_KERNEL_ID as F, type SystemContextField as G, type SystemContextItemClass as H, INCOMPLETE_SAVE_REFUSAL as I, type TableTemplate as J, type TableTemplateField as K, completeWholeValues as L, contextFieldFromStore as M, contextFieldKind as N, contextValueFromStore as O, createScopeDoors as P, incompleteSaveRefusal as Q, type ReadContextFileText as R, type Scope as S, TYPE_SCOPES_PAGE as T, referenceFence as U, referencesOf as V, scopeFromStore as W, scopeTypeFromStore as X, scopeWithTypeFromStore as Y, settingFromStore as Z, systemContextFieldFromStore as _, type ContextField as a, type ContextFieldKind as b, type ContextReference as c, type ArchivedScope as d, type ArchivedScopeType as e, CONTEXT_FIELD_KINDS as f, type ContextFieldSpec as g, type ContextPolicy as h, type ContextSensitivity as i, type ContextValueWrite as j, type ContextValueWritten as k, type IncompleteValue as l, SCOPES_PER_CALL as m, SCOPES_PER_VALUES_CALL as n, SCOPE_TYPES_PER_FIELDS_CALL as o, SYSTEM_CONTEXT_TYPE_ID as p, type ScopeDoorCall as q, type ScopeDoors as r, type ScopePage as s, type ScopeSpec as t, type ScopeTemplate as u, type ScopeType as v, type ScopeTypeLabel as w, type ScopeTypeSkeleton as x, type ScopeTypeSpec as y, type ScopeTypeWithScopes as z };

package/dist/questions/index.d.cts

@@ -1,12 +1,12 @@
 import { A as AggregateBucket } from '../subscription-D5IcSqMw.cjs';
-import { R as RecordsClient } from '../client-BSe721CI.cjs';
+import { R as RecordsClient } from '../client-ijtYioVl.cjs';
 import { F as Field } from '../field-CSNfZsJ3.cjs';
 import { H as HiddenFieldNotice, U as Uuid, R as RecordsResult } from '../record-fC6s1Xc8.cjs';
 import { R as RuleExpression } from '../rule-DE3biaSw.cjs';
 import '../table-kind-CzaNpjv1.cjs';
 import '../ports-DBxW-a61.cjs';
 import '../relation-C5H3GUUP.cjs';
-import '../doors-DEvCdeYB.cjs';
+import '../doors-Bopr9YVf.cjs';
 import '../portal-ByiRZGqc.cjs';
 
 type QuestionOp = "count" | "sum" | "avg" | "min" | "max";

package/dist/questions/index.d.ts

@@ -1,12 +1,12 @@
 import { A as AggregateBucket } from '../subscription-Cu6aMX6f.js';
-import { R as RecordsClient } from '../client-C6_v0Jnq.js';
+import { R as RecordsClient } from '../client-B1PjSTav.js';
 import { F as Field } from '../field-Do135FdJ.js';
 import { H as HiddenFieldNotice, U as Uuid, R as RecordsResult } from '../record-fC6s1Xc8.js';
 import { R as RuleExpression } from '../rule-Bn3E-ZLl.js';
 import '../table-kind-DT5EYraJ.js';
 import '../ports-DCX-WDVh.js';
 import '../relation-yYaW32bf.js';
-import '../doors-DnHM_tkC.js';
+import '../doors-DfHUqP7j.js';
 import '../portal-B_H6TEj2.js';
 
 type QuestionOp = "count" | "sum" | "avg" | "min" | "max";

package/dist/react/index.cjs

@@ -880,6 +880,9 @@ function rememberedOpCount() {
   return defaultOpLedger.size;
 }
 
+// src/scopes/types.ts
+var SYSTEM_CONTEXT_TYPE_ID = "__system__";
+
 // src/scopes/codec.ts
 var str = (v, fallback = "") => typeof v === "string" ? v : fallback;
 var strOrNull = (v) => typeof v === "string" ? v : null;
@@ -1051,6 +1054,51 @@ var SENSITIVITY_TO_DOOR = {
   confidential: "restricted",
   restricted: "privileged"
 };
+var SENSITIVITY_FROM_DOOR = {
+  public: "public",
+  internal: "internal",
+  restricted: "confidential",
+  privileged: "restricted"
+};
+function systemContextFieldFromStore(row, index) {
+  const key = str(row.key);
+  const kind = str(row.value_type, "string");
+  return {
+    id: str(row.id),
+    scope_type_id: SYSTEM_CONTEXT_TYPE_ID,
+    organization_id: "",
+    key,
+    label: str(row.display_name, key),
+    description: str(row.description),
+    kind: KINDS.has(kind) ? kind : "string",
+    type: "system",
+    multi: kind === "array",
+    format: null,
+    config: {},
+    relation_target: null,
+    sort: typeof row.sort_order === "number" ? row.sort_order : index,
+    context_policy: "include",
+    // The system table keeps the old sensitivity words (`restricted`/`privileged`), like the write doors.
+    sensitivity: SENSITIVITY_FROM_DOOR[str(row.sensitivity)] ?? "public",
+    source: "system",
+    status: "active",
+    status_note: null,
+    category: null,
+    tags: [],
+    max_items: 0,
+    custom_component: null,
+    reference_source: null,
+    allowed_scope_type_ids: null,
+    allowed_reference_types: null,
+    review_interval_days: null,
+    depends_on: [],
+    version: 0,
+    created_by: null,
+    created_at: "",
+    updated_at: "",
+    item_class: strOrNull(row.item_class)
+  };
+}
 var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function referencesOf(row) {
   const v = row.value;
@@ -1385,7 +1433,11 @@ function createScopeDoors(call) {
     },
     async systemItems() {
       const res = await call("context_system_items", {}, "scopes.systemItems");
-      return res.ok ? { ok: true, data: res.data ?? [] } : res;
+      return res.ok ? { ok: true, data: (res.data ?? []).map(systemContextFieldFromStore) } : res;
+    },
+    async tableTemplates(organizationId) {
+      const res = await call("table_templates", { p_org_id: organizationId }, "scopes.tableTemplates");
+      return res.ok ? { ok: true, data: Array.isArray(res.data) ? res.data : [] } : res;
     },
     async templates() {
       const res = await call("context_templates", {}, "scopes.templates");