@ai-matrx/records 0.57.0 → 0.57.2

package/dist/{types-DC2tYa4w.d.cts → types-BpBSMhYq.d.cts}

@@ -3019,6 +3019,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_table_id uuid";
     readonly returns: "jsonb";
     readonly security: "definer";
+}, {
+    readonly name: "table_facts";
+    readonly args: "p_organization_id uuid";
+    readonly returns: "TABLE(table_id uuid, visibility text, mine boolean)";
+    readonly security: "definer";
 }, {
     readonly name: "table_from_example";
     readonly args: "p_organization_id uuid, p_home_id uuid, p_example jsonb";
@@ -4026,6 +4031,8 @@ interface PredictedRefusal {
     /** The message the store's own body would raise, word for word. */
     message: string;
     hint?: string;
+    /** The store's structured detail, when its refusal carries one (e.g. `{ example }`). */
+    detail?: Record<string, unknown>;
     sqlstate: string;
     /**
      * Which of the store's bodies would raise it, so a reader can go and check
@@ -4245,7 +4252,25 @@ interface RecordRead {
 /** FLD-3. A constraint attached to a Field. A Rule, never a behaviour. */
 interface FieldRule {
     kind: "min" | "max" | "length" | "pattern" | "equals_field" | "differs_from_field";
-    value: string | number;
+    /**
+     * The rule's own number or word: the least / the most for `min` / `max`, the
+     * LONGEST for `length`, the pattern for `pattern`, the other column's key for
+     * `equals_field` / `differs_from_field`. A `length` rule that only says how
+     * SHORT a value may be carries `min` and no `value`.
+     */
+    value?: string | number;
+    /**
+     * STORE-RULE-GAPS (the older grid's `patternHint`). On a `pattern` rule only:
+     * how a person writes it, e.g. `"949-555-0142"`. The store refuses an example
+     * its own pattern would refuse, and a refused value is told "Enter it like
+     * 949-555-0142." (the hint, and `detail.example`).
+     */
+    example?: string;
+    /**
+     * STORE-RULE-GAPS (the older grid's `minLength`). On a `length` rule only: the
+     * fewest characters. A blank is `required`'s question, never "too short".
+     */
+    min?: number;
     /** FLD-10. Empty means "wherever the Field applies". */
     applies_to_types?: string[];
 }
@@ -4450,6 +4475,12 @@ interface NewFieldDeclaration {
     config?: Record<string, unknown>;
     /** A text column that holds a signature (`custom.doc_sign` accepts no other). */
     format?: string;
+    /**
+     * STORE-RULE-GAPS (the older grid's `allowOther`). A choice list only: a value
+     * that is none of the choices is ADDED to the list as typed instead of
+     * refused. Stored as `config.allow_other`; absent means off.
+     */
+    allow_other?: boolean;
 }
 /**
  * Every word `custom._field_document_for` resolves for `type`: any parity type
@@ -4519,6 +4550,12 @@ interface FieldPatch {
     /** SEAT-SUITES: whether the store builds an index for this column, and a unique one. */
     promoted?: boolean;
     unique?: boolean;
+    /**
+     * STORE-RULE-GAPS. A choice list's "other values allowed" setting — see
+     * `NewFieldDeclaration.allow_other`. Refused by name on any other column; a
+     * retype that stays a list keeps it.
+     */
+    allow_other?: boolean;
     /** §D / T7: which fields a worked-out column reads. */
     depends_on?: Uuid[];
     /**
@@ -4557,6 +4594,11 @@ interface FieldPatch {
      */
     expr?: Record<string, unknown>;
 }
+/**
+ * Whether a choice column takes values that are not one of its choices
+ * (`config.allow_other`, STORE-RULE-GAPS). Off unless the column says so.
+ */
+declare function allowsOtherValues(field: Pick<Field, "type" | "config">): boolean;
 
 /**
  * Who the data belongs to. A test organization is created under this name — the
@@ -4892,4 +4934,4 @@ interface UseCaseSummary {
     rowCount: number;
 }
 
-export { type EntityToken as $, type TableProposal as A, type BusinessIdentity as B, type RecordsError as C, type PgError as D, type StaleWriteDetail as E, type FormAudience as F, type PredictedRefusal as G, ABSENCE_REASONS as H, ACTOR_VOCABULARY as I, type AbsenceReason as J, type Actor as K, COMPUTE_ON as L, CONTEXT_POLICIES as M, type NotificationChannel as N, type ComputeOn as O, type PostalAddress as P, type ContextPolicy as Q, type RecordDocument as R, type StoredRecord as S, type Timestamp as T, type UseCase as U, DECLARABLE_FIELD_KINDS as V, type WriteConflict as W, DELIVERIES as X, type DeclarableFieldKind as Y, type Delivery as Z, ENTITY_TOKENS as _, type UseCaseSummary as a, err as a$, FIELD_SENSITIVITIES as a0, FIELD_SOURCES as a1, FRESHNESS as a2, type FieldBehavior as a3, type FieldRule as a4, type FieldSensitivity as a5, type FieldSource as a6, type FieldTypeWord as a7, type ForbiddenEnvelopeWord as a8, type Freshness as a9, type RelationBinding as aA, type RelationCardinality as aB, type RelationDisplay as aC, type RelationFlavor as aD, type RetiredActorWord as aE, type RuleNodeKind as aF, type RuleUse as aG, STORAGE_MODES as aH, STORE_DOORS as aI, STORE_KNOBS as aJ, STORE_REFUSAL_CODES as aK, type StorageMode as aL, type StoreDoorName as aM, type StoreRefusalCode as aN, TABLE_DISPLAYS as aO, TABLE_ORIGINS as aP, TABLE_TYPES as aQ, type TableDisplay as aR, type TableOrigin as aS, type TableType as aT, VALUE_ALTERNATE_KEYS as aU, VALUE_ENVELOPE_KEYS as aV, type ValueAlternate as aW, type ValueAlternateKey as aX, type ValueEnvelope as aY, type ValueEnvelopeKey as aZ, type ValueSource as a_, type HiddenFieldNotice as aa, KERNEL_TABLES as ab, type KernelTableName as ac, MERGE_FIELD_MODIFIERS as ad, MERGE_FIELD_SEMANTIC_TYPES as ae, MERGE_FIELD_SOURCES as af, type MergeFieldModifier as ag, type MergeFieldSemanticType as ah, type MergeFieldSource as ai, ON_DELETE as aj, OVERRIDE_POLICIES as ak, type OnDelete as al, type OverridePolicy as am, PARITY_FIELD_TYPES as an, PER_VALUE_ACCESS_WORDS as ao, type ParityFieldType as ap, type ParityFieldTypeDescriptor as aq, type PerValueAccessWord as ar, type ProvenancePointer as as, RELATION_BINDINGS as at, RELATION_CARDINALITIES as au, RELATION_FLAVORS as av, RETIRED_ACTOR_WORDS as aw, RULE_NODE_KINDS as ax, RULE_USES as ay, type RecordsErrorCode as az, type UseCaseDashboardQuestion as b, isRecordsErr as b0, ok as b1, type UseCaseDocumentTemplate as c, type UseCaseField as d, type UseCaseForm as e, type UseCaseFormField as f, type UseCaseMergeField as g, type UseCaseNotificationRule as h, type UseCaseNotificationTrigger as i, type UseCasePipeline as j, type UseCasePipelineStage as k, type UseCaseProvenance as l, type UseCaseRelationship as m, type UseCaseRow as n, type UseCaseTable as o, type Uuid as p, type RecordsResult as q, type RecordGraphWritten as r, type RecordRead as s, type ReadRow as t, type Field as u, type NewFieldDeclaration as v, type FieldPatch as w, type RecordRevision as x, type ReadValue as y, type FieldProposal as z };
+export { ENTITY_TOKENS as $, type FieldProposal as A, type BusinessIdentity as B, type TableProposal as C, type RecordsError as D, type PgError as E, type FormAudience as F, type StaleWriteDetail as G, type PredictedRefusal as H, ABSENCE_REASONS as I, ACTOR_VOCABULARY as J, type AbsenceReason as K, type Actor as L, COMPUTE_ON as M, type NotificationChannel as N, CONTEXT_POLICIES as O, type PostalAddress as P, type ComputeOn as Q, type RecordsErrorCode as R, type StoredRecord as S, type Timestamp as T, type UseCase as U, type ContextPolicy as V, type WriteConflict as W, DECLARABLE_FIELD_KINDS as X, DELIVERIES as Y, type DeclarableFieldKind as Z, type Delivery as _, type UseCaseSummary as a, allowsOtherValues as a$, type EntityToken as a0, FIELD_SENSITIVITIES as a1, FIELD_SOURCES as a2, FRESHNESS as a3, type FieldBehavior as a4, type FieldRule as a5, type FieldSensitivity as a6, type FieldSource as a7, type FieldTypeWord as a8, type ForbiddenEnvelopeWord as a9, type RelationBinding as aA, type RelationCardinality as aB, type RelationDisplay as aC, type RelationFlavor as aD, type RetiredActorWord as aE, type RuleNodeKind as aF, type RuleUse as aG, STORAGE_MODES as aH, STORE_DOORS as aI, STORE_KNOBS as aJ, STORE_REFUSAL_CODES as aK, type StorageMode as aL, type StoreDoorName as aM, type StoreRefusalCode as aN, TABLE_DISPLAYS as aO, TABLE_ORIGINS as aP, TABLE_TYPES as aQ, type TableDisplay as aR, type TableOrigin as aS, type TableType as aT, VALUE_ALTERNATE_KEYS as aU, VALUE_ENVELOPE_KEYS as aV, type ValueAlternate as aW, type ValueAlternateKey as aX, type ValueEnvelope as aY, type ValueEnvelopeKey as aZ, type ValueSource as a_, type Freshness as aa, type HiddenFieldNotice as ab, KERNEL_TABLES as ac, type KernelTableName as ad, MERGE_FIELD_MODIFIERS as ae, MERGE_FIELD_SEMANTIC_TYPES as af, MERGE_FIELD_SOURCES as ag, type MergeFieldModifier as ah, type MergeFieldSemanticType as ai, type MergeFieldSource as aj, ON_DELETE as ak, OVERRIDE_POLICIES as al, type OnDelete as am, type OverridePolicy as an, PARITY_FIELD_TYPES as ao, PER_VALUE_ACCESS_WORDS as ap, type ParityFieldType as aq, type ParityFieldTypeDescriptor as ar, type PerValueAccessWord as as, type ProvenancePointer as at, RELATION_BINDINGS as au, RELATION_CARDINALITIES as av, RELATION_FLAVORS as aw, RETIRED_ACTOR_WORDS as ax, RULE_NODE_KINDS as ay, RULE_USES as az, type UseCaseDashboardQuestion as b, err as b0, isRecordsErr as b1, ok as b2, type UseCaseDocumentTemplate as c, type UseCaseField as d, type UseCaseForm as e, type UseCaseFormField as f, type UseCaseMergeField as g, type UseCaseNotificationRule as h, type UseCaseNotificationTrigger as i, type UseCasePipeline as j, type UseCasePipelineStage as k, type UseCaseProvenance as l, type UseCaseRelationship as m, type UseCaseRow as n, type UseCaseTable as o, type Uuid as p, type RecordDocument as q, type RecordsResult as r, type RecordGraphWritten as s, type RecordRead as t, type ReadRow as u, type Field as v, type NewFieldDeclaration as w, type FieldPatch as x, type RecordRevision as y, type ReadValue as z };

package/dist/{types-DC2tYa4w.d.ts → types-BpBSMhYq.d.ts}

@@ -3019,6 +3019,11 @@ declare const STORE_DOORS: readonly [{
     readonly args: "p_organization_id uuid, p_table_id uuid";
     readonly returns: "jsonb";
     readonly security: "definer";
+}, {
+    readonly name: "table_facts";
+    readonly args: "p_organization_id uuid";
+    readonly returns: "TABLE(table_id uuid, visibility text, mine boolean)";
+    readonly security: "definer";
 }, {
     readonly name: "table_from_example";
     readonly args: "p_organization_id uuid, p_home_id uuid, p_example jsonb";
@@ -4026,6 +4031,8 @@ interface PredictedRefusal {
     /** The message the store's own body would raise, word for word. */
     message: string;
     hint?: string;
+    /** The store's structured detail, when its refusal carries one (e.g. `{ example }`). */
+    detail?: Record<string, unknown>;
     sqlstate: string;
     /**
      * Which of the store's bodies would raise it, so a reader can go and check
@@ -4245,7 +4252,25 @@ interface RecordRead {
 /** FLD-3. A constraint attached to a Field. A Rule, never a behaviour. */
 interface FieldRule {
     kind: "min" | "max" | "length" | "pattern" | "equals_field" | "differs_from_field";
-    value: string | number;
+    /**
+     * The rule's own number or word: the least / the most for `min` / `max`, the
+     * LONGEST for `length`, the pattern for `pattern`, the other column's key for
+     * `equals_field` / `differs_from_field`. A `length` rule that only says how
+     * SHORT a value may be carries `min` and no `value`.
+     */
+    value?: string | number;
+    /**
+     * STORE-RULE-GAPS (the older grid's `patternHint`). On a `pattern` rule only:
+     * how a person writes it, e.g. `"949-555-0142"`. The store refuses an example
+     * its own pattern would refuse, and a refused value is told "Enter it like
+     * 949-555-0142." (the hint, and `detail.example`).
+     */
+    example?: string;
+    /**
+     * STORE-RULE-GAPS (the older grid's `minLength`). On a `length` rule only: the
+     * fewest characters. A blank is `required`'s question, never "too short".
+     */
+    min?: number;
     /** FLD-10. Empty means "wherever the Field applies". */
     applies_to_types?: string[];
 }
@@ -4450,6 +4475,12 @@ interface NewFieldDeclaration {
     config?: Record<string, unknown>;
     /** A text column that holds a signature (`custom.doc_sign` accepts no other). */
     format?: string;
+    /**
+     * STORE-RULE-GAPS (the older grid's `allowOther`). A choice list only: a value
+     * that is none of the choices is ADDED to the list as typed instead of
+     * refused. Stored as `config.allow_other`; absent means off.
+     */
+    allow_other?: boolean;
 }
 /**
  * Every word `custom._field_document_for` resolves for `type`: any parity type
@@ -4519,6 +4550,12 @@ interface FieldPatch {
     /** SEAT-SUITES: whether the store builds an index for this column, and a unique one. */
     promoted?: boolean;
     unique?: boolean;
+    /**
+     * STORE-RULE-GAPS. A choice list's "other values allowed" setting — see
+     * `NewFieldDeclaration.allow_other`. Refused by name on any other column; a
+     * retype that stays a list keeps it.
+     */
+    allow_other?: boolean;
     /** §D / T7: which fields a worked-out column reads. */
     depends_on?: Uuid[];
     /**
@@ -4557,6 +4594,11 @@ interface FieldPatch {
      */
     expr?: Record<string, unknown>;
 }
