@timeax/digital-service-engine 0.2.0 → 0.2.1

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 = {
@@ -553,6 +558,7 @@ interface Builder {
     getProps(): ServiceProps;
     /** Service map for validation/rules */
     getServiceMap(): DgpServiceMap;
+    getOptions(): BuilderOptions;
     getConstraints(): {
         id: string;
         label: string;
@@ -763,6 +769,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;

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 = {
@@ -553,6 +558,7 @@ interface Builder {
     getProps(): ServiceProps;
     /** Service map for validation/rules */
     getServiceMap(): DgpServiceMap;
+    getOptions(): BuilderOptions;
     getConstraints(): {
         id: string;
         label: string;
@@ -763,6 +769,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;

package/dist/core/index.js

@@ -1250,15 +1250,13 @@ function rateOk(svcMap, candidate, primary, policy) {
 
 // src/core/validate/steps/rates.ts
 function validateRates(v) {
-  var _a, _b, _c, _d;
-  const ratePolicy = normalizeRatePolicy(
-    (_a = v.options.fallbackSettings) == null ? void 0 : _a.ratePolicy
-  );
+  var _a, _b, _c;
+  const ratePolicy = normalizeRatePolicy(v.options.ratePolicy);
   for (const f of v.fields) {
     if (!isMultiField(f)) continue;
     const baseRates = [];
-    for (const o of (_b = f.options) != null ? _b : []) {
-      const role = (_d = (_c = o.pricing_role) != null ? _c : f.pricing_role) != null ? _d : "base";
+    for (const o of (_a = f.options) != null ? _a : []) {
+      const role = (_c = (_b = o.pricing_role) != null ? _b : f.pricing_role) != null ? _c : "base";
       if (role !== "base") continue;
       const sid = o.service_id;
       if (!isServiceIdRef(sid)) continue;
@@ -2032,6 +2030,38 @@ function applyPolicies(errors, props, serviceMap, policies, fieldsVisibleUnder,
   }
 }
 
+// src/core/governance.ts
+var DEFAULT_FALLBACK_SETTINGS = {
+  requireConstraintFit: true,
+  ratePolicy: { kind: "lte_primary", pct: 5 },
+  selectionStrategy: "priority",
+  mode: "strict"
+};
+function resolveGlobalRatePolicy(options) {
+  return normalizeRatePolicy(options.ratePolicy);
+}
+function resolveFallbackSettings(options) {
+  var _a;
+  return {
+    ...DEFAULT_FALLBACK_SETTINGS,
+    ...(_a = options.fallbackSettings) != null ? _a : {}
+  };
+}
+function mergeValidatorOptions(defaults = {}, overrides = {}) {
+  var _a, _b, _c, _d;
+  const mergedFallbackSettings = {
+    ...(_a = defaults.fallbackSettings) != null ? _a : {},
+    ...(_b = overrides.fallbackSettings) != null ? _b : {}
+  };
+  return {
+    ...defaults,
+    ...overrides,
+    policies: (_c = overrides.policies) != null ? _c : defaults.policies,
+    ratePolicy: (_d = overrides.ratePolicy) != null ? _d : defaults.ratePolicy,
+    fallbackSettings: Object.keys(mergedFallbackSettings).length > 0 ? mergedFallbackSettings : void 0
+  };
+}
+
 // src/core/builder.ts
 import { cloneDeep as cloneDeep2 } from "lodash-es";
 function createBuilder(opts = {}) {
@@ -2274,7 +2304,7 @@ var BuilderImpl = class {
     return out;
   }
   errors() {
-    return validate(this.props, this.options);
+    return validate(this.props, mergeValidatorOptions({}, this.options));
   }
   getOptions() {
     return cloneDeep2(this.options);
@@ -2561,11 +2591,14 @@ function readVisibilitySimOpts(ctx) {
   };
 }
 function validate(props, ctx = {}) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c;
+  const options = mergeValidatorOptions({}, ctx);
+  const fallbackSettings = resolveFallbackSettings(options);
+  const ratePolicy = resolveGlobalRatePolicy(options);
   const errors = [];
-  const serviceMap = (_a = ctx.serviceMap) != null ? _a : {};
+  const serviceMap = (_a = options.serviceMap) != null ? _a : {};
   const selectedKeys = new Set(
-    (_b = ctx.selectedOptionKeys) != null ? _b : []
+    (_b = options.selectedOptionKeys) != null ? _b : []
   );
   const tags = Array.isArray(props.filters) ? props.filters : [];
   const fields = Array.isArray(props.fields) ? props.fields : [];
@@ -2575,8 +2608,12 @@ function validate(props, ctx = {}) {
   for (const f of fields) fieldById.set(f.id, f);
   const v = {
     props,
-    nodeMap: (_c = ctx.nodeMap) != null ? _c : buildNodeMap(props),
-    options: ctx,
+    nodeMap: (_c = options.nodeMap) != null ? _c : buildNodeMap(props),
+    options: {
+      ...options,
+      ratePolicy,
+      fallbackSettings
+    },
     errors,
     serviceMap,
     selectedKeys,
@@ -2591,7 +2628,7 @@ function validate(props, ctx = {}) {
   validateIdentity(v);
   validateOptionMaps(v);
   v.fieldsVisibleUnder = createFieldsVisibleUnder(v);
-  const visSim = readVisibilitySimOpts(ctx);
+  const visSim = readVisibilitySimOpts(options);
   validateVisibility(v, visSim);
   applyPolicies(
     v.errors,
@@ -2612,7 +2649,7 @@ function validate(props, ctx = {}) {
         builder,
         services: serviceMap,
         tagId: tag.id,
-        ratePolicy: (_d = ctx.fallbackSettings) == null ? void 0 : _d.ratePolicy,
+        ratePolicy,
         invalidFieldIds: v.invalidRateFieldIds
       });
       for (const diag of diags) {
@@ -3523,18 +3560,23 @@ function compilePolicies(raw) {
 
 // src/core/service-filter.ts
 function filterServicesForVisibleGroup(input, deps) {
-  var _a, _b, _c, _d, _e, _f;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
   const svcMap = (_c = (_b = (_a = deps.builder).getServiceMap) == null ? void 0 : _b.call(_a)) != null ? _c : {};
+  const builderOptions = (_e = (_d = deps.builder).getOptions) == null ? void 0 : _e.call(_d);
   const { context } = input;
   const usedSet = new Set(context.usedServiceIds.map(String));
   const primary = context.usedServiceIds[0];
+  const explicitFallbackSettings = (_f = context.fallbackSettings) != null ? _f : context.fallback;
+  const resolvedRatePolicy = normalizeRatePolicy(
+    (_h = (_g = context.ratePolicy) != null ? _g : explicitFallbackSettings == null ? void 0 : explicitFallbackSettings.ratePolicy) != null ? _h : builderOptions == null ? void 0 : builderOptions.ratePolicy
+  );
+  const fallbackSettingsSource = explicitFallbackSettings != null ? explicitFallbackSettings : builderOptions == null ? void 0 : builderOptions.fallbackSettings;
   const fb = {
-    requireConstraintFit: true,
-    ratePolicy: { kind: "lte_primary", pct: 5 },
-    selectionStrategy: "priority",
-    mode: "strict",
-    ...(_d = context.fallback) != null ? _d : {}
+    ...DEFAULT_FALLBACK_SETTINGS,
+    ...fallbackSettingsSource != null ? fallbackSettingsSource : {},
+    ratePolicy: resolvedRatePolicy
   };
+  const policySource = (_j = (_i = context.policies) != null ? _i : builderOptions == null ? void 0 : builderOptions.policies) != null ? _j : [];
   const visibleServiceIds = context.selectedButtons === void 0 ? void 0 : collectVisibleServiceIds(
     deps.builder,
     context.tagId,
@@ -3559,11 +3601,11 @@ function filterServicesForVisibleGroup(input, deps) {
     const fitsConstraints = constraintFitOk(
       svcMap,
       cap.id,
-      (_e = context.effectiveConstraints) != null ? _e : {}
+      (_k = context.effectiveConstraints) != null ? _k : {}
     );
     const passesRate2 = primary == null ? true : rateOk(svcMap, id, primary, fb);
     const polRes = evaluatePoliciesRaw(
-      (_f = context.policies) != null ? _f : [],
+      policySource,
       [...context.usedServiceIds, id],
       svcMap,
       context.tagId,