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

package/dist/esm/core/resources/bulk-failure-grouping.frontend.utils.js

@@ -0,0 +1,23 @@
+/** The group key for a refusal that carried no reference at all — an error the engine could not name. */
+export const UNNAMED_BULK_FAILURE_REASON_KEY = 'unnamedRefusal';
+export function groupBulkFailuresByReason(failures, resolveReason) {
+    const groups = new Map();
+    for (const failure of failures) {
+        const key = failure.customMessageReference ?? UNNAMED_BULK_FAILURE_REASON_KEY;
+        const existing = groups.get(key);
+        if (existing) {
+            existing.resourceIds.push(failure.resourceId);
+            continue;
+        }
+        groups.set(key, {
+            key,
+            reason: (failure.customMessageReference ? resolveReason(failure.customMessageReference) : undefined) ?? key,
+            resourceIds: [failure.resourceId],
+        });
+    }
+    // Most-refused first: the reason accounting for most rows is the one worth reading first, and a
+    // panel that listed them in arrival order would bury it behind whichever row happened to fail
+    // earliest.
+    return [...groups.values()].sort((left, right) => right.resourceIds.length - left.resourceIds.length);
+}
+//# sourceMappingURL=bulk-failure-grouping.frontend.utils.js.map

package/dist/esm/core/resources/bulk-failure-grouping.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-failure-grouping.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/bulk-failure-grouping.frontend.utils.ts"],"names":[],"mappings":"AAwBA,yGAAyG;AACzG,MAAM,CAAC,MAAM,+BAA+B,GAAG,gBAAyB,CAAC;AAEzE,MAAM,UAAU,yBAAyB,CACvC,QAAmC,EACnC,aAAwD;IAExD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEzD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,sBAAsB,IAAI,+BAA+B,CAAC;QAC9E,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC9C,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;YACd,GAAG;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,GAAG;YAC3G,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAED,gGAAgG;IAChG,8FAA8F;IAC9F,YAAY;IACZ,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACxG,CAAC","sourcesContent":["/**\n * Group a bulk run's refusals by REASON (#1461).\n *\n * A count tells a person something went wrong; it does not tell them what to do. Twelve rows\n * refused for one reason are one thing to fix, while twelve ids are twelve lookups — so the reason\n * is the unit the panel is built from, and the ids sit under it as the secondary detail they are.\n *\n * Reasons arrive as the refusal's REFERENCE, because a reference is what a locale turns into words;\n * the resolver is passed in so this function stays free of i18n and can be tested for what it\n * actually decides. A reference with no authored words falls back to the reference itself, which is\n * a missing label looking missing rather than an invented sentence\n * (`.claude/rules/display-text-comes-from-i18n.md`).\n */\nimport type { BulkJobFailure } from './useBulkJobProgress';\n\nexport interface BulkFailureReasonGroup {\n  /** Stable key for the group — the refusal reference, or a fixed key when the row carried none. */\n  key: string;\n  /** What to show as the reason: resolved words, else the reference, else the unnamed-refusal key. */\n  reason: string;\n  /** The rows refused for this reason, in the order the run met them. */\n  resourceIds: string[];\n}\n\n/** The group key for a refusal that carried no reference at all — an error the engine could not name. */\nexport const UNNAMED_BULK_FAILURE_REASON_KEY = 'unnamedRefusal' as const;\n\nexport function groupBulkFailuresByReason(\n  failures: readonly BulkJobFailure[],\n  resolveReason: (reference: string) => string | undefined,\n): BulkFailureReasonGroup[] {\n  const groups = new Map<string, BulkFailureReasonGroup>();\n\n  for (const failure of failures) {\n    const key = failure.customMessageReference ?? UNNAMED_BULK_FAILURE_REASON_KEY;\n    const existing = groups.get(key);\n    if (existing) {\n      existing.resourceIds.push(failure.resourceId);\n      continue;\n    }\n    groups.set(key, {\n      key,\n      reason: (failure.customMessageReference ? resolveReason(failure.customMessageReference) : undefined) ?? key,\n      resourceIds: [failure.resourceId],\n    });\n  }\n\n  // Most-refused first: the reason accounting for most rows is the one worth reading first, and a\n  // panel that listed them in arrival order would bury it behind whichever row happened to fail\n  // earliest.\n  return [...groups.values()].sort((left, right) => right.resourceIds.length - left.resourceIds.length);\n}\n"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"collection-export-url.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/resources/collection-export-url.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The API URL of a listing's export companion, and the download that follows it.\n *\n * ## Why the export cannot go through the ordinary action executor\n *\n * Every other resource action ends in `doOperation()`, which parses a JSON result and hands it to\n * the refresh/notification pipeline. An export answers BYTES with a `Content-Disposition`, so there\n * is no result to parse and nothing to refresh — the browser has to be handed a file. That is the\n * same shape the generated-file REGENERATE action already needed special handling for, one step\n * further: regenerate returns JSON and the bytes are fetched later; an export IS the bytes.\n */\nimport {\n  buildCollectionExportFilename,\n  COLLECTION_EXPORT_FORMAT_QUERY_PARAM,\n  COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM,\n  MAIN_API_BASE_PATH,\n  ResourcesConfigOperationsUrlsBuilderUtils,\n  type ResourceCollectionExportFormat,\n  type ResourceCollectionExportRowScope,\n  type ResourceType,\n} from '@wildo-ai/saas-models';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type {\n  FrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\nexport interface BuildCollectionExportUrlParams {\n  registry: FrontendResourcesRegistry;\n  resourceConfig: FrontendResourceConfiguration;\n  /** The DERIVED export operation, not the listing it exports. */\n  exportOperation: FrontendResourceConfiguration_Operation;\n  resourceType: ResourceType;\n  /**\n   * `string | number` rather than `string`: the transport normalizer emits numeric ids as numbers,\n   * and narrowing here would push a cast onto every caller for a value that is stringified into a\n   * URL segment anyway.\n   */\n  contextResourceIdentifiers: Record<string, string>;\n  /**\n   * `string | number`: the parameter map resolved for URL substitution can carry numeric ids, and\n   * narrowing here would push a cast onto every caller for a value that is stringified into a URL\n   * segment anyway.\n   */\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  apiBaseUrl: string;\n  format: ResourceCollectionExportFormat;\n  rowScope: ResourceCollectionExportRowScope;\n  /**\n   * The query the LISTING is currently showing — filters, sort, page. Forwarded verbatim so\n   * \"export what I am looking at\" needs no second grammar, and so a `VISIBLE_PAGE` export returns\n   * the page on screen rather than a different one.\n   */\n  listingQuery?: Record<string, string | number | undefined>;\n}\n\n/**\n * `null` when the route cannot be fully resolved from the current context — the caller then hides\n * the action rather than offering a download that would 404. Deliberately the same posture the file\n * serve URL takes: an unresolved placeholder is a missing parent id, not an error to raise.\n */\nexport function buildCollectionExportUrl(params: BuildCollectionExportUrlParams): string | null {\n  const {\n    registry, resourceConfig, exportOperation, resourceType,\n    contextResourceIdentifiers, contextualParameters, parentResourcesRequirements,\n    apiBaseUrl, format, rowScope, listingQuery,\n  } = params;\n\n  if (!resourceConfig?.resourceFieldIdentifier || !exportOperation) return null;\n\n  try {\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceConfig,\n      exportOperation,\n      registry.allResourceFieldIdentifiers,\n    );\n    if (routePaths.length === 0) return null;\n\n    const routePath = frontendResourceUtils.selectMatchingRoutePath(\n      routePaths,\n      contextResourceIdentifiers,\n      resourceConfig.resourceIdentifier,\n      resourceConfig.resourceFieldIdentifier,\n      parentResourcesRequirements,\n      registry.allResourceFieldIdentifiers,\n    );\n\n    // A collection-level route: the parent chain only, and no id of this resource's own.\n    const resolved = NavigationUtils.resolveUrlPath(routePath.url, contextualParameters);\n    if (NavigationUtils.hasUnresolvedPlaceholders(resolved)) return null;\n\n    const query = new URLSearchParams();\n    query.set(COLLECTION_EXPORT_FORMAT_QUERY_PARAM, format);\n    query.set(COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM, rowScope);\n    for (const [key, value] of Object.entries(listingQuery ?? {})) {\n      if (value === undefined || value === '') continue;\n      // Never forwarded: the caller's own selectors are set above, and a listing query carrying\n      // them would otherwise decide the format twice.\n      if (key === COLLECTION_EXPORT_FORMAT_QUERY_PARAM || key === COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM) continue;\n      query.set(key, String(value));\n    }\n\n    // Frontend route paths omit `/api/v1`; re-add it to match the registered backend route.\n    return `${apiBaseUrl}${MAIN_API_BASE_PATH}${resolved}?${query.toString()}`;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Fetch the export through the AUTHENTICATED client and hand the bytes to the browser.\n *\n * A plain `<a href>` or `window.open` would issue an UNAUTHENTICATED request — the access token\n * lives in the http client, not in a cookie the browser would attach — so the download must go\n * through `getBlob` and be released as an object URL. The object URL is revoked immediately after\n * the click: leaving it alive pins the whole file in memory for the life of the document, and an\n * export is exactly the payload where that matters.\n */\nexport async function downloadCollectionExport(params: {\n  url: string;\n  resourceType: ResourceType;\n  format: ResourceCollectionExportFormat;\n  getBlob: (url: string) => Promise<Blob>;\n}): Promise<void> {\n  const blob = await params.getBlob(params.url);\n  const objectUrl = URL.createObjectURL(blob);\n  try {\n    const link = document.createElement('a');\n    link.href = objectUrl;\n    // The server already names the file in `Content-Disposition`, but a blob download does not see\n    // that header — the name has to be supplied here. Same builder as the server's, so the two\n    // agree instead of drifting.\n    link.download = buildCollectionExportFilename(String(params.resourceType), params.format, new Date());\n    document.body.appendChild(link);\n    link.click();\n    link.remove();\n  } finally {\n    URL.revokeObjectURL(objectUrl);\n  }\n}\n"]}
+{"version":3,"file":"collection-export-url.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/collection-export-url.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The API URL of a listing's export companion, and the download that follows it.\n *\n * ## Why the export cannot go through the ordinary action executor\n *\n * Every other resource action ends in `doOperation()`, which parses a JSON result and hands it to\n * the refresh/notification pipeline. An export answers BYTES with a `Content-Disposition`, so there\n * is no result to parse and nothing to refresh — the browser has to be handed a file. That is the\n * same shape the generated-file REGENERATE action already needed special handling for, one step\n * further: regenerate returns JSON and the bytes are fetched later; an export IS the bytes.\n */\nimport {\n  buildCollectionExportFilename,\n  COLLECTION_EXPORT_FORMAT_QUERY_PARAM,\n  COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM,\n  MAIN_API_BASE_PATH,\n  ResourcesConfigOperationsUrlsBuilderUtils,\n  type ResourceCollectionExportFormat,\n  type ResourceCollectionExportRowScope,\n  type ResourceType,\n} from '@wildo-ai/saas-models';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type {\n  FrontendResourceConfiguration,\n  FrontendResourceConfiguration_Operation,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\nexport interface BuildCollectionExportUrlParams {\n  registry: FrontendResourcesRegistry;\n  resourceConfig: FrontendResourceConfiguration;\n  /** The DERIVED export operation, not the listing it exports. */\n  exportOperation: FrontendResourceConfiguration_Operation;\n  resourceType: ResourceType;\n  /**\n   * `string | number` rather than `string`: the transport normalizer emits numeric ids as numbers,\n   * and narrowing here would push a cast onto every caller for a value that is stringified into a\n   * URL segment anyway.\n   */\n  contextResourceIdentifiers: Record<string, string>;\n  /**\n   * `string | number`: the parameter map resolved for URL substitution can carry numeric ids, and\n   * narrowing here would push a cast onto every caller for a value that is stringified into a URL\n   * segment anyway.\n   */\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  apiBaseUrl: string;\n  format: ResourceCollectionExportFormat;\n  rowScope: ResourceCollectionExportRowScope;\n  /**\n   * The query the LISTING is currently showing — filters, sort, page. Forwarded verbatim so\n   * \"export what I am looking at\" needs no second grammar, and so a `VISIBLE_PAGE` export returns\n   * the page on screen rather than a different one.\n   */\n  listingQuery?: Record<string, string | number | undefined>;\n}\n\n/**\n * `null` when the route cannot be fully resolved from the current context — the caller then hides\n * the action rather than offering a download that would 404. Deliberately the same posture the file\n * serve URL takes: an unresolved placeholder is a missing parent id, not an error to raise.\n */\nexport function buildCollectionExportUrl(params: BuildCollectionExportUrlParams): string | null {\n  const {\n    registry, resourceConfig, exportOperation, resourceType,\n    contextResourceIdentifiers, contextualParameters, parentResourcesRequirements,\n    apiBaseUrl, format, rowScope, listingQuery,\n  } = params;\n\n  if (!resourceConfig?.resourceFieldIdentifier || !exportOperation) return null;\n\n  try {\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceConfig,\n      exportOperation,\n      registry.allResourceFieldIdentifiers,\n    );\n    if (routePaths.length === 0) return null;\n\n    const routePath = frontendResourceUtils.selectMatchingRoutePath(\n      routePaths,\n      contextResourceIdentifiers,\n      resourceConfig.resourceIdentifier,\n      resourceConfig.resourceFieldIdentifier,\n      parentResourcesRequirements,\n      registry.allResourceFieldIdentifiers,\n    );\n\n    // A collection-level route: the parent chain only, and no id of this resource's own.\n    const resolved = NavigationUtils.resolveUrlPath(routePath.url, contextualParameters);\n    if (NavigationUtils.hasUnresolvedPlaceholders(resolved)) return null;\n\n    const query = new URLSearchParams();\n    query.set(COLLECTION_EXPORT_FORMAT_QUERY_PARAM, format);\n    query.set(COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM, rowScope);\n    for (const [key, value] of Object.entries(listingQuery ?? {})) {\n      if (value === undefined || value === '') continue;\n      // Never forwarded: the caller's own selectors are set above, and a listing query carrying\n      // them would otherwise decide the format twice.\n      if (key === COLLECTION_EXPORT_FORMAT_QUERY_PARAM || key === COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM) continue;\n      query.set(key, String(value));\n    }\n\n    // Frontend route paths omit `/api/v1`; re-add it to match the registered backend route.\n    return `${apiBaseUrl}${MAIN_API_BASE_PATH}${resolved}?${query.toString()}`;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Fetch the export through the AUTHENTICATED client and hand the bytes to the browser.\n *\n * A plain `<a href>` or `window.open` would issue an UNAUTHENTICATED request — the access token\n * lives in the http client, not in a cookie the browser would attach — so the download must go\n * through `getBlob` and be released as an object URL. The object URL is revoked immediately after\n * the click: leaving it alive pins the whole file in memory for the life of the document, and an\n * export is exactly the payload where that matters.\n */\nexport async function downloadCollectionExport(params: {\n  url: string;\n  resourceType: ResourceType;\n  format: ResourceCollectionExportFormat;\n  getBlob: (url: string) => Promise<Blob>;\n}): Promise<void> {\n  const blob = await params.getBlob(params.url);\n  const objectUrl = URL.createObjectURL(blob);\n  try {\n    const link = document.createElement('a');\n    link.href = objectUrl;\n    // The server already names the file in `Content-Disposition`, but a blob download does not see\n    // that header — the name has to be supplied here. Same builder as the server's, so the two\n    // agree instead of drifting.\n    link.download = buildCollectionExportFilename(String(params.resourceType), params.format, new Date());\n    document.body.appendChild(link);\n    link.click();\n    link.remove();\n  } finally {\n    URL.revokeObjectURL(objectUrl);\n  }\n}\n"]}

