@robosystems/client 0.5.3 → 0.5.5

package/types.gen.ts

@@ -951,6 +951,88 @@ export type ChangeTierOp = {
     new_tier: 'ladybug-standard' | 'ladybug-large' | 'ladybug-xlarge';
 };
 
+/**
+ * ChartLite
+ *
+ * Server-shaped chart projection — panel/series CONFIG, never values.
+ *
+ * The second real server-computed View arm (after ``rendering``). Values
+ * come from ``rendering.rows`` joined by ``element_id``; the x-axis is
+ * ``rendering.periods``. Renderers (report-components) turn one panel
+ * into one chart.
+ */
+export type ChartLite = {
+    /**
+     * Panels
+     */
+    panels?: Array<ChartPanelLite>;
+};
+
+/**
+ * ChartPanelLite
+ *
+ * One chart panel — series sharing a y-axis format family.
+ *
+ * Mixed-unit catalogs are unplottable on one axis, so the server groups
+ * rows into panels by ``item_type`` family (NULL falls back to
+ * ``is_monetary``). The x-axis is always ``rendering.periods``.
+ */
+export type ChartPanelLite = {
+    /**
+     * Label
+     *
+     * Panel heading — e.g. 'Monetary', 'Ratios'.
+     */
+    label?: string | null;
+    /**
+     * Item Type
+     *
+     * Format family shared by the panel's series (monetary | ratio | percent | multiple | days); None for the untyped fallback panel.
+     */
+    item_type?: string | null;
+    /**
+     * Kind
+     *
+     * Per-panel mark — 'line' or 'bar'.
+     */
+    kind?: string;
+    /**
+     * Series
+     */
+    series?: Array<ChartSeriesLite>;
+};
+
+/**
+ * ChartSeriesLite
+ *
+ * One plottable series in a chart panel.
+ *
+ * Carries structure and identity only — the values live in the sibling
+ * ``rendering.rows`` (join on ``element_id``), so the chart arm never
+ * duplicates the value matrix. ``key`` is the stable series identity for
+ * client state (colors, toggles); today it equals ``element_id``, and
+ * future axes (the forecast scenario) arrive as new fields on this
+ * model, never a new arm shape.
+ */
+export type ChartSeriesLite = {
+    /**
+     * Key
+     *
+     * Stable series id — element_id today.
+     */
+    key: string;
+    /**
+     * Element Id
+     */
+    element_id: string;
+    /**
+     * Label
+     *
+     * Display name for legends.
+     */
+    label: string;
+};
+
 /**
  * CheckoutResponse
  *
@@ -1148,6 +1230,135 @@ export type ClosePeriodResponse = {
     evaluated_structure_ids?: Array<string>;
 };
 
+/**
+ * ComputeMetricsRequest
+ *
+ * Request body for the ``compute-metrics`` operation.
+ *
+ * Resolves the ``Derive`` rules scoped to the metric block, binds each
+ * rule's operands to the entity's most recent persisted report facts at
+ * ``period_end``, evaluates, and upserts the period's standing
+ * ``factset_type='metric'`` FactSet (re-running a period replaces its
+ * facts). One standing FactSet per (structure, entity, period_end) — the
+ * accumulating time series.
+ */
+export type ComputeMetricsRequest = {
+    /**
+     * Structure Id
+     *
+     * Metric block structure (block_type='metric') to compute.
+     */
+    structure_id: string;
+    /**
+     * Period End
+     *
+     * Period end to compute at. Operands bind to report facts whose period_end matches exactly (instant balances as of this date; durations ending on it).
+     */
+    period_end: string;
+    /**
+     * Period Start
+     *
+     * Optional lower bound for duration-operand binding and the standing FactSet's period_start.
+     */
+    period_start?: string | null;
+    /**
+     * Entity Id
+     *
+     * Entity to compute for. Defaults to the graph's earliest-created entity (the primary entity for single-entity graphs).
+     */
+    entity_id?: string | null;
+};
+
+/**
+ * ComputeMetricsResponse
+ *
+ * Response for the ``compute-metrics`` operation.
+ */
+export type ComputeMetricsResponse = {
+    /**
+     * Structure Id
+     */
+    structure_id: string;
+    /**
+     * Entity Id
+     */
+    entity_id: string;
+    /**
+     * Period End
+     */
+    period_end: string;
+    /**
+     * Fact Set Id
+     *
+     * Standing metric FactSet for the period — None when every metric was skipped and no prior set existed.
+     */
+    fact_set_id?: string | null;
+    /**
+     * Computed
+     */
+    computed?: Array<ComputedMetricLite>;
+    /**
+     * Skipped
+     */
+    skipped?: Array<SkippedMetricLite>;
+};
+
+/**
+ * ComputedMetricLite
+ *
+ * One metric computed by a ``compute-metrics`` run.
+ */
+export type ComputedMetricLite = {
+    /**
+     * Rule Id
+     *
+     * Derive rule that produced the value.
+     */
+    rule_id: string;
+    /**
+     * Element Id
+     *
+     * Metric element the fact was written for.
+     */
+    element_id: string;
+    /**
+     * Element Qname
+     *
+     * Metric element qname (e.g. rs-metric:CurrentRatio).
+     */
+    element_qname?: string | null;
+    /**
+     * Name
+     *
+     * Metric display name.
+     */
+    name: string;
+    /**
+     * Value
+     *
+     * Computed value.
+     */
+    value: number;
+    /**
+     * Unit
+     *
+     * Fact unit — 'USD' for monetary, 'days' for days, else 'pure'.
+     */
+    unit: string;
+    /**
+     * Period Type
+     *
+     * 'instant' or 'duration'.
+     */
+    period_type: string;
+    /**
+     * Item Type
+     *
+     * Format family from the metric element (monetary | ratio | percent | multiple | days). None means untyped; fall back to unit.
+     */
+    item_type?: string | null;
+};
+
 /**
  * ConnectionLite
  *
@@ -3598,6 +3809,12 @@ export type ElementLite = {
      * Period Type
      */
     period_type?: string | null;
