@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

package/dist/esm/core/resources/ResourceRegistryContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceRegistryContext.js","sourceRoot":"","sources":["../../../../src/core/resources/ResourceRegistryContext.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ResourceRegistryContext.js","sourceRoot":"","sources":["../../../../../src/core/resources/ResourceRegistryContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,qBAAqB,EAErB,kCAAkC,EAClC,qCAAqC,EACrC,sCAAsC,GACvC,MAAM,uBAAuB,CAAC;AAE/B,OAAc,EAAE,aAAa,EAAa,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,uEAAuE,CAAC;AAQlG,OAAO,EAAE,0CAA0C,EAAE,MAAM,uEAAuE,CAAC;AACnI,OAAO,EAAE,8BAA8B,EAAuC,MAAM,qFAAqF,CAAC;AA4E1K;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA2D,aAAa,CAA0C,SAAS,CAAC,CAAC;AAEjK;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA4C,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,EAAE,EAAE;IACrH,yEAAyE;IACzE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,oBAAoB,EAAE,CAAC;IAC5D,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,sBAAsB,EAAE,CAAC;IACzE,uFAAuF;IACvF,mFAAmF;IACnF,qFAAqF;IACrF,qFAAqF;IACrF,wFAAwF;IACxF,uFAAuF;IACvF,uCAAuC;IACvC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,wBAAwB,EAAE,CAAC;IAE7E,wEAAwE;IACxE,+EAA+E;IAC/E,8EAA8E;IAC9E,6EAA6E;IAC7E,uEAAuE;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,qCAAqC,CAAC,QAAQ,CAAC,sBAA6B,CAAC,CAAC;YACjG,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,KAAK,sCAAsC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;gBACnG,sCAAsC;gBACtC,OAAO,CAAC,IAAI,CAAC,4BAA4B,KAAK,KAAK,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf;;OAEG;IACH,MAAM,WAAW,GAAG,KAAK,EACvB,aAAsC,EACtC,UAA0E,EAC1E,OAAwB,EACJ,EAAE;QACtB,uDAAuD;QACvD,MAAM,gBAAgB,GAAG,OAAO,aAAa,KAAK,QAAQ;YACxD,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,kCAAkC,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAE7E,MAAM,SAAS,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;QAC5E,MAAM,iBAAiB,GAAG,SAAS;YACjC,CAAC,CAAC,0CAA0C,CAAC,SAAS,CAAC,KAAK,qBAAqB,CAAC,MAAM;YACxF,CAAC,CAAC,kCAAkC,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,CAAC,mBAAmB,KAAK,qBAAqB,CAAC,MAAM,CAAC;QAEpI,IAAI,iBAAiB,EAAE,CAAC;YACtB,8BAA8B;YAC9B,OAAO,mBAAmB,CAAC,sBAAsB,CAC/C,gBAAgB,EAChB,UAA0C,EAC1C,OAAO,CACR,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,gCAAgC;YAChC,OAAO,mBAAmB,CAAC,WAAW,CACpC,gBAAgB,EAChB,UAA6C,EAC7C,OAAO,CACR,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF;;;;OAIG;IACH,MAAM,wBAAwB,GAAG,WAAW,CAC1C,KAAK,EACH,MAA8F,EAC5E,EAAE;QACpB,OAAO,8BAA8B,CAAC,wBAAwB,CAAC;YAC7D,GAAI,MAAc;YAClB,iBAAiB,EAAE,QAAQ;YAC3B,WAAW;SACZ,CAAC,CAAC;IACL,CAAC,EACD,CAAC,QAAQ,EAAE,WAAW,CAAC,CACxB,CAAC;IAEF,MAAM,wBAAwB,GAAG,WAAW,CAAC,CAC3C,SAAiE,EACjE,EAAE;QACF,OAAO,8BAA8B,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAC5E,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP;;OAEG;IACH,MAAM,WAAW,GAAG,CAAC,YAAoB,EAAW,EAAE;QACpD,OAAO,YAAY,IAAI,QAAQ,CAAC,sBAAsB,CAAC;IACzD,CAAC,CAAC;IAEF;;OAEG;IACH,MAAM,wBAAwB,GAAG,CAAC,YAAoB,EAAgD,EAAE;QACtG,OAAO,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC,CAAC;IAEF;;OAEG;IACH,MAAM,oBAAoB,GAAG,GAA8B,EAAE;QAC3D,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF;;OAEG;IACH,MAAM,yBAAyB,GAAG,GAAa,EAAE;QAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IACtD,CAAC,CAAC;IAEF;;OAEG;IACH,MAAM,0BAA0B,GAAG,GAAa,EAAE;QAChD,OAAO,mBAAmB,CAAC,0BAA0B,EAAE,CAAC;IAC1D,CAAC,CAAC;IAEF;;OAEG;IACH,MAAM,YAAY,GAAG,CAAC,KAAoB,EAAQ,EAAE;QAClD,IAAI,KAAK,EAAE,CAAC;YACV,mBAAmB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACxC,qBAAqB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,mBAAmB,CAAC,cAAc,EAAE,CAAC;YACrC,qBAAqB,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;IACH,CAAC,CAAC;IAEF;;;;OAIG;IACH,MAAM,sBAAsB,GAAG,CAAC,OAA4B,EAAQ,EAAE;QACpE,mBAAmB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACpD,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC,CAAC;IAEF,MAAM,oBAAoB,GAAG,CAAC,OAAiC,EAAQ,EAAE;QACvE,mBAAmB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAClD,qBAAqB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC,CAAC;IAEF,MAAM,kBAAkB,GAAG,CAAC,KAAoB,EAAQ,EAAE;QACxD,mBAAmB,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC9C,qBAAqB,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,MAAM,KAAK,GAAgC;QACzC,QAAQ;QACR,QAAQ;QAER,wBAAwB;QACxB,WAAW;QAEX,2BAA2B;QAC3B,wBAAwB;QACxB,wBAAwB;QAExB,UAAU;QACV,WAAW;QACX,wBAAwB;QACxB,oBAAoB;QACpB,yBAAyB;QACzB,0BAA0B;QAE1B,OAAO;QACP,YAAY;QACZ,sBAAsB;QACtB,oBAAoB;QACpB,kBAAkB;KACnB,CAAC;IAEF,OAAO,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAoC,CAAC;AACvG,CAAC,CAAC","sourcesContent":["import {\n  CoreResourceOperation,\n  ResourceConfiguration_OperationPath,\n  ResourcesConfig_OperationPathUtils,\n  validateRequiredForeignKeyFillability,\n  ForeignKeyFillabilityViolationSeverity,\n} from '@wildo-ai/saas-models';\n\nimport React, { createContext, ReactNode, useCallback, useEffect } from 'react';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport {\n  ResourceOperationCallParameters,\n  ResourceSearchCallParameters\n} from '~wildo-frontend-lib/core/requests/wildo-http-client-resources.frontend.service';\nimport { RequestOptions, TokenRenewalHandler, StepUpAuthHandler } from '~wildo-frontend-lib/core/requests/wildo-http-client.frontend.service';\nimport { ResourcesRepositoryFrontendService } from './resources-repository.frontend.service';\nimport type { AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { resolveEffectiveCoreOperationFromOperation } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { OperationEnabledConditionUtils, type EvaluateEnabledConditionParams } from '~wildo-frontend-lib/core/resources/utils/operation-enabled-condition.frontend.utils';\n\n/**\n * Resource Registry Context\n * Manages resource configurations and operations\n *\n * ARCHITECTURE NOTE (Scopes):\n * - The base provider is `ResourceRegistryProvider`, which exposes `doOperation()` and the registry.\n * - The app can optionally wrap it with `ScopedResourceRegistryProvider` (in `core/resources/ScopedResourceRegistryProvider.tsx`).\n *   That wrapper **overrides `doOperation()`** to automatically inject the current `AppScope` into\n *   `parameters.contextualParameters` for nested callers (strictly relevant-only).\n * - This means `useResourceRegistry().doOperation(...)` may be the base implementation OR a scoped override,\n *   depending on provider hierarchy.\n */\n\nexport type OperationPathKey = string;\nexport type OperationPathIdentifier = ResourceConfiguration_OperationPath<any, any> | OperationPathKey;\n\nexport interface ResourceRegistryContextType {\n  // State\n  registry: FrontendResourcesRegistry;\n\n  // Main execution method\n  /**\n   * Execute a resource operation (API_CALL or SEARCH).\n   *\n   * IMPORTANT:\n   * This function can be transparently overridden by a nested provider (see note above),\n   * so callers usually should NOT manually inject global scope/context unless they are intentionally\n   * overriding/adding to the contextual parameters for a specific call.\n   *\n   * Merge semantics (when scoped):\n   * - scoped provider injects relevant AppScope fields\n   * - explicit `parameters.contextualParameters` passed by the caller override injected values\n   */\n  doOperation: <TResponse = any>(\n    operationPath: OperationPathIdentifier,\n    parameters: ResourceOperationCallParameters | ResourceSearchCallParameters,\n    options?: RequestOptions\n  ) => Promise<TResponse>;\n\n  // EnabledCondition helpers\n  /**\n   * Evaluate `operation.enabledCondition()` with the current registry + doOperation.\n   * This is used by UI to decide whether an operation should be shown/enabled.\n   */\n  evaluateOperationEnabled: <TMainSchema = any>(\n    params: Omit<EvaluateEnabledConditionParams<TMainSchema>, 'resourcesRegistry' | 'doOperation'>\n  ) => Promise<boolean>;\n\n  /**\n   * Static context-needs extraction for an operation (enabledCondition + prefix ops).\n   */\n  getOperationContextNeeds: (\n    operation: FrontendResourceConfiguration_Operation<any, any, any>\n  ) => { needsObjectContext: boolean; needsUserContext: boolean };\n\n  // Helpers\n  hasResource: (resourceName: string) => boolean;\n  getResourceConfiguration: (resourceName: string) => AnyFrontendResourceConfiguration | undefined;\n  getResourcesRegistry: () => FrontendResourcesRegistry;\n  getAvailableResourceTypes: () => string[];\n  getAvailableOperationPaths: () => string[];\n  \n  // Auth token management\n  setAuthToken: (token: string | null) => void;\n  setTokenRenewalHandler: (handler: TokenRenewalHandler) => void;\n  setStepUpAuthHandler: (handler: StepUpAuthHandler | null) => void;\n  setConsumableToken: (token: string | null) => void;\n}\n\nexport interface ResourceRegistryProviderProps {\n  children: ReactNode;\n  resourcesRepository: ResourcesRepositoryFrontendService;\n}\n\n/**\n * Resource Registry Context\n * Exported for use in separate hook file (Fast Refresh compatibility)\n * @internal - Use useResourceRegistry() hook instead of accessing this directly\n */\nexport const ResourceRegistryContext: React.Context<ResourceRegistryContextType | undefined> = createContext<ResourceRegistryContextType | undefined>(undefined);\n\n/**\n * ResourceRegistryProvider - Simplified version without location dependency\n * isActive computation is now handled by NavigationProvider which is more appropriate\n */\nexport const ResourceRegistryProvider: React.FC<ResourceRegistryProviderProps> = ({ children, resourcesRepository }) => {\n  // Get the registry and resources HTTP client from the repository service\n  const registry = resourcesRepository.getResourcesRegistry();\n  const resourcesHttpClient = resourcesRepository.getResourcesHttpClient();\n  // The base application HTTP client (exposed app-wide as `useApplication().httpClient`)\n  // is a SEPARATE instance from the resources client above. Resource-integrated file\n  // operations (`FormFieldFile` upload / metadata / delete) run through it, so it must\n  // receive the SAME auth token / renewal handler / step-up handler / consumable token\n  // that the resources client gets — otherwise those file requests go out unauthenticated\n  // (401). File upload was the first authenticated consumer of this base client, so this\n  // wiring gap was previously invisible.\n  const applicationHttpClient = resourcesRepository.getApplicationHttpClient();\n\n  // Dev-only mirror of the backend startup guardrail: surface required-FK\n  // fillability violations in the browser console so a frontend-focused dev sees\n  // them where the create form actually lives. The backend is the AUTHORITATIVE\n  // gate (it hard-fails on FAIL severity), so here we only warn — never throw,\n  // and always fail-open so a validator edge case can't affect app load.\n  useEffect(() => {\n    if (!envLoader.isDevelopment()) {\n      return;\n    }\n    try {\n      const violations = validateRequiredForeignKeyFillability(registry.resourceConfigurations as any);\n      for (const violation of violations) {\n        const label = violation.severity === ForeignKeyFillabilityViolationSeverity.FAIL ? 'FAIL' : 'WARN';\n        // eslint-disable-next-line no-console\n        console.warn(`[required-fk-fillability:${label}] ${violation.kind}: ${violation.message}`);\n      }\n    } catch {\n      // Fail-open — never let the guardrail affect app load.\n    }\n  }, [registry]);\n\n  /**\n   * Main operation execution method - handles both regular and search operations\n   */\n  const doOperation = async <TResponse = any>(\n    operationPath: OperationPathIdentifier,\n    parameters: ResourceOperationCallParameters | ResourceSearchCallParameters,\n    options?: RequestOptions\n  ): Promise<TResponse> => {\n    // Convert OperationPath object to string key if needed\n    const operationPathKey = typeof operationPath === 'string' \n      ? operationPath \n      : ResourcesConfig_OperationPathUtils.createOperationPathKey(operationPath);\n\n    const operation = resourcesHttpClient.getOperationDetails(operationPathKey);\n    const isSearchOperation = operation\n      ? resolveEffectiveCoreOperationFromOperation(operation) === CoreResourceOperation.SEARCH\n      : ResourcesConfig_OperationPathUtils.parseOperationPathKey(operationPathKey).operationIdentifier === CoreResourceOperation.SEARCH;\n\n    if (isSearchOperation) {\n      // Call search-specific method\n      return resourcesHttpClient.executeSearchOperation<TResponse>(\n        operationPathKey,\n        parameters as ResourceSearchCallParameters,\n        options\n      );\n    } else {\n      // Call regular operation method\n      return resourcesHttpClient.doOperation<TResponse>(\n        operationPathKey,\n        parameters as ResourceOperationCallParameters,\n        options\n      );\n    }\n  };\n\n  /**\n   * Evaluate if an operation is enabled (enabledCondition).\n   * Centralized here so all consumers automatically benefit from any doOperation overrides\n   * (e.g. ScopedResourceRegistryProvider injecting AppScope).\n   */\n  const evaluateOperationEnabled = useCallback(\n    async <TMainSchema = any>(\n      params: Omit<EvaluateEnabledConditionParams<TMainSchema>, 'resourcesRegistry' | 'doOperation'>\n    ): Promise<boolean> => {\n      return OperationEnabledConditionUtils.evaluateEnabledCondition({\n        ...(params as any),\n        resourcesRegistry: registry,\n        doOperation,\n      });\n    },\n    [registry, doOperation]\n  );\n\n  const getOperationContextNeeds = useCallback((\n    operation: FrontendResourceConfiguration_Operation<any, any, any>\n  ) => {\n    return OperationEnabledConditionUtils.getOperationContextNeeds(operation);\n  }, []);\n\n  /**\n   * Check if resource is available\n   */\n  const hasResource = (resourceName: string): boolean => {\n    return resourceName in registry.resourceConfigurations;\n  };\n\n  /**\n   * Get resource configuration\n   */\n  const getResourceConfiguration = (resourceName: string): AnyFrontendResourceConfiguration | undefined => {\n    return registry.resourceConfigurations[resourceName];\n  };\n\n  /**\n   * Get the full resources registry\n   */\n  const getResourcesRegistry = (): FrontendResourcesRegistry => {\n    return registry;\n  };\n\n  /**\n   * Get available resource types\n   */\n  const getAvailableResourceTypes = (): string[] => {\n    return Object.keys(registry.resourceConfigurations);\n  };\n\n  /**\n   * Get available operation paths\n   */\n  const getAvailableOperationPaths = (): string[] => {\n    return resourcesHttpClient.getAvailableOperationPaths();\n  };\n  \n  /**\n   * Set authentication token for resource operations\n   */\n  const setAuthToken = (token: string | null): void => {\n    if (token) {\n      resourcesHttpClient.setAuthToken(token);\n      applicationHttpClient.setAuthToken(token);\n    } else {\n      resourcesHttpClient.clearAuthToken();\n      applicationHttpClient.clearAuthToken();\n    }\n  };\n\n  /**\n   * Set token renewal handler for resource operations.\n   * Called by AuthSessionContext to enable automatic token refresh on 401s\n   * from the resources HTTP client (not just the manual calls client).\n   */\n  const setTokenRenewalHandler = (handler: TokenRenewalHandler): void => {\n    resourcesHttpClient.setTokenRenewalHandler(handler);\n    applicationHttpClient.setTokenRenewalHandler(handler);\n  };\n\n  const setStepUpAuthHandler = (handler: StepUpAuthHandler | null): void => {\n    resourcesHttpClient.setStepUpAuthHandler(handler);\n    applicationHttpClient.setStepUpAuthHandler(handler);\n  };\n\n  const setConsumableToken = (token: string | null): void => {\n    resourcesHttpClient.setConsumableToken(token);\n    applicationHttpClient.setConsumableToken(token);\n  };\n\n  const value: ResourceRegistryContextType = {\n    // State\n    registry,\n\n    // Main execution method\n    doOperation,\n\n    // EnabledCondition helpers\n    evaluateOperationEnabled,\n    getOperationContextNeeds,\n\n    // Helpers\n    hasResource,\n    getResourceConfiguration,\n    getResourcesRegistry,\n    getAvailableResourceTypes,\n    getAvailableOperationPaths,\n    \n    // Auth\n    setAuthToken,\n    setTokenRenewalHandler,\n    setStepUpAuthHandler,\n    setConsumableToken,\n  };\n\n  return <ResourceRegistryContext.Provider value={value}>{children}</ResourceRegistryContext.Provider>;\n};\n\n// useResourceRegistry hook is now in separate file: ./useResourceRegistry.ts\n// This separation is required for React Fast Refresh compatibility\n"]}

package/dist/esm/core/resources/ScopedResourceRegistryProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScopedResourceRegistryProvider.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/ScopedResourceRegistryProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAwB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAYpE,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAyCD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,EAAE,QAAQ,EAAE,EAAE,mCAAmC,GAAG,KAAK,CAAC,YAAY,CAgFpH"}
+{"version":3,"file":"ScopedResourceRegistryProvider.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/ScopedResourceRegistryProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAwB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAYpE,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,SAAS,CAAC;CACrB;AA4CD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,EAAE,QAAQ,EAAE,EAAE,mCAAmC,GAAG,KAAK,CAAC,YAAY,CAgFpH"}

package/dist/esm/core/resources/ScopedResourceRegistryProvider.js

@@ -31,7 +31,8 @@ function findOperationInRegistry(registry, operationPath) {
             if ((actualVariantKey ?? undefined) !== (expectedVariantKey ?? undefined))
                 return false;
         }
-        if (opPath.variantType === ResourceOperationVariantType.API_CALL) {
+        if (opPath.variantType === ResourceOperationVariantType.API_CALL
+            || opPath.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK) {
             const opIsBulk = opPath.isBulkOperation === true;
             const pathIsBulk = operationPath.isBulkOperation === true;
             return opIsBulk === pathIsBulk;
@@ -105,4 +106,4 @@ export function ScopedResourceRegistryProvider({ children }) {
     }, [base, doOperation, evaluateOperationEnabled]);
     return (_jsx(ResourceRegistryContext.Provider, { value: value, children: children }));
 }
-//# sourceMappingURL=ScopedResourceRegistryProvider.js.map
+//# sourceMappingURL=ScopedResourceRegistryProvider.js.map

package/dist/esm/core/resources/ScopedResourceRegistryProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScopedResourceRegistryProvider.js","sourceRoot":"","sources":["../../../../src/core/resources/ScopedResourceRegistryProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ScopedResourceRegistryProvider.js","sourceRoot":"","sources":["../../../../../src/core/resources/ScopedResourceRegistryProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useCallback, useMemo, type ReactNode } from 'react';\nimport {\n  ResourcesConfig_OperationPathUtils,\n  ResourceOperationVariantType,\n  type ResourceConfiguration_Operation,\n  type ResourceConfiguration_OperationPath,\n} from '@wildo-ai/saas-models';\nimport { OperationEnabledConditionUtils, type EvaluateEnabledConditionParams } from '~wildo-frontend-lib/core/resources/utils/operation-enabled-condition.frontend.utils';\nimport { ResourceRegistryContext, type ResourceRegistryContextType } from './ResourceRegistryContext';\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\n\nexport interface ScopedResourceRegistryProviderProps {\n  children: ReactNode;\n}\n\nfunction toOperationPathKey(operationPath: ResourceConfiguration_OperationPath<any, any> | string): string {\n  return typeof operationPath === 'string'\n    ? operationPath\n    : ResourcesConfig_OperationPathUtils.createOperationPathKey(operationPath);\n}\n\nfunction findOperationInRegistry(\n  registry: ResourceRegistryContextType['registry'],\n  operationPath: ResourceConfiguration_OperationPath<any, any>\n): ResourceConfiguration_Operation<any, any, any> | null {\n  const resourceConfig = registry.resourceConfigurations[operationPath.resourceIdentifier];\n  if (!resourceConfig) {\n    return null;\n  }\n\n  return resourceConfig.operations.find((op: any) => {\n    const opPath = ResourcesConfig_OperationPathUtils.extractOperationPath(op);\n\n    if (opPath.operationIdentifier !== operationPath.operationIdentifier) return false;\n    if (opPath.variantType !== operationPath.variantType) return false;\n\n    if (operationPath.isOperationDefault) {\n      if (!opPath.isOperationDefault) return false;\n    } else {\n      const expectedVariantKey = operationPath.variantKey;\n      const actualVariantKey = opPath.variantKey;\n      if ((actualVariantKey ?? undefined) !== (expectedVariantKey ?? undefined)) return false;\n    }\n\n    if (\n      opPath.variantType === ResourceOperationVariantType.API_CALL\n      || opPath.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK\n    ) {\n      const opIsBulk = opPath.isBulkOperation === true;\n      const pathIsBulk = operationPath.isBulkOperation === true;\n      return opIsBulk === pathIsBulk;\n    }\n\n    return true;\n  }) || null;\n}\n\n/**\n * Nested provider that re-exposes ResourceRegistryContext with a scoped `doOperation()`.\n *\n * This is intentionally placed INSIDE `AppScopeProvider` so it can inject the current scope\n * into all resource calls, while keeping the root `ResourceRegistryProvider` unchanged.\n */\nexport function ScopedResourceRegistryProvider({ children }: ScopedResourceRegistryProviderProps): React.ReactElement {\n  const base = useResourceRegistry();\n  const appScope = useAppScopeSafe();\n\n  const doOperation = useCallback<ResourceRegistryContextType['doOperation']>(\n    async (operationPath, parameters, options) => {\n      // If AppScopeProvider isn't mounted yet, behave exactly like the base registry.\n      if (!appScope) {\n        return base.doOperation(operationPath, parameters, options);\n      }\n\n      const operationPathKey = toOperationPathKey(operationPath as any);\n\n      // Parse target operation to decide which contextual params are relevant.\n      // If parsing fails for any reason, fall back to base behavior.\n      let parsedPath: ResourceConfiguration_OperationPath<any, any> | null = null;\n      try {\n        parsedPath = ResourcesConfig_OperationPathUtils.parseOperationPathKey(operationPathKey);\n      } catch {\n        parsedPath = null;\n      }\n\n      const operation = parsedPath ? findOperationInRegistry(base.registry, parsedPath) : null;\n\n      // If operation was not found in registry, fall back to unscoped behavior.\n      // This prevents fragile optional-chaining on initiatorInfos below.\n      if (!operation) {\n        return base.doOperation(operationPath, parameters, options);\n      }\n\n      const injectedScopeParams: Record<string, string | string[]> = appScope.buildContextualParameters();\n      const existingContextualParameters =\n        (parameters as any)?.contextualParameters as Record<string, string | string[]> | undefined;\n      const mergedContextualParameters = {\n        ...injectedScopeParams,\n        ...(existingContextualParameters || {}),\n      };\n\n      const mergedParameters = {\n        ...(parameters as any),\n        contextualParameters: mergedContextualParameters,\n      };\n\n      return base.doOperation(operationPath, mergedParameters, options);\n    },\n    [appScope, base]\n  );\n\n  /**\n   * IMPORTANT:\n   * `ResourceRegistryProvider`'s `evaluateOperationEnabled` closes over its own `doOperation`.\n   * If we only override `doOperation` in context, enabledCondition evaluation would still run with\n   * the unscoped doOperation (missing AppScope injection).\n   *\n   * So we override `evaluateOperationEnabled` as well, wiring it to the scoped `doOperation`.\n   */\n  const evaluateOperationEnabled = useCallback<ResourceRegistryContextType['evaluateOperationEnabled']>(\n    async (params) => {\n      return OperationEnabledConditionUtils.evaluateEnabledCondition({\n        ...(params as any),\n        resourcesRegistry: base.registry,\n        doOperation,\n      } satisfies EvaluateEnabledConditionParams<any>);\n    },\n    [base.registry, doOperation]\n  );\n\n  const value = useMemo<ResourceRegistryContextType>(() => {\n    return {\n      ...base,\n      doOperation,\n      evaluateOperationEnabled,\n    };\n  }, [base, doOperation, evaluateOperationEnabled]);\n\n  return (\n    <ResourceRegistryContext.Provider value={value}>\n      {children}\n    </ResourceRegistryContext.Provider>\n  );\n}\n\n"]}

package/dist/esm/core/resources/collection-export-url.frontend.utils.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The API URL of a listing's export companion, and the download that follows it.
+ *
+ * ## Why the export cannot go through the ordinary action executor
+ *
+ * Every other resource action ends in `doOperation()`, which parses a JSON result and hands it to
+ * the refresh/notification pipeline. An export answers BYTES with a `Content-Disposition`, so there
+ * is no result to parse and nothing to refresh — the browser has to be handed a file. That is the
+ * same shape the generated-file REGENERATE action already needed special handling for, one step
+ * further: regenerate returns JSON and the bytes are fetched later; an export IS the bytes.
+ */
+import { type ResourceCollectionExportFormat, type ResourceCollectionExportRowScope, type ResourceType } from '@wildo-ai/saas-models';
+import type { FrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
+export interface BuildCollectionExportUrlParams {
+    registry: FrontendResourcesRegistry;
+    resourceConfig: FrontendResourceConfiguration;
+    /** The DERIVED export operation, not the listing it exports. */
+    exportOperation: FrontendResourceConfiguration_Operation;
+    resourceType: ResourceType;
+    /**
+     * `string | number` rather than `string`: the transport normalizer emits numeric ids as numbers,
+     * and narrowing here would push a cast onto every caller for a value that is stringified into a
+     * URL segment anyway.
+     */
+    contextResourceIdentifiers: Record<string, string>;
+    /**
+     * `string | number`: the parameter map resolved for URL substitution can carry numeric ids, and
+     * narrowing here would push a cast onto every caller for a value that is stringified into a URL
+     * segment anyway.
+     */
+    contextualParameters: Record<string, string | number>;
+    parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
+    apiBaseUrl: string;
+    format: ResourceCollectionExportFormat;
+    rowScope: ResourceCollectionExportRowScope;
+    /**
+     * The query the LISTING is currently showing — filters, sort, page. Forwarded verbatim so
+     * "export what I am looking at" needs no second grammar, and so a `VISIBLE_PAGE` export returns
+     * the page on screen rather than a different one.
+     */
+    listingQuery?: Record<string, string | number | undefined>;
+}
+/**
+ * `null` when the route cannot be fully resolved from the current context — the caller then hides
+ * the action rather than offering a download that would 404. Deliberately the same posture the file
+ * serve URL takes: an unresolved placeholder is a missing parent id, not an error to raise.
+ */
+export declare function buildCollectionExportUrl(params: BuildCollectionExportUrlParams): string | null;
+/**
+ * Fetch the export through the AUTHENTICATED client and hand the bytes to the browser.
+ *
+ * A plain `<a href>` or `window.open` would issue an UNAUTHENTICATED request — the access token
+ * lives in the http client, not in a cookie the browser would attach — so the download must go
+ * through `getBlob` and be released as an object URL. The object URL is revoked immediately after
+ * the click: leaving it alive pins the whole file in memory for the life of the document, and an
+ * export is exactly the payload where that matters.
+ */
+export declare function downloadCollectionExport(params: {
+    url: string;
+    resourceType: ResourceType;
+    format: ResourceCollectionExportFormat;
+    getBlob: (url: string) => Promise<Blob>;
+}): Promise<void>;
+//# sourceMappingURL=collection-export-url.frontend.utils.d.ts.map

package/dist/esm/core/resources/collection-export-url.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-export-url.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/collection-export-url.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAML,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EACV,6BAA6B,EAC7B,uCAAuC,EACvC,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAEpI,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,yBAAyB,CAAC;IACpC,cAAc,EAAE,6BAA6B,CAAC;IAC9C,gEAAgE;IAChE,eAAe,EAAE,uCAAuC,CAAC;IACzD,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;OAIG;IACH,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,8BAA8B,CAAC;IACvC,QAAQ,EAAE,gCAAgC,CAAC;IAC3C;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,GAAG,IAAI,CA8C9F;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,8BAA8B,CAAC;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB"}

package/dist/esm/core/resources/collection-export-url.frontend.utils.js

@@ -0,0 +1,79 @@
+/**
+ * The API URL of a listing's export companion, and the download that follows it.
+ *
+ * ## Why the export cannot go through the ordinary action executor
+ *
+ * Every other resource action ends in `doOperation()`, which parses a JSON result and hands it to
+ * the refresh/notification pipeline. An export answers BYTES with a `Content-Disposition`, so there
+ * is no result to parse and nothing to refresh — the browser has to be handed a file. That is the
+ * same shape the generated-file REGENERATE action already needed special handling for, one step
+ * further: regenerate returns JSON and the bytes are fetched later; an export IS the bytes.
+ */
+import { buildCollectionExportFilename, COLLECTION_EXPORT_FORMAT_QUERY_PARAM, COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM, MAIN_API_BASE_PATH, ResourcesConfigOperationsUrlsBuilderUtils, } from '@wildo-ai/saas-models';
+import { NavigationUtils } from '../../core/navigation/navigation.utils.js';
+import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+/**
+ * `null` when the route cannot be fully resolved from the current context — the caller then hides
+ * the action rather than offering a download that would 404. Deliberately the same posture the file
+ * serve URL takes: an unresolved placeholder is a missing parent id, not an error to raise.
+ */
+export function buildCollectionExportUrl(params) {
+    const { registry, resourceConfig, exportOperation, resourceType, contextResourceIdentifiers, contextualParameters, parentResourcesRequirements, apiBaseUrl, format, rowScope, listingQuery, } = params;
+    if (!resourceConfig?.resourceFieldIdentifier || !exportOperation)
+        return null;
+    try {
+        const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(resourceConfig, exportOperation, registry.allResourceFieldIdentifiers);
+        if (routePaths.length === 0)
+            return null;
+        const routePath = frontendResourceUtils.selectMatchingRoutePath(routePaths, contextResourceIdentifiers, resourceConfig.resourceIdentifier, resourceConfig.resourceFieldIdentifier, parentResourcesRequirements, registry.allResourceFieldIdentifiers);
+        // A collection-level route: the parent chain only, and no id of this resource's own.
+        const resolved = NavigationUtils.resolveUrlPath(routePath.url, contextualParameters);
+        if (NavigationUtils.hasUnresolvedPlaceholders(resolved))
+            return null;
+        const query = new URLSearchParams();
+        query.set(COLLECTION_EXPORT_FORMAT_QUERY_PARAM, format);
+        query.set(COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM, rowScope);
+        for (const [key, value] of Object.entries(listingQuery ?? {})) {
+            if (value === undefined || value === '')
+                continue;
+            // Never forwarded: the caller's own selectors are set above, and a listing query carrying
+            // them would otherwise decide the format twice.
+            if (key === COLLECTION_EXPORT_FORMAT_QUERY_PARAM || key === COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM)
+                continue;
+            query.set(key, String(value));
+        }
+        // Frontend route paths omit `/api/v1`; re-add it to match the registered backend route.
+        return `${apiBaseUrl}${MAIN_API_BASE_PATH}${resolved}?${query.toString()}`;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch the export through the AUTHENTICATED client and hand the bytes to the browser.
+ *
+ * A plain `<a href>` or `window.open` would issue an UNAUTHENTICATED request — the access token
+ * lives in the http client, not in a cookie the browser would attach — so the download must go
+ * through `getBlob` and be released as an object URL. The object URL is revoked immediately after
+ * the click: leaving it alive pins the whole file in memory for the life of the document, and an
+ * export is exactly the payload where that matters.
+ */
+export async function downloadCollectionExport(params) {
+    const blob = await params.getBlob(params.url);
+    const objectUrl = URL.createObjectURL(blob);
+    try {
+        const link = document.createElement('a');
+        link.href = objectUrl;
+        // The server already names the file in `Content-Disposition`, but a blob download does not see
+        // that header — the name has to be supplied here. Same builder as the server's, so the two
+        // agree instead of drifting.
+        link.download = buildCollectionExportFilename(String(params.resourceType), params.format, new Date());
+        document.body.appendChild(link);
+        link.click();
+        link.remove();
+    }
+    finally {
+        URL.revokeObjectURL(objectUrl);
+    }
+}
+//# sourceMappingURL=collection-export-url.frontend.utils.js.map

package/dist/esm/core/resources/collection-export-url.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-export-url.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/collection-export-url.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,EACpC,uCAAuC,EACvC,kBAAkB,EAClB,yCAAyC,GAI1C,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAsCnG;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAsC;IAC7E,MAAM,EACJ,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EACvD,0BAA0B,EAAE,oBAAoB,EAAE,2BAA2B,EAC7E,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAC3C,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC,cAAc,EAAE,uBAAuB,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAE9E,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,yCAAyC,CAAC,gCAAgC,CAC3F,cAAc,EACd,eAAe,EACf,QAAQ,CAAC,2BAA2B,CACrC,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzC,MAAM,SAAS,GAAG,qBAAqB,CAAC,uBAAuB,CAC7D,UAAU,EACV,0BAA0B,EAC1B,cAAc,CAAC,kBAAkB,EACjC,cAAc,CAAC,uBAAuB,EACtC,2BAA2B,EAC3B,QAAQ,CAAC,2BAA2B,CACrC,CAAC;QAEF,qFAAqF;QACrF,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACrF,IAAI,eAAe,CAAC,yBAAyB,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAErE,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,KAAK,CAAC,GAAG,CAAC,oCAAoC,EAAE,MAAM,CAAC,CAAC;QACxD,KAAK,CAAC,GAAG,CAAC,uCAAuC,EAAE,QAAQ,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;gBAAE,SAAS;YAClD,0FAA0F;YAC1F,gDAAgD;YAChD,IAAI,GAAG,KAAK,oCAAoC,IAAI,GAAG,KAAK,uCAAuC;gBAAE,SAAS;YAC9G,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChC,CAAC;QAED,wFAAwF;QACxF,OAAO,GAAG,UAAU,GAAG,kBAAkB,GAAG,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAK9C;IACC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,+FAA+F;QAC/F,2FAA2F;QAC3F,6BAA6B;QAC7B,IAAI,CAAC,QAAQ,GAAG,6BAA6B,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACtG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;AACH,CAAC","sourcesContent":["/**\n * The API URL of a listing's export companion, and the download that follows it.\n *\n * ## Why the export cannot go through the ordinary action executor\n *\n * Every other resource action ends in `doOperation()`, which parses a JSON result and hands it to\n * the refresh/notification pipeline. An export answers BYTES with a `Content-Disposition`, so there\n * is no result to parse and nothing to refresh — the browser has to be handed a file. That is the\n * same shape the generated-file REGENERATE action already needed special handling for, one step\n * further: regenerate returns JSON and the bytes are fetched later; an export IS the bytes.\n */\nimport {\n  buildCollectionExportFilename,\n  COLLECTION_EXPORT_FORMAT_QUERY_PARAM,\n  COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM,\n  MAIN_API_BASE_PATH,\n  ResourcesConfigOperationsUrlsBuilderUtils,\n  type ResourceCollectionExportFormat,\n  type ResourceCollectionExportRowScope,\n  type ResourceType,\n} from '@wildo-ai/saas-models';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type {\n  FrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\nexport interface BuildCollectionExportUrlParams {\n  registry: FrontendResourcesRegistry;\n  resourceConfig: FrontendResourceConfiguration;\n  /** The DERIVED export operation, not the listing it exports. */\n  exportOperation: FrontendResourceConfiguration_Operation;\n  resourceType: ResourceType;\n  /**\n   * `string | number` rather than `string`: the transport normalizer emits numeric ids as numbers,\n   * and narrowing here would push a cast onto every caller for a value that is stringified into a\n   * URL segment anyway.\n   */\n  contextResourceIdentifiers: Record<string, string>;\n  /**\n   * `string | number`: the parameter map resolved for URL substitution can carry numeric ids, and\n   * narrowing here would push a cast onto every caller for a value that is stringified into a URL\n   * segment anyway.\n   */\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  apiBaseUrl: string;\n  format: ResourceCollectionExportFormat;\n  rowScope: ResourceCollectionExportRowScope;\n  /**\n   * The query the LISTING is currently showing — filters, sort, page. Forwarded verbatim so\n   * \"export what I am looking at\" needs no second grammar, and so a `VISIBLE_PAGE` export returns\n   * the page on screen rather than a different one.\n   */\n  listingQuery?: Record<string, string | number | undefined>;\n}\n\n/**\n * `null` when the route cannot be fully resolved from the current context — the caller then hides\n * the action rather than offering a download that would 404. Deliberately the same posture the file\n * serve URL takes: an unresolved placeholder is a missing parent id, not an error to raise.\n */\nexport function buildCollectionExportUrl(params: BuildCollectionExportUrlParams): string | null {\n  const {\n    registry, resourceConfig, exportOperation, resourceType,\n    contextResourceIdentifiers, contextualParameters, parentResourcesRequirements,\n    apiBaseUrl, format, rowScope, listingQuery,\n  } = params;\n\n  if (!resourceConfig?.resourceFieldIdentifier || !exportOperation) return null;\n\n  try {\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceConfig,\n      exportOperation,\n      registry.allResourceFieldIdentifiers,\n    );\n    if (routePaths.length === 0) return null;\n\n    const routePath = frontendResourceUtils.selectMatchingRoutePath(\n      routePaths,\n      contextResourceIdentifiers,\n      resourceConfig.resourceIdentifier,\n      resourceConfig.resourceFieldIdentifier,\n      parentResourcesRequirements,\n      registry.allResourceFieldIdentifiers,\n    );\n\n    // A collection-level route: the parent chain only, and no id of this resource's own.\n    const resolved = NavigationUtils.resolveUrlPath(routePath.url, contextualParameters);\n    if (NavigationUtils.hasUnresolvedPlaceholders(resolved)) return null;\n\n    const query = new URLSearchParams();\n    query.set(COLLECTION_EXPORT_FORMAT_QUERY_PARAM, format);\n    query.set(COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM, rowScope);\n    for (const [key, value] of Object.entries(listingQuery ?? {})) {\n      if (value === undefined || value === '') continue;\n      // Never forwarded: the caller's own selectors are set above, and a listing query carrying\n      // them would otherwise decide the format twice.\n      if (key === COLLECTION_EXPORT_FORMAT_QUERY_PARAM || key === COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM) continue;\n      query.set(key, String(value));\n    }\n\n    // Frontend route paths omit `/api/v1`; re-add it to match the registered backend route.\n    return `${apiBaseUrl}${MAIN_API_BASE_PATH}${resolved}?${query.toString()}`;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Fetch the export through the AUTHENTICATED client and hand the bytes to the browser.\n *\n * A plain `<a href>` or `window.open` would issue an UNAUTHENTICATED request — the access token\n * lives in the http client, not in a cookie the browser would attach — so the download must go\n * through `getBlob` and be released as an object URL. The object URL is revoked immediately after\n * the click: leaving it alive pins the whole file in memory for the life of the document, and an\n * export is exactly the payload where that matters.\n */\nexport async function downloadCollectionExport(params: {\n  url: string;\n  resourceType: ResourceType;\n  format: ResourceCollectionExportFormat;\n  getBlob: (url: string) => Promise<Blob>;\n}): Promise<void> {\n  const blob = await params.getBlob(params.url);\n  const objectUrl = URL.createObjectURL(blob);\n  try {\n    const link = document.createElement('a');\n    link.href = objectUrl;\n    // The server already names the file in `Content-Disposition`, but a blob download does not see\n    // that header — the name has to be supplied here. Same builder as the server's, so the two\n    // agree instead of drifting.\n    link.download = buildCollectionExportFilename(String(params.resourceType), params.format, new Date());\n    document.body.appendChild(link);\n    link.click();\n    link.remove();\n  } finally {\n    URL.revokeObjectURL(objectUrl);\n  }\n}\n"]}

package/dist/esm/core/resources/context-resource-identifiers.frontend.utils.d.ts

@@ -0,0 +1,23 @@
+import type { FrontendResourceOperationContext } from './resources.frontend.schemas';
+export type ContextResourceIdentifiersInput = Map<string, string> | FrontendResourceOperationContext['contextResourceIdentifiers'] | Record<string, string | {
+    fieldIdentifier?: string;
+    resourceId?: string;
+}> | undefined;
+/**
+ * Flattens runtime context identifiers into the string-only shape expected by
+ * event payloads, websocket room claims, and backend execution-context builders.
+ * Object-shaped identifiers keep both the original key and their explicit FK
+ * alias so resource-type and relationship-field subscribers compare equally.
+ */
+export declare function normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers: ContextResourceIdentifiersInput): Record<string, string>;
+/**
+ * Outcome events need the real child-row id when a context-addressed mutation
+ * returns it. Add that identity without discarding the parent/FK identifiers
+ * used to route the operation.
+ */
+export declare function normalizeContextResourceIdentifiersForOutcome(params: {
+    contextResourceIdentifiers: ContextResourceIdentifiersInput;
+    resourceType: string;
+    result?: unknown;
+}): Record<string, string>;
+//# sourceMappingURL=context-resource-identifiers.frontend.utils.d.ts.map

package/dist/esm/core/resources/context-resource-identifiers.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resource-identifiers.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/context-resource-identifiers.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAGrF,MAAM,MAAM,+BAA+B,GACvC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACnB,gCAAgC,CAAC,4BAA4B,CAAC,GAC9D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1E,SAAS,CAAC;AAEd;;;;;GAKG;AACH,wBAAgB,+CAA+C,CAC7D,0BAA0B,EAAE,+BAA+B,GAC1D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBxB;AAwCD;;;;GAIG;AACH,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE;IACN,0BAA0B,EAAE,+BAA+B,CAAC;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB"}

package/dist/esm/core/resources/context-resource-identifiers.frontend.utils.js

@@ -0,0 +1,83 @@
+import { frontendResourceUtils } from './frontend-resource.utils.js';
+/**
+ * Flattens runtime context identifiers into the string-only shape expected by
+ * event payloads, websocket room claims, and backend execution-context builders.
+ * Object-shaped identifiers keep both the original key and their explicit FK
+ * alias so resource-type and relationship-field subscribers compare equally.
+ */
+export function normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers) {
+    if (!contextResourceIdentifiers) {
+        return {};
+    }
+    if (contextResourceIdentifiers instanceof Map) {
+        return Object.fromEntries(contextResourceIdentifiers.entries());
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(contextResourceIdentifiers)) {
+        const resourceId = frontendResourceUtils.getResourceId(value);
+        if (resourceId.length === 0) {
+            continue;
+        }
+        normalized[key] = resourceId;
+        const fieldIdentifier = frontendResourceUtils.getFieldIdentifier(value);
+        if (fieldIdentifier) {
+            normalized[fieldIdentifier] = resourceId;
+        }
+    }
+    return normalized;
+}
+function readPersistedResourceIdFromResult(result) {
+    if (typeof result === 'string' && result.length > 0) {
+        return result;
+    }
+    if (!result || typeof result !== 'object') {
+        return undefined;
+    }
+    const resultRecord = result;
+    /**
+     * `id` is read here DELIBERATELY, and it is not an adapter fallback.
+     *
+     * Resource rows carry `_id` on every adapter. The one operation result that names the identity
+     * `id` is the DELETE response (`DefaultDeleteResponseSchema` = `{ id, deletedAt? }`), which is a
+     * REST wire convention rather than a storage detail — so this reads a documented contract, not
+     * "whatever the database happened to attach".
+     *
+     * The distinction matters because the sibling fallbacks elsewhere were the other thing: `id` is
+     * also Mongoose's built-in virtual, present only on surrogate-primary-key resources and never on
+     * PostgreSQL. Those arms were removed; this one is kept because a delete result genuinely has no
+     * `_id`.
+     */
+    const directId = resultRecord._id ?? resultRecord.id;
+    if (typeof directId === 'string' && directId.length > 0) {
+        return directId;
+    }
+    for (const nestedKey of ['responseData', 'data', 'result']) {
+        const nestedId = readPersistedResourceIdFromResult(resultRecord[nestedKey]);
+        if (nestedId) {
+            return nestedId;
+        }
+    }
+    return undefined;
+}
+/**
+ * Outcome events need the real child-row id when a context-addressed mutation
+ * returns it. Add that identity without discarding the parent/FK identifiers
+ * used to route the operation.
+ */
+export function normalizeContextResourceIdentifiersForOutcome(params) {
+    const normalized = normalizeContextResourceIdentifiersForTransport(params.contextResourceIdentifiers);
+    const resultResourceId = readPersistedResourceIdFromResult(params.result);
+    if (resultResourceId) {
+        normalized[params.resourceType] = resultResourceId;
+        if (params.contextResourceIdentifiers
+            && !(params.contextResourceIdentifiers instanceof Map)) {
+            const resourceIdentifier = params.contextResourceIdentifiers[params.resourceType];
+            const fieldIdentifier = frontendResourceUtils.getFieldIdentifier(resourceIdentifier);
+            if (fieldIdentifier) {
+                normalized[fieldIdentifier] = resultResourceId;
+            }
+        }
+    }
+    return normalized;
+}
+//# sourceMappingURL=context-resource-identifiers.frontend.utils.js.map

package/dist/esm/core/resources/context-resource-identifiers.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resource-identifiers.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/context-resource-identifiers.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAQlE;;;;;GAKG;AACH,MAAM,UAAU,+CAA+C,CAC7D,0BAA2D;IAE3D,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,0BAA0B,YAAY,GAAG,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,WAAW,CAAC,0BAA0B,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACtE,MAAM,UAAU,GAAG,qBAAqB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,UAAU,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAC7B,MAAM,eAAe,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACxE,IAAI,eAAe,EAAE,CAAC;YACpB,UAAU,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,iCAAiC,CAAC,MAAe;IACxD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,MAAiC,CAAC;IACvD;;;;;;;;;;;;OAYG;IACH,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC;IACrD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,iCAAiC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5E,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6CAA6C,CAC3D,MAIC;IAED,MAAM,UAAU,GAAG,+CAA+C,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACtG,MAAM,gBAAgB,GAAG,iCAAiC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1E,IAAI,gBAAgB,EAAE,CAAC;QACrB,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,gBAAgB,CAAC;QACnD,IACE,MAAM,CAAC,0BAA0B;eAC9B,CAAC,CAAC,MAAM,CAAC,0BAA0B,YAAY,GAAG,CAAC,EACtD,CAAC;YACD,MAAM,kBAAkB,GAAG,MAAM,CAAC,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAClF,MAAM,eAAe,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;YACrF,IAAI,eAAe,EAAE,CAAC;gBACpB,UAAU,CAAC,eAAe,CAAC,GAAG,gBAAgB,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import type { FrontendResourceOperationContext } from './resources.frontend.schemas';\nimport { frontendResourceUtils } from './frontend-resource.utils';\n\nexport type ContextResourceIdentifiersInput =\n  | Map<string, string>\n  | FrontendResourceOperationContext['contextResourceIdentifiers']\n  | Record<string, string | { fieldIdentifier?: string; resourceId?: string }>\n  | undefined;\n\n/**\n * Flattens runtime context identifiers into the string-only shape expected by\n * event payloads, websocket room claims, and backend execution-context builders.\n * Object-shaped identifiers keep both the original key and their explicit FK\n * alias so resource-type and relationship-field subscribers compare equally.\n */\nexport function normalizeContextResourceIdentifiersForTransport(\n  contextResourceIdentifiers: ContextResourceIdentifiersInput,\n): Record<string, string> {\n  if (!contextResourceIdentifiers) {\n    return {};\n  }\n\n  if (contextResourceIdentifiers instanceof Map) {\n    return Object.fromEntries(contextResourceIdentifiers.entries());\n  }\n\n  const normalized: Record<string, string> = {};\n  for (const [key, value] of Object.entries(contextResourceIdentifiers)) {\n    const resourceId = frontendResourceUtils.getResourceId(value);\n    if (resourceId.length === 0) {\n      continue;\n    }\n\n    normalized[key] = resourceId;\n    const fieldIdentifier = frontendResourceUtils.getFieldIdentifier(value);\n    if (fieldIdentifier) {\n      normalized[fieldIdentifier] = resourceId;\n    }\n  }\n\n  return normalized;\n}\n\nfunction readPersistedResourceIdFromResult(result: unknown): string | undefined {\n  if (typeof result === 'string' && result.length > 0) {\n    return result;\n  }\n\n  if (!result || typeof result !== 'object') {\n    return undefined;\n  }\n\n  const resultRecord = result as Record<string, unknown>;\n  /**\n   * `id` is read here DELIBERATELY, and it is not an adapter fallback.\n   *\n   * Resource rows carry `_id` on every adapter. The one operation result that names the identity\n   * `id` is the DELETE response (`DefaultDeleteResponseSchema` = `{ id, deletedAt? }`), which is a\n   * REST wire convention rather than a storage detail — so this reads a documented contract, not\n   * \"whatever the database happened to attach\".\n   *\n   * The distinction matters because the sibling fallbacks elsewhere were the other thing: `id` is\n   * also Mongoose's built-in virtual, present only on surrogate-primary-key resources and never on\n   * PostgreSQL. Those arms were removed; this one is kept because a delete result genuinely has no\n   * `_id`.\n   */\n  const directId = resultRecord._id ?? resultRecord.id;\n  if (typeof directId === 'string' && directId.length > 0) {\n    return directId;\n  }\n\n  for (const nestedKey of ['responseData', 'data', 'result']) {\n    const nestedId = readPersistedResourceIdFromResult(resultRecord[nestedKey]);\n    if (nestedId) {\n      return nestedId;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Outcome events need the real child-row id when a context-addressed mutation\n * returns it. Add that identity without discarding the parent/FK identifiers\n * used to route the operation.\n */\nexport function normalizeContextResourceIdentifiersForOutcome(\n  params: {\n    contextResourceIdentifiers: ContextResourceIdentifiersInput;\n    resourceType: string;\n    result?: unknown;\n  },\n): Record<string, string> {\n  const normalized = normalizeContextResourceIdentifiersForTransport(params.contextResourceIdentifiers);\n  const resultResourceId = readPersistedResourceIdFromResult(params.result);\n  if (resultResourceId) {\n    normalized[params.resourceType] = resultResourceId;\n    if (\n      params.contextResourceIdentifiers\n      && !(params.contextResourceIdentifiers instanceof Map)\n    ) {\n      const resourceIdentifier = params.contextResourceIdentifiers[params.resourceType];\n      const fieldIdentifier = frontendResourceUtils.getFieldIdentifier(resourceIdentifier);\n      if (fieldIdentifier) {\n        normalized[fieldIdentifier] = resultResourceId;\n      }\n    }\n  }\n\n  return normalized;\n}\n"]}

package/dist/esm/core/resources/ephemeral-fields.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ephemeral-fields.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/ephemeral-fields.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,kBAAkB,EAAE,CAatB"}
+{"version":3,"file":"ephemeral-fields.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/ephemeral-fields.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,kBAAkB,EAAE,CAiBtB"}

package/dist/esm/core/resources/ephemeral-fields.utils.js

@@ -1,4 +1,5 @@
-import { isEphemeralField, getObjectShape } from '@wildo-ai/zod-decorators';
+import { isEphemeralField } from '@wildo-ai/zod-decorators';
+import { AutomatedLayoutFrontendUtils } from '../../core/automated-layout/automated-layout.frontend.utils.js';
 /**
  * Scans a Zod response schema and extracts fields marked with `.isEphemeral()`.
  * Returns only fields that have a truthy value in the response data.
@@ -6,7 +7,11 @@ import { isEphemeralField, getObjectShape } from '@wildo-ai/zod-decorators';
 export function extractEphemeralFields(responseSchema, responseData) {
     if (!responseSchema)
         return [];
-    const shape = getObjectShape(responseSchema);
+    // Union-aware: a polymorphic resource's response DTO is a discriminated union,
+    // for which the object-only `getObjectShape` returns null → no `.isEphemeral()`
+    // field is ever detected. `getObjectLikeFieldShape` merges the union variants
+    // (identical to getObjectShape for a plain-object response).
+    const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(responseSchema, { commonOnly: false });
     if (!shape)
         return [];
     const results = [];
@@ -17,4 +22,4 @@ export function extractEphemeralFields(responseSchema, responseData) {
     }
     return results;
 }
-//# sourceMappingURL=ephemeral-fields.utils.js.map
+//# sourceMappingURL=ephemeral-fields.utils.js.map

package/dist/esm/core/resources/ephemeral-fields.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"ephemeral-fields.utils.js","sourceRoot":"","sources":["../../../../src/core/resources/ephemeral-fields.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAQ5E;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAwC,EACxC,YAAqC;IAErC,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,CAAC;IAE/B,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,IAAI,gBAAgB,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"ephemeral-fields.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/ephemeral-fields.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2EAA2E,CAAC;AAQzH;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAwC,EACxC,YAAqC;IAErC,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,CAAC;IAE/B,+EAA+E;IAC/E,gFAAgF;IAChF,8EAA8E;IAC9E,6DAA6D;IAC7D,MAAM,KAAK,GAAG,4BAA4B,CAAC,uBAAuB,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1G,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,IAAI,gBAAgB,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { type z } from 'zod';\nimport { isEphemeralField } from '@wildo-ai/zod-decorators';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\n\nexport interface EphemeralFieldInfo {\n  fieldName: string;\n  value: unknown;\n  schema: z.ZodTypeAny;\n}\n\n/**\n * Scans a Zod response schema and extracts fields marked with `.isEphemeral()`.\n * Returns only fields that have a truthy value in the response data.\n */\nexport function extractEphemeralFields(\n  responseSchema: z.ZodTypeAny | undefined,\n  responseData: Record<string, unknown>\n): EphemeralFieldInfo[] {\n  if (!responseSchema) return [];\n\n  // Union-aware: a polymorphic resource's response DTO is a discriminated union,\n  // for which the object-only `getObjectShape` returns null → no `.isEphemeral()`\n  // field is ever detected. `getObjectLikeFieldShape` merges the union variants\n  // (identical to getObjectShape for a plain-object response).\n  const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(responseSchema, { commonOnly: false });\n  if (!shape) return [];\n\n  const results: EphemeralFieldInfo[] = [];\n  for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n    if (isEphemeralField(fieldSchema) && responseData[fieldName]) {\n      results.push({ fieldName, value: responseData[fieldName], schema: fieldSchema });\n    }\n  }\n  return results;\n}\n"]}

package/dist/esm/core/resources/file-serve-url.frontend.utils.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Shared builder for the resource-integrated file SERVE URL, used by every display
+ * surface that renders an inline file preview (the resource displayer AND standalone
+ * consumers like the nav user-menu avatar).
+ *
+ * The serve route is ENTITY-addressed:
+ *   `{apiBase}/api/v1/…/{resourceId}/files/{fieldName}/{fileId}`
+ * A context-addressed singleton READ (e.g. the user's own profile) has NO resourceId in
+ * its route, so the caller supplies `recordId` (the displayed record's own `_id`) which
+ * fills the `{resourceId}` segment — the same id the UPDATE/upload uses. This function
+ * returns the serve BASE (`…/{resourceId}/files/{fieldName}`, no fileId); the consumer
+ * appends `/{fileId}` per file. Returns `null` when the route can't be resolved (missing
+ * context / non-addressable) so callers degrade gracefully.
+ *
+ * Authorization for the served bytes inherits the parent resource's READ (enforced
+ * backend-side) — see `.claude/context/file-management.md`.
+ */
+import { FileServeVariant, type ResourceType } from '@wildo-ai/saas-models';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
+export interface BuildResourceFileServeBaseUrlParams {
+    registry: FrontendResourcesRegistry;
+    /** Resolved resource config (`registry.resourceConfigurations[resourceType]`). */
+    resourceConfig: any;
+    /** A url-bearing operation for the resource (typically the default READ). */
+    operation: any;
+    resourceType: ResourceType;
+    /** File field name on the resource (e.g. `avatar`). */
+    fieldName: string;
+    /** The displayed record's own id — fills the entity-addressed `{resourceId}` segment. */
+    recordId: string;
+    /** Parent-chain identifiers (resourceType → id), as on `resourceContext`. */
+    contextResourceIdentifiers: Record<string, string | {
+        fieldIdentifier?: string;
+        resourceId?: string;
+    }>;
+    /** Resolved placeholder params (`FrontendResourceUtils.buildContextualParameters(...)`). */
+    contextualParameters: Record<string, string | number>;
+    /** Optional parent-requirement hints from the resource context. */
+    parentResourcesRequirements?: any[];
+    apiBaseUrl: string;
+}
+/**
+ * Build the resource-integrated serve base URL for a file field, or `null` if it can't
+ * be resolved. See the module doc for the addressing contract.
+ */
+export declare function buildResourceFileServeBaseUrl(params: BuildResourceFileServeBaseUrlParams): string | null;
+/**
+ * Append a `?variant=` query parameter to a serve URL (base or with `/{fileId}`),
+ * selecting a rendition. `ORIGINAL` returns the URL unchanged (the route's default), so
+ * only `THUMBNAIL` actually adds the param. Preserves any pre-existing query string.
+ */
+export declare function appendFileServeVariant(serveUrl: string, variant: FileServeVariant): string;
+/**
+ * Convenience: the `?variant=thumbnail` preview URL for a served file — a small,
+ * downscaled `webp` rendition. Use for preview surfaces (nav avatar, list/card image);
+ * use the un-suffixed serve URL for a full-resolution view (e.g. a lightbox).
+ */
+export declare function buildFileServeThumbnailUrl(serveUrl: string): string;
+//# sourceMappingURL=file-serve-url.frontend.utils.d.ts.map

package/dist/esm/core/resources/file-serve-url.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-serve-url.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/file-serve-url.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAiE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG3I,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAE/G,MAAM,WAAW,mCAAmC;IAClD,QAAQ,EAAE,yBAAyB,CAAC;IACpC,kFAAkF;IAClF,cAAc,EAAE,GAAG,CAAC;IACpB,6EAA6E;IAC7E,SAAS,EAAE,GAAG,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAC3B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvG,4FAA4F;IAC5F,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,mEAAmE;IACnE,2BAA2B,CAAC,EAAE,GAAG,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,mCAAmC,GAAG,MAAM,GAAG,IAAI,CAqDxG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAI1F;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/esm/core/resources/file-serve-url.frontend.utils.js

@@ -0,0 +1,82 @@
+/**
+ * Shared builder for the resource-integrated file SERVE URL, used by every display
+ * surface that renders an inline file preview (the resource displayer AND standalone
+ * consumers like the nav user-menu avatar).
+ *
+ * The serve route is ENTITY-addressed:
+ *   `{apiBase}/api/v1/…/{resourceId}/files/{fieldName}/{fileId}`
+ * A context-addressed singleton READ (e.g. the user's own profile) has NO resourceId in
+ * its route, so the caller supplies `recordId` (the displayed record's own `_id`) which
+ * fills the `{resourceId}` segment — the same id the UPDATE/upload uses. This function
+ * returns the serve BASE (`…/{resourceId}/files/{fieldName}`, no fileId); the consumer
+ * appends `/{fileId}` per file. Returns `null` when the route can't be resolved (missing
+ * context / non-addressable) so callers degrade gracefully.
+ *
+ * Authorization for the served bytes inherits the parent resource's READ (enforced
+ * backend-side) — see `.claude/context/file-management.md`.
+ */
+import { ResourcesConfigOperationsUrlsBuilderUtils, MAIN_API_BASE_PATH, FileServeVariant } from '@wildo-ai/saas-models';
+import { NavigationUtils } from '../../core/navigation/navigation.utils.js';
+import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+/**
+ * Build the resource-integrated serve base URL for a file field, or `null` if it can't
+ * be resolved. See the module doc for the addressing contract.
+ */
+export function buildResourceFileServeBaseUrl(params) {
+    const { registry, resourceConfig, operation, resourceType, fieldName, recordId, contextResourceIdentifiers, contextualParameters, parentResourcesRequirements, apiBaseUrl, } = params;
+    if (!resourceConfig?.resourceFieldIdentifier || !recordId || !operation)
+        return null;
+    try {
+        const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(resourceConfig, operation, registry.allResourceFieldIdentifiers);
+        if (routePaths.length === 0)
+            return null;
+        const routePath = frontendResourceUtils.selectMatchingRoutePath(routePaths, contextResourceIdentifiers, resourceConfig.resourceIdentifier, resourceConfig.resourceFieldIdentifier, parentResourcesRequirements, 
+        // Pass the registry field-identifier map so a parent segment keyed by its STANDARD
+        // identifier can fall back to the broad resource-type context slot (how a nav /
+        // scope-derived caller resolves the parent id without an explicit field key).
+        registry.allResourceFieldIdentifiers);
+        // Serve params = the parent-chain identifiers PLUS the displayed record's own id under
+        // THIS resource's field identifier (the segment the READ route omits when singular).
+        const serveParams = {
+            ...contextualParameters,
+            [resourceConfig.resourceFieldIdentifier]: recordId,
+        };
+        const serveRoute = ResourcesConfigOperationsUrlsBuilderUtils.buildFileUploadRouteForOperation({
+            operationRouteUrl: routePath.url,
+            operationParameters: routePath.parameters,
+            targetResourceType: resourceType,
+            targetResourceFieldIdentifier: resourceConfig.resourceFieldIdentifier,
+            fieldName,
+            requiresTargetResourceId: true,
+            isFrontend: true,
+        });
+        const resolved = NavigationUtils.resolveUrlPath(serveRoute.url, serveParams);
+        if (NavigationUtils.hasUnresolvedPlaceholders(resolved))
+            return null;
+        // Frontend route paths omit `/api/v1`; re-add it to match the registered backend route.
+        return `${apiBaseUrl}${MAIN_API_BASE_PATH}${resolved}`;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Append a `?variant=` query parameter to a serve URL (base or with `/{fileId}`),
+ * selecting a rendition. `ORIGINAL` returns the URL unchanged (the route's default), so
+ * only `THUMBNAIL` actually adds the param. Preserves any pre-existing query string.
+ */
+export function appendFileServeVariant(serveUrl, variant) {
+    if (variant === FileServeVariant.ORIGINAL)
+        return serveUrl;
+    const separator = serveUrl.includes('?') ? '&' : '?';
+    return `${serveUrl}${separator}variant=${encodeURIComponent(variant)}`;
+}
+/**
+ * Convenience: the `?variant=thumbnail` preview URL for a served file — a small,
+ * downscaled `webp` rendition. Use for preview surfaces (nav avatar, list/card image);
+ * use the un-suffixed serve URL for a full-resolution view (e.g. a lightbox).
+ */
+export function buildFileServeThumbnailUrl(serveUrl) {
+    return appendFileServeVariant(serveUrl, FileServeVariant.THUMBNAIL);
+}
+//# sourceMappingURL=file-serve-url.frontend.utils.js.map