@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.5

package/dist/esm/core/features/feature-gate-surface.example.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { FeatureGate } from './FeatureGate.js';
+import { useFeatureGate } from './useFeatureGate.js';
+/** @wildo_source:part:start example.features.connected-feature.surface facet:kind:usage-example facet:audience:app-developer */
+// Consuming the SAME identifier the feature was declared under.
+//
+// In an application both imports come from package roots:
+//
+//   import { FeatureGate, useFeatureGate } from '@wildo-ai/saas-frontend-lib';
+//   import { ApplicationFeature } from '@your-app/shared-lib';
+//
+// `ApplicationFeature` is the enum declared on the models side — one identifier, not a second
+// string typed at the point of use. Render inside the normal Wildo provider tree, which supplies
+// the features, user/organization and billing contexts these read from.
+//
+// A hidden component is NOT authorization. Both forms below decide what a person SEES; the
+// operation still needs its own `requiredFeatures` declaration, or the capability is reachable
+// by anyone who calls the API directly.
+var ApplicationFeature;
+(function (ApplicationFeature) {
+    ApplicationFeature["ADVANCED_REPORTS"] = "ADVANCED_REPORTS";
+})(ApplicationFeature || (ApplicationFeature = {}));
+/**
+ * The ordinary form: when the feature is unavailable, `FeatureGate` renders the policy-driven
+ * prompt configured by the feature's `unavailability` behavior instead of the children.
+ */
+export function ReportsSurface({ children }) {
+    return _jsx(FeatureGate, { featureId: ApplicationFeature.ADVANCED_REPORTS, children: children });
+}
+/**
+ * For a custom layout, consume the same availability result directly. The application supplies
+ * translated content and its normal design-system controls through these slots.
+ */
+export function ReportsAvailability({ available, unavailable }) {
+    const availability = useFeatureGate(ApplicationFeature.ADVANCED_REPORTS);
+    return _jsx(_Fragment, { children: availability.isAvailable ? available : unavailable });
+}
+//# sourceMappingURL=feature-gate-surface.example.js.map

package/dist/esm/core/features/feature-gate-surface.example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-gate-surface.example.js","sourceRoot":"","sources":["../../../../../src/core/features/feature-gate-surface.example.tsx"],"names":[],"mappings":";AA4BA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,gIAAgI;AAChI,gEAAgE;AAChE,EAAE;AACF,0DAA0D;AAC1D,EAAE;AACF,+EAA+E;AAC/E,+DAA+D;AAC/D,EAAE;AACF,8FAA8F;AAC9F,iGAAiG;AACjG,wEAAwE;AACxE,EAAE;AACF,2FAA2F;AAC3F,+FAA+F;AAC/F,wCAAwC;AAExC,IAAK,kBAEJ;AAFD,WAAK,kBAAkB;IACrB,2DAAqC,CAAA;AACvC,CAAC,EAFI,kBAAkB,KAAlB,kBAAkB,QAEtB;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAA2B;IAClE,OAAO,KAAC,WAAW,IAAC,SAAS,EAAE,kBAAkB,CAAC,gBAAgB,YAAG,QAAQ,GAAe,CAAC;AAC/F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAoD;IAC9G,MAAM,YAAY,GAAG,cAAc,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IACzE,OAAO,4BAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,GAAI,CAAC;AACnE,CAAC","sourcesContent":["/**\n * Tier B usage example for the `engine-product-definitions` skill: the INTERFACE half of one\n * feature identifier, paired with the declaration half in\n * `engine/saas-models/src/features/connected-feature.example.ts`.\n *\n * WHY TIER B (and not Tier A against the dogfood application):\n *\n *  1. It is the companion to a Tier-B declaration. The whole lesson is that the same identifier\n *     appears in both places, so splitting the pair across tiers would leave the reader comparing\n *     an illustrative enum against a real application's unrelated one.\n *  2. Surface markup is the product-specific, volatile material Tier B exists for. What is stable\n *     is which hook answers the availability question and what a gate does with the answer.\n *\n * Imports are RELATIVE because this file lives inside `@wildo-ai/saas-frontend-lib` itself and a\n * package may not import its own name. An application developer types the public specifier, which\n * the anchored prose states explicitly — the compiled skill is read by someone with no access to\n * this repository.\n *\n * The feature identifier is re-declared locally rather than imported from the models-side example:\n * these are two packages, and in a real application BOTH sides import the one enum from the\n * application's own shared-lib package root. Keeping each example independently readable matters\n * because the generator inlines them into the skill separately.\n *\n * Typechecked by the package's ordinary program (`include: [\"src\"]`), so a change to `FeatureGate`\n * or `useFeatureGate` breaks the build here rather than silently rotting inside a shipped skill.\n */\n\nimport type { ReactNode } from 'react';\nimport { FeatureGate } from './FeatureGate';\nimport { useFeatureGate } from './useFeatureGate';\n\n/** @wildo_source:part:start example.features.connected-feature.surface facet:kind:usage-example facet:audience:app-developer */\n// Consuming the SAME identifier the feature was declared under.\n//\n// In an application both imports come from package roots:\n//\n//   import { FeatureGate, useFeatureGate } from '@wildo-ai/saas-frontend-lib';\n//   import { ApplicationFeature } from '@your-app/shared-lib';\n//\n// `ApplicationFeature` is the enum declared on the models side — one identifier, not a second\n// string typed at the point of use. Render inside the normal Wildo provider tree, which supplies\n// the features, user/organization and billing contexts these read from.\n//\n// A hidden component is NOT authorization. Both forms below decide what a person SEES; the\n// operation still needs its own `requiredFeatures` declaration, or the capability is reachable\n// by anyone who calls the API directly.\n\nenum ApplicationFeature {\n  ADVANCED_REPORTS = 'ADVANCED_REPORTS',\n}\n\n/**\n * The ordinary form: when the feature is unavailable, `FeatureGate` renders the policy-driven\n * prompt configured by the feature's `unavailability` behavior instead of the children.\n */\nexport function ReportsSurface({ children }: { children: ReactNode }) {\n  return <FeatureGate featureId={ApplicationFeature.ADVANCED_REPORTS}>{children}</FeatureGate>;\n}\n\n/**\n * For a custom layout, consume the same availability result directly. The application supplies\n * translated content and its normal design-system controls through these slots.\n */\nexport function ReportsAvailability({ available, unavailable }: { available: ReactNode; unavailable: ReactNode }) {\n  const availability = useFeatureGate(ApplicationFeature.ADVANCED_REPORTS);\n  return <>{availability.isAvailable ? available : unavailable}</>;\n}\n/** @wildo_source:part:end example.features.connected-feature.surface */\n"]}

