@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

package/dist/esm/core/resources/rmm/useResourceRMM.js.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceRMM.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared RMM lifecycle: registry lookup, transport adapter, getOrCreate, routing sync,\n * cleanup on unmount, snapshot subscription, and list invalidation.\n */\n\nimport { useContext, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport type { RefObject } from 'react';\nimport {\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { DoOperationFn } from './HttpTransportAdapter';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getOperationsForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickInlineFieldWriteOperation } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport { operationInitiatorParametersSatisfied } from '~wildo-frontend-lib/core/resources/operation-initiator-satisfaction.frontend.utils';\nimport { normalizeContextResourceIdentifiersForTransport } from '~wildo-frontend-lib/core/resources/context-resource-identifiers.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { UserOrgsContext } from '~wildo-frontend-lib/core/security/UserOrgsContext';\nimport { HttpTransportAdapter } from './HttpTransportAdapter';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMRegistry } from './RMMRegistry';\nimport { ConflictStrategy, type ConflictPolicy, type RMMSnapshot } from './types';\nimport { resolveCanonicalRMMReadOperationPathKey } from './canonical-read.frontend.utils';\nimport { useListInvalidation } from './useListInvalidation';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useResourceRMM');\nlogger.setDebugTypeLogging('useResourceRMM', false);\n\n/**\n * Stable default conflict policy. As an inline default-parameter object literal it\n * would mint a fresh identity on every render; `conflictPolicy` is a dependency of\n * the routing-sync effect below, so a fresh identity re-fires that effect (and its\n * `rmmRegistry.notifyInstanceRuntimeChanged()`) on every commit even when nothing\n * changed. A module constant keeps the default referentially stable.\n */\nconst DEFAULT_CONFLICT_POLICY: ConflictPolicy = { strategy: ConflictStrategy.ACCEPT_REMOTE };\n\nexport interface UseResourceRMMConfig {\n  resourceType: string;\n  /** When falsy, RMM is not attached (e.g. CREATE flow or missing id). */\n  resourceId: string | null | undefined;\n  doOperationRef: RefObject<DoOperationFn | null>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  resourceSchema?: unknown;\n  /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n  /**\n   * The caller runs directly when no RMM resolves (`UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK`),\n   * so `NO_ELIGIBLE_UPDATE_OPERATION` is an expected absence rather than an integration failure, and is\n   * logged at debug. Without it, a read-only row's declared action logged the \"should fail closed\" warning\n   * on every mount while working exactly as declared.\n   */\n  directFallbackAccepted?: boolean;\n}\n\nexport interface UseResourceRMMResult {\n  rmm: ResourceMutationManager | null;\n  rmmSnapshot: RMMSnapshot;\n  rmmRegistry: RMMRegistry | null;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  canonicalReadOperationPathKey: string | undefined;\n}\n\n/**\n * Why RMM is unattached for the current surface. Every reason fails closed\n * (`rmm === null`); the reason only drives diagnostics. Two of the reasons\n * are *expected absences* logged at debug, two are *genuine integration\n * failures* logged at warn — see the classification memo in\n * `useResourceRMM` for the precedence rules that keep expected absences out\n * of the loud lane.\n */\nexport enum UseResourceRMMUnavailableReason {\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id resolved an operation but no `RMMRegistryProvider` is mounted above it.\n   */\n  PROVIDER_MISSING = 'PROVIDER_MISSING',\n  /**\n   * Expected absence (debug): the caller explicitly opted out of RMM\n   * attachment (e.g. `enabled: isUpdateLikeOperation && !!resourceId` on a\n   * CREATE form).\n   */\n  DISABLED = 'DISABLED',\n  /**\n   * Expected absence (debug): no persisted resource id is attached yet\n   * (CREATE flow, parent-context singleton awaiting READ bootstrap). RMM is\n   * keyed by resource id and can never attach without one.\n   */\n  MISSING_RESOURCE_ID = 'MISSING_RESOURCE_ID',\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id could not resolve any eligible UPDATE-like operation. Default\n   * update-like surfaces fail closed on this unless they explicitly opt\n   * into a weaker direct-operation fallback.\n   */\n  NO_ELIGIBLE_UPDATE_OPERATION = 'NO_ELIGIBLE_UPDATE_OPERATION',\n}\n\nexport function useResourceRMM(config: UseResourceRMMConfig): UseResourceRMMResult {\n  const {\n    resourceType,\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers,\n    resourceSchema,\n    enabled = true,\n    conflictPolicy = DEFAULT_CONFLICT_POLICY,\n    directFallbackAccepted = false,\n  } = config;\n\n  const rmmRegistry = useContext(RMMRegistryContext);\n  const { registry } = useResourceRegistry();\n  const userOrgs = useContext(UserOrgsContext);\n  const scopedUserId = userOrgs?.primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so same-user websocket replay does not immediately degrade into the\n  // foreign-remote lane during runtime churn.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (userOrgs?.user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = userOrgs?.user?._id ?? scopedUserId!;\n  }\n  const currentUserId = userOrgs?.user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n\n  const contextResourceIdentifiersKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(contextResourceIdentifiers),\n    [contextResourceIdentifiers],\n  );\n  // Content-stable key for the routing-sync effect dependency below.\n  // `parentResourcesRequirements` arrives as a freshly-allocated array on most\n  // renders (callers build it inline, e.g. `buildParentResourcesRequirements(...)`),\n  // so depending on its *identity* re-fires the sync effect — and its\n  // `rmmRegistry.notifyInstanceRuntimeChanged()` — on every commit even when the\n  // requirements are unchanged, which storms the WebSocket room re-subscription.\n  // Keying by content mirrors `contextResourceIdentifiersKey`.\n  const parentResourcesRequirementsKey = useMemo(\n    () => JSON.stringify(parentResourcesRequirements ?? null),\n    [parentResourcesRequirements],\n  );\n  const resourceIdStr = resourceId ? String(resourceId) : '';\n\n  const transportAdapter = useMemo(\n    () => new HttpTransportAdapter((...args) => doOperationRef.current!(...args)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref\n    [],\n  );\n\n  const updateOperation = useMemo(() => {\n    return pickInlineFieldWriteOperation({\n      resourceConfig,\n      operations: resourceConfig?.operations ?? [],\n      registry,\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig, resourceIdStr]);\n\n  const rmmOperationPathKey = useMemo(() => {\n    if (!updateOperation) {\n      return null;\n    }\n\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n  }, [resourceType, updateOperation]);\n\n  const rmmReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig?.operations, resourceIdStr, resourceType]);\n\n  const listOperations = useMemo(\n    () => {\n      const { [resourceType]: _self, ...parentScopeIdentifiers } = contextResourceIdentifiers ?? {};\n      const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(\n        parentScopeIdentifiers,\n        registry,\n      );\n      return getOperationsForCoreSemantic(\n        resourceConfig?.operations ?? [],\n        CoreResourceOperation.LIST,\n      ).filter((listOperation) =>\n        operationInitiatorParametersSatisfied({\n          operation: listOperation,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          contextualParameters: parentContextualParameters,\n        })\n      );\n    },\n    [contextResourceIdentifiersKey, registry, resourceConfig?.operations, resourceType],\n  );\n\n  /**\n   * Classify why RMM is unattached, expected-absence checks first. The\n   * precedence matters because the reason drives log level downstream:\n   * `DISABLED` / `MISSING_RESOURCE_ID` are expected absences (debug),\n   * `NO_ELIGIBLE_UPDATE_OPERATION` / `PROVIDER_MISSING` are genuine\n   * integration failures (warn).\n   *\n   * - `!enabled` always classifies as DISABLED, even when no update\n   *   operation resolves: the caller explicitly opted out (the form /\n   *   displayer / layout callers gate `enabled` on `<update-like> && <has\n   *   id>`; the execution participation bridge gates it on execution-level\n   *   availability), so a CREATE surface must not be reported as an\n   *   operation-eligibility failure.\n   * - The missing-id check runs before operation eligibility: without an id\n   *   RMM can never attach (the registry is keyed by resource id), and\n   *   UPDATE addressability is resolved with `hasResourceId: false`, so an\n   *   unresolved operation on an id-less surface is the expected CREATE /\n   *   pre-bootstrap shape rather than a broken update-like surface.\n   *\n   * Rejected alternative: keeping the old loud-first order and only\n   * downgrading the log level — that would still misreport create-like\n   * surfaces as `NO_ELIGIBLE_UPDATE_OPERATION` to consumers of\n   * `rmmUnavailableReason`. All reasons keep failing closed (rmm === null);\n   * only classification and log level differ.\n   */\n  const rmmUnavailableReason = useMemo((): UseResourceRMMUnavailableReason | null => {\n    if (!enabled) {\n      return UseResourceRMMUnavailableReason.DISABLED;\n    }\n    if (!resourceIdStr) {\n      return UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID;\n    }\n    if (!updateOperation) {\n      return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;\n    }\n    if (!rmmRegistry) {\n      return UseResourceRMMUnavailableReason.PROVIDER_MISSING;\n    }\n\n    return null;\n  }, [enabled, resourceIdStr, rmmRegistry, updateOperation]);\n\n  const rmm = useMemo(() => {\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.DISABLED) {\n      logDebug('RMM unavailable because attachment is disabled for this surface.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {\n      logDebug('RMM unavailable because no resource id is attached to the current surface.', {\n        resourceType,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION && directFallbackAccepted) {\n      logDebug('RMM unavailable because no eligible UPDATE-like operation resolves; the caller runs directly, as the operation declared.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {\n      logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.PROVIDER_MISSING) {\n      logger.warn('[useResourceRMM] RMM unavailable because RMMRegistryProvider is not mounted. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n    return rmmRegistry.getOrCreate(resourceType, resourceIdStr, {\n      resourceType,\n      resourceId: resourceIdStr,\n      transportAdapter,\n      operationPathKey: rmmOperationPathKey!,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      resourceSchema,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- registry identity + sync effect for routing/auth\n  }, [directFallbackAccepted, rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);\n\n  useEffect(() => {\n    if (!rmm || !rmmOperationPathKey) return;\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      operationPathKey: rmmOperationPathKey,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      resourceSchema,\n    });\n    rmmRegistry?.notifyInstanceRuntimeChanged();\n  }, [\n    rmm,\n    rmmRegistry,\n    currentUserId,\n    // `ConflictPolicy` is `{ strategy }`; depend on the strategy value, not the\n    // (commonly inline, fresh-identity) object literal callers pass, so the sync\n    // effect does not re-fire — and re-notify — on every commit.\n    conflictPolicy.strategy,\n    contextResourceIdentifiersKey,\n    rmmOperationPathKey,\n    rmmReadOperationPathKey,\n    parentResourcesRequirementsKey,\n    contextualParameters,\n    resourceSchema,\n    transportAdapter,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !rmmRegistry || !resourceIdStr) {\n      return;\n    }\n\n    const key = rmmRegistry.keyFor(resourceType, resourceIdStr);\n    return () => {\n      rmmRegistry.release(key);\n    };\n  }, [rmm, rmmRegistry, resourceType, resourceIdStr]);\n\n  const rmmSnapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n\n  useListInvalidation(rmm, {\n    contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n    parentResourcesRequirements: parentResourcesRequirements ?? [],\n    listOperations,\n  });\n\n  return {\n    rmm,\n    rmmSnapshot,\n    rmmRegistry: rmmRegistry ?? null,\n    rmmUnavailableReason,\n    canonicalReadOperationPathKey: rmmReadOperationPathKey,\n  };\n}\n"]}
+{"version":3,"file":"useResourceRMM.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared RMM lifecycle: registry lookup, transport adapter, getOrCreate, routing sync,\n * cleanup on unmount, snapshot subscription, and list invalidation.\n */\n\nimport { useContext, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport type { RefObject } from 'react';\nimport {\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { DoOperationFn } from './HttpTransportAdapter';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getOperationsForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickInlineFieldWriteOperation, resolveRecordOrganizationId } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport { useViewerEffectiveRolesInOrganization } from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport { operationInitiatorParametersSatisfied } from '~wildo-frontend-lib/core/resources/operation-initiator-satisfaction.frontend.utils';\nimport { normalizeContextResourceIdentifiersForTransport } from '~wildo-frontend-lib/core/resources/context-resource-identifiers.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { UserOrgsContext } from '~wildo-frontend-lib/core/security/UserOrgsContext';\nimport { HttpTransportAdapter } from './HttpTransportAdapter';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMRegistry } from './RMMRegistry';\nimport { ConflictStrategy, type ConflictPolicy, type RMMSnapshot } from './types';\nimport { resolveCanonicalRMMReadOperationPathKey } from './canonical-read.frontend.utils';\nimport { useListInvalidation } from './useListInvalidation';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useResourceRMM');\nlogger.setDebugTypeLogging('useResourceRMM', false);\n\n/**\n * Stable default conflict policy. As an inline default-parameter object literal it\n * would mint a fresh identity on every render; `conflictPolicy` is a dependency of\n * the routing-sync effect below, so a fresh identity re-fires that effect (and its\n * `rmmRegistry.notifyInstanceRuntimeChanged()`) on every commit even when nothing\n * changed. A module constant keeps the default referentially stable.\n */\nconst DEFAULT_CONFLICT_POLICY: ConflictPolicy = { strategy: ConflictStrategy.ACCEPT_REMOTE };\n\nexport interface UseResourceRMMConfig {\n  resourceType: string;\n  /** When falsy, RMM is not attached (e.g. CREATE flow or missing id). */\n  resourceId: string | null | undefined;\n  doOperationRef: RefObject<DoOperationFn | null>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  resourceSchema?: unknown;\n  /** The resource's `inheritenceSchemaDefinition`, so a variant's CRDT fields are merge-tracked too (#2455). */\n  resourceInheritance?: unknown;\n  /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n  /**\n   * The caller runs directly when no RMM resolves (`UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK`),\n   * so `NO_ELIGIBLE_UPDATE_OPERATION` is an expected absence rather than an integration failure, and is\n   * logged at debug. Without it, a read-only row's declared action logged the \"should fail closed\" warning\n   * on every mount while working exactly as declared.\n   */\n  directFallbackAccepted?: boolean;\n}\n\nexport interface UseResourceRMMResult {\n  rmm: ResourceMutationManager | null;\n  rmmSnapshot: RMMSnapshot;\n  rmmRegistry: RMMRegistry | null;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  canonicalReadOperationPathKey: string | undefined;\n}\n\n/**\n * Why RMM is unattached for the current surface. Every reason fails closed\n * (`rmm === null`); the reason only drives diagnostics. Two of the reasons\n * are *expected absences* logged at debug, two are *genuine integration\n * failures* logged at warn — see the classification memo in\n * `useResourceRMM` for the precedence rules that keep expected absences out\n * of the loud lane.\n */\nexport enum UseResourceRMMUnavailableReason {\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id resolved an operation but no `RMMRegistryProvider` is mounted above it.\n   */\n  PROVIDER_MISSING = 'PROVIDER_MISSING',\n  /**\n   * Expected absence (debug): the caller explicitly opted out of RMM\n   * attachment (e.g. `enabled: isUpdateLikeOperation && !!resourceId` on a\n   * CREATE form).\n   */\n  DISABLED = 'DISABLED',\n  /**\n   * Expected absence (debug): no persisted resource id is attached yet\n   * (CREATE flow, parent-context singleton awaiting READ bootstrap). RMM is\n   * keyed by resource id and can never attach without one.\n   */\n  MISSING_RESOURCE_ID = 'MISSING_RESOURCE_ID',\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id could not resolve any eligible UPDATE-like operation. Default\n   * update-like surfaces fail closed on this unless they explicitly opt\n   * into a weaker direct-operation fallback.\n   */\n  NO_ELIGIBLE_UPDATE_OPERATION = 'NO_ELIGIBLE_UPDATE_OPERATION',\n}\n\nexport function useResourceRMM(config: UseResourceRMMConfig): UseResourceRMMResult {\n  const {\n    resourceType,\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers,\n    resourceSchema,\n    resourceInheritance,\n    enabled = true,\n    conflictPolicy = DEFAULT_CONFLICT_POLICY,\n    directFallbackAccepted = false,\n  } = config;\n\n  const rmmRegistry = useContext(RMMRegistryContext);\n  const { registry } = useResourceRegistry();\n  const userOrgs = useContext(UserOrgsContext);\n  const scopedUserId = userOrgs?.primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so same-user websocket replay does not immediately degrade into the\n  // foreign-remote lane during runtime churn.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (userOrgs?.user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = userOrgs?.user?._id ?? scopedUserId!;\n  }\n  const currentUserId = userOrgs?.user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n\n  const contextResourceIdentifiersKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(contextResourceIdentifiers),\n    [contextResourceIdentifiers],\n  );\n  // Content-stable key for the routing-sync effect dependency below.\n  // `parentResourcesRequirements` arrives as a freshly-allocated array on most\n  // renders (callers build it inline, e.g. `buildParentResourcesRequirements(...)`),\n  // so depending on its *identity* re-fires the sync effect — and its\n  // `rmmRegistry.notifyInstanceRuntimeChanged()` — on every commit even when the\n  // requirements are unchanged, which storms the WebSocket room re-subscription.\n  // Keying by content mirrors `contextResourceIdentifiersKey`.\n  const parentResourcesRequirementsKey = useMemo(\n    () => JSON.stringify(parentResourcesRequirements ?? null),\n    [parentResourcesRequirements],\n  );\n  const resourceIdStr = resourceId ? String(resourceId) : '';\n\n  const transportAdapter = useMemo(\n    () => new HttpTransportAdapter((...args) => doOperationRef.current!(...args)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref\n    [],\n  );\n\n  // The viewer's roles in the tenant this record belongs to, which the in-place write pick asks about (#2473).\n  const inlineWriteViewer = useViewerEffectiveRolesInOrganization(\n    resolveRecordOrganizationId(resourceType, resourceIdStr || undefined, contextResourceIdentifiers as Record<string, unknown> | undefined),\n  );\n\n  const updateOperation = useMemo(() => {\n    return pickInlineFieldWriteOperation({\n      resourceConfig,\n      operations: resourceConfig?.operations ?? [],\n      registry,\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n      viewer: inlineWriteViewer,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig, resourceIdStr, inlineWriteViewer]);\n\n  const rmmOperationPathKey = useMemo(() => {\n    if (!updateOperation) {\n      return null;\n    }\n\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n  }, [resourceType, updateOperation]);\n\n  const rmmReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig?.operations, resourceIdStr, resourceType]);\n\n  const listOperations = useMemo(\n    () => {\n      const { [resourceType]: _self, ...parentScopeIdentifiers } = contextResourceIdentifiers ?? {};\n      const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(\n        parentScopeIdentifiers,\n        registry,\n      );\n      return getOperationsForCoreSemantic(\n        resourceConfig?.operations ?? [],\n        CoreResourceOperation.LIST,\n      ).filter((listOperation) =>\n        operationInitiatorParametersSatisfied({\n          operation: listOperation,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          contextualParameters: parentContextualParameters,\n        })\n      );\n    },\n    [contextResourceIdentifiersKey, registry, resourceConfig?.operations, resourceType],\n  );\n\n  /**\n   * Classify why RMM is unattached, expected-absence checks first. The\n   * precedence matters because the reason drives log level downstream:\n   * `DISABLED` / `MISSING_RESOURCE_ID` are expected absences (debug),\n   * `NO_ELIGIBLE_UPDATE_OPERATION` / `PROVIDER_MISSING` are genuine\n   * integration failures (warn).\n   *\n   * - `!enabled` always classifies as DISABLED, even when no update\n   *   operation resolves: the caller explicitly opted out (the form /\n   *   displayer / layout callers gate `enabled` on `<update-like> && <has\n   *   id>`; the execution participation bridge gates it on execution-level\n   *   availability), so a CREATE surface must not be reported as an\n   *   operation-eligibility failure.\n   * - The missing-id check runs before operation eligibility: without an id\n   *   RMM can never attach (the registry is keyed by resource id), and\n   *   UPDATE addressability is resolved with `hasResourceId: false`, so an\n   *   unresolved operation on an id-less surface is the expected CREATE /\n   *   pre-bootstrap shape rather than a broken update-like surface.\n   *\n   * Rejected alternative: keeping the old loud-first order and only\n   * downgrading the log level — that would still misreport create-like\n   * surfaces as `NO_ELIGIBLE_UPDATE_OPERATION` to consumers of\n   * `rmmUnavailableReason`. All reasons keep failing closed (rmm === null);\n   * only classification and log level differ.\n   */\n  const rmmUnavailableReason = useMemo((): UseResourceRMMUnavailableReason | null => {\n    if (!enabled) {\n      return UseResourceRMMUnavailableReason.DISABLED;\n    }\n    if (!resourceIdStr) {\n      return UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID;\n    }\n    if (!updateOperation) {\n      return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;\n    }\n    if (!rmmRegistry) {\n      return UseResourceRMMUnavailableReason.PROVIDER_MISSING;\n    }\n\n    return null;\n  }, [enabled, resourceIdStr, rmmRegistry, updateOperation]);\n\n  const rmm = useMemo(() => {\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.DISABLED) {\n      logDebug('RMM unavailable because attachment is disabled for this surface.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {\n      logDebug('RMM unavailable because no resource id is attached to the current surface.', {\n        resourceType,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION && directFallbackAccepted) {\n      logDebug('RMM unavailable because no eligible UPDATE-like operation resolves; the caller runs directly, as the operation declared.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {\n      logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.PROVIDER_MISSING) {\n      logger.warn('[useResourceRMM] RMM unavailable because RMMRegistryProvider is not mounted. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n    return rmmRegistry.getOrCreate(resourceType, resourceIdStr, {\n      resourceType,\n      resourceId: resourceIdStr,\n      transportAdapter,\n      operationPathKey: rmmOperationPathKey!,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      resourceSchema,\n      resourceInheritance,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- registry identity + sync effect for routing/auth\n  }, [directFallbackAccepted, rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);\n\n  useEffect(() => {\n    if (!rmm || !rmmOperationPathKey) return;\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      operationPathKey: rmmOperationPathKey,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      resourceSchema,\n      resourceInheritance,\n    });\n    rmmRegistry?.notifyInstanceRuntimeChanged();\n  }, [\n    rmm,\n    rmmRegistry,\n    currentUserId,\n    // `ConflictPolicy` is `{ strategy }`; depend on the strategy value, not the\n    // (commonly inline, fresh-identity) object literal callers pass, so the sync\n    // effect does not re-fire — and re-notify — on every commit.\n    conflictPolicy.strategy,\n    contextResourceIdentifiersKey,\n    rmmOperationPathKey,\n    rmmReadOperationPathKey,\n    parentResourcesRequirementsKey,\n    contextualParameters,\n    resourceSchema,\n    resourceInheritance,\n    transportAdapter,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !rmmRegistry || !resourceIdStr) {\n      return;\n    }\n\n    const key = rmmRegistry.keyFor(resourceType, resourceIdStr);\n    return () => {\n      rmmRegistry.release(key);\n    };\n  }, [rmm, rmmRegistry, resourceType, resourceIdStr]);\n\n  const rmmSnapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n\n  useListInvalidation(rmm, {\n    contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n    parentResourcesRequirements: parentResourcesRequirements ?? [],\n    listOperations,\n  });\n\n  return {\n    rmm,\n    rmmSnapshot,\n    rmmRegistry: rmmRegistry ?? null,\n    rmmUnavailableReason,\n    canonicalReadOperationPathKey: rmmReadOperationPathKey,\n  };\n}\n"]}

