npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.4 → 1.1.6 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2742) hide show

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

	@@ -1 +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 { pickPreferredOperationForCoreSemanticAddressability } 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\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 } = 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 pickPreferredOperationForCoreSemanticAddressability({\n resourceConfig,\n operations: resourceConfig?.operations ?? [],\n coreOperation: CoreResourceOperation.UPDATE,\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) {\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 }, [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"]}
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"]}

package/dist/esm/core/resources/useAuthedFileObjectUrl.frontend.hook.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.d.ts","sourceRoot":"","sources":["~~../../../../~~src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAkBA,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CA8BzF"}
1	+ {"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAkBA,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CA8BzF"}

package/dist/esm/core/resources/useAuthedFileObjectUrl.frontend.hook.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.js","sourceRoot":"","sources":["~~../../../../~~src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF,MAAM,UAAU,sBAAsB,CAAC,QAAmC;IACxE,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAAC;IACxC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEhE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,UAAU;aACP,aAAa,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;aACtD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,SAAS;gBAAE,OAAO;YACtB,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACpC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,CAAC,SAAS;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,OAAO;gBAAE,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IAE3B,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/*\n Fetch a protected file's bytes over the AUTHENTICATED client and expose them as an\n * object URL suitable for an `<img>` / `<embed>` `src`.\n \n An `<img>` cannot attach the bearer token, so a protected serve URL can't be loaded\n * directly. This hook fetches the bytes (`WildoBackendHttpClient.fetchFileBlob` — the\n * backend serve route authorizes via the linked resource's READ) and wraps the Blob in\n * `URL.createObjectURL`, revoking it and aborting the request on unmount / url change.\n \n Returns `null` while loading, when `serveUrl` is absent, or on failure — so callers\n * degrade to their own placeholder (e.g. initials). Use in any saas-frontend-lib surface\n * that renders a file preview outside the resource displayer (e.g. the nav user-menu\n * avatar). Inside the presets file components, prefer the injected `httpOperations.getBlob`\n * (keeps presets off the HTTP client).\n */\nimport { useEffect, useState } from 'react';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\n\nexport function useAuthedFileObjectUrl(serveUrl: string \| null \| undefined): string \| null {\n const { httpClient } = useApplication();\n const [objectUrl, setObjectUrl] = useState<string \| null>(null);\n\n useEffect(() => {\n if (!serveUrl) {\n setObjectUrl(null);\n return;\n }\n let cancelled = false;\n let created: string \| null = null;\n const controller = new AbortController();\n httpClient\n .fetchFileBlob(serveUrl, { signal: controller.signal })\n .then((blob) => {\n if (cancelled) return;\n created = URL.createObjectURL(blob);\n setObjectUrl(created);\n })\n .catch(() => {\n if (!cancelled) setObjectUrl(null);\n });\n return () => {\n cancelled = true;\n controller.abort();\n if (created) URL.revokeObjectURL(created);\n };\n }, [serveUrl, httpClient]);\n\n return objectUrl;\n}\n"]}
1	+ {"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.js","sourceRoot":"","sources":["../../../../../src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF,MAAM,UAAU,sBAAsB,CAAC,QAAmC;IACxE,MAAM,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAAC;IACxC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEhE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,UAAU;aACP,aAAa,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;aACtD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,SAAS;gBAAE,OAAO;YACtB,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACpC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,CAAC,SAAS;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,OAAO;gBAAE,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IAE3B,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/*\n Fetch a protected file's bytes over the AUTHENTICATED client and expose them as an\n * object URL suitable for an `<img>` / `<embed>` `src`.\n \n An `<img>` cannot attach the bearer token, so a protected serve URL can't be loaded\n * directly. This hook fetches the bytes (`WildoBackendHttpClient.fetchFileBlob` — the\n * backend serve route authorizes via the linked resource's READ) and wraps the Blob in\n * `URL.createObjectURL`, revoking it and aborting the request on unmount / url change.\n \n Returns `null` while loading, when `serveUrl` is absent, or on failure — so callers\n * degrade to their own placeholder (e.g. initials). Use in any saas-frontend-lib surface\n * that renders a file preview outside the resource displayer (e.g. the nav user-menu\n * avatar). Inside the presets file components, prefer the injected `httpOperations.getBlob`\n * (keeps presets off the HTTP client).\n */\nimport { useEffect, useState } from 'react';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\n\nexport function useAuthedFileObjectUrl(serveUrl: string \| null \| undefined): string \| null {\n const { httpClient } = useApplication();\n const [objectUrl, setObjectUrl] = useState<string \| null>(null);\n\n useEffect(() => {\n if (!serveUrl) {\n setObjectUrl(null);\n return;\n }\n let cancelled = false;\n let created: string \| null = null;\n const controller = new AbortController();\n httpClient\n .fetchFileBlob(serveUrl, { signal: controller.signal })\n .then((blob) => {\n if (cancelled) return;\n created = URL.createObjectURL(blob);\n setObjectUrl(created);\n })\n .catch(() => {\n if (!cancelled) setObjectUrl(null);\n });\n return () => {\n cancelled = true;\n controller.abort();\n if (created) URL.revokeObjectURL(created);\n };\n }, [serveUrl, httpClient]);\n\n return objectUrl;\n}\n"]}

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

@@ -0,0 +1,22 @@
+export interface BulkJobFailure {
+    resourceId: string;
+    customMessageReference?: string;
+    errorType?: string;
+}
+export interface BulkJobProgress {
+    jobId: string;
+    attemptedCount: number;
+    processedCount: number;
+    failedCount: number;
+    finished: boolean;
+    /**
+     * WHICH rows were refused. Arrives with the final event, and is a SAMPLE when the run refused
+     * more than the wire cap — `failedCount` stays exact, and the complete list is in the job result.
+     */
+    failures: BulkJobFailure[];
+}
+export declare function useBulkJobProgress(run: {
+    jobId: string;
+    attemptedCount: number;
+} | null): BulkJobProgress | null;
+//# sourceMappingURL=useBulkJobProgress.d.ts.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * Follow a background BULK run started by this surface (#1461).
+ *
+ * The run's rows change one at a time and each broadcasts its own sync event, so the listing
+ * updates itself while the job works. What this adds is HOW MUCH IS LEFT: the server addresses
+ * progress to the person who started the run, the websocket bridge puts it on the event bus like
+ * every other socket-borne fact, and this reads the ones carrying our own `jobId`.
+ *
+ * Progress counts rows the run has FINISHED with, refusals included — `processed / attempted` is
+ * how far it has got, not how well it is going. `finished` comes from the server rather than from
+ * comparing the counts: a run that ends early would otherwise leave a bar just short of full with
+ * nothing to say it had stopped.
+ */
+import { useEffect, useState } from 'react';
+import { useEventBus } from '../../core/events/useEventBus.js';
+import { FrontendEvents } from '../../core/events/events.frontend.schemas.js';
+export function useBulkJobProgress(run) {
+    const { on } = useEventBus();
+    const [progress, setProgress] = useState(null);
+    // The effect keys on the PRIMITIVES, never on the object. A caller that builds `{ jobId,
+    // attemptedCount }` inline hands a fresh reference every render, and an effect depending on the
+    // object would re-subscribe, set state, re-render, and loop — measured, as an out-of-memory
+    // worker the first time this hook was pinned.
+    const jobId = run?.jobId ?? null;
+    const attemptedCount = run?.attemptedCount ?? 0;
+    useEffect(() => {
+        if (!jobId) {
+            setProgress(null);
+            return;
+        }
+        // Seeded from what the bar ASKED for, so the surface can draw an honest empty bar in the window
+        // between the acceptance and the first progress event — which is exactly the window a person
+        // spends wondering whether anything happened.
+        setProgress({ jobId, attemptedCount, processedCount: 0, failedCount: 0, finished: false, failures: [] });
+        return on(FrontendEvents.BULK_JOB_PROGRESS, (payload) => {
+            // One person may start several runs; only ours is ours.
+            if (payload.jobId !== jobId)
+                return;
+            setProgress({
+                jobId: payload.jobId,
+                attemptedCount: payload.attemptedCount,
+                processedCount: payload.processedCount,
+                failedCount: payload.failedCount,
+                finished: payload.finished,
+                failures: payload.failures ?? [],
+            });
+        });
+    }, [on, jobId, attemptedCount]);
+    return progress;
+}
+//# sourceMappingURL=useBulkJobProgress.js.map

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

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

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

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

package/dist/esm/core/resources/useHostlessResourceNavigation.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useHostlessResourceNavigation.js","sourceRoot":"","sources":["~~../../../../~~src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,mDAAmD,EAAE,MAAM,0CAA0C,CAAC;AAE/G,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AAmCtG,MAAM,UAAU,6BAA6B;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,kBAAkB,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAEzD,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,MAA4C,EAAW,EAAE;QACnG,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,0BAA0B,GAAG,EAAE,EAAE,UAAU,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC;QACtH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,gCAAgC,GAAG;YACvC,GAAG,0BAA0B;YAC7B,CAAC,YAAY,CAAC,EAAE,UAAU;SAC3B,CAAC;QAEF;;;;;;WAMG;QACH,MAAM,aAAa,GAAG,mDAAmD,CAAC;YACxE,cAAc;YACd,UAAU,EAAE,cAAc,CAAC,UAAU,IAAI,EAAE;YAC3C,aAAa,EAAE,qBAAqB,CAAC,IAAI;YACzC,QAAQ;YACR,aAAa,EAAE,IAAI;YACnB,0BAA0B,EAAE,IAAI;YAChC,0BAA0B,EAAE,gCAAgC;YAC5D,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,CACnE,gCAAgC,EAChC,QAAQ,CACT;SACF,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,kBAAkB,CAChB,qBAAqB,CAAC,mDAAmD,CAAC;YACxE,YAAY;YACZ,SAAS,EAAE,aAAa;YACxB,0BAA0B,EAAE,gCAAgC;SAC7D,CAAC,EACF,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAC5D,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["/*\n Navigate to a resource operation from a host that is NOT a resource surface.\n \n ## Why this exists\n \n Every existing path into a resource READ starts from a resource: `useResourceOperationSurface`\n * takes a `resourceContext`, and a list row already has one to derive the target from. A COMPOSITE\n * VIEW has none — it is `APPLICATION`-scoped by definition — so a canvas, board or dashboard that\n * wants a click to open a record had no framework path at all.\n \n The consequence was not that such views did without. It was that they re-implemented the detail\n * pane locally: the application-creation workbench's domain-model graph held its selection in React\n * state and rendered an inline `<aside>`, which meant no URL, no back navigation, no zone semantics\n * and no responsive collapse — a hand-rolled copy of `split` + `SECONDARY` + `onEmpty` at one call\n * site, with none of their behavior (issue #174).\n \n So this is deliberately a NAMED SEAM rather than a widening of the barrel. The alternative was to\n * export `frontend-resource.utils` publicly, which would expose a large internal module as API to\n * solve one caller's problem — repository organization as contract, which\n * `package-public-entrypoints.md` forbids.\n \n ## What it does NOT do\n \n It does not decide WHERE the record opens. That is the navigation layout's job: the transition\n * declared for `READ` in the source zone resolves to push, split or overlay, and a composite view\n * gets the same answer a list would from the same zone. A caller wanting a detail pane declares\n * `READ → SPLIT` in its layout; a caller wanting a full page declares `PUSH`. Nothing here overrides\n * that, which is the entire point — the previous hand-rolled pane WAS the override.\n /\n\nimport { useCallback, useMemo } from 'react';\nimport { CoreResourceOperation, NavigationZoneName } from '@wildo-ai/saas-models';\n\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from './frontend-resource.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from './resource-addressability.frontend.utils';\nimport type { FrontendResourceOperationContext } from './resources.frontend.schemas';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport type { NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\nexport interface HostlessResourceReadNavigationParams {\n /* The resource whose record should open. /\n resourceType: string;\n /* The record's id, as the resource's own identifier field carries it. /\n resourceId: string;\n /\n Additional context identifiers to carry (parent scope, filters). Defaults to none — an\n * `APPLICATION`-scoped host has no ambient resource context to inherit, which is exactly what makes\n * it hostless.\n /\n contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n /\n Which zone the click came from. Defaults to PRIMARY, because a composite view is primary-zone\n * content — and it is the SOURCE zone that decides the transition, so getting this wrong sends the\n * record somewhere the layout did not intend.\n /\n sourceZone?: NavigationInitiatorContext['sourceZone'];\n}\n\nexport interface HostlessResourceNavigation {\n /\n Open a resource's preferred ADDRESSABLE read.\n \n Returns `false` — without navigating — when the resource is not registered, declares no\n * addressable READ, or the id is empty. Fails closed on purpose: navigating to\n * `/<resource>/undefined` produces an unrenderable detail surface that re-renders in a\n * CPU-pegging loop, which is the failure the equivalent guard in `ResourceLayout_List` exists to\n * prevent. A no-op click is recoverable; that is not.\n /\n navigateToResourceRead: (params: HostlessResourceReadNavigationParams) => boolean;\n}\n\nexport function useHostlessResourceNavigation(): HostlessResourceNavigation {\n const { registry } = useResourceRegistry();\n const { navigateToResource } = useNavigationController();\n\n const navigateToResourceRead = useCallback((params: HostlessResourceReadNavigationParams): boolean => {\n const { resourceType, resourceId, contextResourceIdentifiers = {}, sourceZone = NavigationZoneName.PRIMARY } = params;\n if (!resourceId) {\n return false;\n }\n\n const resourceConfig = registry.resourceConfigurations[resourceType];\n if (!resourceConfig) {\n return false;\n }\n\n const targetContextResourceIdentifiers = {\n ...contextResourceIdentifiers,\n [resourceType]: resourceId,\n };\n\n /\n * `requireFrontendAddressable: true` with no EMBEDDED fallback, unlike `ResourceLayout_List`.\n * That list can fall back because it HAS a host to render an embedded read inside; a composite\n * view does not, so an EMBEDDED read reached from here would have nowhere to go — and answering\n * `false` is a visible no-op the author can debug, where navigating to a surface that cannot\n * render is not.\n */\n const readOperation = pickPreferredOperationForCoreSemanticAddressability({\n resourceConfig,\n operations: resourceConfig.operations ?? [],\n coreOperation: CoreResourceOperation.READ,\n registry,\n hasResourceId: true,\n requireFrontendAddressable: true,\n contextResourceIdentifiers: targetContextResourceIdentifiers,\n contextualParameters: FrontendResourceUtils.buildContextualParameters(\n targetContextResourceIdentifiers,\n registry,\n ),\n });\n if (!readOperation) {\n return false;\n }\n\n navigateToResource(\n frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n resourceType,\n operation: readOperation,\n contextResourceIdentifiers: targetContextResourceIdentifiers,\n }),\n { sourceZone, sourceOperation: CoreResourceOperation.READ },\n );\n return true;\n }, [registry, navigateToResource]);\n\n return useMemo(() => ({ navigateToResourceRead }), [navigateToResourceRead]);\n}\n"]}
1	+ {"version":3,"file":"useHostlessResourceNavigation.js","sourceRoot":"","sources":["../../../../../src/core/resources/useHostlessResourceNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,mDAAmD,EAAE,MAAM,0CAA0C,CAAC;AAE/G,OAAO,EAAE,uBAAuB,EAAE,MAAM,6DAA6D,CAAC;AAmCtG,MAAM,UAAU,6BAA6B;IAC3C,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,kBAAkB,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAEzD,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,MAA4C,EAAW,EAAE;QACnG,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,0BAA0B,GAAG,EAAE,EAAE,UAAU,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC;QACtH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,gCAAgC,GAAG;YACvC,GAAG,0BAA0B;YAC7B,CAAC,YAAY,CAAC,EAAE,UAAU;SAC3B,CAAC;QAEF;;;;;;WAMG;QACH,MAAM,aAAa,GAAG,mDAAmD,CAAC;YACxE,cAAc;YACd,UAAU,EAAE,cAAc,CAAC,UAAU,IAAI,EAAE;YAC3C,aAAa,EAAE,qBAAqB,CAAC,IAAI;YACzC,QAAQ;YACR,aAAa,EAAE,IAAI;YACnB,0BAA0B,EAAE,IAAI;YAChC,0BAA0B,EAAE,gCAAgC;YAC5D,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,CACnE,gCAAgC,EAChC,QAAQ,CACT;SACF,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,kBAAkB,CAChB,qBAAqB,CAAC,mDAAmD,CAAC;YACxE,YAAY;YACZ,SAAS,EAAE,aAAa;YACxB,0BAA0B,EAAE,gCAAgC;SAC7D,CAAC,EACF,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAC5D,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,sBAAsB,EAAE,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["/*\n Navigate to a resource operation from a host that is NOT a resource surface.\n \n ## Why this exists\n \n Every existing path into a resource READ starts from a resource: `useResourceOperationSurface`\n * takes a `resourceContext`, and a list row already has one to derive the target from. A COMPOSITE\n * VIEW has none — it is `APPLICATION`-scoped by definition — so a canvas, board or dashboard that\n * wants a click to open a record had no framework path at all.\n \n The consequence was not that such views did without. It was that they re-implemented the detail\n * pane locally: the application-creation workbench's domain-model graph held its selection in React\n * state and rendered an inline `<aside>`, which meant no URL, no back navigation, no zone semantics\n * and no responsive collapse — a hand-rolled copy of `split` + `SECONDARY` + `onEmpty` at one call\n * site, with none of their behavior (issue #174).\n \n So this is deliberately a NAMED SEAM rather than a widening of the barrel. The alternative was to\n * export `frontend-resource.utils` publicly, which would expose a large internal module as API to\n * solve one caller's problem — repository organization as contract, which\n * `package-public-entrypoints.md` forbids.\n \n ## What it does NOT do\n \n It does not decide WHERE the record opens. That is the navigation layout's job: the transition\n * declared for `READ` in the source zone resolves to push, split or overlay, and a composite view\n * gets the same answer a list would from the same zone. A caller wanting a detail pane declares\n * `READ → SPLIT` in its layout; a caller wanting a full page declares `PUSH`. Nothing here overrides\n * that, which is the entire point — the previous hand-rolled pane WAS the override.\n /\n\nimport { useCallback, useMemo } from 'react';\nimport { CoreResourceOperation, NavigationZoneName } from '@wildo-ai/saas-models';\n\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from './frontend-resource.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from './resource-addressability.frontend.utils';\nimport type { FrontendResourceOperationContext } from './resources.frontend.schemas';\nimport { useNavigationController } from '~wildo-frontend-lib/core/navigation/useNavigationController';\nimport type { NavigationInitiatorContext } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\n\nexport interface HostlessResourceReadNavigationParams {\n /* The resource whose record should open. /\n resourceType: string;\n /* The record's id, as the resource's own identifier field carries it. /\n resourceId: string;\n /\n Additional context identifiers to carry (parent scope, filters). Defaults to none — an\n * `APPLICATION`-scoped host has no ambient resource context to inherit, which is exactly what makes\n * it hostless.\n /\n contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n /\n Which zone the click came from. Defaults to PRIMARY, because a composite view is primary-zone\n * content — and it is the SOURCE zone that decides the transition, so getting this wrong sends the\n * record somewhere the layout did not intend.\n /\n sourceZone?: NavigationInitiatorContext['sourceZone'];\n}\n\nexport interface HostlessResourceNavigation {\n /\n Open a resource's preferred ADDRESSABLE read.\n \n Returns `false` — without navigating — when the resource is not registered, declares no\n * addressable READ, or the id is empty. Fails closed on purpose: navigating to\n * `/<resource>/undefined` produces an unrenderable detail surface that re-renders in a\n * CPU-pegging loop, which is the failure the equivalent guard in `ResourceLayout_List` exists to\n * prevent. A no-op click is recoverable; that is not.\n /\n navigateToResourceRead: (params: HostlessResourceReadNavigationParams) => boolean;\n}\n\nexport function useHostlessResourceNavigation(): HostlessResourceNavigation {\n const { registry } = useResourceRegistry();\n const { navigateToResource } = useNavigationController();\n\n const navigateToResourceRead = useCallback((params: HostlessResourceReadNavigationParams): boolean => {\n const { resourceType, resourceId, contextResourceIdentifiers = {}, sourceZone = NavigationZoneName.PRIMARY } = params;\n if (!resourceId) {\n return false;\n }\n\n const resourceConfig = registry.resourceConfigurations[resourceType];\n if (!resourceConfig) {\n return false;\n }\n\n const targetContextResourceIdentifiers = {\n ...contextResourceIdentifiers,\n [resourceType]: resourceId,\n };\n\n /\n * `requireFrontendAddressable: true` with no EMBEDDED fallback, unlike `ResourceLayout_List`.\n * That list can fall back because it HAS a host to render an embedded read inside; a composite\n * view does not, so an EMBEDDED read reached from here would have nowhere to go — and answering\n * `false` is a visible no-op the author can debug, where navigating to a surface that cannot\n * render is not.\n */\n const readOperation = pickPreferredOperationForCoreSemanticAddressability({\n resourceConfig,\n operations: resourceConfig.operations ?? [],\n coreOperation: CoreResourceOperation.READ,\n registry,\n hasResourceId: true,\n requireFrontendAddressable: true,\n contextResourceIdentifiers: targetContextResourceIdentifiers,\n contextualParameters: FrontendResourceUtils.buildContextualParameters(\n targetContextResourceIdentifiers,\n registry,\n ),\n });\n if (!readOperation) {\n return false;\n }\n\n navigateToResource(\n frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n resourceType,\n operation: readOperation,\n contextResourceIdentifiers: targetContextResourceIdentifiers,\n }),\n { sourceZone, sourceOperation: CoreResourceOperation.READ },\n );\n return true;\n }, [registry, navigateToResource]);\n\n return useMemo(() => ({ navigateToResourceRead }), [navigateToResourceRead]);\n}\n"]}