package/dist/esm/core/features/feature-unavailability.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-unavailability.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/features/feature-unavailability.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,UAAU,wBAAwB;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,UAAU,0CAA0C;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC1C,MAAM,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,EACxD,qBAAqB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,EAAE,CAYV;AAgBD;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,0CAA0C,GACjD;IACD,QAAQ,EAAE,6BAA6B,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CA2FA"}
+{"version":3,"file":"feature-unavailability.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/feature-unavailability.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,UAAU,wBAAwB;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,UAAU,0CAA0C;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC1C,MAAM,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,wBAAwB,GAAG,IAAI,GAAG,SAAS,EACxD,qBAAqB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,EAAE,CAYV;AAgBD;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,0CAA0C,GACjD;IACD,QAAQ,EAAE,6BAA6B,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CA2FA"}

package/dist/esm/core/features/feature-unavailability.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature-unavailability.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/features/feature-unavailability.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FeatureUnavailabilityBehavior,\n  type FeatureConfiguration,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\n\ninterface FeaturePolicyPermissions {\n  appLevel?: string[] | null;\n  organizations?: Record<string, string[]> | null;\n}\n\ninterface ResolveFeatureUnavailabilityBehaviorParams {\n  billingEnabled: boolean;\n  featureDef: FeatureDefinition | undefined;\n  policy: FeatureConfiguration['unavailabilityPolicy'];\n  reason: string;\n  userRoles: string[];\n}\n\nconst BILLING_PROMPT_BEHAVIORS = new Set<FeatureUnavailabilityBehavior>([\n  FeatureUnavailabilityBehavior.UPGRADE_PROMPT,\n  FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT,\n  FeatureUnavailabilityBehavior.ADDON_PROMPT,\n]);\n\n/**\n * Merge app-level roles with the current organization's membership roles.\n * The frontend policy contract can target either layer, so availability\n * checks must resolve against the same effective role surface the user sees.\n */\nexport function buildFeaturePolicyRoles(\n  permissions: FeaturePolicyPermissions | null | undefined,\n  currentOrganizationId: string | null | undefined,\n): string[] {\n  const roles: string[] = [];\n\n  if (permissions?.appLevel?.length) {\n    roles.push(...permissions.appLevel);\n  }\n\n  if (currentOrganizationId && permissions?.organizations?.[currentOrganizationId]?.length) {\n    roles.push(...permissions.organizations[currentOrganizationId]);\n  }\n\n  return [...new Set(roles)];\n}\n\nfunction applyBillingDisabledBehaviorOverride(\n  behavior: FeatureUnavailabilityBehavior,\n  billingEnabled: boolean,\n  policy: FeatureConfiguration['unavailabilityPolicy'],\n  trace: string[],\n): FeatureUnavailabilityBehavior {\n  if (billingEnabled || !BILLING_PROMPT_BEHAVIORS.has(behavior)) {\n    return behavior;\n  }\n\n  trace.push(`[billing-disabled] Replacing ${behavior} with ${policy.whenBillingDisabled}`);\n  return policy.whenBillingDisabled;\n}\n\n/**\n * Resolve the final unavailability behavior with a single cascade shared by\n * feature-level and operation-level checks.\n */\nexport function resolveFeatureUnavailabilityBehavior(\n  params: ResolveFeatureUnavailabilityBehaviorParams,\n): {\n  behavior: FeatureUnavailabilityBehavior;\n  suggestedProductRef?: string;\n  /**\n   * The component a CUSTOM-behaviour feature declares. Returned from EVERY arm, unlike\n   * `suggestedProductRef`, because the ref is a property of the FEATURE rather than of the cascade\n   * arm that selected the behaviour — a global role or reason default of CUSTOM must still reach\n   * the component the feature declared, or it renders nothing.\n   */\n  customComponentRef?: string;\n  debugTrace: string[];\n} {\n  const {\n    billingEnabled,\n    featureDef,\n    policy,\n    reason,\n    userRoles,\n  } = params;\n  const trace: string[] = [];\n\n  if (featureDef?.unavailability?.behavior) {\n    trace.push(`[1] Per-feature override: ${featureDef.unavailability.behavior}`);\n    return {\n      behavior: applyBillingDisabledBehaviorOverride(\n        featureDef.unavailability.behavior,\n        billingEnabled,\n        policy,\n        trace,\n      ),\n      suggestedProductRef: featureDef.unavailability.suggestedProductRef,\n      customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n    };\n  }\n\n  if (featureDef?.unavailability?.byRole) {\n    for (const role of userRoles) {\n      const roleBehavior = featureDef.unavailability.byRole[role];\n      if (roleBehavior) {\n        trace.push(`[2] Per-feature role override (${role}): ${roleBehavior}`);\n        return {\n          behavior: applyBillingDisabledBehaviorOverride(\n            roleBehavior,\n            billingEnabled,\n            policy,\n            trace,\n          ),\n          suggestedProductRef: featureDef.unavailability.suggestedProductRef,\n          customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n        };\n      }\n    }\n    trace.push('[2] Per-feature role override: no match');\n  }\n\n  for (const role of userRoles) {\n    const globalRoleBehavior = policy.roleDefaults[role];\n    if (globalRoleBehavior) {\n      trace.push(`[3] Global role default (${role}): ${globalRoleBehavior}`);\n      return {\n        behavior: applyBillingDisabledBehaviorOverride(\n          globalRoleBehavior,\n          billingEnabled,\n          policy,\n          trace,\n        ),\n        customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n      };\n    }\n  }\n  trace.push('[3] Global role default: no match');\n\n  const reasonBehavior = policy.reasonDefaults[reason];\n  if (reasonBehavior) {\n    trace.push(`[4] Global reason default (${reason}): ${reasonBehavior}`);\n    return {\n      behavior: applyBillingDisabledBehaviorOverride(\n        reasonBehavior,\n        billingEnabled,\n        policy,\n        trace,\n      ),\n      customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n    };\n  }\n  trace.push(`[4] Global reason default (${reason}): no match`);\n\n  trace.push(`[5] Global default: ${policy.defaultBehavior}`);\n  return {\n    behavior: applyBillingDisabledBehaviorOverride(\n      policy.defaultBehavior,\n      billingEnabled,\n      policy,\n      trace,\n    ),\n    customComponentRef: featureDef?.unavailability?.customComponentRef,\n    debugTrace: trace,\n  };\n}\n"]}
+{"version":3,"file":"feature-unavailability.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/features/feature-unavailability.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FeatureUnavailabilityBehavior,\n  type FeatureConfiguration,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\n\ninterface FeaturePolicyPermissions {\n  appLevel?: string[] | null;\n  organizations?: Record<string, string[]> | null;\n}\n\ninterface ResolveFeatureUnavailabilityBehaviorParams {\n  billingEnabled: boolean;\n  featureDef: FeatureDefinition | undefined;\n  policy: FeatureConfiguration['unavailabilityPolicy'];\n  reason: string;\n  userRoles: string[];\n}\n\nconst BILLING_PROMPT_BEHAVIORS = new Set<FeatureUnavailabilityBehavior>([\n  FeatureUnavailabilityBehavior.UPGRADE_PROMPT,\n  FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT,\n  FeatureUnavailabilityBehavior.ADDON_PROMPT,\n]);\n\n/**\n * Merge app-level roles with the current organization's membership roles.\n * The frontend policy contract can target either layer, so availability\n * checks must resolve against the same effective role surface the user sees.\n */\nexport function buildFeaturePolicyRoles(\n  permissions: FeaturePolicyPermissions | null | undefined,\n  currentOrganizationId: string | null | undefined,\n): string[] {\n  const roles: string[] = [];\n\n  if (permissions?.appLevel?.length) {\n    roles.push(...permissions.appLevel);\n  }\n\n  if (currentOrganizationId && permissions?.organizations?.[currentOrganizationId]?.length) {\n    roles.push(...permissions.organizations[currentOrganizationId]);\n  }\n\n  return [...new Set(roles)];\n}\n\nfunction applyBillingDisabledBehaviorOverride(\n  behavior: FeatureUnavailabilityBehavior,\n  billingEnabled: boolean,\n  policy: FeatureConfiguration['unavailabilityPolicy'],\n  trace: string[],\n): FeatureUnavailabilityBehavior {\n  if (billingEnabled || !BILLING_PROMPT_BEHAVIORS.has(behavior)) {\n    return behavior;\n  }\n\n  trace.push(`[billing-disabled] Replacing ${behavior} with ${policy.whenBillingDisabled}`);\n  return policy.whenBillingDisabled;\n}\n\n/**\n * Resolve the final unavailability behavior with a single cascade shared by\n * feature-level and operation-level checks.\n */\nexport function resolveFeatureUnavailabilityBehavior(\n  params: ResolveFeatureUnavailabilityBehaviorParams,\n): {\n  behavior: FeatureUnavailabilityBehavior;\n  suggestedProductRef?: string;\n  /**\n   * The component a CUSTOM-behaviour feature declares. Returned from EVERY arm, unlike\n   * `suggestedProductRef`, because the ref is a property of the FEATURE rather than of the cascade\n   * arm that selected the behaviour — a global role or reason default of CUSTOM must still reach\n   * the component the feature declared, or it renders nothing.\n   */\n  customComponentRef?: string;\n  debugTrace: string[];\n} {\n  const {\n    billingEnabled,\n    featureDef,\n    policy,\n    reason,\n    userRoles,\n  } = params;\n  const trace: string[] = [];\n\n  if (featureDef?.unavailability?.behavior) {\n    trace.push(`[1] Per-feature override: ${featureDef.unavailability.behavior}`);\n    return {\n      behavior: applyBillingDisabledBehaviorOverride(\n        featureDef.unavailability.behavior,\n        billingEnabled,\n        policy,\n        trace,\n      ),\n      suggestedProductRef: featureDef.unavailability.suggestedProductRef,\n      customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n    };\n  }\n\n  if (featureDef?.unavailability?.byRole) {\n    for (const role of userRoles) {\n      const roleBehavior = featureDef.unavailability.byRole[role];\n      if (roleBehavior) {\n        trace.push(`[2] Per-feature role override (${role}): ${roleBehavior}`);\n        return {\n          behavior: applyBillingDisabledBehaviorOverride(\n            roleBehavior,\n            billingEnabled,\n            policy,\n            trace,\n          ),\n          suggestedProductRef: featureDef.unavailability.suggestedProductRef,\n          customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n        };\n      }\n    }\n    trace.push('[2] Per-feature role override: no match');\n  }\n\n  for (const role of userRoles) {\n    const globalRoleBehavior = policy.roleDefaults[role];\n    if (globalRoleBehavior) {\n      trace.push(`[3] Global role default (${role}): ${globalRoleBehavior}`);\n      return {\n        behavior: applyBillingDisabledBehaviorOverride(\n          globalRoleBehavior,\n          billingEnabled,\n          policy,\n          trace,\n        ),\n        customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n      };\n    }\n  }\n  trace.push('[3] Global role default: no match');\n\n  const reasonBehavior = policy.reasonDefaults[reason];\n  if (reasonBehavior) {\n    trace.push(`[4] Global reason default (${reason}): ${reasonBehavior}`);\n    return {\n      behavior: applyBillingDisabledBehaviorOverride(\n        reasonBehavior,\n        billingEnabled,\n        policy,\n        trace,\n      ),\n      customComponentRef: featureDef?.unavailability?.customComponentRef,\n      debugTrace: trace,\n    };\n  }\n  trace.push(`[4] Global reason default (${reason}): no match`);\n\n  trace.push(`[5] Global default: ${policy.defaultBehavior}`);\n  return {\n    behavior: applyBillingDisabledBehaviorOverride(\n      policy.defaultBehavior,\n      billingEnabled,\n      policy,\n      trace,\n    ),\n    customComponentRef: featureDef?.unavailability?.customComponentRef,\n    debugTrace: trace,\n  };\n}\n"]}