package/dist/esm/core/resources/temporal-day-groups.frontend.utils.d.ts

@@ -0,0 +1,22 @@
+import type { z } from 'zod';
+import type { DateValueOptions } from '@wildo-ai/presets-components-models';
+/** One run of consecutive rows sharing a displayed day; `label` is `null` for rows with no usable date. */
+export interface TemporalDayGroup<TItem> {
+    key: string;
+    label: string | null;
+    items: TItem[];
+}
+/**
+ * Groups a fetched page of rows by the DAY `field` is shown at, keeping the page's order: a new group starts each
+ * time the day changes, so the server's sort decides the order of the groups.
+ *
+ * The day is the one the formatter prints, so the heading and the grouping can never disagree. Whether the field
+ * is a CALENDAR DAY is read from the resource's own `mainSchema` here, not passed in, so a caller cannot group a
+ * calendar field as instants by leaving a flag out: a calendar day groups by its UTC day, the same for every
+ * reader, and an instant by the reader's day in their zone (#2180). A row whose value is absent or not a date goes
+ * in an unlabelled group.
+ */
+export declare function groupItemsByDisplayedDay<TItem>(items: readonly TItem[], field: string, mainSchema: z.ZodTypeAny | undefined, formatDate: (value: Date, options?: DateValueOptions) => string, 
+/** The resource's `inheritenceSchemaDefinition`, so a variant's calendar-day field groups by day too (#2455). */
+inheritance?: unknown): TemporalDayGroup<TItem>[];
+//# sourceMappingURL=temporal-day-groups.frontend.utils.d.ts.map

