@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/core/config/config-merge-utilities.js

@@ -0,0 +1,242 @@
+/**
+ * Configuration Merge Utilities
+ *
+ * Explicit merge functions for composing preset + app config. The engine
+ * never merges implicitly — these are functions the app calls at config
+ * time to produce a single flat configuration.
+ *
+ * All utilities follow the same semantic: **replace-by-ref on collision,
+ * append new.** The `app` argument always wins over the `base` argument
+ * on key collisions.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   mergeAppScope, mergeAppModes, mergeSidebarSections,
+ *   ApplicationLevelComponentType,
+ * } from '@wildo-ai/saas-frontend-lib';
+ *
+ * // Compose a kit preset with app-specific overrides.
+ * // Each merge utility produces a flat array/object — pass the result
+ * // directly into the AppConfiguration_Frontend config object.
+ * const frontendConfig: AppConfiguration_Frontend = {
+ *   // ...other config...
+ *   appScope: mergeAppScope(kitPreset.appScope, { fields: myAppScopeFields }),
+ *   appModes: mergeAppModes(kitPreset.appModes, myAppModes),
+ *   appComponentsConfiguration: {
+ *     ...kitPreset.appComponentsConfiguration,
+ *     [ApplicationLevelComponentType.SIDEBAR]: {
+ *       ...kitPreset.appComponentsConfiguration.sidebar,
+ *       contentSections: mergeSidebarSections(
+ *         kitPreset.sidebarSections,
+ *         myAppSections,
+ *       ),
+ *     },
+ *   },
+ * };
+ * ```
+ *
+ * @see component-taxonomy-deep-review.md §7.8
+ * @see app-shell-implementation-plan.md Step 8
+ */
+import { LauncherItemTargetKind, SidebarSectionContentKind } from './launcher-items.frontend.schemas.js';
+// ════════════════════════════════════════════════════════════════
+// Generic merge-by-key helper
+// ════════════════════════════════════════════════════════════════
+/**
+ * Merges two arrays by a key field. Items from `override` replace items
+ * from `base` on key collision. Items unique to either array are preserved.
+ * Order: base items first (with overrides applied in-place), then
+ * override-only items appended at the end.
+ *
+ * **Invariant:** Keys must be unique within each input array. If duplicates
+ * exist in `base`, only the first occurrence is kept. If duplicates exist
+ * in `override`, only the last occurrence wins (Map semantics).
+ */
+function mergeByKey(base, override, keyFn) {
+    const overrideMap = new Map();
+    for (const item of override) {
+        overrideMap.set(keyFn(item), item);
+    }
+    const result = [];
+    const emittedKeys = new Set();
+    for (const baseItem of base) {
+        const key = keyFn(baseItem);
+        if (emittedKeys.has(key))
+            continue;
+        emittedKeys.add(key);
+        if (overrideMap.has(key)) {
+            result.push(overrideMap.get(key));
+        }
+        else {
+            result.push(baseItem);
+        }
+    }
+    for (const overrideItem of override) {
+        const key = keyFn(overrideItem);
+        if (!emittedKeys.has(key)) {
+            emittedKeys.add(key);
+            result.push(overrideItem);
+        }
+    }
+    return result;
+}
+/**
+ * Merges two `appScope` configurations.
+ *
+ * **Merge key:** `fieldIdentifier`
+ * **Semantics:** App fields win on collision. Base-only fields preserved.
+ *
+ * @param base   - Base scope config (e.g., from a kit preset)
+ * @param override - App-specific scope config (wins on collision)
+ * @returns Merged scope config
+ */
+export function mergeAppScope(base, override) {
+    if (!base && !override)
+        return {};
+    if (!base)
+        return { ...override };
+    if (!override)
+        return { ...base };
+    const baseFields = base.fields ?? [];
+    const overrideFields = override.fields ?? [];
+    if (baseFields.length === 0 && overrideFields.length === 0) {
+        return {};
+    }
+    return {
+        fields: mergeByKey(baseFields, overrideFields, f => f.fieldIdentifier),
+    };
+}
+// ════════════════════════════════════════════════════════════════
+// mergeAppModes
+// ════════════════════════════════════════════════════════════════
+/**
+ * Merges two `appModes` arrays.
+ *
+ * **Merge key:** `ref`
+ * **Semantics:** App modes win on collision. Base-only modes preserved.
+ *
+ * @param base   - Base modes array (e.g., from a kit preset)
+ * @param override - App-specific modes array (wins on collision)
+ * @returns Merged modes array
+ */
+export function mergeAppModes(base, override) {
+    if (!base && !override)
+        return [];
+    if (!base)
+        return [...(override ?? [])];
+    if (!override)
+        return [...(base ?? [])];
+    return mergeByKey(base, override, m => m.ref);
+}
+// ════════════════════════════════════════════════════════════════
+// mergeSidebarSections
+// ════════════════════════════════════════════════════════════════
+/**
+ * Merges two `contentSections` arrays.
+ *
+ * **Merge key:** `ref`
+ * **Semantics:** App sections **replace** base sections on collision
+ * (full section replace, no item-level deep merge). Base-only sections
+ * preserved.
+ *
+ * @param base   - Base sections array (e.g., from a kit preset)
+ * @param override - App-specific sections array (wins on collision)
+ * @returns Merged sections array
+ */
+export function mergeSidebarSections(base, override) {
+    if (!base && !override)
+        return [];
+    if (!base)
+        return [...(override ?? [])];
+    if (!override)
+        return [...(base ?? [])];
+    return mergeByKey(base, override, s => s.ref);
+}
+export function mergeQuickSwitcherFields(base, extra) {
+    const seen = new Set();
+    const merged = [];
+    for (const field of [...base, ...extra]) {
+        if (seen.has(field.fieldIdentifier)) {
+            continue;
+        }
+        seen.add(field.fieldIdentifier);
+        merged.push(field);
+    }
+    return merged;
+}
+// ════════════════════════════════════════════════════════════════
+// Launcher item keys & command / sidebar append helpers
+// ════════════════════════════════════════════════════════════════
+/**
+ * Stable key for deduping launcher rows (sidebar children, command list, etc.).
+ */
+export function launcherItemRefKey(item) {
+    switch (item.kind) {
+        case LauncherItemTargetKind.RESOURCE_OPERATION:
+            return `resource_operation:${item.resourceType}:${item.operation}:${item.operationVariant ?? 'default'}`;
+        case LauncherItemTargetKind.VIEW:
+            return `${item.kind}:${item.viewRef}`;
+        case LauncherItemTargetKind.RESOURCE_VIEW:
+            return `${item.kind}:${item.resourceType}:${item.viewRef}`;
+        case LauncherItemTargetKind.ENGINE_PAGE:
+            return `engine_page:${item.pageRef}`;
+        case LauncherItemTargetKind.CUSTOM_COMPONENT:
+            return `custom_component:${item.componentRef}`;
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Appends sidebar navigation children to the `NAVIGATION_LIST` section with `sectionRef`.
+ * Skips items whose `launcherItemRefKey` already exists under that section (idempotent).
+ */
+export function appendNavChildrenToSidebarSection(sections, sectionRef, items) {
+    if (!sections?.length)
+        return sections ?? [];
+    if (!items.length)
+        return [...sections];
+    return sections.map(section => {
+        if (section.ref !== sectionRef || section.contentKind !== SidebarSectionContentKind.NAVIGATION_LIST) {
+            return section;
+        }
+        const nav = section;
+        const existing = new Set(nav.children.map(launcherItemRefKey));
+        const toAdd = items.filter(i => !existing.has(launcherItemRefKey(i)));
+        if (toAdd.length === 0)
+            return section;
+        return { ...nav, children: [...nav.children, ...toAdd] };
+    });
+}
+/**
+ * Merges command menu command arrays by `launcherItemRefKey` — override wins on collision.
+ */
+export function mergeCommandMenuCommandLists(base, extra) {
+    if (!base?.length)
+        return [...(extra ?? [])];
+    if (!extra?.length)
+        return [...base];
+    return mergeByKey(base, extra, launcherItemRefKey);
+}
+/**
+ * Merges menubar launcher rows by launcher identity + menubar group.
+ * Override wins on collision.
+ */
+export function mergeMenubarLauncherItems(base, extra) {
+    if (!base?.length)
+        return [...(extra ?? [])];
+    if (!extra?.length)
+        return [...base];
+    return mergeByKey(base, extra, item => `${launcherItemRefKey(item)}:${item.group ?? 'default'}`);
+}
+/**
+ * Merges `fullCustomViews` by `ref` — override wins on collision.
+ */
+export function mergeFullCustomViewsByRef(base, extra) {
+    if (!base?.length)
+        return [...(extra ?? [])];
+    if (!extra?.length)
+        return [...base];
+    return mergeByKey(base, extra, v => v.ref);
+}
+//# sourceMappingURL=config-merge-utilities.js.map

package/dist/esm/core/config/config-merge-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-merge-utilities.js","sourceRoot":"","sources":["../../../../src/core/config/config-merge-utilities.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/config/execution-view.schemas.d.ts

@@ -0,0 +1,127 @@
+import type React from 'react';
+import { z } from 'zod';
+import { CoreResourceOperation, ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';
+import { FrontendView_ScopeMode } from './views-frontend.schemas.js';
+import { type FrontendInsertedViewIdentity } from './inserted-view.frontend.schemas.js';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas.js';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas.js';
+export declare enum ExecutionViewAnchorBindingSource {
+    PARENT_RESOURCE_REQUIREMENT = "parent-resource-requirement",
+    ADDITIONAL_RESOURCE_REQUIREMENT = "additional-resource-requirement"
+}
+/**
+ * Declarative anchor contract for execution views.
+ *
+ * The anchor must point to one stable declared binding key instead of relying on
+ * requirement-array ordering or "first matching requirement" inference.
+ */
+export declare const ExecutionViewAnchorDefinitionSchema: z.ZodObject<{
+    bindingKey: z.ZodString;
+    source: z.ZodEnum<typeof ExecutionViewAnchorBindingSource>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export interface ExecutionViewAnchorDefinition {
+    bindingKey: string;
+    source: ExecutionViewAnchorBindingSource;
+}
+export interface ExecutionViewComponentProps {
+    viewRef: string;
+    viewDefinition: ExecutionViewDefinition;
+    contextResourceIdentifiers: Record<string, string>;
+}
+export declare const ExecutionViewDefinitionSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    scope: z.ZodLiteral<FrontendView_ScopeMode.APPLICATION>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    scope: z.ZodLiteral<FrontendView_ScopeMode.RESOURCE>;
+    parentResourcesRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
+        foreignKeyField: z.ZodOptional<z.ZodString>;
+        childResourceType: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>>;
+        relationshipEdgeKey: z.ZodOptional<z.ZodString>;
+        requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
+        isPrimaryScope: z.ZodBoolean;
+        primaryScope: z.ZodOptional<z.ZodEnum<typeof ResourcePrimaryScope>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    additionalResourceRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
+        foreignKeyField: z.ZodOptional<z.ZodString>;
+        childResourceType: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>>;
+        relationshipEdgeKey: z.ZodOptional<z.ZodString>;
+        requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
+        isPrimaryScope: z.ZodBoolean;
+        primaryScope: z.ZodOptional<z.ZodEnum<typeof ResourcePrimaryScope>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+}, z.core.$strip, core.$ZodObjectExtra>], "scope">, z.ZodObject<{
+    ref: z.ZodString;
+    isAddressable: z.ZodDefault<z.ZodBoolean>;
+    operationLike: z.ZodDefault<z.ZodEnum<typeof CoreResourceOperation>>;
+    primaryScope: z.ZodDefault<z.ZodEnum<typeof ResourcePrimaryScope>>;
+    anchor: z.ZodOptional<z.ZodObject<{
+        bindingKey: z.ZodString;
+        source: z.ZodEnum<typeof ExecutionViewAnchorBindingSource>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    viewComponent: z.ZodAny;
+    requiredFeatures: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+        features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            OR: "OR";
+            AND: "AND";
+        }>>;
+        limitChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            featureId: z.ZodString;
+            increment: z.ZodOptional<z.ZodNumber>;
+            countingOverride: z.ZodOptional<z.ZodObject<{
+                resourceType: z.ZodString;
+                filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                aggregate: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    operation: z.ZodEnum<typeof import("@wildo-ai/saas-models").AggregationOperation>;
+                }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip, core.$ZodObjectExtra>]>>;
+}, z.core.$strip, core.$ZodObjectExtra>>;
+export interface ExecutionViewDefinition {
+    scope: FrontendView_ScopeMode;
+    parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
+    additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];
+    ref: string;
+    isAddressable: boolean;
+    operationLike: CoreResourceOperation;
+    primaryScope: ResourcePrimaryScope;
+    anchor?: ExecutionViewAnchorDefinition;
+    viewComponent: React.ComponentType<ExecutionViewComponentProps>;
+    /** Required features for this view — gates navigation + route access */
+    requiredFeatures?: RequiredFeaturesConfig;
+}
+export declare const EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = "execution_ctx_";
+export interface ResourceExecutionViewAuthoringConfig {
+    isAddressable?: boolean;
+    operationLike?: CoreResourceOperation;
+    primaryScope?: ResourcePrimaryScope;
+    anchor?: ExecutionViewAnchorDefinition;
+    parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
+    additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];
+    viewComponent: React.ComponentType<ExecutionViewComponentProps>;
+    requiredFeatures?: RequiredFeaturesConfig;
+}
+export type ResourceExecutionViewsConfig = Record<string, ResourceExecutionViewAuthoringConfig>;
+export type InsertedExecutionDeclaration = ExecutionViewDefinition;
+/**
+ * Small authoring helper for resource-owned execution views.
+ *
+ * Keeps execution declarations terse at the resource UIBehavior level while
+ * preserving execution-specific semantics such as anchors and explicit resource
+ * requirements.
+ */
+export declare function resourceExecutionView(viewComponent: React.ComponentType<ExecutionViewComponentProps>, config?: Omit<ResourceExecutionViewAuthoringConfig, 'viewComponent'>): ResourceExecutionViewAuthoringConfig;
+export declare function isStandaloneRoutableExecutionView(executionView: ExecutionViewDefinition | undefined): boolean;
+export declare function isStandaloneRoutableInsertedExecutionView(executionView: ExecutionViewDefinition | undefined): boolean;
+export declare function buildResourceInsertedExecutionIdentity(resourceType: string, executionView: Pick<ExecutionViewDefinition, 'ref'>): FrontendInsertedViewIdentity;
+export declare function resolveExecutionViewDefinition(params: {
+    viewRef: string | undefined;
+    registry?: FrontendResourcesRegistry;
+}): ExecutionViewDefinition | undefined;
+export declare function buildExecutionRouteUrlPath(viewRef: string, contextResourceIdentifiers?: Record<string, string>): string;
+export declare function extractExecutionRouteContextResourceIdentifiers(searchParams: URLSearchParams): Record<string, string> | undefined;
+//# sourceMappingURL=execution-view.schemas.d.ts.map

