@timeax/digital-service-engine 0.0.6 → 0.0.8

package/dist/schema/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/schema/index.ts"],"sourcesContent":["export * from \"./base\";\r\nexport * from \"./canvas-types\";\r\nexport * from \"./comments\";\r\nexport * from \"./editor\";\r\nexport * from \"./editor.types\";\r\nexport * from \"./graph\";\r\nexport * from \"./order\";\r\nexport * from \"./policies\";\r\nexport * from \"./provider\";\r\nexport * from \"./validation\";\r\nexport * from \"./fallback-editor\""],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/schema/index.ts"],"sourcesContent":["export * from \"./base\";\r\nexport * from \"./canvas-types\";\r\nexport * from \"./comments\";\r\nexport * from \"./editor\";\r\nexport * from \"./editor.types\";\r\nexport * from \"./graph\";\r\nexport * from \"./order\";\r\nexport * from \"./policies\";\r\nexport * from \"./provider\";\r\nexport * from \"./validation\";\r\nexport * from \"./fallback-editor\"\r\nexport * from './catalog'"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/schema/index.d.cts

@@ -1,9 +1,9 @@
-import { NodeProps } from 'reactflow';
+import { NodeProps, Node } from '@xyflow/react';
 
 interface ButtonValue {
     id: string;
     value: string | number;
-    service_id?: number;
+    service_id?: ServiceIdRef;
     pricing_role?: "base" | "utility";
     meta?: Record<string, unknown> & UtilityMark & WithQuantityDefault;
 }
@@ -12,16 +12,23 @@ type UtilityMode = "flat" | "per_quantity" | "per_value" | "percent";
 type QuantityRule = {
     valueBy: "value" | "length" | "eval";
     code?: string;
+    multiply?: number;
+    clamp?: {
+        min?: number;
+        max?: number;
+    };
+    fallback?: number;
 };
 type UtilityLineItem = {
     nodeId: string;
     mode: UtilityMode;
     rate: number;
+    percentBase?: "service_total" | "base_service" | "all";
+    label?: string;
     inputs: {
         quantity: number;
         value?: Scalar | Scalar[];
-        valueBy?: "value" | "length" | "eval";
-        evalCodeUsed?: boolean;
+        valueBy?: "value" | "length";
     };
 };
 type ServiceFallbacks = ServiceFallback;