package/dist/esm/core/resources/temporal-day-groups.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-day-groups.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/temporal-day-groups.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAG5E,2GAA2G;AAC3G,MAAM,WAAW,gBAAgB,CAAC,KAAK;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,KAAK,EAAE,CAAC;CAChB;AAID;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAC5C,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EACpC,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,MAAM;AAC/D,iHAAiH;AACjH,WAAW,CAAC,EAAE,OAAO,GACpB,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAa3B"}

package/dist/esm/core/resources/temporal-day-groups.frontend.utils.js

@@ -0,0 +1,31 @@
+import { calendarDateFieldNames } from '../../core/resources/calendar-date-fields.frontend.utils.js';
+const UNGROUPED_KEY = '__wildo-ungrouped__';
+/**
+ * Groups a fetched page of rows by the DAY `field` is shown at, keeping the page's order: a new group starts each
+ * time the day changes, so the server's sort decides the order of the groups.
+ *
+ * The day is the one the formatter prints, so the heading and the grouping can never disagree. Whether the field
+ * is a CALENDAR DAY is read from the resource's own `mainSchema` here, not passed in, so a caller cannot group a
+ * calendar field as instants by leaving a flag out: a calendar day groups by its UTC day, the same for every
+ * reader, and an instant by the reader's day in their zone (#2180). A row whose value is absent or not a date goes
+ * in an unlabelled group.
+ */
+export function groupItemsByDisplayedDay(items, field, mainSchema, formatDate, 
+/** The resource's `inheritenceSchemaDefinition`, so a variant's calendar-day field groups by day too (#2455). */
+inheritance) {
+    const calendarDate = calendarDateFieldNames(mainSchema, inheritance).has(field);
+    const groups = [];
+    for (const item of items) {
+        const raw = item[field];
+        const date = raw instanceof Date ? raw : typeof raw === 'string' || typeof raw === 'number' ? new Date(raw) : null;
+        const label = date && !Number.isNaN(date.getTime()) ? formatDate(date, { calendarDate }) : null;
+        const key = label ?? UNGROUPED_KEY;
+        const current = groups[groups.length - 1];
+        if (current && current.key === key)
+            current.items.push(item);
+        else
+            groups.push({ key, label, items: [item] });
+    }
+    return groups;
+}
+//# sourceMappingURL=temporal-day-groups.frontend.utils.js.map

