@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,21 @@
+/**
+ * useFeatures Hook
+ *
+ * Separated from FeaturesContext.tsx for React Fast Refresh compatibility.
+ * Provides access to the feature context: resolved features, definitions, policy, and convenience methods.
+ */
+import { useContext } from 'react';
+import { FeaturesContext } from './FeaturesContext.js';
+/**
+ * Hook to access the Features context.
+ * @returns FeaturesContextType with resolved features, definitions, policy, and convenience methods.
+ * @throws Error if used outside of FeaturesProvider.
+ */
+export const useFeatures = () => {
+    const context = useContext(FeaturesContext);
+    if (!context) {
+        throw new Error('useFeatures must be used within a FeaturesProvider');
+    }
+    return context;
+};
+//# sourceMappingURL=useFeatures.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,71 @@
+/**
+ * useOperationFeatureAvailability Hook
+ *
+ * Resolves feature availability for an operation's `requiredFeatures` config.
+ * Evaluates both boolean features (OR/AND mode) and limit checks.
+ *
+ * For boolean features:
+ *   - OR mode: any single enabled feature is enough
+ *   - AND mode: all features must be enabled
+ *
+ * For limit features:
+ *   - CREATE operations: checks currentUsage + 1 <= limit
+ *   - CREATE_MANY: checks currentUsage < limit (conservative — backend does exact check)
+ *   - Other operations: increment = 0, so limits are not checked
+ *
+ * Returns the "worst" availability result (boolean failure takes precedence over limit failure).
+ */
+import { type RequiredFeaturesConfig, type FeatureUpgradeOption, type FeatureDefinition } from '@wildo-ai/saas-models';
+import type { FrontendResourceConfiguration_Operation } from '../../core/resources/resources.frontend.schemas.js';
+import { useFeatures } from './useFeatures.js';
+import type { FeatureAvailability } from './useFeatureAvailability.js';
+export type { FeatureAvailability };
+/**
+ * Minimal operation-like shape accepted by resolveOperationFeatureAvailability.
+ * Used to wrap view-level requiredFeatures or standalone feature checks
+ * without needing the full FrontendResourceConfiguration_Operation type.
+ *
+ * Cast to FrontendResourceConfiguration_Operation when calling resolveOperationFeatureAvailability:
+ *   `viewCheckable as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation`
+ */
+export interface RequiredFeaturesCheckable {
+    requiredFeatures: RequiredFeaturesConfig;
+    operationIdentifier: string;
+}
+/**
+ * Parameters for the pure resolution function.
+ * Contains all the context needed to resolve feature availability without hooks.
+ */
+export interface ResolveOperationFeatureAvailabilityContext {
+    resolvedFeatures: {
+        features: string[];
+        limits: Record<string, number>;
+        currentUsage: Record<string, number>;
+    };
+    resolvedFeaturesResponse: {
+        upgradeOptions: Record<string, {
+            availableVia: FeatureUpgradeOption[];
+        }>;
+    } | null;
+    featureDefinitions: Map<string, FeatureDefinition>;
+    unavailabilityPolicy: ReturnType<typeof useFeatures>['unavailabilityPolicy'];
+    userRoles: string[];
+    billingEnabled: boolean;
+}
+/**
+ * Pure function to resolve feature availability for an operation's requiredFeatures.
+ * Can be called from hooks (via useMemo) or from batch evaluation effects.
+ *
+ * @param operation - The frontend resource operation configuration
+ * @param ctx - Resolution context (resolved features, definitions, policy, roles)
+ * @returns FeatureAvailability — undefined if no requiredFeatures on the operation
+ */
+export declare function resolveOperationFeatureAvailability(operation: FrontendResourceConfiguration_Operation | null | undefined, ctx: ResolveOperationFeatureAvailabilityContext): FeatureAvailability | undefined;
+/**
+ * Resolve feature availability for an operation's requiredFeatures.
+ *
+ * @param operation - The frontend resource operation configuration
+ * @returns FeatureAvailability — undefined if no requiredFeatures on the operation
+ */
+export declare function useOperationFeatureAvailability(operation: FrontendResourceConfiguration_Operation | null | undefined): FeatureAvailability | undefined;
+//# sourceMappingURL=useOperationFeatureAvailability.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,198 @@
+/**
+ * useOperationFeatureAvailability Hook
+ *
+ * Resolves feature availability for an operation's `requiredFeatures` config.
+ * Evaluates both boolean features (OR/AND mode) and limit checks.
+ *
+ * For boolean features:
+ *   - OR mode: any single enabled feature is enough
+ *   - AND mode: all features must be enabled
+ *
+ * For limit features:
+ *   - CREATE operations: checks currentUsage + 1 <= limit
+ *   - CREATE_MANY: checks currentUsage < limit (conservative — backend does exact check)
+ *   - Other operations: increment = 0, so limits are not checked
+ *
+ * Returns the "worst" availability result (boolean failure takes precedence over limit failure).
+ */
+import { useMemo } from 'react';
+import { FEATURES_UNLIMITED, FeatureValueType, FeatureUnavailabilityBehavior, FeatureUnavailabilityReason, CoreResourceOperation, } from '@wildo-ai/saas-models';
+import { useFeatures } from './useFeatures.js';
+import { useUserOrgs } from '../../core/security/useUserOrgs.js';
+import { useBillingSafe } from '../../core/billing/useBilling.js';
+import { useAppScopeSafe } from '../../core/scope/useAppScope.js';
+import { buildFeaturePolicyRoles, resolveFeatureUnavailabilityBehavior, } from './feature-unavailability.frontend.utils.js';
+/**
+ * Pure function to resolve feature availability for an operation's requiredFeatures.
+ * Can be called from hooks (via useMemo) or from batch evaluation effects.
+ *
+ * @param operation - The frontend resource operation configuration
+ * @param ctx - Resolution context (resolved features, definitions, policy, roles)
+ * @returns FeatureAvailability — undefined if no requiredFeatures on the operation
+ */
+export function resolveOperationFeatureAvailability(operation, ctx) {
+    if (!operation)
+        return undefined;
+    // Normalize requiredFeatures (may be string[] or RequiredFeaturesFullConfig)
+    const raw = operation.requiredFeatures;
+    if (!raw)
+        return undefined;
+    const normalized = Array.isArray(raw)
+        ? { features: raw, mode: 'OR' }
+        : raw;
+    const { resolvedFeatures, resolvedFeaturesResponse, featureDefinitions, unavailabilityPolicy, userRoles, billingEnabled, } = ctx;
+    const resolvedSet = new Set(resolvedFeatures.features);
+    // ── Phase 1: Boolean features ──
+    if (normalized.features && normalized.features.length > 0) {
+        const mode = normalized.mode ?? 'OR';
+        if (mode === 'OR') {
+            // OR: at least one boolean feature must be enabled
+            const booleanFeatures = normalized.features.filter(fId => {
+                const def = featureDefinitions.get(fId);
+                return !def || def.valueType === FeatureValueType.BOOLEAN;
+            });
+            const anyEnabled = booleanFeatures.some(fId => resolvedSet.has(fId));
+            if (booleanFeatures.length > 0 && !anyEnabled) {
+                const missingFeatures = booleanFeatures.filter(fId => !resolvedSet.has(fId));
+                const firstMissing = featureDefinitions.get(missingFeatures[0]);
+                const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;
+                const { behavior } = resolveFeatureUnavailabilityBehavior({
+                    reason,
+                    featureDef: firstMissing,
+                    policy: unavailabilityPolicy,
+                    userRoles,
+                    billingEnabled,
+                });
+                const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[missingFeatures[0]]?.availableVia;
+                return {
+                    isAvailable: false,
+                    reason,
+                    behavior,
+                    missingFeatures,
+                    upgradeOptions,
+                    suggestedProductRef: firstMissing?.unavailability?.suggestedProductRef,
+                };
+            }
+        }
+        else {
+            // AND: all boolean features must be enabled
+            for (const featureId of normalized.features) {
+                const def = featureDefinitions.get(featureId);
+                if (def && def.valueType !== FeatureValueType.BOOLEAN)
+                    continue;
+                if (!resolvedSet.has(featureId)) {
+                    const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;
+                    const { behavior } = resolveFeatureUnavailabilityBehavior({
+                        reason,
+                        featureDef: def,
+                        policy: unavailabilityPolicy,
+                        userRoles,
+                        billingEnabled,
+                    });
+                    const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;
+                    return {
+                        isAvailable: false,
+                        reason,
+                        behavior,
+                        missingFeatures: [featureId],
+                        upgradeOptions,
+                        suggestedProductRef: def?.unavailability?.suggestedProductRef,
+                    };
+                }
+            }
+        }
+    }
+    // ── Phase 2: Limit checks ──
+    if (normalized.limitChecks && normalized.limitChecks.length > 0) {
+        const operationId = operation.operationIdentifier;
+        for (const check of normalized.limitChecks) {
+            const limit = resolvedFeatures.limits[check.featureId];
+            // No limit or unlimited → pass
+            if (limit === undefined || limit === FEATURES_UNLIMITED)
+                continue;
+            const currentUsage = resolvedFeatures.currentUsage[check.featureId] ?? 0;
+            // Infer increment (frontend-side: same logic as backend, conservative for CREATE_MANY)
+            let increment;
+            if (check.increment !== undefined) {
+                increment = check.increment;
+            }
+            else if (operationId === CoreResourceOperation.CREATE) {
+                increment = 1;
+            }
+            else if (operationId === CoreResourceOperation.CREATE_MANY) {
+                increment = 1; // Conservative — backend does exact check
+            }
+            else {
+                increment = 0;
+            }
+            if (increment === 0)
+                continue;
+            if (currentUsage + increment > limit) {
+                const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;
+                const featureDef = featureDefinitions.get(check.featureId);
+                const { behavior } = resolveFeatureUnavailabilityBehavior({
+                    reason,
+                    featureDef,
+                    policy: unavailabilityPolicy,
+                    userRoles,
+                    billingEnabled,
+                });
+                const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[check.featureId]?.availableVia;
+                return {
+                    isAvailable: false,
+                    reason,
+                    behavior,
+                    limitInfo: { featureId: check.featureId, current: currentUsage, limit },
+                    upgradeOptions,
+                    suggestedProductRef: featureDef?.unavailability?.suggestedProductRef,
+                };
+            }
+        }
+    }
+    // All checks passed
+    return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };
+}
+// ================================
+// Hook (convenience wrapper over pure function)
+// ================================
+/**
+ * Resolve feature availability for an operation's requiredFeatures.
+ *
+ * @param operation - The frontend resource operation configuration
+ * @returns FeatureAvailability — undefined if no requiredFeatures on the operation
+ */
+export function useOperationFeatureAvailability(operation) {
+    const { resolvedFeatures, resolvedFeaturesResponse, featureDefinitions, unavailabilityPolicy, isLoading, } = useFeatures();
+    const { permissions } = useUserOrgs();
+    const billing = useBillingSafe();
+    const appScope = useAppScopeSafe();
+    return useMemo(() => {
+        // While loading, treat as available (optimistic — prevents flash of locked UI)
+        if (isLoading) {
+            return operation?.requiredFeatures
+                ? { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE }
+                : undefined;
+        }
+        // Build user roles for policy resolution
+        const userRoles = buildFeaturePolicyRoles(permissions, appScope?.currentOrganizationId ?? null);
+        return resolveOperationFeatureAvailability(operation, {
+            resolvedFeatures,
+            resolvedFeaturesResponse,
+            featureDefinitions,
+            unavailabilityPolicy,
+            userRoles,
+            billingEnabled: billing?.isEnabled ?? false,
+        });
+    }, [
+        operation,
+        isLoading,
+        resolvedFeatures,
+        resolvedFeaturesResponse,
+        featureDefinitions,
+        unavailabilityPolicy,
+        permissions,
+        appScope?.currentOrganizationId,
+        billing?.isEnabled,
+    ]);
+}
+//# sourceMappingURL=useOperationFeatureAvailability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOperationFeatureAvailability.js","sourceRoot":"","sources":["../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,GAKtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EACL,uBAAuB,EACvB,oCAAoC,GACrC,MAAM,yCAAyC,CAAC;AAmCjD;;;;;;;GAOG;AACH,MAAM,UAAU,mCAAmC,CACjD,SAAqE,EACrE,GAA+C;IAE/C,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjC,6EAA6E;IAC7E,MAAM,GAAG,GAAG,SAAS,CAAC,gBAAgB,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,MAAM,UAAU,GAA+B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAC/D,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE;QAC/B,CAAC,CAAC,GAAG,CAAC;IAER,MAAM,EACJ,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,cAAc,GACf,GAAG,GAAG,CAAC;IACR,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEvD,kCAAkC;IAClC,IAAI,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC;QAErC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,mDAAmD;YACnD,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBACvD,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACxC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,KAAK,gBAAgB,CAAC,OAAO,CAAC;YAC5D,CAAC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC9C,MAAM,eAAe,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7E,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChE,MAAM,MAAM,GAAG,2BAA2B,CAAC,mBAAmB,CAAC;gBAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,oCAAoC,CAAC;oBACxD,MAAM;oBACN,UAAU,EAAE,YAAY;oBACxB,MAAM,EAAE,oBAAoB;oBAC5B,SAAS;oBACT,cAAc;iBACf,CAAC,CAAC;gBACH,MAAM,cAAc,GAAG,wBAAwB,EAAE,cAAc,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC;gBAEpG,OAAO;oBACL,WAAW,EAAE,KAAK;oBAClB,MAAM;oBACN,QAAQ;oBACR,eAAe;oBACf,cAAc;oBACd,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,mBAAmB;iBACvE,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,4CAA4C;YAC5C,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;gBAC5C,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC9C,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,KAAK,gBAAgB,CAAC,OAAO;oBAAE,SAAS;gBAEhE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBAChC,MAAM,MAAM,GAAG,2BAA2B,CAAC,mBAAmB,CAAC;oBAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,oCAAoC,CAAC;wBACxD,MAAM;wBACN,UAAU,EAAE,GAAG;wBACf,MAAM,EAAE,oBAAoB;wBAC5B,SAAS;wBACT,cAAc;qBACf,CAAC,CAAC;oBACH,MAAM,cAAc,GAAG,wBAAwB,EAAE,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;oBAE3F,OAAO;wBACL,WAAW,EAAE,KAAK;wBAClB,MAAM;wBACN,QAAQ;wBACR,eAAe,EAAE,CAAC,SAAS,CAAC;wBAC5B,cAAc;wBACd,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE,mBAAmB;qBAC9D,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,WAAW,GAAG,SAAS,CAAC,mBAA6B,CAAC;QAE5D,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAEvD,+BAA+B;YAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,kBAAkB;gBAAE,SAAS;YAElE,MAAM,YAAY,GAAG,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAEzE,uFAAuF;YACvF,IAAI,SAAiB,CAAC;YACtB,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAClC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YAC9B,CAAC;iBAAM,IAAI,WAAW,KAAK,qBAAqB,CAAC,MAAM,EAAE,CAAC;gBACxD,SAAS,GAAG,CAAC,CAAC;YAChB,CAAC;iBAAM,IAAI,WAAW,KAAK,qBAAqB,CAAC,WAAW,EAAE,CAAC;gBAC7D,SAAS,GAAG,CAAC,CAAC,CAAC,0CAA0C;YAC3D,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,CAAC,CAAC;YAChB,CAAC;YAED,IAAI,SAAS,KAAK,CAAC;gBAAE,SAAS;YAE9B,IAAI,YAAY,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,2BAA2B,CAAC,cAAc,CAAC;gBAC1D,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC3D,MAAM,EAAE,QAAQ,EAAE,GAAG,oCAAoC,CAAC;oBACxD,MAAM;oBACN,UAAU;oBACV,MAAM,EAAE,oBAAoB;oBAC5B,SAAS;oBACT,cAAc;iBACf,CAAC,CAAC;gBACH,MAAM,cAAc,GAAG,wBAAwB,EAAE,cAAc,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;gBAEjG,OAAO;oBACL,WAAW,EAAE,KAAK;oBAClB,MAAM;oBACN,QAAQ;oBACR,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE;oBACvE,cAAc;oBACd,mBAAmB,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB;iBACrE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,6BAA6B,CAAC,OAAO,EAAE,CAAC;AAChF,CAAC;AAED,mCAAmC;AACnC,gDAAgD;AAChD,mCAAmC;AAEnC;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,SAAqE;IAErE,MAAM,EACJ,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,GACV,GAAG,WAAW,EAAE,CAAC;IAElB,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IAEnC,OAAO,OAAO,CAAC,GAAoC,EAAE;QACnD,+EAA+E;QAC/E,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,EAAE,gBAAgB;gBAChC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,6BAA6B,CAAC,OAAO,EAAE;gBACxE,CAAC,CAAC,SAAS,CAAC;QAChB,CAAC;QAED,yCAAyC;QACzC,MAAM,SAAS,GAAG,uBAAuB,CACvC,WAAW,EACX,QAAQ,EAAE,qBAAqB,IAAI,IAAI,CACxC,CAAC;QAEF,OAAO,mCAAmC,CAAC,SAAS,EAAE;YACpD,gBAAgB;YAChB,wBAAwB;YACxB,kBAAkB;YAClB,oBAAoB;YACpB,SAAS;YACT,cAAc,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK;SAC5C,CAAC,CAAC;IACL,CAAC,EAAE;QACD,SAAS;QACT,SAAS;QACT,gBAAgB;QAChB,wBAAwB;QACxB,kBAAkB;QAClB,oBAAoB;QACpB,WAAW;QACX,QAAQ,EAAE,qBAAqB;QAC/B,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,83 @@
+import React, { ReactNode } from 'react';
+import { FlowActorSystem_FrontendInfo } from '@wildo-ai/saas-models';
+/**
+ * FlowsActors Execution Status
+ */
+export declare enum FlowsActorsExecutionStatus {
+    IDLE = "idle",
+    STARTING = "starting",
+    RUNNING = "running",
+    AWAITING_APPROVAL = "awaiting_approval",
+    COMPLETED = "completed",
+    ERROR = "error"
+}
+/**
+ * Active Execution State
+ */
+export interface FlowsActorsExecution {
+    executionId: string;
+    systemRef: string;
+    status: FlowsActorsExecutionStatus;
+    progress?: number;
+    currentStep?: string;
+    messages: Array<{
+        type: 'text' | 'markdown' | 'progress' | 'data';
+        content: string;
+        data?: Record<string, unknown>;
+        timestamp: Date;
+    }>;
+    pendingApproval?: {
+        approvalId: string;
+        actionDescription: string;
+        riskLevel: 'low' | 'medium' | 'high' | 'critical';
+        expiresAt?: Date;
+        requiredRoles?: string[];
+    };
+    /** Set when the last error is recoverable (UI can offer a retry action) */
+    recoverable?: boolean;
+    result?: Record<string, unknown>;
+    duration?: number;
+    errorCode?: string;
+}
+/**
+ * FlowsActors Context Type
+ */
+export interface FlowsActorsContextType {
+    /** Available frontend-visible FlowActorSystems */
+    systems: FlowActorSystem_FrontendInfo[];
+    /** Loading state */
+    isLoading: boolean;
+    /** Error state */
+    error: Error | null;
+    /** 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>) => string | null;
+    /** Respond to an approval request (fire-and-forget via WebSocket) */
+    respondToApproval: (executionId: string, approvalId: string, approved: boolean, comment?: string) => void;
+    /** Remove a completed/errored execution from state */
+    clearExecution: (executionId: string) => void;
+    /** Get execution by ID (reads from ref; consume `executions` to re-render on changes) */
+    getExecution: (executionId: string) => FlowsActorsExecution | undefined;
+    /** Get system by ref */
+    getSystem: (systemRef: string) => FlowActorSystem_FrontendInfo | undefined;
+    /** Refresh systems from backend */
+    refreshSystems: () => Promise<void>;
+}
+/**
+ * FlowsActors Context
+ * @internal - Use useFlowsActors() hook instead of accessing this directly
+ */
+export declare const FlowsActorsContext: React.Context<FlowsActorsContextType | undefined>;
+/**
+ * FlowsActors Provider
+ *
+ * Manages:
+ * - Available FlowActorSystems (fetched at startup)
+ * - Active execution state
+ * - WebSocket communication for real-time updates
+ */
+export declare const FlowsActorsProvider: React.FC<{
+    children: ReactNode;
+}>;
+//# sourceMappingURL=FlowsActorsContext.d.ts.map

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

@@ -0,0 +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,EAY7B,MAAM,uBAAuB,CAAC;AAsB/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;KACjB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QAClD,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,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,KAAK,MAAM,GAAG,IAAI,CAAC;IAE7F,qEAAqE;IACrE,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1G,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;CACrC;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,CAoWjE,CAAC"}