@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.7

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

@@ -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"]}
+{"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.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,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.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;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

@@ -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;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

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

@@ -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

@@ -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

@@ -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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"useOperationEnabled.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"useOperationEnabled.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useOperationEnabled.js","sourceRoot":"","sources":["../../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GAKrB,MAAM,6BAA6B,CAAC","sourcesContent":["/**\n * Re-export from the canonical implementation in hooks/useOperationEnabled.\n * \n * The canonical implementation lives in ./hooks/useOperationEnabled.ts.\n * This file exists as a public re-export point (used by index.ts barrel).\n */\nexport {\n  useOperationEnabled,\n  useOperationsEnabled,\n  type UseOperationEnabledParams,\n  type UseOperationEnabledResult,\n  type OperationEnabledEntry,\n  type FeatureAvailability,\n} from './hooks/useOperationEnabled';\n"]}
+{"version":3,"file":"useOperationEnabled.js","sourceRoot":"","sources":["../../../../src/core/resources/useOperationEnabled.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GAKrB,MAAM,6BAA6B,CAAC","sourcesContent":["/**\n * Re-export from the canonical implementation in hooks/useOperationEnabled.\n * \n * The canonical implementation lives in ./hooks/useOperationEnabled.ts.\n * This file exists as a public re-export point (used by index.ts barrel).\n */\nexport {\n  useOperationEnabled,\n  useOperationsEnabled,\n  type UseOperationEnabledParams,\n  type UseOperationEnabledResult,\n  type OperationEnabledEntry,\n  type FeatureAvailability,\n} from './hooks/useOperationEnabled';\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useResourceLabels.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useResourceLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAC;AAcvG,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACrD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;KACzD,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;kGAC8F;IAC9F,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;sGACkG;IAClG,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,+GAA+G;IAC/G,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAqDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,eAAe,CAAC,EAAE,oBAAoB,EACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,GAAE,SAAS,GAAG,MAAkB,EACpC,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAiUzB"}
+{"version":3,"file":"useResourceLabels.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useResourceLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAC;AAcvG,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACrD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;KACzD,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;kGAC8F;IAC9F,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;sGACkG;IAClG,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,+GAA+G;IAC/G,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAqDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,eAAe,CAAC,EAAE,oBAAoB,EACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,GAAE,SAAS,GAAG,MAAkB,EACpC,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAiUzB"}