@timeax/digital-service-engine 0.2.0 → 0.2.2

package/dist/core/index.d.cts

@@ -222,6 +222,11 @@ type ValidatorOptions = {
     selectedOptionKeys?: string[];
     globalUtilityGuard?: boolean;
     policies?: DynamicRule[];
+    /**
+     * Global/base rate policy used by validation and service filtering.
+     * This is intentionally separate from fallbackSettings.ratePolicy.
+     */
+    ratePolicy?: RatePolicy;
     fallbackSettings?: FallbackSettings;
 };
 type RatePolicy = {
@@ -256,6 +261,7 @@ type ServiceFallback = {
 };
 type FallbackEditorServiceMap = DgpServiceMap;
 type FallbackRegistrationScope = "global" | "node";
+type FallbackEligibleSource = "all_services" | "registered";
 type FallbackScopeRef = {
     scope: "global";
     primary: ServiceIdRef;
@@ -553,6 +559,7 @@ interface Builder {
     getProps(): ServiceProps;
     /** Service map for validation/rules */
     getServiceMap(): DgpServiceMap;
+    getOptions(): BuilderOptions;
     getConstraints(): {
         id: string;
         label: string;
@@ -585,16 +592,6 @@ declare function resolveServiceFallback(params: {
     props: ServiceProps;
 }): ServiceIdRef | null;
 declare function collectFailedFallbacks(props: ServiceProps, services: DgpServiceMap, settings?: FallbackSettings): FailedFallbackContext[];
-/**
- * Return all fallback candidates that are eligible for the given primary,
- * respecting:
- *  - node-scoped list first (if nodeId provided), then global list for `primary`
- *  - rate policy vs. primary
- *  - (optional) tag constraint fit, only when tagId is provided and requireConstraintFit=true
- *  - excludes (including primary automatically)
- *  - selectionStrategy: 'priority' keeps list order, 'cheapest' sorts by rate asc
- *  - unique (dedupe) and optional limit
- */
 declare function getEligibleFallbacks(params: {
     primary: ServiceIdRef;
     nodeId?: NodeIdRef;
@@ -606,6 +603,11 @@ declare function getEligibleFallbacks(params: {
     exclude?: Array<ServiceIdRef>;
     unique?: boolean;
     limit?: number;
+    source?: FallbackEligibleSource;
+}): ServiceIdRef[];
+declare function getAssignedServiceIds(params: {
+    props?: ServiceProps;
+    snapshot?: OrderSnapshot;
 }): ServiceIdRef[];
 declare function getFallbackRegistrationInfo(props: ServiceProps, nodeId: NodeIdRef): {
     primary?: ServiceIdRef;
@@ -763,6 +765,9 @@ type FilterServicesForVisibleGroupInput = {
         usedServiceIds: ServiceIdRef[];
         effectiveConstraints?: Partial<Record<"refill" | "cancel" | "dripfeed", boolean>>;
         policies?: unknown;
+        ratePolicy?: RatePolicy;
+        fallbackSettings?: FallbackSettings;
+        /** Backward-compatible alias for fallbackSettings */
         fallback?: FallbackSettings;
         strictSafety?: boolean;
         enforcePolicies?: boolean;
@@ -833,8 +838,9 @@ interface FallbackEditor {
         exclude?: ServiceIdRef[];
         unique?: boolean;
         limit?: number;
+        source?: FallbackEligibleSource;
     }): ServiceIdRef[];
 }
 declare function createFallbackEditor(options?: FallbackEditorOptions): FallbackEditor;
 
-export { type AncestryHit, type AnyNode, type Builder, type BuilderOptions, type FailedFallbackContext, type FallbackEditor, type FieldNode, type FilterServicesForVisibleGroupInput, type FilterServicesForVisibleGroupResult, type NodeIndex, type NodeKind, type NormaliseOptions, type OptionNode, type RateCoherenceDiagnostic, type RelKind, type ServiceCheck, type TagNode, type UnknownNode, type WithAncestry, buildOrderSnapshot, collectFailedFallbacks, createBuilder, createFallbackEditor, createNodeIndex, filterServicesForVisibleGroup, getEligibleFallbacks, getFallbackRegistrationInfo, normalise, normalizeFieldValidation, resolveServiceFallback, validate, validateAsync, validateRateCoherenceDeep };
+export { type AncestryHit, type AnyNode, type Builder, type BuilderOptions, type FailedFallbackContext, type FallbackEditor, type FieldNode, type FilterServicesForVisibleGroupInput, type FilterServicesForVisibleGroupResult, type NodeIndex, type NodeKind, type NormaliseOptions, type OptionNode, type RateCoherenceDiagnostic, type RelKind, type ServiceCheck, type TagNode, type UnknownNode, type WithAncestry, buildOrderSnapshot, collectFailedFallbacks, createBuilder, createFallbackEditor, createNodeIndex, filterServicesForVisibleGroup, getAssignedServiceIds, getEligibleFallbacks, getFallbackRegistrationInfo, normalise, normalizeFieldValidation, resolveServiceFallback, validate, validateAsync, validateRateCoherenceDeep };

package/dist/core/index.d.ts

@@ -222,6 +222,11 @@ type ValidatorOptions = {
     selectedOptionKeys?: string[];
     globalUtilityGuard?: boolean;
     policies?: DynamicRule[];
+    /**
+     * Global/base rate policy used by validation and service filtering.
+     * This is intentionally separate from fallbackSettings.ratePolicy.
+     */
+    ratePolicy?: RatePolicy;
     fallbackSettings?: FallbackSettings;
 };
 type RatePolicy = {
@@ -256,6 +261,7 @@ type ServiceFallback = {
 };
 type FallbackEditorServiceMap = DgpServiceMap;
 type FallbackRegistrationScope = "global" | "node";
+type FallbackEligibleSource = "all_services" | "registered";
 type FallbackScopeRef = {
     scope: "global";
     primary: ServiceIdRef;
@@ -553,6 +559,7 @@ interface Builder {
     getProps(): ServiceProps;
     /** Service map for validation/rules */
     getServiceMap(): DgpServiceMap;
+    getOptions(): BuilderOptions;
     getConstraints(): {
         id: string;
         label: string;
@@ -585,16 +592,6 @@ declare function resolveServiceFallback(params: {
     props: ServiceProps;
 }): ServiceIdRef | null;
 declare function collectFailedFallbacks(props: ServiceProps, services: DgpServiceMap, settings?: FallbackSettings): FailedFallbackContext[];
-/**
- * Return all fallback candidates that are eligible for the given primary,
- * respecting:
- *  - node-scoped list first (if nodeId provided), then global list for `primary`
- *  - rate policy vs. primary
- *  - (optional) tag constraint fit, only when tagId is provided and requireConstraintFit=true
- *  - excludes (including primary automatically)
- *  - selectionStrategy: 'priority' keeps list order, 'cheapest' sorts by rate asc
- *  - unique (dedupe) and optional limit
- */
 declare function getEligibleFallbacks(params: {
     primary: ServiceIdRef;
     nodeId?: NodeIdRef;
@@ -606,6 +603,11 @@ declare function getEligibleFallbacks(params: {
     exclude?: Array<ServiceIdRef>;
     unique?: boolean;
     limit?: number;
+    source?: FallbackEligibleSource;
+}): ServiceIdRef[];
+declare function getAssignedServiceIds(params: {
+    props?: ServiceProps;
+    snapshot?: OrderSnapshot;
 }): ServiceIdRef[];
 declare function getFallbackRegistrationInfo(props: ServiceProps, nodeId: NodeIdRef): {
     primary?: ServiceIdRef;
@@ -763,6 +765,9 @@ type FilterServicesForVisibleGroupInput = {
         usedServiceIds: ServiceIdRef[];
         effectiveConstraints?: Partial<Record<"refill" | "cancel" | "dripfeed", boolean>>;
         policies?: unknown;
+        ratePolicy?: RatePolicy;
+        fallbackSettings?: FallbackSettings;
+        /** Backward-compatible alias for fallbackSettings */
         fallback?: FallbackSettings;
         strictSafety?: boolean;
         enforcePolicies?: boolean;
@@ -833,8 +838,9 @@ interface FallbackEditor {
         exclude?: ServiceIdRef[];
         unique?: boolean;
         limit?: number;
+        source?: FallbackEligibleSource;
     }): ServiceIdRef[];
 }
 declare function createFallbackEditor(options?: FallbackEditorOptions): FallbackEditor;
 
-export { type AncestryHit, type AnyNode, type Builder, type BuilderOptions, type FailedFallbackContext, type FallbackEditor, type FieldNode, type FilterServicesForVisibleGroupInput, type FilterServicesForVisibleGroupResult, type NodeIndex, type NodeKind, type NormaliseOptions, type OptionNode, type RateCoherenceDiagnostic, type RelKind, type ServiceCheck, type TagNode, type UnknownNode, type WithAncestry, buildOrderSnapshot, collectFailedFallbacks, createBuilder, createFallbackEditor, createNodeIndex, filterServicesForVisibleGroup, getEligibleFallbacks, getFallbackRegistrationInfo, normalise, normalizeFieldValidation, resolveServiceFallback, validate, validateAsync, validateRateCoherenceDeep };
+export { type AncestryHit, type AnyNode, type Builder, type BuilderOptions, type FailedFallbackContext, type FallbackEditor, type FieldNode, type FilterServicesForVisibleGroupInput, type FilterServicesForVisibleGroupResult, type NodeIndex, type NodeKind, type NormaliseOptions, type OptionNode, type RateCoherenceDiagnostic, type RelKind, type ServiceCheck, type TagNode, type UnknownNode, type WithAncestry, buildOrderSnapshot, collectFailedFallbacks, createBuilder, createFallbackEditor, createNodeIndex, filterServicesForVisibleGroup, getAssignedServiceIds, getEligibleFallbacks, getFallbackRegistrationInfo, normalise, normalizeFieldValidation, resolveServiceFallback, validate, validateAsync, validateRateCoherenceDeep };