package/dist/esm/core/resources/collection-filter-presets.frontend.utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Applying and reading back a collection's PRESET FILTERS.
+ *
+ * A preset has no state of its own — it is a write into the collection's existing filter values,
+ * and its ON/OFF is derived by reading them back. Everything here is therefore a pure function of
+ * `(preset, currentFilters, now)`, which is what lets the pills stay in step with the filters
+ * panel, the chips and the quick-filter tabs without any of the four knowing about the others.
+ *
+ * `now` is a parameter rather than a `new Date()` inside these functions, for two reasons that
+ * both matter: a single click must resolve every field of a preset against ONE instant (two
+ * `new Date()` calls either side of midnight would produce a window that excludes the row the user
+ * is looking at), and a relative window is otherwise untestable.
+ */
+import { type CollectionFilterPreset } from '../../core/resources/resources.frontend.schemas';
+/** The `{ startDate, endDate }` pair the framework's date-range filter carries. */
+export interface CollectionFilterDateRange {
+    startDate: Date;
+    endDate: Date;
+}
+/**
+ * The CONCRETE filter assignment a preset makes at instant `now` — literals unchanged, relative
+ * ranges resolved to their `{ startDate, endDate }` window.
+ */
+export declare function resolveCollectionFilterPresetAssignment(preset: CollectionFilterPreset, now: Date): Record<string, unknown>;
+/**
+ * Is this preset currently ON?
+ *
+ * ON means every key it assigns holds its value — nothing weaker. A preset that assigns two fields
+ * and finds only one of them set is OFF, because a half-applied narrowing is not the one the pill
+ * names, and showing it as on would make the next click REMOVE a filter the user set by hand.
+ */
+export declare function isCollectionFilterPresetActive(preset: CollectionFilterPreset, currentFilters: Record<string, unknown>, now: Date): boolean;
+/**
+ * The filter values after clicking this preset — applied when it was off, removed when it was on.
+ *
+ * Removing DELETES the keys rather than setting them to `undefined`, matching what the filters
+ * panel and the chips do when a filter is cleared; a key present with `undefined` counts as an
+ * active filter in `countActiveFilters` and would inflate the trigger's badge.
+ */
+export declare function toggleCollectionFilterPreset(preset: CollectionFilterPreset, currentFilters: Record<string, unknown>, now: Date): Record<string, unknown>;
+//# sourceMappingURL=collection-filter-presets.frontend.utils.d.ts.map

