@anzusystems/common-admin 2.0.0-rc.5 → 2.0.0-rc.6

package/dist/domains/system/composables/pageNavigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageNavigation.js","names":["states","appRouter","trackNavigation","router","state","removeBeforeEach","removeAfterEach","isNavigationFailure","failure","NavigationFailureType","to","from","removeOnError","isNavigationPending","isAppNavigationPending","pageIdOf","usePageNavigation","useRouter","pageId","onPage","navigate","replace"],"sources":["../../../../src/domains/system/composables/pageNavigation.ts"],"sourcesContent":["import { isNavigationFailure, NavigationFailureType, type RouteLocationRaw, type Router, useRouter } from 'vue-router'\n\ninterface NavigationState {\n  pending: boolean\n  pageId: number\n}\n\nconst states = new WeakMap<Router, NavigationState>()\nlet appRouter: Router | undefined\n\n/**\n * Follows the user's navigation on `router`: whether one is on its way, and which page is shown.\n *\n * Register it as the router's first guard. A page that acts after an asynchronous step -- a load, a save, a socket\n * event -- asks `onPage()` first (`usePageNavigation`): while the user is navigating, or once the user has left, it\n * does nothing. Its redirect would cancel the user's navigation (in production a page's chunk is fetched on its first\n * visit), and its message would stay on the page the user went to.\n *\n * Returns the unregistration, for tests that create a router each.\n */\nexport function trackNavigation(router: Router): () => void {\n  appRouter = router\n  if (states.has(router)) return () => undefined\n  const state: NavigationState = { pending: false, pageId: 0 }\n  states.set(router, state)\n  const removeBeforeEach = router.beforeEach(() => {\n    state.pending = true\n  })\n  const removeAfterEach = router.afterEach((to, from, failure) => {\n    // A newer navigation took its place and is still on its way; it clears the flag itself.\n    if (isNavigationFailure(failure, NavigationFailureType.cancelled)) return\n    state.pending = false\n    // The admins key their RouterView by the path: another path is another page.\n    if (!failure && to.path !== from.path) state.pageId += 1\n  })\n  const removeOnError = router.onError(() => {\n    state.pending = false\n  })\n  return () => {\n    removeBeforeEach()\n    removeAfterEach()\n    removeOnError()\n    states.delete(router)\n    if (appRouter === router) appRouter = undefined\n  }\n}\n\nexport const isNavigationPending = (router: Router): boolean => states.get(router)?.pending === true\n\n/** Whether the app's router has a navigation of the user's on its way. */\nexport const isAppNavigationPending = (): boolean => appRouter !== undefined && isNavigationPending(appRouter)\n\nconst pageIdOf = (router: Router) => states.get(router)?.pageId ?? 0\n\nexport interface UsePageNavigationReturn {\n  /** The user is still on this page and not navigating away from it. */\n  onPage: () => boolean\n  /** Navigates only `onPage()`. Resolves whether it got there. */\n  push: (to: RouteLocationRaw) => Promise<boolean>\n  replace: (to: RouteLocationRaw) => Promise<boolean>\n}\n\n/**\n * For a page, or a composable it calls in its setup, that navigates after an asynchronous step: the redirect after a\n * save, a create or a delete, a load that forwards. The page is the one shown at setup; a later instance of the same\n * path (A, B, A again) is another page. A composable that is handed its router passes it on.\n */\nexport function usePageNavigation(router: Router | undefined = useRouter()): UsePageNavigationReturn {\n  // Without a router (a composable mounted alone in a test) there is nothing to follow, and nothing to navigate.\n  if (!router) return { onPage: () => true, push: async () => false, replace: async () => false }\n  // Registered late if the admin did not register it: it then misses only the guards that run before it.\n  trackNavigation(router)\n  const pageId = pageIdOf(router)\n\n  const onPage = () => !isNavigationPending(router) && pageIdOf(router) === pageId\n\n  // Not async: a location the router refuses to resolve still throws where the caller's try/catch sees it.\n  const navigate = (to: RouteLocationRaw, replace: boolean): Promise<boolean> => {\n    if (!onPage()) return Promise.resolve(false)\n    return (replace ? router.replace(to) : router.push(to)).then((failure) => !failure)\n  }\n\n  return {\n    onPage,\n    push: (to) => navigate(to, false),\n    replace: (to) => navigate(to, true),\n  }\n}\n"],"mappings":";;AAOA,IAAMA,oBAAS,IAAI,QAAiC,GAChDC;AAYJ,SAAgBC,EAAgB,GAA4B;CAE1D,IADA,IAAYC,GACRH,EAAO,IAAIG,CAAM,GAAG,aAAa,KAAA;CACrC,IAAMC,IAAyB;EAAE,SAAS;EAAO,QAAQ;CAAE;CAC3D,EAAO,IAAID,GAAQC,CAAK;CACxB,IAAMC,IAAmBF,EAAO,iBAAiB;EAC/C,EAAM,UAAU;CAClB,CAAC,GACKG,IAAkBH,EAAO,WAAW,GAAI,GAAM,MAAY;EAE9D,AAAII,EAAoBC,GAASC,EAAsB,SAAS,MAChE,EAAM,UAAU,IAEZ,CAACD,KAAWE,EAAG,SAASC,EAAK,SAAM,EAAM,UAAU;CACzD,CAAC,GACKC,IAAgBT,EAAO,cAAc;EACzC,EAAM,UAAU;CAClB,CAAC;CACD,aAAa;EAKX,AAJAE,EAAiB,GACjBC,EAAgB,GAChBM,EAAc,GACdZ,EAAO,OAAOG,CAAM,GAChBF,MAAcE,MAAQ,IAAY,KAAA;CACxC;AACF;AAEA,IAAaU,KAAuB,MAA4Bb,EAAO,IAAIG,CAAM,CAAC,EAAE,YAAY,IAGnFW,UAAwCb,MAAc,KAAA,KAAaY,EAAoBZ,CAAS,GAEvGc,KAAY,MAAmBf,EAAO,IAAIG,CAAM,CAAC,EAAE,UAAU;AAenE,SAAgBa,EAAkB,IAA6BC,EAAU,GAA4B;CAEnG,IAAI,CAACd,GAAQ,OAAO;EAAE,cAAc;EAAM,MAAM,YAAY;EAAO,SAAS,YAAY;CAAM;CAE9F,EAAgBA,CAAM;CACtB,IAAMe,IAASH,EAASZ,CAAM,GAExBgB,UAAe,CAACN,EAAoBV,CAAM,KAAKY,EAASZ,CAAM,MAAMe,GAGpEE,KAAY,GAAsB,MACjCD,EAAO,KACJE,IAAUlB,EAAO,QAAQO,CAAE,IAAIP,EAAO,KAAKO,CAAE,EAAA,CAAG,MAAM,MAAY,CAACF,CAAO,IAD5D,QAAQ,QAAQ,EAAK;CAI7C,OAAO;EACL;EACA,OAAO,MAAOY,EAASV,GAAI,EAAK;EAChC,UAAU,MAAOU,EAASV,GAAI,EAAI;CACpC;AACF"}
+{"version":3,"file":"pageNavigation.js","names":["states","appRouter","trackNavigation","router","state","removeBeforeEach","removeAfterEach","isNavigationFailure","failure","NavigationFailureType","to","from","removeOnError","isNavigationPending","isAppNavigationPending","pageIdOf","usePageNavigation","useRouter","pageId","onPage","navigate","replace"],"sources":["../../../../src/domains/system/composables/pageNavigation.ts"],"sourcesContent":["import { isNavigationFailure, NavigationFailureType, type RouteLocationRaw, type Router, useRouter } from 'vue-router'\n\ninterface NavigationState {\n  pending: boolean\n  pageId: number\n}\n\nconst states = new WeakMap<Router, NavigationState>()\nlet appRouter: Router | undefined\n\n/**\n * Tracks the user's navigation on `router`: whether one is pending, and which page is shown.\n * Register it as the router's first guard. A page that acts after an async step\n * (load, save, socket event) checks `onPage()` first via `usePageNavigation`.\n * While the user navigates or after leaving, it does nothing. A redirect would\n * cancel the user's navigation, and a message would stay on the next page.\n * Returns the unregistration, for tests that create a router each.\n */\nexport function trackNavigation(router: Router): () => void {\n  appRouter = router\n  if (states.has(router)) return () => undefined\n  const state: NavigationState = { pending: false, pageId: 0 }\n  states.set(router, state)\n  const removeBeforeEach = router.beforeEach(() => {\n    state.pending = true\n  })\n  const removeAfterEach = router.afterEach((to, from, failure) => {\n    // A newer navigation replaced this one and is still pending. It clears the flag itself.\n    if (isNavigationFailure(failure, NavigationFailureType.cancelled)) return\n    state.pending = false\n    // The admins key their RouterView by the path: another path is another page.\n    if (!failure && to.path !== from.path) state.pageId += 1\n  })\n  const removeOnError = router.onError(() => {\n    state.pending = false\n  })\n  return () => {\n    removeBeforeEach()\n    removeAfterEach()\n    removeOnError()\n    states.delete(router)\n    if (appRouter === router) appRouter = undefined\n  }\n}\n\nexport const isNavigationPending = (router: Router): boolean => states.get(router)?.pending === true\n\n/** Whether the app's router has a navigation of the user's on its way. */\nexport const isAppNavigationPending = (): boolean => appRouter !== undefined && isNavigationPending(appRouter)\n\nconst pageIdOf = (router: Router) => states.get(router)?.pageId ?? 0\n\nexport interface UsePageNavigationReturn {\n  /** The user is still on this page and not navigating away from it. */\n  onPage: () => boolean\n  /** Navigates only `onPage()`. Resolves whether it got there. */\n  push: (to: RouteLocationRaw) => Promise<boolean>\n  replace: (to: RouteLocationRaw) => Promise<boolean>\n}\n\n/**\n * For a page, or a composable in its setup, that navigates after\n * an async step, such as a redirect after save, create or delete.\n * The page is the one shown at setup. A later visit to the same path (A, B, A again) is another page.\n * A composable that receives its router passes it on.\n */\nexport function usePageNavigation(router: Router | undefined = useRouter()): UsePageNavigationReturn {\n  // Without a router (a composable mounted alone in a test) there is nothing to track or navigate.\n  if (!router) return { onPage: () => true, push: async () => false, replace: async () => false }\n  // Registers late if the admin did not register it. It then misses only the guards that run before it.\n  trackNavigation(router)\n  const pageId = pageIdOf(router)\n\n  const onPage = () => !isNavigationPending(router) && pageIdOf(router) === pageId\n\n  // Not async, so a location the router cannot resolve still throws inside the caller's try/catch.\n  const navigate = (to: RouteLocationRaw, replace: boolean): Promise<boolean> => {\n    if (!onPage()) return Promise.resolve(false)\n    return (replace ? router.replace(to) : router.push(to)).then((failure) => !failure)\n  }\n\n  return {\n    onPage,\n    push: (to) => navigate(to, false),\n    replace: (to) => navigate(to, true),\n  }\n}\n"],"mappings":";;AAOA,IAAMA,oBAAS,IAAI,QAAiC,GAChDC;AAUJ,SAAgBC,EAAgB,GAA4B;CAE1D,IADA,IAAYC,GACRH,EAAO,IAAIG,CAAM,GAAG,aAAa,KAAA;CACrC,IAAMC,IAAyB;EAAE,SAAS;EAAO,QAAQ;CAAE;CAC3D,EAAO,IAAID,GAAQC,CAAK;CACxB,IAAMC,IAAmBF,EAAO,iBAAiB;EAC/C,EAAM,UAAU;CAClB,CAAC,GACKG,IAAkBH,EAAO,WAAW,GAAI,GAAM,MAAY;EAE9D,AAAII,EAAoBC,GAASC,EAAsB,SAAS,MAChE,EAAM,UAAU,IAEZ,CAACD,KAAWE,EAAG,SAASC,EAAK,SAAM,EAAM,UAAU;CACzD,CAAC,GACKC,IAAgBT,EAAO,cAAc;EACzC,EAAM,UAAU;CAClB,CAAC;CACD,aAAa;EAKX,AAJAE,EAAiB,GACjBC,EAAgB,GAChBM,EAAc,GACdZ,EAAO,OAAOG,CAAM,GAChBF,MAAcE,MAAQ,IAAY,KAAA;CACxC;AACF;AAEA,IAAaU,KAAuB,MAA4Bb,EAAO,IAAIG,CAAM,CAAC,EAAE,YAAY,IAGnFW,UAAwCb,MAAc,KAAA,KAAaY,EAAoBZ,CAAS,GAEvGc,KAAY,MAAmBf,EAAO,IAAIG,CAAM,CAAC,EAAE,UAAU;AAgBnE,SAAgBa,EAAkB,IAA6BC,EAAU,GAA4B;CAEnG,IAAI,CAACd,GAAQ,OAAO;EAAE,cAAc;EAAM,MAAM,YAAY;EAAO,SAAS,YAAY;CAAM;CAE9F,EAAgBA,CAAM;CACtB,IAAMe,IAASH,EAASZ,CAAM,GAExBgB,UAAe,CAACN,EAAoBV,CAAM,KAAKY,EAASZ,CAAM,MAAMe,GAGpEE,KAAY,GAAsB,MACjCD,EAAO,KACJE,IAAUlB,EAAO,QAAQO,CAAE,IAAIP,EAAO,KAAKO,CAAE,EAAA,CAAG,MAAM,MAAY,CAACF,CAAO,IAD5D,QAAQ,QAAQ,EAAK;CAI7C,OAAO;EACL;EACA,OAAO,MAAOY,EAASV,GAAI,EAAK;EAChC,UAAU,MAAOU,EAASV,GAAI,EAAI;CACpC;AACF"}

package/dist/domains/system/composables/recordActions.d.ts

@@ -1,39 +1,31 @@
 import { Ref } from 'vue';
 /**
- * The record's get-one for a detail or edit page, in the shape `useRecordPage` reads: raises `loading`, runs `load`
- * with the page's signal and answers `true` once it resolved, or what `handleRecordLoadError` says after it showed
- * why it threw: `false` leave the page, `undefined` the request was stopped or the session expired (the page stays).
- * `loading` goes down unless the load was aborted: the flag belongs to the next page by then.
- *
- * Inside `load` a bare `return` means loaded (`true`), not "stay" as in a hand-written loader, and everything thrown
- * counts as the record failing to load. So only for the record's own single request: a second awaited request, a
- * secondary request with its own error handling, an early exit meaning "stay", an own alert, an own abort check, an
- * extra loaded/ready flag or a flag kept in a store stays hand-written.
- *
- * ```ts
+ * Get-one loader for a detail or edit page, in the shape `useRecordPage`
+ * reads. Raises `loading` and runs `load` with the page's signal.
+ * Returns `true` once loaded, else the result of `handleRecordLoadError`: `false`
+ * leaves the page, `undefined` means aborted or session expired (page stays).
+ * `loading` is lowered unless the load was aborted, because the flag then belongs to the next page.
+ * A bare `return` in `load` means loaded, and anything thrown counts as a load failure.
+ * Use it only for the record's single request; anything more stays hand-written.
+ * @example
  * const fetchData = defineRecordLoader(detailLoading, async (id: IntegerId, signal) => {
  *   faq.value = await fetchFaq({ urlParams: { id }, signal })
  * })
- * ```
  */
 export declare const defineRecordLoader: <Id>(loading: Ref<boolean>, load: (id: Id, signal: AbortSignal | undefined) => Promise<void>) => (id: Id, options?: {
     signal?: AbortSignal;
 }) => Promise<boolean | undefined>;
 /**
- * The save of a create or edit form: raises `loading`, touches `v$` and stops with `showValidationError` when it is
- * invalid, runs `save`, shows a thrown error with `showErrorsDefault`, lowers `loading`. The success alert and what
- * follows it (a callback, a route push, closing a dialog) stay in `save`.
- *
- * `loading` and `v$` are taken when the save is defined, so both must exist by then. A second validator, a check
- * before the flag goes up, a second flag, own error handling, work in `finally`, a returned value or a second
- * request stays hand-written.
- *
- * ```ts
+ * Save of a create or edit form. Raises `loading`, touches `v$` and calls `showValidationError`
+ * if invalid, runs `save`, shows errors with `showErrorsDefault`, lowers `loading`.
+ * The success alert and what follows it stay in `save`.
+ * `loading` and `v$` are captured at definition, so both must exist then. Extra validators,
+ * flags, error handling, `finally` work, return values or requests stay hand-written.
+ * @example
  * const onUpdate = defineRecordSave(saveButtonLoading, v$, async () => {
  *   faq.value = await updateFaq({ urlParams: { id: faq.value.id }, body: faq.value })
  *   showRecordWas('updated')
  * })
- * ```
  */
 export declare const defineRecordSave: <Args extends unknown[]>(loading: Ref<boolean>, v$: Ref<{
     $touch: () => void;

package/dist/domains/system/composables/recordActions.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordActions.js","names":["defineRecordLoader","load","id","options","error","defineRecordSave","useAlerts","args","v$","save"],"sources":["../../../../src/domains/system/composables/recordActions.ts"],"sourcesContent":["import type { Ref } from 'vue'\nimport { useAlerts } from '@/domains/system/composables/alerts'\nimport { handleRecordLoadError } from '@/domains/system/composables/recordPage'\n\n/**\n * The record's get-one for a detail or edit page, in the shape `useRecordPage` reads: raises `loading`, runs `load`\n * with the page's signal and answers `true` once it resolved, or what `handleRecordLoadError` says after it showed\n * why it threw: `false` leave the page, `undefined` the request was stopped or the session expired (the page stays).\n * `loading` goes down unless the load was aborted: the flag belongs to the next page by then.\n *\n * Inside `load` a bare `return` means loaded (`true`), not \"stay\" as in a hand-written loader, and everything thrown\n * counts as the record failing to load. So only for the record's own single request: a second awaited request, a\n * secondary request with its own error handling, an early exit meaning \"stay\", an own alert, an own abort check, an\n * extra loaded/ready flag or a flag kept in a store stays hand-written.\n *\n * ```ts\n * const fetchData = defineRecordLoader(detailLoading, async (id: IntegerId, signal) => {\n *   faq.value = await fetchFaq({ urlParams: { id }, signal })\n * })\n * ```\n */\nexport const defineRecordLoader =\n  <Id>(loading: Ref<boolean>, load: (id: Id, signal: AbortSignal | undefined) => Promise<void>) =>\n  async (id: Id, options: { signal?: AbortSignal } = {}): Promise<boolean | undefined> => {\n    loading.value = true\n    try {\n      await load(id, options.signal)\n      return true\n    } catch (error) {\n      return handleRecordLoadError(error) ? false : undefined\n    } finally {\n      if (!options.signal?.aborted) loading.value = false\n    }\n  }\n\n/**\n * The save of a create or edit form: raises `loading`, touches `v$` and stops with `showValidationError` when it is\n * invalid, runs `save`, shows a thrown error with `showErrorsDefault`, lowers `loading`. The success alert and what\n * follows it (a callback, a route push, closing a dialog) stay in `save`.\n *\n * `loading` and `v$` are taken when the save is defined, so both must exist by then. A second validator, a check\n * before the flag goes up, a second flag, own error handling, work in `finally`, a returned value or a second\n * request stays hand-written.\n *\n * ```ts\n * const onUpdate = defineRecordSave(saveButtonLoading, v$, async () => {\n *   faq.value = await updateFaq({ urlParams: { id: faq.value.id }, body: faq.value })\n *   showRecordWas('updated')\n * })\n * ```\n */\nexport const defineRecordSave = <Args extends unknown[]>(\n  loading: Ref<boolean>,\n  v$: Ref<{ $touch: () => void; $invalid: boolean }>,\n  save: (...args: Args) => Promise<void>\n) => {\n  const { showValidationError, showErrorsDefault } = useAlerts()\n  return async (...args: Args): Promise<void> => {\n    loading.value = true\n    try {\n      v$.value.$touch()\n      if (v$.value.$invalid) {\n        showValidationError()\n        return\n      }\n      await save(...args)\n    } catch (error) {\n      showErrorsDefault(error)\n    } finally {\n      loading.value = false\n    }\n  }\n}\n"],"mappings":";;;AAqBA,IAAaA,KACN,GAAuB,MAC5B,OAAO,GAAQ,IAAoC,CAAC,MAAoC;CACtF,EAAQ,QAAQ;CAChB,IAAI;EAEF,OADA,MAAMC,EAAKC,GAAIC,EAAQ,MAAM,GACtB;CACT,SAASC,GAAO;EACd,OAAO,GAAsBA,CAAK,KAAY,KAAA;CAChD,UAAU;EACR,AAAKD,EAAQ,QAAQ,YAAS,EAAQ,QAAQ;CAChD;AACF,GAkBWE,KACX,GACA,GACA,MACG;CACH,IAAM,EAAE,wBAAqB,yBAAsBC,EAAU;CAC7D,OAAO,OAAO,GAAGC,MAA8B;EAC7C,EAAQ,QAAQ;EAChB,IAAI;GAEF,IADAC,EAAG,MAAM,OAAO,GACZA,EAAG,MAAM,UAAU;IACrB,EAAoB;IACpB;GACF;GACA,MAAMC,EAAK,GAAGF,CAAI;EACpB,SAASH,GAAO;GACd,EAAkBA,CAAK;EACzB,UAAU;GACR,EAAQ,QAAQ;EAClB;CACF;AACF"}
+{"version":3,"file":"recordActions.js","names":["defineRecordLoader","load","id","options","error","defineRecordSave","useAlerts","args","v$","save"],"sources":["../../../../src/domains/system/composables/recordActions.ts"],"sourcesContent":["import type { Ref } from 'vue'\nimport { useAlerts } from '@/domains/system/composables/alerts'\nimport { handleRecordLoadError } from '@/domains/system/composables/recordPage'\n\n/**\n * Get-one loader for a detail or edit page, in the shape `useRecordPage`\n * reads. Raises `loading` and runs `load` with the page's signal.\n * Returns `true` once loaded, else the result of `handleRecordLoadError`: `false`\n * leaves the page, `undefined` means aborted or session expired (page stays).\n * `loading` is lowered unless the load was aborted, because the flag then belongs to the next page.\n * A bare `return` in `load` means loaded, and anything thrown counts as a load failure.\n * Use it only for the record's single request; anything more stays hand-written.\n * @example\n * const fetchData = defineRecordLoader(detailLoading, async (id: IntegerId, signal) => {\n *   faq.value = await fetchFaq({ urlParams: { id }, signal })\n * })\n */\nexport const defineRecordLoader =\n  <Id>(loading: Ref<boolean>, load: (id: Id, signal: AbortSignal | undefined) => Promise<void>) =>\n  async (id: Id, options: { signal?: AbortSignal } = {}): Promise<boolean | undefined> => {\n    loading.value = true\n    try {\n      await load(id, options.signal)\n      return true\n    } catch (error) {\n      return handleRecordLoadError(error) ? false : undefined\n    } finally {\n      if (!options.signal?.aborted) loading.value = false\n    }\n  }\n\n/**\n * Save of a create or edit form. Raises `loading`, touches `v$` and calls `showValidationError`\n * if invalid, runs `save`, shows errors with `showErrorsDefault`, lowers `loading`.\n * The success alert and what follows it stay in `save`.\n * `loading` and `v$` are captured at definition, so both must exist then. Extra validators,\n * flags, error handling, `finally` work, return values or requests stay hand-written.\n * @example\n * const onUpdate = defineRecordSave(saveButtonLoading, v$, async () => {\n *   faq.value = await updateFaq({ urlParams: { id: faq.value.id }, body: faq.value })\n *   showRecordWas('updated')\n * })\n */\nexport const defineRecordSave = <Args extends unknown[]>(\n  loading: Ref<boolean>,\n  v$: Ref<{ $touch: () => void; $invalid: boolean }>,\n  save: (...args: Args) => Promise<void>\n) => {\n  const { showValidationError, showErrorsDefault } = useAlerts()\n  return async (...args: Args): Promise<void> => {\n    loading.value = true\n    try {\n      v$.value.$touch()\n      if (v$.value.$invalid) {\n        showValidationError()\n        return\n      }\n      await save(...args)\n    } catch (error) {\n      showErrorsDefault(error)\n    } finally {\n      loading.value = false\n    }\n  }\n}\n"],"mappings":";;;AAiBA,IAAaA,KACN,GAAuB,MAC5B,OAAO,GAAQ,IAAoC,CAAC,MAAoC;CACtF,EAAQ,QAAQ;CAChB,IAAI;EAEF,OADA,MAAMC,EAAKC,GAAIC,EAAQ,MAAM,GACtB;CACT,SAASC,GAAO;EACd,OAAO,GAAsBA,CAAK,KAAY,KAAA;CAChD,UAAU;EACR,AAAKD,EAAQ,QAAQ,YAAS,EAAQ,QAAQ;CAChD;AACF,GAcWE,KACX,GACA,GACA,MACG;CACH,IAAM,EAAE,wBAAqB,yBAAsBC,EAAU;CAC7D,OAAO,OAAO,GAAGC,MAA8B;EAC7C,EAAQ,QAAQ;EAChB,IAAI;GAEF,IADAC,EAAG,MAAM,OAAO,GACZA,EAAG,MAAM,UAAU;IACrB,EAAoB;IACpB;GACF;GACA,MAAMC,EAAK,GAAGF,CAAI;EACpB,SAASH,GAAO;GACd,EAAkBA,CAAK;EACzB,UAAU;GACR,EAAQ,QAAQ;EAClB;CACF;AACF"}

package/dist/domains/system/composables/recordPage.d.ts

@@ -1,15 +1,12 @@
 import { Ref } from 'vue';
 import { RouteRecordName } from 'vue-router';
 /**
- * Shows why a record could not be loaded and says whether its page should leave.
- *
- * For the record's own get-one, not for what a page loads around it: a 404 or 403 there means the
- * record is not there for this user, a 404 of a secondary request does not. A request that was
- * stopped (the page is gone) and a session found expired (the logout is already loading) show
- * nothing and do not leave. Everything else -- a 5xx, the network, a timeout, the sign-in server --
- * shows the message `showErrorsDefault` has for it and leaves too: the page would only show an
- * empty record with live buttons. While the user is navigating to another page (`trackNavigation`)
- * it shows nothing, the message would stay there; the page's `leave` then stays put as well.
+ * Shows why a record failed to load and returns whether its page should leave.
+ * Only for the record's own get-one: a 404 or 403 there means the record is unavailable, unlike for secondary requests.
+ * An aborted request or an expired session shows nothing and does not leave. Other errors show the
+ * `showErrorsDefault` message and leave, since the page would show an empty record with live buttons.
+ * While the user navigates elsewhere (`trackNavigation`) it shows nothing
+ * and does not leave, because the message would stay on the next page.
  */
 export declare const handleRecordLoadError: (error: unknown, duration?: number) => boolean;
 export interface UseRecordPageOptions {
@@ -17,21 +14,21 @@ export interface UseRecordPageOptions {
     fallbackRouteName?: RouteRecordName;
     fallbackRouteParams?: Record<string, any>;
     /**
-     * What the page gives its Close button: the record's sibling views and the create form. A route
-     * with the record's params is skipped as that record's address only, see `leave`.
+     * Same as the page's Close button: the record's sibling views and the create form.
+     * A route with the record's params is skipped only as that record's address, see `leave`.
      */
     skipRouteNames?: RouteRecordName[];
     /**
-     * The page's loading flag. `leave` holds it up, so the empty record's buttons never show, and the
-     * page lowers it as it unmounts: the flag is often shared by every view of the entity, and the
-     * next one -- a create form that loads nothing -- must not inherit it.
+     * The page's loading flag. `leave` keeps it up so the empty record's buttons never show.
+     * The page lowers it on unmount. The flag is often shared by all views of
+     * the entity, and the next one (e.g. a create form) must not inherit it.
      */
     loading?: Ref<boolean>;
     /**
-     * The record's load, run on mount with the page's signal; `false` from it leaves the page (`leave`), `true` and
-     * `undefined` keep it. A load the page also calls later (a refresh after a save) is fine:
-     * `load: () => getData()`. Leave it out, and write the `onMounted` by hand, when the page acts on the result
-     * otherwise, loads in setup or makes more requests on mount.
+     * The record's load, run on mount with the page's signal. `false` leaves the page, `true` and `undefined` keep it.
+     * A load also called later is fine: `load: () => getData()`.
+     * Omit it and write `onMounted` by hand when the page acts on
+     * the result, loads in setup or makes more requests on mount.
      */
     load?: (signal: AbortSignal) => Promise<boolean | undefined>;
 }
@@ -44,25 +41,13 @@ export interface UseRecordPageReturn {
     onPage: () => boolean;
 }
 /**
- * For a detail or edit page: aborts the record's load when the page goes, and leaves the page when
- * the load fails.
- *
- * ```ts
- * useRecordPage({
- *   fallbackRouteName: '/x',
- *   skipRouteNames: [...],
- *   loading: detailLoading,
- *   load: (signal) => fetchData(id, { signal }),
- * })
- * ```
- *
- * `false` from the loader means "leave"; `undefined` is a load that was superseded or stopped on
- * purpose, after which the page stays. A page that does more with the load writes its own `onMounted`
- * with the returned `signal` and `leave`, see `load`.
- *
- * While the user is navigating to another page (an async guard, a lazy chunk; `trackNavigation`),
- * the page does not leave: the user's navigation decides, and should it fail, the page stays with
- * its loading flag up. Not handled: a guard that refuses the step back can leave the address bar out
- * of step with the router.
+ * For a detail or edit page: aborts the record's load when the page goes, and leaves the page when the load fails.
+ * `false` from the loader means leave. `undefined` is a superseded or aborted load, and the page stays.
+ * While the user navigates elsewhere (`trackNavigation`), the page does not
+ * leave. If that navigation fails, the page stays with its loading flag up.
+ * Not handled: a guard that refuses the step back can leave the address bar out of sync with the router.
+ * @example
+ * useRecordPage({ fallbackRouteName: '/x', skipRouteNames: [...],
+ * loading: detailLoading, load: (signal) => fetchData(id, { signal }) })
  */
 export declare function useRecordPage(options?: UseRecordPageOptions): UseRecordPageReturn;

package/dist/domains/system/composables/recordPage.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordPage.js","names":["handleRecordLoadError","isAnzuApiCancelledError","error","isInCauseChain","cause","SessionExpiredError","isAppNavigationPending","useAlerts","status","apiErrorStatus","isAnzuApiForbiddenError","showErrorT","duration","showErrorsDefault","showUnknownError","pathOf","fullPath","withoutHash","PATH_PARAM","paramsOf","record","router","route","name","match","waitForLanding","done","stopAfterEach","stopError","resolve","landed","failure","settled","navigation","useRecordPage","useRouter","useRouteHistory","useDatatablePageStore","usePageNavigation","path","controller","unmounted","options","stillHere","skipped","current","paths","names","declared","optional","key","params","findTarget","i","history","entry","isLeftAfterFailureRecently","go","target","to","back","landing","preservePageForLanding","leave","onPage","load","onMounted"],"sources":["../../../../src/domains/system/composables/recordPage.ts"],"sourcesContent":["import { onBeforeUnmount, onMounted, type Ref } from 'vue'\nimport { type NavigationFailure, type RouteLocationRaw, type RouteRecordName, type Router, useRouter } from 'vue-router'\nimport { useAlerts } from '@/domains/system/composables/alerts'\nimport {\n  forgetLeftAfterFailure,\n  isLeftAfterFailureRecently,\n  markLeftAfterFailure,\n  useRouteHistory,\n} from '@/domains/system/composables/routeHistory'\nimport { useDatatablePageStore } from '@/domains/system/store/datatablePageStore'\nimport { isAppNavigationPending, usePageNavigation } from '@/domains/system/composables/pageNavigation'\nimport { apiErrorStatus } from '@/domains/api/utils/apiErrors'\nimport { isAnzuApiCancelledError } from '@/shared/error/AnzuApiCancelledError'\nimport { isAnzuApiForbiddenError } from '@/shared/error/AnzuApiForbiddenError'\nimport { SessionExpiredError } from '@/shared/error/SessionExpiredError'\nimport { isInCauseChain } from '@/shared/error/isInCauseChain'\nimport { HTTP_STATUS_FORBIDDEN, HTTP_STATUS_NOT_FOUND } from '@/shared/statusCodes'\n\n/**\n * Shows why a record could not be loaded and says whether its page should leave.\n *\n * For the record's own get-one, not for what a page loads around it: a 404 or 403 there means the\n * record is not there for this user, a 404 of a secondary request does not. A request that was\n * stopped (the page is gone) and a session found expired (the logout is already loading) show\n * nothing and do not leave. Everything else -- a 5xx, the network, a timeout, the sign-in server --\n * shows the message `showErrorsDefault` has for it and leaves too: the page would only show an\n * empty record with live buttons. While the user is navigating to another page (`trackNavigation`)\n * it shows nothing, the message would stay there; the page's `leave` then stays put as well.\n */\nexport const handleRecordLoadError = (error: unknown, duration = -1): boolean => {\n  if (isAnzuApiCancelledError(error)) return false\n  if (isInCauseChain(error, (cause) => cause instanceof SessionExpiredError)) return false\n  if (isAppNavigationPending()) return true\n\n  const { showErrorT, showErrorsDefault, showUnknownError } = useAlerts()\n  const status = apiErrorStatus(error)\n  // A rejected 403 is `AnzuApiForbiddenError`, which carries no status; one let through by\n  // `validateStatus` is a response code error that does.\n  if (isAnzuApiForbiddenError(error) || status === HTTP_STATUS_FORBIDDEN) {\n    showErrorT('common.alert.recordForbidden', duration)\n    return true\n  }\n  if (status === HTTP_STATUS_NOT_FOUND) {\n    showErrorT('common.alert.recordNotFound', duration)\n    return true\n  }\n  if (!showErrorsDefault(error, duration)) showUnknownError(duration)\n  return true\n}\n\nexport interface UseRecordPageOptions {\n  /** Where to go when nothing in the history is a destination: the entity's list. */\n  fallbackRouteName?: RouteRecordName\n  fallbackRouteParams?: Record<string, any>\n  /**\n   * What the page gives its Close button: the record's sibling views and the create form. A route\n   * with the record's params is skipped as that record's address only, see `leave`.\n   */\n  skipRouteNames?: RouteRecordName[]\n  /**\n   * The page's loading flag. `leave` holds it up, so the empty record's buttons never show, and the\n   * page lowers it as it unmounts: the flag is often shared by every view of the entity, and the\n   * next one -- a create form that loads nothing -- must not inherit it.\n   */\n  loading?: Ref<boolean>\n  /**\n   * The record's load, run on mount with the page's signal; `false` from it leaves the page (`leave`), `true` and\n   * `undefined` keep it. A load the page also calls later (a refresh after a save) is fine:\n   * `load: () => getData()`. Leave it out, and write the `onMounted` by hand, when the page acts on the result\n   * otherwise, loads in setup or makes more requests on mount.\n   */\n  load?: (signal: AbortSignal) => Promise<boolean | undefined>\n}\n\nexport interface UseRecordPageReturn {\n  /** For the record's get-one: stopped when the page unmounts. */\n  signal: AbortSignal\n  /** Back to where the user came from, else to the fallback. Resolves whether it got there. */\n  leave: () => Promise<boolean>\n  /** The user is still on this page and not navigating away: for a redirect after the load. */\n  onPage: () => boolean\n}\n\nconst pathOf = (fullPath: string) => fullPath.split(/[?#]/, 1)[0] ?? fullPath\nconst withoutHash = (fullPath: string) => fullPath.split('#', 1)[0] ?? fullPath\n\n// A param's name, its custom regex (whose `)` may be escaped) and its modifier: `?` and `*` make it optional.\nconst PATH_PARAM = /:(\\w+)(?:\\((?:\\\\.|[^\\\\)])*\\))?([?*+])?/g\n\nconst paramsOf = (router: Router, name: RouteRecordName) => {\n  const record = router.getRoutes().find((route) => route.name === name)\n  if (!record) return undefined\n  return [...record.path.matchAll(PATH_PARAM)].map((match) => ({\n    key: match[1]!,\n    optional: match[2] === '?' || match[2] === '*',\n  }))\n}\n\n// `router.back()` answers nothing; its landing, or its error, is the answer.\nconst waitForLanding = (router: Router) =>\n  new Promise<boolean>((resolve) => {\n    const done = (landed: boolean) => {\n      stopAfterEach()\n      stopError()\n      resolve(landed)\n    }\n    const stopAfterEach = router.afterEach((_to, _from, failure) => done(!failure))\n    const stopError = router.onError(() => done(false))\n  })\n\nconst settled = (navigation: Promise<NavigationFailure | void | undefined>) =>\n  navigation.then(\n    (failure) => !failure,\n    () => false\n  )\n\n/**\n * For a detail or edit page: aborts the record's load when the page goes, and leaves the page when\n * the load fails.\n *\n * ```ts\n * useRecordPage({\n *   fallbackRouteName: '/x',\n *   skipRouteNames: [...],\n *   loading: detailLoading,\n *   load: (signal) => fetchData(id, { signal }),\n * })\n * ```\n *\n * `false` from the loader means \"leave\"; `undefined` is a load that was superseded or stopped on\n * purpose, after which the page stays. A page that does more with the load writes its own `onMounted`\n * with the returned `signal` and `leave`, see `load`.\n *\n * While the user is navigating to another page (an async guard, a lazy chunk; `trackNavigation`),\n * the page does not leave: the user's navigation decides, and should it fail, the page stays with\n * its loading flag up. Not handled: a guard that refuses the step back can leave the address bar out\n * of step with the router.\n */\nexport function useRecordPage(options: UseRecordPageOptions = {}): UseRecordPageReturn {\n  const router = useRouter()\n  const { history } = useRouteHistory()\n  const { preservePageForLanding } = useDatatablePageStore()\n  const { onPage } = usePageNavigation()\n\n  // The path, not the name: /x/1 and /x/2 share a name, and a late failure of the one must not move\n  // the user off the other.\n  const path = router.currentRoute.value.path\n  // On it again: a failure there before no longer counts.\n  forgetLeftAfterFailure(path)\n  const controller = new AbortController()\n  let unmounted = false\n  onBeforeUnmount(() => {\n    unmounted = true\n    controller.abort()\n    // Raised by `leave`, or left up by the load just aborted, whose `finally` no longer owns it. The\n    // next page mounts after this one is gone and raises it again for its own load.\n    if (options.loading) options.loading.value = false\n  })\n\n  const stillHere = () => !unmounted && router.currentRoute.value.path === path\n\n  // Unlike the Close button, which skips every entry with the record's route name so that closing\n  // one row never opens another, this goes back to the view the user actually came from -- another\n  // record of the same entity included. Only the addresses of THIS record are skipped, compared\n  // without query and hash (a tab in the query is the same view), plus the create form the record\n  // may have been saved from: back there, Save would create a second record.\n  const skipped = () => {\n    const current = router.currentRoute.value\n    const paths = new Set<string>([pathOf(current.fullPath)])\n    const names = new Set<RouteRecordName>()\n    for (const name of options.skipRouteNames ?? []) {\n      const declared = paramsOf(router, name)\n      if (!declared) continue\n      // A route without params is one address; one the record cannot fill is skipped by name.\n      if (declared.length === 0 || declared.some(({ key, optional }) => !optional && !(key in current.params))) {\n        names.add(name)\n        continue\n      }\n      const params = Object.fromEntries(\n        declared.filter(({ key }) => key in current.params).map(({ key }) => [key, current.params[key]])\n      )\n      try {\n        paths.add(pathOf(router.resolve({ name, params }).fullPath))\n      } catch {\n        names.add(name)\n      }\n    }\n    return { paths, names }\n  }\n\n  const findTarget = (): string | undefined => {\n    const { paths, names } = skipped()\n    for (let i = history.value.length - 1; i >= 0; i--) {\n      const entry = history.value[i]!\n      // An address a page just left after a failure is no destination either: two failing records\n      // next to each other in the history -- A, then B, while the backend is down -- would send the\n      // user back and forth for as long as the outage lasts, B leaving to A, which finds B as its\n      // newest entry. Skipped, the chain ends at the list.\n      if (paths.has(pathOf(entry.fullPath)) || isLeftAfterFailureRecently(pathOf(entry.fullPath))) continue\n      if (entry.name !== undefined && entry.name !== null && names.has(entry.name as RouteRecordName)) continue\n      return entry.fullPath\n    }\n    return undefined\n  }\n\n  // Leaves no trace of the failed address: a step back when the target is the entry right before\n  // it, a replace otherwise -- a push would let the browser's Back return to the page that just\n  // failed, which would fail and leave again.\n  const go = async (to: RouteLocationRaw): Promise<boolean> => {\n    let target: string\n    try {\n      target = router.resolve(to).fullPath\n    } catch {\n      return false\n    }\n    // Without the hash: a list's filter writes it under the router, so the record's `state.back`\n    // names the list without it, while the route history has it. The filter also keeps the list\n    // entry's `current` in step, so the step back lands on the filter, and adds no entry.\n    const back = router.options.history.state.back\n    if (typeof back === 'string' && withoutHash(back) === withoutHash(target)) {\n      const landing = waitForLanding(router)\n      preservePageForLanding(router)\n      router.back()\n      return landing\n    }\n    const navigation = router.replace(to)\n    preservePageForLanding(router, { to, navigation })\n    return settled(navigation)\n  }\n\n  const leave = async (): Promise<boolean> => {\n    if (!stillHere()) return false\n    // Held up for good on a leave that fails: the record is not loaded, and its buttons -- Save\n    // creating a new record, Delete with the address's id -- must not come back. The Close button,\n    // which no page ties to loading, is the way out then.\n    if (options.loading) options.loading.value = true\n    // The user is on the way to another page: that navigation decides, ours would cancel it.\n    if (!onPage()) return false\n    markLeftAfterFailure(path)\n    const target = findTarget()\n    if (target !== undefined && (await go(target))) return true\n    if (!stillHere() || !onPage() || options.fallbackRouteName === undefined) return false\n    return go({ name: options.fallbackRouteName, params: options.fallbackRouteParams })\n  }\n\n  const { load } = options\n  if (load) {\n    onMounted(async () => {\n      if ((await load(controller.signal)) === false) await leave()\n    })\n  }\n\n  return { signal: controller.signal, leave, onPage }\n}\n"],"mappings":"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"}
+{"version":3,"file":"recordPage.js","names":["handleRecordLoadError","isAnzuApiCancelledError","error","isInCauseChain","cause","SessionExpiredError","isAppNavigationPending","useAlerts","status","apiErrorStatus","isAnzuApiForbiddenError","showErrorT","duration","showErrorsDefault","showUnknownError","pathOf","fullPath","withoutHash","PATH_PARAM","paramsOf","record","router","route","name","match","waitForLanding","done","stopAfterEach","stopError","resolve","landed","failure","settled","navigation","useRecordPage","useRouter","useRouteHistory","useDatatablePageStore","usePageNavigation","path","controller","unmounted","options","stillHere","skipped","current","paths","names","declared","optional","key","params","findTarget","i","history","entry","isLeftAfterFailureRecently","go","target","to","back","landing","preservePageForLanding","leave","onPage","load","onMounted"],"sources":["../../../../src/domains/system/composables/recordPage.ts"],"sourcesContent":["import { onBeforeUnmount, onMounted, type Ref } from 'vue'\nimport { type NavigationFailure, type RouteLocationRaw, type RouteRecordName, type Router, useRouter } from 'vue-router'\nimport { useAlerts } from '@/domains/system/composables/alerts'\nimport {\n  forgetLeftAfterFailure,\n  isLeftAfterFailureRecently,\n  markLeftAfterFailure,\n  useRouteHistory,\n} from '@/domains/system/composables/routeHistory'\nimport { useDatatablePageStore } from '@/domains/system/store/datatablePageStore'\nimport { isAppNavigationPending, usePageNavigation } from '@/domains/system/composables/pageNavigation'\nimport { apiErrorStatus } from '@/domains/api/utils/apiErrors'\nimport { isAnzuApiCancelledError } from '@/shared/error/AnzuApiCancelledError'\nimport { isAnzuApiForbiddenError } from '@/shared/error/AnzuApiForbiddenError'\nimport { SessionExpiredError } from '@/shared/error/SessionExpiredError'\nimport { isInCauseChain } from '@/shared/error/isInCauseChain'\nimport { HTTP_STATUS_FORBIDDEN, HTTP_STATUS_NOT_FOUND } from '@/shared/statusCodes'\n\n/**\n * Shows why a record failed to load and returns whether its page should leave.\n * Only for the record's own get-one: a 404 or 403 there means the record is unavailable, unlike for secondary requests.\n * An aborted request or an expired session shows nothing and does not leave. Other errors show the\n * `showErrorsDefault` message and leave, since the page would show an empty record with live buttons.\n * While the user navigates elsewhere (`trackNavigation`) it shows nothing\n * and does not leave, because the message would stay on the next page.\n */\nexport const handleRecordLoadError = (error: unknown, duration = -1): boolean => {\n  if (isAnzuApiCancelledError(error)) return false\n  if (isInCauseChain(error, (cause) => cause instanceof SessionExpiredError)) return false\n  if (isAppNavigationPending()) return true\n\n  const { showErrorT, showErrorsDefault, showUnknownError } = useAlerts()\n  const status = apiErrorStatus(error)\n  // A rejected 403 is `AnzuApiForbiddenError`, which carries no status; one let through by\n  // `validateStatus` is a response code error that does.\n  if (isAnzuApiForbiddenError(error) || status === HTTP_STATUS_FORBIDDEN) {\n    showErrorT('common.alert.recordForbidden', duration)\n    return true\n  }\n  if (status === HTTP_STATUS_NOT_FOUND) {\n    showErrorT('common.alert.recordNotFound', duration)\n    return true\n  }\n  if (!showErrorsDefault(error, duration)) showUnknownError(duration)\n  return true\n}\n\nexport interface UseRecordPageOptions {\n  /** Where to go when nothing in the history is a destination: the entity's list. */\n  fallbackRouteName?: RouteRecordName\n  fallbackRouteParams?: Record<string, any>\n  /**\n   * Same as the page's Close button: the record's sibling views and the create form.\n   * A route with the record's params is skipped only as that record's address, see `leave`.\n   */\n  skipRouteNames?: RouteRecordName[]\n  /**\n   * The page's loading flag. `leave` keeps it up so the empty record's buttons never show.\n   * The page lowers it on unmount. The flag is often shared by all views of\n   * the entity, and the next one (e.g. a create form) must not inherit it.\n   */\n  loading?: Ref<boolean>\n  /**\n   * The record's load, run on mount with the page's signal. `false` leaves the page, `true` and `undefined` keep it.\n   * A load also called later is fine: `load: () => getData()`.\n   * Omit it and write `onMounted` by hand when the page acts on\n   * the result, loads in setup or makes more requests on mount.\n   */\n  load?: (signal: AbortSignal) => Promise<boolean | undefined>\n}\n\nexport interface UseRecordPageReturn {\n  /** For the record's get-one: stopped when the page unmounts. */\n  signal: AbortSignal\n  /** Back to where the user came from, else to the fallback. Resolves whether it got there. */\n  leave: () => Promise<boolean>\n  /** The user is still on this page and not navigating away: for a redirect after the load. */\n  onPage: () => boolean\n}\n\nconst pathOf = (fullPath: string) => fullPath.split(/[?#]/, 1)[0] ?? fullPath\nconst withoutHash = (fullPath: string) => fullPath.split('#', 1)[0] ?? fullPath\n\n// A param's name, its custom regex (whose `)` may be escaped) and its modifier: `?` and `*` make it optional.\nconst PATH_PARAM = /:(\\w+)(?:\\((?:\\\\.|[^\\\\)])*\\))?([?*+])?/g\n\nconst paramsOf = (router: Router, name: RouteRecordName) => {\n  const record = router.getRoutes().find((route) => route.name === name)\n  if (!record) return undefined\n  return [...record.path.matchAll(PATH_PARAM)].map((match) => ({\n    key: match[1]!,\n    optional: match[2] === '?' || match[2] === '*',\n  }))\n}\n\n// `router.back()` returns nothing, so its landing or its error is the result.\nconst waitForLanding = (router: Router) =>\n  new Promise<boolean>((resolve) => {\n    const done = (landed: boolean) => {\n      stopAfterEach()\n      stopError()\n      resolve(landed)\n    }\n    const stopAfterEach = router.afterEach((_to, _from, failure) => done(!failure))\n    const stopError = router.onError(() => done(false))\n  })\n\nconst settled = (navigation: Promise<NavigationFailure | void | undefined>) =>\n  navigation.then(\n    (failure) => !failure,\n    () => false\n  )\n\n/**\n * For a detail or edit page: aborts the record's load when the page goes, and leaves the page when the load fails.\n * `false` from the loader means leave. `undefined` is a superseded or aborted load, and the page stays.\n * While the user navigates elsewhere (`trackNavigation`), the page does not\n * leave. If that navigation fails, the page stays with its loading flag up.\n * Not handled: a guard that refuses the step back can leave the address bar out of sync with the router.\n * @example\n * useRecordPage({ fallbackRouteName: '/x', skipRouteNames: [...],\n * loading: detailLoading, load: (signal) => fetchData(id, { signal }) })\n */\nexport function useRecordPage(options: UseRecordPageOptions = {}): UseRecordPageReturn {\n  const router = useRouter()\n  const { history } = useRouteHistory()\n  const { preservePageForLanding } = useDatatablePageStore()\n  const { onPage } = usePageNavigation()\n\n  // The path, not the name: /x/1 and /x/2 share a name, and a late failure of one must not move the user off the other.\n  const path = router.currentRoute.value.path\n  // The page is visited again, so an earlier failure no longer counts.\n  forgetLeftAfterFailure(path)\n  const controller = new AbortController()\n  let unmounted = false\n  onBeforeUnmount(() => {\n    unmounted = true\n    controller.abort()\n    // Raised by `leave`, or left up by the aborted load whose `finally` no longer owns it.\n    // The next page mounts after this one is gone and raises it again for its own load.\n    if (options.loading) options.loading.value = false\n  })\n\n  const stillHere = () => !unmounted && router.currentRoute.value.path === path\n\n  // Unlike the Close button, which skips every entry with the record's route name, this\n  // returns to the view the user came from, including another record of the same entity.\n  // Only this record's addresses are skipped, compared without query and hash (a tab in the query is the same view).\n  // The create form is skipped too: going back there, Save would create a second record.\n  const skipped = () => {\n    const current = router.currentRoute.value\n    const paths = new Set<string>([pathOf(current.fullPath)])\n    const names = new Set<RouteRecordName>()\n    for (const name of options.skipRouteNames ?? []) {\n      const declared = paramsOf(router, name)\n      if (!declared) continue\n      // A route without params is one address; one the record cannot fill is skipped by name.\n      if (declared.length === 0 || declared.some(({ key, optional }) => !optional && !(key in current.params))) {\n        names.add(name)\n        continue\n      }\n      const params = Object.fromEntries(\n        declared.filter(({ key }) => key in current.params).map(({ key }) => [key, current.params[key]])\n      )\n      try {\n        paths.add(pathOf(router.resolve({ name, params }).fullPath))\n      } catch {\n        names.add(name)\n      }\n    }\n    return { paths, names }\n  }\n\n  const findTarget = (): string | undefined => {\n    const { paths, names } = skipped()\n    for (let i = history.value.length - 1; i >= 0; i--) {\n      const entry = history.value[i]!\n      // Addresses left recently after a failure are skipped too.\n      // Otherwise two failing records in the history (A, then B, backend down) send the\n      // user back and forth for the whole outage. Skipped, the chain ends at the list.\n      if (paths.has(pathOf(entry.fullPath)) || isLeftAfterFailureRecently(pathOf(entry.fullPath))) continue\n      if (entry.name !== undefined && entry.name !== null && names.has(entry.name as RouteRecordName)) continue\n      return entry.fullPath\n    }\n    return undefined\n  }\n\n  // Leaves no trace of the failed address: a step back when the target is the previous entry, a replace otherwise.\n  // A push would let browser Back return to the failed page, which would fail and leave again.\n  const go = async (to: RouteLocationRaw): Promise<boolean> => {\n    let target: string\n    try {\n      target = router.resolve(to).fullPath\n    } catch {\n      return false\n    }\n    // Compared without the hash. A list filter writes the hash outside the\n    // router, so `state.back` lacks it while the route history has it.\n    // The filter keeps the list entry's `current` in sync, so the step back lands on the filter and adds no entry.\n    const back = router.options.history.state.back\n    if (typeof back === 'string' && withoutHash(back) === withoutHash(target)) {\n      const landing = waitForLanding(router)\n      preservePageForLanding(router)\n      router.back()\n      return landing\n    }\n    const navigation = router.replace(to)\n    preservePageForLanding(router, { to, navigation })\n    return settled(navigation)\n  }\n\n  const leave = async (): Promise<boolean> => {\n    if (!stillHere()) return false\n    // Stays up for good if the leave fails. The record is not loaded, and its Save and Delete buttons must not return.\n    // The Close button, which no page ties to loading, is the way out then.\n    if (options.loading) options.loading.value = true\n    // The user is navigating to another page. That navigation decides, and ours would cancel it.\n    if (!onPage()) return false\n    markLeftAfterFailure(path)\n    const target = findTarget()\n    if (target !== undefined && (await go(target))) return true\n    if (!stillHere() || !onPage() || options.fallbackRouteName === undefined) return false\n    return go({ name: options.fallbackRouteName, params: options.fallbackRouteParams })\n  }\n\n  const { load } = options\n  if (load) {\n    onMounted(async () => {\n      if ((await load(controller.signal)) === false) await leave()\n    })\n  }\n\n  return { signal: controller.signal, leave, onPage }\n}\n"],"mappings":"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"}

package/dist/domains/system/composables/routeHistory.d.ts

@@ -18,12 +18,11 @@ export interface NavigateBackTarget {
 }
 export interface NavigateBackOptions {
     /**
-     * Route names that are not a destination -- typically the sibling views of the record being
-     * closed and the create form it may have been reached from. The CURRENT route is always skipped
-     * on top of these, so there is no need to name it here.
+     * Route names that are not a destination, typically the record's sibling views and its create form.
+     * The current route is always skipped, so do not list it here.
      */
     skipRouteNames?: RouteRecordName[];
-    /** Where to go when the walk finds nothing -- a tab opened straight on the record. */
+    /** Where to go when the walk finds nothing, e.g. a tab opened directly on the record. */
     fallbackRouteName?: RouteRecordName;
     fallbackRouteParams?: Record<string, any>;
 }
@@ -33,6 +32,6 @@ export declare function useRouteHistory(): {
     clearHistory: () => void;
     setBlacklistedRoutes: (routeNames: RouteRecordName[]) => void;
     addBlacklistedRoute: (routeName: RouteRecordName) => void;
-    /** Returns where it goes and its navigation, `undefined` for a step back in the browser's history. */
+    /** Returns the target and its navigation, or `undefined` for a browser history step back. */
     navigateBack: (router: Router, options?: NavigateBackOptions) => NavigateBackTarget | undefined;
 };

package/dist/domains/system/composables/routeHistory.js.map

@@ -1 +1 @@
-{"version":3,"file":"routeHistory.js","names":["history","ref","historyGeneration","leftAfterFailure","LEFT_AFTER_FAILURE_MS","markLeftAfterFailure","now","left","at","path","forgetLeftAfterFailure","isLeftAfterFailureRecently","blacklistedRouteNames","MAX_HISTORY","useRouteHistory","addRoute","route","pathAndQuery","lastRoute","setBlacklistedRoutes","routeNames","addBlacklistedRoute","routeName","findRouteBack","i","isDestination","readonly","options","current","router","skip","skipRouteNames","isCurrent","entry","generation","navigation","failure","fallbackRouteName","fallback","fallbackRouteParams"],"sources":["../../../../src/domains/system/composables/routeHistory.ts"],"sourcesContent":["import type {\n  NavigationFailure,\n  RouteLocationNormalized,\n  RouteLocationRaw,\n  RouteRecordName,\n  RouteRecordNameGeneric,\n  Router,\n} from 'vue-router'\nimport { readonly, type Ref, ref } from 'vue'\n\n/** A visited route, as far as going back to it needs. */\nexport interface RouteHistoryEntry {\n  name: RouteRecordNameGeneric\n  fullPath: string\n}\n\n// Module state, so the history is one list per document. A test that fills it has to clear it\n// again (`clearHistory`), or the next test in the file reads what the previous one left behind.\nconst history = ref<RouteHistoryEntry[]>([])\n// Bumped by `clearHistory`, so that a Close landing after it leaves the new list alone.\nlet historyGeneration = 0\n// Paths a record page left because its record failed, with when; read by `useRecordPage`, which\n// skips them as a destination for a while. Here so that `clearHistory` clears it with the history.\nconst leftAfterFailure = new Map<string, number>()\nconst LEFT_AFTER_FAILURE_MS = 60_000\n\n/** For `useRecordPage` only. */\nexport const markLeftAfterFailure = (path: string) => {\n  const now = Date.now()\n  // Expired ones go here too: a path is otherwise only dropped when it is looked up again.\n  for (const [left, at] of leftAfterFailure) if (now - at >= LEFT_AFTER_FAILURE_MS) leftAfterFailure.delete(left)\n  leftAfterFailure.set(path, now)\n}\n\n/** For `useRecordPage` only: the page is there again, so a failure before no longer counts. */\nexport const forgetLeftAfterFailure = (path: string) => {\n  leftAfterFailure.delete(path)\n}\n\n/** For `useRecordPage` only. */\nexport const isLeftAfterFailureRecently = (path: string) => {\n  const at = leftAfterFailure.get(path)\n  if (at === undefined) return false\n  if (Date.now() - at < LEFT_AFTER_FAILURE_MS) return true\n  leftAfterFailure.delete(path)\n  return false\n}\nconst blacklistedRouteNames = ref<RouteRecordName[]>([])\n/**\n * How many routes back the history reaches. Note that `addRoute` drops only CONSECUTIVE duplicates,\n * so a user bouncing A -> B -> A -> B fills four of these slots and can push the listing they want\n * to return to out of the window. `fallbackRouteName` is what catches that.\n */\nconst MAX_HISTORY = 10\n\n/** Where `navigateBack` goes and its navigation, as `router.push` answers it. */\nexport interface NavigateBackTarget {\n  to: RouteLocationRaw\n  navigation: Promise<NavigationFailure | void | undefined>\n}\n\nexport interface NavigateBackOptions {\n  /**\n   * Route names that are not a destination -- typically the sibling views of the record being\n   * closed and the create form it may have been reached from. The CURRENT route is always skipped\n   * on top of these, so there is no need to name it here.\n   */\n  skipRouteNames?: RouteRecordName[]\n  /** Where to go when the walk finds nothing -- a tab opened straight on the record. */\n  fallbackRouteName?: RouteRecordName\n  fallbackRouteParams?: Record<string, any>\n}\n\nexport function useRouteHistory(): {\n  history: Readonly<Ref<readonly RouteHistoryEntry[]>>\n  addRoute: (route: RouteLocationNormalized) => void\n  clearHistory: () => void\n  // The admin's typed router narrows `RouteRecordName` to its route names: a misspelled one does not compile.\n  setBlacklistedRoutes: (routeNames: RouteRecordName[]) => void\n  addBlacklistedRoute: (routeName: RouteRecordName) => void\n  /** Returns where it goes and its navigation, `undefined` for a step back in the browser's history. */\n  navigateBack: (router: Router, options?: NavigateBackOptions) => NavigateBackTarget | undefined\n} {\n  const addRoute = (route: RouteLocationNormalized) => {\n    if (blacklistedRouteNames.value.includes(route.name as RouteRecordName)) {\n      return\n    }\n\n    // A list filter rewrites its hash with `history.replaceState`, which the router never sees. On a\n    // push the address bar still shows the route being left, so its hash is the one to come back to.\n    const [pathAndQuery] = route.fullPath.split('#')\n    if (pathAndQuery === window.location.pathname + window.location.search && route.hash !== window.location.hash) {\n      route = { ...route, hash: window.location.hash, fullPath: pathAndQuery + window.location.hash }\n    }\n\n    const lastRoute = history.value[history.value.length - 1]\n    if (lastRoute && lastRoute.fullPath === route.fullPath) {\n      return\n    }\n\n    history.value.push({ name: route.name, fullPath: route.fullPath })\n    if (history.value.length > MAX_HISTORY) {\n      history.value.shift()\n    }\n  }\n\n  /** REPLACES the list. Two callers would overwrite each other -- to add one, use `addBlacklistedRoute`. */\n  const setBlacklistedRoutes = (routeNames: RouteRecordName[]) => {\n    blacklistedRouteNames.value = routeNames\n  }\n\n  const addBlacklistedRoute = (routeName: RouteRecordName) => {\n    if (!blacklistedRouteNames.value.includes(routeName)) {\n      blacklistedRouteNames.value.push(routeName)\n    }\n  }\n\n  // Internal on purpose. A caller reaching for it directly would get the walk WITHOUT the\n  // current-route exclusion `navigateBack` adds -- which is the whole trap `navigateBack` exists\n  // to close.\n  const findRouteBack = (isDestination: (route: RouteHistoryEntry) => boolean): RouteHistoryEntry | undefined => {\n    for (let i = history.value.length - 1; i >= 0; i--) {\n      if (isDestination(history.value[i]!)) {\n        return history.value[i]\n      }\n    }\n    return undefined\n  }\n\n  const clearHistory = () => {\n    history.value = []\n    historyGeneration++\n    leftAfterFailure.clear()\n  }\n\n  const navigateBack = (router: Router, options: NavigateBackOptions = {}): NavigateBackTarget | undefined => {\n    const { skipRouteNames, fallbackRouteName, fallbackRouteParams } = options\n    const current = router.currentRoute.value\n    const skip: readonly RouteRecordNameGeneric[] = skipRouteNames ?? []\n\n    // The route we are on is never a place to go back to. `addRoute` runs in `beforeEach`, so a\n    // navigation that a later guard cancels still records the route we never left -- and pushing\n    // that again is a silent no-op, which reads as the button doing nothing at all. Callers\n    // therefore do not name their own route in `skipRouteNames`.\n    //\n    // Both tests sit INSIDE the walk rather than filtering its result: a route name is optional in\n    // vue-router, and a nameless current route can only be recognised by its path -- rejecting the\n    // candidate afterwards would stop the walk at it instead of carrying on to the entry before.\n    // Names are compared with `===` so a symbol name counts too, but only when the current route\n    // has one: two different nameless routes are both `undefined` and are not the same place.\n    const isCurrent = (route: RouteHistoryEntry) =>\n      route.fullPath === current.fullPath || (current.name !== undefined && route.name === current.name)\n\n    const route = findRouteBack((entry) => !isCurrent(entry) && !skip.includes(entry.name))\n\n    if (route) {\n      const generation = historyGeneration\n      const navigation = router.push(route.fullPath)\n      // Back on `route`, what came after it is behind the user, the route being left included, which\n      // this navigation's `beforeEach` records. Kept, it is the next Close's destination: detail A, a\n      // link to detail B, Close to A, and Close on A went back to B, over and over. Dropped once the\n      // navigation has landed, so one that a guard stops (unsaved changes) or a second click cancels\n      // leaves the history as it was. `Promise.resolve`: a test double's `push` may answer nothing.\n      Promise.resolve(navigation).then(\n        (failure) => {\n          if (failure || generation !== historyGeneration) return\n          // Gone without `clearHistory`, `route` was pushed out at the front (`MAX_HISTORY`) by the\n          // route being left: all that is still here came after it.\n          const at = history.value.indexOf(route)\n          history.value.splice(at === -1 ? 0 : at)\n        },\n        () => undefined\n      )\n      return { to: route.fullPath, navigation }\n    }\n    if (fallbackRouteName) {\n      const fallback = { name: fallbackRouteName, params: fallbackRouteParams }\n      return { to: fallback, navigation: router.push(fallback) }\n    }\n    router.back()\n    return undefined\n  }\n\n  return {\n    history: readonly(history),\n    addRoute,\n    clearHistory,\n    setBlacklistedRoutes,\n    addBlacklistedRoute,\n    navigateBack,\n  }\n}\n"],"mappings":";;AAkBA,IAAMA,IAAUC,EAAyB,CAAC,CAAC,GAEvCC,IAAoB,GAGlBC,oBAAmB,IAAI,IAAoB,GAC3CC,IAAwB,KAGjBC,KAAwB,MAAiB;CACpD,IAAMC,IAAM,KAAK,IAAI;CAErB,KAAK,IAAM,CAACC,GAAMC,MAAOL,GAAkB,AAAIG,IAAME,KAAMJ,KAAuBD,EAAiB,OAAOI,CAAI;CAC9G,EAAiB,IAAIE,GAAMH,CAAG;AAChC,GAGaI,KAA0B,MAAiB;CACtD,EAAiB,OAAOD,CAAI;AAC9B,GAGaE,KAA8B,MAAiB;CAC1D,IAAMH,IAAKL,EAAiB,IAAIM,CAAI;CAIpC,OAHID,MAAO,KAAA,IAAkB,KACzB,KAAK,IAAI,IAAIA,IAAKJ,MACtBD,EAAiB,OAAOM,CAAI,GACrB;AACT,GACMG,IAAwBX,EAAuB,CAAC,CAAC,GAMjDY,IAAc;AAoBpB,SAAgBC,IASd;CACA,IAAMC,KAAY,MAAmC;EACnD,IAAIH,EAAsB,MAAM,SAASI,EAAM,IAAuB,GACpE;EAKF,IAAM,CAACC,KAAgBD,EAAM,SAAS,MAAM,GAAG;EAC/C,AAAIC,MAAiB,OAAO,SAAS,WAAW,OAAO,SAAS,UAAUD,EAAM,SAAS,OAAO,SAAS,SACvG,IAAQ;GAAE,GAAGA;GAAO,MAAM,OAAO,SAAS;GAAM,UAAUC,IAAe,OAAO,SAAS;EAAK;EAGhG,IAAMC,IAAYlB,EAAQ,MAAMA,EAAQ,MAAM,SAAS;EACvD,AAAIkB,KAAaA,EAAU,aAAaF,EAAM,aAI9ChB,EAAQ,MAAM,KAAK;GAAE,MAAMgB,EAAM;GAAM,UAAUA,EAAM;EAAS,CAAC,GAC7DhB,EAAQ,MAAM,SAASa,KACzBb,EAAQ,MAAM,MAAM;CAExB,GAGMmB,KAAwB,MAAkC;EAC9D,EAAsB,QAAQC;CAChC,GAEMC,KAAuB,MAA+B;EAC1D,AAAKT,EAAsB,MAAM,SAASU,CAAS,KACjDV,EAAsB,MAAM,KAAKU,CAAS;CAE9C,GAKMC,KAAiB,MAAwF;EAC7G,KAAK,IAAIC,IAAIxB,EAAQ,MAAM,SAAS,GAAGwB,KAAK,GAAG,KAC7C,IAAIC,EAAczB,EAAQ,MAAMwB,EAAG,GACjC,OAAOxB,EAAQ,MAAMwB;CAI3B;CAwDA,OAAO;EACL,SAASE,EAAS1B,CAAO;EACzB;EACA,oBAzDyB;GAGzB,AAFA,EAAQ,QAAQ,CAAC,GACjB,KACAG,EAAiB,MAAM;EACzB;EAsDE;EACA;EACA,eAtDoB,GAAgB,IAA+B,CAAC,MAAsC;GAC1G,IAAM,EAAE,mBAAgB,sBAAmB,2BAAwBwB,GAC7DC,IAAUC,EAAO,aAAa,OAC9BC,IAA0CC,KAAkB,CAAC,GAY7DC,KAAa,MACjBhB,EAAM,aAAaY,EAAQ,YAAaA,EAAQ,SAAS,KAAA,KAAaZ,EAAM,SAASY,EAAQ,MAEzFZ,IAAQO,GAAe,MAAU,CAACS,EAAUC,CAAK,KAAK,CAACH,EAAK,SAASG,EAAM,IAAI,CAAC;GAEtF,IAAIjB,GAAO;IACT,IAAMkB,IAAahC,GACbiC,IAAaN,EAAO,KAAKb,EAAM,QAAQ;IAgB7C,OAVA,QAAQ,QAAQmB,CAAU,CAAC,CAAC,MACzB,MAAY;KACX,IAAIC,KAAWF,MAAehC,GAAmB;KAGjD,IAAMM,IAAKR,EAAQ,MAAM,QAAQgB,CAAK;KACtC,EAAQ,MAAM,OAAOR,MAAO,KAAK,IAAIA,CAAE;IACzC,SACM,KAAA,CACR,GACO;KAAE,IAAIQ,EAAM;KAAU;IAAW;GAC1C;GACA,IAAIqB,GAAmB;IACrB,IAAMC,IAAW;KAAE,MAAMD;KAAmB,QAAQE;IAAoB;IACxE,OAAO;KAAE,IAAID;KAAU,YAAYT,EAAO,KAAKS,CAAQ;IAAE;GAC3D;GACA,EAAO,KAAK;EAEd;CASA;AACF"}
+{"version":3,"file":"routeHistory.js","names":["history","ref","historyGeneration","leftAfterFailure","LEFT_AFTER_FAILURE_MS","markLeftAfterFailure","now","left","at","path","forgetLeftAfterFailure","isLeftAfterFailureRecently","blacklistedRouteNames","MAX_HISTORY","useRouteHistory","addRoute","route","pathAndQuery","lastRoute","setBlacklistedRoutes","routeNames","addBlacklistedRoute","routeName","findRouteBack","i","isDestination","readonly","options","current","router","skip","skipRouteNames","isCurrent","entry","generation","navigation","failure","fallbackRouteName","fallback","fallbackRouteParams"],"sources":["../../../../src/domains/system/composables/routeHistory.ts"],"sourcesContent":["import type {\n  NavigationFailure,\n  RouteLocationNormalized,\n  RouteLocationRaw,\n  RouteRecordName,\n  RouteRecordNameGeneric,\n  Router,\n} from 'vue-router'\nimport { readonly, type Ref, ref } from 'vue'\n\n/** A visited route, as far as going back to it needs. */\nexport interface RouteHistoryEntry {\n  name: RouteRecordNameGeneric\n  fullPath: string\n}\n\n// Module state, so there is one history per document. A test that fills\n// it must call `clearHistory`, or the next test sees the leftovers.\nconst history = ref<RouteHistoryEntry[]>([])\n// Bumped by `clearHistory`, so a Close landing afterwards leaves the new list alone.\nlet historyGeneration = 0\n// Paths a record page left after its record failed, with the\n// time. `useRecordPage` skips them as destinations for a while.\n// Kept here so `clearHistory` clears it too.\nconst leftAfterFailure = new Map<string, number>()\nconst LEFT_AFTER_FAILURE_MS = 60_000\n\n/** For `useRecordPage` only. */\nexport const markLeftAfterFailure = (path: string) => {\n  const now = Date.now()\n  // Prunes expired entries here too. Otherwise a path is dropped only when it is looked up again.\n  for (const [left, at] of leftAfterFailure) if (now - at >= LEFT_AFTER_FAILURE_MS) leftAfterFailure.delete(left)\n  leftAfterFailure.set(path, now)\n}\n\n/** For `useRecordPage` only: the page is there again, so a failure before no longer counts. */\nexport const forgetLeftAfterFailure = (path: string) => {\n  leftAfterFailure.delete(path)\n}\n\n/** For `useRecordPage` only. */\nexport const isLeftAfterFailureRecently = (path: string) => {\n  const at = leftAfterFailure.get(path)\n  if (at === undefined) return false\n  if (Date.now() - at < LEFT_AFTER_FAILURE_MS) return true\n  leftAfterFailure.delete(path)\n  return false\n}\nconst blacklistedRouteNames = ref<RouteRecordName[]>([])\n/**\n * How many routes back the history reaches. `addRoute` drops only consecutive\n * duplicates, so A, B, A, B uses four slots and can push the wanted list out.\n * `fallbackRouteName` covers that case.\n */\nconst MAX_HISTORY = 10\n\n/** Where `navigateBack` goes and its navigation, as `router.push` answers it. */\nexport interface NavigateBackTarget {\n  to: RouteLocationRaw\n  navigation: Promise<NavigationFailure | void | undefined>\n}\n\nexport interface NavigateBackOptions {\n  /**\n   * Route names that are not a destination, typically the record's sibling views and its create form.\n   * The current route is always skipped, so do not list it here.\n   */\n  skipRouteNames?: RouteRecordName[]\n  /** Where to go when the walk finds nothing, e.g. a tab opened directly on the record. */\n  fallbackRouteName?: RouteRecordName\n  fallbackRouteParams?: Record<string, any>\n}\n\nexport function useRouteHistory(): {\n  history: Readonly<Ref<readonly RouteHistoryEntry[]>>\n  addRoute: (route: RouteLocationNormalized) => void\n  clearHistory: () => void\n  // The admin's typed router narrows `RouteRecordName` to its route names: a misspelled one does not compile.\n  setBlacklistedRoutes: (routeNames: RouteRecordName[]) => void\n  addBlacklistedRoute: (routeName: RouteRecordName) => void\n  /** Returns the target and its navigation, or `undefined` for a browser history step back. */\n  navigateBack: (router: Router, options?: NavigateBackOptions) => NavigateBackTarget | undefined\n} {\n  const addRoute = (route: RouteLocationNormalized) => {\n    if (blacklistedRouteNames.value.includes(route.name as RouteRecordName)) {\n      return\n    }\n\n    // A list filter rewrites its hash with `history.replaceState`, which the router never sees.\n    // On a push the address bar still shows the route being left, so its hash is the one to return to.\n    const [pathAndQuery] = route.fullPath.split('#')\n    if (pathAndQuery === window.location.pathname + window.location.search && route.hash !== window.location.hash) {\n      route = { ...route, hash: window.location.hash, fullPath: pathAndQuery + window.location.hash }\n    }\n\n    const lastRoute = history.value[history.value.length - 1]\n    if (lastRoute && lastRoute.fullPath === route.fullPath) {\n      return\n    }\n\n    history.value.push({ name: route.name, fullPath: route.fullPath })\n    if (history.value.length > MAX_HISTORY) {\n      history.value.shift()\n    }\n  }\n\n  /** Replaces the whole list, so two callers overwrite each other. Use `addBlacklistedRoute` to add one. */\n  const setBlacklistedRoutes = (routeNames: RouteRecordName[]) => {\n    blacklistedRouteNames.value = routeNames\n  }\n\n  const addBlacklistedRoute = (routeName: RouteRecordName) => {\n    if (!blacklistedRouteNames.value.includes(routeName)) {\n      blacklistedRouteNames.value.push(routeName)\n    }\n  }\n\n  // Internal on purpose. Called directly, it lacks the current-route exclusion that `navigateBack` adds.\n  const findRouteBack = (isDestination: (route: RouteHistoryEntry) => boolean): RouteHistoryEntry | undefined => {\n    for (let i = history.value.length - 1; i >= 0; i--) {\n      if (isDestination(history.value[i]!)) {\n        return history.value[i]\n      }\n    }\n    return undefined\n  }\n\n  const clearHistory = () => {\n    history.value = []\n    historyGeneration++\n    leftAfterFailure.clear()\n  }\n\n  const navigateBack = (router: Router, options: NavigateBackOptions = {}): NavigateBackTarget | undefined => {\n    const { skipRouteNames, fallbackRouteName, fallbackRouteParams } = options\n    const current = router.currentRoute.value\n    const skip: readonly RouteRecordNameGeneric[] = skipRouteNames ?? []\n\n    // The current route is never a destination. `addRoute` runs in `beforeEach`, so a navigation\n    // cancelled by a later guard still records it, and pushing it again is a silent no-op.\n    // The check runs inside the walk, not on its result. A nameless current route is recognised only\n    // by its path, and rejecting the result afterwards would stop the walk instead of continuing.\n    // Names use `===` so symbol names work, but only when the current route has\n    // a name: two nameless routes are both `undefined` and not the same place.\n    const isCurrent = (route: RouteHistoryEntry) =>\n      route.fullPath === current.fullPath || (current.name !== undefined && route.name === current.name)\n\n    const route = findRouteBack((entry) => !isCurrent(entry) && !skip.includes(entry.name))\n\n    if (route) {\n      const generation = historyGeneration\n      const navigation = router.push(route.fullPath)\n      // Back on `route`, the entries after it are behind the user. Kept, they become\n      // the next Close's destination, and Close ping-pongs between two details.\n      // They are dropped only after landing, so a navigation stopped by a\n      // guard or cancelled by a second click leaves the history unchanged.\n      // `Promise.resolve` because a test double's `push` may return nothing.\n      Promise.resolve(navigation).then(\n        (failure) => {\n          if (failure || generation !== historyGeneration) return\n          // Missing without `clearHistory` means `route` was pushed out\n          // at the front by `MAX_HISTORY`. Everything left came after it.\n          const at = history.value.indexOf(route)\n          history.value.splice(at === -1 ? 0 : at)\n        },\n        () => undefined\n      )\n      return { to: route.fullPath, navigation }\n    }\n    if (fallbackRouteName) {\n      const fallback = { name: fallbackRouteName, params: fallbackRouteParams }\n      return { to: fallback, navigation: router.push(fallback) }\n    }\n    router.back()\n    return undefined\n  }\n\n  return {\n    history: readonly(history),\n    addRoute,\n    clearHistory,\n    setBlacklistedRoutes,\n    addBlacklistedRoute,\n    navigateBack,\n  }\n}\n"],"mappings":"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"}

package/dist/domains/system/composables/sentry.js.map

@@ -1 +1 @@
-{"version":3,"file":"sentry.js","names":["sentryPromise","getSentry","module","useSentry","consoleLabel","component","report","sentry","taggedContext","context","error","level","message","key","value","user"],"sources":["../../../../src/domains/system/composables/sentry.ts"],"sourcesContent":["import type * as SentryType from '@sentry/vue'\n\ninterface SentryContext {\n  extra?: Record<string, any>\n  tags?: Record<string, string>\n  level?: 'fatal' | 'error' | 'warning' | 'log' | 'info' | 'debug'\n  [key: string]: any\n}\n\nlet sentryPromise: Promise<typeof SentryType | null> | null = null\n\nconst getSentry = (): Promise<typeof SentryType | null> => {\n  if (!sentryPromise) {\n    sentryPromise = import('@sentry/vue').then((module) => module).catch(() => null)\n  }\n  return sentryPromise\n}\n\nexport function useSentry(component = 'common-admin') {\n  const consoleLabel = `[${component}]`\n\n  /**\n   * Sentry is imported lazily, so nothing here is synchronous and nothing here may throw: a failed\n   * report must never take down the code that was only trying to report something.\n   */\n  const report = (send: (sentry: typeof SentryType) => void): void => {\n    getSentry().then((sentry) => {\n      if (!sentry) {\n        return\n      }\n      try {\n        send(sentry)\n      } catch (e) {\n        console.debug('Sentry logging failed', e)\n      }\n    })\n  }\n\n  const taggedContext = (context?: SentryContext): SentryContext => ({\n    ...context,\n    tags: {\n      ...context?.tags,\n      component,\n    },\n  })\n\n  const logError = (error: Error, context?: SentryContext): void => {\n    console.error(consoleLabel, error)\n\n    report((sentry) => sentry.captureException(error, taggedContext(context)))\n  }\n\n  const logMessage = (\n    message: string,\n    level: 'fatal' | 'error' | 'warning' | 'info' | 'debug' = 'info',\n    context?: SentryContext\n  ): void => {\n    switch (level) {\n      case 'fatal':\n      case 'error':\n        console.error(consoleLabel, message)\n        break\n      case 'warning':\n        console.warn(consoleLabel, message)\n        break\n      case 'info':\n        console.info(consoleLabel, message)\n        break\n      case 'debug':\n        console.debug(consoleLabel, message)\n        break\n      default:\n        console.log(consoleLabel, message)\n    }\n\n    report((sentry) => sentry.captureMessage(message, { level, ...taggedContext(context) }))\n  }\n\n  const setTag = (key: string, value: string): void => {\n    report((sentry) => sentry.setTag(key, value))\n  }\n\n  const setUser = (user: { id: string; email?: string; username?: string }): void => {\n    report((sentry) => sentry.setUser(user))\n  }\n\n  return {\n    logError,\n    logMessage,\n    setTag,\n    setUser,\n  }\n}\n"],"mappings":";AASA,IAAIA,IAA0D,MAExDC,WACJ,AACED,MAAgB,OAAO,cAAc,CAAC,MAAM,MAAWE,CAAM,CAAC,CAAC,YAAY,IAAI,GAE1EF;AAGT,SAAgBG,EAAU,IAAY,gBAAgB;CACpD,IAAMC,IAAe,IAAIC,EAAU,IAM7BC,KAAU,MAAoD;EAClE,EAAU,CAAC,CAAC,MAAM,MAAW;GAC3B,IAAKC,GAGL,IAAI;IACF,EAAKA,CAAM;GACb,SAAS,GAAG;IACV,QAAQ,MAAM,yBAAyB,CAAC;GAC1C;EACF,CAAC;CACH,GAEMC,KAAiB,OAA4C;EACjE,GAAGC;EACH,MAAM;GACJ,GAAGA,GAAS;GACZ;EACF;CACF;CA0CA,OAAO;EACL,WAzCgB,GAAc,MAAkC;GAGhE,AAFA,QAAQ,MAAML,GAAcM,CAAK,GAEjCJ,GAAQ,MAAWC,EAAO,iBAAiBG,GAAOF,EAAcC,CAAO,CAAC,CAAC;EAC3E;EAsCE,aAnCA,GACA,IAA0D,QAC1D,MACS;GACT,QAAQE,GAAR;IACE,KAAK;IACL,KAAK;KACH,QAAQ,MAAMP,GAAcQ,CAAO;KACnC;IACF,KAAK;KACH,QAAQ,KAAKR,GAAcQ,CAAO;KAClC;IACF,KAAK;KACH,QAAQ,KAAKR,GAAcQ,CAAO;KAClC;IACF,KAAK;KACH,QAAQ,MAAMR,GAAcQ,CAAO;KACnC;IACF,SACE,QAAQ,IAAIR,GAAcQ,CAAO;GACrC;GAEA,GAAQ,MAAWL,EAAO,eAAeK,GAAS;IAAE;IAAO,GAAGJ,EAAcC,CAAO;GAAE,CAAC,CAAC;EACzF;EAaE,SAXc,GAAa,MAAwB;GACnD,GAAQ,MAAWF,EAAO,OAAOM,GAAKC,CAAK,CAAC;EAC9C;EAUE,UARe,MAAkE;GACjF,GAAQ,MAAWP,EAAO,QAAQQ,CAAI,CAAC;EACzC;CAOA;AACF"}
+{"version":3,"file":"sentry.js","names":["sentryPromise","getSentry","module","useSentry","consoleLabel","component","report","sentry","taggedContext","context","error","level","message","key","value","user"],"sources":["../../../../src/domains/system/composables/sentry.ts"],"sourcesContent":["import type * as SentryType from '@sentry/vue'\n\ninterface SentryContext {\n  extra?: Record<string, any>\n  tags?: Record<string, string>\n  level?: 'fatal' | 'error' | 'warning' | 'log' | 'info' | 'debug'\n  [key: string]: any\n}\n\nlet sentryPromise: Promise<typeof SentryType | null> | null = null\n\nconst getSentry = (): Promise<typeof SentryType | null> => {\n  if (!sentryPromise) {\n    sentryPromise = import('@sentry/vue').then((module) => module).catch(() => null)\n  }\n  return sentryPromise\n}\n\nexport function useSentry(component = 'common-admin') {\n  const consoleLabel = `[${component}]`\n\n  /**\n   * Sentry is imported lazily, so this is async and must never\n   * throw. A failed report must not break the code that reports.\n   */\n  const report = (send: (sentry: typeof SentryType) => void): void => {\n    getSentry().then((sentry) => {\n      if (!sentry) {\n        return\n      }\n      try {\n        send(sentry)\n      } catch (e) {\n        console.debug('Sentry logging failed', e)\n      }\n    })\n  }\n\n  const taggedContext = (context?: SentryContext): SentryContext => ({\n    ...context,\n    tags: {\n      ...context?.tags,\n      component,\n    },\n  })\n\n  const logError = (error: Error, context?: SentryContext): void => {\n    console.error(consoleLabel, error)\n\n    report((sentry) => sentry.captureException(error, taggedContext(context)))\n  }\n\n  const logMessage = (\n    message: string,\n    level: 'fatal' | 'error' | 'warning' | 'info' | 'debug' = 'info',\n    context?: SentryContext\n  ): void => {\n    switch (level) {\n      case 'fatal':\n      case 'error':\n        console.error(consoleLabel, message)\n        break\n      case 'warning':\n        console.warn(consoleLabel, message)\n        break\n      case 'info':\n        console.info(consoleLabel, message)\n        break\n      case 'debug':\n        console.debug(consoleLabel, message)\n        break\n      default:\n        console.log(consoleLabel, message)\n    }\n\n    report((sentry) => sentry.captureMessage(message, { level, ...taggedContext(context) }))\n  }\n\n  const setTag = (key: string, value: string): void => {\n    report((sentry) => sentry.setTag(key, value))\n  }\n\n  const setUser = (user: { id: string; email?: string; username?: string }): void => {\n    report((sentry) => sentry.setUser(user))\n  }\n\n  return {\n    logError,\n    logMessage,\n    setTag,\n    setUser,\n  }\n}\n"],"mappings":";AASA,IAAIA,IAA0D,MAExDC,WACJ,AACED,MAAgB,OAAO,cAAc,CAAC,MAAM,MAAWE,CAAM,CAAC,CAAC,YAAY,IAAI,GAE1EF;AAGT,SAAgBG,EAAU,IAAY,gBAAgB;CACpD,IAAMC,IAAe,IAAIC,EAAU,IAM7BC,KAAU,MAAoD;EAClE,EAAU,CAAC,CAAC,MAAM,MAAW;GAC3B,IAAKC,GAGL,IAAI;IACF,EAAKA,CAAM;GACb,SAAS,GAAG;IACV,QAAQ,MAAM,yBAAyB,CAAC;GAC1C;EACF,CAAC;CACH,GAEMC,KAAiB,OAA4C;EACjE,GAAGC;EACH,MAAM;GACJ,GAAGA,GAAS;GACZ;EACF;CACF;CA0CA,OAAO;EACL,WAzCgB,GAAc,MAAkC;GAGhE,AAFA,QAAQ,MAAML,GAAcM,CAAK,GAEjCJ,GAAQ,MAAWC,EAAO,iBAAiBG,GAAOF,EAAcC,CAAO,CAAC,CAAC;EAC3E;EAsCE,aAnCA,GACA,IAA0D,QAC1D,MACS;GACT,QAAQE,GAAR;IACE,KAAK;IACL,KAAK;KACH,QAAQ,MAAMP,GAAcQ,CAAO;KACnC;IACF,KAAK;KACH,QAAQ,KAAKR,GAAcQ,CAAO;KAClC;IACF,KAAK;KACH,QAAQ,KAAKR,GAAcQ,CAAO;KAClC;IACF,KAAK;KACH,QAAQ,MAAMR,GAAcQ,CAAO;KACnC;IACF,SACE,QAAQ,IAAIR,GAAcQ,CAAO;GACrC;GAEA,GAAQ,MAAWL,EAAO,eAAeK,GAAS;IAAE;IAAO,GAAGJ,EAAcC,CAAO;GAAE,CAAC,CAAC;EACzF;EAaE,SAXc,GAAa,MAAwB;GACnD,GAAQ,MAAWF,EAAO,OAAOM,GAAKC,CAAK,CAAC;EAC9C;EAUE,UARe,MAAkE;GACjF,GAAQ,MAAWP,EAAO,QAAQQ,CAAI,CAAC;EACzC;CAOA;AACF"}

package/dist/domains/system/composables/useDebugFeatures.d.ts

@@ -1,10 +1,7 @@
 /**
- * Developer tooling switch, kept apart from `useUnreleasedFeatures` on purpose: "unreleased"
- * means a feature still being built, this one means diagnostics. Turning on work in progress
- * should not also arm the error-reporting test buttons, and the other way round.
- *
- * Plain localStorage, so it needs no current user -- which is what makes it usable in an admin
- * where the user may not have an account in any particular system yet.
+ * Developer diagnostics switch, separate from `useUnreleasedFeatures` on purpose. Enabling
+ * work in progress must not arm the error-reporting test buttons, and vice versa.
+ * Uses plain localStorage, so it needs no current user and works where the user has no account in a system yet.
  */
 export declare function useDebugFeatures(): {
     showDebugFeatures: import('@vueuse/shared').RemovableRef<boolean>;

package/dist/domains/system/composables/useDebugFeatures.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDebugFeatures.js","names":["NAME","useDebugFeatures","useStorage"],"sources":["../../../../src/domains/system/composables/useDebugFeatures.ts"],"sourcesContent":["import { useStorage } from '@vueuse/core'\n\nconst NAME = 'debugFeatures'\n\n/**\n * Developer tooling switch, kept apart from `useUnreleasedFeatures` on purpose: \"unreleased\"\n * means a feature still being built, this one means diagnostics. Turning on work in progress\n * should not also arm the error-reporting test buttons, and the other way round.\n *\n * Plain localStorage, so it needs no current user -- which is what makes it usable in an admin\n * where the user may not have an account in any particular system yet.\n */\nexport function useDebugFeatures() {\n  const showDebugFeatures = useStorage(NAME, false, localStorage, { writeDefaults: false })\n\n  return {\n    showDebugFeatures,\n  }\n}\n"],"mappings":";;AAEA,IAAMA,IAAO;AAUb,SAAgBC,IAAmB;CAGjC,OAAO,EACL,mBAHwBC,EAAWF,GAAM,IAAO,cAAc,EAAE,eAAe,GAAM,CAGrF,EACF;AACF"}
+{"version":3,"file":"useDebugFeatures.js","names":["NAME","useDebugFeatures","useStorage"],"sources":["../../../../src/domains/system/composables/useDebugFeatures.ts"],"sourcesContent":["import { useStorage } from '@vueuse/core'\n\nconst NAME = 'debugFeatures'\n\n/**\n * Developer diagnostics switch, separate from `useUnreleasedFeatures` on purpose. Enabling\n * work in progress must not arm the error-reporting test buttons, and vice versa.\n * Uses plain localStorage, so it needs no current user and works where the user has no account in a system yet.\n */\nexport function useDebugFeatures() {\n  const showDebugFeatures = useStorage(NAME, false, localStorage, { writeDefaults: false })\n\n  return {\n    showDebugFeatures,\n  }\n}\n"],"mappings":";;AAEA,IAAMA,IAAO;AAOb,SAAgBC,IAAmB;CAGjC,OAAO,EACL,mBAHwBC,EAAWF,GAAM,IAAO,cAAc,EAAE,eAAe,GAAM,CAGrF,EACF;AACF"}

package/dist/domains/system/store/datatablePageStore.d.ts

@@ -1,9 +1,16 @@
 import { Router } from 'vue-router';
 import { NavigateBackTarget } from '../composables/routeHistory';
+export interface StoredDatatablePage {
+    page: number;
+    rowsPerPage?: number;
+    view?: string;
+}
 export declare const datatablePageKey: (system?: unknown, subject?: unknown) => string;
 export declare function useDatatablePageStore(): {
-    setStoredPage: (key: string, page: number) => void;
+    setStoredPage: (key: string, page: number, rowsPerPage?: number, view?: string | null) => void;
     setPreservePage: () => void;
     preservePageForLanding: (router: Router, closing?: NavigateBackTarget) => void;
     consumeStoredPage: (key: string) => number | null;
+    getStoredRowsPerPage: (key: string) => number | null;
+    getStoredView: (key: string) => string | null;
 };

package/dist/domains/system/store/datatablePageStore.js

@@ -5,8 +5,13 @@ import { NavigationFailureType as n, isNavigationFailure as r } from "vue-router
 var i = t({}), a = t(!1), o = "__unscoped", s, c = (e, t) => typeof e == "string" && typeof t == "string" ? `${e}_${t}` : o;
 function l() {
 	return {
-		setStoredPage: (e, t) => {
-			i.value[e] = t;
+		setStoredPage: (t, n, r, a) => {
+			let o = {
+				...i.value[t],
+				page: n,
+				rowsPerPage: r
+			};
+			a === null ? delete o.view : e(a) || (o.view = a), i.value[t] = o;
 		},
 		setPreservePage: () => {
 			a.value = !0;
@@ -33,7 +38,9 @@ function l() {
 			}), p = e(i) ? t.onError(d) : void 0;
 			s = u;
 		},
-		consumeStoredPage: (e) => a.value ? (a.value = !1, i.value[e] ?? null) : null
+		consumeStoredPage: (e) => a.value ? (a.value = !1, i.value[e]?.page ?? null) : null,
+		getStoredRowsPerPage: (e) => i.value[e]?.rowsPerPage ?? null,
+		getStoredView: (e) => i.value[e]?.view ?? null
 	};
 }
 export { c as datatablePageKey, l as useDatatablePageStore };

package/dist/domains/system/store/datatablePageStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"datatablePageStore.js","names":["storedPages","ref","preservePage","UNSCOPED_KEY","stopPendingLanding","datatablePageKey","system","subject","useDatatablePageStore","key","page","landed","stopped","target","isUndefined","closing","router","stop","stopAfterEach","stopError","drop","failure","isNavigationFailure","NavigationFailureType","landing"],"sources":["../../../../src/domains/system/store/datatablePageStore.ts"],"sourcesContent":["import { ref } from 'vue'\nimport { isNavigationFailure, NavigationFailureType, type Router } from 'vue-router'\nimport type { NavigateBackTarget } from '@/domains/system/composables/routeHistory'\nimport { isUndefined } from '@/shared/utils/common'\n\n// The page is remembered per table. A single global slot used to leak across entities: paging\n// list B to page 5, closing any detail and then opening list A reopened A on page 5, because\n// both the stored page and the preserve flag were shared. The flag stays global on purpose —\n// it means \"the next list I land on should restore its page\" — but the page itself is keyed.\nconst storedPages = ref<Record<string, number>>({})\nconst preservePage = ref<boolean>(false)\n\nconst UNSCOPED_KEY = '__unscoped'\n\n// One for all close buttons: a newer Close takes over the landing of an older one rather than leaving it to clear the\n// flag the newer one set.\nlet stopPendingLanding: (() => void) | undefined\n\nexport const datatablePageKey = (system?: unknown, subject?: unknown): string =>\n  typeof system === 'string' && typeof subject === 'string' ? `${system}_${subject}` : UNSCOPED_KEY\n\nexport function useDatatablePageStore() {\n  const setStoredPage = (key: string, page: number) => {\n    storedPages.value[key] = page\n  }\n\n  const setPreservePage = () => {\n    preservePage.value = true\n  }\n\n  /**\n   * The flag for the page the Close's navigation lands on, and only for it: a list there takes the page as it mounts,\n   * after the landing's `afterEach`. The next navigation drops it, and so does the Close's navigation stopped, failing\n   * or cancelled by another one (its own `router.push` answers that), and a landing elsewhere; a second click takes it\n   * over. The navigation that cancelled the Close is one of its own, a link opening the list afresh, even to the very\n   * same address; only one that lands there before the Close's cancel is reported finds the page. Without `closing` (a\n   * step back in the browser's history, which answers nothing) the first landing takes it, and a failure other than a\n   * cancel, or a navigation error, drops it.\n   *\n   * The push's rejection is handled here: an error vue-router reports goes to the app's `onError` as before, but one\n   * it does not (an app's `afterEach` throwing, as for a `RouterLink`) is no longer an unhandled rejection. During a\n   * step back the store listens to `onError` too, so in an app with no listener of its own vue-router no longer logs\n   * that navigation's error to the console.\n   */\n  const preservePageForLanding = (router: Router, closing?: NavigateBackTarget) => {\n    stopPendingLanding?.()\n    preservePage.value = true\n    let landed = false\n    let stopped = false\n    const target = isUndefined(closing) ? undefined : router.resolve(closing.to).fullPath\n    const stop = () => {\n      stopped = true\n      stopAfterEach()\n      stopError?.()\n    }\n    const drop = () => {\n      stop()\n      if (stopPendingLanding === stop) stopPendingLanding = undefined\n      preservePage.value = false\n    }\n    closing?.navigation.then(\n      (failure) => {\n        if (!stopped && failure) drop()\n      },\n      () => {\n        if (!stopped) drop()\n      }\n    )\n    const stopAfterEach = router.afterEach((landing, _from, failure) => {\n      if (landed) return drop()\n      if (failure) {\n        // Another navigation's failure is not the Close's to answer for; the Close's own comes from its push.\n        if (isUndefined(closing) && !isNavigationFailure(failure, NavigationFailureType.cancelled)) drop()\n        return\n      }\n      if (!isUndefined(target) && (landing.redirectedFrom ?? landing).fullPath !== target) return drop()\n      landed = true\n      // Kept past the landing, the listener would keep vue-router from logging the next navigation's error.\n      stopError?.()\n    })\n    const stopError = isUndefined(closing) ? router.onError(drop) : undefined\n    stopPendingLanding = stop\n  }\n\n  const consumeStoredPage = (key: string): number | null => {\n    if (!preservePage.value) return null\n    preservePage.value = false\n    return storedPages.value[key] ?? null\n  }\n\n  return {\n    setStoredPage,\n    setPreservePage,\n    preservePageForLanding,\n    consumeStoredPage,\n  }\n}\n"],"mappings":";;;;AASA,IAAMA,IAAcC,EAA4B,CAAC,CAAC,GAC5CC,IAAeD,EAAa,EAAK,GAEjCE,IAAe,cAIjBC,GAESC,KAAoB,GAAkB,MACjD,OAAOC,KAAW,YAAY,OAAOC,KAAY,WAAW,GAAGD,EAAO,GAAGC,MAAYJ;AAEvF,SAAgBK,IAAwB;CAqEtC,OAAO;EACL,gBArEqB,GAAa,MAAiB;GACnD,EAAY,MAAMC,KAAOC;EAC3B;EAoEE,uBAlE4B;GAC5B,EAAa,QAAQ;EACvB;EAiEE,yBAjD8B,GAAgB,MAAiC;GAE/E,AADAN,IAAqB,GACrB,EAAa,QAAQ;GACrB,IAAIO,IAAS,IACTC,IAAU,IACRC,IAASC,EAAYC,CAAO,IAAI,KAAA,IAAYC,EAAO,QAAQD,EAAQ,EAAE,CAAC,CAAC,UACvEE,UAAa;IAGjB,AAFA,IAAU,IACVC,EAAc,GACdC,IAAY;GACd,GACMC,UAAa;IAGjB,AAFAH,EAAK,GACDb,MAAuBa,MAAM,IAAqB,KAAA,IACtD,EAAa,QAAQ;GACvB;GACA,GAAS,WAAW,MACjB,MAAY;IACX,AAAI,CAACL,KAAWS,KAASD,EAAK;GAChC,SACM;IACJ,AAAKR,KAASQ,EAAK;GACrB,CACF;GACA,IAAMF,IAAgBF,EAAO,WAAW,GAAS,GAAO,MAAY;IAClE,IAAIL,GAAQ,OAAOS,EAAK;IACxB,IAAIC,GAEF,AAAIP,EAAYC,CAAO,KAAK,CAACO,EAAoBD,GAASE,EAAsB,SAAS,KAAGH,EAAK;SAGnG;SAAI,CAACN,EAAYD,CAAM,MAAMW,EAAQ,kBAAkBA,EAAA,CAAS,aAAaX,GAAQ,OAAOO,EAAK;KAGjG,AAFA,IAAS,IAETD,IAAY;IAHqF;GAInG,CAAC,GACKA,IAAYL,EAAYC,CAAO,IAAIC,EAAO,QAAQI,CAAI,IAAI,KAAA;GAChE,IAAqBH;EACvB;EAYE,oBAVyB,MACpBf,EAAa,SAClB,EAAa,QAAQ,IACdF,EAAY,MAAMS,MAAQ,QAFD;CAUlC;AACF"}
+{"version":3,"file":"datatablePageStore.js","names":["storedPages","ref","preservePage","UNSCOPED_KEY","stopPendingLanding","datatablePageKey","system","subject","useDatatablePageStore","stored","key","view","isUndefined","landed","stopped","target","closing","router","stop","stopAfterEach","stopError","drop","failure","isNavigationFailure","NavigationFailureType","landing"],"sources":["../../../../src/domains/system/store/datatablePageStore.ts"],"sourcesContent":["import { ref } from 'vue'\nimport { isNavigationFailure, NavigationFailureType, type Router } from 'vue-router'\nimport type { NavigateBackTarget } from '@/domains/system/composables/routeHistory'\nimport { isUndefined } from '@/shared/utils/common'\n\n// The page is stored per table. A single global slot leaked across lists, so list A reopened on the page set in list B.\n// The preserve flag stays global on purpose: it means the next list landed on restores its page.\n// The rows per page are kept with the page: page 3 at another page size shows other rows.\n// So is the view, the serialized filter and sort the page was shown in (see `useFilterHelpers`).\nexport interface StoredDatatablePage {\n  page: number\n  rowsPerPage?: number\n  view?: string\n}\nconst storedPages = ref<Record<string, StoredDatatablePage>>({})\nconst preservePage = ref<boolean>(false)\n\nconst UNSCOPED_KEY = '__unscoped'\n\n// Shared by all Close buttons. A newer Close takes over an older one's\n// landing, so the older one cannot clear the flag the newer one set.\nlet stopPendingLanding: (() => void) | undefined\n\nexport const datatablePageKey = (system?: unknown, subject?: unknown): string =>\n  typeof system === 'string' && typeof subject === 'string' ? `${system}_${subject}` : UNSCOPED_KEY\n\nexport function useDatatablePageStore() {\n  // `view` undefined keeps the stored one: the pager stores a page change, which stays in the view\n  // the filter helpers stored on load, submit or reset. `null` forgets it.\n  const setStoredPage = (key: string, page: number, rowsPerPage?: number, view?: string | null) => {\n    const stored: StoredDatatablePage = { ...storedPages.value[key], page, rowsPerPage }\n    if (view === null) delete stored.view\n    else if (!isUndefined(view)) stored.view = view\n    storedPages.value[key] = stored\n  }\n\n  const setPreservePage = () => {\n    preservePage.value = true\n  }\n\n  /**\n   * Sets the flag only for the page the Close's navigation lands on.\n   * A list there reads it on mount, after the landing's `afterEach`.\n   * The flag is dropped by the next navigation, by the Close's navigation failing\n   * or being cancelled, and by a landing elsewhere. A second click takes it over.\n   * Without `closing` (browser step back, which returns nothing) the first\n   * landing takes it, and a non-cancel failure or navigation error drops it.\n   * The push rejection is handled here, so errors vue-router does not report (e.g. an app\n   * `afterEach` throwing) are not unhandled. During a step back the store also listens to `onError`,\n   * so vue-router does not log that error to the console in apps without their own listener.\n   */\n  const preservePageForLanding = (router: Router, closing?: NavigateBackTarget) => {\n    stopPendingLanding?.()\n    preservePage.value = true\n    let landed = false\n    let stopped = false\n    const target = isUndefined(closing) ? undefined : router.resolve(closing.to).fullPath\n    const stop = () => {\n      stopped = true\n      stopAfterEach()\n      stopError?.()\n    }\n    const drop = () => {\n      stop()\n      if (stopPendingLanding === stop) stopPendingLanding = undefined\n      preservePage.value = false\n    }\n    closing?.navigation.then(\n      (failure) => {\n        if (!stopped && failure) drop()\n      },\n      () => {\n        if (!stopped) drop()\n      }\n    )\n    const stopAfterEach = router.afterEach((landing, _from, failure) => {\n      if (landed) return drop()\n      if (failure) {\n        // Another navigation's failure is not the Close's to answer for; the Close's own comes from its push.\n        if (isUndefined(closing) && !isNavigationFailure(failure, NavigationFailureType.cancelled)) drop()\n        return\n      }\n      if (!isUndefined(target) && (landing.redirectedFrom ?? landing).fullPath !== target) return drop()\n      landed = true\n      // Kept past the landing, the listener would keep vue-router from logging the next navigation's error.\n      stopError?.()\n    })\n    const stopError = isUndefined(closing) ? router.onError(drop) : undefined\n    stopPendingLanding = stop\n  }\n\n  const consumeStoredPage = (key: string): number | null => {\n    if (!preservePage.value) return null\n    preservePage.value = false\n    return storedPages.value[key]?.page ?? null\n  }\n\n  // Read with a page `consumeStoredPage` returned, so the list shows the same rows.\n  const getStoredRowsPerPage = (key: string): number | null => storedPages.value[key]?.rowsPerPage ?? null\n\n  const getStoredView = (key: string): string | null => storedPages.value[key]?.view ?? null\n\n  return {\n    setStoredPage,\n    setPreservePage,\n    preservePageForLanding,\n    consumeStoredPage,\n    getStoredRowsPerPage,\n    getStoredView,\n  }\n}\n"],"mappings":";;;;AAcA,IAAMA,IAAcC,EAAyC,CAAC,CAAC,GACzDC,IAAeD,EAAa,EAAK,GAEjCE,IAAe,cAIjBC,GAESC,KAAoB,GAAkB,MACjD,OAAOC,KAAW,YAAY,OAAOC,KAAY,WAAW,GAAGD,EAAO,GAAGC,MAAYJ;AAEvF,SAAgBK,IAAwB;CA4EtC,OAAO;EACL,gBA1EqB,GAAa,GAAc,GAAsB,MAAyB;GAC/F,IAAMC,IAA8B;IAAE,GAAGT,EAAY,MAAMU;IAAM;IAAM;GAAY;GAGnF,AAFIC,MAAS,OAAM,OAAOF,EAAO,OACvBG,EAAYD,CAAI,MAAG,EAAO,OAAOA,IAC3C,EAAY,MAAMD,KAAOD;EAC3B;EAsEE,uBApE4B;GAC5B,EAAa,QAAQ;EACvB;EAmEE,yBAtD8B,GAAgB,MAAiC;GAE/E,AADAL,IAAqB,GACrB,EAAa,QAAQ;GACrB,IAAIS,IAAS,IACTC,IAAU,IACRC,IAASH,EAAYI,CAAO,IAAI,KAAA,IAAYC,EAAO,QAAQD,EAAQ,EAAE,CAAC,CAAC,UACvEE,UAAa;IAGjB,AAFA,IAAU,IACVC,EAAc,GACdC,IAAY;GACd,GACMC,UAAa;IAGjB,AAFAH,EAAK,GACDd,MAAuBc,MAAM,IAAqB,KAAA,IACtD,EAAa,QAAQ;GACvB;GACA,GAAS,WAAW,MACjB,MAAY;IACX,AAAI,CAACJ,KAAWQ,KAASD,EAAK;GAChC,SACM;IACJ,AAAKP,KAASO,EAAK;GACrB,CACF;GACA,IAAMF,IAAgBF,EAAO,WAAW,GAAS,GAAO,MAAY;IAClE,IAAIJ,GAAQ,OAAOQ,EAAK;IACxB,IAAIC,GAEF,AAAIV,EAAYI,CAAO,KAAK,CAACO,EAAoBD,GAASE,EAAsB,SAAS,KAAGH,EAAK;SAGnG;SAAI,CAACT,EAAYG,CAAM,MAAMU,EAAQ,kBAAkBA,EAAA,CAAS,aAAaV,GAAQ,OAAOM,EAAK;KAGjG,AAFA,IAAS,IAETD,IAAY;IAHqF;GAInG,CAAC,GACKA,IAAYR,EAAYI,CAAO,IAAIC,EAAO,QAAQI,CAAI,IAAI,KAAA;GAChE,IAAqBH;EACvB;EAiBE,oBAfyB,MACpBhB,EAAa,SAClB,EAAa,QAAQ,IACdF,EAAY,MAAMU,EAAI,EAAE,QAAQ,QAFP;EAehC,uBAT4B,MAA+BV,EAAY,MAAMU,EAAI,EAAE,eAAe;EAUlG,gBARqB,MAA+BV,EAAY,MAAMU,EAAI,EAAE,QAAQ;CAStF;AACF"}

package/dist/domains/system/systemBar/components/ASystemBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"ASystemBar.js","names":["_sfc_main","ASystemBar_vue_vue_type_script_setup_true_lang_default","ASystemBar_default"],"sources":["../../../../../src/domains/system/systemBar/components/ASystemBar.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { computed, onBeforeUnmount, ref, watch } from 'vue'\nimport { useIntervalFn } from '@vueuse/core'\nimport ASystemBarNewVersion from '@/domains/system/systemBar/components/ASystemBarNewVersion.vue'\nimport { isUndefined } from '@/shared/utils/common'\nimport { AnzuNewVersionFetchError, isAnzuNewVersionFetchError } from '@/shared/error/AnzuNewVersionFetchError'\nimport { useUserActivity } from '@/domains/system/composables/useUserActivity'\nimport { useSystemBar } from '@/domains/system/systemBar/composables/systemBar'\n\nconst props = withDefaults(\n  defineProps<{\n    currentVersion: string\n    checkInterval?: number\n    jsonRelativePath?: string\n    minInactiveTime?: number\n  }>(),\n  {\n    checkInterval: 60000,\n    jsonRelativePath: 'config.json',\n    minInactiveTime: 5000,\n  }\n)\n\nconst showSystemBar = ref<boolean>(false)\nconst abortController = ref<AbortController | null>(null)\nconst lastInactiveTime = ref<number>(0)\n\nconst CONSECUTIVE_FAILURE_ALERT_THRESHOLD = 5\nlet consecutiveFailures = 0\nlet alertedForCurrentOutage = false\n\nconst { newVersion } = useSystemBar()\n\nconst checkNewVersion = async (): Promise<void> => {\n  if (abortController.value) {\n    abortController.value.abort()\n  }\n\n  abortController.value = new AbortController()\n\n  const isAbortError = (error: unknown): error is Error => {\n    return error instanceof Error && error.name === 'AbortError'\n  }\n\n  try {\n    const res = await fetch(`/${props.jsonRelativePath}?random=${Date.now()}`, {\n      signal: abortController.value.signal,\n    })\n    if (res.ok) {\n      const contentType = res.headers.get('content-type')\n      if (!contentType || !contentType.includes('application/json')) {\n        throw new AnzuNewVersionFetchError('Unable to load env config. Incorrect content type.')\n      }\n      const json = await res.json()\n      if (Object.keys(json).length < 1) {\n        throw new AnzuNewVersionFetchError('Unable to load env config. Incorrect response body.')\n      }\n      showSystemBar.value = !isUndefined(json.appVersion) && json.appVersion !== props.currentVersion\n      newVersion.value = showSystemBar.value\n      consecutiveFailures = 0\n      alertedForCurrentOutage = false\n\n      return\n    }\n    throw new AnzuNewVersionFetchError('Unable to load env config. Incorrect response code.')\n  } catch (error) {\n    if (isAbortError(error)) {\n      return\n    }\n    if (isAnzuNewVersionFetchError(error)) {\n      throw error\n    }\n    if (error instanceof SyntaxError) {\n      throw new AnzuNewVersionFetchError('Unable to load env config. Syntax error.', error)\n    }\n    if (error instanceof Error) {\n      throw new AnzuNewVersionFetchError('Unable to load env config. ' + error.message, error)\n    }\n    throw new AnzuNewVersionFetchError('Unable to load env config. Unknown error.', error as any)\n  }\n}\n\nconst systemBarComponent = computed(() => {\n  return ASystemBarNewVersion\n})\n\n// eslint-disable-next-line vue/no-setup-props-reactivity-loss\nconst { pause, resume } = useIntervalFn(() => {\n  checkNewVersion().catch((error) => {\n    if (isAnzuNewVersionFetchError(error)) {\n      consecutiveFailures++\n      if (consecutiveFailures >= CONSECUTIVE_FAILURE_ALERT_THRESHOLD && !alertedForCurrentOutage) {\n        alertedForCurrentOutage = true\n        // One signal per outage — ops can alert on this; resets on the next successful poll.\n        console.error(`[ASystemBar] Version check failed ${consecutiveFailures} consecutive times:`, error)\n      }\n      return\n    }\n    console.warn(error)\n  })\n}, props.checkInterval)\n\nconst { isWindowActive } = useUserActivity()\n\n// Only one retry is ever pending. Untracked, an unmount left it scheduled to start a fetch that\n// the unmount hook could no longer abort; so is the one a new check replaces, as a return to the window starts one\n// while a retry of the previous is still pending.\nlet retryTimer: ReturnType<typeof setTimeout> | undefined = undefined\n\nconst checkNewVersionWithRetry = (attempt = 1, maxAttempts = 3) => {\n  const delay = Math.min(1000 * attempt, 3000) // 1000ms, 2000ms, 3000ms\n\n  clearTimeout(retryTimer)\n  retryTimer = setTimeout(async () => {\n    try {\n      await checkNewVersion()\n    } catch (error) {\n      if (\n        error instanceof AnzuNewVersionFetchError &&\n        (error.message.includes('Failed to fetch') || error.message.includes('NetworkError')) &&\n        attempt < maxAttempts\n      ) {\n        checkNewVersionWithRetry(attempt + 1, maxAttempts)\n      } else {\n        console.error('Version check failed:', error)\n      }\n    }\n  }, delay)\n}\n\nwatch(\n  isWindowActive,\n  (newValue: boolean) => {\n    const now: number = Date.now()\n\n    if (newValue) {\n      const inactiveDuration: number = now - lastInactiveTime.value\n      resume()\n      if (inactiveDuration > props.minInactiveTime) {\n        checkNewVersionWithRetry()\n      }\n    } else {\n      lastInactiveTime.value = now\n      pause()\n    }\n  },\n  { immediate: true }\n)\n\nonBeforeUnmount(() => {\n  clearTimeout(retryTimer)\n  if (abortController.value) {\n    abortController.value.abort()\n  }\n})\n</script>\n\n<template>\n  <VAppBar\n    v-if=\"showSystemBar\"\n    height=\"48\"\n    color=\"orange-accent-3\"\n    elevation=\"0\"\n    :order=\"-1\"\n  >\n    <div class=\"text-center w-100 text-body-small pb-1\">\n      <component :is=\"systemBarComponent\" />\n    </div>\n  </VAppBar>\n</template>\n"],"mappings":""}
+{"version":3,"file":"ASystemBar.js","names":["_sfc_main","ASystemBar_vue_vue_type_script_setup_true_lang_default","ASystemBar_default"],"sources":["../../../../../src/domains/system/systemBar/components/ASystemBar.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { computed, onBeforeUnmount, ref, watch } from 'vue'\nimport { useIntervalFn } from '@vueuse/core'\nimport ASystemBarNewVersion from '@/domains/system/systemBar/components/ASystemBarNewVersion.vue'\nimport { isUndefined } from '@/shared/utils/common'\nimport { AnzuNewVersionFetchError, isAnzuNewVersionFetchError } from '@/shared/error/AnzuNewVersionFetchError'\nimport { useUserActivity } from '@/domains/system/composables/useUserActivity'\nimport { useSystemBar } from '@/domains/system/systemBar/composables/systemBar'\n\nconst props = withDefaults(\n  defineProps<{\n    currentVersion: string\n    checkInterval?: number\n    jsonRelativePath?: string\n    minInactiveTime?: number\n  }>(),\n  {\n    checkInterval: 60000,\n    jsonRelativePath: 'config.json',\n    minInactiveTime: 5000,\n  }\n)\n\nconst showSystemBar = ref<boolean>(false)\nconst abortController = ref<AbortController | null>(null)\nconst lastInactiveTime = ref<number>(0)\n\nconst CONSECUTIVE_FAILURE_ALERT_THRESHOLD = 5\nlet consecutiveFailures = 0\nlet alertedForCurrentOutage = false\n\nconst { newVersion } = useSystemBar()\n\nconst checkNewVersion = async (): Promise<void> => {\n  if (abortController.value) {\n    abortController.value.abort()\n  }\n\n  abortController.value = new AbortController()\n\n  const isAbortError = (error: unknown): error is Error => {\n    return error instanceof Error && error.name === 'AbortError'\n  }\n\n  try {\n    const res = await fetch(`/${props.jsonRelativePath}?random=${Date.now()}`, {\n      signal: abortController.value.signal,\n    })\n    if (res.ok) {\n      const contentType = res.headers.get('content-type')\n      if (!contentType || !contentType.includes('application/json')) {\n        throw new AnzuNewVersionFetchError('Unable to load env config. Incorrect content type.')\n      }\n      const json = await res.json()\n      if (Object.keys(json).length < 1) {\n        throw new AnzuNewVersionFetchError('Unable to load env config. Incorrect response body.')\n      }\n      showSystemBar.value = !isUndefined(json.appVersion) && json.appVersion !== props.currentVersion\n      newVersion.value = showSystemBar.value\n      consecutiveFailures = 0\n      alertedForCurrentOutage = false\n\n      return\n    }\n    throw new AnzuNewVersionFetchError('Unable to load env config. Incorrect response code.')\n  } catch (error) {\n    if (isAbortError(error)) {\n      return\n    }\n    if (isAnzuNewVersionFetchError(error)) {\n      throw error\n    }\n    if (error instanceof SyntaxError) {\n      throw new AnzuNewVersionFetchError('Unable to load env config. Syntax error.', error)\n    }\n    if (error instanceof Error) {\n      throw new AnzuNewVersionFetchError('Unable to load env config. ' + error.message, error)\n    }\n    throw new AnzuNewVersionFetchError('Unable to load env config. Unknown error.', error as any)\n  }\n}\n\nconst systemBarComponent = computed(() => {\n  return ASystemBarNewVersion\n})\n\n// eslint-disable-next-line vue/no-setup-props-reactivity-loss\nconst { pause, resume } = useIntervalFn(() => {\n  checkNewVersion().catch((error) => {\n    if (isAnzuNewVersionFetchError(error)) {\n      consecutiveFailures++\n      if (consecutiveFailures >= CONSECUTIVE_FAILURE_ALERT_THRESHOLD && !alertedForCurrentOutage) {\n        alertedForCurrentOutage = true\n        // One signal per outage — ops can alert on this; resets on the next successful poll.\n        console.error(`[ASystemBar] Version check failed ${consecutiveFailures} consecutive times:`, error)\n      }\n      return\n    }\n    console.warn(error)\n  })\n}, props.checkInterval)\n\nconst { isWindowActive } = useUserActivity()\n\n// Only one retry is pending at a time. Untracked, a retry left\n// scheduled after unmount starts a fetch that cannot be aborted.\n// A new check also replaces a pending retry, since returning to\n// the window starts one while a previous retry may be pending.\nlet retryTimer: ReturnType<typeof setTimeout> | undefined = undefined\n\nconst checkNewVersionWithRetry = (attempt = 1, maxAttempts = 3) => {\n  const delay = Math.min(1000 * attempt, 3000) // 1000ms, 2000ms, 3000ms\n\n  clearTimeout(retryTimer)\n  retryTimer = setTimeout(async () => {\n    try {\n      await checkNewVersion()\n    } catch (error) {\n      if (\n        error instanceof AnzuNewVersionFetchError &&\n        (error.message.includes('Failed to fetch') || error.message.includes('NetworkError')) &&\n        attempt < maxAttempts\n      ) {\n        checkNewVersionWithRetry(attempt + 1, maxAttempts)\n      } else {\n        console.error('Version check failed:', error)\n      }\n    }\n  }, delay)\n}\n\nwatch(\n  isWindowActive,\n  (newValue: boolean) => {\n    const now: number = Date.now()\n\n    if (newValue) {\n      const inactiveDuration: number = now - lastInactiveTime.value\n      resume()\n      if (inactiveDuration > props.minInactiveTime) {\n        checkNewVersionWithRetry()\n      }\n    } else {\n      lastInactiveTime.value = now\n      pause()\n    }\n  },\n  { immediate: true }\n)\n\nonBeforeUnmount(() => {\n  clearTimeout(retryTimer)\n  if (abortController.value) {\n    abortController.value.abort()\n  }\n})\n</script>\n\n<template>\n  <VAppBar\n    v-if=\"showSystemBar\"\n    height=\"48\"\n    color=\"orange-accent-3\"\n    elevation=\"0\"\n    :order=\"-1\"\n  >\n    <div class=\"text-center w-100 text-body-small pb-1\">\n      <component :is=\"systemBarComponent\" />\n    </div>\n  </VAppBar>\n</template>\n"],"mappings":""}