package/dist/esm/core/config/execution-view.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-view.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/config/execution-view.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/config/execution-view.schemas.js

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import { CoreResourceOperation, ResourcePrimaryScope, RequiredFeaturesConfigSchema, } from '@wildo-ai/saas-models';
+import { FrontendView_DefinitionSchema, FrontendView_ScopeMode, } from './views-frontend.schemas.js';
+import { FrontendInsertedViewHostKind, FrontendInsertedViewKind, createFrontendInsertedViewIdentity, parseFrontendInsertedViewRef, } from './inserted-view.frontend.schemas.js';
+//===============================================================
+//  ExecutionView
+// --------
+// A first-class frontend view family for rich execution surfaces.
+// Phase A1 intentionally keeps this contract thin: it only declares
+// the routed/configurable host-family shape, not the richer runtime DSL.
+//===============================================================
+export var ExecutionViewAnchorBindingSource;
+(function (ExecutionViewAnchorBindingSource) {
+    ExecutionViewAnchorBindingSource["PARENT_RESOURCE_REQUIREMENT"] = "parent-resource-requirement";
+    ExecutionViewAnchorBindingSource["ADDITIONAL_RESOURCE_REQUIREMENT"] = "additional-resource-requirement";
+})(ExecutionViewAnchorBindingSource || (ExecutionViewAnchorBindingSource = {}));
+/**
+ * Declarative anchor contract for execution views.
+ *
+ * The anchor must point to one stable declared binding key instead of relying on
+ * requirement-array ordering or "first matching requirement" inference.
+ */
+export const ExecutionViewAnchorDefinitionSchema = z.object({
+    bindingKey: z.string().min(1),
+    source: z.enum(ExecutionViewAnchorBindingSource),
+});
+export const ExecutionViewDefinitionSchema = z.intersection(FrontendView_DefinitionSchema, z.object({
+    /** Unique view reference (used in URL: /execution/:viewRef once routing is wired) */
+    ref: z.string().min(1),
+    /** Whether this view can be accessed via URL */
+    isAddressable: z.boolean().default(false),
+    /** Operation-like behavior for navigation purposes */
+    operationLike: z.enum(CoreResourceOperation).default(CoreResourceOperation.READ),
+    /** Primary scope for context injection */
+    primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),
+    /**
+     * Optional declarative anchor contract.
+     *
+     * When present, the runtime resolves the execution subject only from the
+     * explicitly declared binding key and only from explicit navigation-time
+     * context bindings.
+     */
+    anchor: ExecutionViewAnchorDefinitionSchema.optional(),
+    /**
+     * Direct authored execution view component.
+     *
+     * App-authored execution views link directly to the React component.
+     */
+    viewComponent: z.any(),
+    /** Required features for this view — gates navigation + route access via feature availability policy */
+    requiredFeatures: RequiredFeaturesConfigSchema.optional(),
+}));
+export const EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'execution_ctx_';
+/**
+ * Small authoring helper for resource-owned execution views.
+ *
+ * Keeps execution declarations terse at the resource UIBehavior level while
+ * preserving execution-specific semantics such as anchors and explicit resource
+ * requirements.
+ */
+export function resourceExecutionView(viewComponent, config = {}) {
+    return {
+        ...config,
+        viewComponent,
+    };
+}
+export function isStandaloneRoutableExecutionView(executionView) {
+    return executionView?.isAddressable === true;
+}
+export function isStandaloneRoutableInsertedExecutionView(executionView) {
+    return (executionView?.isAddressable === true
+        && executionView.scope === FrontendView_ScopeMode.RESOURCE);
+}
+export function buildResourceInsertedExecutionIdentity(resourceType, executionView) {
+    return createFrontendInsertedViewIdentity({
+        hostKind: FrontendInsertedViewHostKind.RESOURCE,
+        hostRef: resourceType,
+        viewKind: FrontendInsertedViewKind.EXECUTION_VIEW,
+        localRef: executionView.ref,
+    });
+}
+export function resolveExecutionViewDefinition(params) {
+    const { viewRef, registry } = params;
+    if (!viewRef) {
+        return undefined;
+    }
+    const insertedIdentity = parseFrontendInsertedViewRef(viewRef);
+    if (!insertedIdentity
+        || insertedIdentity.hostKind !== FrontendInsertedViewHostKind.RESOURCE
+        || insertedIdentity.viewKind !== FrontendInsertedViewKind.EXECUTION_VIEW) {
+        return undefined;
+    }
+    return registry?.resourceConfigurations[insertedIdentity.hostRef]
+        ?.frontendConfiguration
+        ?.executionViews
+        ?.find((candidate) => candidate.ref === insertedIdentity.localRef);
+}
+export function buildExecutionRouteUrlPath(viewRef, contextResourceIdentifiers) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(contextResourceIdentifiers ?? {})) {
+        if (!value) {
+            continue;
+        }
+        params.set(`${EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX}${key}`, value);
+    }
+    const search = params.toString();
+    return search.length > 0 ? `/execution/${viewRef}?${search}` : `/execution/${viewRef}`;
+}
+export function extractExecutionRouteContextResourceIdentifiers(searchParams) {
+    const contextResourceIdentifiers = {};
+    for (const [key, value] of searchParams.entries()) {
+        if (!key.startsWith(EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX) || !value) {
+            continue;
+        }
+        contextResourceIdentifiers[key.slice(EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX.length)] = value;
+    }
+    return Object.keys(contextResourceIdentifiers).length > 0 ? contextResourceIdentifiers : undefined;
+}
+//# sourceMappingURL=execution-view.schemas.js.map