+    /**
+     * Item Type
+     *
+     * Value-domain vocabulary (monetary | ratio | percent | multiple | days | string | …). None means untyped; fall back to is_monetary.
+     */
+    item_type?: string | null;
 };
 
 /**
@@ -7467,6 +7684,52 @@ export type OperationEnvelopeClosePeriodResponse = {
     idempotentReplay?: boolean;
 };
 
+/**
+ * OperationEnvelope[ComputeMetricsResponse]
+ */
+export type OperationEnvelopeComputeMetricsResponse = {
+    /**
+     * Operation
+     *
+     * Kebab-case operation name
+     */
+    operation: string;
+    /**
+     * Operationid
+     *
+     * op_-prefixed ULID for audit and SSE correlation
+     */
+    operationId: string;
+    /**
+     * Status
+     *
+     * Operation lifecycle state
+     */
+    status: 'completed' | 'pending' | 'failed';
+    /**
+     * Command-specific result payload
+     */
+    result?: ComputeMetricsResponse | null;
+    /**
+     * At
+     *
+     * ISO-8601 UTC timestamp
+     */
+    at: string;
+    /**
+     * Createdby
+     *
+     * User ID that initiated the operation (null for legacy callers)
+     */
+    createdBy?: string | null;
+    /**
+     * Idempotentreplay
+     *
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     */
+    idempotentReplay?: boolean;
+};
+
 /**
  * OperationEnvelope[DeleteInformationBlockResponse]
  */