package/dist/esm/core/resources/collection-filter-presets.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-filter-presets.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/collection-filter-presets.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,+DAA+D,CAAC;AAEvE,mFAAmF;AACnF,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AA6DD;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,IAAI,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAuCD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,GAAG,EAAE,IAAI,GACR,OAAO,CAKT;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,GAAG,EAAE,IAAI,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB"}

package/dist/esm/core/resources/collection-filter-presets.frontend.utils.js

@@ -0,0 +1,143 @@
+/**
+ * Applying and reading back a collection's PRESET FILTERS.
+ *
+ * A preset has no state of its own — it is a write into the collection's existing filter values,
+ * and its ON/OFF is derived by reading them back. Everything here is therefore a pure function of
+ * `(preset, currentFilters, now)`, which is what lets the pills stay in step with the filters
+ * panel, the chips and the quick-filter tabs without any of the four knowing about the others.
+ *
+ * `now` is a parameter rather than a `new Date()` inside these functions, for two reasons that
+ * both matter: a single click must resolve every field of a preset against ONE instant (two
+ * `new Date()` calls either side of midnight would produce a window that excludes the row the user
+ * is looking at), and a relative window is otherwise untestable.
+ */
+import { CollectionFilterPresetRelativeRange, } from '../../core/resources/resources.frontend.schemas.js';
+/** Local midnight at the start of `reference`'s day. */
+function startOfLocalDay(reference) {
+    return new Date(reference.getFullYear(), reference.getMonth(), reference.getDate());
+}
+/** Local midnight at the start of the day AFTER `reference`'s — the exclusive end of that day. */
+function startOfNextLocalDay(reference) {
+    return new Date(reference.getFullYear(), reference.getMonth(), reference.getDate() + 1);
+}
+/**
+ * The absolute window a relative range names, resolved against `now` in the VIEWER's timezone.
+ *
+ * A total `Record` rather than a `switch` with a `default`: a member added to the vocabulary is a
+ * compile error here, which is the only place that can resolve it. A `default` arm would silently
+ * give a new member somebody else's window.
+ *
+ * Every window ENDS at the start of tomorrow rather than at `now`, including the rolling ones.
+ * "Created today" must keep matching a row created a minute from now, or the list a user is
+ * watching drops rows as they arrive — which reads as the filter being broken.
+ */
+const RELATIVE_RANGE_RESOLVERS = {
+    [CollectionFilterPresetRelativeRange.TODAY]: (now) => ({
+        startDate: startOfLocalDay(now),
+        endDate: startOfNextLocalDay(now),
+    }),
+    [CollectionFilterPresetRelativeRange.YESTERDAY]: (now) => {
+        const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);
+        return { startDate: startOfLocalDay(yesterday), endDate: startOfNextLocalDay(yesterday) };
+    },
+    [CollectionFilterPresetRelativeRange.LAST_7_DAYS]: (now) => ({
+        // Six days back plus today = a rolling week INCLUDING today, which is what "the last 7 days"
+        // means to a reader looking at a list. Seven days back would be eight days of rows.
+        startDate: new Date(now.getFullYear(), now.getMonth(), now.getDate() - 6),
+        endDate: startOfNextLocalDay(now),
+    }),
+    [CollectionFilterPresetRelativeRange.LAST_30_DAYS]: (now) => ({
+        startDate: new Date(now.getFullYear(), now.getMonth(), now.getDate() - 29),
+        endDate: startOfNextLocalDay(now),
+    }),
+    [CollectionFilterPresetRelativeRange.THIS_MONTH]: (now) => ({
+        startDate: new Date(now.getFullYear(), now.getMonth(), 1),
+        endDate: startOfNextLocalDay(now),
+    }),
+    [CollectionFilterPresetRelativeRange.THIS_YEAR]: (now) => ({
+        startDate: new Date(now.getFullYear(), 0, 1),
+        endDate: startOfNextLocalDay(now),
+    }),
+};
+function isRelativeRangeValue(value) {
+    return typeof value === 'object' && value !== null && 'relativeRange' in value;
+}
+/**
+ * The CONCRETE filter assignment a preset makes at instant `now` — literals unchanged, relative
+ * ranges resolved to their `{ startDate, endDate }` window.
+ */
+export function resolveCollectionFilterPresetAssignment(preset, now) {
+    const assignment = {};
+    for (const [fieldName, value] of Object.entries(preset.filters)) {
+        assignment[fieldName] = isRelativeRangeValue(value)
+            ? RELATIVE_RANGE_RESOLVERS[value.relativeRange](now)
+            : value;
+    }
+    return assignment;
+}
+/**
+ * Is `candidate` the value `expected` assigns?
+ *
+ * A date window compares by its BOUNDS rather than by identity, because the value in the filter
+ * state was resolved on an earlier click and is a different `Date` object from the one this render
+ * computes. Comparing by instant is also what makes a preset go OFF by itself when the day rolls
+ * over — which is correct: "created today" applied yesterday is no longer the window it names.
+ */
+function filterValueMatches(candidate, expected) {
+    if (expected instanceof Object && 'startDate' in expected && 'endDate' in expected) {
+        const range = expected;
+        if (!candidate || typeof candidate !== 'object')
+            return false;
+        const actual = candidate;
+        return actual.startDate instanceof Date
+            && actual.endDate instanceof Date
+            && actual.startDate.getTime() === range.startDate.getTime()
+            && actual.endDate.getTime() === range.endDate.getTime();
+    }
+    // A NUMERIC BOUND pair, compared bound for bound. Identity would never match: the value in the
+    // filter state was built on an earlier click and is a different object, and — unlike a date
+    // window — it is also what the filter panel's own two inputs write, so a pill must read as ON
+    // when someone typed the same bounds by hand. That is the whole point of deriving activeness.
+    if (isNumericBound(expected)) {
+        return isNumericBound(candidate) && candidate.min === expected.min && candidate.max === expected.max;
+    }
+    return candidate === expected;
+}
+/** A `{ min?, max? }` value — the numeric-range filter vocabulary, and nothing else. */
+function isNumericBound(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value) || value instanceof Date)
+        return false;
+    const keys = Object.keys(value);
+    return keys.length > 0 && keys.every((key) => key === 'min' || key === 'max');
+}
+/**
+ * Is this preset currently ON?
+ *
+ * ON means every key it assigns holds its value — nothing weaker. A preset that assigns two fields
+ * and finds only one of them set is OFF, because a half-applied narrowing is not the one the pill
+ * names, and showing it as on would make the next click REMOVE a filter the user set by hand.
+ */
+export function isCollectionFilterPresetActive(preset, currentFilters, now) {
+    const assignment = resolveCollectionFilterPresetAssignment(preset, now);
+    const entries = Object.entries(assignment);
+    return entries.length > 0
+        && entries.every(([fieldName, value]) => filterValueMatches(currentFilters[fieldName], value));
+}
+/**
+ * The filter values after clicking this preset — applied when it was off, removed when it was on.
+ *
+ * Removing DELETES the keys rather than setting them to `undefined`, matching what the filters
+ * panel and the chips do when a filter is cleared; a key present with `undefined` counts as an
+ * active filter in `countActiveFilters` and would inflate the trigger's badge.
+ */
+export function toggleCollectionFilterPreset(preset, currentFilters, now) {
+    const assignment = resolveCollectionFilterPresetAssignment(preset, now);
+    const next = { ...currentFilters };
+    if (isCollectionFilterPresetActive(preset, currentFilters, now)) {
+        for (const fieldName of Object.keys(assignment))
+            delete next[fieldName];
+        return next;
+    }
+    return { ...next, ...assignment };
+}
+//# sourceMappingURL=collection-filter-presets.frontend.utils.js.map