package/dist/esm/core/resources/temporal-day-groups.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-day-groups.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/temporal-day-groups.frontend.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wEAAwE,CAAC;AAShH,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAuB,EACvB,KAAa,EACb,UAAoC,EACpC,UAA+D;AAC/D,iHAAiH;AACjH,WAAqB;IAErB,MAAM,YAAY,GAAG,sBAAsB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChF,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAI,IAAgC,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnH,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,MAAM,GAAG,GAAG,KAAK,IAAI,aAAa,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,KAAK,GAAG;YAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACxD,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type { z } from 'zod';\nimport type { DateValueOptions } from '@wildo-ai/presets-components-models';\nimport { calendarDateFieldNames } from '~wildo-frontend-lib/core/resources/calendar-date-fields.frontend.utils';\n\n/** One run of consecutive rows sharing a displayed day; `label` is `null` for rows with no usable date. */\nexport interface TemporalDayGroup<TItem> {\n  key: string;\n  label: string | null;\n  items: TItem[];\n}\n\nconst UNGROUPED_KEY = '__wildo-ungrouped__';\n\n/**\n * Groups a fetched page of rows by the DAY `field` is shown at, keeping the page's order: a new group starts each\n * time the day changes, so the server's sort decides the order of the groups.\n *\n * The day is the one the formatter prints, so the heading and the grouping can never disagree. Whether the field\n * is a CALENDAR DAY is read from the resource's own `mainSchema` here, not passed in, so a caller cannot group a\n * calendar field as instants by leaving a flag out: a calendar day groups by its UTC day, the same for every\n * reader, and an instant by the reader's day in their zone (#2180). A row whose value is absent or not a date goes\n * in an unlabelled group.\n */\nexport function groupItemsByDisplayedDay<TItem>(\n  items: readonly TItem[],\n  field: string,\n  mainSchema: z.ZodTypeAny | undefined,\n  formatDate: (value: Date, options?: DateValueOptions) => string,\n  /** The resource's `inheritenceSchemaDefinition`, so a variant's calendar-day field groups by day too (#2455). */\n  inheritance?: unknown,\n): TemporalDayGroup<TItem>[] {\n  const calendarDate = calendarDateFieldNames(mainSchema, inheritance).has(field);\n  const groups: TemporalDayGroup<TItem>[] = [];\n  for (const item of items) {\n    const raw = (item as Record<string, unknown>)[field];\n    const date = raw instanceof Date ? raw : typeof raw === 'string' || typeof raw === 'number' ? new Date(raw) : null;\n    const label = date && !Number.isNaN(date.getTime()) ? formatDate(date, { calendarDate }) : null;\n    const key = label ?? UNGROUPED_KEY;\n    const current = groups[groups.length - 1];\n    if (current && current.key === key) current.items.push(item);\n    else groups.push({ key, label, items: [item] });\n  }\n  return groups;\n}\n"]}

package/dist/esm/core/resources/ui-behavior-presentation.frontend.utils.d.ts

@@ -0,0 +1,36 @@
+import type { z } from 'zod';
+/**
+ * A ui-behavior's PRESENTATION composed onto `target`: what `presented` changes relative to `declared`, the schema the
+ * ui-behavior was given (#2918).
+ *
+ * A ui-behavior is declared over the schema its author holds, and presents that schema with its `fields` (and
+ * `schemaOverride`) composed in. The schema the resource actually HAS is often a different one: the resource factory
+ * adds fields (a polymorphic variant's parent key, `retentionStatus` / `impersonalizedAt` for a resource with a
+ * `retentionPolicy`, an http-api resource's tenant anchor) and re-decorates some it was given (a polymorphic variant's
+ * business keys). Taking the presented schema whole dropped every one of those on the frontend, so the presentation is
+ * composed onto the resource's schema instead, key by key:
+ *
+ * - a field the ui-behavior left alone (`presented[k] === declared[k]`) stays `target`'s;
+ * - a field it decorated, which `target` still holds as declared, becomes the presented copy;
+ * - a field it decorated, which `target` holds as a DIFFERENT instance (the factory's own copy, or an earlier
+ *   presentation), becomes an owned copy of `target`'s field carrying the decorator entries the presentation added,
+ *   which win per decorator. Only those `SCHEMA_METADATA` entries travel on this path, written on the field's OUTER
+ *   node: a structural change made in `fields` (a wrapper, a nested leaf), registry metadata (`.describe()`) and a
+ *   mirror onto a wrapper's inner type reach only a field `target` holds as declared. Readers resolve metadata through
+ *   wrappers (`getCustomFieldMetadata`), and no engine preset takes this path (measured 2026-10-19, 0 of 463
+ *   decorated keys); replaying the entries through `addDecorators` was not done, as a stored entry is not always the
+ *   params its decorator was called with.
+ *
+ * With `objectLevel`, the decorator entries the presented OBJECT adds (`schemaOverride: schema.objectUI(…)`) are
+ * carried the same way. Fields the presentation names that `target` lacks are not added: `target` is the resource's
+ * schema, and a field it does not declare is not the resource's.
+ *
+ * Returns `target` itself when the presentation changes nothing in it, and `presented` when any of the three is not an
+ * object schema, where nothing can be composed by key (as the presented schema always stood before).
+ *
+ * Never writes any of its inputs.
+ */
+export declare function composeUiBehaviorPresentation<T extends z.ZodTypeAny>(target: T, declared: z.ZodTypeAny, presented: z.ZodTypeAny, options?: {
+    readonly objectLevel?: boolean;
+}): T;
+//# sourceMappingURL=ui-behavior-presentation.frontend.utils.d.ts.map

