@wildo-ai/saas-models 1.1.5 → 1.1.6

package/dist/esm/organizations/organization-notifications.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-notifications.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-notifications.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D;;;;;;;;;;;;;;;;;OAiBG;IACH,mBAAmB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,cAAc,EAAE;IAC1D,cAAc,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACpC,eAAe,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACrC,qBAAqB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAC3C,sBAAsB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAE5C;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACnC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC3C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE;IACtD,6EAA6E;IAC7E,iFAAiF;IACjF,gFAAgF;IAChF,eAAe;IACf,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;IAE9G,6FAA6F;IAC7F,4EAA4E;IAC5E,+EAA+E;IAC/E,0EAA0E;IAC1E,kDAAkD;IAClD,kBAAkB,EAAE,oCAAoC;SACrD,OAAO,CAAC,oCAAoC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACvD,cAAc,EAAE;IAEnB,eAAe;IACf,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;IACnG,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;CACpG,CAAC,CAAC","sourcesContent":["/**\n * Organization Notifications Shared Schemas\n * \n * Notification preferences and settings.\n * Separated from core organization for performance optimization.\n */\n\nimport { z } from 'zod';\n\n/**\n * Per-category notification routing block for an organization.\n *\n * Every interior field is optional (the routing addresses) or carries a\n * `.default(...)` (the category opt-in booleans), so the object is fully\n * materializable from `{}`. Extracted as a named schema so\n * {@link OrganizationNotificationsSchema} can default it via the Zod-4-safe\n * `Schema.default(Schema.parse({}))` idiom — see the `emailNotifications` field.\n */\nexport const OrganizationEmailNotificationsSchema = z.object({\n  /**\n   * Where a tenant's organization-flavoured email goes, and whether it goes at all. READ by the\n   * notification dispatcher since 2026-09-08 (#410).\n   *\n   * It was read by NOTHING before that. The record was seeded by apps-manager at provisioning,\n   * rendered and edited through the organizations preset and audited, while organization-targeted\n   * notifications resolved to member user ids by role and went to each member's own address — so a\n   * tenant that filled this screen in changed nothing.\n   *\n   * The category a notification belongs to is DERIVED from its target: the notification-target\n   * vocabulary and these four categories line up one-for-one, so a per-notification declaration\n   * would only be a place for the two to disagree. `ORGANIZATION_USERS` is deliberately outside the\n   * mapping — it fans out to every member by design, and routing it to one address would change who\n   * the message is FOR rather than where it lands.\n   *\n   * An address REPLACES the member fan-out rather than adding to it: a tenant routing security mail\n   * to a SOC address is saying where it goes, not asking for a copy.\n   */\n  defaultEmailAddress: z.email().optional().isSummaryField(),\n  billingAddress: z.email().optional(),\n  securityAddress: z.email().optional(),\n  administrativeAddress: z.email().optional(),\n  usersManagementAddress: z.email().optional(),\n\n  /**\n   * Category opt-ins. A `false` SUPPRESSES that category entirely — for the members too, not only\n   * for the routing address — because a tenant turning billing notifications off means it.\n   */\n  billing: z.boolean().default(true),\n  administrative: z.boolean().default(true),\n  security: z.boolean().default(true),\n  usersManagement: z.boolean().default(true),\n});\nexport type OrganizationEmailNotifications = z.infer<typeof OrganizationEmailNotificationsSchema>;\n\nexport const OrganizationNotificationsSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  // `.isUnique()` = idempotency backstop for onParentCreate seeding: the eager\n  // `createAsSystem` seed on ORGANIZATIONS create writes one notifications row per\n  // org; the unique index makes a re-fire (retry / replay) fail-closed instead of\n  // duplicating.\n  organizationId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),\n\n  // Email notification preferences. `.default(OrganizationEmailNotificationsSchema.parse({}))`\n  // makes the block materialize to its interior defaults when omitted, so the\n  // resource is default-seedable from its CREATE DTO + parent FK alone (required\n  // by the onParentCreate lifecycle guard). The output type keeps the block\n  // required, so downstream readers are unaffected.\n  emailNotifications: OrganizationEmailNotificationsSchema\n    .default(OrganizationEmailNotificationsSchema.parse({}))\n    .isSummaryField(),\n\n  // Audit fields\n  createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate()\n});\nexport type OrganizationNotifications = z.infer<typeof OrganizationNotificationsSchema>;\n\n"]}
+{"version":3,"file":"organization-notifications.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-notifications.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D;;;;;;;;;;;;;;;;;OAiBG;IACH,mBAAmB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,4WAA4W,CAAC;IACjb,cAAc,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kQAAkQ,CAAC;IACjT,eAAe,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gJAAgJ,CAAC;IAChM,qBAAqB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sJAAsJ,CAAC;IAC5M,sBAAsB,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uJAAuJ,CAAC;IAE9M;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iMAAiM,CAAC;IAC9O,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,+MAA+M,CAAC;IACnQ,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mMAAmM,CAAC;IACjP,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iNAAiN,CAAC;CACvQ,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE;IACtD,6EAA6E;IAC7E,iFAAiF;IACjF,gFAAgF;IAChF,eAAe;IACf,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;IAE9G,6FAA6F;IAC7F,4EAA4E;IAC5E,+EAA+E;IAC/E,0EAA0E;IAC1E,kDAAkD;IAClD,kBAAkB,EAAE,oCAAoC;SACrD,OAAO,CAAC,oCAAoC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACvD,cAAc,EAAE;IAEnB,eAAe;IACf,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;IACnG,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;CACpG,CAAC,CAAC","sourcesContent":["/**\n * Organization Notifications Shared Schemas\n * \n * Notification preferences and settings.\n * Separated from core organization for performance optimization.\n */\n\nimport { z } from 'zod';\n\n/**\n * Per-category notification routing block for an organization.\n *\n * Every interior field is optional (the routing addresses) or carries a\n * `.default(...)` (the category opt-in booleans), so the object is fully\n * materializable from `{}`. Extracted as a named schema so\n * {@link OrganizationNotificationsSchema} can default it via the Zod-4-safe\n * `Schema.default(Schema.parse({}))` idiom — see the `emailNotifications` field.\n */\nexport const OrganizationEmailNotificationsSchema = z.object({\n  /**\n   * Where a tenant's organization-flavoured email goes, and whether it goes at all. READ by the\n   * notification dispatcher since 2026-09-08 (#410).\n   *\n   * It was read by NOTHING before that. The record was seeded by apps-manager at provisioning,\n   * rendered and edited through the organizations preset and audited, while organization-targeted\n   * notifications resolved to member user ids by role and went to each member's own address — so a\n   * tenant that filled this screen in changed nothing.\n   *\n   * The category a notification belongs to is DERIVED from its target: the notification-target\n   * vocabulary and these four categories line up one-for-one, so a per-notification declaration\n   * would only be a place for the two to disagree. `ORGANIZATION_USERS` is deliberately outside the\n   * mapping — it fans out to every member by design, and routing it to one address would change who\n   * the message is FOR rather than where it lands.\n   *\n   * An address REPLACES the member fan-out rather than adding to it: a tenant routing security mail\n   * to a SOC address is saying where it goes, not asking for a copy.\n   */\n  defaultEmailAddress: z.email().optional().isSummaryField().describe(\"Email address that receives the notification emails addressed to the organization itself, and those of a category (billing, security, administrative, user management) that has no address of its own. When set, these emails go to this address instead of to the members who would otherwise receive them. Emails meant for every member are always sent to each member.\"),\n  billingAddress: z.email().optional().describe(\"Email address that receives the organization's billing notification emails instead of its members; when unset, `defaultEmailAddress` is used. It is also given to the payment provider as the customer email when the organization's billing account is created.\"),\n  securityAddress: z.email().optional().describe(\"Email address that receives the organization's security notification emails instead of its members; when unset, `defaultEmailAddress` is used.\"),\n  administrativeAddress: z.email().optional().describe(\"Email address that receives the organization's administrative notification emails instead of its members; when unset, `defaultEmailAddress` is used.\"),\n  usersManagementAddress: z.email().optional().describe(\"Email address that receives the organization's user-management notification emails instead of its members; when unset, `defaultEmailAddress` is used.\"),\n\n  /**\n   * Category opt-ins. A `false` SUPPRESSES that category entirely — for the members too, not only\n   * for the routing address — because a tenant turning billing notifications off means it.\n   */\n  billing: z.boolean().default(true).describe(\"When false, the organization's billing notification emails are not sent at all, neither to `billingAddress` nor to members. Emails only; in-app notifications are unaffected. Defaults to true.\"),\n  administrative: z.boolean().default(true).describe(\"When false, the organization's administrative notification emails are not sent at all, neither to `administrativeAddress` nor to members. Emails only; in-app notifications are unaffected. Defaults to true.\"),\n  security: z.boolean().default(true).describe(\"When false, the organization's security notification emails are not sent at all, neither to `securityAddress` nor to members. Emails only; in-app notifications are unaffected. Defaults to true.\"),\n  usersManagement: z.boolean().default(true).describe(\"When false, the organization's user-management notification emails are not sent at all, neither to `usersManagementAddress` nor to members. Emails only; in-app notifications are unaffected. Defaults to true.\"),\n});\nexport type OrganizationEmailNotifications = z.infer<typeof OrganizationEmailNotificationsSchema>;\n\nexport const OrganizationNotificationsSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  // `.isUnique()` = idempotency backstop for onParentCreate seeding: the eager\n  // `createAsSystem` seed on ORGANIZATIONS create writes one notifications row per\n  // org; the unique index makes a re-fire (retry / replay) fail-closed instead of\n  // duplicating.\n  organizationId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),\n\n  // Email notification preferences. `.default(OrganizationEmailNotificationsSchema.parse({}))`\n  // makes the block materialize to its interior defaults when omitted, so the\n  // resource is default-seedable from its CREATE DTO + parent FK alone (required\n  // by the onParentCreate lifecycle guard). The output type keeps the block\n  // required, so downstream readers are unaffected.\n  emailNotifications: OrganizationEmailNotificationsSchema\n    .default(OrganizationEmailNotificationsSchema.parse({}))\n    .isSummaryField(),\n\n  // Audit fields\n  createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate()\n});\nexport type OrganizationNotifications = z.infer<typeof OrganizationNotificationsSchema>;\n\n"]}