package/dist/esm/core/features/useFeatureAvailability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAGL,6BAA6B,EAC7B,2BAA2B,EAE3B,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAmB/B,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IAGrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,wCAAwC;IACxC,QAAQ,EAAE,6BAA6B,CAAC;IACxC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,yEAAyE;IACzE,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CA0J7E"}
+{"version":3,"file":"useFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAGL,6BAA6B,EAC7B,2BAA2B,EAE3B,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAmB/B,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IAGrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,wCAAwC;IACxC,QAAQ,EAAE,6BAA6B,CAAC;IACxC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,yEAAyE;IACzE,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CA0J7E"}

package/dist/esm/core/features/useFeatureAvailability.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureAvailability.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useFeatureAvailability Hook\n * \n * Resolves \"is this feature available, and if not, what to do about it\" for a single feature.\n * Uses the FeaturesContext (resolved features + definitions + unavailability policy) and\n * UserOrgsContext (for role) to resolve the complete availability state.\n * \n * Policy cascade (first match wins):\n *   1. Per-feature override → feature.unavailability.behavior\n *   2. Per-feature role override → feature.unavailability.byRole[role]\n *   3. Global role default → policy.roleDefaults[role]\n *   4. Global reason default → policy.reasonDefaults[reason]\n *   5. Global default → policy.defaultBehavior\n * \n * Includes dev-only debugTrace for debugging policy resolution.\n */\n\nimport { useEffect, useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  type FeatureDefinition,\n  type FeatureUpgradeOption,\n} from '@wildo-ai/saas-models';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAnalytics } from '~wildo-frontend-lib/core/monitoring/analytics/useAnalytics';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Cross-instance dedup for feature gate analytics\nconst reportedFeatures = new Set<string>();\n\n// ================================\n// FeatureAvailability Type\n// ================================\n\nexport interface FeatureAvailability {\n  /** Whether the feature is available for the current context */\n  isAvailable: boolean;\n\n  // ── When not available ──\n  /** Why the feature is unavailable */\n  reason?: FeatureUnavailabilityReason;\n  /** What behavior the UI should adopt */\n  behavior: FeatureUnavailabilityBehavior;\n  /** Which feature(s) are missing (for boolean OR/AND modes) */\n  missingFeatures?: string[];\n  /** Limit information (for limit features) */\n  limitInfo?: { featureId: string; current: number; limit: number };\n  /** Upgrade options from the backend (from resolved features response) */\n  upgradeOptions?: FeatureUpgradeOption[];\n  /** Suggested product reference (from per-feature override) */\n  suggestedProductRef?: string;\n  /** Component reference for CUSTOM behaviour (from the feature's unavailability config). */\n  customComponentRef?: string;\n\n  // ── Debug (dev only) ──\n  /** Policy resolution trace — only populated in development mode */\n  debugTrace?: string[];\n}\n\n/**\n * Resolve availability + behavior for a single feature.\n * \n * @param featureId - The feature identifier to check\n * @returns FeatureAvailability — the resolved availability, behavior, and metadata\n */\nexport function useFeatureAvailability(featureId: string): FeatureAvailability {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const { track, isActive } = useAnalytics();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  const result = useMemo((): FeatureAvailability => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n    }\n\n    const featureDef = featureDefinitions.get(featureId);\n\n    // Feature not registered → NOT_CONFIGURED\n    if (!featureDef) {\n      const { behavior, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        featureDef: undefined,\n        policy: unavailabilityPolicy,\n        userRoles: [],\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n      return {\n        isAvailable: false,\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        behavior,\n        missingFeatures: [featureId],\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Build user roles array for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    // ── Boolean feature check ──\n    if (featureDef.valueType === FeatureValueType.BOOLEAN) {\n      const resolvedSet = new Set(resolvedFeatures.features);\n      const isEnabled = resolvedSet.has(featureId);\n      if (isEnabled) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Not enabled → resolve behavior\n      const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      // Get upgrade options from backend response\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        missingFeatures: [featureId],\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // ── Limit feature check ──\n    if (featureDef.valueType === FeatureValueType.LIMIT) {\n      const limit = resolvedFeatures.limits[featureId];\n\n      // No limit set → available (no restriction configured)\n      if (limit === undefined) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Unlimited → always available\n      if (limit === FEATURES_UNLIMITED) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      const currentUsage = resolvedFeatures.currentUsage[featureId] ?? 0;\n\n      // Under the limit → available\n      if (currentUsage < limit) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // At or over limit → resolve behavior\n      const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        limitInfo: { featureId, current: currentUsage, limit },\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Unknown value type → treat as available (defensive)\n    return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n  }, [\n    featureId,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n\n  useEffect(() => {\n    if (!isActive) return;\n    const dedupKey = `${featureId}:${result.isAvailable}`;\n    if (reportedFeatures.has(dedupKey)) return;\n    reportedFeatures.add(dedupKey);\n    track('feature_gate', {\n      featureRef: featureId,\n      isAvailable: result.isAvailable,\n      reason: result.reason,\n    });\n    if (result.isAvailable) {\n      track('feature_accessed', { featureId });\n    }\n  }, [featureId, result.isAvailable, result.reason, isActive, track]);\n\n  return result;\n}\n"]}
+{"version":3,"file":"useFeatureAvailability.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useFeatureAvailability Hook\n * \n * Resolves \"is this feature available, and if not, what to do about it\" for a single feature.\n * Uses the FeaturesContext (resolved features + definitions + unavailability policy) and\n * UserOrgsContext (for role) to resolve the complete availability state.\n * \n * Policy cascade (first match wins):\n *   1. Per-feature override → feature.unavailability.behavior\n *   2. Per-feature role override → feature.unavailability.byRole[role]\n *   3. Global role default → policy.roleDefaults[role]\n *   4. Global reason default → policy.reasonDefaults[reason]\n *   5. Global default → policy.defaultBehavior\n * \n * Includes dev-only debugTrace for debugging policy resolution.\n */\n\nimport { useEffect, useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  type FeatureDefinition,\n  type FeatureUpgradeOption,\n} from '@wildo-ai/saas-models';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAnalytics } from '~wildo-frontend-lib/core/monitoring/analytics/useAnalytics';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Cross-instance dedup for feature gate analytics\nconst reportedFeatures = new Set<string>();\n\n// ================================\n// FeatureAvailability Type\n// ================================\n\nexport interface FeatureAvailability {\n  /** Whether the feature is available for the current context */\n  isAvailable: boolean;\n\n  // ── When not available ──\n  /** Why the feature is unavailable */\n  reason?: FeatureUnavailabilityReason;\n  /** What behavior the UI should adopt */\n  behavior: FeatureUnavailabilityBehavior;\n  /** Which feature(s) are missing (for boolean OR/AND modes) */\n  missingFeatures?: string[];\n  /** Limit information (for limit features) */\n  limitInfo?: { featureId: string; current: number; limit: number };\n  /** Upgrade options from the backend (from resolved features response) */\n  upgradeOptions?: FeatureUpgradeOption[];\n  /** Suggested product reference (from per-feature override) */\n  suggestedProductRef?: string;\n  /** Component reference for CUSTOM behaviour (from the feature's unavailability config). */\n  customComponentRef?: string;\n\n  // ── Debug (dev only) ──\n  /** Policy resolution trace — only populated in development mode */\n  debugTrace?: string[];\n}\n\n/**\n * Resolve availability + behavior for a single feature.\n * \n * @param featureId - The feature identifier to check\n * @returns FeatureAvailability — the resolved availability, behavior, and metadata\n */\nexport function useFeatureAvailability(featureId: string): FeatureAvailability {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const { track, isActive } = useAnalytics();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  const result = useMemo((): FeatureAvailability => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n    }\n\n    const featureDef = featureDefinitions.get(featureId);\n\n    // Feature not registered → NOT_CONFIGURED\n    if (!featureDef) {\n      const { behavior, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        featureDef: undefined,\n        policy: unavailabilityPolicy,\n        userRoles: [],\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n      return {\n        isAvailable: false,\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        behavior,\n        missingFeatures: [featureId],\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Build user roles array for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    // ── Boolean feature check ──\n    if (featureDef.valueType === FeatureValueType.BOOLEAN) {\n      const resolvedSet = new Set(resolvedFeatures.features);\n      const isEnabled = resolvedSet.has(featureId);\n      if (isEnabled) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Not enabled → resolve behavior\n      const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      // Get upgrade options from backend response\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        missingFeatures: [featureId],\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // ── Limit feature check ──\n    if (featureDef.valueType === FeatureValueType.LIMIT) {\n      const limit = resolvedFeatures.limits[featureId];\n\n      // No limit set → available (no restriction configured)\n      if (limit === undefined) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Unlimited → always available\n      if (limit === FEATURES_UNLIMITED) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      const currentUsage = resolvedFeatures.currentUsage[featureId] ?? 0;\n\n      // Under the limit → available\n      if (currentUsage < limit) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // At or over limit → resolve behavior\n      const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        limitInfo: { featureId, current: currentUsage, limit },\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Unknown value type → treat as available (defensive)\n    return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n  }, [\n    featureId,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n\n  useEffect(() => {\n    if (!isActive) return;\n    const dedupKey = `${featureId}:${result.isAvailable}`;\n    if (reportedFeatures.has(dedupKey)) return;\n    reportedFeatures.add(dedupKey);\n    track('feature_gate', {\n      featureRef: featureId,\n      isAvailable: result.isAvailable,\n      reason: result.reason,\n    });\n    if (result.isAvailable) {\n      track('feature_accessed', { featureId });\n    }\n  }, [featureId, result.isAvailable, result.reason, isActive, track]);\n\n  return result;\n}\n"]}