package/dist/esm/core/resources/ui-behavior-presentation.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-behavior-presentation.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/ui-behavior-presentation.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuB7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAClE,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,CAAC,CAAC,UAAU,EACtB,SAAS,EAAE,CAAC,CAAC,UAAU,EACvB,OAAO,GAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,CAAC,CAmCH"}

package/dist/esm/core/resources/ui-behavior-presentation.frontend.utils.js

@@ -0,0 +1,88 @@
+import { addDecorators, getZodObjectShape, SCHEMA_METADATA, withObjectFields } from '@wildo-ai/zod-decorators';
+function isObjectSchema(schema) {
+    return schema?._zod?.def?.type === 'object';
+}
+/** The decorator entries `presented` carries that `declared` does not carry as the same value. */
+function metadataDelta(declared, presented) {
+    const presentedMetadata = presented[SCHEMA_METADATA] ?? {};
+    const declaredMetadata = declared[SCHEMA_METADATA] ?? {};
+    return Object.fromEntries(Object.entries(presentedMetadata).filter(([key, value]) => declaredMetadata[key] !== value));
+}
+/** An owned copy of `schema` (`addDecorators` with nothing to add only copies) carrying `delta` over its own metadata. */
+function withMetadataDelta(schema, delta) {
+    const copy = addDecorators(schema, []);
+    copy[SCHEMA_METADATA] = { ...(copy[SCHEMA_METADATA] ?? {}), ...delta };
+    return copy;
+}
+/**
+ * A ui-behavior's PRESENTATION composed onto `target`: what `presented` changes relative to `declared`, the schema the
+ * ui-behavior was given (#2918).
+ *
+ * A ui-behavior is declared over the schema its author holds, and presents that schema with its `fields` (and
+ * `schemaOverride`) composed in. The schema the resource actually HAS is often a different one: the resource factory
+ * adds fields (a polymorphic variant's parent key, `retentionStatus` / `impersonalizedAt` for a resource with a
+ * `retentionPolicy`, an http-api resource's tenant anchor) and re-decorates some it was given (a polymorphic variant's
+ * business keys). Taking the presented schema whole dropped every one of those on the frontend, so the presentation is
+ * composed onto the resource's schema instead, key by key:
+ *
+ * - a field the ui-behavior left alone (`presented[k] === declared[k]`) stays `target`'s;
+ * - a field it decorated, which `target` still holds as declared, becomes the presented copy;
+ * - a field it decorated, which `target` holds as a DIFFERENT instance (the factory's own copy, or an earlier
+ *   presentation), becomes an owned copy of `target`'s field carrying the decorator entries the presentation added,
+ *   which win per decorator. Only those `SCHEMA_METADATA` entries travel on this path, written on the field's OUTER
+ *   node: a structural change made in `fields` (a wrapper, a nested leaf), registry metadata (`.describe()`) and a
+ *   mirror onto a wrapper's inner type reach only a field `target` holds as declared. Readers resolve metadata through
+ *   wrappers (`getCustomFieldMetadata`), and no engine preset takes this path (measured 2026-10-19, 0 of 463
+ *   decorated keys); replaying the entries through `addDecorators` was not done, as a stored entry is not always the
+ *   params its decorator was called with.
+ *
+ * With `objectLevel`, the decorator entries the presented OBJECT adds (`schemaOverride: schema.objectUI(…)`) are
+ * carried the same way. Fields the presentation names that `target` lacks are not added: `target` is the resource's
+ * schema, and a field it does not declare is not the resource's.
+ *
+ * Returns `target` itself when the presentation changes nothing in it, and `presented` when any of the three is not an
+ * object schema, where nothing can be composed by key (as the presented schema always stood before).
+ *
+ * Never writes any of its inputs.
+ */
+export function composeUiBehaviorPresentation(target, declared, presented, options = {}) {
+    if (presented === declared)
+        return target;
+    if (!isObjectSchema(target) || !isObjectSchema(declared) || !isObjectSchema(presented))
+        return presented;
+    const targetShape = getZodObjectShape(target);
+    const declaredShape = getZodObjectShape(declared);
+    const presentedShape = getZodObjectShape(presented);
+    const replacements = {};
+    for (const [key, presentedField] of Object.entries(presentedShape)) {
+        const declaredField = declaredShape[key];
+        const targetField = targetShape[key];
+        if (declaredField === undefined || targetField === undefined)
+            continue;
+        if (presentedField === declaredField || targetField === presentedField)
+            continue;
+        if (targetField === declaredField) {
+            replacements[key] = presentedField;
+            continue;
+        }
+        const delta = metadataDelta(declaredField, presentedField);
+        if (Object.keys(delta).length > 0)
+            replacements[key] = withMetadataDelta(targetField, delta);
+    }
+    let composed = Object.keys(replacements).length === 0 ? target : withObjectFields(target, replacements);
+    if (options.objectLevel) {
+        const objectDelta = metadataDelta(declared, presented);
+        if (Object.keys(objectDelta).length > 0) {
+            if (composed === target) {
+                composed = withMetadataDelta(target, objectDelta);
+            }
+            else {
+                // `composed` is a copy this function made, so its metadata is written in place.
+                const owned = composed;
+                owned[SCHEMA_METADATA] = { ...(owned[SCHEMA_METADATA] ?? {}), ...objectDelta };
+            }
+        }
+    }
+    return composed;
+}
+//# sourceMappingURL=ui-behavior-presentation.frontend.utils.js.map