package/dist/esm/core/resources/useOperationDirectExecution.d.ts ADDED Viewed

@@ -0,0 +1,59 @@
+export interface UseOperationDirectExecutionParams {
+    /** Replaces what happens AFTER a success. The outcome is announced either way. Omitted: go back within the zone. */
+    onSuccess?: (result: unknown) => void;
+    /** The message a failure is reported under. */
+    errorMessage: string;
+    /** The component a failure is attributed to in the report. */
+    errorComponent: string;
+}
+export interface OperationDirectExecution {
+    /**
+     * Execute the hosted operation with this exact request body — no form, no validation pass beyond
+     * the server's. Resolves once the outcome has been announced (success) or reported (failure).
+     * Omitted means "no body at all", which is what a zero-input action sends — not an empty object.
+     */
+    execute: (requestData?: Record<string, unknown>) => Promise<void>;
+    /** True while a request is in flight. */
+    isExecuting: boolean;
+    /**
+     * True while an update-like operation with no target id in its context is resolving that id from
+     * the canonical READ. Execution must wait for it: the RMM that carries the mutation is keyed on it.
+     */
+    isBootstrapping: boolean;
+    /**
+     * The success path itself — announce the outcome, then `onSuccess` or go back. Exposed so a host
+     * that ALSO renders a form hands the form this very function, and "what success means" has one
+     * definition across the form and the form-less paths.
+     */
+    completeWithSuccess: (result: unknown) => void;
+    /** The failure path — reports under `errorMessage` / `errorComponent`. Same reason as above. */
+    reportFailure: (error: Error) => void;
+}
+/**
+ * Execute the NEAREST operation view's operation with a body the caller already has — the form-less
+ * half of every operation host.
+ *
+ * ## Why this is its own hook
+ *
+ * It began as the zero-input branch of `ResourceLayout_SemanticOperationFallback` ("Run" with an
+ * empty body), and a DROPDOWN action needs exactly the same thing with a one-field body: the pick is
+ * the submission. The alternative — a second copy of the RMM-or-direct decision, the canonical-READ
+ * bootstrap and the outcome announcement inside the dropdown — is the shape this package has already
+ * paid for once (the bulk selector, spelled two ways). One hook, so a host that executes without a
+ * form inherits the whole contract by using it:
+ *
+ * - **update-like single-resource operations run through the RMM**, never the plain `doOperation`
+ *   lane, and fail closed with `MissingRMMRuntimeError` rather than writing without it;
+ * - **a missing target id is resolved first** from the canonical READ, so a detail-less context (a
+ *   bulk bar, a singleton) still mutates the right row;
+ * - **everything else runs `executeCurrentOperation`**, which merges a bulk selection into the body;
+ * - **the outcome is ALWAYS announced**, and `onSuccess` replaces only what happens next.
+ *
+ * Confirmation is NOT decided here. Each host owns the dialog it shows, because only the host knows
+ * whether a person has already acted deliberately (typed a phrase, pressed Submit) or merely picked.
+ *
+ * Must be called under a `ResourceOperationViewProvider` for the operation being executed — a
+ * detached host establishes one (`ResourceOperationDetachedHost`, `ResourceOperationActionDropdown`).
+ */
+export declare function useOperationDirectExecution({ onSuccess, errorMessage, errorComponent, }: UseOperationDirectExecutionParams): OperationDirectExecution;
+//# sourceMappingURL=useOperationDirectExecution.d.ts.map