package/dist/esm/organizations/organization-preferences.shared.schemas.js

@@ -10,10 +10,10 @@ import { z } from 'zod';
 import '@wildo-ai/zod-decorators';
 import { AvailableLanguage, TimeFormat, TimezoneSchema, DateFormat } from '@wildo-ai/presets-components-models';
 export const OrganizationLanguagePreferencesSchema = z.object({
-    primaryLanguage: z.enum(AvailableLanguage).systemEnum('AvailableLanguage').default(AvailableLanguage.EN).isSummaryField(),
-    supportedLanguages: z.array(z.enum(AvailableLanguage).systemEnum('AvailableLanguage')).default([AvailableLanguage.EN]),
-    allowUserOverride: z.boolean().default(true),
-    enforceForAllMembers: z.boolean().default(false)
+    primaryLanguage: z.enum(AvailableLanguage).systemEnum('AvailableLanguage').default(AvailableLanguage.EN).isSummaryField().describe("The organization's default interface language. Every member uses it when `enforceForAllMembers` is true or `allowUserOverride` is false, a member who opts into the organization default uses it, and otherwise it applies when a member's own language cannot be used. Ignored when the application does not offer it. Defaults to `en`."),
+    supportedLanguages: z.array(z.enum(AvailableLanguage).systemEnum('AvailableLanguage')).default([AvailableLanguage.EN]).describe("The interface languages this organization's members may use, limited to those the application offers; `primaryLanguage` is always included. When none of them is offered by the application, every language the application offers stays available. Defaults to `[\"en\"]`."),
+    allowUserOverride: z.boolean().default(true).describe("When false, members cannot use a language of their own choosing and the interface uses `primaryLanguage` for all of them. Defaults to true."),
+    enforceForAllMembers: z.boolean().default(false).describe("When true, every member's interface uses `primaryLanguage`, whatever language they chose for themselves. Defaults to false.")
 });
 export const OrganizationPreferencesSchema = z.object({
     _id: z.string().min(1).isPrimaryKey().isSummaryField(),

package/dist/esm/organizations/organization-preferences.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-preferences.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-preferences.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Preferences Shared Schemas\n * \n * Localization, regional settings, and application preferences.\n * Separated from core organization for performance optimization.\n */\n\nimport { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first —\n// never by the importer's luck (#966). A named import used only as a type would be elided and install nothing.\nimport '@wildo-ai/zod-decorators';\nimport { AvailableLanguage, TimeFormat, TimezoneSchema, DateFormat } from '@wildo-ai/presets-components-models';\n\nexport const OrganizationLanguagePreferencesSchema = z.object({\n  primaryLanguage: z.enum(AvailableLanguage).systemEnum('AvailableLanguage').default(AvailableLanguage.EN).isSummaryField(),\n  supportedLanguages: z.array(z.enum(AvailableLanguage).systemEnum('AvailableLanguage')).default([AvailableLanguage.EN]),\n  allowUserOverride: z.boolean().default(true),\n  enforceForAllMembers: z.boolean().default(false)\n});\nexport type OrganizationLanguagePreferences = z.infer<typeof OrganizationLanguagePreferencesSchema>;\n\nexport const OrganizationPreferencesSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  // `.isUnique()` = idempotency backstop for onParentCreate seeding: the eager\n  // `createAsSystem` seed on ORGANIZATIONS create writes one preferences row per\n  // org; the unique index makes a re-fire (retry / replay) fail-closed instead of\n  // duplicating.\n  organizationId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),\n  \n  // Regional settings\n  // Default 'UTC' (a valid `CommonTimezone`), NOT 'US_SHORT' — that was a\n  // `DateFormat` value mistakenly used here. `TimezoneSchema` is a\n  // `union([enum(CommonTimezone), string])`, so Zod accepted the bad string\n  // (the onParentCreate boot-guard probe passed), but the Mongoose model enforces\n  // the enum and rejected 'US_SHORT' at seed time → the org preferences row failed\n  // to eager-seed. Mirrors the USER preferences `timezone` default. See\n  // composition-oncreate-lifecycle plan (W3 runtime-verify).\n  timezone: TimezoneSchema.default('UTC').isDBIndexed().isSummaryField(),\n  locale: z.enum(AvailableLanguage).systemEnum('AvailableLanguage').default(AvailableLanguage.EN).isDBIndexed().isSummaryField(),\n  // LOCALE_DEFAULT (not ISO_8601): mirrors the USER preferences default — see the\n  // rationale on `UserPreferences_RegionalSchema.dateFormat`.\n  dateFormat: z.enum(DateFormat).systemEnum('DateFormat').default(DateFormat.LOCALE_DEFAULT).isDBIndexed(),\n  timeFormat: z.enum(TimeFormat).systemEnum('TimeFormat').default(TimeFormat.TWENTY_FOUR_HOUR).isDBIndexed(),\n  \n  // Language preferences\n  languagePreferences: OrganizationLanguagePreferencesSchema.default(OrganizationLanguagePreferencesSchema.parse({})).isSummaryField(),\n  \n  allowMemberEmailOverride: z.boolean().default(true).isDBIndexed(),\n  \n  // Audit fields\n  createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate()\n});\nexport type OrganizationPreferences = z.infer<typeof OrganizationPreferencesSchema>;\n\n/**\n * The tenant's regional answer, as the DEFAULT LAYER beneath a member's own (#410).\n *\n * These four fields sit at the top level of {@link OrganizationPreferencesSchema} because they are\n * the organization's own settings, not a sub-record; this is a derived VIEW of them, so the two can\n * never drift. It exists because the frontend needs to carry exactly this much of the tenant's\n * preferences record to `I18nContext` — sending the whole record would put `_id`, audit fields and\n * the member-email-override policy on an event that has no use for any of them.\n *\n * The resolution `I18nContext` performs is: the member's own value, then this, then the framework\n * fallback. A member's explicit choice always wins — that is why\n * {@link UserPreferences_RegionalSchema}'s four fields are optional, so \"the member expressed\n * nothing\" is representable at all.\n *\n * Unlike the member's block, these fields keep their defaults, and that is correct rather than an\n * oversight: the organization record is seeded at provisioning and always exists, so its values ARE\n * the tenant's answer. A tenant that has edited nothing answers with the same four values the\n * framework would have used, which makes the layer a no-op for it — exactly as it should be.\n */\nexport const OrganizationRegionalPreferencesSchema = OrganizationPreferencesSchema.pick({\n  timezone: true,\n  locale: true,\n  dateFormat: true,\n  timeFormat: true,\n});\nexport type OrganizationRegionalPreferences = z.infer<typeof OrganizationRegionalPreferencesSchema>;\n"]}
+{"version":3,"file":"organization-preferences.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-preferences.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Preferences Shared Schemas\n * \n * Localization, regional settings, and application preferences.\n * Separated from core organization for performance optimization.\n */\n\nimport { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first —\n// never by the importer's luck (#966). A named import used only as a type would be elided and install nothing.\nimport '@wildo-ai/zod-decorators';\nimport { AvailableLanguage, TimeFormat, TimezoneSchema, DateFormat } from '@wildo-ai/presets-components-models';\n\nexport const OrganizationLanguagePreferencesSchema = z.object({\n  primaryLanguage: z.enum(AvailableLanguage).systemEnum('AvailableLanguage').default(AvailableLanguage.EN).isSummaryField().describe(\"The organization's default interface language. Every member uses it when `enforceForAllMembers` is true or `allowUserOverride` is false, a member who opts into the organization default uses it, and otherwise it applies when a member's own language cannot be used. Ignored when the application does not offer it. Defaults to `en`.\"),\n  supportedLanguages: z.array(z.enum(AvailableLanguage).systemEnum('AvailableLanguage')).default([AvailableLanguage.EN]).describe(\"The interface languages this organization's members may use, limited to those the application offers; `primaryLanguage` is always included. When none of them is offered by the application, every language the application offers stays available. Defaults to `[\\\"en\\\"]`.\"),\n  allowUserOverride: z.boolean().default(true).describe(\"When false, members cannot use a language of their own choosing and the interface uses `primaryLanguage` for all of them. Defaults to true.\"),\n  enforceForAllMembers: z.boolean().default(false).describe(\"When true, every member's interface uses `primaryLanguage`, whatever language they chose for themselves. Defaults to false.\")\n});\nexport type OrganizationLanguagePreferences = z.infer<typeof OrganizationLanguagePreferencesSchema>;\n\nexport const OrganizationPreferencesSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  // `.isUnique()` = idempotency backstop for onParentCreate seeding: the eager\n  // `createAsSystem` seed on ORGANIZATIONS create writes one preferences row per\n  // org; the unique index makes a re-fire (retry / replay) fail-closed instead of\n  // duplicating.\n  organizationId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),\n  \n  // Regional settings\n  // Default 'UTC' (a valid `CommonTimezone`), NOT 'US_SHORT' — that was a\n  // `DateFormat` value mistakenly used here. `TimezoneSchema` is a\n  // `union([enum(CommonTimezone), string])`, so Zod accepted the bad string\n  // (the onParentCreate boot-guard probe passed), but the Mongoose model enforces\n  // the enum and rejected 'US_SHORT' at seed time → the org preferences row failed\n  // to eager-seed. Mirrors the USER preferences `timezone` default. See\n  // composition-oncreate-lifecycle plan (W3 runtime-verify).\n  timezone: TimezoneSchema.default('UTC').isDBIndexed().isSummaryField(),\n  locale: z.enum(AvailableLanguage).systemEnum('AvailableLanguage').default(AvailableLanguage.EN).isDBIndexed().isSummaryField(),\n  // LOCALE_DEFAULT (not ISO_8601): mirrors the USER preferences default — see the\n  // rationale on `UserPreferences_RegionalSchema.dateFormat`.\n  dateFormat: z.enum(DateFormat).systemEnum('DateFormat').default(DateFormat.LOCALE_DEFAULT).isDBIndexed(),\n  timeFormat: z.enum(TimeFormat).systemEnum('TimeFormat').default(TimeFormat.TWENTY_FOUR_HOUR).isDBIndexed(),\n  \n  // Language preferences\n  languagePreferences: OrganizationLanguagePreferencesSchema.default(OrganizationLanguagePreferencesSchema.parse({})).isSummaryField(),\n  \n  allowMemberEmailOverride: z.boolean().default(true).isDBIndexed(),\n  \n  // Audit fields\n  createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate()\n});\nexport type OrganizationPreferences = z.infer<typeof OrganizationPreferencesSchema>;\n\n/**\n * The tenant's regional answer, as the DEFAULT LAYER beneath a member's own (#410).\n *\n * These four fields sit at the top level of {@link OrganizationPreferencesSchema} because they are\n * the organization's own settings, not a sub-record; this is a derived VIEW of them, so the two can\n * never drift. It exists because the frontend needs to carry exactly this much of the tenant's\n * preferences record to `I18nContext` — sending the whole record would put `_id`, audit fields and\n * the member-email-override policy on an event that has no use for any of them.\n *\n * The resolution `I18nContext` performs is: the member's own value, then this, then the framework\n * fallback. A member's explicit choice always wins — that is why\n * {@link UserPreferences_RegionalSchema}'s four fields are optional, so \"the member expressed\n * nothing\" is representable at all.\n *\n * Unlike the member's block, these fields keep their defaults, and that is correct rather than an\n * oversight: the organization record is seeded at provisioning and always exists, so its values ARE\n * the tenant's answer. A tenant that has edited nothing answers with the same four values the\n * framework would have used, which makes the layer a no-op for it — exactly as it should be.\n */\nexport const OrganizationRegionalPreferencesSchema = OrganizationPreferencesSchema.pick({\n  timezone: true,\n  locale: true,\n  dateFormat: true,\n  timeFormat: true,\n});\nexport type OrganizationRegionalPreferences = z.infer<typeof OrganizationRegionalPreferencesSchema>;\n"]}

package/dist/esm/organizations/organization-profile.shared.resources-config.schemas.d.ts

@@ -37,7 +37,6 @@ export declare const organizationProfileResourceConfiguration_InitializationFact
         favicon: z.ZodOptional<z.ZodURL>;
         primaryColor: z.ZodOptional<z.ZodString>;
         secondaryColor: z.ZodOptional<z.ZodString>;
-        customDomain: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     socialLinks: z.ZodOptional<z.ZodObject<{
         linkedin: z.ZodOptional<z.ZodURL>;

package/dist/esm/organizations/organization-profile.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization-profile.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-profile.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAoD,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAW/H,oBAAY,8BAA8B;IACxC,eAAe,oBAAoB;CACpC;AAED,KAAK,iCAAiC,GAClC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAKjC,eAAO,MAAM,8DAA8D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgH3H,CAAC"}
+{"version":3,"file":"organization-profile.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-profile.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAoD,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAW/H,oBAAY,8BAA8B;IACxC,eAAe,oBAAoB;CACpC;AAED,KAAK,iCAAiC,GAClC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAKjC,eAAO,MAAM,8DAA8D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgH3H,CAAC"}

package/dist/esm/organizations/organization-profile.shared.schemas.d.ts

@@ -30,7 +30,6 @@ export declare const OrganizationBrandingSchema: z.ZodObject<{
     favicon: z.ZodOptional<z.ZodURL>;
     primaryColor: z.ZodOptional<z.ZodString>;
     secondaryColor: z.ZodOptional<z.ZodString>;
-    customDomain: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type OrganizationBranding = z.infer<typeof OrganizationBrandingSchema>;
 /**
@@ -49,9 +48,10 @@ export type OrganizationBranding = z.infer<typeof OrganizationBrandingSchema>;
  * how the application's own logo is chosen. The caller keeps that; this owns only the precedence,
  * which is the part worth having one copy of.
  *
- * `favicon` and `secondaryColor` are deliberately absent: the DTO that carries this to a login
- * screen has no field for either, so resolving them would produce values nothing transports. Adding
- * them is a DTO decision first.
+ * `faviconUrl` is the tenant's or nothing: the application's own icon is already the page's, so the
+ * sign-in page swaps it only for a tenant that set one (#1799). `secondaryColor` is deliberately
+ * absent: the DTO that carries this to a login screen has no field for it, so resolving it would
+ * produce a value nothing transports. Adding it is a DTO decision first.
  */
 export declare function resolveTenantBrandPresentation(branding: OrganizationBranding | null | undefined, applicationBrand: {
     logoUrl?: string;
@@ -59,6 +59,7 @@ export declare function resolveTenantBrandPresentation(branding: OrganizationBra
 }): {
     logoUrl?: string;
     primaryColor?: string;
+    faviconUrl?: string;
 };
 export declare const OrganizationProfileSchema: z.ZodObject<{
     _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
@@ -85,7 +86,6 @@ export declare const OrganizationProfileSchema: z.ZodObject<{
         favicon: z.ZodOptional<z.ZodURL>;
         primaryColor: z.ZodOptional<z.ZodString>;
         secondaryColor: z.ZodOptional<z.ZodString>;
-        customDomain: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     socialLinks: z.ZodOptional<z.ZodObject<{
         linkedin: z.ZodOptional<z.ZodURL>;

package/dist/esm/organizations/organization-profile.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization-profile.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-profile.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,oBAAY,gBAAgB;IAC1B,OAAO,YAAY,CAAY,iBAAiB;IAChD,KAAK,UAAU,CAAgB,kBAAkB;IACjD,MAAM,WAAW,CAAc,mBAAmB;IAClD,KAAK,UAAU,CAAgB,qBAAqB;IACpD,UAAU,eAAe;CAC1B;AAED,oBAAY,oBAAoB;IAC9B,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAID,eAAO,MAAM,0BAA0B;;;;;;iBA+BrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EACjD,gBAAgB,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAK7C;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"organization-profile.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-profile.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,oBAAY,gBAAgB;IAC1B,OAAO,YAAY,CAAY,iBAAiB;IAChD,KAAK,UAAU,CAAgB,kBAAkB;IACjD,MAAM,WAAW,CAAc,mBAAmB;IAClD,KAAK,UAAU,CAAgB,qBAAqB;IACpD,UAAU,eAAe;CAC1B;AAED,oBAAY,oBAAoB;IAC9B,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAID,eAAO,MAAM,0BAA0B;;;;;iBAkCrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EACjD,gBAAgB,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAMlE;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/esm/organizations/organization-profile.shared.schemas.js

@@ -58,11 +58,14 @@ export const OrganizationBrandingSchema = z.object({
      * backend-populated `logoUrl` output fields (auth-response / email context)
      * that accept app-relative brand-asset paths.
      */
-    logo: z.url().optional(),
-    favicon: z.url().optional(),
+    logo: z.url().optional().describe("Absolute URL of the organization's logo. On the sign-in page, people whose email domain signs in through this organization's single sign-on see it in place of the application's logo."),
+    favicon: z.url().optional().describe("Absolute URL of the organization's browser-tab icon. On the sign-in page, people whose email domain signs in through this organization's single sign-on see it in the tab while the organization's sign-in card is shown."),
     primaryColor: ZodTypeForColors.optional(),
     secondaryColor: ZodTypeForColors.optional(),
-    customDomain: z.string().min(1).max(100).optional(),
+    // `customDomain` was removed (#1799). Nothing resolved an organization from a request's host, and
+    // serving an application on a tenant's own domain needs host routing, certificates, CORS, cookie and
+    // redirect-URI handling and domain verification — a feature, not a field. An administrator who set it
+    // believed a domain was configured and nothing was.
 });
 /**
  * What a tenant's own sign-in screen should show: the ORGANIZATION's branding when it declared any,
@@ -80,14 +83,16 @@ export const OrganizationBrandingSchema = z.object({
  * how the application's own logo is chosen. The caller keeps that; this owns only the precedence,
  * which is the part worth having one copy of.
  *
- * `favicon` and `secondaryColor` are deliberately absent: the DTO that carries this to a login
- * screen has no field for either, so resolving them would produce values nothing transports. Adding
- * them is a DTO decision first.
+ * `faviconUrl` is the tenant's or nothing: the application's own icon is already the page's, so the
+ * sign-in page swaps it only for a tenant that set one (#1799). `secondaryColor` is deliberately
+ * absent: the DTO that carries this to a login screen has no field for it, so resolving it would
+ * produce a value nothing transports. Adding it is a DTO decision first.
  */
 export function resolveTenantBrandPresentation(branding, applicationBrand) {
     return {
         logoUrl: branding?.logo ?? applicationBrand.logoUrl,
         primaryColor: branding?.primaryColor ?? applicationBrand.primaryColor,
+        ...(branding?.favicon ? { faviconUrl: branding.favicon } : {}),
     };
 }
 export const OrganizationProfileSchema = z.object({
@@ -112,10 +117,10 @@ export const OrganizationProfileSchema = z.object({
     branding: OrganizationBrandingSchema.default(OrganizationBrandingSchema.parse({})),
     // Social links
     socialLinks: z.object({
-        linkedin: z.url().optional(),
-        twitter: z.url().optional(),
-        facebook: z.url().optional(),
-        github: z.url().optional()
+        linkedin: z.url().optional().describe("URL of the organization's LinkedIn page."),
+        twitter: z.url().optional().describe("URL of the organization's X (Twitter) profile."),
+        facebook: z.url().optional().describe("URL of the organization's Facebook page."),
+        github: z.url().optional().describe("URL of the organization's GitHub profile.")
     }).optional(),
     // Audit fields
     createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),

package/dist/esm/organizations/organization-profile.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-profile.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-profile.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Profile Shared Schemas\n * \n * Company information, branding, and public profile data.\n * Separated from core organization for performance optimization.\n */\n\nimport { z } from 'zod';\nimport { AddressSchema } from '@wildo-ai/presets-components-models';\nimport { ZodTypeForColors } from '@wildo-ai/zod-decorators';\nimport { CommonTimezone, TimezoneSchema } from '@wildo-ai/presets-components-models';\n\n// Organization classification enums\nexport enum OrganizationSize {\n  STARTUP = 'STARTUP',           // 1-10 employees\n  SMALL = 'SMALL',               // 11-50 employees\n  MEDIUM = 'MEDIUM',             // 51-200 employees\n  LARGE = 'LARGE',               // 201-1000 employees\n  ENTERPRISE = 'ENTERPRISE'      // 1000+ employees\n}\n\nexport enum OrganizationIndustry {\n  TECHNOLOGY = 'TECHNOLOGY',\n  FINANCE = 'FINANCE',\n  HEALTHCARE = 'HEALTHCARE',\n  EDUCATION = 'EDUCATION',\n  RETAIL = 'RETAIL',\n  MANUFACTURING = 'MANUFACTURING',\n  CONSULTING = 'CONSULTING',\n  MEDIA = 'MEDIA',\n  GOVERNMENT = 'GOVERNMENT',\n  NONPROFIT = 'NONPROFIT',\n  OTHER = 'OTHER'\n}\n\n// Address Schema\n\nexport const OrganizationBrandingSchema = z.object({\n  /**\n   * Per-org logo (user-authored, absolute URL), resolved into identification by #410 and consumed by the standard login card in #651.\n   *\n   * A tenant that uploads a logo now sees it on its own sign-in page: the identification response\n   * resolves this first and falls back to the application's own brand assets. See\n   * {@link resolveTenantBrandPresentation}, which owns the precedence.\n   *\n   * **The audit note this replaces was accurate and its conclusion was wrong**, and the way it went\n   * wrong is worth keeping. It read: *\"the one place that surfaces an organization's branding logo\n   * to a DTO is the auth login response, and it ALREADY applies the app-level default: at\n   * identification time only a domain was matched (the org profile is not loaded) … Because the only\n   * surfacing seam is already handled, no additional backend fallback seam is introduced here\n   * (invented seams are avoided by design).\"*\n   *\n   * Every factual clause held. But \"the org profile is not loaded\" described what the code DID, not\n   * what it could do — the domain lookup resolves `scopeId`, which is the organization id, so the\n   * profile was always one read away. Reasoning from the current call graph to \"no seam is needed\"\n   * turned an unfinished implementation into a documented design decision, and it then justified\n   * leaving the field inert for as long as anyone read the note. Avoiding invented seams is right;\n   * this seam was not invented, it was the one the field exists for.\n   *\n   * Kept `z.url()` (absolute) because this is direct user input, unlike the\n   * backend-populated `logoUrl` output fields (auth-response / email context)\n   * that accept app-relative brand-asset paths.\n   */\n  logo: z.url().optional(),\n  favicon: z.url().optional(),\n  primaryColor: ZodTypeForColors.optional(),\n  secondaryColor: ZodTypeForColors.optional(),\n  customDomain: z.string().min(1).max(100).optional(),\n});\nexport type OrganizationBranding = z.infer<typeof OrganizationBrandingSchema>;\n\n/**\n * What a tenant's own sign-in screen should show: the ORGANIZATION's branding when it declared any,\n * otherwise the application's (#410).\n *\n * Per field, not per record — a tenant that uploaded a logo and never picked a colour keeps the\n * caller's colour fallback, if one exists. Authentication identification supplies no application colour;\n * its standard login consumer keeps application theme tokens and uses a supplied tenant colour only as\n * a decorative identity accent. Resolving the record as a unit would make one\n * expressed field silence the others, which is the same trap the regional-preferences layer had to\n * avoid.\n *\n * A pure function taking the application's ALREADY-RESOLVED values, so it can live beside the schema\n * it resolves without this module knowing anything about brand assets, configuration services or\n * how the application's own logo is chosen. The caller keeps that; this owns only the precedence,\n * which is the part worth having one copy of.\n *\n * `favicon` and `secondaryColor` are deliberately absent: the DTO that carries this to a login\n * screen has no field for either, so resolving them would produce values nothing transports. Adding\n * them is a DTO decision first.\n */\nexport function resolveTenantBrandPresentation(\n  branding: OrganizationBranding | null | undefined,\n  applicationBrand: { logoUrl?: string; primaryColor?: string },\n): { logoUrl?: string; primaryColor?: string } {\n  return {\n    logoUrl: branding?.logo ?? applicationBrand.logoUrl,\n    primaryColor: branding?.primaryColor ?? applicationBrand.primaryColor,\n  };\n}\n\nexport const OrganizationProfileSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  \n  // Company information\n  displayName: z.string().max(100).optional().isDBIndexed().isSummaryField(),\n  domain: z.string().min(1).max(100).optional().isDBIndexed(),\n  phone: z.string().max(20).optional(),\n  website: z.url().optional(),\n  description: z.string().max(500).optional(),\n  \n  // Classification\n  industry: z.enum(OrganizationIndustry).optional().isDBIndexed(),\n  size: z.enum(OrganizationSize).optional().isDBIndexed(),\n  founded: z.date().optional(),\n  \n  // Location\n  address: AddressSchema.optional(),\n  timezone: z.string().default(CommonTimezone.UTC).isDBIndexed(),\n  \n  // Branding\n  // `.default(...)` (interior fully optional/defaulted) so the row is eager-seedable\n  // via onParentCreate — root-cause fix, consistent with sibling defaulted objects.\n  branding: OrganizationBrandingSchema.default(OrganizationBrandingSchema.parse({})),\n  \n  // Social links\n  socialLinks: z.object({\n    linkedin: z.url().optional(),\n    twitter: z.url().optional(),\n    facebook: z.url().optional(),\n    github: z.url().optional()\n  }).optional(),\n  \n  // Audit fields\n  createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate()\n});\nexport type OrganizationProfile = z.infer<typeof OrganizationProfileSchema>; "]}
+{"version":3,"file":"organization-profile.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-profile.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Profile Shared Schemas\n * \n * Company information, branding, and public profile data.\n * Separated from core organization for performance optimization.\n */\n\nimport { z } from 'zod';\nimport { AddressSchema } from '@wildo-ai/presets-components-models';\nimport { ZodTypeForColors } from '@wildo-ai/zod-decorators';\nimport { CommonTimezone, TimezoneSchema } from '@wildo-ai/presets-components-models';\n\n// Organization classification enums\nexport enum OrganizationSize {\n  STARTUP = 'STARTUP',           // 1-10 employees\n  SMALL = 'SMALL',               // 11-50 employees\n  MEDIUM = 'MEDIUM',             // 51-200 employees\n  LARGE = 'LARGE',               // 201-1000 employees\n  ENTERPRISE = 'ENTERPRISE'      // 1000+ employees\n}\n\nexport enum OrganizationIndustry {\n  TECHNOLOGY = 'TECHNOLOGY',\n  FINANCE = 'FINANCE',\n  HEALTHCARE = 'HEALTHCARE',\n  EDUCATION = 'EDUCATION',\n  RETAIL = 'RETAIL',\n  MANUFACTURING = 'MANUFACTURING',\n  CONSULTING = 'CONSULTING',\n  MEDIA = 'MEDIA',\n  GOVERNMENT = 'GOVERNMENT',\n  NONPROFIT = 'NONPROFIT',\n  OTHER = 'OTHER'\n}\n\n// Address Schema\n\nexport const OrganizationBrandingSchema = z.object({\n  /**\n   * Per-org logo (user-authored, absolute URL), resolved into identification by #410 and consumed by the standard login card in #651.\n   *\n   * A tenant that uploads a logo now sees it on its own sign-in page: the identification response\n   * resolves this first and falls back to the application's own brand assets. See\n   * {@link resolveTenantBrandPresentation}, which owns the precedence.\n   *\n   * **The audit note this replaces was accurate and its conclusion was wrong**, and the way it went\n   * wrong is worth keeping. It read: *\"the one place that surfaces an organization's branding logo\n   * to a DTO is the auth login response, and it ALREADY applies the app-level default: at\n   * identification time only a domain was matched (the org profile is not loaded) … Because the only\n   * surfacing seam is already handled, no additional backend fallback seam is introduced here\n   * (invented seams are avoided by design).\"*\n   *\n   * Every factual clause held. But \"the org profile is not loaded\" described what the code DID, not\n   * what it could do — the domain lookup resolves `scopeId`, which is the organization id, so the\n   * profile was always one read away. Reasoning from the current call graph to \"no seam is needed\"\n   * turned an unfinished implementation into a documented design decision, and it then justified\n   * leaving the field inert for as long as anyone read the note. Avoiding invented seams is right;\n   * this seam was not invented, it was the one the field exists for.\n   *\n   * Kept `z.url()` (absolute) because this is direct user input, unlike the\n   * backend-populated `logoUrl` output fields (auth-response / email context)\n   * that accept app-relative brand-asset paths.\n   */\n  logo: z.url().optional().describe(\"Absolute URL of the organization's logo. On the sign-in page, people whose email domain signs in through this organization's single sign-on see it in place of the application's logo.\"),\n  favicon: z.url().optional().describe(\"Absolute URL of the organization's browser-tab icon. On the sign-in page, people whose email domain signs in through this organization's single sign-on see it in the tab while the organization's sign-in card is shown.\"),\n  primaryColor: ZodTypeForColors.optional(),\n  secondaryColor: ZodTypeForColors.optional(),\n  // `customDomain` was removed (#1799). Nothing resolved an organization from a request's host, and\n  // serving an application on a tenant's own domain needs host routing, certificates, CORS, cookie and\n  // redirect-URI handling and domain verification — a feature, not a field. An administrator who set it\n  // believed a domain was configured and nothing was.\n});\nexport type OrganizationBranding = z.infer<typeof OrganizationBrandingSchema>;\n\n/**\n * What a tenant's own sign-in screen should show: the ORGANIZATION's branding when it declared any,\n * otherwise the application's (#410).\n *\n * Per field, not per record — a tenant that uploaded a logo and never picked a colour keeps the\n * caller's colour fallback, if one exists. Authentication identification supplies no application colour;\n * its standard login consumer keeps application theme tokens and uses a supplied tenant colour only as\n * a decorative identity accent. Resolving the record as a unit would make one\n * expressed field silence the others, which is the same trap the regional-preferences layer had to\n * avoid.\n *\n * A pure function taking the application's ALREADY-RESOLVED values, so it can live beside the schema\n * it resolves without this module knowing anything about brand assets, configuration services or\n * how the application's own logo is chosen. The caller keeps that; this owns only the precedence,\n * which is the part worth having one copy of.\n *\n * `faviconUrl` is the tenant's or nothing: the application's own icon is already the page's, so the\n * sign-in page swaps it only for a tenant that set one (#1799). `secondaryColor` is deliberately\n * absent: the DTO that carries this to a login screen has no field for it, so resolving it would\n * produce a value nothing transports. Adding it is a DTO decision first.\n */\nexport function resolveTenantBrandPresentation(\n  branding: OrganizationBranding | null | undefined,\n  applicationBrand: { logoUrl?: string; primaryColor?: string },\n): { logoUrl?: string; primaryColor?: string; faviconUrl?: string } {\n  return {\n    logoUrl: branding?.logo ?? applicationBrand.logoUrl,\n    primaryColor: branding?.primaryColor ?? applicationBrand.primaryColor,\n    ...(branding?.favicon ? { faviconUrl: branding.favicon } : {}),\n  };\n}\n\nexport const OrganizationProfileSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  \n  // Company information\n  displayName: z.string().max(100).optional().isDBIndexed().isSummaryField(),\n  domain: z.string().min(1).max(100).optional().isDBIndexed(),\n  phone: z.string().max(20).optional(),\n  website: z.url().optional(),\n  description: z.string().max(500).optional(),\n  \n  // Classification\n  industry: z.enum(OrganizationIndustry).optional().isDBIndexed(),\n  size: z.enum(OrganizationSize).optional().isDBIndexed(),\n  founded: z.date().optional(),\n  \n  // Location\n  address: AddressSchema.optional(),\n  timezone: z.string().default(CommonTimezone.UTC).isDBIndexed(),\n  \n  // Branding\n  // `.default(...)` (interior fully optional/defaulted) so the row is eager-seedable\n  // via onParentCreate — root-cause fix, consistent with sibling defaulted objects.\n  branding: OrganizationBrandingSchema.default(OrganizationBrandingSchema.parse({})),\n  \n  // Social links\n  socialLinks: z.object({\n    linkedin: z.url().optional().describe(\"URL of the organization's LinkedIn page.\"),\n    twitter: z.url().optional().describe(\"URL of the organization's X (Twitter) profile.\"),\n    facebook: z.url().optional().describe(\"URL of the organization's Facebook page.\"),\n    github: z.url().optional().describe(\"URL of the organization's GitHub profile.\")\n  }).optional(),\n  \n  // Audit fields\n  createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate()\n});\nexport type OrganizationProfile = z.infer<typeof OrganizationProfileSchema>; "]}

package/dist/esm/organizations/organization-unit-members.shared.resources-config.schemas.js

@@ -16,7 +16,7 @@ import { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas.
 const ORGANIZATION_UNIT_MEMBER_FILTER_FIELDS = {
     organizationUnitId: z.string(),
     organizationMemberId: z.string(),
-    role: z.string(),
+    role: z.string().describe('Only return assignments that hold exactly this role inside their unit.'),
 };
 /**
  * Organization Unit Member Resource Configuration Factory.

package/dist/esm/organizations/organization-unit-members.shared.resources-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-unit-members.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-members.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Unit Member Shared Resource Configuration\n *\n * The junction resource that replaced `OrganizationMember.organizationUnitsMembership` (plan\n * decision D-B5). See {@link OrganizationUnitMemberSchema} for why the embedded array could not\n * carry these semantics.\n */\n\nimport { z } from 'zod';\nimport { OrganizationUnitMemberSchema } from './organization-unit-members.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';\n\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\n\nimport { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\n\nconst ORGANIZATION_UNIT_MEMBER_FILTER_FIELDS = {\n  organizationUnitId: z.string(),\n  organizationMemberId: z.string(),\n  role: z.string(),\n};\n\ntype OrganizationUnitMemberCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.DELETE;\n\n/**\n * Organization Unit Member Resource Configuration Factory.\n *\n * Read access is ORG_MEMBER (the org chart and who sits where is ordinary directory information\n * inside a tenant); every WRITE is ORG_ADMIN, because a unit assignment is a role grant and becomes\n * live authority once WS-C wires units into authorization.\n */\nexport const organizationUnitMemberResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  Record<string, never>,\n  OrganizationUnitMemberCoreOperations,\n  typeof OrganizationUnitMemberSchema\n>({\n  mainSchema: OrganizationUnitMemberSchema,\n  resourceIdentifier: CoreResourceType.ORGANIZATION_UNIT_MEMBERS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATION_UNIT_MEMBERS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.DELETE,\n  ],\n\n  operationsConfiguration: {\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          // A unit assignment is a role grant; the role-ceiling gate additionally bounds WHICH role\n          // an admin may grant here.\n          roles: [CORE_ORG_ROLES.ORG_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.LIST]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          filterFields: ORGANIZATION_UNIT_MEMBER_FILTER_FIELDS,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        },\n      ],\n    },\n  },\n});\n"]}
+{"version":3,"file":"organization-unit-members.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-members.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Organization Unit Member Shared Resource Configuration\n *\n * The junction resource that replaced `OrganizationMember.organizationUnitsMembership` (plan\n * decision D-B5). See {@link OrganizationUnitMemberSchema} for why the embedded array could not\n * carry these semantics.\n */\n\nimport { z } from 'zod';\nimport { OrganizationUnitMemberSchema } from './organization-unit-members.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';\n\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\n\nimport { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\n\nconst ORGANIZATION_UNIT_MEMBER_FILTER_FIELDS = {\n  organizationUnitId: z.string(),\n  organizationMemberId: z.string(),\n  role: z.string().describe('Only return assignments that hold exactly this role inside their unit.'),\n};\n\ntype OrganizationUnitMemberCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.DELETE;\n\n/**\n * Organization Unit Member Resource Configuration Factory.\n *\n * Read access is ORG_MEMBER (the org chart and who sits where is ordinary directory information\n * inside a tenant); every WRITE is ORG_ADMIN, because a unit assignment is a role grant and becomes\n * live authority once WS-C wires units into authorization.\n */\nexport const organizationUnitMemberResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  Record<string, never>,\n  OrganizationUnitMemberCoreOperations,\n  typeof OrganizationUnitMemberSchema\n>({\n  mainSchema: OrganizationUnitMemberSchema,\n  resourceIdentifier: CoreResourceType.ORGANIZATION_UNIT_MEMBERS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATION_UNIT_MEMBERS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.DELETE,\n  ],\n\n  operationsConfiguration: {\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          // A unit assignment is a role grant; the role-ceiling gate additionally bounds WHICH role\n          // an admin may grant here.\n          roles: [CORE_ORG_ROLES.ORG_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.LIST]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          filterFields: ORGANIZATION_UNIT_MEMBER_FILTER_FIELDS,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        },\n      ],\n    },\n\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        },\n      ],\n    },\n  },\n});\n"]}

package/dist/esm/organizations/organization-unit-members.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization-unit-members.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-members.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,4BAA4B;;;;;;;;kBA4CvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}
+{"version":3,"file":"organization-unit-members.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-members.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,4BAA4B;;;;;;;;kBA6CvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/esm/organizations/organization-unit-members.shared.schemas.js

@@ -82,7 +82,8 @@ export const OrganizationUnitMemberSchema = z.object({
      * itself hold. Because a custom implementation resolves by an exact operation-path key, each path
      * carries the gate explicitly; neither inherits it from the other.
      */
-    role: OrgRolesSchema.isDBIndexed().isSummaryField(),
+    role: OrgRolesSchema.isDBIndexed().isSummaryField()
+        .describe('The role the member holds inside this unit: a core organization role or one the application defines. A caller cannot grant a role it does not hold itself.'),
     createdAt: z.date().default(() => new Date()).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),
     updatedAt: z.date().default(() => new Date()).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),
 }).businessKeySet([

package/dist/esm/organizations/organization-unit-members.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"organization-unit-members.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-members.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE;IACtD;;;;OAIG;IACH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;IACnG,yDAAyD;IACzD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;IACvG;;;;;;;;;;;;OAYG;IACH,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;IACzG;;;;;;;;;;;;;OAaG;IACH,IAAI,EAAE,cAAc,CAAC,WAAW,EAAE,CAAC,cAAc,EAAE;IACnD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;IAC9G,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;CAC/G,CAAC,CAAC,cAAc,CAAC;IAChB,sBAAsB;IACtB,oBAAoB;CACrB,CAAC,CAAC","sourcesContent":["/**\n * Organization Unit Member Shared Schemas\n *\n * The junction between an organization MEMBERSHIP and an organization UNIT: \"this member holds this\n * role inside this unit of the org chart\".\n *\n * ## Why this is a resource and not an embedded array (plan decision D-B5)\n *\n * This started life as `OrganizationMember.organizationUnitsMembership` — an embedded\n * `[{ organizationUnitId, role }]` array. That shape could not carry the semantics it claimed:\n *\n *  - **It was not portably queryable.** A dot-path filter into an array-valued field works on Mongo\n *    and resolves to `NULL` on PostgreSQL (matching nothing), there is no first-class containment\n *    operator, and the application-side fallback is stripped by the LIST summary projection. BOTH\n *    available routes fail **OPEN**. Anything that had to ask \"who is assigned to this unit?\" —\n *    the unit DELETE dependents guard, and any future authorization read — would have silently\n *    passed on one adapter.\n *  - **It could not be a relationship.** With no registered edge there was no cascade, so unit\n *    assignments outlived both the unit and the membership that justified them.\n *  - **It admitted duplicates.** An array has no uniqueness; a member could carry two different\n *    roles for the same unit with no defined winner.\n *\n * As a first-class junction all three close: the assignment is queryable on every adapter, the\n * `ORGANIZATION_UNITS → ORGANIZATION_UNIT_MEMBERS` edge lets the unit DELETE guard finally cover\n * assigned members, and {@link OrganizationUnitMemberSchema}'s business key makes \"one role per\n * member per unit\" a persisted invariant instead of a convention.\n *\n * ## An authorization axis — live since WS-C phase 2\n *\n * ⚠️ `role` here IS read by the authorization path. `appendUnitScopedRoles` emits one\n * `initiatorRoles` entry per assignment, carrying `organizationUnitId` as a NARROWING discriminator\n * beside the organization-wide entry; every consumer that unions `initiatorRoles` partitions on that\n * field first (`isOrganizationWideRoleInfo`). So a unit role is live authority — bounded to one unit,\n * never tenant-wide. Two consequences for anything touching this field:\n *\n *  - The role-ceiling gate governs who may ASSIGN it (both write paths carry it explicitly, see\n *    {@link OrganizationUnitMemberSchema.shape.role}).\n *  - Every change to it is an access-control decision and emits\n *    `ORGANIZATION_UNIT_MEMBER_ROLE_CHANGED`, the narrowed twin of the organization-wide\n *    `ORGANIZATION_MEMBER_ROLE_CHANGED`.\n *\n * assurance-control: WILDO.ACCESS.LEAST_PRIVILEGE · WILDO.ACCESS.PRIVILEGE_EVIDENCE — least-privilege and evidence on unit-scoped\n * role assignment.\n */\n\nimport { z } from 'zod';\n\nimport { OrgRolesSchema } from '../security/authorizations/roles.shared.schemas';\n\nexport const OrganizationUnitMemberSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  /**\n   * Tenant anchor. Denormalized from the parent membership so tenant scoping and the contextual\n   * filter resolve on this row alone — an authorization-adjacent read must never depend on a join\n   * to establish which tenant a row belongs to.\n   */\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  /** The unit of the org chart this assignment targets. */\n  organizationUnitId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  /**\n   * The organization MEMBERSHIP being assigned — deliberately the membership, not the user.\n   *\n   * A unit assignment presupposes membership of the owning organization, so the membership row is\n   * the true semantic parent: it carries the tenant binding and its deletion is exactly when the\n   * assignment stops meaning anything (hence the cascade on that edge). Pointing at `userId`\n   * instead would model a user as assignable to a unit of an organization they may not belong to.\n   *\n   * A denormalized `userId` copy was considered for a one-hop \"unit roles for this user\" read and\n   * REJECTED: the execution-context builder already holds the member rows (and therefore their\n   * `_id`s) at the point it would need this, so the copy would buy nothing and add a field that can\n   * drift.\n   */\n  organizationMemberId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  /**\n   * The role this member holds WITHIN this unit.\n   *\n   * The only mutable field on the row, and deliberately so: re-grading an assignment through UPDATE\n   * keeps the row's identity (and its `createdAt` provenance) intact, where a delete-plus-create\n   * would silently reset both. The two coordinates that IDENTIFY the assignment\n   * (`organizationMemberId`, `organizationUnitId`) are `.excludeFromUpdate()`, so an edit can change\n   * what the assignment GRANTS but never what it is ABOUT.\n   *\n   * Both write paths — CREATE and UPDATE — are governed by the role-ceiling gate\n   * (`assertRequestedRolesWithinCallerCeiling`): a principal cannot grant a unit role it does not\n   * itself hold. Because a custom implementation resolves by an exact operation-path key, each path\n   * carries the gate explicitly; neither inherits it from the other.\n   */\n  role: OrgRolesSchema.isDBIndexed().isSummaryField(),\n  createdAt: z.date().default(() => new Date()).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n}).businessKeySet([\n  'organizationMemberId',\n  'organizationUnitId',\n]);\n\nexport type OrganizationUnitMember = z.infer<typeof OrganizationUnitMemberSchema>;\n"]}
+{"version":3,"file":"organization-unit-members.shared.schemas.js","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-members.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE;IACtD;;;;OAIG;IACH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;IACnG,yDAAyD;IACzD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;IACvG;;;;;;;;;;;;OAYG;IACH,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;IACzG;;;;;;;;;;;;;OAaG;IACH,IAAI,EAAE,cAAc,CAAC,WAAW,EAAE,CAAC,cAAc,EAAE;SAChD,QAAQ,CAAC,4JAA4J,CAAC;IACzK,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;IAC9G,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;CAC/G,CAAC,CAAC,cAAc,CAAC;IAChB,sBAAsB;IACtB,oBAAoB;CACrB,CAAC,CAAC","sourcesContent":["/**\n * Organization Unit Member Shared Schemas\n *\n * The junction between an organization MEMBERSHIP and an organization UNIT: \"this member holds this\n * role inside this unit of the org chart\".\n *\n * ## Why this is a resource and not an embedded array (plan decision D-B5)\n *\n * This started life as `OrganizationMember.organizationUnitsMembership` — an embedded\n * `[{ organizationUnitId, role }]` array. That shape could not carry the semantics it claimed:\n *\n *  - **It was not portably queryable.** A dot-path filter into an array-valued field works on Mongo\n *    and resolves to `NULL` on PostgreSQL (matching nothing), there is no first-class containment\n *    operator, and the application-side fallback is stripped by the LIST summary projection. BOTH\n *    available routes fail **OPEN**. Anything that had to ask \"who is assigned to this unit?\" —\n *    the unit DELETE dependents guard, and any future authorization read — would have silently\n *    passed on one adapter.\n *  - **It could not be a relationship.** With no registered edge there was no cascade, so unit\n *    assignments outlived both the unit and the membership that justified them.\n *  - **It admitted duplicates.** An array has no uniqueness; a member could carry two different\n *    roles for the same unit with no defined winner.\n *\n * As a first-class junction all three close: the assignment is queryable on every adapter, the\n * `ORGANIZATION_UNITS → ORGANIZATION_UNIT_MEMBERS` edge lets the unit DELETE guard finally cover\n * assigned members, and {@link OrganizationUnitMemberSchema}'s business key makes \"one role per\n * member per unit\" a persisted invariant instead of a convention.\n *\n * ## An authorization axis — live since WS-C phase 2\n *\n * ⚠️ `role` here IS read by the authorization path. `appendUnitScopedRoles` emits one\n * `initiatorRoles` entry per assignment, carrying `organizationUnitId` as a NARROWING discriminator\n * beside the organization-wide entry; every consumer that unions `initiatorRoles` partitions on that\n * field first (`isOrganizationWideRoleInfo`). So a unit role is live authority — bounded to one unit,\n * never tenant-wide. Two consequences for anything touching this field:\n *\n *  - The role-ceiling gate governs who may ASSIGN it (both write paths carry it explicitly, see\n *    {@link OrganizationUnitMemberSchema.shape.role}).\n *  - Every change to it is an access-control decision and emits\n *    `ORGANIZATION_UNIT_MEMBER_ROLE_CHANGED`, the narrowed twin of the organization-wide\n *    `ORGANIZATION_MEMBER_ROLE_CHANGED`.\n *\n * assurance-control: WILDO.ACCESS.LEAST_PRIVILEGE · WILDO.ACCESS.PRIVILEGE_EVIDENCE — least-privilege and evidence on unit-scoped\n * role assignment.\n */\n\nimport { z } from 'zod';\n\nimport { OrgRolesSchema } from '../security/authorizations/roles.shared.schemas';\n\nexport const OrganizationUnitMemberSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  /**\n   * Tenant anchor. Denormalized from the parent membership so tenant scoping and the contextual\n   * filter resolve on this row alone — an authorization-adjacent read must never depend on a join\n   * to establish which tenant a row belongs to.\n   */\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  /** The unit of the org chart this assignment targets. */\n  organizationUnitId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  /**\n   * The organization MEMBERSHIP being assigned — deliberately the membership, not the user.\n   *\n   * A unit assignment presupposes membership of the owning organization, so the membership row is\n   * the true semantic parent: it carries the tenant binding and its deletion is exactly when the\n   * assignment stops meaning anything (hence the cascade on that edge). Pointing at `userId`\n   * instead would model a user as assignable to a unit of an organization they may not belong to.\n   *\n   * A denormalized `userId` copy was considered for a one-hop \"unit roles for this user\" read and\n   * REJECTED: the execution-context builder already holds the member rows (and therefore their\n   * `_id`s) at the point it would need this, so the copy would buy nothing and add a field that can\n   * drift.\n   */\n  organizationMemberId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n  /**\n   * The role this member holds WITHIN this unit.\n   *\n   * The only mutable field on the row, and deliberately so: re-grading an assignment through UPDATE\n   * keeps the row's identity (and its `createdAt` provenance) intact, where a delete-plus-create\n   * would silently reset both. The two coordinates that IDENTIFY the assignment\n   * (`organizationMemberId`, `organizationUnitId`) are `.excludeFromUpdate()`, so an edit can change\n   * what the assignment GRANTS but never what it is ABOUT.\n   *\n   * Both write paths — CREATE and UPDATE — are governed by the role-ceiling gate\n   * (`assertRequestedRolesWithinCallerCeiling`): a principal cannot grant a unit role it does not\n   * itself hold. Because a custom implementation resolves by an exact operation-path key, each path\n   * carries the gate explicitly; neither inherits it from the other.\n   */\n  role: OrgRolesSchema.isDBIndexed().isSummaryField()\n    .describe('The role the member holds inside this unit: a core organization role or one the application defines. A caller cannot grant a role it does not hold itself.'),\n  createdAt: z.date().default(() => new Date()).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),\n}).businessKeySet([\n  'organizationMemberId',\n  'organizationUnitId',\n]);\n\nexport type OrganizationUnitMember = z.infer<typeof OrganizationUnitMemberSchema>;\n"]}

package/dist/esm/organizations/organization-unit-narrowing-decision.shared.d.ts

@@ -32,7 +32,14 @@ export declare enum OrganizationUnitNarrowingDecisionKind {
     /** ONLY unit grants satisfy the operation, so access is confined to those units. */
     UNIT_NARROWED = "UNIT_NARROWED",
     /** Neither an organization-wide nor a unit grant satisfies the operation. */
-    DENIED = "DENIED"
+    DENIED = "DENIED",
+    /**
+     * A UNIT-ONLY principal — one holding no organization-wide entry in the target organization, which
+     * only a unit-scoped service-provider relationship produces (#1597) — reads a resource the application
+     * declared organization-wide for providers (`serviceProviderOrganizationWideAccess`). Admitted with NO
+     * row confinement, read-class operations only. Never produced for a resource that narrows by unit.
+     */
+    SERVICE_PROVIDER_ORGANIZATION_WIDE = "SERVICE_PROVIDER_ORGANIZATION_WIDE"
 }
 export type OrganizationUnitNarrowingDecision = {
     kind: OrganizationUnitNarrowingDecisionKind.NOT_NARROWED;
@@ -44,6 +51,8 @@ export type OrganizationUnitNarrowingDecision = {
     organizationUnitIds: string[];
 } | {
     kind: OrganizationUnitNarrowingDecisionKind.DENIED;
+} | {
+    kind: OrganizationUnitNarrowingDecisionKind.SERVICE_PROVIDER_ORGANIZATION_WIDE;
 };
 /**
  * A decision as STAMPED on an execution context — the conferring-grant record.
@@ -124,7 +133,60 @@ export declare function resolveOrganizationUnitNarrowingDecision(input: {
     readonly resourceType: string;
     readonly requiredRoles: readonly string[];
     readonly initiatorRoles: readonly ExecutionContext_RoleInfo[] | undefined;
+    /**
+     * The organization the request acts inside. Only role entries held IN it are evaluated — an
+     * ORG_ADMIN of another tenant must neither satisfy the organization-wide step nor lift narrowing
+     * here (see `selectRoleInfosActingInOrganization`). Absent ⇒ no organization entry counts.
+     */
+    readonly organizationId: string | undefined;
     readonly narrowingRegistry: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>;
     readonly roleHierarchyResolver: OrganizationUnitRoleHierarchyResolver;
+    /**
+     * Resources the application declared readable organization-wide by a UNIT-scoped service provider
+     * (`serviceProviderOrganizationWideAccess`). Absent ⇒ none.
+     */
+    readonly serviceProviderOrganizationWideAccess?: Readonly<Partial<Record<string, ServiceProviderOrganizationWideAccessDeclaration>>>;
+    /** Whether the operation only READS (`READ`/`LIST`/`SEARCH`/`COUNT`). The provider declaration admits nothing else. */
+    readonly operationIsReadOnly?: boolean;
 }): OrganizationUnitNarrowingDecision;
+/**
+ * An application's statement that a UNIT-scoped service-provider expert may READ a resource across the
+ * whole client organization — a shared reference list, say — even though the resource does not narrow
+ * by unit. The rationale is required: it is what a reviewer reads to judge whether the widening is right.
+ */
+export type ServiceProviderOrganizationWideAccessDeclaration = {
+    readonly rationale: string;
+};
+/**
+ * The ENGINE's own organization-wide reads for a unit-only service-provider principal (#1597) — exactly one resource,
+ * and it is the organization row itself.
+ *
+ * A principal who works in an organization must be able to read which organization that is: its name, type and status,
+ * the row an ordinary member reads (its READ requires ORG_MEMBER, which the provider role inherits). Without it the organization switcher — one READ of the row per membership —
+ * never lists a client whose relationship is confined to units, so unit scope is unusable through the shipped UI.
+ * Reading the row grants nothing else: no other resource, and (by the admission below) no write.
+ *
+ * Engine-owned rather than an application declaration because the application MAY NOT declare it: ORGANIZATIONS is in
+ * the authorization plane, which `collectServiceProviderOrganizationWideAccessViolations` refuses — rightly, since an
+ * application widening it could expose a future authority field. The engine owns the row's shape, so the engine is the
+ * party that can say its READ is safe. Widening this set is a framework decision, made here and nowhere else.
+ */
+export declare const ENGINE_SERVICE_PROVIDER_ORGANIZATION_WIDE_READS: ReadonlySet<string>;
+/** Why a `serviceProviderOrganizationWideAccess` entry was refused at startup. */
+export declare enum ServiceProviderOrganizationWideAccessViolationKind {
+    /** The resource issues authority (the authorization plane) — a provider must never read it tenant-wide by declaration. */
+    AUTHORIZATION_PLANE_RESOURCE = "AUTHORIZATION_PLANE_RESOURCE",
+    /** The resource already narrows by unit; declaring it organization-wide for providers would make one decision two. */
+    RESOURCE_NARROWS_BY_UNIT = "RESOURCE_NARROWS_BY_UNIT",
+    /** No rationale — the declaration's whole review value is the sentence saying why. */
+    MISSING_RATIONALE = "MISSING_RATIONALE"
+}
+/**
+ * Validate an application's `serviceProviderOrganizationWideAccess` against the MERGED narrowing map.
+ * Fail closed at startup on any violation: a misdeclared widening is a silent authorization hole.
+ */
+export declare function collectServiceProviderOrganizationWideAccessViolations(declarations: Readonly<Partial<Record<string, ServiceProviderOrganizationWideAccessDeclaration>>> | undefined, narrowingRegistry: Readonly<Partial<Record<string, OrganizationUnitNarrowingDeclaration>>>): {
+    resourceType: string;
+    kind: ServiceProviderOrganizationWideAccessViolationKind;
+}[];
 //# sourceMappingURL=organization-unit-narrowing-decision.shared.d.ts.map

package/dist/esm/organizations/organization-unit-narrowing-decision.shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organization-unit-narrowing-decision.shared.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-narrowing-decision.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAE7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,sCAAsC,CAAC;AAGjG,sDAAsD;AACtD,oBAAY,qCAAqC;IAC/C,6FAA6F;IAC7F,YAAY,iBAAiB;IAC7B,2FAA2F;IAC3F,iBAAiB,sBAAsB;IACvC,oFAAoF;IACpF,aAAa,kBAAkB;IAC/B,6EAA6E;IAC7E,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,iCAAiC,GACzC;IAAE,IAAI,EAAE,qCAAqC,CAAC,YAAY,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,qCAAqC,CAAC,iBAAiB,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,qCAAqC,CAAC,aAAa,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAAE,GACnH;IAAE,IAAI,EAAE,qCAAqC,CAAC,MAAM,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,gGAAgG;IAChG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8FAA8F;IAC9F,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,iCAAiC,CAAC;IACrD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3D,CAAC;AAaF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oCAAoC,CAClD,aAAa,EAAE,8BAA8B,GAAG,SAAS,EACzD,aAAa,EAAE,8BAA8B,GAC5C,8BAA8B,CAwBhC;AAED,oGAAoG;AACpG,MAAM,MAAM,qCAAqC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,KAAK,MAAM,EAAE,CAAC;AAc5G;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wCAAwC,CAAC,KAAK,EAAE;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,SAAS,yBAAyB,EAAE,GAAG,SAAS,CAAC;IAC1E,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC,CAAC,CAAC;IACpG,QAAQ,CAAC,qBAAqB,EAAE,qCAAqC,CAAC;CACvE,GAAG,iCAAiC,CA6BpC"}
+{"version":3,"file":"organization-unit-narrowing-decision.shared.d.ts","sourceRoot":"","sources":["../../../../src/organizations/organization-unit-narrowing-decision.shared.ts"],"names":[],"mappings":"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"}