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

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

@@ -1 +1 @@
-{"version":3,"file":"ScopedResourceRegistryProvider.js","sourceRoot":"","sources":["../../../../../src/core/resources/ScopedResourceRegistryProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useCallback, useMemo, type ReactNode } from 'react';\nimport {\n  ResourcesConfig_OperationPathUtils,\n  ResourceOperationVariantType,\n  type ResourceConfiguration_Operation,\n  type ResourceConfiguration_OperationPath,\n} from '@wildo-ai/saas-models';\nimport { OperationEnabledConditionUtils, type EvaluateEnabledConditionParams } from '~wildo-frontend-lib/core/resources/utils/operation-enabled-condition.frontend.utils';\nimport { ResourceRegistryContext, type ResourceRegistryContextType } from './ResourceRegistryContext';\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\n\nexport interface ScopedResourceRegistryProviderProps {\n  children: ReactNode;\n}\n\nfunction toOperationPathKey(operationPath: ResourceConfiguration_OperationPath<any, any> | string): string {\n  return typeof operationPath === 'string'\n    ? operationPath\n    : ResourcesConfig_OperationPathUtils.createOperationPathKey(operationPath);\n}\n\nfunction findOperationInRegistry(\n  registry: ResourceRegistryContextType['registry'],\n  operationPath: ResourceConfiguration_OperationPath<any, any>\n): ResourceConfiguration_Operation<any, any, any> | null {\n  const resourceConfig = registry.resourceConfigurations[operationPath.resourceIdentifier];\n  if (!resourceConfig) {\n    return null;\n  }\n\n  return resourceConfig.operations.find((op: any) => {\n    const opPath = ResourcesConfig_OperationPathUtils.extractOperationPath(op);\n\n    if (opPath.operationIdentifier !== operationPath.operationIdentifier) return false;\n    if (opPath.variantType !== operationPath.variantType) return false;\n\n    if (operationPath.isOperationDefault) {\n      if (!opPath.isOperationDefault) return false;\n    } else {\n      const expectedVariantKey = operationPath.variantKey;\n      const actualVariantKey = opPath.variantKey;\n      if ((actualVariantKey ?? undefined) !== (expectedVariantKey ?? undefined)) return false;\n    }\n\n    if (\n      opPath.variantType === ResourceOperationVariantType.API_CALL\n      || opPath.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK\n    ) {\n      const opIsBulk = opPath.isBulkOperation === true;\n      const pathIsBulk = operationPath.isBulkOperation === true;\n      return opIsBulk === pathIsBulk;\n    }\n\n    return true;\n  }) || null;\n}\n\n/**\n * Nested provider that re-exposes ResourceRegistryContext with a scoped `doOperation()`.\n *\n * This is intentionally placed INSIDE `AppScopeProvider` so it can inject the current scope\n * into all resource calls, while keeping the root `ResourceRegistryProvider` unchanged.\n */\nexport function ScopedResourceRegistryProvider({ children }: ScopedResourceRegistryProviderProps): React.ReactElement {\n  const base = useResourceRegistry();\n  const appScope = useAppScopeSafe();\n\n  const doOperation = useCallback<ResourceRegistryContextType['doOperation']>(\n    async (operationPath, parameters, options) => {\n      // If AppScopeProvider isn't mounted yet, behave exactly like the base registry.\n      if (!appScope) {\n        return base.doOperation(operationPath, parameters, options);\n      }\n\n      const operationPathKey = toOperationPathKey(operationPath as any);\n\n      // Parse target operation to decide which contextual params are relevant.\n      // If parsing fails for any reason, fall back to base behavior.\n      let parsedPath: ResourceConfiguration_OperationPath<any, any> | null = null;\n      try {\n        parsedPath = ResourcesConfig_OperationPathUtils.parseOperationPathKey(operationPathKey);\n      } catch {\n        parsedPath = null;\n      }\n\n      const operation = parsedPath ? findOperationInRegistry(base.registry, parsedPath) : null;\n\n      // If operation was not found in registry, fall back to unscoped behavior.\n      // This prevents fragile optional-chaining on initiatorInfos below.\n      if (!operation) {\n        return base.doOperation(operationPath, parameters, options);\n      }\n\n      const injectedScopeParams: Record<string, string | string[]> = appScope.buildContextualParameters();\n      const existingContextualParameters =\n        (parameters as any)?.contextualParameters as Record<string, string | string[]> | undefined;\n      const mergedContextualParameters = {\n        ...injectedScopeParams,\n        ...(existingContextualParameters || {}),\n      };\n\n      const mergedParameters = {\n        ...(parameters as any),\n        contextualParameters: mergedContextualParameters,\n      };\n\n      return base.doOperation(operationPath, mergedParameters, options);\n    },\n    [appScope, base]\n  );\n\n  /**\n   * IMPORTANT:\n   * `ResourceRegistryProvider`'s `evaluateOperationEnabled` closes over its own `doOperation`.\n   * If we only override `doOperation` in context, enabledCondition evaluation would still run with\n   * the unscoped doOperation (missing AppScope injection).\n   *\n   * So we override `evaluateOperationEnabled` as well, wiring it to the scoped `doOperation`.\n   */\n  const evaluateOperationEnabled = useCallback<ResourceRegistryContextType['evaluateOperationEnabled']>(\n    async (params) => {\n      return OperationEnabledConditionUtils.evaluateEnabledCondition({\n        ...(params as any),\n        resourcesRegistry: base.registry,\n        doOperation,\n      } satisfies EvaluateEnabledConditionParams<any>);\n    },\n    [base.registry, doOperation]\n  );\n\n  const value = useMemo<ResourceRegistryContextType>(() => {\n    return {\n      ...base,\n      doOperation,\n      evaluateOperationEnabled,\n    };\n  }, [base, doOperation, evaluateOperationEnabled]);\n\n  return (\n    <ResourceRegistryContext.Provider value={value}>\n      {children}\n    </ResourceRegistryContext.Provider>\n  );\n}\n\n"]}
+{"version":3,"file":"ScopedResourceRegistryProvider.js","sourceRoot":"","sources":["../../../../../src/core/resources/ScopedResourceRegistryProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useCallback, useMemo, type ReactNode } from 'react';\nimport {\n  ResourcesConfig_OperationPathUtils,\n  ResourceOperationVariantType,\n  type ResourceConfiguration_Operation,\n  type ResourceConfiguration_OperationPath,\n} from '@wildo-ai/saas-models';\nimport { OperationEnabledConditionUtils, type EvaluateEnabledConditionParams } from '~wildo-frontend-lib/core/resources/utils/operation-enabled-condition.frontend.utils';\nimport { ResourceRegistryContext, type ResourceRegistryContextType } from './ResourceRegistryContext';\nimport { useResourceRegistry } from './useResourceRegistry';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\n\nexport interface ScopedResourceRegistryProviderProps {\n  children: ReactNode;\n}\n\nfunction toOperationPathKey(operationPath: ResourceConfiguration_OperationPath<any, any> | string): string {\n  return typeof operationPath === 'string'\n    ? operationPath\n    : ResourcesConfig_OperationPathUtils.createOperationPathKey(operationPath);\n}\n\nfunction findOperationInRegistry(\n  registry: ResourceRegistryContextType['registry'],\n  operationPath: ResourceConfiguration_OperationPath<any, any>\n): ResourceConfiguration_Operation<any, any, any> | null {\n  const resourceConfig = registry.resourceConfigurations[operationPath.resourceIdentifier];\n  if (!resourceConfig) {\n    return null;\n  }\n\n  return resourceConfig.operations.find((op: any) => {\n    const opPath = ResourcesConfig_OperationPathUtils.extractOperationPath(op);\n\n    if (opPath.operationIdentifier !== operationPath.operationIdentifier) return false;\n    if (opPath.variantType !== operationPath.variantType) return false;\n\n    if (operationPath.isOperationDefault) {\n      if (!opPath.isOperationDefault) return false;\n    } else {\n      const expectedVariantKey = operationPath.variantKey;\n      const actualVariantKey = opPath.variantKey;\n      if ((actualVariantKey ?? undefined) !== (expectedVariantKey ?? undefined)) return false;\n    }\n\n    if (\n      opPath.variantType === ResourceOperationVariantType.API_CALL\n    ) {\n      const opIsBulk = opPath.isBulkOperation === true;\n      const pathIsBulk = operationPath.isBulkOperation === true;\n      return opIsBulk === pathIsBulk;\n    }\n\n    return true;\n  }) || null;\n}\n\n/**\n * Nested provider that re-exposes ResourceRegistryContext with a scoped `doOperation()`.\n *\n * This is intentionally placed INSIDE `AppScopeProvider` so it can inject the current scope\n * into all resource calls, while keeping the root `ResourceRegistryProvider` unchanged.\n */\nexport function ScopedResourceRegistryProvider({ children }: ScopedResourceRegistryProviderProps): React.ReactElement {\n  const base = useResourceRegistry();\n  const appScope = useAppScopeSafe();\n\n  const doOperation = useCallback<ResourceRegistryContextType['doOperation']>(\n    async (operationPath, parameters, options) => {\n      // If AppScopeProvider isn't mounted yet, behave exactly like the base registry.\n      if (!appScope) {\n        return base.doOperation(operationPath, parameters, options);\n      }\n\n      const operationPathKey = toOperationPathKey(operationPath as any);\n\n      // Parse target operation to decide which contextual params are relevant.\n      // If parsing fails for any reason, fall back to base behavior.\n      let parsedPath: ResourceConfiguration_OperationPath<any, any> | null = null;\n      try {\n        parsedPath = ResourcesConfig_OperationPathUtils.parseOperationPathKey(operationPathKey);\n      } catch {\n        parsedPath = null;\n      }\n\n      const operation = parsedPath ? findOperationInRegistry(base.registry, parsedPath) : null;\n\n      // If operation was not found in registry, fall back to unscoped behavior.\n      // This prevents fragile optional-chaining on initiatorInfos below.\n      if (!operation) {\n        return base.doOperation(operationPath, parameters, options);\n      }\n\n      const injectedScopeParams: Record<string, string | string[]> = appScope.buildContextualParameters();\n      const existingContextualParameters =\n        (parameters as any)?.contextualParameters as Record<string, string | string[]> | undefined;\n      const mergedContextualParameters = {\n        ...injectedScopeParams,\n        ...(existingContextualParameters || {}),\n      };\n\n      const mergedParameters = {\n        ...(parameters as any),\n        contextualParameters: mergedContextualParameters,\n      };\n\n      return base.doOperation(operationPath, mergedParameters, options);\n    },\n    [appScope, base]\n  );\n\n  /**\n   * IMPORTANT:\n   * `ResourceRegistryProvider`'s `evaluateOperationEnabled` closes over its own `doOperation`.\n   * If we only override `doOperation` in context, enabledCondition evaluation would still run with\n   * the unscoped doOperation (missing AppScope injection).\n   *\n   * So we override `evaluateOperationEnabled` as well, wiring it to the scoped `doOperation`.\n   */\n  const evaluateOperationEnabled = useCallback<ResourceRegistryContextType['evaluateOperationEnabled']>(\n    async (params) => {\n      return OperationEnabledConditionUtils.evaluateEnabledCondition({\n        ...(params as any),\n        resourcesRegistry: base.registry,\n        doOperation,\n      } satisfies EvaluateEnabledConditionParams<any>);\n    },\n    [base.registry, doOperation]\n  );\n\n  const value = useMemo<ResourceRegistryContextType>(() => {\n    return {\n      ...base,\n      doOperation,\n      evaluateOperationEnabled,\n    };\n  }, [base, doOperation, evaluateOperationEnabled]);\n\n  return (\n    <ResourceRegistryContext.Provider value={value}>\n      {children}\n    </ResourceRegistryContext.Provider>\n  );\n}\n\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"bulk-failure-grouping.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/bulk-failure-grouping.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAC;IACZ,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,yGAAyG;AACzG,eAAO,MAAM,+BAA+B,EAAG,gBAAyB,CAAC;AAEzE,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACvD,sBAAsB,EAAE,CAqB1B"}
+{"version":3,"file":"bulk-failure-grouping.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/bulk-failure-grouping.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAC;IACZ,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,yGAAyG;AACzG,eAAO,MAAM,+BAA+B,EAAG,gBAAyB,CAAC;AAEzE,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACvD,sBAAsB,EAAE,CAqB1B"}

package/dist/esm/core/resources/calendar-date-fields.frontend.utils.d.ts

@@ -0,0 +1,14 @@
+import type { z } from 'zod';
+/**
+ * The fields of a resource that hold a CALENDAR DAY (`isCalendarDate()`), read from its MAIN schema, where the
+ * declaration lives (#2180). A filter, a preset window, a chip or a day grouping over one of them works in days
+ * held as UTC midnight, not in the browser's instants.
+ *
+ * An inheritance resource's VARIANT-ONLY fields are included (a recurring todo's `startDate`), read from the
+ * variants of `inheritance` (#2455): a family's `mainSchema` is its base object since #2414, so the base alone
+ * never named them. A filter or a grouping on one reads the rows of that variant, and they hold calendar days like
+ * any other. A field any variant declares as a calendar day counts, which is right because one field name keeps one
+ * meaning across a resource's variants.
+ */
+export declare function calendarDateFieldNames(mainSchema: z.ZodTypeAny | undefined, inheritance?: unknown): ReadonlySet<string>;
+//# sourceMappingURL=calendar-date-fields.frontend.utils.d.ts.map

package/dist/esm/core/resources/calendar-date-fields.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-date-fields.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/calendar-date-fields.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAUvH"}

package/dist/esm/core/resources/calendar-date-fields.frontend.utils.js

@@ -0,0 +1,29 @@
+import { isCalendarDateSchema } from '@wildo-ai/zod-decorators';
+import { resourceInheritanceVariantSchemas } from '@wildo-ai/saas-models';
+import { AutomatedLayoutFrontendUtils } from '../../core/automated-layout/automated-layout.frontend.utils.js';
+const NONE = new Set();
+/**
+ * The fields of a resource that hold a CALENDAR DAY (`isCalendarDate()`), read from its MAIN schema, where the
+ * declaration lives (#2180). A filter, a preset window, a chip or a day grouping over one of them works in days
+ * held as UTC midnight, not in the browser's instants.
+ *
+ * An inheritance resource's VARIANT-ONLY fields are included (a recurring todo's `startDate`), read from the
+ * variants of `inheritance` (#2455): a family's `mainSchema` is its base object since #2414, so the base alone
+ * never named them. A filter or a grouping on one reads the rows of that variant, and they hold calendar days like
+ * any other. A field any variant declares as a calendar day counts, which is right because one field name keeps one
+ * meaning across a resource's variants.
+ */
+export function calendarDateFieldNames(mainSchema, inheritance) {
+    if (!mainSchema)
+        return NONE;
+    const names = new Set();
+    for (const rowSchema of [mainSchema, ...resourceInheritanceVariantSchemas(inheritance)]) {
+        const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(rowSchema, { commonOnly: false });
+        for (const [name, schema] of Object.entries(shape ?? {})) {
+            if (isCalendarDateSchema(schema))
+                names.add(name);
+        }
+    }
+    return names.size > 0 ? names : NONE;
+}
+//# sourceMappingURL=calendar-date-fields.frontend.utils.js.map

package/dist/esm/core/resources/calendar-date-fields.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-date-fields.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/calendar-date-fields.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,2EAA2E,CAAC;AAEzH,MAAM,IAAI,GAAwB,IAAI,GAAG,EAAE,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAoC,EAAE,WAAqB;IAChG,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,SAAS,IAAI,CAAC,UAAU,EAAE,GAAG,iCAAiC,CAAC,WAAoB,CAAC,CAAC,EAAE,CAAC;QACjG,MAAM,KAAK,GAAG,4BAA4B,CAAC,uBAAuB,CAAC,SAAyB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACrH,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YACzD,IAAI,oBAAoB,CAAC,MAAsB,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC","sourcesContent":["import type { z } from 'zod';\nimport { isCalendarDateSchema } from '@wildo-ai/zod-decorators';\nimport { resourceInheritanceVariantSchemas } from '@wildo-ai/saas-models';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\n\nconst NONE: ReadonlySet<string> = new Set();\n\n/**\n * The fields of a resource that hold a CALENDAR DAY (`isCalendarDate()`), read from its MAIN schema, where the\n * declaration lives (#2180). A filter, a preset window, a chip or a day grouping over one of them works in days\n * held as UTC midnight, not in the browser's instants.\n *\n * An inheritance resource's VARIANT-ONLY fields are included (a recurring todo's `startDate`), read from the\n * variants of `inheritance` (#2455): a family's `mainSchema` is its base object since #2414, so the base alone\n * never named them. A filter or a grouping on one reads the rows of that variant, and they hold calendar days like\n * any other. A field any variant declares as a calendar day counts, which is right because one field name keeps one\n * meaning across a resource's variants.\n */\nexport function calendarDateFieldNames(mainSchema: z.ZodTypeAny | undefined, inheritance?: unknown): ReadonlySet<string> {\n  if (!mainSchema) return NONE;\n  const names = new Set<string>();\n  for (const rowSchema of [mainSchema, ...resourceInheritanceVariantSchemas(inheritance as never)]) {\n    const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(rowSchema as z.ZodTypeAny, { commonOnly: false });\n    for (const [name, schema] of Object.entries(shape ?? {})) {\n      if (isCalendarDateSchema(schema as z.ZodTypeAny)) names.add(name);\n    }\n  }\n  return names.size > 0 ? names : NONE;\n}\n"]}

package/dist/esm/core/resources/caller-identity-record.frontend.utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Whether a resource's record IS the signed-in person's own account (#2324, #2541).
+ *
+ * Two declarations decide it, and both are needed:
+ * - the resource's primary key names the caller (`primaryKeyIdentifiesInitiator`);
+ * - its field identifier is the user's own (`userId`).
+ *
+ * That is `user_self`. It is never `users`, which shares the field identifier but declares that its key names ANY
+ * user (`primaryKeyIdentifiesInitiator: false`). A preferences or profile record is not it either: it has a field
+ * identifier of its own.
+ *
+ * Two readers: the Settings operation panel addresses that record with the caller's own user id, and the resources
+ * client re-validates the session after a write to it. Derived from configuration, never from a list of resources,
+ * so a second such resource is recognised without anyone remembering it.
+ *
+ * A registry built by hand (a host, a test double) may omit the field-identifier map. Then nothing is the caller's
+ * account.
+ */
+export declare function isCallerIdentityRecordResource(resourceConfig: {
+    primaryKeyIdentifiesInitiator?: boolean;
+    resourceFieldIdentifier?: string;
+} | undefined, allResourceFieldIdentifiers: Readonly<Record<string, string>> | undefined): boolean;
+//# sourceMappingURL=caller-identity-record.frontend.utils.d.ts.map

package/dist/esm/core/resources/caller-identity-record.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller-identity-record.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/caller-identity-record.frontend.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE;IAAE,6BAA6B,CAAC,EAAE,OAAO,CAAC;IAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACzG,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACxE,OAAO,CAKT"}

package/dist/esm/core/resources/caller-identity-record.frontend.utils.js

@@ -0,0 +1,26 @@
+import { CoreResourceType } from '@wildo-ai/saas-models';
+/**
+ * Whether a resource's record IS the signed-in person's own account (#2324, #2541).
+ *
+ * Two declarations decide it, and both are needed:
+ * - the resource's primary key names the caller (`primaryKeyIdentifiesInitiator`);
+ * - its field identifier is the user's own (`userId`).
+ *
+ * That is `user_self`. It is never `users`, which shares the field identifier but declares that its key names ANY
+ * user (`primaryKeyIdentifiesInitiator: false`). A preferences or profile record is not it either: it has a field
+ * identifier of its own.
+ *
+ * Two readers: the Settings operation panel addresses that record with the caller's own user id, and the resources
+ * client re-validates the session after a write to it. Derived from configuration, never from a list of resources,
+ * so a second such resource is recognised without anyone remembering it.
+ *
+ * A registry built by hand (a host, a test double) may omit the field-identifier map. Then nothing is the caller's
+ * account.
+ */
+export function isCallerIdentityRecordResource(resourceConfig, allResourceFieldIdentifiers) {
+    const userFieldIdentifier = allResourceFieldIdentifiers?.[CoreResourceType.USERS];
+    return resourceConfig?.primaryKeyIdentifiesInitiator === true
+        && userFieldIdentifier !== undefined
+        && resourceConfig.resourceFieldIdentifier === userFieldIdentifier;
+}
+//# sourceMappingURL=caller-identity-record.frontend.utils.js.map

package/dist/esm/core/resources/caller-identity-record.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller-identity-record.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/caller-identity-record.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,8BAA8B,CAC5C,cAAyG,EACzG,2BAAyE;IAEzE,MAAM,mBAAmB,GAAG,2BAA2B,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAClF,OAAO,cAAc,EAAE,6BAA6B,KAAK,IAAI;WACxD,mBAAmB,KAAK,SAAS;WACjC,cAAc,CAAC,uBAAuB,KAAK,mBAAmB,CAAC;AACtE,CAAC","sourcesContent":["import { CoreResourceType } from '@wildo-ai/saas-models';\n\n/**\n * Whether a resource's record IS the signed-in person's own account (#2324, #2541).\n *\n * Two declarations decide it, and both are needed:\n * - the resource's primary key names the caller (`primaryKeyIdentifiesInitiator`);\n * - its field identifier is the user's own (`userId`).\n *\n * That is `user_self`. It is never `users`, which shares the field identifier but declares that its key names ANY\n * user (`primaryKeyIdentifiesInitiator: false`). A preferences or profile record is not it either: it has a field\n * identifier of its own.\n *\n * Two readers: the Settings operation panel addresses that record with the caller's own user id, and the resources\n * client re-validates the session after a write to it. Derived from configuration, never from a list of resources,\n * so a second such resource is recognised without anyone remembering it.\n *\n * A registry built by hand (a host, a test double) may omit the field-identifier map. Then nothing is the caller's\n * account.\n */\nexport function isCallerIdentityRecordResource(\n  resourceConfig: { primaryKeyIdentifiesInitiator?: boolean; resourceFieldIdentifier?: string } | undefined,\n  allResourceFieldIdentifiers: Readonly<Record<string, string>> | undefined,\n): boolean {\n  const userFieldIdentifier = allResourceFieldIdentifiers?.[CoreResourceType.USERS];\n  return resourceConfig?.primaryKeyIdentifiesInitiator === true\n    && userFieldIdentifier !== undefined\n    && resourceConfig.resourceFieldIdentifier === userFieldIdentifier;\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,OAAO,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,GAAG,IAAI,CA8C9F;AA0BD;;;;;;;;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;AAGpI,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,OAAO,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,GAAG,IAAI,CA8C9F;AA0BD;;;;;;;;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,CAMhB"}

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

@@ -12,6 +12,7 @@
 import { buildCollectionExportFilename, COLLECTION_EXPORT_FORMAT_QUERY_PARAM, COLLECTION_EXPORT_ROW_SCOPE_QUERY_PARAM, MAIN_API_BASE_PATH, ResourcesConfigOperationsUrlsBuilderUtils, } from '@wildo-ai/saas-models';
 import { NavigationUtils } from '../../core/navigation/navigation.utils.js';
 import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
+import { saveBlobAsFile } from '../../core/commons/save-blob-as-file.frontend.utils.js';
 /**
  * `null` when the route cannot be fully resolved from the current context — the caller then hides
  * the action rather than offering a download that would 404. Deliberately the same posture the file
@@ -88,20 +89,9 @@ function appendListingQueryValue(query, key, value) {
  */
 export async function downloadCollectionExport(params) {
     const blob = await params.getBlob(params.url);
-    const objectUrl = URL.createObjectURL(blob);
-    try {
-        const link = document.createElement('a');
-        link.href = objectUrl;
-        // The server already names the file in `Content-Disposition`, but a blob download does not see
-        // that header — the name has to be supplied here. Same builder as the server's, so the two
-        // agree instead of drifting.
-        link.download = buildCollectionExportFilename(String(params.resourceType), params.format, new Date());
-        document.body.appendChild(link);
-        link.click();
-        link.remove();
-    }
-    finally {
-        URL.revokeObjectURL(objectUrl);
-    }
+    // The server already names the file in `Content-Disposition`, but a blob download does not see
+    // that header — the name has to be supplied here. Same builder as the server's, so the two
+    // agree instead of drifting.
+    saveBlobAsFile(blob, buildCollectionExportFilename(String(params.resourceType), params.format, new Date()));
 }
 //# sourceMappingURL=collection-export-url.frontend.utils.js.map

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":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,EACpC,uCAAuC,EACvC,kBAAkB,EAClB,yCAAyC,GAI1C,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAsCnG;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAsC;IAC7E,MAAM,EACJ,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EACvD,0BAA0B,EAAE,oBAAoB,EAAE,2BAA2B,EAC7E,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAC3C,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC,cAAc,EAAE,uBAAuB,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAE9E,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,yCAAyC,CAAC,gCAAgC,CAC3F,cAAc,EACd,eAAe,EACf,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,EAC3B,QAAQ,CAAC,2BAA2B,CACrC,CAAC;QAEF,qFAAqF;QACrF,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACrF,IAAI,eAAe,CAAC,yBAAyB,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAErE,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,KAAK,CAAC,GAAG,CAAC,oCAAoC,EAAE,MAAM,CAAC,CAAC;QACxD,KAAK,CAAC,GAAG,CAAC,uCAAuC,EAAE,QAAQ,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;gBAAE,SAAS;YAClD,0FAA0F;YAC1F,gDAAgD;YAChD,IAAI,GAAG,KAAK,oCAAoC,IAAI,GAAG,KAAK,uCAAuC;gBAAE,SAAS;YAC9G,uBAAuB,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QAED,wFAAwF;QACxF,OAAO,GAAG,UAAU,GAAG,kBAAkB,GAAG,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,KAAsB,EAAE,GAAW,EAAE,KAAc;IAClF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO;IAClE,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACzC,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,+GAA+G;QAC/G,gBAAgB;QAChB,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;YAAE,uBAAuB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,MAAM,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAK9C;IACC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,+FAA+F;QAC/F,2FAA2F;QAC3F,6BAA6B;QAC7B,IAAI,CAAC,QAAQ,GAAG,6BAA6B,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACtG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;AACH,CAAC","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, unknown>;\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      appendListingQueryValue(query, key, 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 * Write one listing-query value the way the list request itself writes it, so an export narrowed by a filter returns the\n * rows the list showed.\n *\n * The list sends its filters through the http client, which encodes a structured value in bracket notation: a date window\n * `{ startDate, endDate }` becomes `dueDate[startDate]=<ISO>&dueDate[endDate]=<ISO>`, a number range `cost[min]=…`, and\n * the controller rebuilds those keys. `String(value)` on the same object sends `dueDate=[object Object]`, so the export\n * silently ignored every date and number range. A `Date` travels as its ISO instant.\n */\nfunction appendListingQueryValue(query: URLSearchParams, key: string, value: unknown): void {\n  if (value === undefined || value === null || value === '') return;\n  if (value instanceof Date) {\n    query.append(key, value.toISOString());\n  } else if (Array.isArray(value)) {\n    // Unchanged from before: this function only fixes the OBJECT case, and a multi-value filter's wire form is not\n    // decided here.\n    query.append(key, String(value));\n  } else if (typeof value === 'object') {\n    for (const [subKey, subValue] of Object.entries(value as Record<string, unknown>)) appendListingQueryValue(query, `${key}[${subKey}]`, subValue);\n  } else {\n    query.append(key, String(value));\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';\nimport { saveBlobAsFile } from '~wildo-frontend-lib/core/commons/save-blob-as-file.frontend.utils';\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, unknown>;\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      appendListingQueryValue(query, key, 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 * Write one listing-query value the way the list request itself writes it, so an export narrowed by a filter returns the\n * rows the list showed.\n *\n * The list sends its filters through the http client, which encodes a structured value in bracket notation: a date window\n * `{ startDate, endDate }` becomes `dueDate[startDate]=<ISO>&dueDate[endDate]=<ISO>`, a number range `cost[min]=…`, and\n * the controller rebuilds those keys. `String(value)` on the same object sends `dueDate=[object Object]`, so the export\n * silently ignored every date and number range. A `Date` travels as its ISO instant.\n */\nfunction appendListingQueryValue(query: URLSearchParams, key: string, value: unknown): void {\n  if (value === undefined || value === null || value === '') return;\n  if (value instanceof Date) {\n    query.append(key, value.toISOString());\n  } else if (Array.isArray(value)) {\n    // Unchanged from before: this function only fixes the OBJECT case, and a multi-value filter's wire form is not\n    // decided here.\n    query.append(key, String(value));\n  } else if (typeof value === 'object') {\n    for (const [subKey, subValue] of Object.entries(value as Record<string, unknown>)) appendListingQueryValue(query, `${key}[${subKey}]`, subValue);\n  } else {\n    query.append(key, String(value));\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  // 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  saveBlobAsFile(blob, buildCollectionExportFilename(String(params.resourceType), params.format, new Date()));\n}\n"]}

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

@@ -3,7 +3,7 @@
  *
  * 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
+ * `(preset, currentFilters, resolution)`, 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
@@ -11,39 +11,53 @@
  * `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.
  *
- * The VIEWER is a parameter for the same reason (#2511): a context value ("assigned to me") is resolved from who is
- * looking, and a preset that names one cannot be applied for a viewer it cannot be resolved for.
+ * The VIEWER is part of the resolution for the same reason (#2511): a context value ("assigned to me") is resolved
+ * from who is looking, and a preset that names one cannot be applied for a viewer it cannot be resolved for.
  */
 import { type CollectionFilterPreset } from '../../core/resources/resources.frontend.schemas';
-/**
- * The `{ startDate?, endDate? }` pair the framework's date-range filter carries. Either bound may be open: "overdue" has
- * no start (#2511), and the filter treats an absent bound as unbounded on both adapters.
- */
-export interface CollectionFilterDateRange {
-    startDate?: Date;
-    endDate?: Date;
-}
 /** Who is looking at the list: what a context value is resolved from. */
 export interface CollectionFilterPresetViewer {
     /** The signed-in user's id, or absent when nobody is signed in. */
     readonly userId?: string;
 }
 /**
- * The CONCRETE filter assignment a preset makes at instant `now` for `viewer` — literals unchanged, relative ranges
- * resolved to their window, context values resolved from the viewer. `null` when a context value cannot be resolved
- * for this viewer: the preset is then unavailable, never applied without that field.
+ * What a preset is resolved against: one instant, the reader's zone, which fields hold a calendar day, and who is
+ * looking.
+ *
+ * All four are REQUIRED. Each one changes the assignment, and each defaulted silently to the wrong answer before
+ * (#2180 review, #2511 merge): the browser's zone instead of the reader's, an instant window over a calendar-day
+ * field, and a chips row that resolved "Mine" for nobody and so never saw its pill as on.
+ */
+export interface CollectionFilterPresetResolution {
+    /** The instant every relative range in one click is resolved against. */
+    now: Date;
+    /** The reader's resolved time zone (member, then organization, then floor). `undefined` falls back to the browser's. */
+    timeZone: string | undefined;
+    /** The fields declaring a calendar day (`isCalendarDate()`); see `calendarDateFieldNames`. */
+    calendarDateFields: ReadonlySet<string>;
+    /** The signed-in viewer, `{}` when nobody is signed in; see `useCollectionFilterPresetScope`. */
+    viewer: CollectionFilterPresetViewer;
+}
+/**
+ * The CONCRETE filter assignment a preset makes — literals unchanged, relative ranges resolved to their
+ * `{ startDate?, endDate? }` window for that field, context values resolved from the viewer. `null` when a context
+ * value cannot be resolved for this viewer: the preset is then unavailable, never applied without that field.
  */
-export declare function resolveCollectionFilterPresetAssignment(preset: CollectionFilterPreset, now: Date, viewer?: CollectionFilterPresetViewer): Record<string, unknown> | null;
-/** Whether this viewer can apply the preset at all: every context value it names resolves for them. */
-export declare function isCollectionFilterPresetAvailable(preset: CollectionFilterPreset, viewer?: CollectionFilterPresetViewer): boolean;
+export declare function resolveCollectionFilterPresetAssignment(preset: CollectionFilterPreset, resolution: CollectionFilterPresetResolution): Record<string, unknown> | null;
+/**
+ * Whether this viewer can apply the preset at all: every context value it names resolves for them. Only the context
+ * values decide it, so it needs no instant, zone or field declarations.
+ */
+export declare function isCollectionFilterPresetAvailable(preset: CollectionFilterPreset, viewer: CollectionFilterPresetViewer): boolean;
 /**
  * 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.
+ * names, and showing it as on would make the next click REMOVE a filter the user set by hand. A
+ * preset unavailable to this viewer is never on.
  */
-export declare function isCollectionFilterPresetActive(preset: CollectionFilterPreset, currentFilters: Record<string, unknown>, now: Date, viewer?: CollectionFilterPresetViewer): boolean;
+export declare function isCollectionFilterPresetActive(preset: CollectionFilterPreset, currentFilters: Record<string, unknown>, resolution: CollectionFilterPresetResolution): boolean;
 /**
  * The filter values after clicking this preset — applied when it was off, removed when it was on.
  *
@@ -51,5 +65,20 @@ export declare function isCollectionFilterPresetActive(preset: CollectionFilterP
  * 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, viewer?: CollectionFilterPresetViewer): Record<string, unknown>;
+export declare function toggleCollectionFilterPreset(preset: CollectionFilterPreset, currentFilters: Record<string, unknown>, resolution: CollectionFilterPresetResolution): Record<string, unknown>;
+/**
+ * The filter fields an ACTIVE preset is already showing — so the chips row does not show them again.
+ *
+ * A pressed pill IS the readout of the narrowing it names: "Touched this week" lit up says what is
+ * filtering the list, in the words the application chose for it. Rendering a chip for the same field
+ * beside it stated one fact twice, and in the weaker form — the chip can only show the field label and
+ * a resolved window ("Updated: 24 Sep – 30 Sep"), never the preset's own name. It is the same rule the
+ * promoted quick-filter field already follows: one control owns each field's active-state display.
+ *
+ * Only a preset that is ON contributes (see {@link isCollectionFilterPresetActive}), so a value the
+ * user set by hand that no preset names — or that only half-matches one — keeps its chip, and an
+ * active filter is never left invisible. That is why the resolution carries the viewer: without it a
+ * "Mine" preset reads as off here while its pill is pressed, and the chip comes back.
+ */
+export declare function collectionFilterFieldsShownByActivePresets(presets: readonly CollectionFilterPreset[], currentFilters: Record<string, unknown>, resolution: CollectionFilterPresetResolution): ReadonlySet<string>;
 //# sourceMappingURL=collection-filter-presets.frontend.utils.d.ts.map

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

@@ -1 +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;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,+DAA+D,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,yEAAyE;AACzE,MAAM,WAAW,4BAA4B;IAC3C,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAoGD;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,IAAI,EACT,MAAM,GAAE,4BAAiC,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAchC;AAED,uGAAuG;AACvG,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,sBAAsB,EAAE,MAAM,GAAE,4BAAiC,GAAG,OAAO,CAEpI;AA2CD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,GAAG,EAAE,IAAI,EACT,MAAM,GAAE,4BAAiC,GACxC,OAAO,CAMT;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,GAAG,EAAE,IAAI,EACT,MAAM,GAAE,4BAAiC,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}
+{"version":3,"file":"collection-filter-presets.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/collection-filter-presets.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,+DAA+D,CAAC;AAQvE,yEAAyE;AACzE,MAAM,WAAW,4BAA4B;IAC3C,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gCAAgC;IAC/C,yEAAyE;IACzE,GAAG,EAAE,IAAI,CAAC;IACV,wHAAwH;IACxH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8FAA8F;IAC9F,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,iGAAiG;IACjG,MAAM,EAAE,4BAA4B,CAAC;CACtC;AAyED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,gCAAgC,GAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgBhC;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAI/H;AA8CD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,UAAU,EAAE,gCAAgC,GAC3C,OAAO,CAMT;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,UAAU,EAAE,gCAAgC,GAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,SAAS,sBAAsB,EAAE,EAC1C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,UAAU,EAAE,gCAAgC,GAC3C,WAAW,CAAC,MAAM,CAAC,CAOrB"}