package/dist/esm/core/resources/useOperationDirectExecution.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"useOperationDirectExecution.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationDirectExecution.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,iCAAiC;IAChD,oHAAoH;IACpH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,gGAAgG;IAChG,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACvC;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,SAAS,EACT,YAAY,EACZ,cAAc,GACf,EAAE,iCAAiC,GAAG,wBAAwB,CA6Q9D"}

package/dist/esm/core/resources/useOperationDirectExecution.js ADDED Viewed

@@ -0,0 +1,278 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { useI18n } from '../../core/i18n/useI18n.js';
+import { resolveComponentLabel } from '../../core/i18n/component-label-resolution.utils.js';
+import { useResourceOperationViewContext } from '../../core/resources/ResourceOperationViewContext.js';
+import { FrontendResourceUtils, frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
+import { allowsDirectOperationFallback, MissingRMMRuntimeError, resolveDeclaredUpdateLikeMutationFallbackMode, } from '../../core/resources/rmm/update-like-mutation-fallback.frontend.js';
+import { useResourceRMM } from '../../core/resources/rmm/useResourceRMM.js';
+import { mutationErrorForReport } from '../../core/resources/rmm/mutation-error-report.utils.js';
+import { ConflictStrategy, MutationPriority, MutationSourceType, MutationType } from '../../core/resources/rmm/types.js';
+import { performCanonicalRMMRead, resolveCanonicalRMMReadOperationPathKey, } from '../../core/resources/rmm/canonical-read.frontend.utils.js';
+import { isSingleResourceUpdateLikeOperation } from '../../core/resources/operation-semantics.frontend.utils.js';
+import { useResourceOperationOutcomeEmitter } from '../../core/resources/useResourceOperationOutcomeEmitter.js';
+/**
+ * Execute the NEAREST operation view's operation with a body the caller already has — the form-less
+ * half of every operation host.
+ *
+ * ## Why this is its own hook
+ *
+ * It began as the zero-input branch of `ResourceLayout_SemanticOperationFallback` ("Run" with an
+ * empty body), and a DROPDOWN action needs exactly the same thing with a one-field body: the pick is
+ * the submission. The alternative — a second copy of the RMM-or-direct decision, the canonical-READ
+ * bootstrap and the outcome announcement inside the dropdown — is the shape this package has already
+ * paid for once (the bulk selector, spelled two ways). One hook, so a host that executes without a
+ * form inherits the whole contract by using it:
+ *
+ * - **update-like single-resource operations run through the RMM**, never the plain `doOperation`
+ *   lane, and fail closed with `MissingRMMRuntimeError` rather than writing without it;
+ * - **a missing target id is resolved first** from the canonical READ, so a detail-less context (a
+ *   bulk bar, a singleton) still mutates the right row;
+ * - **everything else runs `executeCurrentOperation`**, which merges a bulk selection into the body;
+ * - **the outcome is ALWAYS announced**, and `onSuccess` replaces only what happens next.
+ *
+ * Confirmation is NOT decided here. Each host owns the dialog it shows, because only the host knows
+ * whether a person has already acted deliberately (typed a phrase, pressed Submit) or merely picked.
+ *
+ * Must be called under a `ResourceOperationViewProvider` for the operation being executed — a
+ * detached host establishes one (`ResourceOperationDetachedHost`, `ResourceOperationActionDropdown`).
+ */
+export function useOperationDirectExecution({ onSuccess, errorMessage, errorComponent, }) {
+    const { resourceContext: currentResourceContext, resourceType, operation, reportError, goBackWithinZone, executeCurrentOperation, } = useResourceOperationViewContext();
+    const { doOperation, registry } = useResourceRegistry();
+    // `resource` as well as the component: a resource may override the component's words, and the
+    // fallback this was extracted from resolved them resource-scoped.
+    const { tComponent } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_ACTION, resource: resourceType });
+    const doOperationRef = useRef(doOperation);
+    doOperationRef.current = doOperation;
+    const [isExecuting, setIsExecuting] = useState(false);
+    const [isBootstrapping, setIsBootstrapping] = useState(false);
+    const [bootstrappedRow, setBootstrappedRow] = useState(null);
+    /*
+     * A single-row update-like operation addresses ONE row, whichever lane it runs on, so its target id
+     * is resolved (the canonical-READ bootstrap below) for both lanes, and the row's RMM is attached when
+     * the row has one.
+     *
+     * It runs through that RMM when there is one. Without one it runs directly only if the operation
+     * DECLARED the direct lane (`operationFrontendConfig.updateLikeMutationFallbackMode`), read through the
+     * same function the form host and `useResourceOperationSurface` read, so the two hosts pick the same lane;
+     * otherwise it fails closed.
+     */
+    const isSingleRowUpdateLike = useMemo(() => isSingleResourceUpdateLikeOperation(operation), [operation]);
+    const acceptsDirectLane = isSingleRowUpdateLike
+        && allowsDirectOperationFallback(resolveDeclaredUpdateLikeMutationFallbackMode(operation));
+    const bootstrapContextKey = useMemo(() => JSON.stringify({
+        contextResourceIdentifiers: FrontendResourceUtils.buildContextResourceIdentifiersKey(currentResourceContext.contextResourceIdentifiers ?? {}),
+        parentResourcesRequirements: currentResourceContext.parentResourcesRequirements ?? [],
+    }), [
+        currentResourceContext.contextResourceIdentifiers,
+        currentResourceContext.parentResourcesRequirements,
+    ]);
+    const routeResourceId = useMemo(() => {
+        const identifier = currentResourceContext.contextResourceIdentifiers?.[resourceType];
+        if (!identifier) {
+            return null;
+        }
+        return frontendResourceUtils.getResourceId(identifier) ?? null;
+    }, [currentResourceContext.contextResourceIdentifiers, resourceType]);
+    const currentResourceId = routeResourceId ?? (bootstrappedRow?.contextKey === bootstrapContextKey
+        && typeof bootstrappedRow.row._id === 'string'
+        && bootstrappedRow.row._id.length > 0
+        ? bootstrappedRow.row._id
+        : null);
+    const contextResourceIdentifiersWithResourceId = useMemo(() => {
+        if (!currentResourceId || currentResourceContext.contextResourceIdentifiers?.[resourceType]) {
+            return currentResourceContext.contextResourceIdentifiers;
+        }
+        return {
+            ...currentResourceContext.contextResourceIdentifiers,
+            [resourceType]: currentResourceId,
+        };
+    }, [currentResourceContext.contextResourceIdentifiers, currentResourceId, resourceType]);
+    const contextualParameters = useMemo(() => {
+        return FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiersWithResourceId, registry);
+    }, [contextResourceIdentifiersWithResourceId, registry]);
+    const canonicalReadOperationPathKey = useMemo(() => {
+        return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {
+            hasResourceId: Boolean(currentResourceId),
+            contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,
+            contextualParameters,
+        });
+    }, [contextResourceIdentifiersWithResourceId, contextualParameters, currentResourceId, registry, resourceType]);
+    const { rmm } = useResourceRMM({
+        resourceType,
+        resourceId: currentResourceId,
+        doOperationRef,
+        contextualParameters,
+        parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
+        contextResourceIdentifiers: contextResourceIdentifiersWithResourceId,
+        resourceSchema: registry.resourceConfigurations[resourceType]?.mainSchema,
+        enabled: isSingleRowUpdateLike && !!currentResourceId,
+        conflictPolicy: { strategy: ConflictStrategy.ACCEPT_REMOTE },
+        directFallbackAccepted: acceptsDirectLane,
+    });
+    const executionFailedLabel = useMemo(() => {
+        return resolveComponentLabel({
+            tComponent,
+            componentType: FrontendComponentType.RESOURCES_LAYOUTS_ACTION,
+            key: 'executionFailed',
+        });
+    }, [tComponent]);
+    /*
+     * Announced with the context that carries the RESOLVED row id, not the route's. A context-addressed
+     * singleton has no id on its route; the id comes from the canonical READ, and a page showing that row
+     * re-reads only when the announcement names it (#1782). The route context named no row, so an action
+     * whose result carries no `_id` (a secret's change outcome) announced a change to nobody.
+     */
+    const announcedContext = useMemo(() => (contextResourceIdentifiersWithResourceId === currentResourceContext.contextResourceIdentifiers
+        ? currentResourceContext
+        : { ...currentResourceContext, contextResourceIdentifiers: contextResourceIdentifiersWithResourceId }), [contextResourceIdentifiersWithResourceId, currentResourceContext]);
+    const announceOutcome = useResourceOperationOutcomeEmitter(announcedContext, operation);
+    const handleSuccess = useCallback((result) => {
+        announceOutcome(result);
+        if (onSuccess) {
+            onSuccess(result);
+            return;
+        }
+        goBackWithinZone();
+    }, [announceOutcome, goBackWithinZone, onSuccess]);
+    const handleError = useCallback((error) => {
+        reportError(error, errorMessage, errorComponent);
+    }, [errorComponent, errorMessage, reportError]);
+    useEffect(() => {
+        if (!isSingleRowUpdateLike || currentResourceId || !canonicalReadOperationPathKey) {
+            return;
+        }
+        let cancelled = false;
+        setIsBootstrapping(true);
+        void performCanonicalRMMRead({
+            doOperation: doOperationRef.current,
+            readOperationPathKey: canonicalReadOperationPathKey,
+            contextualParameters,
+            parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
+        }).then((row) => {
+            if (cancelled)
+                return;
+            setBootstrappedRow({
+                contextKey: bootstrapContextKey,
+                row,
+            });
+        }).catch((error) => {
+            if (cancelled)
+                return;
+            handleError(error instanceof Error ? error : new Error(String(error)));
+        }).finally(() => {
+            if (!cancelled) {
+                setIsBootstrapping(false);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [
+        bootstrapContextKey,
+        canonicalReadOperationPathKey,
+        contextualParameters,
+        currentResourceContext.parentResourcesRequirements,
+        currentResourceId,
+        handleError,
+        isSingleRowUpdateLike,
+    ]);
+    useEffect(() => {
+        if (!rmm || !bootstrappedRow || bootstrappedRow.contextKey !== bootstrapContextKey) {
+            return;
+        }
+        if (typeof rmm.getSnapshot === 'function' && rmm.getSnapshot().confirmedData !== null) {
+            return;
+        }
+        if (typeof rmm.setInitialState === 'function') {
+            const row = bootstrappedRow.row;
+            rmm.setInitialState(row, row._version ?? 0, row._field_meta);
+        }
+    }, [bootstrapContextKey, bootstrappedRow, rmm]);
+    const execute = useCallback(async (requestData) => {
+        setIsExecuting(true);
+        try {
+            let result;
+            if (isSingleRowUpdateLike && (rmm || !acceptsDirectLane)) {
+                if (!rmm) {
+                    throw new MissingRMMRuntimeError({
+                        surfaceName: 'useOperationDirectExecution',
+                        resourceType,
+                        operationIdentifier: String(operation.operationIdentifier),
+                    });
+                }
+                // No optimistic patch: the body is the OPERATION's input, not a set of resource fields, and a
+                // custom operation's input names need not be the row's. The row is read back on success.
+                const mutationResult = await rmm.queueMutation({}, {
+                    type: MutationType.CUSTOM,
+                    priority: MutationPriority.HIGH,
+                    source: {
+                        type: MutationSourceType.CUSTOM,
+                        subscriberId: `direct-execution:${String(operation.operationIdentifier)}`,
+                    },
+                    transportOverride: {
+                        operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation),
+                        contextualParameters,
+                        parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
+                        requestData: requestData ?? {},
+                        readBackOnSuccess: true,
+                    },
+                });
+                if (!mutationResult.success) {
+                    throw mutationErrorForReport(mutationResult.error, executionFailedLabel);
+                }
+                result = mutationResult.responseData;
+            }
+            else if (isSingleRowUpdateLike) {
+                /*
+                 * No RMM and the direct lane declared, still for ONE row: sent with the parameters this hook resolved, which carry the
+                 * bootstrapped id when the route had none. `executeCurrentOperation` builds its parameters from the
+                 * route alone, so from a detail-less context (a singleton, a bulk bar) it would address `{id}`
+                 * unresolved. With no id at all the operation has no row to act on, and says so instead of sending.
+                 */
+                if (!currentResourceId) {
+                    throw new Error(`${String(operation.operationIdentifier)} on ${resourceType} has no row to act on: no id on the route and none from its canonical READ.`);
+                }
+                result = await doOperationRef.current(ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation), {
+                    contextualParameters,
+                    parentResourcesRequirements: currentResourceContext.parentResourcesRequirements,
+                    requestData: requestData ?? {},
+                });
+            }
+            else {
+                result = await executeCurrentOperation(requestData);
+            }
+            handleSuccess(result);
+        }
+        catch (error) {
+            handleError(error instanceof Error ? error : new Error(executionFailedLabel));
+        }
+        finally {
+            setIsExecuting(false);
+        }
+    }, [
+        contextualParameters,
+        currentResourceContext.parentResourcesRequirements,
+        executeCurrentOperation,
+        handleError,
+        handleSuccess,
+        acceptsDirectLane,
+        isSingleRowUpdateLike,
+        currentResourceId,
+        operation,
+        resourceType,
+        rmm,
+        executionFailedLabel,
+    ]);
+    return {
+        execute,
+        isExecuting,
+        isBootstrapping,
+        completeWithSuccess: handleSuccess,
+        reportFailure: handleError,
+    };
+}
+//# sourceMappingURL=useOperationDirectExecution.js.map