package/dist/esm/core/features/useFeatureGate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureGate.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAErE"}
+{"version":3,"file":"useFeatureGate.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAErE"}

package/dist/esm/core/features/useFeatureGate.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatureGate.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/**\n * useFeatureGate Hook\n * \n * Separated from FeatureGate.tsx for React Fast Refresh compatibility.\n */\n\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\n\n/**\n * Programmatic hook for checking a single feature's availability.\n * Equivalent to useFeatureAvailability — provides both the availability state and\n * a convenience `isAvailable` boolean.\n */\nexport function useFeatureGate(featureId: string): FeatureAvailability {\n  return useFeatureAvailability(featureId);\n}\n"]}
+{"version":3,"file":"useFeatureGate.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/**\n * useFeatureGate Hook\n * \n * Separated from FeatureGate.tsx for React Fast Refresh compatibility.\n */\n\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\n\n/**\n * Programmatic hook for checking a single feature's availability.\n * Equivalent to useFeatureAvailability — provides both the availability state and\n * a convenience `isAvailable` boolean.\n */\nexport function useFeatureGate(featureId: string): FeatureAvailability {\n  return useFeatureAvailability(featureId);\n}\n"]}

package/dist/esm/core/features/useFeatures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatures.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAO,mBAM9B,CAAC"}
+{"version":3,"file":"useFeatures.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAO,mBAM9B,CAAC"}