@@ -10412,6 +10675,12 @@ export type RenderingRowLite = {
      * Balance Type
      */
     balance_type?: string | null;
+    /**
+     * Item Type
+     *
+     * Value-domain format family from the element (monetary | ratio | percent | multiple | days | …). Drives per-row value formatting; None falls back to is_monetary on the element.
+     */
+    item_type?: string | null;
     /**
      * Values
      */
@@ -11831,6 +12100,42 @@ export type ShareResultItem = {
     fact_count?: number;
 };
 
+/**
+ * SkippedMetricLite
+ *
+ * One metric a ``compute-metrics`` run could not compute.
+ *
+ * Soft-fail by design: a missing operand fact (e.g. InterestExpense for a
+ * debt-free entity) or an undefined ratio (division by zero) skips the
+ * metric with a reason — it never errors the run.
+ */
+export type SkippedMetricLite = {
+    /**
+     * Rule Id
+     *
+     * Derive rule that was skipped.
+     */
+    rule_id: string;
+    /**
+     * Element Qname
+     *
+     * Metric element qname the rule targets.
+     */
+    element_qname?: string | null;
+    /**
+     * Reason
+     *
+     * Why the metric was skipped.
+     */
+    reason: string;
+    /**
+     * Missing
+     *
+     * Operand qnames with no bound fact at the period, when applicable.
+     */
+    missing?: Array<string>;
+};
+
 /**
  * SqlStatementRequest
  */
@@ -12020,6 +12325,11 @@ export type StructureSummary = {
  * StructureUpdatePatch
  *
  * Partial-update patch for a single structure, keyed by structure_id.
+ *
+ * ``concept_arrangement`` makes a mis-CAP'd structure repairable in
+ * place (e.g. promoting a ``set`` note to ``roll_up`` so it gains a
+ * footing rule); ``block_type`` stays immutable — it drives block-type
+ * routing, so changing it is a re-create, not an edit.
  */
 export type StructureUpdatePatch = {
     /**
@@ -12040,6 +12350,10 @@ export type StructureUpdatePatch = {
      * Role Uri
      */
     role_uri?: string | null;
+    /**
+     * Concept Arrangement
+     */
+    concept_arrangement?: 'set' | 'roll_up' | 'roll_forward' | 'roll_forward_info' | 'adjustment' | 'variance' | 'arithmetic' | 'text_block' | 'level1_textblock' | 'level2_textblock' | 'level3_textblock' | 'level4_detail' | 'table_equivalent_textblock' | 'grid' | 'compound_fact' | null;
     /**
      * Metadata
      */
@@ -12787,9 +13101,9 @@ export type TaxonomyBlockRuleRequest = {
     /**
      * Rule Pattern
      *
-     * One of 11 cm:BusinessRulePattern mechanisms.
+     * One of the cm:BusinessRulePattern mechanisms. 'Derive' rules COMPUTE a value from bound operand facts (compute-metrics) rather than verify one — the tenant-authored-metric pattern.
      */
-    rule_pattern: 'Adjustment' | 'CoExists' | 'EqualTo' | 'Exists' | 'GreaterThan' | 'GreaterThanOrEqualToZero' | 'LessThan' | 'RollForward' | 'RollUp' | 'SumEquals' | 'Variance';
+    rule_pattern: 'Adjustment' | 'CoExists' | 'Derive' | 'EqualTo' | 'Exists' | 'GreaterThan' | 'GreaterThanOrEqualToZero' | 'LessThan' | 'RollForward' | 'RollUp' | 'SumEquals' | 'Variance';
     /**
      * Expression
      *
@@ -14311,7 +14625,9 @@ export type ViewConfig = {
  * mode; missing projections (those still in backlog) render as empty
  * states without breaking the dispatcher.
  *
- * Today: ``rendering`` is computed for the statement family.
+ * Today: ``rendering`` is computed for the statement family, and
+ * ``chart`` (the 7th arm — panel/series config over the rendering's
+ * rows and periods) for metric blocks.
  * Other arms (``fact_table``, ``model_structure``, ``verification_results``,
  * ``report_elements``, ``business_rules``) come online as their backend
  * support lands; ``fact_table`` is trivially derivable from
@@ -14320,6 +14636,7 @@ export type ViewConfig = {
  */
 export type ViewProjections = {
     rendering?: RenderingLite | null;
+    chart?: ChartLite | null;
 };
 
 /**
@@ -22022,6 +22339,70 @@ export type EvaluateRulesResponses = {
 
 export type EvaluateRulesResponse2 = EvaluateRulesResponses[keyof EvaluateRulesResponses];
 
+export type ComputeMetricsData = {
+    body: ComputeMetricsRequest;
+    headers?: {
+        /**
+         * Idempotency-Key
+         */
+        'Idempotency-Key'?: string | null;
+    };
+    path: {
+        /**
+         * Graph Id
+         */
+        graph_id: string;
+    };
+    query?: never;
+    url: '/extensions/roboledger/{graph_id}/operations/compute-metrics';
+};
+
+export type ComputeMetricsErrors = {
+    /**
+     * Invalid request
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Access denied
+     */
+    403: ErrorResponse;
+    /**
+     * Resource not found
+     */
+    404: ErrorResponse;
+    /**
+     * Idempotency-Key conflict — key reused with different body
+     */
+    409: ErrorResponse;
+    /**
+     * Validation error
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+
+export type ComputeMetricsError = ComputeMetricsErrors[keyof ComputeMetricsErrors];
+
+export type ComputeMetricsResponses = {
+    /**
+     * Successful Response
+     */
+    200: OperationEnvelopeComputeMetricsResponse;
+};
+
+export type ComputeMetricsResponse2 = ComputeMetricsResponses[keyof ComputeMetricsResponses];
+
 export type BindTextBlockData = {
     body: BindTextBlockRequest;
     headers?: {