@@ -47,8 +54,16 @@ type SnapshotContext = {
     /** Client pruning policy used (so server can mirror/compare). */
     policy: {
         ratePolicy: {
-            kind: "lte_primary" | "none";
-            thresholdPct?: number;
+            kind: "eq_primary";
+        } | {
+            kind: "lte_primary";
+            pct: number;
+        } | {
+            kind: "within_pct";
+            pct: number;
+        } | {
+            kind: "at_least_pct_lower";
+            pct: number;
         };
         requireConstraintFit: boolean;
     };
@@ -156,7 +171,7 @@ type NodeRef = {
 };
 type NodeMap = Map<string, NodeRef>;
 
-type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context";
+type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "rate_coherence_violation" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context" | "field_validation_invalid_rule" | "field_validation_invalid_op" | "field_validation_eval_missing_code" | "field_validation_between_missing_bounds" | "field_validation_match_missing_pattern";
 type ValidationError = {
     code: ValidationCode;
     message: string;
@@ -212,7 +227,10 @@ type ValidatorOptions = {
     fallbackSettings?: FallbackSettings;
 };
 type RatePolicy = {
+    kind: "eq_primary";
+} | {
     kind: "lte_primary";
+    pct: number;
 } | {
     kind: "within_pct";
     pct: number;
@@ -223,7 +241,7 @@ type RatePolicy = {
 type FallbackSettings = {
     /** Require fallbacks to satisfy tag constraints (dripfeed/refill/cancel) when a tag context is known. Default: true */
     requireConstraintFit?: boolean;
-    /** Rate rule policy. Default: { kind: 'lte_primary' } i.e. candidate.rate <= primary.rate */
+    /** Rate rule policy. Default: { kind: 'lte_primary', pct: 5 }. */
     ratePolicy?: RatePolicy;
     /** When multiple candidates remain, choose first (priority) or cheapest. Default: 'priority' */
     selectionStrategy?: "priority" | "cheapest";
@@ -231,7 +249,6 @@ type FallbackSettings = {
     mode?: "strict" | "dev";
 };
 
-type ServiceIdRef = number | string;
 type NodeIdRef = string;
 type ServiceFallback = {
     /** Node-scoped fallbacks: prefer these when that node’s primary service fails */
@@ -375,6 +392,7 @@ interface FallbackEditor {
 }
 declare function createFallbackEditor(options?: FallbackEditorOptions): FallbackEditor;
 
+type ServiceIdRef = IdType;
 type PricingRole = "base" | "utility";
 type FieldType = "custom" | (string & {});
 /** ── Marker types (live inside meta; non-breaking) ───────────────────── */
@@ -508,6 +526,20 @@ type UiValue<U extends Ui> = U extends {
 } ? {
     [K in keyof F]?: UiValue<F[K]>;
 } : unknown;
+type FieldValidationValueBy = "value" | "length" | "eval";
+type FieldValidationOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "between" | "in" | "nin" | "truthy" | "falsy" | "match";
+type FieldValidationRule = {
+    valueBy?: FieldValidationValueBy;
+    op: FieldValidationOp;
+    value?: unknown;
+    min?: number;
+    max?: number;
+    values?: unknown[];
+    pattern?: string;
+    flags?: string;
+    code?: string;
+    message?: string;
+};
 /**
  * FieldWithTypedDefaults<T>: same shape as BaseFieldUI, but:
  *  - ui is a concrete map T (propName → Ui node)
@@ -523,7 +555,7 @@ type FieldOption = {
     id: string;
     label: string;
     value?: string | number;
-    service_id?: number;
+    service_id?: ServiceIdRef;
     pricing_role?: PricingRole;
     meta?: Record<string, unknown> & UtilityMark & WithQuantityDefault;
 };
@@ -536,6 +568,7 @@ type Field = BaseFieldUI & {
     description?: string;
     component?: string;
     pricing_role?: PricingRole;
+    validation?: FieldValidationRule[];
     meta?: Record<string, unknown> & QuantityMark & UtilityMark & {
         multi?: boolean;
     };
@@ -544,7 +577,7 @@ type Field = BaseFieldUI & {
     service_id?: undefined;
 } | ({
     button: true;
-    service_id?: number;
+    service_id?: ServiceIdRef;
 } & WithQuantityDefault));
 type ConstraintKey = string;
 /**
@@ -556,7 +589,7 @@ type Tag = {
     id: string;
     label: string;
     bind_id?: string;
-    service_id?: number;
+    service_id?: ServiceIdRef;
     includes?: string[];
     excludes?: string[];
     meta?: Record<string, unknown> & WithQuantityDefault;
@@ -635,10 +668,10 @@ type GraphSnapshot = {
     nodes: GraphNode[];
     edges: GraphEdge[];
 };
-type FlowNode = NodeProps<{
+type FlowNode = NodeProps<Node<{
     node: GraphNode;
     [x: string]: any;
-}>;
+}, NodeKind>>;
 
 type CommentId = string;
 type ThreadId = string;
@@ -681,6 +714,119 @@ type CommentThread = {
     _sync?: "pending" | "synced" | "error";
 };
 
+type Env = "client" | "workspace";
+type SelectionOptions = {
+    env?: Env;
+    rootTagId?: string;
+    /** Resolve service capability from an id (used for `services` array) */
+    resolveService?: (id: any) => DgpServiceCapability | undefined;
+};
+
+type CatalogId = string;
+type CatalogServiceId = string | number;
+type CatalogNodeKind = "group" | "smart-group";
+type CatalogSmartRule = {
+    type: "service-field";
+    field: string;
+    op: "eq" | "neq" | "in" | "contains" | "startsWith" | "endsWith" | "gt" | "gte" | "lt" | "lte" | "between" | "exists";
+    value?: unknown;
+    min?: number;
+    max?: number;
+} | {
+    type: "policy-family";
+    key: string;
+    value?: unknown;
+} | {
+    type: "compatibility";
+    scope: "tag" | "field" | "option" | "visible-group";
+    targetId?: string;
+    mode: "safe" | "assignable" | "same-family" | "conflicts";
+};
+type CatalogNodeBase = {
+    id: CatalogId;
+    label: string;
+    parentId?: CatalogId;
+    description?: string;
+    order?: number;
+    color?: string;
+    icon?: string;
+    collapsed?: boolean;
+    meta?: Record<string, unknown>;
+};
+type CatalogGroupNode = CatalogNodeBase & {
+    kind: "group";
+    serviceIds: CatalogServiceId[];
+};
+type CatalogSmartGroupNode = CatalogNodeBase & {
+    kind: "smart-group";
+    rules: CatalogSmartRule[];
+    match: "all" | "any";
+    resolvedServiceIds?: CatalogServiceId[];
+    resolvedAt?: number;
+};
+type CatalogNode = CatalogGroupNode | CatalogSmartGroupNode;
+type CatalogViewMode = "all" | "grouped" | "smart" | "assigned";
+interface ServiceCatalogState {
+    version: 1;
+    nodes: CatalogNode[];
+    activeNodeId?: CatalogId;
+    expandedIds?: CatalogId[];
+    pinnedNodeIds?: CatalogId[];
+    selectedServiceId?: CatalogServiceId;
+    viewMode?: CatalogViewMode;
+    meta?: Record<string, unknown>;
+}
+
+type EditorEvents = {
+    "editor:command": {
+        name: string;
+        payload?: any;
+    };
+    "editor:change": {
+        props: ServiceProps;
+        reason: string;
+        command?: string;
+        snapshot: EditorSnapshot;
+    };
+    "editor:undo": {
+        stackSize: number;
+        index: number;
+    };
+    "editor:redo": {
+        stackSize: number;
+        index: number;
+    };
+    "editor:error": {
+        message: string;
+        code?: string;
+        meta?: any;
+    };
+    "catalog:change": {
+        catalog?: ServiceCatalogState;
+        reason: string;
+    };
+    "catalog:active-change": {
+        activeNodeId?: string;
+    };
+};
+type Command = {
+    name: string;
+    do(): void;
+    undo(): void;
+};
+type EditorOptions = {
+    historyLimit?: number;
+    validateAfterEach?: boolean;
+    /** Sync existence check; return true if the service exists. */
+    serviceExists?: (id: number) => boolean;
+    /** Optional local index; used if serviceExists is not provided. */
+    serviceMap?: Record<number, unknown>;
+    /** Raw policies JSON; will be compiled on demand by filterServicesForVisibleGroup. */
+    policiesRaw?: unknown;
+    selectionProps?: SelectionOptions;
+};
+type ConnectKind = "bind" | "include" | "exclude";
+
 type Viewport = {
     x: number;
     y: number;
@@ -766,7 +912,7 @@ type CanvasEvents = {
         nextDelayMs?: number;
         error?: any;
     };
-};
+} & EditorEvents;
 type NodeView = GraphNode & {
     position?: NodePos;
 };
@@ -811,60 +957,11 @@ type EditorSnapshot = {
     props: ServiceProps;
     layout?: LayoutState;
     comments?: CommentNode[];
+    catalog?: ServiceCatalogState;
     meta?: Record<string, unknown>;
 };
 
-type Env = "client" | "workspace";
-type SelectionOptions = {
-    env?: Env;
-    rootTagId?: string;
-    /** Resolve service capability from an id (used for `services` array) */
-    resolveService?: (id: any) => DgpServiceCapability | undefined;
-};
-
-type EditorEvents = {
-    "editor:command": {
-        name: string;
-        payload?: any;
-    };
-    "editor:change": {
-        props: ServiceProps;
-        reason: string;
-        command?: string;
-    };
-    "editor:undo": {
-        stackSize: number;
-        index: number;
-    };
-    "editor:redo": {
-        stackSize: number;
-        index: number;
-    };
-    "editor:error": {
-        message: string;
-        code?: string;
-        meta?: any;
-    };
-};
-type Command = {
-    name: string;
-    do(): void;
-    undo(): void;
-};
-type EditorOptions = {
-    historyLimit?: number;
-    validateAfterEach?: boolean;
-    /** Sync existence check; return true if the service exists. */
-    serviceExists?: (id: number) => boolean;
-    /** Optional local index; used if serviceExists is not provided. */
-    serviceMap?: Record<number, unknown>;
-    /** Raw policies JSON; will be compiled on demand by filterServicesForVisibleGroup. */
-    policiesRaw?: unknown;
-    selectionProps?: SelectionOptions;
-};
-type ConnectKind = "bind" | "include" | "exclude";
-
 /** Exported alias so the schema generator can target an array */
 type AdminPolicies = DynamicRule[];
 
-export { type AdminPolicies, type BaseFieldUI, type ButtonValue, type CanvasEvents, type CanvasOptions, type CanvasState, type Command, type CommentAnchor, type CommentId, type CommentMessage, type CommentNode, type CommentThread, type ConnectKind, type ConstraintKey, type DgpServiceCapability, type DgpServiceMap, type DraftWire, type DynamicRule, type EdgeKind, type EdgeRoute, type EdgeView, type EditorEvents, type EditorOptions, type EditorSnapshot, type FallbackCandidateCheck, type FallbackCheckReason, type FallbackCheckResult, type FallbackDiagnostics, type FallbackEditor, type FallbackEditorOptions, type FallbackEditorServiceMap, type FallbackEditorServiceRecord, type FallbackEditorState, type FallbackMutationOptions, type FallbackRegistration, type FallbackRegistrationScope, type FallbackScopeRef, type FallbackSettings, type Field, type FieldOption, type FieldType, type FieldWithTypedDefaults, type FlagKey, type FlowNode, type GraphEdge, type GraphNode, type GraphSnapshot, type IdType, type LayoutState, type NodeIdRef, type NodeKind, type NodePos, type NodePositions, type NodeView, type NoticeKind, type NoticeSeverity, type NoticeTarget, type NoticeType, type OrderSnapshot, type PricingRole, type QuantityMark, type QuantityRule, type RatePolicy, type Scalar, type ServiceEstimates, type ServiceFallback, type ServiceFallbacks, type ServiceFlag, type ServiceFlags, type ServiceIdRef, type ServiceProps, type ServicePropsNotice, type ServiceWhereClause, type ServiceWhereOp, type SnapshotContext, type SpeedEstimate, type Tag, type ThreadId, type TimeRangeEstimate, type Ui, type UiAnyOf, type UiArray, type UiBoolean, type UiNumber, type UiObject, type UiString, type UiValue, type UtilityLineItem, type UtilityMark, type UtilityMode, type ValidationCode, type ValidationError, type ValidatorOptions, type Viewport, type WithQuantityDefault, createFallbackEditor };
+export { type AdminPolicies, type BaseFieldUI, type ButtonValue, type CanvasEvents, type CanvasOptions, type CanvasState, type CatalogGroupNode, type CatalogId, type CatalogNode, type CatalogNodeBase, type CatalogNodeKind, type CatalogServiceId, type CatalogSmartGroupNode, type CatalogSmartRule, type CatalogViewMode, type Command, type CommentAnchor, type CommentId, type CommentMessage, type CommentNode, type CommentThread, type ConnectKind, type ConstraintKey, type DgpServiceCapability, type DgpServiceMap, type DraftWire, type DynamicRule, type EdgeKind, type EdgeRoute, type EdgeView, type EditorEvents, type EditorOptions, type EditorSnapshot, type FallbackCandidateCheck, type FallbackCheckReason, type FallbackCheckResult, type FallbackDiagnostics, type FallbackEditor, type FallbackEditorOptions, type FallbackEditorServiceMap, type FallbackEditorServiceRecord, type FallbackEditorState, type FallbackMutationOptions, type FallbackRegistration, type FallbackRegistrationScope, type FallbackScopeRef, type FallbackSettings, type Field, type FieldOption, type FieldType, type FieldValidationOp, type FieldValidationRule, type FieldValidationValueBy, type FieldWithTypedDefaults, type FlagKey, type FlowNode, type GraphEdge, type GraphNode, type GraphSnapshot, type IdType, type LayoutState, type NodeIdRef, type NodeKind, type NodePos, type NodePositions, type NodeView, type NoticeKind, type NoticeSeverity, type NoticeTarget, type NoticeType, type OrderSnapshot, type PricingRole, type QuantityMark, type QuantityRule, type RatePolicy, type Scalar, type ServiceCatalogState, type ServiceEstimates, type ServiceFallback, type ServiceFallbacks, type ServiceFlag, type ServiceFlags, type ServiceIdRef, type ServiceProps, type ServicePropsNotice, type ServiceWhereClause, type ServiceWhereOp, type SnapshotContext, type SpeedEstimate, type Tag, type ThreadId, type TimeRangeEstimate, type Ui, type UiAnyOf, type UiArray, type UiBoolean, type UiNumber, type UiObject, type UiString, type UiValue, type UtilityLineItem, type UtilityMark, type UtilityMode, type ValidationCode, type ValidationError, type ValidatorOptions, type Viewport, type WithQuantityDefault, createFallbackEditor };