@wildo-ai/saas-models 1.1.4 → 1.1.5

package/dist/esm/guidance/guidance-flow.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-flow.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/guidance-flow.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { OnboardingTriggerSchema, OnboardingElementSchema, OnboardingElementType } from '../config/frontend/onboarding.shared.schemas';\nimport { OnboardingViewOptionsSchema } from '../config/frontend/onboarding.shared.schemas';\nimport { RequiredFeaturesConfigSchema } from '../features/feature-definition.shared.schemas';\nimport { CoreResourceType } from '../resources/resources.shared.core.definitions';\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Render Modes\n * ────────────────────────────────────────────────────────────── */\n\nexport enum GuidanceRenderMode {\n  /** Modal, banner, announcement — rendered on top of the current view */\n  OVERLAY = 'overlay',\n  /** Tooltip, spotlight — attached to DOM elements in the current view */\n  INLINE = 'inline',\n  /** Floating checklist panel — persistent sidebar/widget */\n  CHECKLIST = 'checklist',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Scope\n * ────────────────────────────────────────────────────────────── */\n\n/** Which scope resource stores this flow's state */\nexport enum GuidanceFlowScope {\n  /** State stored in USER_GUIDANCE_STATE — personal flows (default) */\n  USER = 'user',\n  /** State stored in ORGANIZATION_GUIDANCE_STATE — org-wide flows (completion shared across members) */\n  ORGANIZATION = 'organization',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Audience\n * ────────────────────────────────────────────────────────────── */\n\n/** Audience targeting — who sees this flow */\nexport const GuidanceAudienceSchema = z.object({\n  /** Required user roles (any match = eligible). Empty/omitted = all roles. */\n  roles: z.array(z.string()).optional(),\n  /** Required features using the shared `RequiredFeaturesConfig` semantics. */\n  requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n  /** Exclude users who have completed these flows */\n  excludeIfCompleted: z.array(z.string()).optional(),\n  /** Only show to users created after this date (for new-user flows) */\n  createdAfter: z.coerce.date().optional(),\n});\nexport type GuidanceAudience = z.infer<typeof GuidanceAudienceSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Definition\n * ────────────────────────────────────────────────────────────── */\n\n/** GuidanceFlowDefinition — declarative flow configuration */\nexport const GuidanceFlowDefinitionSchema = z.object({\n  /** Unique flow reference (e.g., 'welcome-tour', 'org-setup-wizard') */\n  ref: z.string().min(1),\n  /** State scope — determines which resource stores this flow's state.\n   *  USER (default): personal guidance, each user has their own state.\n   *  ORGANIZATION: org-wide guidance, shared across all members. */\n  scope: z.enum(GuidanceFlowScope).default(GuidanceFlowScope.USER),\n  /** Rendering mode */\n  renderMode: z.enum(GuidanceRenderMode),\n  /** When/how to activate this flow */\n  trigger: OnboardingTriggerSchema,\n  /** Audience targeting */\n  audience: GuidanceAudienceSchema.optional(),\n  /** Priority for ordering when multiple flows are eligible (lower = higher priority) */\n  priority: z.number().int().default(100),\n  /** Elements in this flow — reuses existing OnboardingElement discriminated union */\n  elements: z.array(OnboardingElementSchema),\n  /** Flow-level options */\n  options: OnboardingViewOptionsSchema.optional(),\n  /** i18n: label configuration */\n  labels: z.object({\n    description: z.boolean().default(false),\n  }).optional(),\n});\nexport type GuidanceFlowDefinition = z.infer<typeof GuidanceFlowDefinitionSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Reference\n * ────────────────────────────────────────────────────────────── */\n\n/** Lightweight reference for toggling/prioritizing flows without repeating the full definition */\nexport const GuidanceFlowReferenceSchema = z.object({\n  ref: z.string().min(1),\n  priority: z.number().int().optional(),\n  enabled: z.boolean().default(true),\n});\nexport type GuidanceFlowReference = z.infer<typeof GuidanceFlowReferenceSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance — Scope to Resource Mapping\n * ────────────────────────────────────────────────────────────── */\n\n/** Maps GuidanceFlowScope to the CoreResourceType that stores its state */\nexport const GUIDANCE_SCOPE_TO_RESOURCE: Record<GuidanceFlowScope, CoreResourceType> = {\n  [GuidanceFlowScope.USER]: CoreResourceType.USER_GUIDANCE_STATE,\n  [GuidanceFlowScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_GUIDANCE_STATE,\n};\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance — Per-Element-Type i18n Field Map\n * ────────────────────────────────────────────────────────────── */\n\n/** Controls which i18n keys are generated per element type.\n *  Follows the ERROR_GUIDANCE_REFS pattern — avoids wasteful cartesian product generation. */\nexport const GUIDANCE_ELEMENT_FIELDS: Record<OnboardingElementType, string[]> = {\n  [OnboardingElementType.CHECKLIST]:      ['title', 'description'],\n  [OnboardingElementType.CHECKLIST_ITEM]: ['title', 'description', 'actionLabel'],\n  [OnboardingElementType.TOUR]:           ['title', 'description'],\n  [OnboardingElementType.TOOLTIP]:        ['title', 'description', 'content'],\n  [OnboardingElementType.MODAL]:          ['title', 'description', 'content', 'actionLabel'],\n  [OnboardingElementType.BANNER]:         ['title', 'description', 'content', 'actionLabel'],\n  [OnboardingElementType.ANNOUNCEMENT]:   ['title', 'description', 'content', 'actionLabel'],\n  [OnboardingElementType.BADGE]:          ['title', 'content'],\n  [OnboardingElementType.CARD]:           ['title', 'description', 'content', 'actionLabel'],\n  [OnboardingElementType.SURVEY]:         ['title', 'description'],\n};\n"]}
+{"version":3,"file":"guidance-flow.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/guidance-flow.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { OnboardingTriggerSchema, OnboardingElementSchema, OnboardingElementType } from '../config/frontend/onboarding.shared.schemas';\nimport type { OnboardingElement } from '../config/frontend/onboarding.shared.schemas';\nimport { LifecycleScope, LifecycleStage } from './lifecycle-state.shared.schemas';\nimport { ProgressionScope } from './milestone-definition.shared.schemas';\nimport { RequiredFeaturesConfigSchema } from '../features/feature-definition.shared.schemas';\nimport { CoreResourceType } from '../resources/resources.shared.core.definitions';\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Render Modes\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * @wildo_source:part:start saas.models.guidance-flow facet:layer:shared facet:family:guidance facet:audience:app-developer\n *\n * A guidance flow is triggered chrome — a banner, a modal, a tour, a survey — that appears over\n * whatever the person is looking at when an event fires, remembers whether they finished with it,\n * and does not come back. Declare flows as `GuidanceFlowDefinition[]` on a frontend module's\n * `guidanceFlows`. Import from `@wildo-ai/saas-models`.\n *\n * Only ONE `OVERLAY` flow is shown at a time: of the active ones, the lowest `priority` number is\n * shown. The others WAIT — each appears once the one in front of it is completed, skipped or\n * dismissed in the same session. A flow that never got shown is not saved as started, so a page\n * reload drops it until its trigger fires again.\n */\n\nexport enum GuidanceRenderMode {\n  /** Modal, banner, announcement — rendered on top of the current view */\n  OVERLAY = 'overlay',\n  /** Tooltip, spotlight — attached to DOM elements in the current view */\n  INLINE = 'inline',\n  /** Floating checklist panel — persistent sidebar/widget */\n  CHECKLIST = 'checklist',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Scope\n * ────────────────────────────────────────────────────────────── */\n\n/** Which scope resource stores this flow's state */\nexport enum GuidanceFlowScope {\n  /** State stored in USER_GUIDANCE_STATE — personal flows (default) */\n  USER = 'user',\n  /** State stored in ORGANIZATION_GUIDANCE_STATE — org-wide flows (completion shared across members) */\n  ORGANIZATION = 'organization',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Audience\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * Audience targeting — who sees this flow.\n *\n * ## What it may read, and why that boundary is where it is\n *\n * Everything here is answered from state the GUIDANCE CONTEXT ALREADY HOLDS: the subject's roles,\n * their resolved features, the flow states it loaded, and the progression and\n * lifecycle documents it loads beside them. No criterion reads an arbitrary resource row, and that\n * is the deliberate line: eligibility is computed on the frontend, synchronously, every time the\n * eligible set is recomputed. A criterion needing a row nobody has loaded would turn that into a\n * fetch, and an eligibility question that can be SLOW or FAIL is a different mechanism.\n *\n * ## Scope\n *\n * The progression and lifecycle criteria read the scope the FLOW declares — a USER flow asks about\n * the user's own milestones and stage, an ORGANIZATION flow about the organization's. Anything else\n * would make an org-wide flow gate on whichever member happened to load it.\n *\n * ## ANY vs ALL, stated per field because the two readings are both defensible\n *\n * A field answering \"who are you\" is ANY-of (`roles`, the two lifecycle fields): one match is\n * enough. A field answering \"what must already be true\" is ALL-of (`requireIfCompleted`,\n * `requiredMilestones`, `requiredSurveyAnswers`): a prerequisite list with one unmet entry is unmet.\n * `excludeIfCompleted` is ANY-of because it is a veto — one reason to suppress is enough.\n */\nexport const GuidanceAudienceSchema = z.object({\n  /** Required user roles (any match = eligible). Empty/omitted = all roles. */\n  roles: z.array(z.string()).optional(),\n  /** Required features using the shared `RequiredFeaturesConfig` semantics. */\n  requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n  /** Exclude users who have completed these flows (ANY match suppresses). */\n  excludeIfCompleted: z.array(z.string()).optional(),\n  /**\n   * Show only once ALL of these flows have been COMPLETED — the positive counterpart of\n   * `excludeIfCompleted`, and how a second flow follows a first.\n   *\n   * COMPLETED only. A flow that was dismissed or skipped has not met a prerequisite — the person\n   * declined it — and treating those as satisfaction would show a follow-up to exactly the people\n   * who opted out of its lead-in.\n   */\n  requireIfCompleted: z.array(z.string()).optional(),\n  /** Show only once ALL of these milestones are achieved, in the flow's own progression scope. */\n  requiredMilestones: z.array(z.string()).optional(),\n  /**\n   * Show only while the subject's CURRENT lifecycle stage is one of these.\n   *\n   * Distinct from `lifecycleStagesReached` on purpose, because the two answer opposite questions and\n   * confusing them is the likeliest authoring mistake here. This one is \"who are you NOW\" — it stops\n   * matching the moment the subject moves on, which is what a dormancy nudge wants and what an\n   * \"already activated\" tip does not.\n   */\n  currentLifecycleStages: z.array(z.enum(LifecycleStage)).optional(),\n  /**\n   * Show once the subject has EVER been in one of these stages.\n   *\n   * Reads `stagesVisited`, which exists precisely so this question survives the stage-history cap.\n   * This is what an onboarding tip usually wants: \"once they have activated\" stays true after they\n   * go on to ENGAGED, where `currentLifecycleStages: [ACTIVATED]` would silently stop matching.\n   */\n  lifecycleStagesReached: z.array(z.enum(LifecycleStage)).optional(),\n  /**\n   * Show only when ALL of these recorded survey answers match.\n   *\n   * The answer is read from the guidance state the context already holds, so it addresses a\n   * question by the flow, element and question that asked it. Equality only, against the scalar\n   * kinds an answer can be — the point is branching on what somebody said, not a query language.\n   */\n  requiredSurveyAnswers: z.array(z.object({\n    flowRef: z.string().min(1),\n    elementRef: z.string().min(1),\n    questionId: z.string().min(1),\n    equals: z.union([z.string(), z.number(), z.boolean()]),\n  })).optional(),\n  /** Only show to users created after this date (for new-user flows) */\n  createdAfter: z.coerce.date().optional(),\n});\nexport type GuidanceAudience = z.infer<typeof GuidanceAudienceSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance Flow — Definition\n * ────────────────────────────────────────────────────────────── */\n\n/** GuidanceFlowDefinition — declarative flow configuration */\nexport const GuidanceFlowDefinitionSchema = z.object({\n  /** Unique flow reference (e.g., 'welcome-tour', 'org-setup-wizard') */\n  ref: z.string().min(1),\n  /** State scope — determines which resource stores this flow's state.\n   *  USER (default): personal guidance, each user has their own state.\n   *  ORGANIZATION: org-wide guidance, shared across all members. */\n  scope: z.enum(GuidanceFlowScope).default(GuidanceFlowScope.USER),\n  /** Rendering mode */\n  renderMode: z.enum(GuidanceRenderMode),\n  /** When/how to activate this flow */\n  trigger: OnboardingTriggerSchema,\n  /** Audience targeting */\n  audience: GuidanceAudienceSchema.optional(),\n  /** Priority for ordering when multiple flows are eligible (lower = higher priority) */\n  priority: z.number().int().default(100),\n  /** Elements in this flow — reuses existing OnboardingElement discriminated union */\n  elements: z.array(OnboardingElementSchema),\n  /*\n   * There is no flow-level options block: dismissing, skipping and progress display are set on each\n   * ELEMENT (`dismissible` on banner / modal / announcement / card, `allowSkip` on tour and survey,\n   * `showProgress` on checklist), where the element's renderer reads them.\n   */\n  /** i18n: label configuration */\n  labels: z.object({\n    description: z.boolean().default(false),\n  }).optional(),\n});\nexport type GuidanceFlowDefinition = z.infer<typeof GuidanceFlowDefinitionSchema>;\n/** @wildo_source:part:end saas.models.guidance-flow */\n\n/*\n * Maintainer note — kept OUTSIDE the anchor above because it is history, not guidance an application\n * needs. A flow-level `options` block (`OnboardingViewOptionsSchema`) was REMOVED rather than wired\n * (#1368): the guidance renderer read none of it. Three of its six members were a second spelling of\n * a per-element control already enforced where it is read (`dismissible`, `allowSkip`,\n * `showProgress`), so wiring them would have created two places to say one thing plus a precedence\n * rule; `persistState: false` named a mode that does not exist; `className` is the theme's; and\n * `autoStart` is read at neither level. Do not reintroduce it without a renderer that reads it.\n */\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance — Scope to Resource Mapping\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * The progression scope a flow of this scope asks about (#1373).\n *\n * Written as an explicit total map rather than a cast, even though the three scope enums currently\n * share their wire values. They are DISTINCT vocabularies — a guidance flow's storage scope, a\n * milestone's accrual scope and a subject's lifecycle scope — and collapsing them because the\n * strings line up today is what this repository's \"never merge semantically distinct concepts\n * merely because their wire values overlap\" rule exists to stop. Being total, a member added to\n * `GuidanceFlowScope` is a compile error here rather than a silent `undefined` lookup.\n */\nexport const GUIDANCE_SCOPE_TO_PROGRESSION_SCOPE: Record<GuidanceFlowScope, ProgressionScope> = {\n  [GuidanceFlowScope.USER]: ProgressionScope.USER,\n  [GuidanceFlowScope.ORGANIZATION]: ProgressionScope.ORGANIZATION,\n};\n\n/** The lifecycle scope a flow of this scope asks about. Total, for the reason above. */\nexport const GUIDANCE_SCOPE_TO_LIFECYCLE_SCOPE: Record<GuidanceFlowScope, LifecycleScope> = {\n  [GuidanceFlowScope.USER]: LifecycleScope.USER,\n  [GuidanceFlowScope.ORGANIZATION]: LifecycleScope.ORGANIZATION,\n};\n\n/** Maps GuidanceFlowScope to the CoreResourceType that stores its state */\nexport const GUIDANCE_SCOPE_TO_RESOURCE: Record<GuidanceFlowScope, CoreResourceType> = {\n  [GuidanceFlowScope.USER]: CoreResourceType.USER_GUIDANCE_STATE,\n  [GuidanceFlowScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_GUIDANCE_STATE,\n};\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance — Per-Element-Type i18n Field Map\n * ────────────────────────────────────────────────────────────── */\n\n/** Controls which i18n keys are generated per element type.\n *  Follows the ERROR_GUIDANCE_REFS pattern — avoids wasteful cartesian product generation. */\nexport const GUIDANCE_ELEMENT_FIELDS: Record<OnboardingElementType, string[]> = {\n  [OnboardingElementType.CHECKLIST]:      ['title', 'description'],\n  [OnboardingElementType.CHECKLIST_ITEM]: ['title', 'description', 'actionLabel'],\n  [OnboardingElementType.TOUR]:           ['title', 'description'],\n  [OnboardingElementType.TOOLTIP]:        ['title', 'description', 'content'],\n  [OnboardingElementType.MODAL]:          ['title', 'description', 'content', 'actionLabel'],\n  [OnboardingElementType.BANNER]:         ['title', 'description', 'content', 'actionLabel'],\n  [OnboardingElementType.ANNOUNCEMENT]:   ['title', 'description', 'content', 'actionLabel'],\n  [OnboardingElementType.BADGE]:          ['title', 'content'],\n  [OnboardingElementType.CARD]:           ['title', 'description', 'content', 'actionLabel'],\n  [OnboardingElementType.SURVEY]:         ['title', 'description'],\n};\n\n/**\n * The label fields an element CANNOT be presented without — the subset of\n * {@link GUIDANCE_ELEMENT_FIELDS} whose absence means the element's copy does not\n * exist yet, rather than that its author chose to omit an optional slot.\n *\n * - **`title`, for every element type.** The labelling pipeline generates EVERY\n *   field `GUIDANCE_ELEMENT_FIELDS` lists, so a missing title is never an\n *   authoring choice: it means copy has not been generated for this element at all.\n * - **`actionLabel`, only when the element declares an ACTION** (`actionRef`, or a\n *   modal's `ctaAction`) and its type lists the field. A banner offering\n *   navigation with no label renders no button, so the action the flow exists to\n *   offer silently disappears (#539).\n *\n * `description` and `content` stay optional: an element with no body is legitimate.\n *\n * Two consumers act on the answer, and neither may re-derive it:\n * - the element translator renders the raw KEY for a required field, so a missing\n *   label LOOKS missing (`.claude/rules/display-text-comes-from-i18n.md`) instead of\n *   collapsing to an invisible card;\n * - the guidance renderer records a flow as PRESENTED — which is what spends its\n *   once-per-user occasion — only when every required label of every element\n *   resolves.\n *\n * Derived from the element's own type and declared action rather than listed per\n * type, so a new element type is covered the day it joins `GUIDANCE_ELEMENT_FIELDS`.\n */\nexport function resolveGuidanceElementRequiredLabelFields(element: OnboardingElement): string[] {\n  const declaredFields = GUIDANCE_ELEMENT_FIELDS[element.type] ?? [];\n  const required: string[] = declaredFields.includes('title') ? ['title'] : [];\n  const declaresAction =\n    ('actionRef' in element && typeof element.actionRef === 'string' && element.actionRef.length > 0)\n    || ('ctaAction' in element && typeof element.ctaAction === 'string' && element.ctaAction.length > 0);\n  if (declaresAction && declaredFields.includes('actionLabel')) {\n    required.push('actionLabel');\n  }\n  return required;\n}\n"]}

package/dist/esm/guidance/guidance-state.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-state.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/guidance-state.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAWzG,KAAK,+BAA+B,GAChC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAE5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,WAAW,CAAC;AAEtC,eAAO,MAAM,4DAA4D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;iCAyKzH,CAAC;AAIH,KAAK,uCAAuC,GACxC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,oEAAoE,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;iCAiGjI,CAAC"}
+{"version":3,"file":"guidance-state.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/guidance-state.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAWzG,KAAK,+BAA+B,GAChC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAE5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,WAAW,CAAC;AAEtC,eAAO,MAAM,4DAA4D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;iCAyKzH,CAAC;AAIH,KAAK,uCAAuC,GACxC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,oEAAoE,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;iCAiGjI,CAAC"}

package/dist/esm/guidance/guidance-state.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-state.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/guidance-state.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAIhF;;oEAEoE;AAEpE,mCAAmC;AACnC,eAAO,MAAM,0BAA0B;;;;;iBASrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;oEAEoE;AAEpE,qBAAqB;AACrB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBASlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;oEAEoE;AAEpE;;wDAEwD;AACxD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAa9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;iBAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;iBAE1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,yBAAyB,CAAC"}
+{"version":3,"file":"guidance-state.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/guidance-state.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAIhF;;oEAEoE;AAEpE,mCAAmC;AACnC,eAAO,MAAM,0BAA0B;;;;;iBASrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;oEAEoE;AAEpE,qBAAqB;AACrB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBASlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;oEAEoE;AAEpE;;wDAEwD;AACxD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAa9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;iBAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;iBAE1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,yBAAyB,CAAC"}

package/dist/esm/guidance/guidance-state.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-state.shared.utils.d.ts","sourceRoot":"","sources":["../../../src/guidance/guidance-state.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAE5C,qBAAa,kBAAkB;IAC7B,OAAO;WAEO,0BAA0B,IAAI,aAAa;WAM3C,yBAAyB,CACrC,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAC1D,sBAAsB;WAgBX,6BAA6B,IAAI,gBAAgB;WAUjD,4BAA4B,CACxC,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAC1D,yBAAyB;WAgBd,2BAA2B,CAAC,GAAG,GAAE,IAAiB,GAAG,cAAc;WAgBnE,iCAAiC,CAC7C,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,EAC3D,GAAG,GAAE,IAAiB,GACrB,uBAAuB;CAe3B"}
+{"version":3,"file":"guidance-state.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/guidance/guidance-state.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAE5C,qBAAa,kBAAkB;IAC7B,OAAO;WAEO,0BAA0B,IAAI,aAAa;WAM3C,yBAAyB,CACrC,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAC1D,sBAAsB;WAgBX,6BAA6B,IAAI,gBAAgB;WAUjD,4BAA4B,CACxC,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAC1D,yBAAyB;WAgBd,2BAA2B,CAAC,GAAG,GAAE,IAAiB,GAAG,cAAc;WAgBnE,iCAAiC,CAC7C,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,EAC3D,GAAG,GAAE,IAAiB,GACrB,uBAAuB;CAe3B"}

package/dist/esm/guidance/guidance-state.shared.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-state.shared.utils.js","sourceRoot":"","sources":["../../../src/guidance/guidance-state.shared.utils.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,GAGf,MAAM,kCAAkC,CAAC;AAM1C,MAAM,OAAO,kBAAkB;IAC7B,gBAAuB,CAAC;IAEjB,MAAM,CAAC,0BAA0B;QACtC,OAAO;YACL,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,yBAAyB,CACrC,UAA2D;QAE3D,MAAM,YAAY,GAAG,kBAAkB,CAAC,0BAA0B,EAAE,CAAC;QAErE,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;YAC3B,OAAO;gBACL,GAAG,YAAY;gBACf,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,GAAG,YAAY;YACf,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,6BAA6B;QACzC,OAAO;YACL,kBAAkB,EAAE,EAAE;YACtB,eAAe,EAAE,EAAE;YACnB,WAAW,EAAE,CAAC;YACd,oBAAoB,EAAE,EAAE;YACxB,kBAAkB,EAAE,EAAE;SACvB,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,4BAA4B,CACxC,UAA2D;QAE3D,MAAM,YAAY,GAAG,kBAAkB,CAAC,6BAA6B,EAAE,CAAC;QAExE,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;YAC3B,OAAO;gBACL,GAAG,YAAY;gBACf,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,GAAG,YAAY;YACf,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,2BAA2B,CAAC,MAAY,IAAI,IAAI,EAAE;QAC9D,OAAO;YACL,YAAY,EAAE,cAAc,CAAC,SAAS;YACtC,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,CAAC;oBACb,KAAK,EAAE,cAAc,CAAC,SAAS;oBAC/B,SAAS,EAAE,GAAG;oBACd,OAAO,EAAE,aAAa;iBACvB,CAAC;YACF,aAAa,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;YACzC,YAAY,EAAE,GAAG;YACjB,qBAAqB,EAAE,EAAE;YACzB,UAAU,EAAE,EAAE,yBAAyB,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;SAC9D,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,iCAAiC,CAC7C,UAA2D,EAC3D,MAAY,IAAI,IAAI,EAAE;QAEtB,MAAM,YAAY,GAAG,kBAAkB,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC;QAEzE,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;YAC3B,OAAO;gBACL,GAAG,YAAY;gBACf,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,GAAG,YAAY;YACf,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C,CAAC;IACJ,CAAC;CACF","sourcesContent":["import type {\n  GuidanceState,\n  PersistedGuidanceState,\n} from './guidance-state.shared.schemas';\nimport {\n  LifecycleStage,\n  type LifecycleState,\n  type PersistedLifecycleState,\n} from './lifecycle-state.shared.schemas';\nimport type {\n  PersistedProgressionState,\n  ProgressionState,\n} from './progression-state.shared.schemas';\n\nexport class GuidanceStateUtils {\n  private constructor() {}\n\n  public static createInitialGuidanceState(): GuidanceState {\n    return {\n      flows: {},\n    };\n  }\n\n  public static createScopedGuidanceState(\n    scopeOwner: { userId: string } | { organizationId: string },\n  ): PersistedGuidanceState {\n    const initialState = GuidanceStateUtils.createInitialGuidanceState();\n\n    if ('userId' in scopeOwner) {\n      return {\n        ...initialState,\n        userId: scopeOwner.userId,\n      };\n    }\n\n    return {\n      ...initialState,\n      organizationId: scopeOwner.organizationId,\n    };\n  }\n\n  public static createInitialProgressionState(): ProgressionState {\n    return {\n      milestonesAchieved: {},\n      operationCounts: {},\n      totalPoints: 0,\n      valueMomentsAchieved: {},\n      categoriesProgress: {},\n    };\n  }\n\n  public static createScopedProgressionState(\n    scopeOwner: { userId: string } | { organizationId: string },\n  ): PersistedProgressionState {\n    const initialState = GuidanceStateUtils.createInitialProgressionState();\n\n    if ('userId' in scopeOwner) {\n      return {\n        ...initialState,\n        userId: scopeOwner.userId,\n      };\n    }\n\n    return {\n      ...initialState,\n      organizationId: scopeOwner.organizationId,\n    };\n  }\n\n  public static createInitialLifecycleState(now: Date = new Date()): LifecycleState {\n    return {\n      currentStage: LifecycleStage.SIGNED_UP,\n      stageEnteredAt: now,\n      stageHistory: [{\n        stage: LifecycleStage.SIGNED_UP,\n        enteredAt: now,\n        trigger: 'auto_create',\n      }],\n      stagesVisited: [LifecycleStage.SIGNED_UP],\n      lastActiveAt: now,\n      activationCriteriaMet: {},\n      engagement: { operationsSinceActivation: 0, activeDates: [] },\n    };\n  }\n\n  public static createInitialScopedLifecycleState(\n    scopeOwner: { userId: string } | { organizationId: string },\n    now: Date = new Date(),\n  ): PersistedLifecycleState {\n    const initialState = GuidanceStateUtils.createInitialLifecycleState(now);\n\n    if ('userId' in scopeOwner) {\n      return {\n        ...initialState,\n        userId: scopeOwner.userId,\n      };\n    }\n\n    return {\n      ...initialState,\n      organizationId: scopeOwner.organizationId,\n    };\n  }\n}\n"]}
+{"version":3,"file":"guidance-state.shared.utils.js","sourceRoot":"","sources":["../../../../src/guidance/guidance-state.shared.utils.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,GAGf,MAAM,kCAAkC,CAAC;AAM1C,MAAM,OAAO,kBAAkB;IAC7B,gBAAuB,CAAC;IAEjB,MAAM,CAAC,0BAA0B;QACtC,OAAO;YACL,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,yBAAyB,CACrC,UAA2D;QAE3D,MAAM,YAAY,GAAG,kBAAkB,CAAC,0BAA0B,EAAE,CAAC;QAErE,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;YAC3B,OAAO;gBACL,GAAG,YAAY;gBACf,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,GAAG,YAAY;YACf,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,6BAA6B;QACzC,OAAO;YACL,kBAAkB,EAAE,EAAE;YACtB,eAAe,EAAE,EAAE;YACnB,WAAW,EAAE,CAAC;YACd,oBAAoB,EAAE,EAAE;YACxB,kBAAkB,EAAE,EAAE;SACvB,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,4BAA4B,CACxC,UAA2D;QAE3D,MAAM,YAAY,GAAG,kBAAkB,CAAC,6BAA6B,EAAE,CAAC;QAExE,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;YAC3B,OAAO;gBACL,GAAG,YAAY;gBACf,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,GAAG,YAAY;YACf,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,2BAA2B,CAAC,MAAY,IAAI,IAAI,EAAE;QAC9D,OAAO;YACL,YAAY,EAAE,cAAc,CAAC,SAAS;YACtC,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,CAAC;oBACb,KAAK,EAAE,cAAc,CAAC,SAAS;oBAC/B,SAAS,EAAE,GAAG;oBACd,OAAO,EAAE,aAAa;iBACvB,CAAC;YACF,aAAa,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;YACzC,YAAY,EAAE,GAAG;YACjB,qBAAqB,EAAE,EAAE;YACzB,UAAU,EAAE,EAAE,yBAAyB,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;SAC9D,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,iCAAiC,CAC7C,UAA2D,EAC3D,MAAY,IAAI,IAAI,EAAE;QAEtB,MAAM,YAAY,GAAG,kBAAkB,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC;QAEzE,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;YAC3B,OAAO;gBACL,GAAG,YAAY;gBACf,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,GAAG,YAAY;YACf,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C,CAAC;IACJ,CAAC;CACF","sourcesContent":["import type {\n  GuidanceState,\n  PersistedGuidanceState,\n} from './guidance-state.shared.schemas';\nimport {\n  LifecycleStage,\n  type LifecycleState,\n  type PersistedLifecycleState,\n} from './lifecycle-state.shared.schemas';\nimport type {\n  PersistedProgressionState,\n  ProgressionState,\n} from './progression-state.shared.schemas';\n\nexport class GuidanceStateUtils {\n  private constructor() {}\n\n  public static createInitialGuidanceState(): GuidanceState {\n    return {\n      flows: {},\n    };\n  }\n\n  public static createScopedGuidanceState(\n    scopeOwner: { userId: string } | { organizationId: string },\n  ): PersistedGuidanceState {\n    const initialState = GuidanceStateUtils.createInitialGuidanceState();\n\n    if ('userId' in scopeOwner) {\n      return {\n        ...initialState,\n        userId: scopeOwner.userId,\n      };\n    }\n\n    return {\n      ...initialState,\n      organizationId: scopeOwner.organizationId,\n    };\n  }\n\n  public static createInitialProgressionState(): ProgressionState {\n    return {\n      milestonesAchieved: {},\n      operationCounts: {},\n      totalPoints: 0,\n      valueMomentsAchieved: {},\n      categoriesProgress: {},\n    };\n  }\n\n  public static createScopedProgressionState(\n    scopeOwner: { userId: string } | { organizationId: string },\n  ): PersistedProgressionState {\n    const initialState = GuidanceStateUtils.createInitialProgressionState();\n\n    if ('userId' in scopeOwner) {\n      return {\n        ...initialState,\n        userId: scopeOwner.userId,\n      };\n    }\n\n    return {\n      ...initialState,\n      organizationId: scopeOwner.organizationId,\n    };\n  }\n\n  public static createInitialLifecycleState(now: Date = new Date()): LifecycleState {\n    return {\n      currentStage: LifecycleStage.SIGNED_UP,\n      stageEnteredAt: now,\n      stageHistory: [{\n        stage: LifecycleStage.SIGNED_UP,\n        enteredAt: now,\n        trigger: 'auto_create',\n      }],\n      stagesVisited: [LifecycleStage.SIGNED_UP],\n      lastActiveAt: now,\n      activationCriteriaMet: {},\n      engagement: { operationsSinceActivation: 0, activeDates: [] },\n    };\n  }\n\n  public static createInitialScopedLifecycleState(\n    scopeOwner: { userId: string } | { organizationId: string },\n    now: Date = new Date(),\n  ): PersistedLifecycleState {\n    const initialState = GuidanceStateUtils.createInitialLifecycleState(now);\n\n    if ('userId' in scopeOwner) {\n      return {\n        ...initialState,\n        userId: scopeOwner.userId,\n      };\n    }\n\n    return {\n      ...initialState,\n      organizationId: scopeOwner.organizationId,\n    };\n  }\n}\n"]}

package/dist/esm/guidance/lifecycle-config.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-config.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/lifecycle-config.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;oEAEoE;AAEpE,iCAAiC;AACjC,oBAAY,uBAAuB;IACjC,4CAA4C;IAC5C,SAAS,cAAc;IACvB,wCAAwC;IACxC,kBAAkB,uBAAuB;CAC1C;AAED;;oEAEoE;AAEpE,eAAO,MAAM,yBAAyB;;;;;;oCASpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;oEAEoE;AAEpE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;iBAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;oEAEoE;AAEpE,eAAO,MAAM,yBAAyB;;;iBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;oEAEoE;AAEpE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;iBAkBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;oEAEoE;AAEpE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC"}
+{"version":3,"file":"lifecycle-config.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/lifecycle-config.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;oEAEoE;AAEpE,iCAAiC;AACjC,oBAAY,uBAAuB;IACjC,4CAA4C;IAC5C,SAAS,cAAc;IACvB,wCAAwC;IACxC,kBAAkB,uBAAuB;CAC1C;AAED;;oEAEoE;AAEpE,eAAO,MAAM,yBAAyB;;;;;;oCASpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;oEAEoE;AAEpE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;iBAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;oEAEoE;AAEpE,eAAO,MAAM,yBAAyB;;;iBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;oEAEoE;AAEpE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;iBAkBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;oEAEoE;AAEpE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC"}

package/dist/esm/guidance/lifecycle-state.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-state.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/lifecycle-state.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAWzG,KAAK,gCAAgC,GACjC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAE5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,WAAW,CAAC;AAEtC,eAAO,MAAM,6DAA6D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;iCA4K1H,CAAC;AAIH,KAAK,wCAAwC,GACzC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,qEAAqE,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;iCAoGlI,CAAC"}
+{"version":3,"file":"lifecycle-state.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/lifecycle-state.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAA8B,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAWzG,KAAK,gCAAgC,GACjC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAE5B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,WAAW,CAAC;AAEtC,eAAO,MAAM,6DAA6D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;iCA4K1H,CAAC;AAIH,KAAK,wCAAwC,GACzC,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,qEAAqE,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;iCAoGlI,CAAC"}

package/dist/esm/guidance/lifecycle-state.shared.schemas.d.ts

@@ -31,15 +31,9 @@ export declare enum LifecycleScope {
 /** ──────────────────────────────────────────────────────────────
  * Const Maps — State Machine, Stage Sets, Scope Mappings
  * ────────────────────────────────────────────────────────────── */
-/** "Happy path" progression weight — used ONLY for the linear happy path.
- *  The lifecycle is NOT a linear progression (it branches at dormancy/reactivation).
- *  `hasReachedStage()` uses stagesVisited instead — see below. */
-export declare const LIFECYCLE_HAPPY_PATH_WEIGHT: Readonly<Record<LifecycleStage, number>>;
 /** Valid state transitions — the lifecycle state machine.
  *  Key = source stage, Value = valid target stages. */
 export declare const LIFECYCLE_VALID_TRANSITIONS: Readonly<Record<LifecycleStage, readonly LifecycleStage[]>>;
-/** Stages that represent an "active" user (not dormant/churned/offboarded) */
-export declare const LIFECYCLE_ACTIVE_STAGES: readonly [LifecycleStage.SIGNED_UP, LifecycleStage.ACTIVATED, LifecycleStage.ENGAGED, LifecycleStage.REACTIVATED];
 /** Stages from which a user can become dormant (all active stages except SIGNED_UP) */
 export declare const LIFECYCLE_DORMANCY_SOURCE_STAGES: readonly [LifecycleStage.ACTIVATED, LifecycleStage.ENGAGED, LifecycleStage.REACTIVATED];
 /** Stages eligible for engagement threshold evaluation (can transition to ENGAGED) */

package/dist/esm/guidance/lifecycle-state.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-state.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/lifecycle-state.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lifecycle-state.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/lifecycle-state.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAIlF;;oEAEoE;AAEpE,iFAAiF;AACjF,oBAAY,cAAc;IACxB,4DAA4D;IAC5D,SAAS,cAAc;IACvB,+DAA+D;IAC/D,SAAS,cAAc;IACvB,uFAAuF;IACvF,OAAO,YAAY;IACnB,yDAAyD;IACzD,OAAO,YAAY;IACnB,2CAA2C;IAC3C,WAAW,gBAAgB;IAC3B,sDAAsD;IACtD,OAAO,YAAY;IACnB,gDAAgD;IAChD,UAAU,eAAe;CAC1B;AAED;;oEAEoE;AAEpE,sEAAsE;AACtE,oBAAY,cAAc;IACxB,IAAI,SAAS;IACb,YAAY,iBAAiB;CAC9B;AAED;;oEAEoE;AAEpE;uDACuD;AACvD,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAAC,CAQ1F,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,gCAAgC,yFAInC,CAAC;AAEX,sFAAsF;AACtF,eAAO,MAAM,oCAAoC,iEAGvC,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAGjF,CAAC;AAEX;;gEAEgE;AAChE,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAGvF,CAAC;AAEX,qHAAqH;AACrH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAGpF,CAAC;AAEX;uFACuF;AACvF,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,gBAAgB,CAGjE,CAAC;AAEH,oGAAoG;AACpG,eAAO,MAAM,6BAA6B,EAAE,WAAW,CAAC,gBAAgB,CAGtE,CAAC;AAEH;;oEAEoE;AAEpE,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,GAAG,OAAO,CAE5F;AAED;;oEAEoE;AAEpE,0CAA0C;AAC1C,eAAO,MAAM,8BAA8B;;;;;iBASzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,yDAAyD;AACzD,eAAO,MAAM,yBAAyB;;;iBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;wDAEwD;AACxD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;iBAqD/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;iBAInC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;iBAG3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,GAAG,0BAA0B,CAAC;AAEtF;;oEAEoE;AAEpE;;2FAE2F;AAC3F,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,GAAG,OAAO,CAM3F"}

package/dist/esm/guidance/lifecycle-state.shared.schemas.js

@@ -36,18 +36,6 @@ export var LifecycleScope;
 /** ──────────────────────────────────────────────────────────────
  * Const Maps — State Machine, Stage Sets, Scope Mappings
  * ────────────────────────────────────────────────────────────── */
-/** "Happy path" progression weight — used ONLY for the linear happy path.
- *  The lifecycle is NOT a linear progression (it branches at dormancy/reactivation).
- *  `hasReachedStage()` uses stagesVisited instead — see below. */
-export const LIFECYCLE_HAPPY_PATH_WEIGHT = {
-    [LifecycleStage.SIGNED_UP]: 0,
-    [LifecycleStage.ACTIVATED]: 1,
-    [LifecycleStage.ENGAGED]: 2,
-    [LifecycleStage.REACTIVATED]: 2, // Same weight as ENGAGED — reactivated users regain engaged-level access
-    [LifecycleStage.DORMANT]: -1, // Not on happy path
-    [LifecycleStage.CHURNED]: -2, // Terminal negative
-    [LifecycleStage.OFFBOARDED]: -3, // Terminal negative
-};
 /** Valid state transitions — the lifecycle state machine.
  *  Key = source stage, Value = valid target stages. */
 export const LIFECYCLE_VALID_TRANSITIONS = {
@@ -59,13 +47,6 @@ export const LIFECYCLE_VALID_TRANSITIONS = {
     [LifecycleStage.CHURNED]: [LifecycleStage.OFFBOARDED],
     [LifecycleStage.OFFBOARDED]: [],
 };
-/** Stages that represent an "active" user (not dormant/churned/offboarded) */
-export const LIFECYCLE_ACTIVE_STAGES = [
-    LifecycleStage.SIGNED_UP,
-    LifecycleStage.ACTIVATED,
-    LifecycleStage.ENGAGED,
-    LifecycleStage.REACTIVATED,
-];
 /** Stages from which a user can become dormant (all active stages except SIGNED_UP) */
 export const LIFECYCLE_DORMANCY_SOURCE_STAGES = [
     LifecycleStage.ACTIVATED,

package/dist/esm/guidance/lifecycle-state.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-state.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/lifecycle-state.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport { CoreResourceType } from '../resources/resources.shared.core.definitions';\nimport { RedactionType } from '../compliance/privacy/redaction.shared.schemas';\nimport { addImpersonalizeWith } from '@wildo-ai/zod-decorators';\n\n/** ──────────────────────────────────────────────────────────────\n * Lifecycle Stage — Ordered Progression with Dormancy/Reactivation Branches\n * ────────────────────────────────────────────────────────────── */\n\n/** Lifecycle stages — ordered progression with dormancy/reactivation branches */\nexport enum LifecycleStage {\n  /** User has signed up but hasn't met activation criteria */\n  SIGNED_UP = 'signed_up',\n  /** User has met activation criteria (reached product value) */\n  ACTIVATED = 'activated',\n  /** User shows sustained engagement (optional — requires engagementThreshold config) */\n  ENGAGED = 'engaged',\n  /** User has been inactive past the dormancy threshold */\n  DORMANT = 'dormant',\n  /** Previously dormant user has returned */\n  REACTIVATED = 'reactivated',\n  /** User has churned (billing-triggered — deferred) */\n  CHURNED = 'churned',\n  /** User has been fully offboarded (deferred) */\n  OFFBOARDED = 'offboarded',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Lifecycle Scope — Bi-Scope (same as guidance/progression)\n * ────────────────────────────────────────────────────────────── */\n\n/** Lifecycle state scope — bi-scope (same as guidance/progression) */\nexport enum LifecycleScope {\n  USER = 'user',\n  ORGANIZATION = 'organization',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Const Maps — State Machine, Stage Sets, Scope Mappings\n * ────────────────────────────────────────────────────────────── */\n\n/** \"Happy path\" progression weight — used ONLY for the linear happy path.\n *  The lifecycle is NOT a linear progression (it branches at dormancy/reactivation).\n *  `hasReachedStage()` uses stagesVisited instead — see below. */\nexport const LIFECYCLE_HAPPY_PATH_WEIGHT: Readonly<Record<LifecycleStage, number>> = {\n  [LifecycleStage.SIGNED_UP]: 0,\n  [LifecycleStage.ACTIVATED]: 1,\n  [LifecycleStage.ENGAGED]: 2,\n  [LifecycleStage.REACTIVATED]: 2,  // Same weight as ENGAGED — reactivated users regain engaged-level access\n  [LifecycleStage.DORMANT]: -1,     // Not on happy path\n  [LifecycleStage.CHURNED]: -2,     // Terminal negative\n  [LifecycleStage.OFFBOARDED]: -3,  // Terminal negative\n} as const;\n\n/** Valid state transitions — the lifecycle state machine.\n *  Key = source stage, Value = valid target stages. */\nexport const LIFECYCLE_VALID_TRANSITIONS: Readonly<Record<LifecycleStage, readonly LifecycleStage[]>> = {\n  [LifecycleStage.SIGNED_UP]: [LifecycleStage.ACTIVATED],\n  [LifecycleStage.ACTIVATED]: [LifecycleStage.ENGAGED, LifecycleStage.DORMANT],\n  [LifecycleStage.ENGAGED]: [LifecycleStage.DORMANT],\n  [LifecycleStage.DORMANT]: [LifecycleStage.REACTIVATED, LifecycleStage.CHURNED],\n  [LifecycleStage.REACTIVATED]: [LifecycleStage.ENGAGED, LifecycleStage.DORMANT],\n  [LifecycleStage.CHURNED]: [LifecycleStage.OFFBOARDED],\n  [LifecycleStage.OFFBOARDED]: [],\n} as const;\n\n/** Stages that represent an \"active\" user (not dormant/churned/offboarded) */\nexport const LIFECYCLE_ACTIVE_STAGES = [\n  LifecycleStage.SIGNED_UP,\n  LifecycleStage.ACTIVATED,\n  LifecycleStage.ENGAGED,\n  LifecycleStage.REACTIVATED,\n] as const;\n\n/** Stages from which a user can become dormant (all active stages except SIGNED_UP) */\nexport const LIFECYCLE_DORMANCY_SOURCE_STAGES = [\n  LifecycleStage.ACTIVATED,\n  LifecycleStage.ENGAGED,\n  LifecycleStage.REACTIVATED,\n] as const;\n\n/** Stages eligible for engagement threshold evaluation (can transition to ENGAGED) */\nexport const LIFECYCLE_ENGAGEMENT_ELIGIBLE_STAGES = [\n  LifecycleStage.ACTIVATED,\n  LifecycleStage.REACTIVATED,\n] as const;\n\n/** Maps LifecycleScope → corresponding CoreResourceType for lifecycle state storage */\nexport const LIFECYCLE_SCOPE_TO_RESOURCE: Readonly<Record<LifecycleScope, CoreResourceType>> = {\n  [LifecycleScope.USER]: CoreResourceType.USER_LIFECYCLE_STATE,\n  [LifecycleScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_LIFECYCLE_STATE,\n} as const;\n\n/** Maps LifecycleScope → corresponding Progression resource type (for activation criteria eval).\n *  Named to avoid collision with existing PROGRESSION_SCOPE_TO_RESOURCE in milestone-definition.shared.schemas.ts\n *  (which is keyed by ProgressionScope, not LifecycleScope). */\nexport const LIFECYCLE_TO_PROGRESSION_RESOURCE: Readonly<Record<LifecycleScope, CoreResourceType>> = {\n  [LifecycleScope.USER]: CoreResourceType.USER_PROGRESSION_STATE,\n  [LifecycleScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_PROGRESSION_STATE,\n} as const;\n\n/** Maps LifecycleScope → corresponding Guidance state resource type (for GUIDANCE_COMPLETED activation criteria). */\nexport const LIFECYCLE_TO_GUIDANCE_RESOURCE: Readonly<Record<LifecycleScope, CoreResourceType>> = {\n  [LifecycleScope.USER]: CoreResourceType.USER_GUIDANCE_STATE,\n  [LifecycleScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_GUIDANCE_STATE,\n} as const;\n\n/** All lifecycle resource types — for conditional exclusion when lifecycle disabled\n *  (same pattern as BILLING_RESOURCE_TYPES in resources.shared.core.definitions.ts) */\nexport const LIFECYCLE_RESOURCE_TYPES: ReadonlySet<CoreResourceType> = new Set([\n  CoreResourceType.USER_LIFECYCLE_STATE,\n  CoreResourceType.ORGANIZATION_LIFECYCLE_STATE,\n]);\n\n/** Guidance state resource types — used to detect guidance state updates for activation criteria */\nexport const GUIDANCE_STATE_RESOURCE_TYPES: ReadonlySet<CoreResourceType> = new Set([\n  CoreResourceType.USER_GUIDANCE_STATE,\n  CoreResourceType.ORGANIZATION_GUIDANCE_STATE,\n]);\n\n/** ──────────────────────────────────────────────────────────────\n * Utility Functions\n * ────────────────────────────────────────────────────────────── */\n\n/** Validate if a lifecycle transition is valid per the state machine. */\nexport function isValidLifecycleTransition(from: LifecycleStage, to: LifecycleStage): boolean {\n  return LIFECYCLE_VALID_TRANSITIONS[from]?.includes(to) ?? false;\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Zod Schemas — Lifecycle State Document\n * ────────────────────────────────────────────────────────────── */\n\n/** Record of a single stage transition */\nexport const LifecycleStageTransitionSchema = z.object({\n  /** Stage that was entered */\n  stage: z.enum(LifecycleStage),\n  /** When this stage was entered */\n  enteredAt: z.coerce.date(),\n  /** When this stage was exited (undefined if current) */\n  exitedAt: z.coerce.date().optional(),\n  /** What triggered this transition (milestone ref, cron, operation, etc.) */\n  trigger: z.string().optional(),\n});\nexport type LifecycleStageTransition = z.infer<typeof LifecycleStageTransitionSchema>;\n\n/** Engagement metrics tracked while user is ACTIVATED */\nexport const LifecycleEngagementSchema = z.object({\n  /** Total operations since activation */\n  operationsSinceActivation: z.number().int().default(0),\n  /** Distinct active dates since activation (YYYY-MM-DD strings) */\n  activeDates: z.array(z.string()).default([]),\n});\nexport type LifecycleEngagement = z.infer<typeof LifecycleEngagementSchema>;\n\n/** Shared lifecycle state payload body.\n *  Scope-specific state resources extend this schema with their owning FK\n *  (`userId` / `organizationId`) before persistence. */\nexport const LifecycleStateSchema = z.object({\n  /** Current lifecycle stage */\n  // USAGE across the block below — a lifecycle stage, its history, and an engagement score are all\n  // observations the product made ABOUT this person's behaviour.\n  // RESET on erasure — returns this field to its schema default. It holds the lifecycle stage this person reached,\n  // which the category above correctly declares as personal data. RESET rather than REMOVE or MASK\n  // because the field is non-nullable WITH a `.default()`: REMOVE needs a clearable field and MASK\n  // needs a string. The value comes from the schema, so there is no second copy to drift.\n  currentStage: addImpersonalizeWith(\n  z.enum(LifecycleStage).default(LifecycleStage.SIGNED_UP).isSummaryField()\n      .dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** When the current stage was entered. `.default(now)` so the row is\n   *  eager-seedable via onParentCreate (the evaluator still supplies it explicitly). */\n  stageEnteredAt: z.coerce.date().default(() => new Date()),\n  /** History of stage transitions (most recent first, capped at last 20) */\n  // RESET on erasure — returns this field to its schema default. It holds the transition history — when they moved between stages,\n  // which the category above correctly declares as personal data. RESET rather than REMOVE or MASK\n  // because the field is non-nullable WITH a `.default()`: REMOVE needs a clearable field and MASK\n  // needs a string. The value comes from the schema, so there is no second copy to drift.\n  stageHistory: addImpersonalizeWith(\n  z.array(LifecycleStageTransitionSchema).default([]).dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Deduplicated set of all stages ever visited (survives stageHistory cap).\n   *  Used by `hasReachedStage()` for reliable stage visitation checks. */\n  stagesVisited: z.array(z.enum(LifecycleStage)).default([]),\n  /** Last activity timestamp (updated on operations, debounced ~30 min).\n   *  `.default(now)` so the row is eager-seedable via onParentCreate. */\n  // NO treatment, deliberately — and this is a CHOICE the RESET guard forced rather than an omission.\n  //\n  // This field's default reads the clock (`.default(() => new Date())`, so a row is eager-seedable via\n  // onParentCreate). RESET would therefore write a value generated BY the erasure, recording the erased\n  // person as active at the moment they were erased — fabricating information rather than removing it.\n  // The guard refuses that outright.\n  //\n  // Of its two suggested remedies, neither is right here. A static `new Date(0)` default would change\n  // what every LIVE row means, not just erased ones — the lifecycle evaluator reads this to decide\n  // engagement, so a new member would read as inactive since 1970. Making it nullable + REMOVE pushes\n  // an `undefined` onto every consumer of a field that has always held a value.\n  //\n  // So the timestamp is RETAINED, and the notice can say so plainly. The mode is satisfied by\n  // `currentStage` and `stageHistory`, which carry the behavioural detail; a bare timestamp attached to\n  // a subject whose identity row has been scrubbed discloses very little on its own.\n  lastActiveAt: z.coerce.date().default(() => new Date()).dataCategories(PersonalDataCategory.USAGE),\n  /** Which activation criteria have been met (keyed by criterion ref) */\n  activationCriteriaMet: z.record(z.string(), z.boolean()).default({}),\n  /** Engagement metrics (tracked while ACTIVATED, used for ENGAGED transition) */\n  engagement: LifecycleEngagementSchema.default({\n    operationsSinceActivation: 0,\n    activeDates: [],\n  }),\n});\nexport type LifecycleState = z.infer<typeof LifecycleStateSchema>;\n\nexport const UserLifecycleStateSchema = LifecycleStateSchema.extend({\n  // `.isUnique()` = idempotency backstop for onParentCreate seeding (one row per user;\n  // the evaluator's read-then-create already tolerates the unique conflict).\n  userId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type UserLifecycleState = z.infer<typeof UserLifecycleStateSchema>;\n\nexport const OrganizationLifecycleStateSchema = LifecycleStateSchema.extend({\n  // `.isUnique()` = idempotency backstop for onParentCreate seeding (one row per org).\n  organizationId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type OrganizationLifecycleState = z.infer<typeof OrganizationLifecycleStateSchema>;\n\nexport type PersistedLifecycleState = UserLifecycleState | OrganizationLifecycleState;\n\n/** ──────────────────────────────────────────────────────────────\n * Stage History Utility\n * ────────────────────────────────────────────────────────────── */\n\n/** Check if the user has ACTUALLY visited a given stage (not a linear comparison).\n *  Uses `stagesVisited` for reliable lookups that survive the stageHistory cap.\n *  Falls back to `stageHistory` for documents created before `stagesVisited` was added. */\nexport function hasReachedStage(state: LifecycleState, targetStage: LifecycleStage): boolean {\n  if (state.currentStage === targetStage) return true;\n  if (state.stagesVisited?.length) {\n    return state.stagesVisited.includes(targetStage);\n  }\n  return state.stageHistory.some(entry => entry.stage === targetStage);\n}\n"]}
+{"version":3,"file":"lifecycle-state.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/lifecycle-state.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport { CoreResourceType } from '../resources/resources.shared.core.definitions';\nimport { RedactionType } from '../compliance/privacy/redaction.shared.schemas';\nimport { addImpersonalizeWith } from '@wildo-ai/zod-decorators';\n\n/** ──────────────────────────────────────────────────────────────\n * Lifecycle Stage — Ordered Progression with Dormancy/Reactivation Branches\n * ────────────────────────────────────────────────────────────── */\n\n/** Lifecycle stages — ordered progression with dormancy/reactivation branches */\nexport enum LifecycleStage {\n  /** User has signed up but hasn't met activation criteria */\n  SIGNED_UP = 'signed_up',\n  /** User has met activation criteria (reached product value) */\n  ACTIVATED = 'activated',\n  /** User shows sustained engagement (optional — requires engagementThreshold config) */\n  ENGAGED = 'engaged',\n  /** User has been inactive past the dormancy threshold */\n  DORMANT = 'dormant',\n  /** Previously dormant user has returned */\n  REACTIVATED = 'reactivated',\n  /** User has churned (billing-triggered — deferred) */\n  CHURNED = 'churned',\n  /** User has been fully offboarded (deferred) */\n  OFFBOARDED = 'offboarded',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Lifecycle Scope — Bi-Scope (same as guidance/progression)\n * ────────────────────────────────────────────────────────────── */\n\n/** Lifecycle state scope — bi-scope (same as guidance/progression) */\nexport enum LifecycleScope {\n  USER = 'user',\n  ORGANIZATION = 'organization',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Const Maps — State Machine, Stage Sets, Scope Mappings\n * ────────────────────────────────────────────────────────────── */\n\n/** Valid state transitions — the lifecycle state machine.\n *  Key = source stage, Value = valid target stages. */\nexport const LIFECYCLE_VALID_TRANSITIONS: Readonly<Record<LifecycleStage, readonly LifecycleStage[]>> = {\n  [LifecycleStage.SIGNED_UP]: [LifecycleStage.ACTIVATED],\n  [LifecycleStage.ACTIVATED]: [LifecycleStage.ENGAGED, LifecycleStage.DORMANT],\n  [LifecycleStage.ENGAGED]: [LifecycleStage.DORMANT],\n  [LifecycleStage.DORMANT]: [LifecycleStage.REACTIVATED, LifecycleStage.CHURNED],\n  [LifecycleStage.REACTIVATED]: [LifecycleStage.ENGAGED, LifecycleStage.DORMANT],\n  [LifecycleStage.CHURNED]: [LifecycleStage.OFFBOARDED],\n  [LifecycleStage.OFFBOARDED]: [],\n} as const;\n\n/** Stages from which a user can become dormant (all active stages except SIGNED_UP) */\nexport const LIFECYCLE_DORMANCY_SOURCE_STAGES = [\n  LifecycleStage.ACTIVATED,\n  LifecycleStage.ENGAGED,\n  LifecycleStage.REACTIVATED,\n] as const;\n\n/** Stages eligible for engagement threshold evaluation (can transition to ENGAGED) */\nexport const LIFECYCLE_ENGAGEMENT_ELIGIBLE_STAGES = [\n  LifecycleStage.ACTIVATED,\n  LifecycleStage.REACTIVATED,\n] as const;\n\n/** Maps LifecycleScope → corresponding CoreResourceType for lifecycle state storage */\nexport const LIFECYCLE_SCOPE_TO_RESOURCE: Readonly<Record<LifecycleScope, CoreResourceType>> = {\n  [LifecycleScope.USER]: CoreResourceType.USER_LIFECYCLE_STATE,\n  [LifecycleScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_LIFECYCLE_STATE,\n} as const;\n\n/** Maps LifecycleScope → corresponding Progression resource type (for activation criteria eval).\n *  Named to avoid collision with existing PROGRESSION_SCOPE_TO_RESOURCE in milestone-definition.shared.schemas.ts\n *  (which is keyed by ProgressionScope, not LifecycleScope). */\nexport const LIFECYCLE_TO_PROGRESSION_RESOURCE: Readonly<Record<LifecycleScope, CoreResourceType>> = {\n  [LifecycleScope.USER]: CoreResourceType.USER_PROGRESSION_STATE,\n  [LifecycleScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_PROGRESSION_STATE,\n} as const;\n\n/** Maps LifecycleScope → corresponding Guidance state resource type (for GUIDANCE_COMPLETED activation criteria). */\nexport const LIFECYCLE_TO_GUIDANCE_RESOURCE: Readonly<Record<LifecycleScope, CoreResourceType>> = {\n  [LifecycleScope.USER]: CoreResourceType.USER_GUIDANCE_STATE,\n  [LifecycleScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_GUIDANCE_STATE,\n} as const;\n\n/** All lifecycle resource types — for conditional exclusion when lifecycle disabled\n *  (same pattern as BILLING_RESOURCE_TYPES in resources.shared.core.definitions.ts) */\nexport const LIFECYCLE_RESOURCE_TYPES: ReadonlySet<CoreResourceType> = new Set([\n  CoreResourceType.USER_LIFECYCLE_STATE,\n  CoreResourceType.ORGANIZATION_LIFECYCLE_STATE,\n]);\n\n/** Guidance state resource types — used to detect guidance state updates for activation criteria */\nexport const GUIDANCE_STATE_RESOURCE_TYPES: ReadonlySet<CoreResourceType> = new Set([\n  CoreResourceType.USER_GUIDANCE_STATE,\n  CoreResourceType.ORGANIZATION_GUIDANCE_STATE,\n]);\n\n/** ──────────────────────────────────────────────────────────────\n * Utility Functions\n * ────────────────────────────────────────────────────────────── */\n\n/** Validate if a lifecycle transition is valid per the state machine. */\nexport function isValidLifecycleTransition(from: LifecycleStage, to: LifecycleStage): boolean {\n  return LIFECYCLE_VALID_TRANSITIONS[from]?.includes(to) ?? false;\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Zod Schemas — Lifecycle State Document\n * ────────────────────────────────────────────────────────────── */\n\n/** Record of a single stage transition */\nexport const LifecycleStageTransitionSchema = z.object({\n  /** Stage that was entered */\n  stage: z.enum(LifecycleStage),\n  /** When this stage was entered */\n  enteredAt: z.coerce.date(),\n  /** When this stage was exited (undefined if current) */\n  exitedAt: z.coerce.date().optional(),\n  /** What triggered this transition (milestone ref, cron, operation, etc.) */\n  trigger: z.string().optional(),\n});\nexport type LifecycleStageTransition = z.infer<typeof LifecycleStageTransitionSchema>;\n\n/** Engagement metrics tracked while user is ACTIVATED */\nexport const LifecycleEngagementSchema = z.object({\n  /** Total operations since activation */\n  operationsSinceActivation: z.number().int().default(0),\n  /** Distinct active dates since activation (YYYY-MM-DD strings) */\n  activeDates: z.array(z.string()).default([]),\n});\nexport type LifecycleEngagement = z.infer<typeof LifecycleEngagementSchema>;\n\n/** Shared lifecycle state payload body.\n *  Scope-specific state resources extend this schema with their owning FK\n *  (`userId` / `organizationId`) before persistence. */\nexport const LifecycleStateSchema = z.object({\n  /** Current lifecycle stage */\n  // USAGE across the block below — a lifecycle stage, its history, and an engagement score are all\n  // observations the product made ABOUT this person's behaviour.\n  // RESET on erasure — returns this field to its schema default. It holds the lifecycle stage this person reached,\n  // which the category above correctly declares as personal data. RESET rather than REMOVE or MASK\n  // because the field is non-nullable WITH a `.default()`: REMOVE needs a clearable field and MASK\n  // needs a string. The value comes from the schema, so there is no second copy to drift.\n  currentStage: addImpersonalizeWith(\n  z.enum(LifecycleStage).default(LifecycleStage.SIGNED_UP).isSummaryField()\n      .dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** When the current stage was entered. `.default(now)` so the row is\n   *  eager-seedable via onParentCreate (the evaluator still supplies it explicitly). */\n  stageEnteredAt: z.coerce.date().default(() => new Date()),\n  /** History of stage transitions (most recent first, capped at last 20) */\n  // RESET on erasure — returns this field to its schema default. It holds the transition history — when they moved between stages,\n  // which the category above correctly declares as personal data. RESET rather than REMOVE or MASK\n  // because the field is non-nullable WITH a `.default()`: REMOVE needs a clearable field and MASK\n  // needs a string. The value comes from the schema, so there is no second copy to drift.\n  stageHistory: addImpersonalizeWith(\n  z.array(LifecycleStageTransitionSchema).default([]).dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Deduplicated set of all stages ever visited (survives stageHistory cap).\n   *  Used by `hasReachedStage()` for reliable stage visitation checks. */\n  stagesVisited: z.array(z.enum(LifecycleStage)).default([]),\n  /** Last activity timestamp (updated on operations, debounced ~30 min).\n   *  `.default(now)` so the row is eager-seedable via onParentCreate. */\n  // NO treatment, deliberately — and this is a CHOICE the RESET guard forced rather than an omission.\n  //\n  // This field's default reads the clock (`.default(() => new Date())`, so a row is eager-seedable via\n  // onParentCreate). RESET would therefore write a value generated BY the erasure, recording the erased\n  // person as active at the moment they were erased — fabricating information rather than removing it.\n  // The guard refuses that outright.\n  //\n  // Of its two suggested remedies, neither is right here. A static `new Date(0)` default would change\n  // what every LIVE row means, not just erased ones — the lifecycle evaluator reads this to decide\n  // engagement, so a new member would read as inactive since 1970. Making it nullable + REMOVE pushes\n  // an `undefined` onto every consumer of a field that has always held a value.\n  //\n  // So the timestamp is RETAINED, and the notice can say so plainly. The mode is satisfied by\n  // `currentStage` and `stageHistory`, which carry the behavioural detail; a bare timestamp attached to\n  // a subject whose identity row has been scrubbed discloses very little on its own.\n  lastActiveAt: z.coerce.date().default(() => new Date()).dataCategories(PersonalDataCategory.USAGE),\n  /** Which activation criteria have been met (keyed by criterion ref) */\n  activationCriteriaMet: z.record(z.string(), z.boolean()).default({}),\n  /** Engagement metrics (tracked while ACTIVATED, used for ENGAGED transition) */\n  engagement: LifecycleEngagementSchema.default({\n    operationsSinceActivation: 0,\n    activeDates: [],\n  }),\n});\nexport type LifecycleState = z.infer<typeof LifecycleStateSchema>;\n\nexport const UserLifecycleStateSchema = LifecycleStateSchema.extend({\n  // `.isUnique()` = idempotency backstop for onParentCreate seeding (one row per user;\n  // the evaluator's read-then-create already tolerates the unique conflict).\n  userId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type UserLifecycleState = z.infer<typeof UserLifecycleStateSchema>;\n\nexport const OrganizationLifecycleStateSchema = LifecycleStateSchema.extend({\n  // `.isUnique()` = idempotency backstop for onParentCreate seeding (one row per org).\n  organizationId: z.string().min(1).isDBIndexed().isUnique().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type OrganizationLifecycleState = z.infer<typeof OrganizationLifecycleStateSchema>;\n\nexport type PersistedLifecycleState = UserLifecycleState | OrganizationLifecycleState;\n\n/** ──────────────────────────────────────────────────────────────\n * Stage History Utility\n * ────────────────────────────────────────────────────────────── */\n\n/** Check if the user has ACTUALLY visited a given stage (not a linear comparison).\n *  Uses `stagesVisited` for reliable lookups that survive the stageHistory cap.\n *  Falls back to `stageHistory` for documents created before `stagesVisited` was added. */\nexport function hasReachedStage(state: LifecycleState, targetStage: LifecycleStage): boolean {\n  if (state.currentStage === targetStage) return true;\n  if (state.stagesVisited?.length) {\n    return state.stagesVisited.includes(targetStage);\n  }\n  return state.stageHistory.some(entry => entry.stage === targetStage);\n}\n"]}

package/dist/esm/guidance/milestone-builders.shared.d.ts

@@ -1,5 +1,6 @@
 import { MilestoneType, MilestoneRewardType, ProgressionScope } from './milestone-definition.shared.schemas';
 import type { MilestoneDefinition, MilestoneReward, MilestoneTrigger, MilestoneLifecycleTransition } from './milestone-definition.shared.schemas';
+/** @wildo_source:part:start saas.models.milestone-definition */
 /**
  * defineMilestone() — Milestone Builder
  *
@@ -10,7 +11,7 @@ import type { MilestoneDefinition, MilestoneReward, MilestoneTrigger, MilestoneL
  * defineMilestone('FIRST_PROJECT_CREATED', {
  *   type: MilestoneType.FIRST_TIME,
  *   trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },
- *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: 'high' },
+ *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: MilestoneCelebrationLevel.HIGH },
  *   category: 'getting-started',
  *   points: 10,
  *   labels: { description: true },
@@ -22,7 +23,7 @@ import type { MilestoneDefinition, MilestoneReward, MilestoneTrigger, MilestoneL
  *   scope: ProgressionScope.ORGANIZATION,
  *   trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },
  *   threshold: 100,
- *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: 'high' },
+ *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: MilestoneCelebrationLevel.HIGH },
  *   category: 'team-achievements',
  *   points: 50,
  * })
@@ -44,6 +45,7 @@ export declare function defineMilestone(identifier: string, options: {
     lifecycleTransition?: MilestoneLifecycleTransition;
     dependencies?: string[];
 }): MilestoneDefinition;
+/** @wildo_source:part:end saas.models.milestone-definition */
 export { MilestoneType, MilestoneRewardType, ProgressionScope };
 export type { MilestoneDefinition, MilestoneReward, MilestoneTrigger, MilestoneLifecycleTransition };
 //# sourceMappingURL=milestone-builders.shared.d.ts.map

package/dist/esm/guidance/milestone-builders.shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"milestone-builders.shared.d.ts","sourceRoot":"","sources":["../../../src/guidance/milestone-builders.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC7G,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAElJ;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,IAAI,EAAE,aAAa,CAAC;IACpB;0FACsF;IACtF,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnC,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACA,mBAAmB,CAerB;AAGD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,CAAC"}
+{"version":3,"file":"milestone-builders.shared.d.ts","sourceRoot":"","sources":["../../../../src/guidance/milestone-builders.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC7G,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAElJ,gEAAgE;AAChE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,IAAI,EAAE,aAAa,CAAC;IACpB;0FACsF;IACtF,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnC,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACA,mBAAmB,CAerB;AACD,8DAA8D;AAG9D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/esm/guidance/milestone-builders.shared.js

@@ -1,4 +1,5 @@
 import { MilestoneType, MilestoneRewardType, ProgressionScope } from './milestone-definition.shared.schemas.js';
+/** @wildo_source:part:start saas.models.milestone-definition */
 /**
  * defineMilestone() — Milestone Builder
  *
@@ -9,7 +10,7 @@ import { MilestoneType, MilestoneRewardType, ProgressionScope } from './mileston
  * defineMilestone('FIRST_PROJECT_CREATED', {
  *   type: MilestoneType.FIRST_TIME,
  *   trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },
- *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: 'high' },
+ *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: MilestoneCelebrationLevel.HIGH },
  *   category: 'getting-started',
  *   points: 10,
  *   labels: { description: true },
@@ -21,7 +22,7 @@ import { MilestoneType, MilestoneRewardType, ProgressionScope } from './mileston
  *   scope: ProgressionScope.ORGANIZATION,
  *   trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },
  *   threshold: 100,
- *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: 'high' },
+ *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: MilestoneCelebrationLevel.HIGH },
  *   category: 'team-achievements',
  *   points: 50,
  * })
@@ -42,6 +43,7 @@ export function defineMilestone(identifier, options) {
         dependencies: options.dependencies ?? [],
     };
 }
+/** @wildo_source:part:end saas.models.milestone-definition */
 // Re-export types and enums for convenience from a single import point
 export { MilestoneType, MilestoneRewardType, ProgressionScope };
 //# sourceMappingURL=milestone-builders.shared.js.map

package/dist/esm/guidance/milestone-builders.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"milestone-builders.shared.js","sourceRoot":"","sources":["../../../../src/guidance/milestone-builders.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAG7G;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,OAcC;IAED,OAAO;QACL,UAAU;QACV,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAAC,IAAI;QAC7C,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["import { MilestoneType, MilestoneRewardType, ProgressionScope } from './milestone-definition.shared.schemas';\nimport type { MilestoneDefinition, MilestoneReward, MilestoneTrigger, MilestoneLifecycleTransition } from './milestone-definition.shared.schemas';\n\n/**\n * defineMilestone() — Milestone Builder\n * \n * Creates a MilestoneDefinition with sensible defaults.\n * Follows the same pattern as defineFeature() / defineLimitFeature().\n * \n * @example // Personal milestone (scope defaults to USER)\n * defineMilestone('FIRST_PROJECT_CREATED', {\n *   type: MilestoneType.FIRST_TIME,\n *   trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },\n *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: 'high' },\n *   category: 'getting-started',\n *   points: 10,\n *   labels: { description: true },\n * })\n * \n * @example // Org-wide milestone — any member creating the 100th project triggers it\n * defineMilestone('ORG_100_PROJECTS', {\n *   type: MilestoneType.COUNT_THRESHOLD,\n *   scope: ProgressionScope.ORGANIZATION,\n *   trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },\n *   threshold: 100,\n *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: 'high' },\n *   category: 'team-achievements',\n *   points: 50,\n * })\n */\nexport function defineMilestone(\n  identifier: string,\n  options: {\n    type: MilestoneType;\n    /** Scope of this milestone — defaults to USER if omitted.\n     *  ORGANIZATION milestones track collective achievements (any member can trigger). */\n    scope?: ProgressionScope;\n    trigger: MilestoneTrigger;\n    threshold?: number;\n    conditionRef?: string;\n    reward: MilestoneReward;\n    category: string;\n    points?: number;\n    labels?: { description?: boolean };\n    lifecycleTransition?: MilestoneLifecycleTransition;\n    dependencies?: string[];\n  }\n): MilestoneDefinition {\n  return {\n    identifier,\n    type: options.type,\n    scope: options.scope ?? ProgressionScope.USER,\n    trigger: options.trigger,\n    threshold: options.threshold,\n    conditionRef: options.conditionRef,\n    reward: options.reward,\n    category: options.category,\n    points: options.points ?? 0,\n    labels: options.labels,\n    lifecycleTransition: options.lifecycleTransition,\n    dependencies: options.dependencies ?? [],\n  };\n}\n\n// Re-export types and enums for convenience from a single import point\nexport { MilestoneType, MilestoneRewardType, ProgressionScope };\nexport type { MilestoneDefinition, MilestoneReward, MilestoneTrigger, MilestoneLifecycleTransition };\n"]}
+{"version":3,"file":"milestone-builders.shared.js","sourceRoot":"","sources":["../../../../src/guidance/milestone-builders.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAG7G,gEAAgE;AAChE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,OAcC;IAED,OAAO;QACL,UAAU;QACV,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAAC,IAAI;QAC7C,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QAC3B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;KACzC,CAAC;AACJ,CAAC;AACD,8DAA8D;AAE9D,uEAAuE;AACvE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["import { MilestoneType, MilestoneRewardType, ProgressionScope } from './milestone-definition.shared.schemas';\nimport type { MilestoneDefinition, MilestoneReward, MilestoneTrigger, MilestoneLifecycleTransition } from './milestone-definition.shared.schemas';\n\n/** @wildo_source:part:start saas.models.milestone-definition */\n/**\n * defineMilestone() — Milestone Builder\n * \n * Creates a MilestoneDefinition with sensible defaults.\n * Follows the same pattern as defineFeature() / defineLimitFeature().\n * \n * @example // Personal milestone (scope defaults to USER)\n * defineMilestone('FIRST_PROJECT_CREATED', {\n *   type: MilestoneType.FIRST_TIME,\n *   trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },\n *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: MilestoneCelebrationLevel.HIGH },\n *   category: 'getting-started',\n *   points: 10,\n *   labels: { description: true },\n * })\n * \n * @example // Org-wide milestone — any member creating the 100th project triggers it\n * defineMilestone('ORG_100_PROJECTS', {\n *   type: MilestoneType.COUNT_THRESHOLD,\n *   scope: ProgressionScope.ORGANIZATION,\n *   trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },\n *   threshold: 100,\n *   reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: MilestoneCelebrationLevel.HIGH },\n *   category: 'team-achievements',\n *   points: 50,\n * })\n */\nexport function defineMilestone(\n  identifier: string,\n  options: {\n    type: MilestoneType;\n    /** Scope of this milestone — defaults to USER if omitted.\n     *  ORGANIZATION milestones track collective achievements (any member can trigger). */\n    scope?: ProgressionScope;\n    trigger: MilestoneTrigger;\n    threshold?: number;\n    conditionRef?: string;\n    reward: MilestoneReward;\n    category: string;\n    points?: number;\n    labels?: { description?: boolean };\n    lifecycleTransition?: MilestoneLifecycleTransition;\n    dependencies?: string[];\n  }\n): MilestoneDefinition {\n  return {\n    identifier,\n    type: options.type,\n    scope: options.scope ?? ProgressionScope.USER,\n    trigger: options.trigger,\n    threshold: options.threshold,\n    conditionRef: options.conditionRef,\n    reward: options.reward,\n    category: options.category,\n    points: options.points ?? 0,\n    labels: options.labels,\n    lifecycleTransition: options.lifecycleTransition,\n    dependencies: options.dependencies ?? [],\n  };\n}\n/** @wildo_source:part:end saas.models.milestone-definition */\n\n// Re-export types and enums for convenience from a single import point\nexport { MilestoneType, MilestoneRewardType, ProgressionScope };\nexport type { MilestoneDefinition, MilestoneReward, MilestoneTrigger, MilestoneLifecycleTransition };\n"]}

package/dist/esm/guidance/milestone-definition.shared.schemas.d.ts

@@ -1,8 +1,18 @@
+import { CelebrationDisplayMode } from '../notifications/notifications.shared.schemas';
 import { CoreResourceOperation } from '../resources/resources.shared.core.definitions';
 import { CoreResourceType } from '../resources/resources.shared.core.definitions';
+import { LifecycleStage } from './lifecycle-state.shared.schemas';
 /** ──────────────────────────────────────────────────────────────
  * Milestone Type — Condition Evaluation Strategy
  * ────────────────────────────────────────────────────────────── */
+/**
+ * @wildo_source:part:start saas.models.milestone-definition facet:layer:shared facet:family:progression facet:audience:app-developer
+ *
+ * A milestone is a moment in a person's (or an organization's) use of the application that the
+ * application wants to recognise: the first project created, the tenth todo completed. Declare them
+ * in `shared-lib/src/engine/milestones.ts`; the framework counts the triggering operations, marks a
+ * milestone achieved, awards its points and delivers its reward. Import from `@wildo-ai/saas-models`.
+ */
 export declare enum MilestoneType {
     /** Achieved on first occurrence of the trigger operation */
     FIRST_TIME = "first_time",
@@ -32,26 +42,77 @@ export declare enum ProgressionScope {
      *  (e.g., "Team reached 50 members", "First integration configured") */
     ORGANIZATION = "organization"
 }
+/** @wildo_source:part:end saas.models.milestone-definition */
 /** Maps ProgressionScope to the CoreResourceType that stores its state */
 export declare const PROGRESSION_SCOPE_TO_RESOURCE: Record<ProgressionScope, CoreResourceType>;
 /** ──────────────────────────────────────────────────────────────
  * Milestone Lifecycle Transition — Phase 5 Integration Point
  * ────────────────────────────────────────────────────────────── */
+/** @wildo_source:part:start saas.models.milestone-definition */
+/**
+ * The lifecycle stage change a milestone triggers when it is achieved — for example moving a person
+ * from `LifecycleStage.SIGNED_UP` to `LifecycleStage.ACTIVATED` when they create their first project.
+ *
+ * Use the `LifecycleStage` enum values, not their names. When the application's lifecycle config
+ * declares no `activationCriteria`, a milestone transition is how activation happens at all.
+ */
 export interface MilestoneLifecycleTransition {
-    from: string;
-    to: string;
+    from: LifecycleStage;
+    to: LifecycleStage;
 }
+/** @wildo_source:part:end saas.models.milestone-definition */
 /** ──────────────────────────────────────────────────────────────
  * Milestone Reward Definition
  * ────────────────────────────────────────────────────────────── */
+/**
+ * @wildo_source:part:start saas.models.milestone-celebration facet:layer:shared facet:family:progression facet:audience:app-developer
+ *
+ * How much of a moment a milestone is — NOT how it is drawn.
+ *
+ * Presentation is a separate choice, `celebrationMode` (a `CelebrationDisplayMode`), so that a
+ * milestone can be significant without having to accept a particular animation. Leave the mode out
+ * and the level picks one through `DEFAULT_CELEBRATION_MODE_BY_LEVEL`.
+ */
+export declare enum MilestoneCelebrationLevel {
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high"
+}
+/**
+ * The display mode each level gets when a milestone does not name one — the framework's default,
+ * readable so an application knows what it is opting out of when it sets `celebrationMode`.
+ */
+export declare const DEFAULT_CELEBRATION_MODE_BY_LEVEL: Record<MilestoneCelebrationLevel, CelebrationDisplayMode>;
+/**
+ * How a celebration is drawn, in order: the milestone's own `celebrationMode`; else the default for
+ * its `celebrationLevel`; else `CONFETTI`, the quietest presentation, for a reward that says neither.
+ */
+export declare function resolveCelebrationDisplayMode(reward: {
+    readonly celebrationLevel?: MilestoneCelebrationLevel;
+    readonly celebrationMode?: CelebrationDisplayMode;
+}): CelebrationDisplayMode;
+/** @wildo_source:part:end saas.models.milestone-celebration */
+/** @wildo_source:part:start saas.models.milestone-definition */
+/**
+ * What a person gets when the milestone is achieved. `type` picks which of the other fields apply:
+ * `CELEBRATION` reads `celebrationLevel` / `celebrationMode`, `FEATURE_UNLOCK` reads `featureRef`,
+ * `GUIDANCE_FLOW` reads `guidanceFlowRef`.
+ */
 export interface MilestoneReward {
     type: MilestoneRewardType;
     /** For FEATURE_UNLOCK: the feature identifier to enable */
     featureRef?: string;
     /** For GUIDANCE_FLOW: the guidance flow ref to activate */
     guidanceFlowRef?: string;
-    /** For CELEBRATION: notification severity level (controls animation intensity) */
-    celebrationLevel?: 'low' | 'medium' | 'high';
+    /** For CELEBRATION: how big a moment this is. Presentation follows from it unless overridden. */
+    celebrationLevel?: MilestoneCelebrationLevel;
+    /**
+     * For CELEBRATION: draw it THIS way, whatever the level would have chosen.
+     *
+     * Makes the level a default rather than a verdict: a milestone that is significant but should
+     * still get confetti says so here. Omit it to get {@link DEFAULT_CELEBRATION_MODE_BY_LEVEL}.
+     */
+    celebrationMode?: CelebrationDisplayMode;
 }
 /** ──────────────────────────────────────────────────────────────
  * Milestone Trigger — What Operation Triggers Evaluation
@@ -100,6 +161,7 @@ export interface MilestoneDefinition {
      *  Dependencies are validated and evaluated within the same progression scope. */
     dependencies?: string[];
 }
+/** @wildo_source:part:end saas.models.milestone-definition */
 /** ──────────────────────────────────────────────────────────────
  * Milestone Label Fields — i18n Key Generation Configuration
  * ────────────────────────────────────────────────────────────── */

package/dist/esm/guidance/milestone-definition.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"milestone-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/milestone-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAElF;;oEAEoE;AAEpE,oBAAY,aAAa;IACvB,4DAA4D;IAC5D,UAAU,eAAe;IACzB,0DAA0D;IAC1D,eAAe,oBAAoB;IACnC,6DAA6D;IAC7D,gBAAgB,qBAAqB;CACtC;AAED;;oEAEoE;AAEpE,oBAAY,mBAAmB;IAC7B,uEAAuE;IACvE,WAAW,gBAAgB;IAC3B,8EAA8E;IAC9E,cAAc,mBAAmB;IACjC,2CAA2C;IAC3C,aAAa,kBAAkB;CAChC;AAED;;oEAEoE;AAEpE,oBAAY,gBAAgB;IAC1B,6EAA6E;IAC7E,IAAI,SAAS;IACb;4EACwE;IACxE,YAAY,iBAAiB;CAC9B;AAED,0EAA0E;AAC1E,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAGpF,CAAC;AAEF;;oEAEoE;AAEpE,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;oEAEoE;AAEpE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC9C;AAED;;oEAEoE;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,SAAS,EAAE,qBAAqB,CAAC;CAClC;AAED;;oEAEoE;AAEpE,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,IAAI,EAAE,aAAa,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,mEAAmE;IACnE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;gGAE4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,MAAM,EAAE,eAAe,CAAC;IACxB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD;sFACkF;IAClF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;oEAEoE"}
+{"version":3,"file":"milestone-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/milestone-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE;;oEAEoE;AAEpE;;;;;;;GAOG;AACH,oBAAY,aAAa;IACvB,4DAA4D;IAC5D,UAAU,eAAe;IACzB,0DAA0D;IAC1D,eAAe,oBAAoB;IACnC,6DAA6D;IAC7D,gBAAgB,qBAAqB;CACtC;AAED;;oEAEoE;AAEpE,oBAAY,mBAAmB;IAC7B,uEAAuE;IACvE,WAAW,gBAAgB;IAC3B,8EAA8E;IAC9E,cAAc,mBAAmB;IACjC,2CAA2C;IAC3C,aAAa,kBAAkB;CAChC;AAED;;oEAEoE;AAEpE,oBAAY,gBAAgB;IAC1B,6EAA6E;IAC7E,IAAI,SAAS;IACb;4EACwE;IACxE,YAAY,iBAAiB;CAC9B;AAED,8DAA8D;AAE9D,0EAA0E;AAC1E,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,gBAAgB,EAAE,gBAAgB,CAGpF,CAAC;AAEF;;oEAEoE;AAEpE,gEAAgE;AAChE;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,cAAc,CAAC;CACpB;AACD,8DAA8D;AAE9D;;oEAEoE;AAEpE;;;;;;;;GAQG;AACH,oBAAY,yBAAyB;IACnC,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,yBAAyB,EAAE,sBAAsB,CAIvG,CAAC;AAEF;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC;CACnD,GAAG,sBAAsB,CAIzB;AACD,+DAA+D;AAE/D,gEAAgE;AAChE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED;;oEAEoE;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,SAAS,EAAE,qBAAqB,CAAC;CAClC;AAED;;oEAEoE;AAEpE,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,IAAI,EAAE,aAAa,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,mEAAmE;IACnE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;gGAE4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,MAAM,EAAE,eAAe,CAAC;IACxB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD;sFACkF;IAClF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AACD,8DAA8D;AAE9D;;oEAEoE"}

package/dist/esm/guidance/milestone-definition.shared.schemas.js

@@ -1,7 +1,16 @@
+import { CelebrationDisplayMode } from '../notifications/notifications.shared.schemas.js';
 import { CoreResourceType } from '../resources/resources.shared.core.definitions.js';
 /** ──────────────────────────────────────────────────────────────
  * Milestone Type — Condition Evaluation Strategy
  * ────────────────────────────────────────────────────────────── */
+/**
+ * @wildo_source:part:start saas.models.milestone-definition facet:layer:shared facet:family:progression facet:audience:app-developer
+ *
+ * A milestone is a moment in a person's (or an organization's) use of the application that the
+ * application wants to recognise: the first project created, the tenth todo completed. Declare them
+ * in `shared-lib/src/engine/milestones.ts`; the framework counts the triggering operations, marks a
+ * milestone achieved, awards its points and delivers its reward. Import from `@wildo-ai/saas-models`.
+ */
 export var MilestoneType;
 (function (MilestoneType) {
     /** Achieved on first occurrence of the trigger operation */
@@ -34,11 +43,52 @@ export var ProgressionScope;
      *  (e.g., "Team reached 50 members", "First integration configured") */
     ProgressionScope["ORGANIZATION"] = "organization";
 })(ProgressionScope || (ProgressionScope = {}));
+/** @wildo_source:part:end saas.models.milestone-definition */
 /** Maps ProgressionScope to the CoreResourceType that stores its state */
 export const PROGRESSION_SCOPE_TO_RESOURCE = {
     [ProgressionScope.USER]: CoreResourceType.USER_PROGRESSION_STATE,
     [ProgressionScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_PROGRESSION_STATE,
 };
+/** @wildo_source:part:end saas.models.milestone-definition */
+/** ──────────────────────────────────────────────────────────────
+ * Milestone Reward Definition
+ * ────────────────────────────────────────────────────────────── */
+/**
+ * @wildo_source:part:start saas.models.milestone-celebration facet:layer:shared facet:family:progression facet:audience:app-developer
+ *
+ * How much of a moment a milestone is — NOT how it is drawn.
+ *
+ * Presentation is a separate choice, `celebrationMode` (a `CelebrationDisplayMode`), so that a
+ * milestone can be significant without having to accept a particular animation. Leave the mode out
+ * and the level picks one through `DEFAULT_CELEBRATION_MODE_BY_LEVEL`.
+ */
+export var MilestoneCelebrationLevel;
+(function (MilestoneCelebrationLevel) {
+    MilestoneCelebrationLevel["LOW"] = "low";
+    MilestoneCelebrationLevel["MEDIUM"] = "medium";
+    MilestoneCelebrationLevel["HIGH"] = "high";
+})(MilestoneCelebrationLevel || (MilestoneCelebrationLevel = {}));
+/**
+ * The display mode each level gets when a milestone does not name one — the framework's default,
+ * readable so an application knows what it is opting out of when it sets `celebrationMode`.
+ */
+export const DEFAULT_CELEBRATION_MODE_BY_LEVEL = {
+    [MilestoneCelebrationLevel.LOW]: CelebrationDisplayMode.CONFETTI,
+    [MilestoneCelebrationLevel.MEDIUM]: CelebrationDisplayMode.OVERLAY,
+    [MilestoneCelebrationLevel.HIGH]: CelebrationDisplayMode.LOTTIE,
+};
+/**
+ * How a celebration is drawn, in order: the milestone's own `celebrationMode`; else the default for
+ * its `celebrationLevel`; else `CONFETTI`, the quietest presentation, for a reward that says neither.
+ */
+export function resolveCelebrationDisplayMode(reward) {
+    if (reward.celebrationMode)
+        return reward.celebrationMode;
+    if (reward.celebrationLevel)
+        return DEFAULT_CELEBRATION_MODE_BY_LEVEL[reward.celebrationLevel];
+    return CelebrationDisplayMode.CONFETTI;
+}
+/** @wildo_source:part:end saas.models.milestone-definition */
 /** ──────────────────────────────────────────────────────────────
  * Milestone Label Fields — i18n Key Generation Configuration
  * ────────────────────────────────────────────────────────────── */