package/dist/esm/core/features/useFeatures.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFeatures.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,eAAe,EAA4B,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAwB,EAAE;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * useFeatures Hook\n * \n * Separated from FeaturesContext.tsx for React Fast Refresh compatibility.\n * Provides access to the feature context: resolved features, definitions, policy, and convenience methods.\n */\n\nimport { useContext } from 'react';\nimport { FeaturesContext, type FeaturesContextType } from './FeaturesContext';\n\n/**\n * Hook to access the Features context.\n * @returns FeaturesContextType with resolved features, definitions, policy, and convenience methods.\n * @throws Error if used outside of FeaturesProvider.\n */\nexport const useFeatures = (): FeaturesContextType => {\n  const context = useContext(FeaturesContext);\n  if (!context) {\n    throw new Error('useFeatures must be used within a FeaturesProvider');\n  }\n  return context;\n};\n"]}
+{"version":3,"file":"useFeatures.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,eAAe,EAA4B,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAwB,EAAE;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * useFeatures Hook\n * \n * Separated from FeaturesContext.tsx for React Fast Refresh compatibility.\n * Provides access to the feature context: resolved features, definitions, policy, and convenience methods.\n */\n\nimport { useContext } from 'react';\nimport { FeaturesContext, type FeaturesContextType } from './FeaturesContext';\n\n/**\n * Hook to access the Features context.\n * @returns FeaturesContextType with resolved features, definitions, policy, and convenience methods.\n * @throws Error if used outside of FeaturesProvider.\n */\nexport const useFeatures = (): FeaturesContextType => {\n  const context = useContext(FeaturesContext);\n  if (!context) {\n    throw new Error('useFeatures must be used within a FeaturesProvider');\n  }\n  return context;\n};\n"]}

package/dist/esm/core/features/useOperationFeatureAvailability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAML,KAAK,sBAAsB,EAE3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAC7H,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AASpE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC/G,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,EAAE,oBAAoB,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9G,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnD,oBAAoB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,EACrE,GAAG,EAAE,0CAA0C,GAC9C,mBAAmB,GAAG,SAAS,CAyIjC;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,GACpE,mBAAmB,GAAG,SAAS,CA8CjC"}
+{"version":3,"file":"useOperationFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAML,KAAK,sBAAsB,EAE3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAC7H,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AASpE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC/G,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,EAAE,oBAAoB,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9G,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnD,oBAAoB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,EACrE,GAAG,EAAE,0CAA0C,GAC9C,mBAAmB,GAAG,SAAS,CAyIjC;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,GACpE,mBAAmB,GAAG,SAAS,CA8CjC"}