package/dist/esm/core/resources/ui-behavior-presentation.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-behavior-presentation.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/ui-behavior-presentation.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { z } from 'zod';\nimport { addDecorators, getZodObjectShape, SCHEMA_METADATA, withObjectFields } from '@wildo-ai/zod-decorators';\n\ntype MetadataHolder = Record<symbol, Record<string, unknown> | undefined>;\n\nfunction isObjectSchema(schema: unknown): boolean {\n  return (schema as { _zod?: { def?: { type?: string } } } | undefined)?._zod?.def?.type === 'object';\n}\n\n/** The decorator entries `presented` carries that `declared` does not carry as the same value. */\nfunction metadataDelta(declared: unknown, presented: unknown): Record<string, unknown> {\n  const presentedMetadata = (presented as MetadataHolder)[SCHEMA_METADATA] ?? {};\n  const declaredMetadata = (declared as MetadataHolder)[SCHEMA_METADATA] ?? {};\n  return Object.fromEntries(Object.entries(presentedMetadata).filter(([key, value]) => declaredMetadata[key] !== value));\n}\n\n/** An owned copy of `schema` (`addDecorators` with nothing to add only copies) carrying `delta` over its own metadata. */\nfunction withMetadataDelta<T extends z.ZodTypeAny>(schema: T, delta: Record<string, unknown>): T {\n  const copy = addDecorators(schema, []) as unknown as MetadataHolder;\n  copy[SCHEMA_METADATA] = { ...(copy[SCHEMA_METADATA] ?? {}), ...delta };\n  return copy as unknown as T;\n}\n\n/**\n * A ui-behavior's PRESENTATION composed onto `target`: what `presented` changes relative to `declared`, the schema the\n * ui-behavior was given (#2918).\n *\n * A ui-behavior is declared over the schema its author holds, and presents that schema with its `fields` (and\n * `schemaOverride`) composed in. The schema the resource actually HAS is often a different one: the resource factory\n * adds fields (a polymorphic variant's parent key, `retentionStatus` / `impersonalizedAt` for a resource with a\n * `retentionPolicy`, an http-api resource's tenant anchor) and re-decorates some it was given (a polymorphic variant's\n * business keys). Taking the presented schema whole dropped every one of those on the frontend, so the presentation is\n * composed onto the resource's schema instead, key by key:\n *\n * - a field the ui-behavior left alone (`presented[k] === declared[k]`) stays `target`'s;\n * - a field it decorated, which `target` still holds as declared, becomes the presented copy;\n * - a field it decorated, which `target` holds as a DIFFERENT instance (the factory's own copy, or an earlier\n *   presentation), becomes an owned copy of `target`'s field carrying the decorator entries the presentation added,\n *   which win per decorator. Only those `SCHEMA_METADATA` entries travel on this path, written on the field's OUTER\n *   node: a structural change made in `fields` (a wrapper, a nested leaf), registry metadata (`.describe()`) and a\n *   mirror onto a wrapper's inner type reach only a field `target` holds as declared. Readers resolve metadata through\n *   wrappers (`getCustomFieldMetadata`), and no engine preset takes this path (measured 2026-10-19, 0 of 463\n *   decorated keys); replaying the entries through `addDecorators` was not done, as a stored entry is not always the\n *   params its decorator was called with.\n *\n * With `objectLevel`, the decorator entries the presented OBJECT adds (`schemaOverride: schema.objectUI(…)`) are\n * carried the same way. Fields the presentation names that `target` lacks are not added: `target` is the resource's\n * schema, and a field it does not declare is not the resource's.\n *\n * Returns `target` itself when the presentation changes nothing in it, and `presented` when any of the three is not an\n * object schema, where nothing can be composed by key (as the presented schema always stood before).\n *\n * Never writes any of its inputs.\n */\nexport function composeUiBehaviorPresentation<T extends z.ZodTypeAny>(\n  target: T,\n  declared: z.ZodTypeAny,\n  presented: z.ZodTypeAny,\n  options: { readonly objectLevel?: boolean } = {},\n): T {\n  if (presented === declared) return target;\n  if (!isObjectSchema(target) || !isObjectSchema(declared) || !isObjectSchema(presented)) return presented as T;\n  const targetShape = getZodObjectShape(target) as Record<string, z.ZodTypeAny>;\n  const declaredShape = getZodObjectShape(declared) as Record<string, z.ZodTypeAny>;\n  const presentedShape = getZodObjectShape(presented) as Record<string, z.ZodTypeAny>;\n\n  const replacements: Record<string, z.ZodTypeAny> = {};\n  for (const [key, presentedField] of Object.entries(presentedShape)) {\n    const declaredField = declaredShape[key];\n    const targetField = targetShape[key];\n    if (declaredField === undefined || targetField === undefined) continue;\n    if (presentedField === declaredField || targetField === presentedField) continue;\n    if (targetField === declaredField) {\n      replacements[key] = presentedField;\n      continue;\n    }\n    const delta = metadataDelta(declaredField, presentedField);\n    if (Object.keys(delta).length > 0) replacements[key] = withMetadataDelta(targetField, delta);\n  }\n\n  let composed = Object.keys(replacements).length === 0 ? target : withObjectFields(target, replacements);\n  if (options.objectLevel) {\n    const objectDelta = metadataDelta(declared, presented);\n    if (Object.keys(objectDelta).length > 0) {\n      if (composed === target) {\n        composed = withMetadataDelta(target, objectDelta);\n      } else {\n        // `composed` is a copy this function made, so its metadata is written in place.\n        const owned = composed as unknown as MetadataHolder;\n        owned[SCHEMA_METADATA] = { ...(owned[SCHEMA_METADATA] ?? {}), ...objectDelta };\n      }\n    }\n  }\n  return composed;\n}\n"]}

package/dist/esm/core/resources/useBulkJobProgress.d.ts

@@ -5,6 +5,12 @@ export interface BulkJobFailure {
 }
 export interface BulkJobProgress {
     jobId: string;
+    /**
+     * The operation the run executes, as the server reports it — absent only in the seeded state before
+     * the first event. A refusal is explained in that operation's own words (its authored
+     * `unavailableReason`) rather than the generic reference's (#2264), so the panel needs to know it.
+     */
+    operationIdentifier?: string;
     attemptedCount: number;
     processedCount: number;
     failedCount: number;

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

@@ -1 +1 @@
-{"version":3,"file":"useBulkJobProgress.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useBulkJobProgress.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAqChH"}
+{"version":3,"file":"useBulkJobProgress.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useBulkJobProgress.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAsChH"}

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

@@ -38,6 +38,7 @@ export function useBulkJobProgress(run) {
                 return;
             setProgress({
                 jobId: payload.jobId,
+                operationIdentifier: payload.operationIdentifier,
                 attemptedCount: payload.attemptedCount,
                 processedCount: payload.processedCount,
                 failedCount: payload.failedCount,

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

@@ -1 +1 @@
-{"version":3,"file":"useBulkJobProgress.js","sourceRoot":"","sources":["../../../../../src/core/resources/useBulkJobProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAqC,MAAM,yDAAyD,CAAC;AAqB5H,MAAM,UAAU,kBAAkB,CAAC,GAAqD;IACtF,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAyB,IAAI,CAAC,CAAC;IAEvE,yFAAyF;IACzF,gGAAgG;IAChG,4FAA4F;IAC5F,8CAA8C;IAC9C,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IACjC,MAAM,cAAc,GAAG,GAAG,EAAE,cAAc,IAAI,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,gGAAgG;QAChG,6FAA6F;QAC7F,8CAA8C;QAC9C,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAEzG,OAAO,EAAE,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,OAAqC,EAAE,EAAE;YACpF,wDAAwD;YACxD,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;gBAAE,OAAO;YACpC,WAAW,CAAC;gBACV,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;aACjC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAEhC,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Follow a background BULK run started by this surface (#1461).\n *\n * The run's rows change one at a time and each broadcasts its own sync event, so the listing\n * updates itself while the job works. What this adds is HOW MUCH IS LEFT: the server addresses\n * progress to the person who started the run, the websocket bridge puts it on the event bus like\n * every other socket-borne fact, and this reads the ones carrying our own `jobId`.\n *\n * Progress counts rows the run has FINISHED with, refusals included — `processed / attempted` is\n * how far it has got, not how well it is going. `finished` comes from the server rather than from\n * comparing the counts: a run that ends early would otherwise leave a bar just short of full with\n * nothing to say it had stopped.\n */\nimport { useEffect, useState } from 'react';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents, type FrontendEventBulkJobProgress } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\n\nexport interface BulkJobFailure {\n  resourceId: string;\n  customMessageReference?: string;\n  errorType?: string;\n}\n\nexport interface BulkJobProgress {\n  jobId: string;\n  attemptedCount: number;\n  processedCount: number;\n  failedCount: number;\n  finished: boolean;\n  /**\n   * WHICH rows were refused. Arrives with the final event, and is a SAMPLE when the run refused\n   * more than the wire cap — `failedCount` stays exact, and the complete list is in the job result.\n   */\n  failures: BulkJobFailure[];\n}\n\nexport function useBulkJobProgress(run: { jobId: string; attemptedCount: number } | null): BulkJobProgress | null {\n  const { on } = useEventBus();\n  const [progress, setProgress] = useState<BulkJobProgress | null>(null);\n\n  // The effect keys on the PRIMITIVES, never on the object. A caller that builds `{ jobId,\n  // attemptedCount }` inline hands a fresh reference every render, and an effect depending on the\n  // object would re-subscribe, set state, re-render, and loop — measured, as an out-of-memory\n  // worker the first time this hook was pinned.\n  const jobId = run?.jobId ?? null;\n  const attemptedCount = run?.attemptedCount ?? 0;\n\n  useEffect(() => {\n    if (!jobId) {\n      setProgress(null);\n      return;\n    }\n\n    // Seeded from what the bar ASKED for, so the surface can draw an honest empty bar in the window\n    // between the acceptance and the first progress event — which is exactly the window a person\n    // spends wondering whether anything happened.\n    setProgress({ jobId, attemptedCount, processedCount: 0, failedCount: 0, finished: false, failures: [] });\n\n    return on(FrontendEvents.BULK_JOB_PROGRESS, (payload: FrontendEventBulkJobProgress) => {\n      // One person may start several runs; only ours is ours.\n      if (payload.jobId !== jobId) return;\n      setProgress({\n        jobId: payload.jobId,\n        attemptedCount: payload.attemptedCount,\n        processedCount: payload.processedCount,\n        failedCount: payload.failedCount,\n        finished: payload.finished,\n        failures: payload.failures ?? [],\n      });\n    });\n  }, [on, jobId, attemptedCount]);\n\n  return progress;\n}\n"]}
+{"version":3,"file":"useBulkJobProgress.js","sourceRoot":"","sources":["../../../../../src/core/resources/useBulkJobProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAqC,MAAM,yDAAyD,CAAC;AA2B5H,MAAM,UAAU,kBAAkB,CAAC,GAAqD;IACtF,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAyB,IAAI,CAAC,CAAC;IAEvE,yFAAyF;IACzF,gGAAgG;IAChG,4FAA4F;IAC5F,8CAA8C;IAC9C,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IACjC,MAAM,cAAc,GAAG,GAAG,EAAE,cAAc,IAAI,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,gGAAgG;QAChG,6FAA6F;QAC7F,8CAA8C;QAC9C,WAAW,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAEzG,OAAO,EAAE,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,OAAqC,EAAE,EAAE;YACpF,wDAAwD;YACxD,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;gBAAE,OAAO;YACpC,WAAW,CAAC;gBACV,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;gBAChD,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;aACjC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAEhC,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Follow a background BULK run started by this surface (#1461).\n *\n * The run's rows change one at a time and each broadcasts its own sync event, so the listing\n * updates itself while the job works. What this adds is HOW MUCH IS LEFT: the server addresses\n * progress to the person who started the run, the websocket bridge puts it on the event bus like\n * every other socket-borne fact, and this reads the ones carrying our own `jobId`.\n *\n * Progress counts rows the run has FINISHED with, refusals included — `processed / attempted` is\n * how far it has got, not how well it is going. `finished` comes from the server rather than from\n * comparing the counts: a run that ends early would otherwise leave a bar just short of full with\n * nothing to say it had stopped.\n */\nimport { useEffect, useState } from 'react';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents, type FrontendEventBulkJobProgress } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\n\nexport interface BulkJobFailure {\n  resourceId: string;\n  customMessageReference?: string;\n  errorType?: string;\n}\n\nexport interface BulkJobProgress {\n  jobId: string;\n  /**\n   * The operation the run executes, as the server reports it — absent only in the seeded state before\n   * the first event. A refusal is explained in that operation's own words (its authored\n   * `unavailableReason`) rather than the generic reference's (#2264), so the panel needs to know it.\n   */\n  operationIdentifier?: string;\n  attemptedCount: number;\n  processedCount: number;\n  failedCount: number;\n  finished: boolean;\n  /**\n   * WHICH rows were refused. Arrives with the final event, and is a SAMPLE when the run refused\n   * more than the wire cap — `failedCount` stays exact, and the complete list is in the job result.\n   */\n  failures: BulkJobFailure[];\n}\n\nexport function useBulkJobProgress(run: { jobId: string; attemptedCount: number } | null): BulkJobProgress | null {\n  const { on } = useEventBus();\n  const [progress, setProgress] = useState<BulkJobProgress | null>(null);\n\n  // The effect keys on the PRIMITIVES, never on the object. A caller that builds `{ jobId,\n  // attemptedCount }` inline hands a fresh reference every render, and an effect depending on the\n  // object would re-subscribe, set state, re-render, and loop — measured, as an out-of-memory\n  // worker the first time this hook was pinned.\n  const jobId = run?.jobId ?? null;\n  const attemptedCount = run?.attemptedCount ?? 0;\n\n  useEffect(() => {\n    if (!jobId) {\n      setProgress(null);\n      return;\n    }\n\n    // Seeded from what the bar ASKED for, so the surface can draw an honest empty bar in the window\n    // between the acceptance and the first progress event — which is exactly the window a person\n    // spends wondering whether anything happened.\n    setProgress({ jobId, attemptedCount, processedCount: 0, failedCount: 0, finished: false, failures: [] });\n\n    return on(FrontendEvents.BULK_JOB_PROGRESS, (payload: FrontendEventBulkJobProgress) => {\n      // One person may start several runs; only ours is ours.\n      if (payload.jobId !== jobId) return;\n      setProgress({\n        jobId: payload.jobId,\n        operationIdentifier: payload.operationIdentifier,\n        attemptedCount: payload.attemptedCount,\n        processedCount: payload.processedCount,\n        failedCount: payload.failedCount,\n        finished: payload.finished,\n        failures: payload.failures ?? [],\n      });\n    });\n  }, [on, jobId, attemptedCount]);\n\n  return progress;\n}\n"]}

package/dist/esm/core/resources/useCollectionFilterPresetScope.d.ts

@@ -0,0 +1,14 @@
+import type { CollectionFilterPresetResolution } from '../../core/resources/collection-filter-presets.frontend.utils';
+/**
+ * What a resource's preset filters are resolved against, apart from the instant: the reader's RESOLVED time zone,
+ * the resource's calendar-day fields (#2180) and the signed-in viewer (#2511). The pills and the chips read the same
+ * scope, so a pill that is on and the chip it hides agree about which window, and whose rows, it names.
+ *
+ * The viewer is read from `UserOrgsContext` directly rather than through `useUserOrgs`, which throws outside its
+ * provider: a list rendered with no signed-in session simply has no viewer, and a preset naming one is unavailable.
+ *
+ * The caller adds `now` itself, once per click or render, so every preset in one pass resolves against one
+ * instant.
+ */
+export declare function useCollectionFilterPresetScope(resourceType: string): Omit<CollectionFilterPresetResolution, 'now'>;
+//# sourceMappingURL=useCollectionFilterPresetScope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionFilterPresetScope.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useCollectionFilterPresetScope.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,gCAAgC,EAEjC,MAAM,6EAA6E,CAAC;AAErF;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAWlH"}

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

@@ -0,0 +1,29 @@
+import { useContext, useMemo } from 'react';
+import { useI18n } from '../../core/i18n/useI18n.js';
+import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
+import { calendarDateFieldNames } from '../../core/resources/calendar-date-fields.frontend.utils.js';
+import { UserOrgsContext } from '../../core/security/UserOrgsContext.js';
+/**
+ * What a resource's preset filters are resolved against, apart from the instant: the reader's RESOLVED time zone,
+ * the resource's calendar-day fields (#2180) and the signed-in viewer (#2511). The pills and the chips read the same
+ * scope, so a pill that is on and the chip it hides agree about which window, and whose rows, it names.
+ *
+ * The viewer is read from `UserOrgsContext` directly rather than through `useUserOrgs`, which throws outside its
+ * provider: a list rendered with no signed-in session simply has no viewer, and a preset naming one is unavailable.
+ *
+ * The caller adds `now` itself, once per click or render, so every preset in one pass resolves against one
+ * instant.
+ */
+export function useCollectionFilterPresetScope(resourceType) {
+    const { resolvedRegionalPreferences } = useI18n();
+    const { registry } = useResourceRegistry();
+    const configuration = registry.resourceConfigurations[resourceType];
+    const mainSchema = configuration?.mainSchema;
+    const inheritance = configuration?.inheritenceSchemaDefinition;
+    const calendarDateFields = useMemo(() => calendarDateFieldNames(mainSchema, inheritance), [mainSchema, inheritance]);
+    const timeZone = resolvedRegionalPreferences?.timezone;
+    const viewerUserId = useContext(UserOrgsContext)?.user?._id;
+    const viewer = useMemo(() => (viewerUserId ? { userId: String(viewerUserId) } : {}), [viewerUserId]);
+    return useMemo(() => ({ timeZone, calendarDateFields, viewer }), [timeZone, calendarDateFields, viewer]);
+}
+//# sourceMappingURL=useCollectionFilterPresetScope.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionFilterPresetScope.js","sourceRoot":"","sources":["../../../../../src/core/resources/useCollectionFilterPresetScope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,wEAAwE,CAAC;AAChH,OAAO,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAC;AAMpF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAAC,YAAoB;IACjE,MAAM,EAAE,2BAA2B,EAAE,GAAG,OAAO,EAAE,CAAC;IAClD,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,aAAa,EAAE,UAAsC,CAAC;IACzE,MAAM,WAAW,GAAG,aAAa,EAAE,2BAA2B,CAAC;IAC/D,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IACrH,MAAM,QAAQ,GAAG,2BAA2B,EAAE,QAAQ,CAAC;IACvD,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC;IAC5D,MAAM,MAAM,GAAG,OAAO,CAA+B,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACnI,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3G,CAAC","sourcesContent":["import { useContext, useMemo } from 'react';\nimport type { z } from 'zod';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { calendarDateFieldNames } from '~wildo-frontend-lib/core/resources/calendar-date-fields.frontend.utils';\nimport { UserOrgsContext } from '~wildo-frontend-lib/core/security/UserOrgsContext';\nimport type {\n  CollectionFilterPresetResolution,\n  CollectionFilterPresetViewer,\n} from '~wildo-frontend-lib/core/resources/collection-filter-presets.frontend.utils';\n\n/**\n * What a resource's preset filters are resolved against, apart from the instant: the reader's RESOLVED time zone,\n * the resource's calendar-day fields (#2180) and the signed-in viewer (#2511). The pills and the chips read the same\n * scope, so a pill that is on and the chip it hides agree about which window, and whose rows, it names.\n *\n * The viewer is read from `UserOrgsContext` directly rather than through `useUserOrgs`, which throws outside its\n * provider: a list rendered with no signed-in session simply has no viewer, and a preset naming one is unavailable.\n *\n * The caller adds `now` itself, once per click or render, so every preset in one pass resolves against one\n * instant.\n */\nexport function useCollectionFilterPresetScope(resourceType: string): Omit<CollectionFilterPresetResolution, 'now'> {\n  const { resolvedRegionalPreferences } = useI18n();\n  const { registry } = useResourceRegistry();\n  const configuration = registry.resourceConfigurations[resourceType];\n  const mainSchema = configuration?.mainSchema as z.ZodTypeAny | undefined;\n  const inheritance = configuration?.inheritenceSchemaDefinition;\n  const calendarDateFields = useMemo(() => calendarDateFieldNames(mainSchema, inheritance), [mainSchema, inheritance]);\n  const timeZone = resolvedRegionalPreferences?.timezone;\n  const viewerUserId = useContext(UserOrgsContext)?.user?._id;\n  const viewer = useMemo<CollectionFilterPresetViewer>(() => (viewerUserId ? { userId: String(viewerUserId) } : {}), [viewerUserId]);\n  return useMemo(() => ({ timeZone, calendarDateFields, viewer }), [timeZone, calendarDateFields, viewer]);\n}\n"]}

package/dist/esm/core/resources/useHostlessResourceNavigation.d.ts

@@ -49,13 +49,14 @@ export interface HostlessResourceReadNavigationParams {
 }
 export interface HostlessResourceNavigation {
     /**
-     * Open a resource's preferred ADDRESSABLE read.
+     * Open a resource's preferred ADDRESSABLE read — or, when it has none, its `EMBEDDED` read, which the
+     * navigation layer opens as an overlay (an EMBEDDED read never takes over a structural zone).
      *
-     * Returns `false` — without navigating — when the resource is not registered, declares no
-     * addressable READ, or the id is empty. Fails closed on purpose: navigating to
-     * `/<resource>/undefined` produces an unrenderable detail surface that re-renders in a
-     * CPU-pegging loop, which is the failure the equivalent guard in `ResourceLayout_List` exists to
-     * prevent. A no-op click is recoverable; that is not.
+     * Returns `false` — without navigating — when the resource is not registered, declares neither an
+     * addressable nor an EMBEDDED READ, or the id is empty. `API_ONLY` stays refused: headless means no
+     * interface. Fails closed on purpose: navigating to `/<resource>/undefined` produces an unrenderable
+     * detail surface that re-renders in a CPU-pegging loop, which is the failure the equivalent guard in
+     * `ResourceLayout_List` exists to prevent. A no-op click is recoverable; that is not.
      */
     navigateToResourceRead: (params: HostlessResourceReadNavigationParams) => boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"useHostlessResourceNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAQH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAErF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AAEzG,MAAM,WAAW,oCAAoC;IACnD,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F;;;;OAIG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;OAQG;IACH,sBAAsB,EAAE,CAAC,MAAM,EAAE,oCAAoC,KAAK,OAAO,CAAC;CACnF;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,CAwD1E"}
+{"version":3,"file":"useHostlessResourceNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAWH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAErF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AAEzG,MAAM,WAAW,oCAAoC;IACnD,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F;;;;OAIG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;OASG;IACH,sBAAsB,EAAE,CAAC,MAAM,EAAE,oCAAoC,KAAK,OAAO,CAAC;CACnF;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,CAkD1E"}

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

@@ -28,10 +28,10 @@
  * that, which is the entire point — the previous hand-rolled pane WAS the override.
  */
 import { useCallback, useMemo } from 'react';
-import { CoreResourceOperation, NavigationZoneName } from '@wildo-ai/saas-models';
+import { CoreResourceOperation, NavigationZoneName, ResourceOperationFrontendSurface } from '@wildo-ai/saas-models';
 import { useResourceRegistry } from './useResourceRegistry.js';
 import { frontendResourceUtils, FrontendResourceUtils } from './frontend-resource.utils.js';
-import { pickPreferredOperationForCoreSemanticAddressability } from './resource-addressability.frontend.utils.js';
+import { pickPreferredOperationForCoreSemanticAddressability, } from './resource-addressability.frontend.utils.js';
 import { useNavigationController } from '../../core/navigation/useNavigationController.js';
 export function useHostlessResourceNavigation() {
     const { registry } = useResourceRegistry();
@@ -45,27 +45,20 @@ export function useHostlessResourceNavigation() {
         if (!resourceConfig) {
             return false;
         }
-        const targetContextResourceIdentifiers = {
-            ...contextResourceIdentifiers,
-            [resourceType]: resourceId,
-        };
+        const targetContextResourceIdentifiers = frontendResourceUtils.buildRecordIdentifiersFromCollection(contextResourceIdentifiers, resourceType, resourceId);
         /*
-         * `requireFrontendAddressable: true` with no EMBEDDED fallback, unlike `ResourceLayout_List`.
-         * That list can fall back because it HAS a host to render an embedded read inside; a composite
-         * view does not, so an EMBEDDED read reached from here would have nowhere to go — and answering
-         * `false` is a visible no-op the author can debug, where navigating to a surface that cannot
-         * render is not.
+         * An ADDRESSABLE read first; failing that, an EMBEDDED one (#2063).
+         *
+         * This used to stop at the addressable read, on the reasoning that a composite view has no host
+         * for an embedded read, so it "would have nowhere to go". The navigation layer answers that: an
+         * EMBEDDED read navigated into a structural zone is coerced to an OVERLAY
+         * (`NavigationPlacementAdjustment.EMBEDDED_COERCED_TO_OVERLAY`), which is exactly how a reference
+         * to an aspect row opens it (`resolveFkOverlayTarget` in the reference display emits the same
+         * navigation). Without the fallback every workbench aspect row — whose READ is EMBEDDED by design —
+         * was unopenable from Home, a card or a `?open=` deep link: the call answered `false`, the caller
+         * ignored it, and no request was ever sent.
          */
-        const readOperation = pickPreferredOperationForCoreSemanticAddressability({
-            resourceConfig,
-            operations: resourceConfig.operations ?? [],
-            coreOperation: CoreResourceOperation.READ,
-            registry,
-            hasResourceId: true,
-            requireFrontendAddressable: true,
-            contextResourceIdentifiers: targetContextResourceIdentifiers,
-            contextualParameters: FrontendResourceUtils.buildContextualParameters(targetContextResourceIdentifiers, registry),
-        });
+        const readOperation = pickHostlessReadOperation(resourceConfig, registry, targetContextResourceIdentifiers);
         if (!readOperation) {
             return false;
         }
@@ -78,4 +71,25 @@ export function useHostlessResourceNavigation() {
     }, [registry, navigateToResource]);
     return useMemo(() => ({ navigateToResourceRead }), [navigateToResourceRead]);
 }
+/**
+ * The READ a hostless navigation opens: the preferred addressable one, else an `EMBEDDED` one (opened as
+ * an overlay by the navigation layer). `API_ONLY` and every other surface yield `undefined`.
+ */
+function pickHostlessReadOperation(resourceConfig, registry, contextResourceIdentifiers) {
+    const pick = (requireFrontendAddressable) => pickPreferredOperationForCoreSemanticAddressability({
+        resourceConfig,
+        operations: resourceConfig?.operations ?? [],
+        coreOperation: CoreResourceOperation.READ,
+        registry,
+        hasResourceId: true,
+        requireFrontendAddressable,
+        contextResourceIdentifiers,
+        contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),
+    });
+    const addressable = pick(true);
+    if (addressable)
+        return addressable;
+    const anyRead = pick(false);
+    return anyRead?.operationFrontendConfig?.surface === ResourceOperationFrontendSurface.EMBEDDED ? anyRead : undefined;
+}
 //# sourceMappingURL=useHostlessResourceNavigation.js.map