+/**
+ * Whether a choice column takes values that are not one of its choices
+ * (`config.allow_other`, STORE-RULE-GAPS). Off unless the column says so.
+ */
+declare function allowsOtherValues(field: Pick<Field, "type" | "config">): boolean;
 
 /**
  * Who the data belongs to. A test organization is created under this name — the
@@ -4892,4 +4934,4 @@ interface UseCaseSummary {
     rowCount: number;
 }
 
-export { type EntityToken as $, type TableProposal as A, type BusinessIdentity as B, type RecordsError as C, type PgError as D, type StaleWriteDetail as E, type FormAudience as F, type PredictedRefusal as G, ABSENCE_REASONS as H, ACTOR_VOCABULARY as I, type AbsenceReason as J, type Actor as K, COMPUTE_ON as L, CONTEXT_POLICIES as M, type NotificationChannel as N, type ComputeOn as O, type PostalAddress as P, type ContextPolicy as Q, type RecordDocument as R, type StoredRecord as S, type Timestamp as T, type UseCase as U, DECLARABLE_FIELD_KINDS as V, type WriteConflict as W, DELIVERIES as X, type DeclarableFieldKind as Y, type Delivery as Z, ENTITY_TOKENS as _, type UseCaseSummary as a, err as a$, FIELD_SENSITIVITIES as a0, FIELD_SOURCES as a1, FRESHNESS as a2, type FieldBehavior as a3, type FieldRule as a4, type FieldSensitivity as a5, type FieldSource as a6, type FieldTypeWord as a7, type ForbiddenEnvelopeWord as a8, type Freshness as a9, type RelationBinding as aA, type RelationCardinality as aB, type RelationDisplay as aC, type RelationFlavor as aD, type RetiredActorWord as aE, type RuleNodeKind as aF, type RuleUse as aG, STORAGE_MODES as aH, STORE_DOORS as aI, STORE_KNOBS as aJ, STORE_REFUSAL_CODES as aK, type StorageMode as aL, type StoreDoorName as aM, type StoreRefusalCode as aN, TABLE_DISPLAYS as aO, TABLE_ORIGINS as aP, TABLE_TYPES as aQ, type TableDisplay as aR, type TableOrigin as aS, type TableType as aT, VALUE_ALTERNATE_KEYS as aU, VALUE_ENVELOPE_KEYS as aV, type ValueAlternate as aW, type ValueAlternateKey as aX, type ValueEnvelope as aY, type ValueEnvelopeKey as aZ, type ValueSource as a_, type HiddenFieldNotice as aa, KERNEL_TABLES as ab, type KernelTableName as ac, MERGE_FIELD_MODIFIERS as ad, MERGE_FIELD_SEMANTIC_TYPES as ae, MERGE_FIELD_SOURCES as af, type MergeFieldModifier as ag, type MergeFieldSemanticType as ah, type MergeFieldSource as ai, ON_DELETE as aj, OVERRIDE_POLICIES as ak, type OnDelete as al, type OverridePolicy as am, PARITY_FIELD_TYPES as an, PER_VALUE_ACCESS_WORDS as ao, type ParityFieldType as ap, type ParityFieldTypeDescriptor as aq, type PerValueAccessWord as ar, type ProvenancePointer as as, RELATION_BINDINGS as at, RELATION_CARDINALITIES as au, RELATION_FLAVORS as av, RETIRED_ACTOR_WORDS as aw, RULE_NODE_KINDS as ax, RULE_USES as ay, type RecordsErrorCode as az, type UseCaseDashboardQuestion as b, isRecordsErr as b0, ok as b1, type UseCaseDocumentTemplate as c, type UseCaseField as d, type UseCaseForm as e, type UseCaseFormField as f, type UseCaseMergeField as g, type UseCaseNotificationRule as h, type UseCaseNotificationTrigger as i, type UseCasePipeline as j, type UseCasePipelineStage as k, type UseCaseProvenance as l, type UseCaseRelationship as m, type UseCaseRow as n, type UseCaseTable as o, type Uuid as p, type RecordsResult as q, type RecordGraphWritten as r, type RecordRead as s, type ReadRow as t, type Field as u, type NewFieldDeclaration as v, type FieldPatch as w, type RecordRevision as x, type ReadValue as y, type FieldProposal as z };
+export { ENTITY_TOKENS as $, type FieldProposal as A, type BusinessIdentity as B, type TableProposal as C, type RecordsError as D, type PgError as E, type FormAudience as F, type StaleWriteDetail as G, type PredictedRefusal as H, ABSENCE_REASONS as I, ACTOR_VOCABULARY as J, type AbsenceReason as K, type Actor as L, COMPUTE_ON as M, type NotificationChannel as N, CONTEXT_POLICIES as O, type PostalAddress as P, type ComputeOn as Q, type RecordsErrorCode as R, type StoredRecord as S, type Timestamp as T, type UseCase as U, type ContextPolicy as V, type WriteConflict as W, DECLARABLE_FIELD_KINDS as X, DELIVERIES as Y, type DeclarableFieldKind as Z, type Delivery as _, type UseCaseSummary as a, allowsOtherValues as a$, type EntityToken as a0, FIELD_SENSITIVITIES as a1, FIELD_SOURCES as a2, FRESHNESS as a3, type FieldBehavior as a4, type FieldRule as a5, type FieldSensitivity as a6, type FieldSource as a7, type FieldTypeWord as a8, type ForbiddenEnvelopeWord as a9, type RelationBinding as aA, type RelationCardinality as aB, type RelationDisplay as aC, type RelationFlavor as aD, type RetiredActorWord as aE, type RuleNodeKind as aF, type RuleUse as aG, STORAGE_MODES as aH, STORE_DOORS as aI, STORE_KNOBS as aJ, STORE_REFUSAL_CODES as aK, type StorageMode as aL, type StoreDoorName as aM, type StoreRefusalCode as aN, TABLE_DISPLAYS as aO, TABLE_ORIGINS as aP, TABLE_TYPES as aQ, type TableDisplay as aR, type TableOrigin as aS, type TableType as aT, VALUE_ALTERNATE_KEYS as aU, VALUE_ENVELOPE_KEYS as aV, type ValueAlternate as aW, type ValueAlternateKey as aX, type ValueEnvelope as aY, type ValueEnvelopeKey as aZ, type ValueSource as a_, type Freshness as aa, type HiddenFieldNotice as ab, KERNEL_TABLES as ac, type KernelTableName as ad, MERGE_FIELD_MODIFIERS as ae, MERGE_FIELD_SEMANTIC_TYPES as af, MERGE_FIELD_SOURCES as ag, type MergeFieldModifier as ah, type MergeFieldSemanticType as ai, type MergeFieldSource as aj, ON_DELETE as ak, OVERRIDE_POLICIES as al, type OnDelete as am, type OverridePolicy as an, PARITY_FIELD_TYPES as ao, PER_VALUE_ACCESS_WORDS as ap, type ParityFieldType as aq, type ParityFieldTypeDescriptor as ar, type PerValueAccessWord as as, type ProvenancePointer as at, RELATION_BINDINGS as au, RELATION_CARDINALITIES as av, RELATION_FLAVORS as aw, RETIRED_ACTOR_WORDS as ax, RULE_NODE_KINDS as ay, RULE_USES as az, type UseCaseDashboardQuestion as b, err as b0, isRecordsErr as b1, ok as b2, type UseCaseDocumentTemplate as c, type UseCaseField as d, type UseCaseForm as e, type UseCaseFormField as f, type UseCaseMergeField as g, type UseCaseNotificationRule as h, type UseCaseNotificationTrigger as i, type UseCasePipeline as j, type UseCasePipelineStage as k, type UseCaseProvenance as l, type UseCaseRelationship as m, type UseCaseRow as n, type UseCaseTable as o, type Uuid as p, type RecordDocument as q, type RecordsResult as r, type RecordGraphWritten as s, type RecordRead as t, type ReadRow as u, type Field as v, type NewFieldDeclaration as w, type FieldPatch as x, type RecordRevision as y, type ReadValue as z };