package/dist/esm/core/features/useOperationFeatureAvailability.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationFeatureAvailability.js","sourceRoot":"","sources":["../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useOperationFeatureAvailability Hook\n * \n * Resolves feature availability for an operation's `requiredFeatures` config.\n * Evaluates both boolean features (OR/AND mode) and limit checks.\n * \n * For boolean features:\n *   - OR mode: any single enabled feature is enough\n *   - AND mode: all features must be enabled\n * \n * For limit features:\n *   - CREATE operations: checks currentUsage + 1 <= limit\n *   - CREATE_MANY: checks currentUsage < limit (conservative — backend does exact check)\n *   - Other operations: increment = 0, so limits are not checked\n * \n * Returns the \"worst\" availability result (boolean failure takes precedence over limit failure).\n */\n\nimport { useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  CoreResourceOperation,\n  type RequiredFeaturesConfig,\n  type RequiredFeaturesFullConfig,\n  type FeatureUpgradeOption,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { FeatureAvailability } from './useFeatureAvailability';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Re-export the FeatureAvailability type for convenience\nexport type { FeatureAvailability };\n\n/**\n * Minimal operation-like shape accepted by resolveOperationFeatureAvailability.\n * Used to wrap view-level requiredFeatures or standalone feature checks\n * without needing the full FrontendResourceConfiguration_Operation type.\n * \n * Cast to FrontendResourceConfiguration_Operation when calling resolveOperationFeatureAvailability:\n *   `viewCheckable as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation`\n */\nexport interface RequiredFeaturesCheckable {\n  requiredFeatures: RequiredFeaturesConfig;\n  operationIdentifier: string;\n}\n\n// ================================\n// Pure Resolution Function (for batch + hook use)\n// ================================\n\n/**\n * Parameters for the pure resolution function.\n * Contains all the context needed to resolve feature availability without hooks.\n */\nexport interface ResolveOperationFeatureAvailabilityContext {\n  resolvedFeatures: { features: string[]; limits: Record<string, number>; currentUsage: Record<string, number> };\n  resolvedFeaturesResponse: { upgradeOptions: Record<string, { availableVia: FeatureUpgradeOption[] }> } | null;\n  featureDefinitions: Map<string, FeatureDefinition>;\n  unavailabilityPolicy: ReturnType<typeof useFeatures>['unavailabilityPolicy'];\n  userRoles: string[];\n  billingEnabled: boolean;\n}\n\n/**\n * Pure function to resolve feature availability for an operation's requiredFeatures.\n * Can be called from hooks (via useMemo) or from batch evaluation effects.\n * \n * @param operation - The frontend resource operation configuration\n * @param ctx - Resolution context (resolved features, definitions, policy, roles)\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function resolveOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n  ctx: ResolveOperationFeatureAvailabilityContext,\n): FeatureAvailability | undefined {\n  if (!operation) return undefined;\n\n  // Normalize requiredFeatures (may be string[] or RequiredFeaturesFullConfig)\n  const raw = operation.requiredFeatures;\n  if (!raw) return undefined;\n\n  const normalized: RequiredFeaturesFullConfig = Array.isArray(raw)\n    ? { features: raw, mode: 'OR' }\n    : raw;\n\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    userRoles,\n    billingEnabled,\n  } = ctx;\n  const resolvedSet = new Set(resolvedFeatures.features);\n\n  // ── Phase 1: Boolean features ──\n  if (normalized.features && normalized.features.length > 0) {\n    const mode = normalized.mode ?? 'OR';\n\n    if (mode === 'OR') {\n      // OR: at least one boolean feature must be enabled\n      const booleanFeatures = normalized.features.filter(fId => {\n        const def = featureDefinitions.get(fId);\n        return !def || def.valueType === FeatureValueType.BOOLEAN;\n      });\n\n      const anyEnabled = booleanFeatures.some(fId => resolvedSet.has(fId));\n      if (booleanFeatures.length > 0 && !anyEnabled) {\n        const missingFeatures = booleanFeatures.filter(fId => !resolvedSet.has(fId));\n        const firstMissing = featureDefinitions.get(missingFeatures[0]);\n        const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef: firstMissing,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[missingFeatures[0]]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          missingFeatures,\n          upgradeOptions,\n          suggestedProductRef: firstMissing?.unavailability?.suggestedProductRef,\n        };\n      }\n    } else {\n      // AND: all boolean features must be enabled\n      for (const featureId of normalized.features) {\n        const def = featureDefinitions.get(featureId);\n        if (def && def.valueType !== FeatureValueType.BOOLEAN) continue;\n\n        if (!resolvedSet.has(featureId)) {\n          const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n          const { behavior } = resolveFeatureUnavailabilityBehavior({\n            reason,\n            featureDef: def,\n            policy: unavailabilityPolicy,\n            userRoles,\n            billingEnabled,\n          });\n          const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n          return {\n            isAvailable: false,\n            reason,\n            behavior,\n            missingFeatures: [featureId],\n            upgradeOptions,\n            suggestedProductRef: def?.unavailability?.suggestedProductRef,\n          };\n        }\n      }\n    }\n  }\n\n  // ── Phase 2: Limit checks ──\n  if (normalized.limitChecks && normalized.limitChecks.length > 0) {\n    const operationId = operation.operationIdentifier as string;\n\n    for (const check of normalized.limitChecks) {\n      const limit = resolvedFeatures.limits[check.featureId];\n\n      // No limit or unlimited → pass\n      if (limit === undefined || limit === FEATURES_UNLIMITED) continue;\n\n      const currentUsage = resolvedFeatures.currentUsage[check.featureId] ?? 0;\n\n      // Infer increment (frontend-side: same logic as backend, conservative for CREATE_MANY)\n      let increment: number;\n      if (check.increment !== undefined) {\n        increment = check.increment;\n      } else if (operationId === CoreResourceOperation.CREATE) {\n        increment = 1;\n      } else if (operationId === CoreResourceOperation.CREATE_MANY) {\n        increment = 1; // Conservative — backend does exact check\n      } else {\n        increment = 0;\n      }\n\n      if (increment === 0) continue;\n\n      if (currentUsage + increment > limit) {\n        const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n        const featureDef = featureDefinitions.get(check.featureId);\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[check.featureId]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          limitInfo: { featureId: check.featureId, current: currentUsage, limit },\n          upgradeOptions,\n          suggestedProductRef: featureDef?.unavailability?.suggestedProductRef,\n        };\n      }\n    }\n  }\n\n  // All checks passed\n  return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n}\n\n// ================================\n// Hook (convenience wrapper over pure function)\n// ================================\n\n/**\n * Resolve feature availability for an operation's requiredFeatures.\n * \n * @param operation - The frontend resource operation configuration\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function useOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n): FeatureAvailability | undefined {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  return useMemo((): FeatureAvailability | undefined => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return operation?.requiredFeatures\n        ? { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE }\n        : undefined;\n    }\n\n    // Build user roles for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    return resolveOperationFeatureAvailability(operation, {\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      userRoles,\n      billingEnabled: billing?.isEnabled ?? false,\n    });\n  }, [\n    operation,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n}\n"]}
+{"version":3,"file":"useOperationFeatureAvailability.js","sourceRoot":"","sources":["../../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useOperationFeatureAvailability Hook\n * \n * Resolves feature availability for an operation's `requiredFeatures` config.\n * Evaluates both boolean features (OR/AND mode) and limit checks.\n * \n * For boolean features:\n *   - OR mode: any single enabled feature is enough\n *   - AND mode: all features must be enabled\n * \n * For limit features:\n *   - CREATE operations: checks currentUsage + 1 <= limit\n *   - CREATE_MANY: checks currentUsage < limit (conservative — backend does exact check)\n *   - Other operations: increment = 0, so limits are not checked\n * \n * Returns the \"worst\" availability result (boolean failure takes precedence over limit failure).\n */\n\nimport { useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  CoreResourceOperation,\n  type RequiredFeaturesConfig,\n  type RequiredFeaturesFullConfig,\n  type FeatureUpgradeOption,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { FeatureAvailability } from './useFeatureAvailability';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Re-export the FeatureAvailability type for convenience\nexport type { FeatureAvailability };\n\n/**\n * Minimal operation-like shape accepted by resolveOperationFeatureAvailability.\n * Used to wrap view-level requiredFeatures or standalone feature checks\n * without needing the full FrontendResourceConfiguration_Operation type.\n * \n * Cast to FrontendResourceConfiguration_Operation when calling resolveOperationFeatureAvailability:\n *   `viewCheckable as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation`\n */\nexport interface RequiredFeaturesCheckable {\n  requiredFeatures: RequiredFeaturesConfig;\n  operationIdentifier: string;\n}\n\n// ================================\n// Pure Resolution Function (for batch + hook use)\n// ================================\n\n/**\n * Parameters for the pure resolution function.\n * Contains all the context needed to resolve feature availability without hooks.\n */\nexport interface ResolveOperationFeatureAvailabilityContext {\n  resolvedFeatures: { features: string[]; limits: Record<string, number>; currentUsage: Record<string, number> };\n  resolvedFeaturesResponse: { upgradeOptions: Record<string, { availableVia: FeatureUpgradeOption[] }> } | null;\n  featureDefinitions: Map<string, FeatureDefinition>;\n  unavailabilityPolicy: ReturnType<typeof useFeatures>['unavailabilityPolicy'];\n  userRoles: string[];\n  billingEnabled: boolean;\n}\n\n/**\n * Pure function to resolve feature availability for an operation's requiredFeatures.\n * Can be called from hooks (via useMemo) or from batch evaluation effects.\n * \n * @param operation - The frontend resource operation configuration\n * @param ctx - Resolution context (resolved features, definitions, policy, roles)\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function resolveOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n  ctx: ResolveOperationFeatureAvailabilityContext,\n): FeatureAvailability | undefined {\n  if (!operation) return undefined;\n\n  // Normalize requiredFeatures (may be string[] or RequiredFeaturesFullConfig)\n  const raw = operation.requiredFeatures;\n  if (!raw) return undefined;\n\n  const normalized: RequiredFeaturesFullConfig = Array.isArray(raw)\n    ? { features: raw, mode: 'OR' }\n    : raw;\n\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    userRoles,\n    billingEnabled,\n  } = ctx;\n  const resolvedSet = new Set(resolvedFeatures.features);\n\n  // ── Phase 1: Boolean features ──\n  if (normalized.features && normalized.features.length > 0) {\n    const mode = normalized.mode ?? 'OR';\n\n    if (mode === 'OR') {\n      // OR: at least one boolean feature must be enabled\n      const booleanFeatures = normalized.features.filter(fId => {\n        const def = featureDefinitions.get(fId);\n        return !def || def.valueType === FeatureValueType.BOOLEAN;\n      });\n\n      const anyEnabled = booleanFeatures.some(fId => resolvedSet.has(fId));\n      if (booleanFeatures.length > 0 && !anyEnabled) {\n        const missingFeatures = booleanFeatures.filter(fId => !resolvedSet.has(fId));\n        const firstMissing = featureDefinitions.get(missingFeatures[0]);\n        const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef: firstMissing,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[missingFeatures[0]]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          missingFeatures,\n          upgradeOptions,\n          suggestedProductRef: firstMissing?.unavailability?.suggestedProductRef,\n        };\n      }\n    } else {\n      // AND: all boolean features must be enabled\n      for (const featureId of normalized.features) {\n        const def = featureDefinitions.get(featureId);\n        if (def && def.valueType !== FeatureValueType.BOOLEAN) continue;\n\n        if (!resolvedSet.has(featureId)) {\n          const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n          const { behavior } = resolveFeatureUnavailabilityBehavior({\n            reason,\n            featureDef: def,\n            policy: unavailabilityPolicy,\n            userRoles,\n            billingEnabled,\n          });\n          const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n          return {\n            isAvailable: false,\n            reason,\n            behavior,\n            missingFeatures: [featureId],\n            upgradeOptions,\n            suggestedProductRef: def?.unavailability?.suggestedProductRef,\n          };\n        }\n      }\n    }\n  }\n\n  // ── Phase 2: Limit checks ──\n  if (normalized.limitChecks && normalized.limitChecks.length > 0) {\n    const operationId = operation.operationIdentifier as string;\n\n    for (const check of normalized.limitChecks) {\n      const limit = resolvedFeatures.limits[check.featureId];\n\n      // No limit or unlimited → pass\n      if (limit === undefined || limit === FEATURES_UNLIMITED) continue;\n\n      const currentUsage = resolvedFeatures.currentUsage[check.featureId] ?? 0;\n\n      // Infer increment (frontend-side: same logic as backend, conservative for CREATE_MANY)\n      let increment: number;\n      if (check.increment !== undefined) {\n        increment = check.increment;\n      } else if (operationId === CoreResourceOperation.CREATE) {\n        increment = 1;\n      } else if (operationId === CoreResourceOperation.CREATE_MANY) {\n        increment = 1; // Conservative — backend does exact check\n      } else {\n        increment = 0;\n      }\n\n      if (increment === 0) continue;\n\n      if (currentUsage + increment > limit) {\n        const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n        const featureDef = featureDefinitions.get(check.featureId);\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[check.featureId]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          limitInfo: { featureId: check.featureId, current: currentUsage, limit },\n          upgradeOptions,\n          suggestedProductRef: featureDef?.unavailability?.suggestedProductRef,\n        };\n      }\n    }\n  }\n\n  // All checks passed\n  return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n}\n\n// ================================\n// Hook (convenience wrapper over pure function)\n// ================================\n\n/**\n * Resolve feature availability for an operation's requiredFeatures.\n * \n * @param operation - The frontend resource operation configuration\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function useOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n): FeatureAvailability | undefined {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  return useMemo((): FeatureAvailability | undefined => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return operation?.requiredFeatures\n        ? { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE }\n        : undefined;\n    }\n\n    // Build user roles for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    return resolveOperationFeatureAvailability(operation, {\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      userRoles,\n      billingEnabled: billing?.isEnabled ?? false,\n    });\n  }, [\n    operation,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n}\n"]}

package/dist/esm/core/flows-actors/FlowsActorsContext.d.ts

@@ -1,5 +1,6 @@
 import React, { ReactNode } from 'react';
-import { FlowActorSystem_FrontendInfo, type FlowsActors_ConversationHistoryResponse } from '@wildo-ai/saas-models';
+import { FlowActorSystem_FrontendInfo, type FlowsActors_ConversationHistoryResponse, type WS_FlowsActorsApprovalModificationRefusal } from '@wildo-ai/saas-models';
+import type { SerializableZodSchema } from '@wildo-ai/zod-decorators';
 /**
  * FlowsActors Execution Status
  */
@@ -51,6 +52,23 @@ export interface FlowsActorsExecution {
         /** The tool call being gated, and its arguments — the structured thing being approved. */
         toolName?: string;
         toolArgs?: Record<string, unknown>;
+        /**
+         * The gated tool's input schema as a serialized descriptor (#587), so an editor can offer the
+         * tool's fields. A rendering hint only — the server re-validates every modification.
+         */
+        toolInputSchema?: SerializableZodSchema;
+        /**
+         * The server's refusal of the approver's last edit, when it refused one (#587). The approval is
+         * still pending when this is set: a refused modification leaves the pause standing, so the
+         * surface keeps the decision on screen with the reason instead of dropping it.
+         *
+         * STRUCTURED, not the server's sentence (#1186): the card renders a label per reason, naming the
+         * tool and the offending arguments as parameters. A server that sent no structure (older than the
+         * field) yields an empty `reason`, which the card reads as "refused, reason not stated".
+         */
+        modificationRefusal?: WS_FlowsActorsApprovalModificationRefusal;
+        /** The arguments the approver submitted in that refused edit, so the editor reopens on them (#587). */
+        rejectedToolArgs?: Record<string, unknown>;
         requestedAt?: Date;
         /**
          * ECHOED back on the decision. Dropping it filters the resume against the default-instance
@@ -61,6 +79,18 @@ export interface FlowsActorsExecution {
     };
     /** Set when the last error is recoverable (UI can offer a retry action) */
     recoverable?: boolean;
+    /**
+     * The approval this client last ANSWERED, kept until the server's reaction is known (#587).
+     *
+     * Answering clears `pendingApproval` at once, which is right when the decision lands. But a refused
+     * modification leaves the server's pause standing, and without this the surface would have nothing to
+     * put back on screen — the approval would vanish while still waiting. `submittedToolArgs` is what the
+     * approver authored, so a restored editor reopens on their edit rather than on the model's call.
+     */
+    answeredApproval?: {
+        approval: NonNullable<FlowsActorsExecution['pendingApproval']>;
+        submittedToolArgs?: Record<string, unknown>;
+    };
     result?: Record<string, unknown>;
     duration?: number;
     errorCode?: string;
@@ -78,7 +108,11 @@ export interface FlowsActorsContextType {
     /** Active executions */
     executions: Map<string, FlowsActorsExecution>;
     /** Start a new execution (fire-and-forget via WebSocket; returns local executionId) */
-    startExecution: (systemRef: string, initialInput?: Record<string, unknown>, existingExecutionId?: string) => string | null;
+    /**
+     * Send a turn. A new `executionId` opens a thread; an existing one continues it. The optional
+     * identifiers are folded into the thread's `contextRef` on open (see `fetchConversationHistory`).
+     */
+    startExecution: (systemRef: string, initialInput?: Record<string, unknown>, existingExecutionId?: string, extraContextResourceIdentifiers?: Record<string, string>) => string | null;
     /** Respond to an approval request (fire-and-forget via WebSocket) */
     /**
      * `modifiedToolArgs` (#566) replaces the arguments the agent proposed. Absent means "run the call
@@ -101,7 +135,12 @@ export interface FlowsActorsContextType {
      * sidebar + transcripts on a fresh page load. Returns `[]` when the backend has
      * no flows-actors history surface (feature absent).
      */
-    fetchConversationHistory: (systemRef: string) => Promise<FlowsActors_ConversationHistoryResponse['executions']>;
+    /**
+     * The caller's own threads for a system. With `contextResourceIdentifiers`, only the threads
+     * opened in that context — the same identifiers passed to `startExecution`, canonicalised the
+     * same way — which is how a surface hosting one system for several subjects keeps them apart.
+     */
+    fetchConversationHistory: (systemRef: string, contextResourceIdentifiers?: Record<string, string>) => Promise<FlowsActors_ConversationHistoryResponse['executions']>;
     /**
      * Delete ONE of the caller's own persisted conversations (a discussion). Runs
      * under the caller's auth, so the executions resource's USER_SELF owner filter

package/dist/esm/core/flows-actors/FlowsActorsContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlowsActorsContext.d.ts","sourceRoot":"","sources":["../../../../src/core/flows-actors/FlowsActorsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAA2B,SAAS,EAA2C,MAAM,OAAO,CAAC;AAC3G,OAAO,EACL,4BAA4B,EAM5B,KAAK,uCAAuC,EAU7C,MAAM,uBAAuB,CAAC;AAwD/B;;GAEG;AACH,oBAAY,0BAA0B;IACpC,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,iBAAiB,sBAAsB;IACvC,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,0BAA0B,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;QAChD,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,SAAS,EAAE,IAAI,CAAC;QAChB;;;;;WAKG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QACnD,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,0FAA0F;QAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,WAAW,CAAC,EAAE,IAAI,CAAC;QACnB;;;;WAIG;QACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;KACpC,CAAC;IACF,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,OAAO,EAAE,4BAA4B,EAAE,CAAC;IAExC,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IAEnB,kBAAkB;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,wBAAwB;IACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAE9C,uFAAuF;IACvF,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAE3H,qEAAqE;IACrE;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAEtJ,sDAAsD;IACtD,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAE9C,yFAAyF;IACzF,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,oBAAoB,GAAG,SAAS,CAAC;IAExE,wBAAwB;IACxB,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,4BAA4B,GAAG,SAAS,CAAC;IAE3E,mCAAmC;IACnC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,wBAAwB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,uCAAuC,CAAC,YAAY,CAAC,CAAC,CAAC;IAEhH;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAgE,CAAC;AAElJ;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAwejE,CAAC"}
+{"version":3,"file":"FlowsActorsContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/flows-actors/FlowsActorsContext.tsx"],"names":[],"mappings":"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"}