package/dist/esm/core/resources/collection-filter-presets.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-filter-presets.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/collection-filter-presets.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Applying and reading back a collection's PRESET FILTERS.\n *\n * A preset has no state of its own — it is a write into the collection's existing filter values,\n * and its ON/OFF is derived by reading them back. Everything here is therefore a pure function of\n * `(preset, currentFilters, now)`, which is what lets the pills stay in step with the filters\n * panel, the chips and the quick-filter tabs without any of the four knowing about the others.\n *\n * `now` is a parameter rather than a `new Date()` inside these functions, for two reasons that\n * both matter: a single click must resolve every field of a preset against ONE instant (two\n * `new Date()` calls either side of midnight would produce a window that excludes the row the user\n * is looking at), and a relative window is otherwise untestable.\n */\n\nimport {\n  CollectionFilterPresetRelativeRange,\n  type CollectionFilterPreset,\n  type CollectionFilterPresetValue,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n/** The `{ startDate, endDate }` pair the framework's date-range filter carries. */\nexport interface CollectionFilterDateRange {\n  startDate: Date;\n  endDate: Date;\n}\n\n/** Local midnight at the start of `reference`'s day. */\nfunction startOfLocalDay(reference: Date): Date {\n  return new Date(reference.getFullYear(), reference.getMonth(), reference.getDate());\n}\n\n/** Local midnight at the start of the day AFTER `reference`'s — the exclusive end of that day. */\nfunction startOfNextLocalDay(reference: Date): Date {\n  return new Date(reference.getFullYear(), reference.getMonth(), reference.getDate() + 1);\n}\n\n/**\n * The absolute window a relative range names, resolved against `now` in the VIEWER's timezone.\n *\n * A total `Record` rather than a `switch` with a `default`: a member added to the vocabulary is a\n * compile error here, which is the only place that can resolve it. A `default` arm would silently\n * give a new member somebody else's window.\n *\n * Every window ENDS at the start of tomorrow rather than at `now`, including the rolling ones.\n * \"Created today\" must keep matching a row created a minute from now, or the list a user is\n * watching drops rows as they arrive — which reads as the filter being broken.\n */\nconst RELATIVE_RANGE_RESOLVERS: Record<\n  CollectionFilterPresetRelativeRange,\n  (now: Date) => CollectionFilterDateRange\n> = {\n  [CollectionFilterPresetRelativeRange.TODAY]: (now) => ({\n    startDate: startOfLocalDay(now),\n    endDate: startOfNextLocalDay(now),\n  }),\n  [CollectionFilterPresetRelativeRange.YESTERDAY]: (now) => {\n    const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1);\n    return { startDate: startOfLocalDay(yesterday), endDate: startOfNextLocalDay(yesterday) };\n  },\n  [CollectionFilterPresetRelativeRange.LAST_7_DAYS]: (now) => ({\n    // Six days back plus today = a rolling week INCLUDING today, which is what \"the last 7 days\"\n    // means to a reader looking at a list. Seven days back would be eight days of rows.\n    startDate: new Date(now.getFullYear(), now.getMonth(), now.getDate() - 6),\n    endDate: startOfNextLocalDay(now),\n  }),\n  [CollectionFilterPresetRelativeRange.LAST_30_DAYS]: (now) => ({\n    startDate: new Date(now.getFullYear(), now.getMonth(), now.getDate() - 29),\n    endDate: startOfNextLocalDay(now),\n  }),\n  [CollectionFilterPresetRelativeRange.THIS_MONTH]: (now) => ({\n    startDate: new Date(now.getFullYear(), now.getMonth(), 1),\n    endDate: startOfNextLocalDay(now),\n  }),\n  [CollectionFilterPresetRelativeRange.THIS_YEAR]: (now) => ({\n    startDate: new Date(now.getFullYear(), 0, 1),\n    endDate: startOfNextLocalDay(now),\n  }),\n};\n\nfunction isRelativeRangeValue(\n  value: CollectionFilterPresetValue,\n): value is { relativeRange: CollectionFilterPresetRelativeRange } {\n  return typeof value === 'object' && value !== null && 'relativeRange' in value;\n}\n\n/**\n * The CONCRETE filter assignment a preset makes at instant `now` — literals unchanged, relative\n * ranges resolved to their `{ startDate, endDate }` window.\n */\nexport function resolveCollectionFilterPresetAssignment(\n  preset: CollectionFilterPreset,\n  now: Date,\n): Record<string, unknown> {\n  const assignment: Record<string, unknown> = {};\n  for (const [fieldName, value] of Object.entries(preset.filters)) {\n    assignment[fieldName] = isRelativeRangeValue(value)\n      ? RELATIVE_RANGE_RESOLVERS[value.relativeRange](now)\n      : value;\n  }\n  return assignment;\n}\n\n/**\n * Is `candidate` the value `expected` assigns?\n *\n * A date window compares by its BOUNDS rather than by identity, because the value in the filter\n * state was resolved on an earlier click and is a different `Date` object from the one this render\n * computes. Comparing by instant is also what makes a preset go OFF by itself when the day rolls\n * over — which is correct: \"created today\" applied yesterday is no longer the window it names.\n */\nfunction filterValueMatches(candidate: unknown, expected: unknown): boolean {\n  if (expected instanceof Object && 'startDate' in expected && 'endDate' in expected) {\n    const range = expected as CollectionFilterDateRange;\n    if (!candidate || typeof candidate !== 'object') return false;\n    const actual = candidate as Partial<CollectionFilterDateRange>;\n    return actual.startDate instanceof Date\n      && actual.endDate instanceof Date\n      && actual.startDate.getTime() === range.startDate.getTime()\n      && actual.endDate.getTime() === range.endDate.getTime();\n  }\n\n  // A NUMERIC BOUND pair, compared bound for bound. Identity would never match: the value in the\n  // filter state was built on an earlier click and is a different object, and — unlike a date\n  // window — it is also what the filter panel's own two inputs write, so a pill must read as ON\n  // when someone typed the same bounds by hand. That is the whole point of deriving activeness.\n  if (isNumericBound(expected)) {\n    return isNumericBound(candidate) && candidate.min === expected.min && candidate.max === expected.max;\n  }\n\n  return candidate === expected;\n}\n\n/** A `{ min?, max? }` value — the numeric-range filter vocabulary, and nothing else. */\nfunction isNumericBound(value: unknown): value is { min?: number; max?: number } {\n  if (!value || typeof value !== 'object' || Array.isArray(value) || value instanceof Date) return false;\n  const keys = Object.keys(value);\n  return keys.length > 0 && keys.every((key) => key === 'min' || key === 'max');\n}\n\n/**\n * Is this preset currently ON?\n *\n * ON means every key it assigns holds its value — nothing weaker. A preset that assigns two fields\n * and finds only one of them set is OFF, because a half-applied narrowing is not the one the pill\n * names, and showing it as on would make the next click REMOVE a filter the user set by hand.\n */\nexport function isCollectionFilterPresetActive(\n  preset: CollectionFilterPreset,\n  currentFilters: Record<string, unknown>,\n  now: Date,\n): boolean {\n  const assignment = resolveCollectionFilterPresetAssignment(preset, now);\n  const entries = Object.entries(assignment);\n  return entries.length > 0\n    && entries.every(([fieldName, value]) => filterValueMatches(currentFilters[fieldName], value));\n}\n\n/**\n * The filter values after clicking this preset — applied when it was off, removed when it was on.\n *\n * Removing DELETES the keys rather than setting them to `undefined`, matching what the filters\n * panel and the chips do when a filter is cleared; a key present with `undefined` counts as an\n * active filter in `countActiveFilters` and would inflate the trigger's badge.\n */\nexport function toggleCollectionFilterPreset(\n  preset: CollectionFilterPreset,\n  currentFilters: Record<string, unknown>,\n  now: Date,\n): Record<string, unknown> {\n  const assignment = resolveCollectionFilterPresetAssignment(preset, now);\n  const next = { ...currentFilters };\n\n  if (isCollectionFilterPresetActive(preset, currentFilters, now)) {\n    for (const fieldName of Object.keys(assignment)) delete next[fieldName];\n    return next;\n  }\n\n  return { ...next, ...assignment };\n}\n"]}

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

@@ -14,10 +14,17 @@ export declare function normalizeContextResourceIdentifiersForTransport(contextR
  * Outcome events need the real child-row id when a context-addressed mutation
  * returns it. Add that identity without discarding the parent/FK identifiers
  * used to route the operation.
+ *
+ * A BULK operation's result names no single subject, even when it is one row: a one-row
+ * selection answers with that row, and naming it here turned the outcome's context from "this
+ * collection" into "this todo". The bulk bar matches its outcome on the collection's context, so
+ * it never cleared the selection after a one-row bulk action. Pass `isBulkOperation` and the
+ * result is not read.
  */
 export declare function normalizeContextResourceIdentifiersForOutcome(params: {
     contextResourceIdentifiers: ContextResourceIdentifiersInput;
     resourceType: string;
     result?: unknown;
+    isBulkOperation?: boolean;
 }): Record<string, string>;
 //# sourceMappingURL=context-resource-identifiers.frontend.utils.d.ts.map

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

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

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

@@ -63,10 +63,16 @@ function readPersistedResourceIdFromResult(result) {
  * Outcome events need the real child-row id when a context-addressed mutation
  * returns it. Add that identity without discarding the parent/FK identifiers
  * used to route the operation.
+ *
+ * A BULK operation's result names no single subject, even when it is one row: a one-row
+ * selection answers with that row, and naming it here turned the outcome's context from "this
+ * collection" into "this todo". The bulk bar matches its outcome on the collection's context, so
+ * it never cleared the selection after a one-row bulk action. Pass `isBulkOperation` and the
+ * result is not read.
  */
 export function normalizeContextResourceIdentifiersForOutcome(params) {
     const normalized = normalizeContextResourceIdentifiersForTransport(params.contextResourceIdentifiers);
-    const resultResourceId = readPersistedResourceIdFromResult(params.result);
+    const resultResourceId = params.isBulkOperation === true ? undefined : readPersistedResourceIdFromResult(params.result);
     if (resultResourceId) {
         normalized[params.resourceType] = resultResourceId;
         if (params.contextResourceIdentifiers

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

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"file-serve-url.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/resources/file-serve-url.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,yCAAyC,EAAE,kBAAkB,EAAE,gBAAgB,EAAqB,MAAM,uBAAuB,CAAC;AAC3I,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAuBnG;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAA2C;IACvF,MAAM,EACJ,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EACtE,0BAA0B,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,UAAU,GAC1F,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC,cAAc,EAAE,uBAAuB,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAErF,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,yCAAyC,CAAC,gCAAgC,CAC3F,cAAc,EACd,SAAS,EACT,QAAQ,CAAC,2BAA2B,CACrC,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzC,MAAM,SAAS,GAAG,qBAAqB,CAAC,uBAAuB,CAC7D,UAAU,EACV,0BAA0B,EAC1B,cAAc,CAAC,kBAAkB,EACjC,cAAc,CAAC,uBAAuB,EACtC,2BAA2B;QAC3B,mFAAmF;QACnF,gFAAgF;QAChF,8EAA8E;QAC9E,QAAQ,CAAC,2BAA2B,CACrC,CAAC;QAEF,uFAAuF;QACvF,qFAAqF;QACrF,MAAM,WAAW,GAAG;YAClB,GAAG,oBAAoB;YACvB,CAAC,cAAc,CAAC,uBAAuB,CAAC,EAAE,QAAQ;SACnD,CAAC;QAEF,MAAM,UAAU,GAAG,yCAAyC,CAAC,gCAAgC,CAAC;YAC5F,iBAAiB,EAAE,SAAS,CAAC,GAAG;YAChC,mBAAmB,EAAE,SAAS,CAAC,UAAU;YACzC,kBAAkB,EAAE,YAAY;YAChC,6BAA6B,EAAE,cAAc,CAAC,uBAAuB;YACrE,SAAS;YACT,wBAAwB,EAAE,IAAI;YAC9B,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC7E,IAAI,eAAe,CAAC,yBAAyB,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAErE,wFAAwF;QACxF,OAAO,GAAG,UAAU,GAAG,kBAAkB,GAAG,QAAQ,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,OAAyB;IAChF,IAAI,OAAO,KAAK,gBAAgB,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC3D,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,OAAO,GAAG,QAAQ,GAAG,SAAS,WAAW,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,OAAO,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACtE,CAAC","sourcesContent":["/**\n * Shared builder for the resource-integrated file SERVE URL, used by every display\n * surface that renders an inline file preview (the resource displayer AND standalone\n * consumers like the nav user-menu avatar).\n *\n * The serve route is ENTITY-addressed:\n *   `{apiBase}/api/v1/…/{resourceId}/files/{fieldName}/{fileId}`\n * A context-addressed singleton READ (e.g. the user's own profile) has NO resourceId in\n * its route, so the caller supplies `recordId` (the displayed record's own `_id`) which\n * fills the `{resourceId}` segment — the same id the UPDATE/upload uses. This function\n * returns the serve BASE (`…/{resourceId}/files/{fieldName}`, no fileId); the consumer\n * appends `/{fileId}` per file. Returns `null` when the route can't be resolved (missing\n * context / non-addressable) so callers degrade gracefully.\n *\n * Authorization for the served bytes inherits the parent resource's READ (enforced\n * backend-side) — see `.claude/context/file-management.md`.\n */\nimport { ResourcesConfigOperationsUrlsBuilderUtils, MAIN_API_BASE_PATH, FileServeVariant, type ResourceType } from '@wildo-ai/saas-models';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport interface BuildResourceFileServeBaseUrlParams {\n  registry: FrontendResourcesRegistry;\n  /** Resolved resource config (`registry.resourceConfigurations[resourceType]`). */\n  resourceConfig: any;\n  /** A url-bearing operation for the resource (typically the default READ). */\n  operation: any;\n  resourceType: ResourceType;\n  /** File field name on the resource (e.g. `avatar`). */\n  fieldName: string;\n  /** The displayed record's own id — fills the entity-addressed `{resourceId}` segment. */\n  recordId: string;\n  /** Parent-chain identifiers (resourceType → id), as on `resourceContext`. */\n  contextResourceIdentifiers: Record<string, string | { fieldIdentifier?: string; resourceId?: string }>;\n  /** Resolved placeholder params (`FrontendResourceUtils.buildContextualParameters(...)`). */\n  contextualParameters: Record<string, string | number>;\n  /** Optional parent-requirement hints from the resource context. */\n  parentResourcesRequirements?: any[];\n  apiBaseUrl: string;\n}\n\n/**\n * Build the resource-integrated serve base URL for a file field, or `null` if it can't\n * be resolved. See the module doc for the addressing contract.\n */\nexport function buildResourceFileServeBaseUrl(params: BuildResourceFileServeBaseUrlParams): string | null {\n  const {\n    registry, resourceConfig, operation, resourceType, fieldName, recordId,\n    contextResourceIdentifiers, contextualParameters, parentResourcesRequirements, apiBaseUrl,\n  } = params;\n\n  if (!resourceConfig?.resourceFieldIdentifier || !recordId || !operation) return null;\n\n  try {\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceConfig,\n      operation,\n      registry.allResourceFieldIdentifiers,\n    );\n    if (routePaths.length === 0) return null;\n\n    const routePath = frontendResourceUtils.selectMatchingRoutePath(\n      routePaths,\n      contextResourceIdentifiers,\n      resourceConfig.resourceIdentifier,\n      resourceConfig.resourceFieldIdentifier,\n      parentResourcesRequirements,\n      // Pass the registry field-identifier map so a parent segment keyed by its STANDARD\n      // identifier can fall back to the broad resource-type context slot (how a nav /\n      // scope-derived caller resolves the parent id without an explicit field key).\n      registry.allResourceFieldIdentifiers,\n    );\n\n    // Serve params = the parent-chain identifiers PLUS the displayed record's own id under\n    // THIS resource's field identifier (the segment the READ route omits when singular).\n    const serveParams = {\n      ...contextualParameters,\n      [resourceConfig.resourceFieldIdentifier]: recordId,\n    };\n\n    const serveRoute = ResourcesConfigOperationsUrlsBuilderUtils.buildFileUploadRouteForOperation({\n      operationRouteUrl: routePath.url,\n      operationParameters: routePath.parameters,\n      targetResourceType: resourceType,\n      targetResourceFieldIdentifier: resourceConfig.resourceFieldIdentifier,\n      fieldName,\n      requiresTargetResourceId: true,\n      isFrontend: true,\n    });\n\n    const resolved = NavigationUtils.resolveUrlPath(serveRoute.url, serveParams);\n    if (NavigationUtils.hasUnresolvedPlaceholders(resolved)) return null;\n\n    // Frontend route paths omit `/api/v1`; re-add it to match the registered backend route.\n    return `${apiBaseUrl}${MAIN_API_BASE_PATH}${resolved}`;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Append a `?variant=` query parameter to a serve URL (base or with `/{fileId}`),\n * selecting a rendition. `ORIGINAL` returns the URL unchanged (the route's default), so\n * only `THUMBNAIL` actually adds the param. Preserves any pre-existing query string.\n */\nexport function appendFileServeVariant(serveUrl: string, variant: FileServeVariant): string {\n  if (variant === FileServeVariant.ORIGINAL) return serveUrl;\n  const separator = serveUrl.includes('?') ? '&' : '?';\n  return `${serveUrl}${separator}variant=${encodeURIComponent(variant)}`;\n}\n\n/**\n * Convenience: the `?variant=thumbnail` preview URL for a served file — a small,\n * downscaled `webp` rendition. Use for preview surfaces (nav avatar, list/card image);\n * use the un-suffixed serve URL for a full-resolution view (e.g. a lightbox).\n */\nexport function buildFileServeThumbnailUrl(serveUrl: string): string {\n  return appendFileServeVariant(serveUrl, FileServeVariant.THUMBNAIL);\n}\n"]}
+{"version":3,"file":"file-serve-url.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/file-serve-url.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,yCAAyC,EAAE,kBAAkB,EAAE,gBAAgB,EAAqB,MAAM,uBAAuB,CAAC;AAC3I,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAuBnG;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAA2C;IACvF,MAAM,EACJ,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EACtE,0BAA0B,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,UAAU,GAC1F,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC,cAAc,EAAE,uBAAuB,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAErF,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,yCAAyC,CAAC,gCAAgC,CAC3F,cAAc,EACd,SAAS,EACT,QAAQ,CAAC,2BAA2B,CACrC,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzC,MAAM,SAAS,GAAG,qBAAqB,CAAC,uBAAuB,CAC7D,UAAU,EACV,0BAA0B,EAC1B,cAAc,CAAC,kBAAkB,EACjC,cAAc,CAAC,uBAAuB,EACtC,2BAA2B;QAC3B,mFAAmF;QACnF,gFAAgF;QAChF,8EAA8E;QAC9E,QAAQ,CAAC,2BAA2B,CACrC,CAAC;QAEF,uFAAuF;QACvF,qFAAqF;QACrF,MAAM,WAAW,GAAG;YAClB,GAAG,oBAAoB;YACvB,CAAC,cAAc,CAAC,uBAAuB,CAAC,EAAE,QAAQ;SACnD,CAAC;QAEF,MAAM,UAAU,GAAG,yCAAyC,CAAC,gCAAgC,CAAC;YAC5F,iBAAiB,EAAE,SAAS,CAAC,GAAG;YAChC,mBAAmB,EAAE,SAAS,CAAC,UAAU;YACzC,kBAAkB,EAAE,YAAY;YAChC,6BAA6B,EAAE,cAAc,CAAC,uBAAuB;YACrE,SAAS;YACT,wBAAwB,EAAE,IAAI;YAC9B,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC7E,IAAI,eAAe,CAAC,yBAAyB,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAErE,wFAAwF;QACxF,OAAO,GAAG,UAAU,GAAG,kBAAkB,GAAG,QAAQ,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,OAAyB;IAChF,IAAI,OAAO,KAAK,gBAAgB,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC3D,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,OAAO,GAAG,QAAQ,GAAG,SAAS,WAAW,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,OAAO,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACtE,CAAC","sourcesContent":["/**\n * Shared builder for the resource-integrated file SERVE URL, used by every display\n * surface that renders an inline file preview (the resource displayer AND standalone\n * consumers like the nav user-menu avatar).\n *\n * The serve route is ENTITY-addressed:\n *   `{apiBase}/api/v1/…/{resourceId}/files/{fieldName}/{fileId}`\n * A context-addressed singleton READ (e.g. the user's own profile) has NO resourceId in\n * its route, so the caller supplies `recordId` (the displayed record's own `_id`) which\n * fills the `{resourceId}` segment — the same id the UPDATE/upload uses. This function\n * returns the serve BASE (`…/{resourceId}/files/{fieldName}`, no fileId); the consumer\n * appends `/{fileId}` per file. Returns `null` when the route can't be resolved (missing\n * context / non-addressable) so callers degrade gracefully.\n *\n * Authorization for the served bytes inherits the parent resource's READ (enforced\n * backend-side) — see `.claude/context/file-management.md`.\n */\nimport { ResourcesConfigOperationsUrlsBuilderUtils, MAIN_API_BASE_PATH, FileServeVariant, type ResourceType } from '@wildo-ai/saas-models';\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport interface BuildResourceFileServeBaseUrlParams {\n  registry: FrontendResourcesRegistry;\n  /** Resolved resource config (`registry.resourceConfigurations[resourceType]`). */\n  resourceConfig: any;\n  /** A url-bearing operation for the resource (typically the default READ). */\n  operation: any;\n  resourceType: ResourceType;\n  /** File field name on the resource (e.g. `avatar`). */\n  fieldName: string;\n  /** The displayed record's own id — fills the entity-addressed `{resourceId}` segment. */\n  recordId: string;\n  /** Parent-chain identifiers (resourceType → id), as on `resourceContext`. */\n  contextResourceIdentifiers: Record<string, string | { fieldIdentifier?: string; resourceId?: string }>;\n  /** Resolved placeholder params (`FrontendResourceUtils.buildContextualParameters(...)`). */\n  contextualParameters: Record<string, string | number>;\n  /** Optional parent-requirement hints from the resource context. */\n  parentResourcesRequirements?: any[];\n  apiBaseUrl: string;\n}\n\n/**\n * Build the resource-integrated serve base URL for a file field, or `null` if it can't\n * be resolved. See the module doc for the addressing contract.\n */\nexport function buildResourceFileServeBaseUrl(params: BuildResourceFileServeBaseUrlParams): string | null {\n  const {\n    registry, resourceConfig, operation, resourceType, fieldName, recordId,\n    contextResourceIdentifiers, contextualParameters, parentResourcesRequirements, apiBaseUrl,\n  } = params;\n\n  if (!resourceConfig?.resourceFieldIdentifier || !recordId || !operation) return null;\n\n  try {\n    const routePaths = ResourcesConfigOperationsUrlsBuilderUtils.buildOperationFrontendRoutePaths(\n      resourceConfig,\n      operation,\n      registry.allResourceFieldIdentifiers,\n    );\n    if (routePaths.length === 0) return null;\n\n    const routePath = frontendResourceUtils.selectMatchingRoutePath(\n      routePaths,\n      contextResourceIdentifiers,\n      resourceConfig.resourceIdentifier,\n      resourceConfig.resourceFieldIdentifier,\n      parentResourcesRequirements,\n      // Pass the registry field-identifier map so a parent segment keyed by its STANDARD\n      // identifier can fall back to the broad resource-type context slot (how a nav /\n      // scope-derived caller resolves the parent id without an explicit field key).\n      registry.allResourceFieldIdentifiers,\n    );\n\n    // Serve params = the parent-chain identifiers PLUS the displayed record's own id under\n    // THIS resource's field identifier (the segment the READ route omits when singular).\n    const serveParams = {\n      ...contextualParameters,\n      [resourceConfig.resourceFieldIdentifier]: recordId,\n    };\n\n    const serveRoute = ResourcesConfigOperationsUrlsBuilderUtils.buildFileUploadRouteForOperation({\n      operationRouteUrl: routePath.url,\n      operationParameters: routePath.parameters,\n      targetResourceType: resourceType,\n      targetResourceFieldIdentifier: resourceConfig.resourceFieldIdentifier,\n      fieldName,\n      requiresTargetResourceId: true,\n      isFrontend: true,\n    });\n\n    const resolved = NavigationUtils.resolveUrlPath(serveRoute.url, serveParams);\n    if (NavigationUtils.hasUnresolvedPlaceholders(resolved)) return null;\n\n    // Frontend route paths omit `/api/v1`; re-add it to match the registered backend route.\n    return `${apiBaseUrl}${MAIN_API_BASE_PATH}${resolved}`;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Append a `?variant=` query parameter to a serve URL (base or with `/{fileId}`),\n * selecting a rendition. `ORIGINAL` returns the URL unchanged (the route's default), so\n * only `THUMBNAIL` actually adds the param. Preserves any pre-existing query string.\n */\nexport function appendFileServeVariant(serveUrl: string, variant: FileServeVariant): string {\n  if (variant === FileServeVariant.ORIGINAL) return serveUrl;\n  const separator = serveUrl.includes('?') ? '&' : '?';\n  return `${serveUrl}${separator}variant=${encodeURIComponent(variant)}`;\n}\n\n/**\n * Convenience: the `?variant=thumbnail` preview URL for a served file — a small,\n * downscaled `webp` rendition. Use for preview surfaces (nav avatar, list/card image);\n * use the un-suffixed serve URL for a full-resolution view (e.g. a lightbox).\n */\nexport function buildFileServeThumbnailUrl(serveUrl: string): string {\n  return appendFileServeVariant(serveUrl, FileServeVariant.THUMBNAIL);\n}\n"]}

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

@@ -1,7 +1,7 @@
 import { ChildOperationsConfig_Parsed, CoreResourceOperation, ResourceType, ResourceConfiguration_Operation_UrlInitiatorInfo, ResourceConfiguration_Operation_UrlParameterInfo, ErrorCustomMessageReference, DataMode, Resources_SharedUtils } from "@wildo-ai/saas-models";
 import type { z } from 'zod';
 import type { FrontendResourceOperationPath, FrontendResource_ParentResourceRequirement } from './resource-path.frontend.schemas';
-import type { FrontendResourcesRegistry, FrontendResourceConfiguration_Operation } from './resources.frontend.schemas';
+import type { FrontendResourcesRegistry, AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation } from './resources.frontend.schemas';
 import { FrontendResourceOperationContext } from './resources.frontend.schemas';
 export interface ResolvedRelationshipObjectFieldSemantics {
     rootFieldName: string;
@@ -123,6 +123,30 @@ export declare class FrontendResourceUtils {
         targetDefaultFieldIdentifier: string;
         parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
     }): ResourceConfiguration_Operation_UrlInitiatorInfo | undefined;
+    /**
+     * The part of a listing's context that actually SCOPES it: the identifiers consumed by the route
+     * the transport selects for it (same selector, {@link selectOperationUrlInitiatorInfo}), and
+     * nothing else.
+     *
+     * A collection refreshes when a changed row's context COVERS this scope. The listing's own
+     * context also carries AMBIENT identifiers that play no part in what it shows — the signed-in
+     * user, for one — and matching on those made the scope uncoverable: the Wonder Todos listing,
+     * addressed by `organizations` alone, carried `users` as well, so no row broadcast (which names
+     * only the organization) ever refreshed it. Every edit, bulk or single, left it stale until reload.
+     *
+     * An operation with no URL initiators is scoped by nothing it can read from context, so its scope
+     * is empty and it refreshes on any change to its resource type.
+     */
+    static resolveCollectionRefreshScope(params: {
+        operation: {
+            initiatorInfos?: ResourceConfiguration_Operation_UrlInitiatorInfo[];
+        } | undefined;
+        contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'];
+        contextualParameters: Record<string, string | number | string[] | undefined>;
+        targetResourceType: ResourceType;
+        targetDefaultFieldIdentifier: string;
+        parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
+    }): FrontendResourceOperationContext['contextResourceIdentifiers'];
     /**
      * Pick the preferred URL-bearing operation from config for a given operation identifier.
      * Prefers default and non-bulk operations without assuming API_CALL over callbacks.
@@ -241,7 +265,13 @@ export declare class FrontendResourceUtils {
      *
      * - If config label is a `string[]`, we join non-empty values with a space.
      * - If config label is a function, we call it with `t` and (optional) context.
-     * - If anything fails, we fall back to common fields (`name`, `title`, `_id`, ...).
+     * - With no strategy (or a failing one), we fall back to the record's DECLARED SUMMARY FIELDS,
+     *   and finally to its id. See the fallback site below for what that replaced and why.
+     *
+     * The third bullet used to read "we fall back to common fields (`name`, `title`, `_id`, ...)".
+     * No code ever did that — the fallback read a foreign-key field name off the record and could
+     * only return `null` — so the JSDoc described an intent nobody had implemented (#633). It is
+     * now true.
      */
     static computeFrontendResourceLabel(params: {
         resourceType: ResourceType;
@@ -253,6 +283,48 @@ export declare class FrontendResourceUtils {
         objectContext?: any;
         initiatorUserContext?: any;
     }): string | null;
+    /**
+     * Detect a resource's summary fields — the `.isSummaryField()` scan over its main schema.
+     *
+     * Returns only explicitly annotated fields: no config overrides, no heuristic fallbacks. Three
+     * exclusions are applied, and each is load-bearing rather than tidiness:
+     *
+     * - the resource's OWN field identifier, which addresses the row rather than describing it;
+     * - the PRIMARY-SCOPE foreign key (e.g. `organizationId`), identical for every row in a scoped
+     *   collection — the collection is already scoped to it — and a heavy reference to render;
+     * - `_`-prefixed keys (`_id`), which are identity rather than content.
+     *
+     * Display-hidden fields are excluded too: such a field is summary-PROJECTED for non-display
+     * consumers (a denormalized field backing a synchronous resource label, or member search) and
+     * must never auto-render as a card-secondary field or a table column.
+     *
+     * Lives HERE, at the resource-utility layer, rather than in `resourceLayout.utils` where it was
+     * written: the layouts need it and so does `getResourceLabel` above, and this module is the one
+     * both can import without a cycle. `ResourceLayoutUtils.detectSummaryFields` delegates to it.
+     *
+     * Returns `[]` for an absent config or a schema with no resolvable object shape, and — unlike
+     * the layout version it replaces — for a config carrying no `resourceFieldIdentifier`. Throwing
+     * there was safe while the only callers were layouts that had already resolved a registered
+     * resource; it is not safe on a label path, which must never crash a page over a label.
+     */
+    /**
+     * Is this field name IDENTITY PLUMBING rather than something a person reads?
+     *
+     * Three names are excluded from every summary surface: the resource's own field identifier,
+     * the primary-scope column (`organizationId`, `userId`, …) and anything `_`-prefixed. None of
+     * them tells a reader WHICH record they are looking at — they are how the system addresses it.
+     *
+     * Extracted so the two paths that answer "which fields does a summary show?" cannot drift
+     * apart. They did: `detectSummaryFields` (table columns, list-card bodies) applied these three
+     * exclusions while `generateDefaultSummaryTemplate` (foreign-key popovers, read-summary bodies)
+     * filtered only backend-only fields — so hovering a reference to a resource with no authored
+     * `layout.summary` rendered its raw `_id` and its tenant id as two labelled rows, while the
+     * same resource's list card one component over correctly omitted both. The generator's own
+     * comment claimed the two were kept "in sync"; they were not, and a shared predicate is what
+     * makes that claim true rather than aspirational.
+     */
+    static isIdentityOnlySummaryField(fieldName: string, resourceConfig: AnyFrontendResourceConfiguration | undefined): boolean;
+    static detectSummaryFields(resourceConfig: AnyFrontendResourceConfiguration | undefined): string[];
     /**
      * Build a WildoError for frontend resource configuration errors (instance method).
      * Uses ErrorType.CONFIGURATION — missing route paths, missing callbacks, etc.