package/dist/esm/core/config/execution-view.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-view.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/execution-view.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/config/flows-actors-view.schemas.d.ts

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { CoreResourceOperation, ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';
+import { FrontendView_ScopeMode } from './views-frontend.schemas.js';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas.js';
+export declare const FlowsActorsViewDefinitionSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    scope: z.ZodLiteral<FrontendView_ScopeMode.APPLICATION>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    scope: z.ZodLiteral<FrontendView_ScopeMode.RESOURCE>;
+    parentResourcesRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
+        foreignKeyField: z.ZodOptional<z.ZodString>;
+        childResourceType: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>>;
+        relationshipEdgeKey: z.ZodOptional<z.ZodString>;
+        requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
+        isPrimaryScope: z.ZodBoolean;
+        primaryScope: z.ZodOptional<z.ZodEnum<typeof ResourcePrimaryScope>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    additionalResourceRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
+        foreignKeyField: z.ZodOptional<z.ZodString>;
+        childResourceType: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>>;
+        relationshipEdgeKey: z.ZodOptional<z.ZodString>;
+        requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
+        isPrimaryScope: z.ZodBoolean;
+        primaryScope: z.ZodOptional<z.ZodEnum<typeof ResourcePrimaryScope>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+}, z.core.$strip, core.$ZodObjectExtra>], "scope">, z.ZodObject<{
+    ref: z.ZodString;
+    isAddressable: z.ZodDefault<z.ZodBoolean>;
+    operationLike: z.ZodDefault<z.ZodEnum<typeof CoreResourceOperation>>;
+    primaryScope: z.ZodDefault<z.ZodEnum<typeof ResourcePrimaryScope>>;
+    systemRefs: z.ZodArray<z.ZodString>;
+    layoutPreset: z.ZodDefault<z.ZodString>;
+    requiredFeatures: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+        features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            OR: "OR";
+            AND: "AND";
+        }>>;
+        limitChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            featureId: z.ZodString;
+            increment: z.ZodOptional<z.ZodNumber>;
+            countingOverride: z.ZodOptional<z.ZodObject<{
+                resourceType: z.ZodString;
+                filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                aggregate: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    operation: z.ZodEnum<typeof import("@wildo-ai/saas-models").AggregationOperation>;
+                }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip, core.$ZodObjectExtra>]>>;
+}, z.core.$strip, core.$ZodObjectExtra>>;
+export interface FlowsActorsViewDefinition {
+    scope: FrontendView_ScopeMode;
+    parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
+    additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];
+    ref: string;
+    isAddressable: boolean;
+    operationLike: CoreResourceOperation;
+    primaryScope: ResourcePrimaryScope;
+    systemRefs: string[];
+    layoutPreset: string;
+    /** Required features for this view — gates navigation + route access */
+    requiredFeatures?: RequiredFeaturesConfig;
+}
+//# sourceMappingURL=flows-actors-view.schemas.d.ts.map

