@wildo-ai/saas-models 1.1.4 → 1.1.6

package/dist/esm/users/user-identity-links.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-identity-links.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/users/user-identity-links.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,2DAA2D,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CACxD,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAW/D,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;kBAmJjC,CAAC;AAGH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"user-identity-links.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/users/user-identity-links.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,2DAA2D,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CACxD,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAW/D,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;kBAqLjC,CAAC;AAGH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/esm/users/user-identity-links.shared.schemas.js

@@ -65,6 +65,36 @@ export const UserIdentityLinkSchema = z.object({
     // exactly why it must be scrubbed: an unclassifiable blob is not an empty one.
     providerRawProfile: addImpersonalizeWith(z.record(z.string(), z.unknown()).optional().isBackendOnly(), RedactionType.REMOVE)
         .dataCategories([PersonalDataCategory.IDENTITY, PersonalDataCategory.USER_CONTENT]),
+    /**
+     * The DIRECTORY's own identifier for this person, as SCIM `externalId` — and deliberately NOT
+     * {@link UserIdentityLinkSchema.shape.providerUserId}.
+     *
+     * ## Why it cannot share a column with `providerUserId`
+     *
+     * `providerUserId` is the AUTHENTICATION KEY. `createIdentityLink` resolves an existing link by it
+     * (with `providerRef`, `connectionType` and the scope) and refuses with
+     * `enterprise_identity_already_linked_to_another_user` when it points at somebody else. It is also
+     * part of this resource's business key.
+     *
+     * SCIM `externalId` is not that. RFC 7643 §3.1 makes it the CLIENT's identifier, which the service
+     * provider stores; the provider's own identifier is `id`. Microsoft Entra maps it from
+     * `[mailNickname]` by default — a mutable handle — so writing it into `providerUserId` would
+     * re-key a live SSO identity from an attribute an administrator can change in the directory. The
+     * next sign-in asserting the original subject would find no link.
+     *
+     * ## What it was before (#1402)
+     *
+     * `SCIM_USER_ATTRIBUTE_MAP` mapped `externalId` → `providerUserId`, and the SCIM PATCH/PUT path
+     * folded it into the profile update bag — which writes `USER_PROFILES`, a resource that does not
+     * own the field. It was stripped by the strict re-parse and the directory was told `200`. Measured
+     * against a live Entra tenant on 2026-09-21: it reported updating `externalId` for two users, and
+     * neither value was stored, so it re-sent the same update on every cycle.
+     *
+     * Optional because only a directory sets it: a social or interactive SSO link has none. Not
+     * indexed and not part of any key — it is a value to hand back, not to resolve by; resolving by it
+     * is what the whole comment above exists to prevent.
+     */
+    scimExternalId: addImpersonalizeWith(z.string().optional().dataCategories(PersonalDataCategory.IDENTITY), RedactionType.REMOVE),
     /** Enterprise tenant kind. Absent for social links. */
     scopeType: z.enum(AuthScopeType).optional().isDBIndexed(),
     /** Organization tenant identifier. Present only for organization-scoped enterprise links. */

package/dist/esm/users/user-identity-links.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-identity-links.shared.schemas.js","sourceRoot":"","sources":["../../../../src/users/user-identity-links.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * User Identity Links Schema\n *\n * Tracks OAuth2/SSO provider connections per user.\n * A user can have multiple identity links (e.g., Google social + Microsoft enterprise).\n *\n * Canonical identity key: connection type + provider + provider user + exact enterprise\n * scope/connection coordinates. The database compound unique index prevents the same\n * external identity from being bound to two Wildo users inside one tenant connection.\n */\n\nimport { z } from 'zod';\nimport { addImpersonalizeWith } from '@wildo-ai/zod-decorators';\nimport { RedactionType } from '../compliance/privacy/redaction.shared.schemas';\nimport { ERASED_USER_EMAIL, ERASED_IDENTITY_VALUE } from './users.shared.schemas';\nimport { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport {\n  AuthScopeType,\n  ExternalIdentitySource,\n  SsoConnectionType,\n} from '../security/authentications/authentication.shared.schemas';\n\n/**\n * Valid provenance mechanisms for each connection ownership class.\n *\n * OAuth2 is social-only; SAML and SCIM are enterprise-only; OIDC legitimately\n * spans both. Keeping this relationship beside the persisted link schema makes\n * invalid cross-products impossible at every repository boundary.\n */\nexport const IDENTITY_SOURCES_BY_CONNECTION_TYPE: Readonly<\n  Record<SsoConnectionType, ReadonlySet<ExternalIdentitySource>>\n> = {\n  [SsoConnectionType.SOCIAL]: new Set([\n    ExternalIdentitySource.OAUTH2,\n    ExternalIdentitySource.OIDC,\n  ]),\n  [SsoConnectionType.ENTERPRISE]: new Set([\n    ExternalIdentitySource.OIDC,\n    ExternalIdentitySource.SAML,\n    ExternalIdentitySource.SCIM,\n  ]),\n};\n\nexport const UserIdentityLinkSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  /** FK → USERS — the user who owns this identity link */\n  userId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n\n  /** Distinguishes social vs enterprise links */\n  connectionType: z.enum(SsoConnectionType).isDBIndexed().isSummaryField(),\n\n  /** Matches external connector ref (e.g., \"google\", \"microsoft\", \"github\", \"oidc\") */\n  providerRef: z.string().min(1).isDBIndexed().isSummaryField(),\n\n  /** The user's ID at the IdP */\n  // MASK, not REMOVE: `min(1)` and part of the compound business key, so a null fails the re-parse.\n  // Two erased links for one connection would share this masked value — which is safe because a\n  // declared retention policy makes the planner emit that unique index RETENTION-SCOPED, so retained\n  // rows fall outside the constraint. Confirmed in the generated migration, not assumed.\n  providerUserId: addImpersonalizeWith(\n    z.string().min(1).isDBIndexed().dataCategories(PersonalDataCategory.IDENTITY),\n    RedactionType.MASK,\n    { maskValue: ERASED_IDENTITY_VALUE },\n  ),\n\n  /** Email from the IdP */\n  providerEmail: addImpersonalizeWith(\n    z.string().isDBIndexed().dataCategories(PersonalDataCategory.CONTACT_DETAILS),\n    RedactionType.MASK,\n    { maskValue: ERASED_USER_EMAIL },\n  ),\n\n  /** Display name from IdP */\n  providerDisplayName: addImpersonalizeWith(\n    z.string().optional().dataCategories(PersonalDataCategory.IDENTITY),\n    RedactionType.REMOVE,\n  ),\n\n  /** Avatar URL from IdP */\n  providerAvatarUrl: addImpersonalizeWith(\n    z.string().optional().dataCategories(PersonalDataCategory.IDENTITY),\n    RedactionType.REMOVE,\n  ),\n\n  /**\n   * Raw claims from the IdP for debugging — backend only.\n   *\n   * The one field on this resource whose contents the framework does not control: an IdP may put\n   * anything in a claim set, including a special category. IDENTITY + USER_CONTENT is what the field\n   * is FOR; it is not a certification of what a given IdP will send. An application whose IdP is\n   * known to emit a special-category claim should say so on its own copy.\n   */\n  // The provider's own payload about the person, unbounded in shape — whatever that provider chose\n  // to send. It carries no `dataCategories` because nothing can classify it in advance, which is\n  // exactly why it must be scrubbed: an unclassifiable blob is not an empty one.\n  providerRawProfile: addImpersonalizeWith(\n    z.record(z.string(), z.unknown()).optional().isBackendOnly(),\n    RedactionType.REMOVE,\n  )\n    .dataCategories([PersonalDataCategory.IDENTITY, PersonalDataCategory.USER_CONTENT]),\n\n  /** Enterprise tenant kind. Absent for social links. */\n  scopeType: z.enum(AuthScopeType).optional().isDBIndexed(),\n\n  /** Organization tenant identifier. Present only for organization-scoped enterprise links. */\n  organizationId: z.string().optional().isForeignKey(),\n\n  /** Application tenant identifier. Present only for application-scoped enterprise links. */\n  applicationId: z.string().optional().isForeignKey(),\n\n  /** Enterprise connection identifier within the owning scope. */\n  connectionId: z.string().optional(),\n\n  /** Authentication source that created this link. */\n  source: z.enum(ExternalIdentitySource),\n\n  /** When this identity link was created */\n  linkedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n\n  /** Last time this identity link was used for authentication */\n  lastUsedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n}).businessKeySet([\n  'connectionType',\n  'providerRef',\n  'providerUserId',\n  'scopeType',\n  'organizationId',\n  'applicationId',\n  'connectionId',\n]).superRefine((link, ctx) => {\n  if (!IDENTITY_SOURCES_BY_CONNECTION_TYPE[link.connectionType].has(link.source)) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['source'],\n      message: `Identity source ${link.source} is incompatible with ${link.connectionType} connections`,\n    });\n  }\n\n  if (link.connectionType === SsoConnectionType.SOCIAL) {\n    if (\n      link.scopeType !== undefined\n      || link.organizationId !== undefined\n      || link.applicationId !== undefined\n      || link.connectionId !== undefined\n    ) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['scopeType'],\n        message: 'Social identity links must not carry enterprise scope fields',\n      });\n    }\n    return;\n  }\n\n  if (!link.connectionId) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['connectionId'],\n      message: 'Enterprise identity links require connectionId',\n    });\n  }\n\n  if (link.scopeType === AuthScopeType.ORGANIZATION) {\n    if (!link.organizationId || link.applicationId !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['organizationId'],\n        message: 'Organization-scoped identity links require only organizationId',\n      });\n    }\n    return;\n  }\n\n  if (link.scopeType === AuthScopeType.APPLICATION) {\n    if (!link.applicationId || link.organizationId !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['applicationId'],\n        message: 'Application-scoped identity links require only applicationId',\n      });\n    }\n    return;\n  }\n\n  ctx.addIssue({\n    code: 'custom',\n    path: ['scopeType'],\n    message: 'Enterprise identity links require an explicit scopeType',\n  });\n});\n\n\nexport type UserIdentityLink = z.infer<typeof UserIdentityLinkSchema>;\n"]}
+{"version":3,"file":"user-identity-links.shared.schemas.js","sourceRoot":"","sources":["../../../../src/users/user-identity-links.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * User Identity Links Schema\n *\n * Tracks OAuth2/SSO provider connections per user.\n * A user can have multiple identity links (e.g., Google social + Microsoft enterprise).\n *\n * Canonical identity key: connection type + provider + provider user + exact enterprise\n * scope/connection coordinates. The database compound unique index prevents the same\n * external identity from being bound to two Wildo users inside one tenant connection.\n */\n\nimport { z } from 'zod';\nimport { addImpersonalizeWith } from '@wildo-ai/zod-decorators';\nimport { RedactionType } from '../compliance/privacy/redaction.shared.schemas';\nimport { ERASED_USER_EMAIL, ERASED_IDENTITY_VALUE } from './users.shared.schemas';\nimport { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport {\n  AuthScopeType,\n  ExternalIdentitySource,\n  SsoConnectionType,\n} from '../security/authentications/authentication.shared.schemas';\n\n/**\n * Valid provenance mechanisms for each connection ownership class.\n *\n * OAuth2 is social-only; SAML and SCIM are enterprise-only; OIDC legitimately\n * spans both. Keeping this relationship beside the persisted link schema makes\n * invalid cross-products impossible at every repository boundary.\n */\nexport const IDENTITY_SOURCES_BY_CONNECTION_TYPE: Readonly<\n  Record<SsoConnectionType, ReadonlySet<ExternalIdentitySource>>\n> = {\n  [SsoConnectionType.SOCIAL]: new Set([\n    ExternalIdentitySource.OAUTH2,\n    ExternalIdentitySource.OIDC,\n  ]),\n  [SsoConnectionType.ENTERPRISE]: new Set([\n    ExternalIdentitySource.OIDC,\n    ExternalIdentitySource.SAML,\n    ExternalIdentitySource.SCIM,\n  ]),\n};\n\nexport const UserIdentityLinkSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  /** FK → USERS — the user who owns this identity link */\n  userId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n\n  /** Distinguishes social vs enterprise links */\n  connectionType: z.enum(SsoConnectionType).isDBIndexed().isSummaryField(),\n\n  /** Matches external connector ref (e.g., \"google\", \"microsoft\", \"github\", \"oidc\") */\n  providerRef: z.string().min(1).isDBIndexed().isSummaryField(),\n\n  /** The user's ID at the IdP */\n  // MASK, not REMOVE: `min(1)` and part of the compound business key, so a null fails the re-parse.\n  // Two erased links for one connection would share this masked value — which is safe because a\n  // declared retention policy makes the planner emit that unique index RETENTION-SCOPED, so retained\n  // rows fall outside the constraint. Confirmed in the generated migration, not assumed.\n  providerUserId: addImpersonalizeWith(\n    z.string().min(1).isDBIndexed().dataCategories(PersonalDataCategory.IDENTITY),\n    RedactionType.MASK,\n    { maskValue: ERASED_IDENTITY_VALUE },\n  ),\n\n  /** Email from the IdP */\n  providerEmail: addImpersonalizeWith(\n    z.string().isDBIndexed().dataCategories(PersonalDataCategory.CONTACT_DETAILS),\n    RedactionType.MASK,\n    { maskValue: ERASED_USER_EMAIL },\n  ),\n\n  /** Display name from IdP */\n  providerDisplayName: addImpersonalizeWith(\n    z.string().optional().dataCategories(PersonalDataCategory.IDENTITY),\n    RedactionType.REMOVE,\n  ),\n\n  /** Avatar URL from IdP */\n  providerAvatarUrl: addImpersonalizeWith(\n    z.string().optional().dataCategories(PersonalDataCategory.IDENTITY),\n    RedactionType.REMOVE,\n  ),\n\n  /**\n   * Raw claims from the IdP for debugging — backend only.\n   *\n   * The one field on this resource whose contents the framework does not control: an IdP may put\n   * anything in a claim set, including a special category. IDENTITY + USER_CONTENT is what the field\n   * is FOR; it is not a certification of what a given IdP will send. An application whose IdP is\n   * known to emit a special-category claim should say so on its own copy.\n   */\n  // The provider's own payload about the person, unbounded in shape — whatever that provider chose\n  // to send. It carries no `dataCategories` because nothing can classify it in advance, which is\n  // exactly why it must be scrubbed: an unclassifiable blob is not an empty one.\n  providerRawProfile: addImpersonalizeWith(\n    z.record(z.string(), z.unknown()).optional().isBackendOnly(),\n    RedactionType.REMOVE,\n  )\n    .dataCategories([PersonalDataCategory.IDENTITY, PersonalDataCategory.USER_CONTENT]),\n\n  /**\n   * The DIRECTORY's own identifier for this person, as SCIM `externalId` — and deliberately NOT\n   * {@link UserIdentityLinkSchema.shape.providerUserId}.\n   *\n   * ## Why it cannot share a column with `providerUserId`\n   *\n   * `providerUserId` is the AUTHENTICATION KEY. `createIdentityLink` resolves an existing link by it\n   * (with `providerRef`, `connectionType` and the scope) and refuses with\n   * `enterprise_identity_already_linked_to_another_user` when it points at somebody else. It is also\n   * part of this resource's business key.\n   *\n   * SCIM `externalId` is not that. RFC 7643 §3.1 makes it the CLIENT's identifier, which the service\n   * provider stores; the provider's own identifier is `id`. Microsoft Entra maps it from\n   * `[mailNickname]` by default — a mutable handle — so writing it into `providerUserId` would\n   * re-key a live SSO identity from an attribute an administrator can change in the directory. The\n   * next sign-in asserting the original subject would find no link.\n   *\n   * ## What it was before (#1402)\n   *\n   * `SCIM_USER_ATTRIBUTE_MAP` mapped `externalId` → `providerUserId`, and the SCIM PATCH/PUT path\n   * folded it into the profile update bag — which writes `USER_PROFILES`, a resource that does not\n   * own the field. It was stripped by the strict re-parse and the directory was told `200`. Measured\n   * against a live Entra tenant on 2026-09-21: it reported updating `externalId` for two users, and\n   * neither value was stored, so it re-sent the same update on every cycle.\n   *\n   * Optional because only a directory sets it: a social or interactive SSO link has none. Not\n   * indexed and not part of any key — it is a value to hand back, not to resolve by; resolving by it\n   * is what the whole comment above exists to prevent.\n   */\n  scimExternalId: addImpersonalizeWith(\n    z.string().optional().dataCategories(PersonalDataCategory.IDENTITY),\n    RedactionType.REMOVE,\n  ),\n\n  /** Enterprise tenant kind. Absent for social links. */\n  scopeType: z.enum(AuthScopeType).optional().isDBIndexed(),\n\n  /** Organization tenant identifier. Present only for organization-scoped enterprise links. */\n  organizationId: z.string().optional().isForeignKey(),\n\n  /** Application tenant identifier. Present only for application-scoped enterprise links. */\n  applicationId: z.string().optional().isForeignKey(),\n\n  /** Enterprise connection identifier within the owning scope. */\n  connectionId: z.string().optional(),\n\n  /** Authentication source that created this link. */\n  source: z.enum(ExternalIdentitySource),\n\n  /** When this identity link was created */\n  linkedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n\n  /** Last time this identity link was used for authentication */\n  lastUsedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n}).businessKeySet([\n  'connectionType',\n  'providerRef',\n  'providerUserId',\n  'scopeType',\n  'organizationId',\n  'applicationId',\n  'connectionId',\n]).superRefine((link, ctx) => {\n  if (!IDENTITY_SOURCES_BY_CONNECTION_TYPE[link.connectionType].has(link.source)) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['source'],\n      message: `Identity source ${link.source} is incompatible with ${link.connectionType} connections`,\n    });\n  }\n\n  if (link.connectionType === SsoConnectionType.SOCIAL) {\n    if (\n      link.scopeType !== undefined\n      || link.organizationId !== undefined\n      || link.applicationId !== undefined\n      || link.connectionId !== undefined\n    ) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['scopeType'],\n        message: 'Social identity links must not carry enterprise scope fields',\n      });\n    }\n    return;\n  }\n\n  if (!link.connectionId) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['connectionId'],\n      message: 'Enterprise identity links require connectionId',\n    });\n  }\n\n  if (link.scopeType === AuthScopeType.ORGANIZATION) {\n    if (!link.organizationId || link.applicationId !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['organizationId'],\n        message: 'Organization-scoped identity links require only organizationId',\n      });\n    }\n    return;\n  }\n\n  if (link.scopeType === AuthScopeType.APPLICATION) {\n    if (!link.applicationId || link.organizationId !== undefined) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['applicationId'],\n        message: 'Application-scoped identity links require only applicationId',\n      });\n    }\n    return;\n  }\n\n  ctx.addIssue({\n    code: 'custom',\n    path: ['scopeType'],\n    message: 'Enterprise identity links require an explicit scopeType',\n  });\n});\n\n\nexport type UserIdentityLink = z.infer<typeof UserIdentityLinkSchema>;\n"]}

package/dist/esm/users/user-preferences-reset.shared.utils.d.ts

@@ -16,7 +16,7 @@
  * the write against that same DTO, and Mongoose drops every non-schema path. A request naming
  * no schema path therefore produced an empty `$set`: the route answered HTTP 200 having reset
  * nothing. That is the class of defect catalogued in
- * `.claude/plans/routed-unimplemented-operations-fail-closed.md`.
+ * the 2026-08-01 routed-but-unimplemented operation sweep (#1275).
  *
  * ## How the reset reaches the database now
  *
@@ -61,18 +61,18 @@ export type UserPreferencesResetRequest = z.infer<typeof UserPreferencesResetReq
  * unnamed block is left exactly as it was.
  *
  * assurance-control: WILDO.PRIVACY.CONSENT_RECORD — resetting {@link UserPreferenceGroup.PRIVACY}
- * returns `dataProcessingConsent` to its default, which IS a consent decision. It leaves a trail
+ * returns `consentedPurposes` to the empty set and clears `consentDecidedAt`, which IS a consent
+ * decision — a withdrawal of everything, after which a consent surface asks again. It leaves a trail
  * naming the previous and resulting value: the operation is CRITICAL, so it sits above the
  * framework's automatic audit floor and emits `resource_operation_performed`, and
- * `dataProcessingConsent` / `privacyLevel` carry `.isAuditEvidence()` so their VALUES ride on that
- * record. Governed-document receipts are neither preference members nor resettable values.
+ * `consentedPurposes` carries `.isAuditEvidence()` so its VALUES ride on that record. Governed-document receipts are neither preference members nor resettable values.
  *
  * @param request - the parsed request body. Re-parse `inputDto` through
  *   {@link UserPreferencesResetRequestSchema} at the call site rather than casting it: the
  *   prefix hook types `inputDto` as the resource's main schema, while the runtime value is the
  *   operation's request DTO.
- * @param currentPreferences - the row being reset, needed by blocks whose reset is not a pure
- *   default (today: privacy, whose consent receipts are carried through).
+ * @param currentPreferences - the row being reset, supplied to each block factory. Current
+ *   factories return schema defaults; governed-document receipts live outside this resource.
  */
 export declare function buildUserPreferencesResetPatch(request: UserPreferencesResetRequest, currentPreferences: UserPreferences | undefined): Partial<UserPreferences>;
 //# sourceMappingURL=user-preferences-reset.shared.utils.d.ts.map

package/dist/esm/users/user-preferences-reset.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-preferences-reset.shared.utils.d.ts","sourceRoot":"","sources":["../../../src/users/user-preferences-reset.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,eAAe,EAKhB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iCAAiC;;iBAE5C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AA2B5F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,2BAA2B,EACpC,kBAAkB,EAAE,eAAe,GAAG,SAAS,GAC9C,OAAO,CAAC,eAAe,CAAC,CAU1B"}
+{"version":3,"file":"user-preferences-reset.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/users/user-preferences-reset.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,mBAAmB,EACnB,eAAe,EAKhB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iCAAiC;;iBAE5C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AA2B5F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,2BAA2B,EACpC,kBAAkB,EAAE,eAAe,GAAG,SAAS,GAC9C,OAAO,CAAC,eAAe,CAAC,CAU1B"}

package/dist/esm/users/user-preferences-reset.shared.utils.js

@@ -16,7 +16,7 @@
  * the write against that same DTO, and Mongoose drops every non-schema path. A request naming
  * no schema path therefore produced an empty `$set`: the route answered HTTP 200 having reset
  * nothing. That is the class of defect catalogued in
- * `.claude/plans/routed-unimplemented-operations-fail-closed.md`.
+ * the 2026-08-01 routed-but-unimplemented operation sweep (#1275).
  *
  * ## How the reset reaches the database now
  *
@@ -35,7 +35,7 @@
  * `.excludeFromUpdate()`.
  */
 import { z } from "zod";
-import { EnumEditMode } from "@wildo-ai/zod-decorators";
+import { EnumMultipleEditMode } from "@wildo-ai/zod-decorators";
 import { UserPreferenceGroup, UserLanguagePreferencesSchema, UserPreferences_NotificationsSchema, UserPreferences_RegionalSchema, UserPreferences_UI_ThemeSchema, } from "./users.shared.schemas.js";
 import { UserPrivacySchema } from "../compliance/privacy/privacy.shared.schemas.js";
 /**
@@ -51,7 +51,7 @@ import { UserPrivacySchema } from "../compliance/privacy/privacy.shared.schemas.
  * matching how `fallbackLanguages` presents a compact multi-select in the same settings surface.
  */
 export const UserPreferencesResetRequestSchema = z.object({
-    groups: z.array(z.enum(UserPreferenceGroup).enumUI({ edit: { editMode: EnumEditMode.COMBOBOX } })).min(1),
+    groups: z.array(z.enum(UserPreferenceGroup).enumUI({ edit: { multipleEditMode: EnumMultipleEditMode.COMBOBOX } })).min(1).describe("The preference blocks to return to their defaults, by field name: `notifications`, `privacy`, `ui`, `regional` or `languagePreferences`. At least one is required, and blocks not named are left unchanged. Resetting `privacy` withdraws every consent the user has given; resetting `regional` clears the user's own regional choices so the organization's apply."),
 });
 /**
  * Every block is preference state. Governed-document interaction receipts live in their own
@@ -73,18 +73,18 @@ const USER_PREFERENCE_GROUP_RESET_FACTORIES = {
  * unnamed block is left exactly as it was.
  *
  * assurance-control: WILDO.PRIVACY.CONSENT_RECORD — resetting {@link UserPreferenceGroup.PRIVACY}
- * returns `dataProcessingConsent` to its default, which IS a consent decision. It leaves a trail
+ * returns `consentedPurposes` to the empty set and clears `consentDecidedAt`, which IS a consent
+ * decision — a withdrawal of everything, after which a consent surface asks again. It leaves a trail
  * naming the previous and resulting value: the operation is CRITICAL, so it sits above the
  * framework's automatic audit floor and emits `resource_operation_performed`, and
- * `dataProcessingConsent` / `privacyLevel` carry `.isAuditEvidence()` so their VALUES ride on that
- * record. Governed-document receipts are neither preference members nor resettable values.
+ * `consentedPurposes` carries `.isAuditEvidence()` so its VALUES ride on that record. Governed-document receipts are neither preference members nor resettable values.
  *
  * @param request - the parsed request body. Re-parse `inputDto` through
  *   {@link UserPreferencesResetRequestSchema} at the call site rather than casting it: the
  *   prefix hook types `inputDto` as the resource's main schema, while the runtime value is the
  *   operation's request DTO.
- * @param currentPreferences - the row being reset, needed by blocks whose reset is not a pure
- *   default (today: privacy, whose consent receipts are carried through).
+ * @param currentPreferences - the row being reset, supplied to each block factory. Current
+ *   factories return schema defaults; governed-document receipts live outside this resource.
  */
 export function buildUserPreferencesResetPatch(request, currentPreferences) {
     const patch = {};

package/dist/esm/users/user-preferences-reset.shared.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-preferences-reset.shared.utils.js","sourceRoot":"","sources":["../../../../src/users/user-preferences-reset.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EACL,mBAAmB,EAEnB,6BAA6B,EAC7B,mCAAmC,EACnC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1G,CAAC,CAAC;AAiBH;;;GAGG;AACH,MAAM,qCAAqC,GAAsC;IAC/E,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,CAAC,mCAAmC,CAAC,KAAK,CAAC,EAAE,CAAC;IACxF,CAAC,mBAAmB,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,CAAC;IACxE,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9E,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,6BAA6B,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7E,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;CACjE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAoC,EACpC,kBAA+C;IAE/C,MAAM,KAAK,GAA6B,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,sFAAsF;QACtF,yFAAyF;QACxF,KAAiC,CAAC,KAAK,CAAC,GAAG,qCAAqC,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC/G,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * User Preferences Reset — the shared contract behind `reset_to_defaults`.\n *\n * ONE authority for the self-service reset of a preferences row. `USER_SELF_PREFERENCES`\n * resolves to the `USER_PREFERENCES` persistence collection, but the administrator-addressed\n * resource deliberately exposes no reset operation: a second public verb would be a second\n * contract for the same mutation, free to drift. Administrators have the generic UPDATE for an\n * explicit correction; subjects own selective reset here.\n *\n * ## Why this file exists at all\n *\n * The operation used to declare six booleans (`resetNotifications`, `resetPrivacy`, `resetUI`,\n * `resetRegional`, `resetLanguage`, `resetAll`). None of them is a field on\n * `UserPreferencesSchema`, and a payload is stripped THREE times on the way to the database —\n * the controller parses the body against the operation `requestDto`, the repository re-parses\n * the write against that same DTO, and Mongoose drops every non-schema path. A request naming\n * no schema path therefore produced an empty `$set`: the route answered HTTP 200 having reset\n * nothing. That is the class of defect catalogued in\n * `.claude/plans/routed-unimplemented-operations-fail-closed.md`.\n *\n * ## How the reset reaches the database now\n *\n * `requestDto` names the caller-facing vocabulary ({@link UserPreferenceGroup}); a\n * `basicPrefixOperation` turns it into the patch this module builds. The framework merges a\n * prefix's return value onto the payload and whitelists the keys the prefix ADDED into\n * `preserveServerInjectedFields`, which the repository re-attaches after its strict parse. So\n * the group fields persist while the `groups` array itself — a client-supplied key, never\n * whitelisted — is stripped before it can reach a document.\n *\n * The patch is deliberately PARTIAL. The repository `$set`s it with no dot-path flattening, so\n * naming a group replaces that whole subdocument (which is exactly what \"reset this block\"\n * means), while an unnamed group is not in the `$set` at all and is left untouched. Spreading\n * the current row instead — the shape `todo-lists`/`todos` use — would make `_id` and `userId`\n * prefix-injected keys and re-write `userId` on every reset, despite it being\n * `.excludeFromUpdate()`.\n */\n\nimport { z } from \"zod\";\nimport { EnumEditMode } from \"@wildo-ai/zod-decorators\";\n\nimport {\n  UserPreferenceGroup,\n  UserPreferences,\n  UserLanguagePreferencesSchema,\n  UserPreferences_NotificationsSchema,\n  UserPreferences_RegionalSchema,\n  UserPreferences_UI_ThemeSchema,\n} from \"./users.shared.schemas\";\nimport { UserPrivacySchema } from \"../compliance/privacy/privacy.shared.schemas\";\n\n/**\n * The `reset_to_defaults` request body for the subject-facing preferences resource.\n *\n * `.min(1)` is load-bearing, not decoration: a reset naming no group would write nothing and\n * answer 200, re-creating the exact silent no-op this operation was fixed for. Rejecting it at\n * the DTO makes that unrepresentable — the controller's strict parse turns it into a 400 before\n * any dispatch, and the repository's re-parse of the write enforces the same rule on every\n * non-HTTP path.\n *\n * `COMBOBOX` renders the array as a chips multi-select rather than an add-a-row array field,\n * matching how `fallbackLanguages` presents a compact multi-select in the same settings surface.\n */\nexport const UserPreferencesResetRequestSchema = z.object({\n  groups: z.array(z.enum(UserPreferenceGroup).enumUI({ edit: { editMode: EnumEditMode.COMBOBOX } })).min(1),\n});\n\nexport type UserPreferencesResetRequest = z.infer<typeof UserPreferencesResetRequestSchema>;\n\n/**\n * How each preference block returns to its defaults.\n *\n * The mapped type is the integrity proof: `UserPreferences[Group]` only type-checks when every\n * {@link UserPreferenceGroup} value is a real field of `UserPreferences`. Typo a value, rename a\n * group field without renaming the enum value, or add a group member without a factory, and\n * this stops compiling — instead of shipping a patch key Mongoose silently drops, which is the\n * failure mode that made the old contract a no-op.\n */\ntype UserPreferenceGroupResetFactories = {\n  [Group in UserPreferenceGroup]: (currentPreferences: UserPreferences | undefined) => UserPreferences[Group];\n};\n\n/**\n * Every block is preference state. Governed-document interaction receipts live in their own\n * immutable release-bound store and therefore cannot be erased or forged by this reset path.\n */\nconst USER_PREFERENCE_GROUP_RESET_FACTORIES: UserPreferenceGroupResetFactories = {\n  [UserPreferenceGroup.NOTIFICATIONS]: () => UserPreferences_NotificationsSchema.parse({}),\n  [UserPreferenceGroup.UI]: () => UserPreferences_UI_ThemeSchema.parse({}),\n  [UserPreferenceGroup.REGIONAL]: () => UserPreferences_RegionalSchema.parse({}),\n  [UserPreferenceGroup.LANGUAGE]: () => UserLanguagePreferencesSchema.parse({}),\n  [UserPreferenceGroup.PRIVACY]: () => UserPrivacySchema.parse({}),\n};\n\n/**\n * The persistence patch for a `reset_to_defaults` request — one key per requested block, and\n * nothing else.\n *\n * Returned from a `basicPrefixOperation`, so the framework merges it onto the payload and the\n * core UPDATE persists it. Keys absent from the patch are absent from the `$set`, so an\n * unnamed block is left exactly as it was.\n *\n * assurance-control: WILDO.PRIVACY.CONSENT_RECORD — resetting {@link UserPreferenceGroup.PRIVACY}\n * returns `dataProcessingConsent` to its default, which IS a consent decision. It leaves a trail\n * naming the previous and resulting value: the operation is CRITICAL, so it sits above the\n * framework's automatic audit floor and emits `resource_operation_performed`, and\n * `dataProcessingConsent` / `privacyLevel` carry `.isAuditEvidence()` so their VALUES ride on that\n * record. Governed-document receipts are neither preference members nor resettable values.\n *\n * @param request - the parsed request body. Re-parse `inputDto` through\n *   {@link UserPreferencesResetRequestSchema} at the call site rather than casting it: the\n *   prefix hook types `inputDto` as the resource's main schema, while the runtime value is the\n *   operation's request DTO.\n * @param currentPreferences - the row being reset, needed by blocks whose reset is not a pure\n *   default (today: privacy, whose consent receipts are carried through).\n */\nexport function buildUserPreferencesResetPatch(\n  request: UserPreferencesResetRequest,\n  currentPreferences: UserPreferences | undefined,\n): Partial<UserPreferences> {\n  const patch: Partial<UserPreferences> = {};\n\n  for (const group of request.groups) {\n    // Same correlated-write widening as above: the factory is selected by the same key it\n    // writes, so the value type is right by construction and only the assignment is widened.\n    (patch as Record<string, unknown>)[group] = USER_PREFERENCE_GROUP_RESET_FACTORIES[group](currentPreferences);\n  }\n\n  return patch;\n}\n"]}
+{"version":3,"file":"user-preferences-reset.shared.utils.js","sourceRoot":"","sources":["../../../../src/users/user-preferences-reset.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EACL,mBAAmB,EAEnB,6BAA6B,EAC7B,mCAAmC,EACnC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sWAAsW,CAAC;CAC3e,CAAC,CAAC;AAiBH;;;GAGG;AACH,MAAM,qCAAqC,GAAsC;IAC/E,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,CAAC,mCAAmC,CAAC,KAAK,CAAC,EAAE,CAAC;IACxF,CAAC,mBAAmB,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,CAAC;IACxE,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,8BAA8B,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9E,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,6BAA6B,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7E,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;CACjE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAoC,EACpC,kBAA+C;IAE/C,MAAM,KAAK,GAA6B,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,sFAAsF;QACtF,yFAAyF;QACxF,KAAiC,CAAC,KAAK,CAAC,GAAG,qCAAqC,CAAC,KAAK,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC/G,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * User Preferences Reset — the shared contract behind `reset_to_defaults`.\n *\n * ONE authority for the self-service reset of a preferences row. `USER_SELF_PREFERENCES`\n * resolves to the `USER_PREFERENCES` persistence collection, but the administrator-addressed\n * resource deliberately exposes no reset operation: a second public verb would be a second\n * contract for the same mutation, free to drift. Administrators have the generic UPDATE for an\n * explicit correction; subjects own selective reset here.\n *\n * ## Why this file exists at all\n *\n * The operation used to declare six booleans (`resetNotifications`, `resetPrivacy`, `resetUI`,\n * `resetRegional`, `resetLanguage`, `resetAll`). None of them is a field on\n * `UserPreferencesSchema`, and a payload is stripped THREE times on the way to the database —\n * the controller parses the body against the operation `requestDto`, the repository re-parses\n * the write against that same DTO, and Mongoose drops every non-schema path. A request naming\n * no schema path therefore produced an empty `$set`: the route answered HTTP 200 having reset\n * nothing. That is the class of defect catalogued in\n * the 2026-08-01 routed-but-unimplemented operation sweep (#1275).\n *\n * ## How the reset reaches the database now\n *\n * `requestDto` names the caller-facing vocabulary ({@link UserPreferenceGroup}); a\n * `basicPrefixOperation` turns it into the patch this module builds. The framework merges a\n * prefix's return value onto the payload and whitelists the keys the prefix ADDED into\n * `preserveServerInjectedFields`, which the repository re-attaches after its strict parse. So\n * the group fields persist while the `groups` array itself — a client-supplied key, never\n * whitelisted — is stripped before it can reach a document.\n *\n * The patch is deliberately PARTIAL. The repository `$set`s it with no dot-path flattening, so\n * naming a group replaces that whole subdocument (which is exactly what \"reset this block\"\n * means), while an unnamed group is not in the `$set` at all and is left untouched. Spreading\n * the current row instead — the shape `todo-lists`/`todos` use — would make `_id` and `userId`\n * prefix-injected keys and re-write `userId` on every reset, despite it being\n * `.excludeFromUpdate()`.\n */\n\nimport { z } from \"zod\";\nimport { EnumMultipleEditMode } from \"@wildo-ai/zod-decorators\";\n\nimport {\n  UserPreferenceGroup,\n  UserPreferences,\n  UserLanguagePreferencesSchema,\n  UserPreferences_NotificationsSchema,\n  UserPreferences_RegionalSchema,\n  UserPreferences_UI_ThemeSchema,\n} from \"./users.shared.schemas\";\nimport { UserPrivacySchema } from \"../compliance/privacy/privacy.shared.schemas\";\n\n/**\n * The `reset_to_defaults` request body for the subject-facing preferences resource.\n *\n * `.min(1)` is load-bearing, not decoration: a reset naming no group would write nothing and\n * answer 200, re-creating the exact silent no-op this operation was fixed for. Rejecting it at\n * the DTO makes that unrepresentable — the controller's strict parse turns it into a 400 before\n * any dispatch, and the repository's re-parse of the write enforces the same rule on every\n * non-HTTP path.\n *\n * `COMBOBOX` renders the array as a chips multi-select rather than an add-a-row array field,\n * matching how `fallbackLanguages` presents a compact multi-select in the same settings surface.\n */\nexport const UserPreferencesResetRequestSchema = z.object({\n  groups: z.array(z.enum(UserPreferenceGroup).enumUI({ edit: { multipleEditMode: EnumMultipleEditMode.COMBOBOX } })).min(1).describe(\"The preference blocks to return to their defaults, by field name: `notifications`, `privacy`, `ui`, `regional` or `languagePreferences`. At least one is required, and blocks not named are left unchanged. Resetting `privacy` withdraws every consent the user has given; resetting `regional` clears the user's own regional choices so the organization's apply.\"),\n});\n\nexport type UserPreferencesResetRequest = z.infer<typeof UserPreferencesResetRequestSchema>;\n\n/**\n * How each preference block returns to its defaults.\n *\n * The mapped type is the integrity proof: `UserPreferences[Group]` only type-checks when every\n * {@link UserPreferenceGroup} value is a real field of `UserPreferences`. Typo a value, rename a\n * group field without renaming the enum value, or add a group member without a factory, and\n * this stops compiling — instead of shipping a patch key Mongoose silently drops, which is the\n * failure mode that made the old contract a no-op.\n */\ntype UserPreferenceGroupResetFactories = {\n  [Group in UserPreferenceGroup]: (currentPreferences: UserPreferences | undefined) => UserPreferences[Group];\n};\n\n/**\n * Every block is preference state. Governed-document interaction receipts live in their own\n * immutable release-bound store and therefore cannot be erased or forged by this reset path.\n */\nconst USER_PREFERENCE_GROUP_RESET_FACTORIES: UserPreferenceGroupResetFactories = {\n  [UserPreferenceGroup.NOTIFICATIONS]: () => UserPreferences_NotificationsSchema.parse({}),\n  [UserPreferenceGroup.UI]: () => UserPreferences_UI_ThemeSchema.parse({}),\n  [UserPreferenceGroup.REGIONAL]: () => UserPreferences_RegionalSchema.parse({}),\n  [UserPreferenceGroup.LANGUAGE]: () => UserLanguagePreferencesSchema.parse({}),\n  [UserPreferenceGroup.PRIVACY]: () => UserPrivacySchema.parse({}),\n};\n\n/**\n * The persistence patch for a `reset_to_defaults` request — one key per requested block, and\n * nothing else.\n *\n * Returned from a `basicPrefixOperation`, so the framework merges it onto the payload and the\n * core UPDATE persists it. Keys absent from the patch are absent from the `$set`, so an\n * unnamed block is left exactly as it was.\n *\n * assurance-control: WILDO.PRIVACY.CONSENT_RECORD — resetting {@link UserPreferenceGroup.PRIVACY}\n * returns `consentedPurposes` to the empty set and clears `consentDecidedAt`, which IS a consent\n * decision — a withdrawal of everything, after which a consent surface asks again. It leaves a trail\n * naming the previous and resulting value: the operation is CRITICAL, so it sits above the\n * framework's automatic audit floor and emits `resource_operation_performed`, and\n * `consentedPurposes` carries `.isAuditEvidence()` so its VALUES ride on that record. Governed-document receipts are neither preference members nor resettable values.\n *\n * @param request - the parsed request body. Re-parse `inputDto` through\n *   {@link UserPreferencesResetRequestSchema} at the call site rather than casting it: the\n *   prefix hook types `inputDto` as the resource's main schema, while the runtime value is the\n *   operation's request DTO.\n * @param currentPreferences - the row being reset, supplied to each block factory. Current\n *   factories return schema defaults; governed-document receipts live outside this resource.\n */\nexport function buildUserPreferencesResetPatch(\n  request: UserPreferencesResetRequest,\n  currentPreferences: UserPreferences | undefined,\n): Partial<UserPreferences> {\n  const patch: Partial<UserPreferences> = {};\n\n  for (const group of request.groups) {\n    // Same correlated-write widening as above: the factory is selected by the same key it\n    // writes, so the value type is right by construction and only the assignment is widened.\n    (patch as Record<string, unknown>)[group] = USER_PREFERENCE_GROUP_RESET_FACTORIES[group](currentPreferences);\n  }\n\n  return patch;\n}\n"]}

package/dist/esm/users/user-preferences.shared.resources-config.schemas.d.ts

@@ -4,37 +4,79 @@
  * Resource configuration for user preferences management operations.
  * Handles notifications, privacy, UI, regional, and language preferences.
  */
+import { z } from 'zod';
 import { CoreResourceOperation } from '../resources/resources.shared.core.definitions';
 import { ResourceRelationship } from '../resources/resources.shared.schemas';
+/**
+ * Custom operations on a person's preferences, from the ADMINISTRATIVE side.
+ *
+ * `CARRY_ANONYMOUS_CONSENT` exists because a consent decision has THREE authors, not two, and only
+ * two had a door (#1258):
+ *
+ * | who decided | door | rule |
+ * |---|---|---|
+ * | the person, now | `USER_SELF_PREFERENCES.UPDATE` | `buildConsentDecisionPatch` — the server stamps the instant |
+ * | an administrator, for them | `USER_PREFERENCES.UPDATE` | `buildAdministratorConsentDecisionPatch` — withdraw only, never grant |
+ * | **the person, BEFORE they had an account** | this | the decision was already made and already timed; it is being MOVED |
+ *
+ * The third is not a variant of either. Routed through the administrator door it is REFUSED — that
+ * door throws on any added purpose, which is exactly what a carry adds — and routed through the self
+ * door the hook stamps the server's NOW over the instant the visitor actually decided at, and stamps
+ * one in the case that must deliberately have none. Both are correct rules for their own author, and
+ * neither is the rule for this one.
+ *
+ * So it is named rather than smuggled past a guard: `design-philosophy.md`, semantic distinction over
+ * convenience.
+ */
+export declare enum UserPreferences_Operations {
+    CARRY_ANONYMOUS_CONSENT = "carry_anonymous_consent"
+}
+/**
+ * The privacy block to store, ALREADY DECIDED.
+ *
+ * The whole block, not a delta, and never a partial: `buildAnonymousConsentCarryPatch` overlays the
+ * account's current block before returning, so what arrives here is complete — a partial write would
+ * silently reset any member it omits to that member's schema default.
+ *
+ * `consentDecidedAt` is ABSENT exactly when the visitor was shown less than this application asks.
+ * That absence is the payload's most important property: it is what leaves the question open so the
+ * application still prompts, with the grants the person already made pre-ticked. An operation that
+ * defaulted it would collapse the carry into "record a decision", which is the defect the whole step
+ * exists to avoid.
+ */
+export declare const UserPreferencesCarryAnonymousConsentRequestSchema: z.ZodObject<{
+    privacy: z.ZodObject<{
+        consentedPurposes: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodArray<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("..").ConsentPurpose>>>>>;
+        consentDecidedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type UserPreferencesCarryAnonymousConsentRequest = z.infer<typeof UserPreferencesCarryAnonymousConsentRequestSchema>;
 type UserPreferencesCoreOperations = CoreResourceOperation.READ | CoreResourceOperation.UPDATE | CoreResourceOperation.CREATE | CoreResourceOperation.LIST | CoreResourceOperation.UPDATE_MANY | CoreResourceOperation.DELETE;
-export declare const userPreferencesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("..").ResourceConfiguration<undefined, UserPreferencesCoreOperations, import("zod").ZodObject<{
-    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
-    userId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>>>>;
-    notifications: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodObject<{
-        email: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        push: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        sms: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        inApp: import("zod").ZodDefault<import("zod").ZodBoolean>;
-    }, import("zod/v4/core").$strip>>>;
-    privacy: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodObject<{
-        dataProcessingConsent: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodEnum<typeof import("..").DataProcessingConsent>>>;
-        privacyLevel: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodEnum<typeof import("..").PrivacyLevel>>>;
-    }, import("zod/v4/core").$strip>>>;
-    ui: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodObject<{
-        theme: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodEnum<typeof import("./users.shared.schemas").UserTheme>>>;
-    }, import("zod/v4/core").$strip>>>;
-    regional: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodObject<{
-        timezone: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodEnum<typeof import("@wildo-ai/presets-components-models").CommonTimezone>, import("zod").ZodString]>>>;
-        dateFormat: import("zod").ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodEnum<typeof import("@wildo-ai/presets-components-models").DateFormat>>>;
-        timeFormat: import("zod").ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodEnum<typeof import("@wildo-ai/presets-components-models").TimeFormat>>>;
-        locale: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodEnum<typeof import("@wildo-ai/presets-components-models").AvailableLanguage>>>>;
-    }, import("zod/v4/core").$strip>>>>;
-    languagePreferences: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodObject<{
-        primaryLanguage: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodEnum<typeof import("@wildo-ai/presets-components-models").AvailableLanguage>>>>;
-        fallbackLanguages: import("zod").ZodDefault<import("zod").ZodArray<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodEnum<typeof import("@wildo-ai/presets-components-models").AvailableLanguage>>>>>;
-        autoDetect: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        useOrganizationDefault: import("zod").ZodDefault<import("zod").ZodBoolean>;
-    }, import("zod/v4/core").$strip>>>>;
-}, import("zod/v4/core").$strip>>;
+export declare const userPreferencesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("..").ResourceConfiguration<typeof UserPreferences_Operations, UserPreferencesCoreOperations, z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    userId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>>>;
+    notifications: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodObject<{
+        email: z.ZodDefault<z.ZodBoolean>;
+        inApp: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    privacy: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodObject<{
+        consentedPurposes: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodArray<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("..").ConsentPurpose>>>>>;
+        consentDecidedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>>>>;
+    ui: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodObject<{
+        theme: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodEnum<typeof import("./users.shared.schemas").UserTheme>>>;
+    }, z.core.$strip>>>;
+    regional: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodObject<{
+        timezone: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodUnion<[z.ZodEnum<typeof import("@wildo-ai/presets-components-models").CommonTimezone>, z.ZodString]>>>;
+        dateFormat: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("@wildo-ai/presets-components-models").DateFormat>>>;
+        timeFormat: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("@wildo-ai/presets-components-models").TimeFormat>>>;
+        locale: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("@wildo-ai/presets-components-models").AvailableLanguage>>>>;
+    }, z.core.$strip>>>>;
+    languagePreferences: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodObject<{
+        primaryLanguage: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("@wildo-ai/presets-components-models").AvailableLanguage>>>>;
+        fallbackLanguages: z.ZodDefault<z.ZodArray<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("@wildo-ai/presets-components-models").AvailableLanguage>>>>>;
+        useOrganizationDefault: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>>;
 export {};
 //# sourceMappingURL=user-preferences.shared.resources-config.schemas.d.ts.map

package/dist/esm/users/user-preferences.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-preferences.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/users/user-preferences.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAWzG,KAAK,6BAA6B,GAC9B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,WAAW,GACjC,qBAAqB,CAAC,MAAM,CAAC;AAKjC,eAAO,MAAM,0DAA0D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAyJvH,CAAC"}
+{"version":3,"file":"user-preferences.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/users/user-preferences.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAWzG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,oBAAY,0BAA0B;IACpC,uBAAuB,4BAA4B;CACpD;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iDAAiD;;;;;iBAE5D,CAAC;AAEH,MAAM,MAAM,2CAA2C,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iDAAiD,CAAC,CAAC;AAE5H,KAAK,6BAA6B,GAC9B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,WAAW,GACjC,qBAAqB,CAAC,MAAM,CAAC;AAKjC,eAAO,MAAM,0DAA0D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;kBAkNvH,CAAC"}

package/dist/esm/users/user-preferences.shared.resources-config.schemas.js

@@ -4,7 +4,10 @@
  * Resource configuration for user preferences management operations.
  * Handles notifications, privacy, UI, regional, and language preferences.
  */
+import { z } from 'zod';
 import { UserPreferencesSchema } from './users.shared.schemas.js';
+import { UserPrivacySchema } from '../compliance/privacy/privacy.shared.schemas.js';
+import { buildAdministratorConsentDecisionPatch } from './user-consent-decision.shared.utils.js';
 import { ErasureRetentionMode, ResourceDataSubjectKind } from '../compliance/privacy/impersonalization.shared.schemas.js';
 import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
 import { ResourceOperationRiskLevel } from '../resources/resources.shared.schemas.js';
@@ -15,6 +18,47 @@ import { createResourceConfiguration_Initialization } from '../resources/resourc
 import { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas.js';
 import { CORE_APP_ROLES } from '../security/authorizations/roles.shared.schemas.js';
 import { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas.js';
+/**
+ * Custom operations on a person's preferences, from the ADMINISTRATIVE side.
+ *
+ * `CARRY_ANONYMOUS_CONSENT` exists because a consent decision has THREE authors, not two, and only
+ * two had a door (#1258):
+ *
+ * | who decided | door | rule |
+ * |---|---|---|
+ * | the person, now | `USER_SELF_PREFERENCES.UPDATE` | `buildConsentDecisionPatch` — the server stamps the instant |
+ * | an administrator, for them | `USER_PREFERENCES.UPDATE` | `buildAdministratorConsentDecisionPatch` — withdraw only, never grant |
+ * | **the person, BEFORE they had an account** | this | the decision was already made and already timed; it is being MOVED |
+ *
+ * The third is not a variant of either. Routed through the administrator door it is REFUSED — that
+ * door throws on any added purpose, which is exactly what a carry adds — and routed through the self
+ * door the hook stamps the server's NOW over the instant the visitor actually decided at, and stamps
+ * one in the case that must deliberately have none. Both are correct rules for their own author, and
+ * neither is the rule for this one.
+ *
+ * So it is named rather than smuggled past a guard: `design-philosophy.md`, semantic distinction over
+ * convenience.
+ */
+export var UserPreferences_Operations;
+(function (UserPreferences_Operations) {
+    UserPreferences_Operations["CARRY_ANONYMOUS_CONSENT"] = "carry_anonymous_consent";
+})(UserPreferences_Operations || (UserPreferences_Operations = {}));
+/**
+ * The privacy block to store, ALREADY DECIDED.
+ *
+ * The whole block, not a delta, and never a partial: `buildAnonymousConsentCarryPatch` overlays the
+ * account's current block before returning, so what arrives here is complete — a partial write would
+ * silently reset any member it omits to that member's schema default.
+ *
+ * `consentDecidedAt` is ABSENT exactly when the visitor was shown less than this application asks.
+ * That absence is the payload's most important property: it is what leaves the question open so the
+ * application still prompts, with the grants the person already made pre-ticked. An operation that
+ * defaulted it would collapse the carry into "record a decision", which is the defect the whole step
+ * exists to avoid.
+ */
+export const UserPreferencesCarryAnonymousConsentRequestSchema = z.object({
+    privacy: UserPrivacySchema,
+});
 /*
 User Preferences Resource Configuration Factory
 */
@@ -69,6 +113,7 @@ export const userPreferencesResourceConfiguration_InitializationFactory = (resou
         CoreResourceOperation.LIST,
         CoreResourceOperation.UPDATE_MANY,
     ],
+    customOperation: UserPreferences_Operations,
     operationsConfiguration: {
         /*
          * Route-less retention plumbing. INTERNAL_CALL registers NO route, and must not be
@@ -134,7 +179,14 @@ export const userPreferencesResourceConfiguration_InitializationFactory = (resou
                     variantKey: "admin",
                     roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
                     riskLevel: ResourceOperationRiskLevel.MEDIUM,
+                    // Consent settings need before/after evidence even below the automatic risk floor.
+                    auditableEvent: { auditBelowRiskFloor: true },
                     admitsCrossSubjectUserAdministration: true,
+                    // An administrator acting for the subject still makes a DECISION the server stamps (#534) —
+                    // the same hook as the self door, so the two doors onto one record cannot disagree.
+                    // Withdraw-only (#534): an administrator never grants consent on a person's behalf.
+                    basicPrefixOperation: ({ inputDto, currentObject }) => buildAdministratorConsentDecisionPatch(inputDto, currentObject),
+                    authoritativeFields: ['privacy'],
                 }
             ],
             userNotifications: [
@@ -156,6 +208,53 @@ export const userPreferencesResourceConfiguration_InitializationFactory = (resou
                     riskLevel: ResourceOperationRiskLevel.MEDIUM,
                 }
             ],
+        },
+        /**
+         * Move a decision the person made BEFORE they had an account onto the account (#1258).
+         *
+         * See {@link UserPreferences_Operations} for why this is a third door rather than a use of
+         * either existing one: the administrator door refuses a granted purpose, and the self door
+         * stamps the server's clock over the instant the visitor actually decided at.
+         *
+         * ## No consent-decision prefix, and that is the point
+         *
+         * Every other write of this field carries one — `buildConsentDecisionPatch` on the self door,
+         * `buildAdministratorConsentDecisionPatch` on the administrative one. This carries NONE, because
+         * the rule was ALREADY applied, by `buildAnonymousConsentCarryPatch`, against the visitor's own
+         * record: which grants were actually offered, whether the offered set covered what this
+         * application asks, and therefore whether an instant may be stamped at all. Re-applying a hook
+         * here would overwrite that answer with a worse one.
+         *
+         * So the payload is authored, not derived, and the operation's job is to store it faithfully.
+         *
+         * ## INTERNAL_CALL: there is no caller to expose this to
+         *
+         * It registers no route. Its only caller is the anonymous→authenticated conversion, which runs
+         * inside authentication with no person at a keyboard. A person changing their own mind uses the
+         * self door; an administrator uses theirs.
+         *
+         * MEDIUM sits below the automatic HIGH/CRITICAL audit floor, so `auditBelowRiskFloor` is what
+         * makes the change leave a row — the same remedy, and the same reasoning, as the two sibling
+         * doors and the lead's CREATE: buying the row by mis-declaring the verb's danger would corrupt
+         * the risk vocabulary every other control reads. Only the marked decision leaves
+         * (`consentedPurposes`) enter the evidence, so the row carries the choice and its
+         * provenance rather than the whole block.
+         *
+         * assurance-control: WILDO.PRIVACY.CONSENT_RECORD — a decision taken before identity is recorded
+         * against the person it belonged to, and the change leaves a trail naming what it moved.
+         */
+        [UserPreferences_Operations.CARRY_ANONYMOUS_CONSENT]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.INTERNAL_CALL,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.MEDIUM,
+                    resourceOperationLike: CoreResourceOperation.UPDATE,
+                    requestDto: UserPreferencesCarryAnonymousConsentRequestSchema,
+                    auditableEvent: { auditBelowRiskFloor: true },
+                }
+            ],
         }
     },
 });

package/dist/esm/users/user-preferences.shared.resources-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-preferences.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/users/user-preferences.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * User Preferences Shared Resource Configuration\n *\n * Resource configuration for user preferences management operations.\n * Handles notifications, privacy, UI, regional, and language preferences.\n */\n\nimport { UserPreferencesSchema } from './users.shared.schemas';\nimport { ErasureRetentionMode, ResourceDataSubjectKind } from '../compliance/privacy/impersonalization.shared.schemas';\nimport { CoreResourceOperation } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourceRelationship } from '../resources/resources.shared.schemas';\nimport { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationVariantType } from '../resources/resources.shared.schemas';\nimport { CoreUserNotificationTarget, CoreUserNotificationChannel } from '../notifications/notifications.shared.schemas';\n\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\nimport { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas';\n\nimport { CORE_APP_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas';\n\ntype UserPreferencesCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.UPDATE_MANY\n  | CoreResourceOperation.DELETE;\n\n/*\nUser Preferences Resource Configuration Factory\n*/\nexport const userPreferencesResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  undefined,\n  UserPreferencesCoreOperations,\n  typeof UserPreferencesSchema\n>({\n  mainSchema: UserPreferencesSchema,\n  resourceIdentifier: CoreResourceType.USER_PREFERENCES,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USER_PREFERENCES],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n\n  // Eager composition seeding: the USERS → USER_PREFERENCES relationship declares\n  // `onParentCreate.enabled`, so a default preferences row is written via\n  // `createAsSystem` on user creation. Registration (and OAuth/SCIM/SAML/enterprise)\n  // create USERS; USER_SELF_PREFERENCES is a read-only view over the SAME collection\n  // (`getCollectionNameForResource` maps USER_SELF_PREFERENCES → USER_PREFERENCES),\n  // so the self-read finds this seeded row. Guard-1 is fail-closed by omission, so\n  // the system seed requires this explicit CREATE opt-in.\n  systemAccessPolicy: {\n    exportSubject: ResourceSystemAccessMode.ALLOWED, create: ResourceSystemAccessMode.ALLOWED },\n\n  /**\n   * Subject-export disclosure. Admin door onto the same preference rows.\n   */\n  portabilityPolicy: { defaultProvenance: DataPortabilityProvenance.SUBJECT_PROVIDED },\n\n\n  /**\n   * Subject erasure RETAINS the preferences row and RESETS what it holds.\n   *\n   * `RETAIN_AND_IMPERSONALIZE`: notification routing, privacy choices, regional settings (which carry\n   * LOCATION — a timezone and a locale narrow where a person is) and language preferences are all a\n   * record of one person's choices. All four take `RESET`, returning the application's own defaults.\n   *\n   * RESET rather than REMOVE, and the distinction is why this resource could not be declared at all\n   * until 2026-09-01: every one of these fields is non-nullable with a schema default, so a null fails\n   * the strict re-parse and `maskValue` (typed `string`) cannot express an object. Neither mode was\n   * authorable — `RETAIN_AND_IMPERSONALIZE` is refused when nothing would be scrubbed, and\n   * `RETAIN_ONLY` would have asserted this resource holds no personal data, which is false.\n   *\n   * ⚠️ `USER_SELF_PREFERENCES` declares the SAME policy on purpose — a second config over the SAME\n   * collection and the SAME schema, so both must inject the same marker and emit the same partial\n   * index. Change the two together, as `USERS` / `USER_SELF` documents.\n   */\n  retentionPolicy: {\n    mode: ErasureRetentionMode.RETAIN_AND_IMPERSONALIZE,\n  },\n\n  /** The subject is the person whose preferences these are, reached through `userId`. */\n  dataSubjectPolicy: { kind: ResourceDataSubjectKind.SELF_PRINCIPAL },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.DELETE,\n    // Route-less; required by `retentionPolicy` (the in-place scrub + audited see-through read).\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.UPDATE_MANY,\n  ],\n\n  operationsConfiguration: {\n    /*\n     * Route-less retention plumbing. INTERNAL_CALL registers NO route, and must not be\n     * REPOSITORY_ONLY: the retention primitives resolve through `getServiceOperationPathDefault`,\n     * which excludes it, so that spelling passes the boot guard and fails when an erasure runs.\n     * LIST is LOW — a read-shaped operation may not claim the HIGH/CRITICAL band, which carries an\n     * audit-emission obligation checked over the real engine catalogue.\n     */\n    [CoreResourceOperation.LIST]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        },\n      ],\n    },\n    [CoreResourceOperation.UPDATE_MANY]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.CRITICAL,\n        },\n      ],\n    },\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          variantKey: \"admin\",\n          roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          // USER_PREFERENCES is the cross-subject administrative door onto the same rows exposed\n          // to a subject by USER_SELF_PREFERENCES. This opt-in is what makes the addressed\n          // `{userId}` an administrator-selected subject rather than forcing it to equal the\n          // caller. The APP_ADMIN_VIEWER role remains the independent authorization gate.\n          admitsCrossSubjectUserAdministration: true,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          // Preferences are seeded by the USERS -> USER_PREFERENCES composition. CREATE remains\n          // enabled only so the trusted lifecycle hook can call createAsSystem; it is not a public\n          // recovery endpoint and does not belong in either API-reference section.\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          variantKey: \"admin\",\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          admitsCrossSubjectUserAdministration: true,\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.USER_SELF,\n          channel: CoreUserNotificationChannel.FRONT_END_SUCCESS,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          // The USERS composition cascade needs DELETE to exist, but no actor should delete an\n          // eagerly seeded preferences row through HTTP. The self API has selective reset; the\n          // administration API has UPDATE. Account deletion invokes this internal lifecycle edge.\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        }\n      ],\n    }\n  },\n});\n"]}
+{"version":3,"file":"user-preferences.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/users/user-preferences.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * User Preferences Shared Resource Configuration\n *\n * Resource configuration for user preferences management operations.\n * Handles notifications, privacy, UI, regional, and language preferences.\n */\n\nimport { z } from 'zod';\n\nimport { UserPreferencesSchema } from './users.shared.schemas';\nimport { UserPrivacySchema } from '../compliance/privacy/privacy.shared.schemas';\nimport { buildAdministratorConsentDecisionPatch } from './user-consent-decision.shared.utils';\nimport { ErasureRetentionMode, ResourceDataSubjectKind } from '../compliance/privacy/impersonalization.shared.schemas';\nimport { CoreResourceOperation } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourceRelationship } from '../resources/resources.shared.schemas';\nimport { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationVariantType } from '../resources/resources.shared.schemas';\nimport { CoreUserNotificationTarget, CoreUserNotificationChannel } from '../notifications/notifications.shared.schemas';\n\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\nimport { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas';\n\nimport { CORE_APP_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas';\n\n/**\n * Custom operations on a person's preferences, from the ADMINISTRATIVE side.\n *\n * `CARRY_ANONYMOUS_CONSENT` exists because a consent decision has THREE authors, not two, and only\n * two had a door (#1258):\n *\n * | who decided | door | rule |\n * |---|---|---|\n * | the person, now | `USER_SELF_PREFERENCES.UPDATE` | `buildConsentDecisionPatch` — the server stamps the instant |\n * | an administrator, for them | `USER_PREFERENCES.UPDATE` | `buildAdministratorConsentDecisionPatch` — withdraw only, never grant |\n * | **the person, BEFORE they had an account** | this | the decision was already made and already timed; it is being MOVED |\n *\n * The third is not a variant of either. Routed through the administrator door it is REFUSED — that\n * door throws on any added purpose, which is exactly what a carry adds — and routed through the self\n * door the hook stamps the server's NOW over the instant the visitor actually decided at, and stamps\n * one in the case that must deliberately have none. Both are correct rules for their own author, and\n * neither is the rule for this one.\n *\n * So it is named rather than smuggled past a guard: `design-philosophy.md`, semantic distinction over\n * convenience.\n */\nexport enum UserPreferences_Operations {\n  CARRY_ANONYMOUS_CONSENT = 'carry_anonymous_consent',\n}\n\n/**\n * The privacy block to store, ALREADY DECIDED.\n *\n * The whole block, not a delta, and never a partial: `buildAnonymousConsentCarryPatch` overlays the\n * account's current block before returning, so what arrives here is complete — a partial write would\n * silently reset any member it omits to that member's schema default.\n *\n * `consentDecidedAt` is ABSENT exactly when the visitor was shown less than this application asks.\n * That absence is the payload's most important property: it is what leaves the question open so the\n * application still prompts, with the grants the person already made pre-ticked. An operation that\n * defaulted it would collapse the carry into \"record a decision\", which is the defect the whole step\n * exists to avoid.\n */\nexport const UserPreferencesCarryAnonymousConsentRequestSchema = z.object({\n  privacy: UserPrivacySchema,\n});\n\nexport type UserPreferencesCarryAnonymousConsentRequest = z.infer<typeof UserPreferencesCarryAnonymousConsentRequestSchema>;\n\ntype UserPreferencesCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.UPDATE_MANY\n  | CoreResourceOperation.DELETE;\n\n/*\nUser Preferences Resource Configuration Factory\n*/\nexport const userPreferencesResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  typeof UserPreferences_Operations,\n  UserPreferencesCoreOperations,\n  typeof UserPreferencesSchema\n>({\n  mainSchema: UserPreferencesSchema,\n  resourceIdentifier: CoreResourceType.USER_PREFERENCES,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USER_PREFERENCES],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n\n  // Eager composition seeding: the USERS → USER_PREFERENCES relationship declares\n  // `onParentCreate.enabled`, so a default preferences row is written via\n  // `createAsSystem` on user creation. Registration (and OAuth/SCIM/SAML/enterprise)\n  // create USERS; USER_SELF_PREFERENCES is a read-only view over the SAME collection\n  // (`getCollectionNameForResource` maps USER_SELF_PREFERENCES → USER_PREFERENCES),\n  // so the self-read finds this seeded row. Guard-1 is fail-closed by omission, so\n  // the system seed requires this explicit CREATE opt-in.\n  systemAccessPolicy: {\n    exportSubject: ResourceSystemAccessMode.ALLOWED, create: ResourceSystemAccessMode.ALLOWED },\n\n  /**\n   * Subject-export disclosure. Admin door onto the same preference rows.\n   */\n  portabilityPolicy: { defaultProvenance: DataPortabilityProvenance.SUBJECT_PROVIDED },\n\n\n  /**\n   * Subject erasure RETAINS the preferences row and RESETS what it holds.\n   *\n   * `RETAIN_AND_IMPERSONALIZE`: notification routing, privacy choices, regional settings (which carry\n   * LOCATION — a timezone and a locale narrow where a person is) and language preferences are all a\n   * record of one person's choices. All four take `RESET`, returning the application's own defaults.\n   *\n   * RESET rather than REMOVE, and the distinction is why this resource could not be declared at all\n   * until 2026-09-01: every one of these fields is non-nullable with a schema default, so a null fails\n   * the strict re-parse and `maskValue` (typed `string`) cannot express an object. Neither mode was\n   * authorable — `RETAIN_AND_IMPERSONALIZE` is refused when nothing would be scrubbed, and\n   * `RETAIN_ONLY` would have asserted this resource holds no personal data, which is false.\n   *\n   * ⚠️ `USER_SELF_PREFERENCES` declares the SAME policy on purpose — a second config over the SAME\n   * collection and the SAME schema, so both must inject the same marker and emit the same partial\n   * index. Change the two together, as `USERS` / `USER_SELF` documents.\n   */\n  retentionPolicy: {\n    mode: ErasureRetentionMode.RETAIN_AND_IMPERSONALIZE,\n  },\n\n  /** The subject is the person whose preferences these are, reached through `userId`. */\n  dataSubjectPolicy: { kind: ResourceDataSubjectKind.SELF_PRINCIPAL },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.DELETE,\n    // Route-less; required by `retentionPolicy` (the in-place scrub + audited see-through read).\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.UPDATE_MANY,\n  ],\n\n  customOperation: UserPreferences_Operations,\n\n  operationsConfiguration: {\n    /*\n     * Route-less retention plumbing. INTERNAL_CALL registers NO route, and must not be\n     * REPOSITORY_ONLY: the retention primitives resolve through `getServiceOperationPathDefault`,\n     * which excludes it, so that spelling passes the boot guard and fails when an erasure runs.\n     * LIST is LOW — a read-shaped operation may not claim the HIGH/CRITICAL band, which carries an\n     * audit-emission obligation checked over the real engine catalogue.\n     */\n    [CoreResourceOperation.LIST]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        },\n      ],\n    },\n    [CoreResourceOperation.UPDATE_MANY]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.CRITICAL,\n        },\n      ],\n    },\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          variantKey: \"admin\",\n          roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          // USER_PREFERENCES is the cross-subject administrative door onto the same rows exposed\n          // to a subject by USER_SELF_PREFERENCES. This opt-in is what makes the addressed\n          // `{userId}` an administrator-selected subject rather than forcing it to equal the\n          // caller. The APP_ADMIN_VIEWER role remains the independent authorization gate.\n          admitsCrossSubjectUserAdministration: true,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          // Preferences are seeded by the USERS -> USER_PREFERENCES composition. CREATE remains\n          // enabled only so the trusted lifecycle hook can call createAsSystem; it is not a public\n          // recovery endpoint and does not belong in either API-reference section.\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          variantKey: \"admin\",\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          // Consent settings need before/after evidence even below the automatic risk floor.\n          auditableEvent: { auditBelowRiskFloor: true },\n          admitsCrossSubjectUserAdministration: true,\n          // An administrator acting for the subject still makes a DECISION the server stamps (#534) —\n          // the same hook as the self door, so the two doors onto one record cannot disagree.\n          // Withdraw-only (#534): an administrator never grants consent on a person's behalf.\n          basicPrefixOperation: ({ inputDto, currentObject }) => buildAdministratorConsentDecisionPatch(inputDto, currentObject),\n          authoritativeFields: ['privacy'],\n        }\n      ],\n      userNotifications: [\n        {\n          target: CoreUserNotificationTarget.USER_SELF,\n          channel: CoreUserNotificationChannel.FRONT_END_SUCCESS,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          // The USERS composition cascade needs DELETE to exist, but no actor should delete an\n          // eagerly seeded preferences row through HTTP. The self API has selective reset; the\n          // administration API has UPDATE. Account deletion invokes this internal lifecycle edge.\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        }\n      ],\n    },\n\n    /**\n     * Move a decision the person made BEFORE they had an account onto the account (#1258).\n     *\n     * See {@link UserPreferences_Operations} for why this is a third door rather than a use of\n     * either existing one: the administrator door refuses a granted purpose, and the self door\n     * stamps the server's clock over the instant the visitor actually decided at.\n     *\n     * ## No consent-decision prefix, and that is the point\n     *\n     * Every other write of this field carries one — `buildConsentDecisionPatch` on the self door,\n     * `buildAdministratorConsentDecisionPatch` on the administrative one. This carries NONE, because\n     * the rule was ALREADY applied, by `buildAnonymousConsentCarryPatch`, against the visitor's own\n     * record: which grants were actually offered, whether the offered set covered what this\n     * application asks, and therefore whether an instant may be stamped at all. Re-applying a hook\n     * here would overwrite that answer with a worse one.\n     *\n     * So the payload is authored, not derived, and the operation's job is to store it faithfully.\n     *\n     * ## INTERNAL_CALL: there is no caller to expose this to\n     *\n     * It registers no route. Its only caller is the anonymous→authenticated conversion, which runs\n     * inside authentication with no person at a keyboard. A person changing their own mind uses the\n     * self door; an administrator uses theirs.\n     *\n     * MEDIUM sits below the automatic HIGH/CRITICAL audit floor, so `auditBelowRiskFloor` is what\n     * makes the change leave a row — the same remedy, and the same reasoning, as the two sibling\n     * doors and the lead's CREATE: buying the row by mis-declaring the verb's danger would corrupt\n     * the risk vocabulary every other control reads. Only the marked decision leaves\n     * (`consentedPurposes`) enter the evidence, so the row carries the choice and its\n     * provenance rather than the whole block.\n     *\n     * assurance-control: WILDO.PRIVACY.CONSENT_RECORD — a decision taken before identity is recorded\n     * against the person it belonged to, and the change leaves a trail naming what it moved.\n     */\n    [UserPreferences_Operations.CARRY_ANONYMOUS_CONSENT]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          resourceOperationLike: CoreResourceOperation.UPDATE,\n          requestDto: UserPreferencesCarryAnonymousConsentRequestSchema,\n          auditableEvent: { auditBelowRiskFloor: true },\n        }\n      ],\n    }\n  },\n});\n"]}

package/dist/esm/users/user-profiles.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-profiles.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/users/user-profiles.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAyBzG,oBAAY,uBAAuB;IACjC,aAAa,kBAAkB,CAAE,qBAAqB;IACtD,aAAa,kBAAkB,CAAE,qBAAqB;IACtD,mBAAmB,wBAAwB;CAC5C;AAED,KAAK,0BAA0B,GAC3B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,WAAW,CAAC;AAKtC,eAAO,MAAM,uDAAuD,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;kBAkUpH,CAAC"}
+{"version":3,"file":"user-profiles.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/users/user-profiles.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAyBzG,oBAAY,uBAAuB;IACjC,aAAa,kBAAkB,CAAE,qBAAqB;IACtD,aAAa,kBAAkB,CAAE,qBAAqB;IACtD,mBAAmB,wBAAwB;CAC5C;AAED,KAAK,0BAA0B,GAC3B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,WAAW,CAAC;AAKtC,eAAO,MAAM,uDAAuD,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;kBAgVpH,CAAC"}