package/dist/esm/core/config/flows-actors-view.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows-actors-view.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/config/flows-actors-view.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAgC,MAAM,uBAAuB,CAAC;AAClH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAUpI,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAwC+tL,IAAK,CAAC,eAAe;8BAA6B,IAAK,CAAC,eAAe;0BAAyB,IAAK,CAAC,eAAe;;wCAhB/3L,CAAC;AAGF,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,qBAAqB,CAAC;IACrC,YAAY,EAAE,oBAAoB,CAAC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C"}

package/dist/esm/core/config/flows-actors-view.schemas.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { CoreResourceOperation, ResourcePrimaryScope, RequiredFeaturesConfigSchema } from '@wildo-ai/saas-models';
+import { FrontendView_DefinitionSchema } from './views-frontend.schemas.js';
+//===============================================================
+//  FlowsActorsView
+// --------
+// A view that exposes one or more FlowActorSystems to the user.
+// Used for conversation interfaces, human-in-the-loop interactions,
+// and workflow orchestration.
+//===============================================================
+export const FlowsActorsViewDefinitionSchema = z.intersection(FrontendView_DefinitionSchema, z.object({
+    /** Unique view reference (used in URL: /flows-actors/:viewRef) */
+    ref: z.string().min(1),
+    /** Whether this view can be accessed via URL */
+    isAddressable: z.boolean().default(false),
+    /** Operation-like behavior for navigation purposes */
+    operationLike: z.enum(CoreResourceOperation).default(CoreResourceOperation.READ),
+    /** Primary scope for context injection */
+    primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),
+    /** FlowActorSystem references to expose in this view */
+    systemRefs: z.array(z.string().min(1)).min(1),
+    /** Layout preset from component registry (Default, Compact, etc.) */
+    layoutPreset: z.string().default('Default'),
+    /** Required features for this view — gates navigation + route access via feature availability policy */
+    requiredFeatures: RequiredFeaturesConfigSchema.optional(),
+}));
+//# sourceMappingURL=flows-actors-view.schemas.js.map

package/dist/esm/core/config/flows-actors-view.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows-actors-view.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/flows-actors-view.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAElH,OAAO,EAAE,6BAA6B,EAA0B,MAAM,0BAA0B,CAAC;AAGjG,iEAAiE;AACjE,mBAAmB;AACnB,WAAW;AACX,gEAAgE;AAChE,oEAAoE;AACpE,8BAA8B;AAC9B,iEAAiE;AAEjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,YAAY,CAC3D,6BAA6B,EAC7B,CAAC,CAAC,MAAM,CAAC;IACP,kEAAkE;IAClE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEtB,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEzC,sDAAsD;IACtD,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC;IAEhF,0CAA0C;IAC1C,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC;IAEtF,wDAAwD;IACxD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7C,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IAE3C,wGAAwG;IACxG,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAC1D,CAAC,CACH,CAAC"}