@wildo-ai/saas-models 1.1.7 → 1.1.8

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/** 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).describe('The stage entered.'),\n  /** When this stage was entered */\n  enteredAt: z.coerce.date().describe('When the stage was entered.'),\n  /** When this stage was exited (undefined if current) */\n  exitedAt: z.coerce.date().optional().describe('When the stage was left. Absent for the current stage, and occasionally for an earlier one when two transitions happened at once.'),\n  /** What triggered this transition (milestone ref, cron, operation, etc.) */\n  trigger: z.string().optional().describe('What caused the transition: `auto_create` for the initial stage, `operation:<operation>`, `milestone:<milestone>`, `guidance_completed`, `engagement_threshold`, `dormancy_cron` or `on_read_reactivation`.'),\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).describe('Operations performed while in the `activated` or `reactivated` stage. Reset to 0 on reactivation, and compared with the configured engagement threshold to move to `engaged`.'),\n  /** Distinct active dates since activation (YYYY-MM-DD strings) */\n  activeDates: z.array(z.string()).default([]).describe('Distinct UTC calendar days (`YYYY-MM-DD`) with at least one operation while in the `activated` or `reactivated` stage. Cleared on reactivation.'),\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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;oEAEoE;AAEpE,iFAAiF;AACjF,MAAM,CAAN,IAAY,cAeX;AAfD,WAAY,cAAc;IACxB,4DAA4D;IAC5D,yCAAuB,CAAA;IACvB,+DAA+D;IAC/D,yCAAuB,CAAA;IACvB,uFAAuF;IACvF,qCAAmB,CAAA;IACnB,yDAAyD;IACzD,qCAAmB,CAAA;IACnB,2CAA2C;IAC3C,6CAA2B,CAAA;IAC3B,sDAAsD;IACtD,qCAAmB,CAAA;IACnB,gDAAgD;IAChD,2CAAyB,CAAA;AAC3B,CAAC,EAfW,cAAc,KAAd,cAAc,QAezB;AAED;;oEAEoE;AAEpE,sEAAsE;AACtE,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,+CAA6B,CAAA;AAC/B,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED;;oEAEoE;AAEpE;uDACuD;AACvD,MAAM,CAAC,MAAM,2BAA2B,GAAgE;IACtG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;IACtD,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;IAC5E,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC;IAClD,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC;IAC9E,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;IAC9E,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC;IACrD,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,EAAE;CACvB,CAAC;AAEX,uFAAuF;AACvF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,cAAc,CAAC,SAAS;IACxB,cAAc,CAAC,OAAO;IACtB,cAAc,CAAC,WAAW;CAClB,CAAC;AAEX,sFAAsF;AACtF,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,cAAc,CAAC,SAAS;IACxB,cAAc,CAAC,WAAW;CAClB,CAAC;AAEX,uFAAuF;AACvF,MAAM,CAAC,MAAM,2BAA2B,GAAuD;IAC7F,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,oBAAoB;IAC5D,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,4BAA4B;CACpE,CAAC;AAEX;;gEAEgE;AAChE,MAAM,CAAC,MAAM,iCAAiC,GAAuD;IACnG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,sBAAsB;IAC9D,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,8BAA8B;CACtE,CAAC;AAEX,qHAAqH;AACrH,MAAM,CAAC,MAAM,8BAA8B,GAAuD;IAChG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,mBAAmB;IAC3D,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,2BAA2B;CACnE,CAAC;AAEX;uFACuF;AACvF,MAAM,CAAC,MAAM,wBAAwB,GAAkC,IAAI,GAAG,CAAC;IAC7E,gBAAgB,CAAC,oBAAoB;IACrC,gBAAgB,CAAC,4BAA4B;CAC9C,CAAC,CAAC;AAEH,oGAAoG;AACpG,MAAM,CAAC,MAAM,6BAA6B,GAAkC,IAAI,GAAG,CAAC;IAClF,gBAAgB,CAAC,mBAAmB;IACpC,gBAAgB,CAAC,2BAA2B;CAC7C,CAAC,CAAC;AAEH;;oEAEoE;AAEpE,yEAAyE;AACzE,MAAM,UAAU,0BAA0B,CAAC,IAAoB,EAAE,EAAkB;IACjF,OAAO,2BAA2B,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;AAClE,CAAC;AAED;;oEAEoE;AAEpE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,6BAA6B;IAC7B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC5D,kCAAkC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAClE,wDAAwD;IACxD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mIAAmI,CAAC;IAClL,4EAA4E;IAC5E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6MAA6M,CAAC;CACvP,CAAC,CAAC;AAGH,yDAAyD;AACzD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,wCAAwC;IACxC,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+KAA+K,CAAC;IAChP,kEAAkE;IAClE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iJAAiJ,CAAC;CACzM,CAAC,CAAC;AAGH;;wDAEwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,8BAA8B;IAC9B,iGAAiG;IACjG,+DAA+D;IAC/D,iHAAiH;IACjH,iGAAiG;IACjG,iGAAiG;IACjG,wFAAwF;IACxF,YAAY,EAAE,oBAAoB,CAClC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE;SACpE,cAAc,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAC7C,aAAa,CAAC,KAAK,CACpB;IACD;0FACsF;IACtF,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IACzD,0EAA0E;IAC1E,iIAAiI;IACjI,iGAAiG;IACjG,iGAAiG;IACjG,wFAAwF;IACxF,YAAY,EAAE,oBAAoB,CAClC,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAC5F,aAAa,CAAC,KAAK,CACpB;IACD;4EACwE;IACxE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1D;2EACuE;IACvE,oGAAoG;IACpG,EAAE;IACF,qGAAqG;IACrG,sGAAsG;IACtG,qGAAqG;IACrG,mCAAmC;IACnC,EAAE;IACF,oGAAoG;IACpG,iGAAiG;IACjG,oGAAoG;IACpG,8EAA8E;IAC9E,EAAE;IACF,4FAA4F;IAC5F,sGAAsG;IACtG,mFAAmF;IACnF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,oBAAoB,CAAC,KAAK,CAAC;IAClG,uEAAuE;IACvE,qBAAqB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpE,gFAAgF;IAChF,UAAU,EAAE,yBAAyB,CAAC,OAAO,CAAC;QAC5C,yBAAyB,EAAE,CAAC;QAC5B,WAAW,EAAE,EAAE;KAChB,CAAC;CACH,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAClE,qFAAqF;IACrF,2EAA2E;IAC3E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;CACvG,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gCAAgC,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAC1E,qFAAqF;IACrF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;CAC/G,CAAC,CAAC;AAKH;;oEAEoE;AAEpE;;2FAE2F;AAC3F,MAAM,UAAU,eAAe,CAAC,KAAqB,EAAE,WAA2B;IAChF,IAAI,KAAK,CAAC,YAAY,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC;AACvE,CAAC","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).describe('The stage entered.'),\n  /** When this stage was entered */\n  enteredAt: z.coerce.date().describe('When the stage was entered.'),\n  /** When this stage was exited (undefined if current) */\n  exitedAt: z.coerce.date().optional().describe('When the stage was left. Absent for the current stage, and occasionally for an earlier one when two transitions happened at once.'),\n  /** What triggered this transition (milestone ref, cron, operation, etc.) */\n  trigger: z.string().optional().describe('What caused the transition: `auto_create` for the initial stage, `operation:<operation>`, `milestone:<milestone>`, `guidance_completed`, `engagement_threshold`, `dormancy_cron` or `on_read_reactivation`.'),\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).describe('Operations performed while in the `activated` or `reactivated` stage. Reset to 0 on reactivation, and compared with the configured engagement threshold to move to `engaged`.'),\n  /** Distinct active dates since activation (YYYY-MM-DD strings) */\n  activeDates: z.array(z.string()).default([]).describe('Distinct UTC calendar days (`YYYY-MM-DD`) with at least one operation while in the `activated` or `reactivated` stage. Cleared on reactivation.'),\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.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,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"}
+{"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.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,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"]}
+{"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.map

@@ -1 +1 @@
-{"version":3,"file":"milestone-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/milestone-definition.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"milestone-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/milestone-definition.shared.schemas.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"milestone-definition.shared.schemas.js","sourceRoot":"","sources":["../../../src/guidance/milestone-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAGlF;;oEAEoE;AAEpE;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,4DAA4D;IAC5D,0CAAyB,CAAA;IACzB,0DAA0D;IAC1D,oDAAmC,CAAA;IACnC,6DAA6D;IAC7D,sDAAqC,CAAA;AACvC,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAED;;oEAEoE;AAEpE,MAAM,CAAN,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAC7B,uEAAuE;IACvE,kDAA2B,CAAA;IAC3B,8EAA8E;IAC9E,wDAAiC,CAAA;IACjC,2CAA2C;IAC3C,sDAA+B,CAAA;AACjC,CAAC,EAPW,mBAAmB,KAAnB,mBAAmB,QAO9B;AAED;;oEAEoE;AAEpE,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,6EAA6E;IAC7E,iCAAa,CAAA;IACb;4EACwE;IACxE,iDAA6B,CAAA;AAC/B,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAED,8DAA8D;AAE9D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,6BAA6B,GAA+C;IACvF,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,sBAAsB;IAChE,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,8BAA8B;CACjF,CAAC;AAkBF,8DAA8D;AAE9D;;oEAEoE;AAEpE;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACnC,wCAAW,CAAA;IACX,8CAAiB,CAAA;IACjB,0CAAa,CAAA;AACf,CAAC,EAJW,yBAAyB,KAAzB,yBAAyB,QAIpC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAA8D;IAC1G,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,sBAAsB,CAAC,QAAQ;IAChE,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,OAAO;IAClE,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC,MAAM;CAChE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAG7C;IACC,IAAI,MAAM,CAAC,eAAe;QAAE,OAAO,MAAM,CAAC,eAAe,CAAC;IAC1D,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,iCAAiC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC/F,OAAO,sBAAsB,CAAC,QAAQ,CAAC;AACzC,CAAC;AA4ED,8DAA8D;AAE9D;;oEAEoE","sourcesContent":["import { CelebrationDisplayMode } from '../notifications/notifications.shared.schemas';\nimport { CoreResourceOperation } from '../resources/resources.shared.core.definitions';\nimport { CoreResourceType } from '../resources/resources.shared.core.definitions';\nimport { LifecycleStage } from './lifecycle-state.shared.schemas';\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Type — Condition Evaluation Strategy\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * @wildo_source:part:start saas.models.milestone-definition facet:layer:shared facet:family:progression facet:audience:app-developer\n *\n * A milestone is a moment in a person's (or an organization's) use of the application that the\n * application wants to recognise: the first project created, the tenth todo completed. Declare them\n * in `shared-lib/src/engine/milestones.ts`; the framework counts the triggering operations, marks a\n * milestone achieved, awards its points and delivers its reward. Import from `@wildo-ai/saas-models`.\n */\nexport enum MilestoneType {\n  /** Achieved on first occurrence of the trigger operation */\n  FIRST_TIME = 'first_time',\n  /** Achieved when operation count reaches the threshold */\n  COUNT_THRESHOLD = 'count_threshold',\n  /** Achieved when a custom condition function returns true */\n  CUSTOM_CONDITION = 'custom_condition',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Reward Type\n * ────────────────────────────────────────────────────────────── */\n\nexport enum MilestoneRewardType {\n  /** Visual celebration (confetti, animation) via notification system */\n  CELEBRATION = 'celebration',\n  /** Unlock a feature by writing override to scope-matched features resource */\n  FEATURE_UNLOCK = 'feature_unlock',\n  /** Activate a guidance flow via WS push */\n  GUIDANCE_FLOW = 'guidance_flow',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Progression Scope — Bi-Scope State Routing\n * ────────────────────────────────────────────────────────────── */\n\nexport enum ProgressionScope {\n  /** State stored in USER_PROGRESSION_STATE — personal milestones (default) */\n  USER = 'user',\n  /** State stored in ORGANIZATION_PROGRESSION_STATE — org-wide milestones\n   *  (e.g., \"Team reached 50 members\", \"First integration configured\") */\n  ORGANIZATION = 'organization',\n}\n\n/** @wildo_source:part:end saas.models.milestone-definition */\n\n/** Maps ProgressionScope to the CoreResourceType that stores its state */\nexport const PROGRESSION_SCOPE_TO_RESOURCE: Record<ProgressionScope, CoreResourceType> = {\n  [ProgressionScope.USER]: CoreResourceType.USER_PROGRESSION_STATE,\n  [ProgressionScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_PROGRESSION_STATE,\n};\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Lifecycle Transition — Phase 5 Integration Point\n * ────────────────────────────────────────────────────────────── */\n\n/** @wildo_source:part:start saas.models.milestone-definition */\n/**\n * The lifecycle stage change a milestone triggers when it is achieved — for example moving a person\n * from `LifecycleStage.SIGNED_UP` to `LifecycleStage.ACTIVATED` when they create their first project.\n *\n * Use the `LifecycleStage` enum values, not their names. When the application's lifecycle config\n * declares no `activationCriteria`, a milestone transition is how activation happens at all.\n */\nexport interface MilestoneLifecycleTransition {\n  from: LifecycleStage;\n  to: LifecycleStage;\n}\n/** @wildo_source:part:end saas.models.milestone-definition */\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Reward Definition\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * @wildo_source:part:start saas.models.milestone-celebration facet:layer:shared facet:family:progression facet:audience:app-developer\n *\n * How much of a moment a milestone is — NOT how it is drawn.\n *\n * Presentation is a separate choice, `celebrationMode` (a `CelebrationDisplayMode`), so that a\n * milestone can be significant without having to accept a particular animation. Leave the mode out\n * and the level picks one through `DEFAULT_CELEBRATION_MODE_BY_LEVEL`.\n */\nexport enum MilestoneCelebrationLevel {\n  LOW = 'low',\n  MEDIUM = 'medium',\n  HIGH = 'high',\n}\n\n/**\n * The display mode each level gets when a milestone does not name one — the framework's default,\n * readable so an application knows what it is opting out of when it sets `celebrationMode`.\n */\nexport const DEFAULT_CELEBRATION_MODE_BY_LEVEL: Record<MilestoneCelebrationLevel, CelebrationDisplayMode> = {\n  [MilestoneCelebrationLevel.LOW]: CelebrationDisplayMode.CONFETTI,\n  [MilestoneCelebrationLevel.MEDIUM]: CelebrationDisplayMode.OVERLAY,\n  [MilestoneCelebrationLevel.HIGH]: CelebrationDisplayMode.LOTTIE,\n};\n\n/**\n * How a celebration is drawn, in order: the milestone's own `celebrationMode`; else the default for\n * its `celebrationLevel`; else `CONFETTI`, the quietest presentation, for a reward that says neither.\n */\nexport function resolveCelebrationDisplayMode(reward: {\n  readonly celebrationLevel?: MilestoneCelebrationLevel;\n  readonly celebrationMode?: CelebrationDisplayMode;\n}): CelebrationDisplayMode {\n  if (reward.celebrationMode) return reward.celebrationMode;\n  if (reward.celebrationLevel) return DEFAULT_CELEBRATION_MODE_BY_LEVEL[reward.celebrationLevel];\n  return CelebrationDisplayMode.CONFETTI;\n}\n/** @wildo_source:part:end saas.models.milestone-celebration */\n\n/** @wildo_source:part:start saas.models.milestone-definition */\n/**\n * What a person gets when the milestone is achieved. `type` picks which of the other fields apply:\n * `CELEBRATION` reads `celebrationLevel` / `celebrationMode`, `FEATURE_UNLOCK` reads `featureRef`,\n * `GUIDANCE_FLOW` reads `guidanceFlowRef`.\n */\nexport interface MilestoneReward {\n  type: MilestoneRewardType;\n  /** For FEATURE_UNLOCK: the feature identifier to enable */\n  featureRef?: string;\n  /** For GUIDANCE_FLOW: the guidance flow ref to activate */\n  guidanceFlowRef?: string;\n  /** For CELEBRATION: how big a moment this is. Presentation follows from it unless overridden. */\n  celebrationLevel?: MilestoneCelebrationLevel;\n  /**\n   * For CELEBRATION: draw it THIS way, whatever the level would have chosen.\n   *\n   * Makes the level a default rather than a verdict: a milestone that is significant but should\n   * still get confetti says so here. Omit it to get {@link DEFAULT_CELEBRATION_MODE_BY_LEVEL}.\n   */\n  celebrationMode?: CelebrationDisplayMode;\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Trigger — What Operation Triggers Evaluation\n * ────────────────────────────────────────────────────────────── */\n\nexport interface MilestoneTrigger {\n  /** Resource type that triggers evaluation */\n  resourceType: string;\n  /** Operation that triggers evaluation */\n  operation: CoreResourceOperation;\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Definition — Full Declaration\n * ────────────────────────────────────────────────────────────── */\n\nexport interface MilestoneDefinition {\n  /** Unique milestone identifier (e.g., 'FIRST_PROJECT_CREATED') */\n  identifier: string;\n  /** Milestone type — determines condition evaluation logic */\n  type: MilestoneType;\n  /** State scope — determines which resource stores this milestone's progress.\n   *  USER (default): personal milestones, each user has their own state.\n   *  ORGANIZATION: org-wide milestones, shared across all members. When any member\n   *    triggers \"org reached 50 members\", it's achieved for the whole org.\n   */\n  scope?: ProgressionScope;\n  /** What resource operation triggers this milestone's evaluation */\n  trigger: MilestoneTrigger;\n  /** For COUNT_THRESHOLD: the count that must be reached */\n  threshold?: number;\n  /** For CUSTOM_CONDITION: condition function reference key.\n   *  Receives (operationCounts, milestonesAchieved) and returns boolean.\n   *  Note: Serialized as a reference string for frontend — backend evaluates the function. */\n  conditionRef?: string;\n  /** What the user gets when milestone is achieved */\n  reward: MilestoneReward;\n  /** Category for grouping (e.g., 'getting-started', 'power-user') */\n  category: string;\n  /** Points awarded for this milestone (for gamification) */\n  points?: number;\n  /** i18n: which labels to generate */\n  labels?: {\n    description?: boolean;\n  };\n  /** Phase 5 integration: lifecycle stage transition triggered by this milestone */\n  lifecycleTransition?: MilestoneLifecycleTransition;\n  /** Dependencies: milestone refs that must be achieved first (for unlocking chains).\n   *  Dependencies are validated and evaluated within the same progression scope. */\n  dependencies?: string[];\n}\n/** @wildo_source:part:end saas.models.milestone-definition */\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Label Fields — i18n Key Generation Configuration\n * ────────────────────────────────────────────────────────────── */\n\n"]}
+{"version":3,"file":"milestone-definition.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/milestone-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAGlF;;oEAEoE;AAEpE;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,4DAA4D;IAC5D,0CAAyB,CAAA;IACzB,0DAA0D;IAC1D,oDAAmC,CAAA;IACnC,6DAA6D;IAC7D,sDAAqC,CAAA;AACvC,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAED;;oEAEoE;AAEpE,MAAM,CAAN,IAAY,mBAOX;AAPD,WAAY,mBAAmB;IAC7B,uEAAuE;IACvE,kDAA2B,CAAA;IAC3B,8EAA8E;IAC9E,wDAAiC,CAAA;IACjC,2CAA2C;IAC3C,sDAA+B,CAAA;AACjC,CAAC,EAPW,mBAAmB,KAAnB,mBAAmB,QAO9B;AAED;;oEAEoE;AAEpE,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,6EAA6E;IAC7E,iCAAa,CAAA;IACb;4EACwE;IACxE,iDAA6B,CAAA;AAC/B,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAED,8DAA8D;AAE9D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,6BAA6B,GAA+C;IACvF,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,sBAAsB;IAChE,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,8BAA8B;CACjF,CAAC;AAkBF,8DAA8D;AAE9D;;oEAEoE;AAEpE;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,yBAIX;AAJD,WAAY,yBAAyB;IACnC,wCAAW,CAAA;IACX,8CAAiB,CAAA;IACjB,0CAAa,CAAA;AACf,CAAC,EAJW,yBAAyB,KAAzB,yBAAyB,QAIpC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAA8D;IAC1G,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,sBAAsB,CAAC,QAAQ;IAChE,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,OAAO;IAClE,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC,MAAM;CAChE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAG7C;IACC,IAAI,MAAM,CAAC,eAAe;QAAE,OAAO,MAAM,CAAC,eAAe,CAAC;IAC1D,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,iCAAiC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC/F,OAAO,sBAAsB,CAAC,QAAQ,CAAC;AACzC,CAAC;AA4ED,8DAA8D;AAE9D;;oEAEoE","sourcesContent":["import { CelebrationDisplayMode } from '../notifications/notifications.shared.schemas';\nimport { CoreResourceOperation } from '../resources/resources.shared.core.definitions';\nimport { CoreResourceType } from '../resources/resources.shared.core.definitions';\nimport { LifecycleStage } from './lifecycle-state.shared.schemas';\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Type — Condition Evaluation Strategy\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * @wildo_source:part:start saas.models.milestone-definition facet:layer:shared facet:family:progression facet:audience:app-developer\n *\n * A milestone is a moment in a person's (or an organization's) use of the application that the\n * application wants to recognise: the first project created, the tenth todo completed. Declare them\n * in `shared-lib/src/engine/milestones.ts`; the framework counts the triggering operations, marks a\n * milestone achieved, awards its points and delivers its reward. Import from `@wildo-ai/saas-models`.\n */\nexport enum MilestoneType {\n  /** Achieved on first occurrence of the trigger operation */\n  FIRST_TIME = 'first_time',\n  /** Achieved when operation count reaches the threshold */\n  COUNT_THRESHOLD = 'count_threshold',\n  /** Achieved when a custom condition function returns true */\n  CUSTOM_CONDITION = 'custom_condition',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Reward Type\n * ────────────────────────────────────────────────────────────── */\n\nexport enum MilestoneRewardType {\n  /** Visual celebration (confetti, animation) via notification system */\n  CELEBRATION = 'celebration',\n  /** Unlock a feature by writing override to scope-matched features resource */\n  FEATURE_UNLOCK = 'feature_unlock',\n  /** Activate a guidance flow via WS push */\n  GUIDANCE_FLOW = 'guidance_flow',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Progression Scope — Bi-Scope State Routing\n * ────────────────────────────────────────────────────────────── */\n\nexport enum ProgressionScope {\n  /** State stored in USER_PROGRESSION_STATE — personal milestones (default) */\n  USER = 'user',\n  /** State stored in ORGANIZATION_PROGRESSION_STATE — org-wide milestones\n   *  (e.g., \"Team reached 50 members\", \"First integration configured\") */\n  ORGANIZATION = 'organization',\n}\n\n/** @wildo_source:part:end saas.models.milestone-definition */\n\n/** Maps ProgressionScope to the CoreResourceType that stores its state */\nexport const PROGRESSION_SCOPE_TO_RESOURCE: Record<ProgressionScope, CoreResourceType> = {\n  [ProgressionScope.USER]: CoreResourceType.USER_PROGRESSION_STATE,\n  [ProgressionScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_PROGRESSION_STATE,\n};\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Lifecycle Transition — Phase 5 Integration Point\n * ────────────────────────────────────────────────────────────── */\n\n/** @wildo_source:part:start saas.models.milestone-definition */\n/**\n * The lifecycle stage change a milestone triggers when it is achieved — for example moving a person\n * from `LifecycleStage.SIGNED_UP` to `LifecycleStage.ACTIVATED` when they create their first project.\n *\n * Use the `LifecycleStage` enum values, not their names. When the application's lifecycle config\n * declares no `activationCriteria`, a milestone transition is how activation happens at all.\n */\nexport interface MilestoneLifecycleTransition {\n  from: LifecycleStage;\n  to: LifecycleStage;\n}\n/** @wildo_source:part:end saas.models.milestone-definition */\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Reward Definition\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * @wildo_source:part:start saas.models.milestone-celebration facet:layer:shared facet:family:progression facet:audience:app-developer\n *\n * How much of a moment a milestone is — NOT how it is drawn.\n *\n * Presentation is a separate choice, `celebrationMode` (a `CelebrationDisplayMode`), so that a\n * milestone can be significant without having to accept a particular animation. Leave the mode out\n * and the level picks one through `DEFAULT_CELEBRATION_MODE_BY_LEVEL`.\n */\nexport enum MilestoneCelebrationLevel {\n  LOW = 'low',\n  MEDIUM = 'medium',\n  HIGH = 'high',\n}\n\n/**\n * The display mode each level gets when a milestone does not name one — the framework's default,\n * readable so an application knows what it is opting out of when it sets `celebrationMode`.\n */\nexport const DEFAULT_CELEBRATION_MODE_BY_LEVEL: Record<MilestoneCelebrationLevel, CelebrationDisplayMode> = {\n  [MilestoneCelebrationLevel.LOW]: CelebrationDisplayMode.CONFETTI,\n  [MilestoneCelebrationLevel.MEDIUM]: CelebrationDisplayMode.OVERLAY,\n  [MilestoneCelebrationLevel.HIGH]: CelebrationDisplayMode.LOTTIE,\n};\n\n/**\n * How a celebration is drawn, in order: the milestone's own `celebrationMode`; else the default for\n * its `celebrationLevel`; else `CONFETTI`, the quietest presentation, for a reward that says neither.\n */\nexport function resolveCelebrationDisplayMode(reward: {\n  readonly celebrationLevel?: MilestoneCelebrationLevel;\n  readonly celebrationMode?: CelebrationDisplayMode;\n}): CelebrationDisplayMode {\n  if (reward.celebrationMode) return reward.celebrationMode;\n  if (reward.celebrationLevel) return DEFAULT_CELEBRATION_MODE_BY_LEVEL[reward.celebrationLevel];\n  return CelebrationDisplayMode.CONFETTI;\n}\n/** @wildo_source:part:end saas.models.milestone-celebration */\n\n/** @wildo_source:part:start saas.models.milestone-definition */\n/**\n * What a person gets when the milestone is achieved. `type` picks which of the other fields apply:\n * `CELEBRATION` reads `celebrationLevel` / `celebrationMode`, `FEATURE_UNLOCK` reads `featureRef`,\n * `GUIDANCE_FLOW` reads `guidanceFlowRef`.\n */\nexport interface MilestoneReward {\n  type: MilestoneRewardType;\n  /** For FEATURE_UNLOCK: the feature identifier to enable */\n  featureRef?: string;\n  /** For GUIDANCE_FLOW: the guidance flow ref to activate */\n  guidanceFlowRef?: string;\n  /** For CELEBRATION: how big a moment this is. Presentation follows from it unless overridden. */\n  celebrationLevel?: MilestoneCelebrationLevel;\n  /**\n   * For CELEBRATION: draw it THIS way, whatever the level would have chosen.\n   *\n   * Makes the level a default rather than a verdict: a milestone that is significant but should\n   * still get confetti says so here. Omit it to get {@link DEFAULT_CELEBRATION_MODE_BY_LEVEL}.\n   */\n  celebrationMode?: CelebrationDisplayMode;\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Trigger — What Operation Triggers Evaluation\n * ────────────────────────────────────────────────────────────── */\n\nexport interface MilestoneTrigger {\n  /** Resource type that triggers evaluation */\n  resourceType: string;\n  /** Operation that triggers evaluation */\n  operation: CoreResourceOperation;\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Definition — Full Declaration\n * ────────────────────────────────────────────────────────────── */\n\nexport interface MilestoneDefinition {\n  /** Unique milestone identifier (e.g., 'FIRST_PROJECT_CREATED') */\n  identifier: string;\n  /** Milestone type — determines condition evaluation logic */\n  type: MilestoneType;\n  /** State scope — determines which resource stores this milestone's progress.\n   *  USER (default): personal milestones, each user has their own state.\n   *  ORGANIZATION: org-wide milestones, shared across all members. When any member\n   *    triggers \"org reached 50 members\", it's achieved for the whole org.\n   */\n  scope?: ProgressionScope;\n  /** What resource operation triggers this milestone's evaluation */\n  trigger: MilestoneTrigger;\n  /** For COUNT_THRESHOLD: the count that must be reached */\n  threshold?: number;\n  /** For CUSTOM_CONDITION: condition function reference key.\n   *  Receives (operationCounts, milestonesAchieved) and returns boolean.\n   *  Note: Serialized as a reference string for frontend — backend evaluates the function. */\n  conditionRef?: string;\n  /** What the user gets when milestone is achieved */\n  reward: MilestoneReward;\n  /** Category for grouping (e.g., 'getting-started', 'power-user') */\n  category: string;\n  /** Points awarded for this milestone (for gamification) */\n  points?: number;\n  /** i18n: which labels to generate */\n  labels?: {\n    description?: boolean;\n  };\n  /** Phase 5 integration: lifecycle stage transition triggered by this milestone */\n  lifecycleTransition?: MilestoneLifecycleTransition;\n  /** Dependencies: milestone refs that must be achieved first (for unlocking chains).\n   *  Dependencies are validated and evaluated within the same progression scope. */\n  dependencies?: string[];\n}\n/** @wildo_source:part:end saas.models.milestone-definition */\n\n/** ──────────────────────────────────────────────────────────────\n * Milestone Label Fields — i18n Key Generation Configuration\n * ────────────────────────────────────────────────────────────── */\n\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"progression-presentation.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/progression-presentation.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,yBAAyB;IACnC;;;;;;;OAOG;IACH,YAAY,iBAAiB;IAE7B;;;;;;OAMG;IACH,OAAO,YAAY;IAEnB;;;;;;;OAOG;IACH,IAAI,SAAS;IAEb;;;;;;;OAOG;IACH,QAAQ,aAAa;CACtB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,EAAE,yBAA6D,CAAC;AAChH,qEAAqE"}
+{"version":3,"file":"progression-presentation.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/progression-presentation.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,oBAAY,yBAAyB;IACnC;;;;;;;OAOG;IACH,YAAY,iBAAiB;IAE7B;;;;;;OAMG;IACH,OAAO,YAAY;IAEnB;;;;;;;OAOG;IACH,IAAI,SAAS;IAEb;;;;;;;OAOG;IACH,QAAQ,aAAa;CACtB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,EAAE,yBAA6D,CAAC;AAChH,qEAAqE"}

package/dist/esm/guidance/progression-presentation.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"progression-presentation.shared.schemas.js","sourceRoot":"","sources":["../../../src/guidance/progression-presentation.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAN,IAAY,yBAuCX;AAvCD,WAAY,yBAAyB;IACnC;;;;;;;OAOG;IACH,0DAA6B,CAAA;IAE7B;;;;;;OAMG;IACH,gDAAmB,CAAA;IAEnB;;;;;;;OAOG;IACH,0CAAa,CAAA;IAEb;;;;;;;OAOG;IACH,kDAAqB,CAAA;AACvB,CAAC,EAvCW,yBAAyB,KAAzB,yBAAyB,QAuCpC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA8B,yBAAyB,CAAC,OAAO,CAAC;AAChH,qEAAqE","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * Progression — Presentation Vocabulary\n *\n * How much of a person's progression a surface SHOWS. Distinct from\n * `progression-state.shared.schemas.ts`, which is what the product RECORDS, and from\n * `milestone-definition.shared.schemas.ts`, which is what an application DECLARES.\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * @wildo_source:part:start saas.models.progression-tracker-variant facet:layer:shared facet:family:progression facet:audience:app-developer\n *\n * How much progression one `ProgressionMilestoneTracker` mount shows — passed as its `variant` prop.\n * Import from `@wildo-ai/saas-models`.\n *\n * Chosen PER MOUNT, because surfaces of one application want different amounts: a home dashboard\n * wants a glance, an achievements screen wants the detail, a product still teaching its first task\n * wants only the next thing to do. Every variant reads the same progression state and the same\n * milestone definitions; they differ only in how much of it reaches the screen.\n *\n * These four are the common shapes, not a ceiling — but the tracker is composed by name, not\n * resolved through the component registry, so there is no preset to swap. An application needing a\n * shape none of them covers builds its own card from `useProgression()` (exported by\n * `@wildo-ai/saas-frontend-lib`), which gives the same milestone definitions, per-scope state and\n * points total the tracker renders from.\n */\nexport enum ProgressionTrackerVariant {\n  /**\n   * Overall progress and the milestones actually in reach — nothing else.\n   *\n   * No categories, no points, no per-milestone bars, and ACHIEVED milestones are not listed at all:\n   * the \"5 of 8\" line is the record of them. For a surface whose job is to get someone to the next\n   * action rather than to celebrate the last one. The smallest shape, and the right default for a\n   * product that is still teaching itself.\n   */\n  NEXT_ACTIONS = 'next_actions',\n\n  /**\n   * A glance: overall progress, the points total, and the single next milestone.\n   *\n   * For a dashboard card sitting beside other cards, where progression is one of several things\n   * competing for the same screen. Pairs with a `DETAILED` mount on a dedicated view — this is the\n   * summary that links to it.\n   */\n  SUMMARY = 'summary',\n\n  /**\n   * One list and ONE progress signal.\n   *\n   * Categories become plain section headings rather than separately measured units, so there is a\n   * single bar for the whole surface; a per-milestone count appears only where one is genuinely in\n   * flight. Every milestone is listed, achieved ones included, with achievement carried by ONE\n   * encoding rather than four.\n   */\n  FLAT = 'flat',\n\n  /**\n   * Categories measured in their own right, with the full per-milestone breakdown.\n   *\n   * The densest shape, for a screen whose whole subject is progression. It keeps the per-category\n   * bar and the per-milestone count that `FLAT` collapses, and gives them different visual weight so\n   * they stop competing — the defect in the original was never that both existed, it was that they\n   * were rendered identically and so read as one confused signal.\n   */\n  DETAILED = 'detailed',\n}\n\n/**\n * The shape used when a mount does not name one.\n *\n * `SUMMARY` rather than `DETAILED`, deliberately: the overwhelmingly common mount is a card on a\n * home surface, and the density that made the original hard to read is exactly what a card cannot\n * afford. An application that wants everything asks for it.\n */\nexport const DEFAULT_PROGRESSION_TRACKER_VARIANT: ProgressionTrackerVariant = ProgressionTrackerVariant.SUMMARY;\n/** @wildo_source:part:end saas.models.progression-tracker-variant */\n"]}
+{"version":3,"file":"progression-presentation.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/progression-presentation.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAN,IAAY,yBAuCX;AAvCD,WAAY,yBAAyB;IACnC;;;;;;;OAOG;IACH,0DAA6B,CAAA;IAE7B;;;;;;OAMG;IACH,gDAAmB,CAAA;IAEnB;;;;;;;OAOG;IACH,0CAAa,CAAA;IAEb;;;;;;;OAOG;IACH,kDAAqB,CAAA;AACvB,CAAC,EAvCW,yBAAyB,KAAzB,yBAAyB,QAuCpC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA8B,yBAAyB,CAAC,OAAO,CAAC;AAChH,qEAAqE","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * Progression — Presentation Vocabulary\n *\n * How much of a person's progression a surface SHOWS. Distinct from\n * `progression-state.shared.schemas.ts`, which is what the product RECORDS, and from\n * `milestone-definition.shared.schemas.ts`, which is what an application DECLARES.\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * @wildo_source:part:start saas.models.progression-tracker-variant facet:layer:shared facet:family:progression facet:audience:app-developer\n *\n * How much progression one `ProgressionMilestoneTracker` mount shows — passed as its `variant` prop.\n * Import from `@wildo-ai/saas-models`.\n *\n * Chosen PER MOUNT, because surfaces of one application want different amounts: a home dashboard\n * wants a glance, an achievements screen wants the detail, a product still teaching its first task\n * wants only the next thing to do. Every variant reads the same progression state and the same\n * milestone definitions; they differ only in how much of it reaches the screen.\n *\n * These four are the common shapes, not a ceiling — but the tracker is composed by name, not\n * resolved through the component registry, so there is no preset to swap. An application needing a\n * shape none of them covers builds its own card from `useProgression()` (exported by\n * `@wildo-ai/saas-frontend-lib`), which gives the same milestone definitions, per-scope state and\n * points total the tracker renders from.\n */\nexport enum ProgressionTrackerVariant {\n  /**\n   * Overall progress and the milestones actually in reach — nothing else.\n   *\n   * No categories, no points, no per-milestone bars, and ACHIEVED milestones are not listed at all:\n   * the \"5 of 8\" line is the record of them. For a surface whose job is to get someone to the next\n   * action rather than to celebrate the last one. The smallest shape, and the right default for a\n   * product that is still teaching itself.\n   */\n  NEXT_ACTIONS = 'next_actions',\n\n  /**\n   * A glance: overall progress, the points total, and the single next milestone.\n   *\n   * For a dashboard card sitting beside other cards, where progression is one of several things\n   * competing for the same screen. Pairs with a `DETAILED` mount on a dedicated view — this is the\n   * summary that links to it.\n   */\n  SUMMARY = 'summary',\n\n  /**\n   * One list and ONE progress signal.\n   *\n   * Categories become plain section headings rather than separately measured units, so there is a\n   * single bar for the whole surface; a per-milestone count appears only where one is genuinely in\n   * flight. Every milestone is listed, achieved ones included, with achievement carried by ONE\n   * encoding rather than four.\n   */\n  FLAT = 'flat',\n\n  /**\n   * Categories measured in their own right, with the full per-milestone breakdown.\n   *\n   * The densest shape, for a screen whose whole subject is progression. It keeps the per-category\n   * bar and the per-milestone count that `FLAT` collapses, and gives them different visual weight so\n   * they stop competing — the defect in the original was never that both existed, it was that they\n   * were rendered identically and so read as one confused signal.\n   */\n  DETAILED = 'detailed',\n}\n\n/**\n * The shape used when a mount does not name one.\n *\n * `SUMMARY` rather than `DETAILED`, deliberately: the overwhelmingly common mount is a card on a\n * home surface, and the density that made the original hard to read is exactly what a card cannot\n * afford. An application that wants everything asks for it.\n */\nexport const DEFAULT_PROGRESSION_TRACKER_VARIANT: ProgressionTrackerVariant = ProgressionTrackerVariant.SUMMARY;\n/** @wildo_source:part:end saas.models.progression-tracker-variant */\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"progression-state.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/progression-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,kCAAkC,GACnC,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,+DAA+D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;iCA2K5H,CAAC;AAIH,KAAK,0CAA0C,GAC3C,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,uEAAuE,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;iCAoGpI,CAAC"}
+{"version":3,"file":"progression-state.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/progression-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,kCAAkC,GACnC,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,+DAA+D,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;iCA2K5H,CAAC;AAIH,KAAK,0CAA0C,GAC3C,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,uEAAuE,GAAI,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;iCAoGpI,CAAC"}

package/dist/esm/guidance/progression-state.shared.resources-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"progression-state.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/guidance/progression-state.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Progression State Shared Resource Configurations\n *\n * Resource configurations for dual-scope progression state management (USER / ORGANIZATION).\n * Each scope stores milestone achievement progress, operation counts, and category progress.\n * The shared payload schema stays scope-agnostic, while the schema file also owns\n * the scope-aware persisted variants used by these resource configurations.\n */\n\nimport {\n  ProgressionStateSchema,\n  UserProgressionStateSchema,\n  OrganizationProgressionStateSchema,\n} from './progression-state.shared.schemas';\nimport { CoreResourceOperation } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourceRelationship } from '../resources/resources.shared.schemas';\nimport { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationVariantType } from '../resources/resources.shared.schemas';\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\nimport { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas';\nimport { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas';\nimport { ErasureRetentionMode, ResourceDataSubjectKind } from '../compliance/privacy/impersonalization.shared.schemas';\n\n// ─── USER PROGRESSION STATE ─────────────────────────────────────────────────────\n\ntype UserProgressionStateCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.DELETE\n  // Route-less; `retentionPolicy` requires READ + LIST + UPDATE_MANY.\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.UPDATE_MANY;\n\nexport const userProgressionStateResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  Record<string, never>,\n  UserProgressionStateCoreOperations,\n  typeof UserProgressionStateSchema\n>({\n  mainSchema: UserProgressionStateSchema,\n  resourceIdentifier: CoreResourceType.USER_PROGRESSION_STATE,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USER_PROGRESSION_STATE],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  // onParentCreate eager-seeding writes through createAsSystem → opt into the\n  // fail-closed system-write policy (composition-oncreate-lifecycle plan).\n  systemAccessPolicy: {\n    exportSubject: ResourceSystemAccessMode.ALLOWED, create: ResourceSystemAccessMode.ALLOWED },\n  portabilityPolicy: { defaultProvenance: DataPortabilityProvenance.DERIVED },\n\n  /**\n   * Subject erasure RETAINS this row and RESETS the achievement records, operation counters and points total to the schema's own defaults.\n   *\n   * The USAGE categories on this resource are accurate — these are observations the product made about a\n   * named person — so `RETAIN_ONLY` would be a false assertion and the factory refuses it. Until\n   * `RedactionType.RESET` existed no treatment could reach these fields at all: they are non-nullable WITH\n   * a `.default()`, so REMOVE (needs clearable) and MASK (needs a string) both refuse. RESET returns each\n   * to what it is when nobody has set it, which for a behavioural record is exactly what erasure should\n   * leave behind.\n   *\n   * The primary scope FK is preserved — severing it is refused outright, because it would leave the\n   * retained row with no tenant anchor, unreachable even to the audited see-through read.\n   */\n  retentionPolicy: {\n    mode: ErasureRetentionMode.RETAIN_AND_IMPERSONALIZE,\n  },\n\n  /**\n   * Erasing one of these rows revokes NO session. The row is state ABOUT a person rather than the person,\n *  and its primary scope FK anchors it — the enum prescribes `NO_PRINCIPAL` for that shape. The subject's\n *  own session ends through the `USERS` row.\n   */\n  dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.CREATE,\n    // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition\n    // onParentDelete cascade so the self-healing state row is physically removed\n    // when its owning scope is deleted. Without it the cascade throws\n    // ErrorType.CONFIGURATION on any scope that has a materialized row.\n    CoreResourceOperation.DELETE,\n    // Route-less; `retentionPolicy` requires READ + LIST + UPDATE_MANY (READ is above).\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.UPDATE_MANY,\n  ],\n\n  customOperation: {} as Record<string, never>,\n\n  operationsConfiguration: {\n\n    /*\n\n     * Route-less retention plumbing — INTERNAL_CALL registers no route and must not be REPOSITORY_ONLY:\n\n     * the retention primitives resolve through `getServiceOperationPathDefault`, which matches only\n\n     * INTERNAL_CALL / API_CALL. UPDATE_MANY is the verb the impersonalize writer uses.\n\n     */\n\n    [CoreResourceOperation.LIST]: {\n\n      variants: [{\n\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n\n        isDefault: true,\n\n        roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n\n        riskLevel: ResourceOperationRiskLevel.LOW,\n\n      }],\n\n    },\n\n    [CoreResourceOperation.UPDATE_MANY]: {\n\n      variants: [{\n\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n\n        isDefault: true,\n\n        roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n\n        riskLevel: ResourceOperationRiskLevel.CRITICAL,\n\n      }],\n\n    },\n\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_APP_ROLES.APP_USER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        isSearchable: false,\n        searchableFields: [],\n        searchableOptions: { caseSensitive: false, fullMatchOnly: false },\n        filterFields: {},\n        sortFields: [],\n        maxPaginatedResultPerPageLimit: 50,\n      }],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          // INTERNAL_CALL (not REPOSITORY_ONLY): the onParentCreate seed's\n          // `createAsSystem` resolves the CREATE op via the service tier, which\n          // rejects REPOSITORY_ONLY → OPERATION_PATH_NOT_FOUND, silent no-seed. See\n          // the org-preferences config + composition-oncreate plan for the rationale.\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition\n    // onParentDelete cascade so this self-healing state row is physically removed\n    // when its owning user is deleted. Without a DELETE op the cascade\n    // (deleteChildrenImmediate) throws ErrorType.CONFIGURATION on any user that\n    // has a materialized row — these rows self-heal on first READ, so most active\n    // users have one. Super-admin/HIGH: a privileged teardown, not the APP_USER\n    // self-write. See composition-oncreate-lifecycle plan (systemic DELETE gap).\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n        }\n      ],\n    },\n  },\n});\n\n// ─── ORGANIZATION PROGRESSION STATE ─────────────────────────────────────────────\n\ntype OrganizationProgressionStateCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.DELETE;\n\nexport const organizationProgressionStateResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  Record<string, never>,\n  OrganizationProgressionStateCoreOperations,\n  typeof OrganizationProgressionStateSchema\n>({\n  mainSchema: OrganizationProgressionStateSchema,\n  resourceIdentifier: CoreResourceType.ORGANIZATION_PROGRESSION_STATE,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATION_PROGRESSION_STATE],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  // onParentCreate eager-seeding writes through createAsSystem → opt into the\n  // fail-closed system-write policy (composition-oncreate-lifecycle plan).\n  systemAccessPolicy: { create: ResourceSystemAccessMode.ALLOWED },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.CREATE,\n    // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition\n    // onParentDelete cascade so the self-healing state row is physically removed\n    // when its owning scope is deleted. Without it the cascade throws\n    // ErrorType.CONFIGURATION on any scope that has a materialized row.\n    CoreResourceOperation.DELETE,\n  ],\n\n  customOperation: {} as Record<string, never>,\n\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_MEMBER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        isSearchable: false,\n        searchableFields: [],\n        searchableOptions: { caseSensitive: false, fullMatchOnly: false },\n        filterFields: {},\n        sortFields: [],\n        maxPaginatedResultPerPageLimit: 50,\n      }],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          // INTERNAL_CALL (not REPOSITORY_ONLY): the onParentCreate seed's\n          // `createAsSystem` resolves the CREATE op via the service tier, which\n          // rejects REPOSITORY_ONLY → OPERATION_PATH_NOT_FOUND, silent no-seed. See\n          // the org-preferences config + composition-oncreate plan for the rationale.\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition\n    // onParentDelete cascade so this self-healing state row is physically removed\n    // when its owning organization is deleted. Without a DELETE op the cascade\n    // (deleteChildrenImmediate) throws ErrorType.CONFIGURATION on any org that has\n    // a materialized row — these rows self-heal on first READ, so most active orgs\n    // have one. ORG_ADMIN/HIGH: the org-scope admin tier for a privileged teardown\n    // (org progression writes are ORG_MEMBER, but teardown is admin-gated).\n    // See composition-oncreate-lifecycle plan (systemic DELETE gap).\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n        }\n      ],\n    },\n  },\n});\n"]}
+{"version":3,"file":"progression-state.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/progression-state.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Progression State Shared Resource Configurations\n *\n * Resource configurations for dual-scope progression state management (USER / ORGANIZATION).\n * Each scope stores milestone achievement progress, operation counts, and category progress.\n * The shared payload schema stays scope-agnostic, while the schema file also owns\n * the scope-aware persisted variants used by these resource configurations.\n */\n\nimport {\n  ProgressionStateSchema,\n  UserProgressionStateSchema,\n  OrganizationProgressionStateSchema,\n} from './progression-state.shared.schemas';\nimport { CoreResourceOperation } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourceRelationship } from '../resources/resources.shared.schemas';\nimport { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport { ResourceOperationVariantType } from '../resources/resources.shared.schemas';\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\nimport { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas';\nimport { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas';\nimport { ErasureRetentionMode, ResourceDataSubjectKind } from '../compliance/privacy/impersonalization.shared.schemas';\n\n// ─── USER PROGRESSION STATE ─────────────────────────────────────────────────────\n\ntype UserProgressionStateCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.DELETE\n  // Route-less; `retentionPolicy` requires READ + LIST + UPDATE_MANY.\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.UPDATE_MANY;\n\nexport const userProgressionStateResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  Record<string, never>,\n  UserProgressionStateCoreOperations,\n  typeof UserProgressionStateSchema\n>({\n  mainSchema: UserProgressionStateSchema,\n  resourceIdentifier: CoreResourceType.USER_PROGRESSION_STATE,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USER_PROGRESSION_STATE],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  // onParentCreate eager-seeding writes through createAsSystem → opt into the\n  // fail-closed system-write policy (composition-oncreate-lifecycle plan).\n  systemAccessPolicy: {\n    exportSubject: ResourceSystemAccessMode.ALLOWED, create: ResourceSystemAccessMode.ALLOWED },\n  portabilityPolicy: { defaultProvenance: DataPortabilityProvenance.DERIVED },\n\n  /**\n   * Subject erasure RETAINS this row and RESETS the achievement records, operation counters and points total to the schema's own defaults.\n   *\n   * The USAGE categories on this resource are accurate — these are observations the product made about a\n   * named person — so `RETAIN_ONLY` would be a false assertion and the factory refuses it. Until\n   * `RedactionType.RESET` existed no treatment could reach these fields at all: they are non-nullable WITH\n   * a `.default()`, so REMOVE (needs clearable) and MASK (needs a string) both refuse. RESET returns each\n   * to what it is when nobody has set it, which for a behavioural record is exactly what erasure should\n   * leave behind.\n   *\n   * The primary scope FK is preserved — severing it is refused outright, because it would leave the\n   * retained row with no tenant anchor, unreachable even to the audited see-through read.\n   */\n  retentionPolicy: {\n    mode: ErasureRetentionMode.RETAIN_AND_IMPERSONALIZE,\n  },\n\n  /**\n   * Erasing one of these rows revokes NO session. The row is state ABOUT a person rather than the person,\n *  and its primary scope FK anchors it — the enum prescribes `NO_PRINCIPAL` for that shape. The subject's\n *  own session ends through the `USERS` row.\n   */\n  dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.CREATE,\n    // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition\n    // onParentDelete cascade so the self-healing state row is physically removed\n    // when its owning scope is deleted. Without it the cascade throws\n    // ErrorType.CONFIGURATION on any scope that has a materialized row.\n    CoreResourceOperation.DELETE,\n    // Route-less; `retentionPolicy` requires READ + LIST + UPDATE_MANY (READ is above).\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.UPDATE_MANY,\n  ],\n\n  customOperation: {} as Record<string, never>,\n\n  operationsConfiguration: {\n\n    /*\n\n     * Route-less retention plumbing — INTERNAL_CALL registers no route and must not be REPOSITORY_ONLY:\n\n     * the retention primitives resolve through `getServiceOperationPathDefault`, which matches only\n\n     * INTERNAL_CALL / API_CALL. UPDATE_MANY is the verb the impersonalize writer uses.\n\n     */\n\n    [CoreResourceOperation.LIST]: {\n\n      variants: [{\n\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n\n        isDefault: true,\n\n        roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n\n        riskLevel: ResourceOperationRiskLevel.LOW,\n\n      }],\n\n    },\n\n    [CoreResourceOperation.UPDATE_MANY]: {\n\n      variants: [{\n\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n\n        isDefault: true,\n\n        roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n\n        riskLevel: ResourceOperationRiskLevel.CRITICAL,\n\n      }],\n\n    },\n\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_APP_ROLES.APP_USER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        isSearchable: false,\n        searchableFields: [],\n        searchableOptions: { caseSensitive: false, fullMatchOnly: false },\n        filterFields: {},\n        sortFields: [],\n        maxPaginatedResultPerPageLimit: 50,\n      }],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          // INTERNAL_CALL (not REPOSITORY_ONLY): the onParentCreate seed's\n          // `createAsSystem` resolves the CREATE op via the service tier, which\n          // rejects REPOSITORY_ONLY → OPERATION_PATH_NOT_FOUND, silent no-seed. See\n          // the org-preferences config + composition-oncreate plan for the rationale.\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition\n    // onParentDelete cascade so this self-healing state row is physically removed\n    // when its owning user is deleted. Without a DELETE op the cascade\n    // (deleteChildrenImmediate) throws ErrorType.CONFIGURATION on any user that\n    // has a materialized row — these rows self-heal on first READ, so most active\n    // users have one. Super-admin/HIGH: a privileged teardown, not the APP_USER\n    // self-write. See composition-oncreate-lifecycle plan (systemic DELETE gap).\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n        }\n      ],\n    },\n  },\n});\n\n// ─── ORGANIZATION PROGRESSION STATE ─────────────────────────────────────────────\n\ntype OrganizationProgressionStateCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.DELETE;\n\nexport const organizationProgressionStateResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  Record<string, never>,\n  OrganizationProgressionStateCoreOperations,\n  typeof OrganizationProgressionStateSchema\n>({\n  mainSchema: OrganizationProgressionStateSchema,\n  resourceIdentifier: CoreResourceType.ORGANIZATION_PROGRESSION_STATE,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATION_PROGRESSION_STATE],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  // onParentCreate eager-seeding writes through createAsSystem → opt into the\n  // fail-closed system-write policy (composition-oncreate-lifecycle plan).\n  systemAccessPolicy: { create: ResourceSystemAccessMode.ALLOWED },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.UPDATE,\n    CoreResourceOperation.CREATE,\n    // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition\n    // onParentDelete cascade so the self-healing state row is physically removed\n    // when its owning scope is deleted. Without it the cascade throws\n    // ErrorType.CONFIGURATION on any scope that has a materialized row.\n    CoreResourceOperation.DELETE,\n  ],\n\n  customOperation: {} as Record<string, never>,\n\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_MEMBER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        isSearchable: false,\n        searchableFields: [],\n        searchableOptions: { caseSensitive: false, fullMatchOnly: false },\n        filterFields: {},\n        sortFields: [],\n        maxPaginatedResultPerPageLimit: 50,\n      }],\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          // INTERNAL_CALL (not REPOSITORY_ONLY): the onParentCreate seed's\n          // `createAsSystem` resolves the CREATE op via the service tier, which\n          // rejects REPOSITORY_ONLY → OPERATION_PATH_NOT_FOUND, silent no-seed. See\n          // the org-preferences config + composition-oncreate plan for the rationale.\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_MEMBER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ],\n    },\n\n    // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition\n    // onParentDelete cascade so this self-healing state row is physically removed\n    // when its owning organization is deleted. Without a DELETE op the cascade\n    // (deleteChildrenImmediate) throws ErrorType.CONFIGURATION on any org that has\n    // a materialized row — these rows self-heal on first READ, so most active orgs\n    // have one. ORG_ADMIN/HIGH: the org-scope admin tier for a privileged teardown\n    // (org progression writes are ORG_MEMBER, but teardown is admin-gated).\n    // See composition-oncreate-lifecycle plan (systemic DELETE gap).\n    [CoreResourceOperation.DELETE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.HIGH,\n        }\n      ],\n    },\n  },\n});\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"progression-state.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/progression-state.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;oEAEoE;AAEpE,+CAA+C;AAC/C,eAAO,MAAM,kCAAkC;;;iBAK7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;oEAEoE;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sBAAsB;;;;iBAejC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;oEAEoE;AAEpE,uCAAuC;AACvC,eAAO,MAAM,iCAAiC;;;iBAK5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;oEAEoE;AAEpE;;wDAEwD;AACxD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;iBA8CjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;iBAErC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;iBAE7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG,4BAA4B,CAAC"}
+{"version":3,"file":"progression-state.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/guidance/progression-state.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;oEAEoE;AAEpE,+CAA+C;AAC/C,eAAO,MAAM,kCAAkC;;;iBAK7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;oEAEoE;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sBAAsB;;;;iBAejC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;oEAEoE;AAEpE,uCAAuC;AACvC,eAAO,MAAM,iCAAiC;;;iBAK5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;oEAEoE;AAEpE;;wDAEwD;AACxD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;iBA8CjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;iBAErC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;iBAE7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG,4BAA4B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"progression-state.shared.schemas.js","sourceRoot":"","sources":["../../../src/guidance/progression-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 { RedactionType } from '../compliance/privacy/redaction.shared.schemas';\nimport { addImpersonalizeWith } from '@wildo-ai/zod-decorators';\n\n/** ──────────────────────────────────────────────────────────────\n * Progression State — Milestone Achievement Record\n * ────────────────────────────────────────────────────────────── */\n\n/** Record of a single milestone achievement */\nexport const ProgressionMilestoneAchievedSchema = z.object({\n  /** When the milestone was achieved */\n  achievedAt: z.coerce.date().describe('When the milestone was achieved.'),\n  /** How many times the triggering operation occurred (for COUNT_THRESHOLD context) */\n  count: z.number().int().default(0).describe('How many times the milestone\\'s triggering operation had been performed when the milestone was achieved.'),\n});\nexport type ProgressionMilestoneAchieved = z.infer<typeof ProgressionMilestoneAchievedSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Progression State — Value Moment Record\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * A value moment's state for one scope: what it has observed, and whether it fired.\n *\n * ## Why this lives on the progression state rather than in a resource of its own\n *\n * A value moment is an achievement keyed by an identifier, measured per USER or per ORGANIZATION,\n * derived from the same operation stream — the exact shape this row already holds for milestones,\n * with the same `PersonalDataCategory.USAGE` classification, the same erasure treatment, the same\n * subject-export provenance and the same `onParentCreate` / `onParentDelete` lifecycle. A second\n * resource would have re-declared every one of those obligations (#414).\n *\n * ## Why it is a SEPARATE FIELD from `milestonesAchieved`\n *\n * The two vocabularies are semantically distinct and their identifier spaces are independent: a\n * milestone is AUTHORED progression (dependencies, conditions, points, categories); a value moment\n * is a MEASURED behavioural moment (a `ValueMomentRole`, `ANY`/`ALL` composition over typed signals,\n * a cooldown, a suppressing `beforeStage`). Sharing one map would let a `milestoneRef` and a\n * `momentIdentifier` collide silently, and neither vocabulary constrains the other.\n *\n * ## What is NOT here, and why\n *\n * `ValueMomentRole.ANTI_PATTERN` is declared as NOT persisted — it re-fires on a cooldown rather than\n * being achieved once — so no anti-pattern ever writes a record here. Its cooldown is in-process; in\n * a multi-instance deployment each instance therefore keeps its own, which is what \"not persisted\"\n * means rather than a defect to fix here.\n */\nexport const ValueMomentStateSchema = z.object({\n  /**\n   * Signal keys observed so far, for `ValueMomentMode.ALL` composition. A moment in `ANY` mode fires\n   * on the first signal and never needs this, but it is recorded for both so a moment whose mode is\n   * changed after the fact does not silently lose the progress it already had.\n   */\n  signalsObserved: z.array(z.string()).default([]).describe('Signals observed so far. A signal that must occur several times is added once it reaches that count. The moment fires when any signal, or every signal, has been observed, depending on its mode.'),\n  /** Matching event occurrences per path-safe signal identity, accumulated per moment and scope.\n   * Optional for existing state rows; absent counts mean zero. Ordinary moment counters share the\n   * progression record's retention/erasure lifecycle. Anti-pattern counts remain instance-local.\n   */\n  signalOccurrenceCounts: z.record(z.string(), z.number().int().nonnegative()).optional()\n    .describe('Occurrences counted per signal, kept only for signals that must occur more than once before they count as observed. A missing count means zero.'),\n  /** When the moment fired. Absent while it is still accumulating signals. */\n  achievedAt: z.coerce.date().optional().describe('When the value moment fired. Absent while it is still collecting signals.'),\n});\nexport type ValueMomentState = z.infer<typeof ValueMomentStateSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Progression State — Per-Category Aggregated Progress\n * ────────────────────────────────────────────────────────────── */\n\n/** Per-category aggregated progress */\nexport const ProgressionCategoryProgressSchema = z.object({\n  /** Number of milestones completed in this category */\n  completedCount: z.number().int().default(0).describe('Number of milestones achieved in this category.'),\n  /** Total points earned in this category */\n  totalPoints: z.number().int().default(0).describe('Points earned from the milestones achieved in this category.'),\n});\nexport type ProgressionCategoryProgress = z.infer<typeof ProgressionCategoryProgressSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Progression State — Top-Level Document\n * ────────────────────────────────────────────────────────────── */\n\n/** Shared progression state payload body.\n *  Scope-specific state resources extend this schema with their owning FK\n *  (`userId` / `organizationId`) before persistence. */\nexport const ProgressionStateSchema = z.object({\n  /** Map of milestoneRef → achievement record. Populated when a milestone is achieved. */\n  // USAGE — a per-person record of what they accomplished and how often they acted.\n  // RESET on erasure — returns this field to its schema default. It holds what this person achieved and when,\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  milestonesAchieved: addImpersonalizeWith(\n  z.record(z.string(), ProgressionMilestoneAchievedSchema).default({})\n      .dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Map of `${resourceType}:${operation}` → count. Incremented on every matching operation.\n   *  This is the raw data used by COUNT_THRESHOLD conditions. */\n  // RESET on erasure — returns this field to its schema default. It holds how often they performed each operation,\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  operationCounts: addImpersonalizeWith(\n  z.record(z.string(), z.number().int()).default({}).dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Total points across all achieved milestones. Updated atomically with achievements. */\n  // RESET on erasure — returns this field to its schema default. It holds their points total,\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  totalPoints: addImpersonalizeWith(\n  z.number().int().default(0).isSummaryField().dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Map of momentIdentifier → value-moment state. See `ValueMomentStateSchema` for why it is\n   *  separate from `milestonesAchieved`. */\n  // USAGE — a per-person record of which product moments they reached and when.\n  // RESET on erasure — the same treatment as `milestonesAchieved` beside it, and for the same\n  // reasons: the USAGE category is accurate (these are observations the product made about a named\n  // person, so RETAIN_ONLY would be a false assertion), and the field is non-nullable WITH a\n  // `.default()`, so REMOVE needs a clearable field and MASK needs a string. RESET returns it to\n  // what it is when nobody has been observed, which is what erasure should leave behind.\n  valueMomentsAchieved: addImpersonalizeWith(\n    z.record(z.string(), ValueMomentStateSchema).default({})\n      .dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Per-category progress. Pre-aggregated for frontend display efficiency. */\n  categoriesProgress: z.record(z.string(), ProgressionCategoryProgressSchema).default({}),\n});\nexport type ProgressionState = z.infer<typeof ProgressionStateSchema>;\n\nexport const UserProgressionStateSchema = ProgressionStateSchema.extend({\n  userId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type UserProgressionState = z.infer<typeof UserProgressionStateSchema>;\n\nexport const OrganizationProgressionStateSchema = ProgressionStateSchema.extend({\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type OrganizationProgressionState = z.infer<typeof OrganizationProgressionStateSchema>;\n\nexport type PersistedProgressionState = UserProgressionState | OrganizationProgressionState;\n"]}
+{"version":3,"file":"progression-state.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/progression-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 { RedactionType } from '../compliance/privacy/redaction.shared.schemas';\nimport { addImpersonalizeWith } from '@wildo-ai/zod-decorators';\n\n/** ──────────────────────────────────────────────────────────────\n * Progression State — Milestone Achievement Record\n * ────────────────────────────────────────────────────────────── */\n\n/** Record of a single milestone achievement */\nexport const ProgressionMilestoneAchievedSchema = z.object({\n  /** When the milestone was achieved */\n  achievedAt: z.coerce.date().describe('When the milestone was achieved.'),\n  /** How many times the triggering operation occurred (for COUNT_THRESHOLD context) */\n  count: z.number().int().default(0).describe('How many times the milestone\\'s triggering operation had been performed when the milestone was achieved.'),\n});\nexport type ProgressionMilestoneAchieved = z.infer<typeof ProgressionMilestoneAchievedSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Progression State — Value Moment Record\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * A value moment's state for one scope: what it has observed, and whether it fired.\n *\n * ## Why this lives on the progression state rather than in a resource of its own\n *\n * A value moment is an achievement keyed by an identifier, measured per USER or per ORGANIZATION,\n * derived from the same operation stream — the exact shape this row already holds for milestones,\n * with the same `PersonalDataCategory.USAGE` classification, the same erasure treatment, the same\n * subject-export provenance and the same `onParentCreate` / `onParentDelete` lifecycle. A second\n * resource would have re-declared every one of those obligations (#414).\n *\n * ## Why it is a SEPARATE FIELD from `milestonesAchieved`\n *\n * The two vocabularies are semantically distinct and their identifier spaces are independent: a\n * milestone is AUTHORED progression (dependencies, conditions, points, categories); a value moment\n * is a MEASURED behavioural moment (a `ValueMomentRole`, `ANY`/`ALL` composition over typed signals,\n * a cooldown, a suppressing `beforeStage`). Sharing one map would let a `milestoneRef` and a\n * `momentIdentifier` collide silently, and neither vocabulary constrains the other.\n *\n * ## What is NOT here, and why\n *\n * `ValueMomentRole.ANTI_PATTERN` is declared as NOT persisted — it re-fires on a cooldown rather than\n * being achieved once — so no anti-pattern ever writes a record here. Its cooldown is in-process; in\n * a multi-instance deployment each instance therefore keeps its own, which is what \"not persisted\"\n * means rather than a defect to fix here.\n */\nexport const ValueMomentStateSchema = z.object({\n  /**\n   * Signal keys observed so far, for `ValueMomentMode.ALL` composition. A moment in `ANY` mode fires\n   * on the first signal and never needs this, but it is recorded for both so a moment whose mode is\n   * changed after the fact does not silently lose the progress it already had.\n   */\n  signalsObserved: z.array(z.string()).default([]).describe('Signals observed so far. A signal that must occur several times is added once it reaches that count. The moment fires when any signal, or every signal, has been observed, depending on its mode.'),\n  /** Matching event occurrences per path-safe signal identity, accumulated per moment and scope.\n   * Optional for existing state rows; absent counts mean zero. Ordinary moment counters share the\n   * progression record's retention/erasure lifecycle. Anti-pattern counts remain instance-local.\n   */\n  signalOccurrenceCounts: z.record(z.string(), z.number().int().nonnegative()).optional()\n    .describe('Occurrences counted per signal, kept only for signals that must occur more than once before they count as observed. A missing count means zero.'),\n  /** When the moment fired. Absent while it is still accumulating signals. */\n  achievedAt: z.coerce.date().optional().describe('When the value moment fired. Absent while it is still collecting signals.'),\n});\nexport type ValueMomentState = z.infer<typeof ValueMomentStateSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Progression State — Per-Category Aggregated Progress\n * ────────────────────────────────────────────────────────────── */\n\n/** Per-category aggregated progress */\nexport const ProgressionCategoryProgressSchema = z.object({\n  /** Number of milestones completed in this category */\n  completedCount: z.number().int().default(0).describe('Number of milestones achieved in this category.'),\n  /** Total points earned in this category */\n  totalPoints: z.number().int().default(0).describe('Points earned from the milestones achieved in this category.'),\n});\nexport type ProgressionCategoryProgress = z.infer<typeof ProgressionCategoryProgressSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Progression State — Top-Level Document\n * ────────────────────────────────────────────────────────────── */\n\n/** Shared progression state payload body.\n *  Scope-specific state resources extend this schema with their owning FK\n *  (`userId` / `organizationId`) before persistence. */\nexport const ProgressionStateSchema = z.object({\n  /** Map of milestoneRef → achievement record. Populated when a milestone is achieved. */\n  // USAGE — a per-person record of what they accomplished and how often they acted.\n  // RESET on erasure — returns this field to its schema default. It holds what this person achieved and when,\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  milestonesAchieved: addImpersonalizeWith(\n  z.record(z.string(), ProgressionMilestoneAchievedSchema).default({})\n      .dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Map of `${resourceType}:${operation}` → count. Incremented on every matching operation.\n   *  This is the raw data used by COUNT_THRESHOLD conditions. */\n  // RESET on erasure — returns this field to its schema default. It holds how often they performed each operation,\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  operationCounts: addImpersonalizeWith(\n  z.record(z.string(), z.number().int()).default({}).dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Total points across all achieved milestones. Updated atomically with achievements. */\n  // RESET on erasure — returns this field to its schema default. It holds their points total,\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  totalPoints: addImpersonalizeWith(\n  z.number().int().default(0).isSummaryField().dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Map of momentIdentifier → value-moment state. See `ValueMomentStateSchema` for why it is\n   *  separate from `milestonesAchieved`. */\n  // USAGE — a per-person record of which product moments they reached and when.\n  // RESET on erasure — the same treatment as `milestonesAchieved` beside it, and for the same\n  // reasons: the USAGE category is accurate (these are observations the product made about a named\n  // person, so RETAIN_ONLY would be a false assertion), and the field is non-nullable WITH a\n  // `.default()`, so REMOVE needs a clearable field and MASK needs a string. RESET returns it to\n  // what it is when nobody has been observed, which is what erasure should leave behind.\n  valueMomentsAchieved: addImpersonalizeWith(\n    z.record(z.string(), ValueMomentStateSchema).default({})\n      .dataCategories(PersonalDataCategory.USAGE),\n    RedactionType.RESET,\n  ),\n  /** Per-category progress. Pre-aggregated for frontend display efficiency. */\n  categoriesProgress: z.record(z.string(), ProgressionCategoryProgressSchema).default({}),\n});\nexport type ProgressionState = z.infer<typeof ProgressionStateSchema>;\n\nexport const UserProgressionStateSchema = ProgressionStateSchema.extend({\n  userId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type UserProgressionState = z.infer<typeof UserProgressionStateSchema>;\n\nexport const OrganizationProgressionStateSchema = ProgressionStateSchema.extend({\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type OrganizationProgressionState = z.infer<typeof OrganizationProgressionStateSchema>;\n\nexport type PersistedProgressionState = UserProgressionState | OrganizationProgressionState;\n"]}

package/dist/esm/http-api-binding/http-api-binding-id.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-api-binding-id.shared.utils.d.ts","sourceRoot":"","sources":["../../../src/http-api-binding/http-api-binding-id.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAmBH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,mCAAmC,CAAC;AAG3C;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAA6B,CAAC;AA6DzE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,OAAO,GAChB,wBAAwB,CA4C1B;AAaD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE;IAAE,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,EAClD,aAAa,EAAE,SAAS,OAAO,EAAE,GAChC,MAAM,CAqBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE;IAAE,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,EAClD,UAAU,EAAE,MAAM,GACjB,wBAAwB,EAAE,CAqC5B;AAED,yCAAyC;AACzC,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzE"}
+{"version":3,"file":"http-api-binding-id.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/http-api-binding/http-api-binding-id.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAmBH,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,mCAAmC,CAAC;AAG3C;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAA6B,CAAC;AA6DzE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,OAAO,GAChB,wBAAwB,CA4C1B;AAaD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE;IAAE,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,EAClD,aAAa,EAAE,SAAS,OAAO,EAAE,GAChC,MAAM,CAqBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE;IAAE,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,EAClD,UAAU,EAAE,MAAM,GACjB,wBAAwB,EAAE,CAqC5B;AAED,yCAAyC;AACzC,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzE"}

package/dist/esm/http-api-binding/http-api-binding-id.shared.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-api-binding-id.shared.utils.js","sourceRoot":"","sources":["../../../src/http-api-binding/http-api-binding-id.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HTTP-API resource-id synthesis — THE single authority for encoding/decoding the engine-facing\n * `_id` of an `HTTP_API`-backed resource from its remote key components.\n *\n * Contract (design paper `.claude/plans/etl-composite-key-synthesis.md`):\n * - **Deterministic + injective**: the same remote row yields the same `_id` on every machine,\n *   forever; two rows never collide (JSON array encoding preserves order and type).\n * - **Charset law**: every synthesized id matches `^[A-Za-z0-9._~-]+$` (URL-unreserved). This is\n *   what survives the two measured hazards: the frontend's unencoded `String.replace` URL\n *   substitution (forbids `/ ? # % $`) and colon-parsed websocket-room / Redis keys (forbids `:`).\n * - **Two static forms**, selected by the BINDING, never sniffed per row:\n *   verbatim (single key whose codec's whole value space is charset-safe — GUID, INTEGER) or\n *   encoded (base64url of the canonical JSON array of normalized components, no padding).\n * - **Decodable offline**: `_id` → key components needs no remote call.\n *\n * Errors are thrown as the typed {@link HttpApiResourceIdError} — this module is shared-tier (no\n * `ErrorBuilder` here; same precedent as `selectByPersistenceAdapter`). Backend callers classify\n * it by INSTANCE into a LOUD `VALIDATION` refusal — never a silent not-found (the Mongo\n * CastError-to-404 behavior is explicitly NOT mimicked).\n *\n * No `Buffer` here on purpose: this file must run in the browser bundle as well as Node, so\n * base64url is implemented over `TextEncoder`/`TextDecoder`.\n */\n\n/*\n * entrypoint-closure-waiver: this root-reachable module imports the external-data AUTHORING\n * contract, which only `@wildo-ai/saas-models/external-data` publishes (see\n * `external-data.exports.ts` for why that subpath exists).\n *\n * MEASURED SAFE 2026-08-29 by the probe `package-public-entrypoints.md` prescribes — a consumer\n * importing ONLY the package root, re-exporting these surfaces and deriving their parameter types\n * so declaration emit must WRITE them rather than alias them, compiled with `declaration: true`:\n * zero TS2742 / TS2883 / TS7056, and the emitted `.d.ts` names `@wildo-ai/saas-models` with no\n * `node_modules/...` path anywhere in it.\n *\n * The mechanism, so the next reader need not re-derive it: every crossing here is an EXPLICIT\n * ANNOTATION inside this package, so TypeScript emits a RELATIVE intra-package import in our own\n * `.d.ts` — which resolves by PATH for any consumer, whatever the exports map says. TS2742 bites\n * only when TypeScript must INVENT a specifier for an INFERRED type. Re-run the probe if a\n * root-exported contract here ever starts inferring one.\n */\nimport {\n  HttpApiKeyComponentCodec,\n  httpApiBindingUsesVerbatimKey,\n  type HttpApiKeyField,\n} from './http-api-binding.shared.schemas';\n\nimport { describeCaughtError } from '../errors/caught-error-description.shared.utils';\n/**\n * The typed refusal every codec failure throws — undecodable ids, non-canonical aliases, missing\n * or malformed key components. Typed (rather than message-matched) so the backend adapter can\n * classify it into a VALIDATION projection without regexing prose that a reword would silently\n * break.\n */\nexport class HttpApiResourceIdError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'HttpApiResourceIdError';\n  }\n}\n\n/** One normalized key component value as it participates in id synthesis. */\nexport type HttpApiKeyComponentValue = string | number;\n\n/**\n * The charset law for every synthesized HTTP-API resource id: URL-unreserved characters only.\n * See the module JSDoc for the two measured hazards this survives.\n */\nexport const HTTP_API_RESOURCE_ID_CHARSET: RegExp = /^[A-Za-z0-9._~-]+$/;\n\nconst GUID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;\n\n// --------------------------------\n// base64url (portable, unpadded)\n// --------------------------------\n\nconst B64URL_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';\n\nconst B64URL_REVERSE: ReadonlyMap<string, number> = new Map(\n  [...B64URL_ALPHABET].map((char, index) => [char, index]),\n);\n\nfunction bytesToBase64Url(bytes: Uint8Array): string {\n  let out = '';\n  for (let i = 0; i < bytes.length; i += 3) {\n    const b0 = bytes[i];\n    const b1 = i + 1 < bytes.length ? bytes[i + 1] : undefined;\n    const b2 = i + 2 < bytes.length ? bytes[i + 2] : undefined;\n    out += B64URL_ALPHABET[b0 >> 2];\n    out += B64URL_ALPHABET[((b0 & 0x03) << 4) | ((b1 ?? 0) >> 4)];\n    if (b1 !== undefined) {\n      out += B64URL_ALPHABET[((b1 & 0x0f) << 2) | ((b2 ?? 0) >> 6)];\n    }\n    if (b2 !== undefined) {\n      out += B64URL_ALPHABET[b2 & 0x3f];\n    }\n  }\n  return out;\n}\n\nfunction base64UrlToBytes(encoded: string): Uint8Array {\n  if (encoded.length % 4 === 1) {\n    throw new HttpApiResourceIdError(`Invalid base64url payload length in HTTP-API resource id (length ${encoded.length}).`);\n  }\n  const byteLength = Math.floor((encoded.length * 3) / 4);\n  const bytes = new Uint8Array(byteLength);\n  let byteIndex = 0;\n  let buffer = 0;\n  let bitsInBuffer = 0;\n  for (const char of encoded) {\n    const value = B64URL_REVERSE.get(char);\n    if (value === undefined) {\n      throw new HttpApiResourceIdError(`Invalid base64url character '${char}' in HTTP-API resource id.`);\n    }\n    buffer = (buffer << 6) | value;\n    bitsInBuffer += 6;\n    if (bitsInBuffer >= 8) {\n      bitsInBuffer -= 8;\n      bytes[byteIndex] = (buffer >> bitsInBuffer) & 0xff;\n      byteIndex += 1;\n    }\n  }\n  return bytes;\n}\n\n// --------------------------------\n// Component normalization per codec\n// --------------------------------\n\n/**\n * Normalize one raw remote key value per its declared codec. Normalization is what makes the\n * synthesis STABLE: the same remote row must produce byte-identical components regardless of the\n * remote system's incidental formatting (GUID casing, datetime precision).\n */\nexport function normalizeHttpApiKeyComponent(\n  keyField: HttpApiKeyField,\n  rawValue: unknown,\n): HttpApiKeyComponentValue {\n  switch (keyField.codec) {\n    case HttpApiKeyComponentCodec.STRING: {\n      if (typeof rawValue !== 'string' || rawValue.length === 0) {\n        throw new HttpApiResourceIdError(\n          `HTTP-API key component '${keyField.remoteField}' (codec STRING) must be a non-empty string, got ${describeValue(rawValue)}.`,\n        );\n      }\n      return rawValue;\n    }\n    case HttpApiKeyComponentCodec.INTEGER: {\n      const numeric = typeof rawValue === 'string' && /^-?\\d+$/.test(rawValue) ? Number(rawValue) : rawValue;\n      if (typeof numeric !== 'number' || !Number.isSafeInteger(numeric)) {\n        throw new HttpApiResourceIdError(\n          `HTTP-API key component '${keyField.remoteField}' (codec INTEGER) must be a safe integer, got ${describeValue(rawValue)}.`,\n        );\n      }\n      return numeric;\n    }\n    case HttpApiKeyComponentCodec.GUID: {\n      if (typeof rawValue !== 'string' || !GUID_PATTERN.test(rawValue)) {\n        throw new HttpApiResourceIdError(\n          `HTTP-API key component '${keyField.remoteField}' (codec GUID) must be a GUID string, got ${describeValue(rawValue)}.`,\n        );\n      }\n      // Lowercase so the same remote row synthesizes the same id regardless of the target's casing.\n      return rawValue.toLowerCase();\n    }\n    case HttpApiKeyComponentCodec.DATETIME_ISO: {\n      // Strict ISO 8601 shape gate BEFORE Date.parse: bare Date.parse accepts\n      // implementation-defined non-ISO formats, which would make the synthesized id differ\n      // across JS engines — the determinism the module contract promises would silently hold\n      // only for genuinely ISO inputs.\n      const isStrictIso = typeof rawValue === 'string'\n        && /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$/.test(rawValue);\n      const timestamp = isStrictIso ? Date.parse(rawValue as string) : Number.NaN;\n      if (Number.isNaN(timestamp)) {\n        throw new HttpApiResourceIdError(\n          `HTTP-API key component '${keyField.remoteField}' (codec DATETIME_ISO) must be an ISO 8601 datetime string with an explicit offset, got ${describeValue(rawValue)}.`,\n        );\n      }\n      return new Date(timestamp).toISOString();\n    }\n  }\n}\n\nfunction describeValue(value: unknown): string {\n  if (typeof value === 'string') {\n    return `'${value.length > 64 ? `${value.slice(0, 64)}…` : value}'`;\n  }\n  return `${typeof value} ${String(value)}`;\n}\n\n// --------------------------------\n// Encode / decode (the two id forms)\n// --------------------------------\n\n/**\n * Synthesize the engine-facing `_id` for one remote row, from its raw remote key values in\n * `keyFields` order. The form (verbatim vs encoded) is a static property of the binding\n * (`httpApiBindingUsesVerbatimKey`).\n */\nexport function synthesizeHttpApiResourceId(\n  binding: { keyFields: readonly HttpApiKeyField[] },\n  rawComponents: readonly unknown[],\n): string {\n  if (rawComponents.length !== binding.keyFields.length) {\n    throw new HttpApiResourceIdError(\n      `HTTP-API id synthesis received ${rawComponents.length} key component(s) for a binding declaring ${binding.keyFields.length}.`,\n    );\n  }\n  const normalized = binding.keyFields.map((keyField, index) =>\n    normalizeHttpApiKeyComponent(keyField, rawComponents[index]),\n  );\n\n  if (httpApiBindingUsesVerbatimKey(binding)) {\n    const verbatim = String(normalized[0]);\n    // Defensive: the codec gate should make this unreachable, but the charset law is the invariant\n    // every downstream consumer relies on, so it is asserted where the id is minted.\n    assertCharsetSafe(verbatim);\n    return verbatim;\n  }\n\n  const encoded = bytesToBase64Url(new TextEncoder().encode(JSON.stringify(normalized)));\n  assertCharsetSafe(encoded);\n  return encoded;\n}\n\n/**\n * Resolve an engine-facing `_id` back to its normalized key components, in `keyFields` order.\n * Purely local — no remote call. Throws on any id this binding could not have synthesized —\n * INCLUDING every non-canonical ALIAS of a valid id (base64url trailing-bit variants,\n * JSON-whitespace variants, non-normalized verbatim forms such as an uppercase GUID): one remote\n * row answers to exactly ONE engine id, because row identity, URL canonicality, dedup keys and\n * id-based exclusion filters are all built on that equality. Enforced by re-synthesizing from the\n * resolved components and requiring byte-equality with the incoming id.\n */\nexport function resolveHttpApiKeyComponents(\n  binding: { keyFields: readonly HttpApiKeyField[] },\n  resourceId: string,\n): HttpApiKeyComponentValue[] {\n  if (resourceId.length === 0) {\n    throw new HttpApiResourceIdError('HTTP-API resource id must be a non-empty string.');\n  }\n\n  let components: HttpApiKeyComponentValue[];\n  if (httpApiBindingUsesVerbatimKey(binding)) {\n    components = [normalizeHttpApiKeyComponent(binding.keyFields[0], resourceId)];\n  } else {\n    assertCharsetSafe(resourceId);\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(new TextDecoder().decode(base64UrlToBytes(resourceId)));\n    } catch (error) {\n      throw new HttpApiResourceIdError(\n        `HTTP-API resource id '${resourceId}' is not a valid encoded composite key: ${describeCaughtError(error)}`,\n      );\n    }\n    if (!Array.isArray(parsed) || parsed.length !== binding.keyFields.length) {\n      throw new HttpApiResourceIdError(\n        `HTTP-API resource id '${resourceId}' decodes to ${Array.isArray(parsed) ? `${parsed.length} component(s)` : 'a non-array'} for a binding declaring ${binding.keyFields.length}.`,\n      );\n    }\n    components = binding.keyFields.map((keyField, index) => normalizeHttpApiKeyComponent(keyField, parsed[index]));\n  }\n\n  // Canonicality gate: re-synthesize and require byte-equality. Normalization is idempotent per\n  // codec, so a canonical id always round-trips to itself; any alias (dropped-bit base64url\n  // variant, whitespace-bearing JSON, '042' for an INTEGER key, 'ABC…' for a GUID key) differs\n  // here and is refused rather than silently adopted as a second name for the same row.\n  const canonical = synthesizeHttpApiResourceId(binding, components);\n  if (canonical !== resourceId) {\n    throw new HttpApiResourceIdError(\n      `HTTP-API resource id ${describeValue(resourceId)} is a non-canonical alias of ${describeValue(canonical)} and is refused: every remote row has exactly one engine id.`,\n    );\n  }\n  return components;\n}\n\n/** Runtime guard for the charset law. */\nexport function isCharsetSafeHttpApiResourceId(candidate: string): boolean {\n  return HTTP_API_RESOURCE_ID_CHARSET.test(candidate);\n}\n\nfunction assertCharsetSafe(candidate: string): void {\n  if (!isCharsetSafeHttpApiResourceId(candidate)) {\n    throw new HttpApiResourceIdError(\n      `HTTP-API resource id violates the charset law ${HTTP_API_RESOURCE_ID_CHARSET}: ${describeValue(candidate)}. `\n      + 'Ids must stay URL-unreserved — the frontend substitutes them into URLs without encoding, and websocket room names parse on \\':\\'.',\n    );\n  }\n}\n"]}
+{"version":3,"file":"http-api-binding-id.shared.utils.js","sourceRoot":"","sources":["../../../../src/http-api-binding/http-api-binding-id.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HTTP-API resource-id synthesis — THE single authority for encoding/decoding the engine-facing\n * `_id` of an `HTTP_API`-backed resource from its remote key components.\n *\n * Contract (design paper `.claude/plans/etl-composite-key-synthesis.md`):\n * - **Deterministic + injective**: the same remote row yields the same `_id` on every machine,\n *   forever; two rows never collide (JSON array encoding preserves order and type).\n * - **Charset law**: every synthesized id matches `^[A-Za-z0-9._~-]+$` (URL-unreserved). This is\n *   what survives the two measured hazards: the frontend's unencoded `String.replace` URL\n *   substitution (forbids `/ ? # % $`) and colon-parsed websocket-room / Redis keys (forbids `:`).\n * - **Two static forms**, selected by the BINDING, never sniffed per row:\n *   verbatim (single key whose codec's whole value space is charset-safe — GUID, INTEGER) or\n *   encoded (base64url of the canonical JSON array of normalized components, no padding).\n * - **Decodable offline**: `_id` → key components needs no remote call.\n *\n * Errors are thrown as the typed {@link HttpApiResourceIdError} — this module is shared-tier (no\n * `ErrorBuilder` here; same precedent as `selectByPersistenceAdapter`). Backend callers classify\n * it by INSTANCE into a LOUD `VALIDATION` refusal — never a silent not-found (the Mongo\n * CastError-to-404 behavior is explicitly NOT mimicked).\n *\n * No `Buffer` here on purpose: this file must run in the browser bundle as well as Node, so\n * base64url is implemented over `TextEncoder`/`TextDecoder`.\n */\n\n/*\n * entrypoint-closure-waiver: this root-reachable module imports the external-data AUTHORING\n * contract, which only `@wildo-ai/saas-models/external-data` publishes (see\n * `external-data.exports.ts` for why that subpath exists).\n *\n * MEASURED SAFE 2026-08-29 by the probe `package-public-entrypoints.md` prescribes — a consumer\n * importing ONLY the package root, re-exporting these surfaces and deriving their parameter types\n * so declaration emit must WRITE them rather than alias them, compiled with `declaration: true`:\n * zero TS2742 / TS2883 / TS7056, and the emitted `.d.ts` names `@wildo-ai/saas-models` with no\n * `node_modules/...` path anywhere in it.\n *\n * The mechanism, so the next reader need not re-derive it: every crossing here is an EXPLICIT\n * ANNOTATION inside this package, so TypeScript emits a RELATIVE intra-package import in our own\n * `.d.ts` — which resolves by PATH for any consumer, whatever the exports map says. TS2742 bites\n * only when TypeScript must INVENT a specifier for an INFERRED type. Re-run the probe if a\n * root-exported contract here ever starts inferring one.\n */\nimport {\n  HttpApiKeyComponentCodec,\n  httpApiBindingUsesVerbatimKey,\n  type HttpApiKeyField,\n} from './http-api-binding.shared.schemas';\n\nimport { describeCaughtError } from '../errors/caught-error-description.shared.utils';\n/**\n * The typed refusal every codec failure throws — undecodable ids, non-canonical aliases, missing\n * or malformed key components. Typed (rather than message-matched) so the backend adapter can\n * classify it into a VALIDATION projection without regexing prose that a reword would silently\n * break.\n */\nexport class HttpApiResourceIdError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'HttpApiResourceIdError';\n  }\n}\n\n/** One normalized key component value as it participates in id synthesis. */\nexport type HttpApiKeyComponentValue = string | number;\n\n/**\n * The charset law for every synthesized HTTP-API resource id: URL-unreserved characters only.\n * See the module JSDoc for the two measured hazards this survives.\n */\nexport const HTTP_API_RESOURCE_ID_CHARSET: RegExp = /^[A-Za-z0-9._~-]+$/;\n\nconst GUID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;\n\n// --------------------------------\n// base64url (portable, unpadded)\n// --------------------------------\n\nconst B64URL_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';\n\nconst B64URL_REVERSE: ReadonlyMap<string, number> = new Map(\n  [...B64URL_ALPHABET].map((char, index) => [char, index]),\n);\n\nfunction bytesToBase64Url(bytes: Uint8Array): string {\n  let out = '';\n  for (let i = 0; i < bytes.length; i += 3) {\n    const b0 = bytes[i];\n    const b1 = i + 1 < bytes.length ? bytes[i + 1] : undefined;\n    const b2 = i + 2 < bytes.length ? bytes[i + 2] : undefined;\n    out += B64URL_ALPHABET[b0 >> 2];\n    out += B64URL_ALPHABET[((b0 & 0x03) << 4) | ((b1 ?? 0) >> 4)];\n    if (b1 !== undefined) {\n      out += B64URL_ALPHABET[((b1 & 0x0f) << 2) | ((b2 ?? 0) >> 6)];\n    }\n    if (b2 !== undefined) {\n      out += B64URL_ALPHABET[b2 & 0x3f];\n    }\n  }\n  return out;\n}\n\nfunction base64UrlToBytes(encoded: string): Uint8Array {\n  if (encoded.length % 4 === 1) {\n    throw new HttpApiResourceIdError(`Invalid base64url payload length in HTTP-API resource id (length ${encoded.length}).`);\n  }\n  const byteLength = Math.floor((encoded.length * 3) / 4);\n  const bytes = new Uint8Array(byteLength);\n  let byteIndex = 0;\n  let buffer = 0;\n  let bitsInBuffer = 0;\n  for (const char of encoded) {\n    const value = B64URL_REVERSE.get(char);\n    if (value === undefined) {\n      throw new HttpApiResourceIdError(`Invalid base64url character '${char}' in HTTP-API resource id.`);\n    }\n    buffer = (buffer << 6) | value;\n    bitsInBuffer += 6;\n    if (bitsInBuffer >= 8) {\n      bitsInBuffer -= 8;\n      bytes[byteIndex] = (buffer >> bitsInBuffer) & 0xff;\n      byteIndex += 1;\n    }\n  }\n  return bytes;\n}\n\n// --------------------------------\n// Component normalization per codec\n// --------------------------------\n\n/**\n * Normalize one raw remote key value per its declared codec. Normalization is what makes the\n * synthesis STABLE: the same remote row must produce byte-identical components regardless of the\n * remote system's incidental formatting (GUID casing, datetime precision).\n */\nexport function normalizeHttpApiKeyComponent(\n  keyField: HttpApiKeyField,\n  rawValue: unknown,\n): HttpApiKeyComponentValue {\n  switch (keyField.codec) {\n    case HttpApiKeyComponentCodec.STRING: {\n      if (typeof rawValue !== 'string' || rawValue.length === 0) {\n        throw new HttpApiResourceIdError(\n          `HTTP-API key component '${keyField.remoteField}' (codec STRING) must be a non-empty string, got ${describeValue(rawValue)}.`,\n        );\n      }\n      return rawValue;\n    }\n    case HttpApiKeyComponentCodec.INTEGER: {\n      const numeric = typeof rawValue === 'string' && /^-?\\d+$/.test(rawValue) ? Number(rawValue) : rawValue;\n      if (typeof numeric !== 'number' || !Number.isSafeInteger(numeric)) {\n        throw new HttpApiResourceIdError(\n          `HTTP-API key component '${keyField.remoteField}' (codec INTEGER) must be a safe integer, got ${describeValue(rawValue)}.`,\n        );\n      }\n      return numeric;\n    }\n    case HttpApiKeyComponentCodec.GUID: {\n      if (typeof rawValue !== 'string' || !GUID_PATTERN.test(rawValue)) {\n        throw new HttpApiResourceIdError(\n          `HTTP-API key component '${keyField.remoteField}' (codec GUID) must be a GUID string, got ${describeValue(rawValue)}.`,\n        );\n      }\n      // Lowercase so the same remote row synthesizes the same id regardless of the target's casing.\n      return rawValue.toLowerCase();\n    }\n    case HttpApiKeyComponentCodec.DATETIME_ISO: {\n      // Strict ISO 8601 shape gate BEFORE Date.parse: bare Date.parse accepts\n      // implementation-defined non-ISO formats, which would make the synthesized id differ\n      // across JS engines — the determinism the module contract promises would silently hold\n      // only for genuinely ISO inputs.\n      const isStrictIso = typeof rawValue === 'string'\n        && /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$/.test(rawValue);\n      const timestamp = isStrictIso ? Date.parse(rawValue as string) : Number.NaN;\n      if (Number.isNaN(timestamp)) {\n        throw new HttpApiResourceIdError(\n          `HTTP-API key component '${keyField.remoteField}' (codec DATETIME_ISO) must be an ISO 8601 datetime string with an explicit offset, got ${describeValue(rawValue)}.`,\n        );\n      }\n      return new Date(timestamp).toISOString();\n    }\n  }\n}\n\nfunction describeValue(value: unknown): string {\n  if (typeof value === 'string') {\n    return `'${value.length > 64 ? `${value.slice(0, 64)}…` : value}'`;\n  }\n  return `${typeof value} ${String(value)}`;\n}\n\n// --------------------------------\n// Encode / decode (the two id forms)\n// --------------------------------\n\n/**\n * Synthesize the engine-facing `_id` for one remote row, from its raw remote key values in\n * `keyFields` order. The form (verbatim vs encoded) is a static property of the binding\n * (`httpApiBindingUsesVerbatimKey`).\n */\nexport function synthesizeHttpApiResourceId(\n  binding: { keyFields: readonly HttpApiKeyField[] },\n  rawComponents: readonly unknown[],\n): string {\n  if (rawComponents.length !== binding.keyFields.length) {\n    throw new HttpApiResourceIdError(\n      `HTTP-API id synthesis received ${rawComponents.length} key component(s) for a binding declaring ${binding.keyFields.length}.`,\n    );\n  }\n  const normalized = binding.keyFields.map((keyField, index) =>\n    normalizeHttpApiKeyComponent(keyField, rawComponents[index]),\n  );\n\n  if (httpApiBindingUsesVerbatimKey(binding)) {\n    const verbatim = String(normalized[0]);\n    // Defensive: the codec gate should make this unreachable, but the charset law is the invariant\n    // every downstream consumer relies on, so it is asserted where the id is minted.\n    assertCharsetSafe(verbatim);\n    return verbatim;\n  }\n\n  const encoded = bytesToBase64Url(new TextEncoder().encode(JSON.stringify(normalized)));\n  assertCharsetSafe(encoded);\n  return encoded;\n}\n\n/**\n * Resolve an engine-facing `_id` back to its normalized key components, in `keyFields` order.\n * Purely local — no remote call. Throws on any id this binding could not have synthesized —\n * INCLUDING every non-canonical ALIAS of a valid id (base64url trailing-bit variants,\n * JSON-whitespace variants, non-normalized verbatim forms such as an uppercase GUID): one remote\n * row answers to exactly ONE engine id, because row identity, URL canonicality, dedup keys and\n * id-based exclusion filters are all built on that equality. Enforced by re-synthesizing from the\n * resolved components and requiring byte-equality with the incoming id.\n */\nexport function resolveHttpApiKeyComponents(\n  binding: { keyFields: readonly HttpApiKeyField[] },\n  resourceId: string,\n): HttpApiKeyComponentValue[] {\n  if (resourceId.length === 0) {\n    throw new HttpApiResourceIdError('HTTP-API resource id must be a non-empty string.');\n  }\n\n  let components: HttpApiKeyComponentValue[];\n  if (httpApiBindingUsesVerbatimKey(binding)) {\n    components = [normalizeHttpApiKeyComponent(binding.keyFields[0], resourceId)];\n  } else {\n    assertCharsetSafe(resourceId);\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(new TextDecoder().decode(base64UrlToBytes(resourceId)));\n    } catch (error) {\n      throw new HttpApiResourceIdError(\n        `HTTP-API resource id '${resourceId}' is not a valid encoded composite key: ${describeCaughtError(error)}`,\n      );\n    }\n    if (!Array.isArray(parsed) || parsed.length !== binding.keyFields.length) {\n      throw new HttpApiResourceIdError(\n        `HTTP-API resource id '${resourceId}' decodes to ${Array.isArray(parsed) ? `${parsed.length} component(s)` : 'a non-array'} for a binding declaring ${binding.keyFields.length}.`,\n      );\n    }\n    components = binding.keyFields.map((keyField, index) => normalizeHttpApiKeyComponent(keyField, parsed[index]));\n  }\n\n  // Canonicality gate: re-synthesize and require byte-equality. Normalization is idempotent per\n  // codec, so a canonical id always round-trips to itself; any alias (dropped-bit base64url\n  // variant, whitespace-bearing JSON, '042' for an INTEGER key, 'ABC…' for a GUID key) differs\n  // here and is refused rather than silently adopted as a second name for the same row.\n  const canonical = synthesizeHttpApiResourceId(binding, components);\n  if (canonical !== resourceId) {\n    throw new HttpApiResourceIdError(\n      `HTTP-API resource id ${describeValue(resourceId)} is a non-canonical alias of ${describeValue(canonical)} and is refused: every remote row has exactly one engine id.`,\n    );\n  }\n  return components;\n}\n\n/** Runtime guard for the charset law. */\nexport function isCharsetSafeHttpApiResourceId(candidate: string): boolean {\n  return HTTP_API_RESOURCE_ID_CHARSET.test(candidate);\n}\n\nfunction assertCharsetSafe(candidate: string): void {\n  if (!isCharsetSafeHttpApiResourceId(candidate)) {\n    throw new HttpApiResourceIdError(\n      `HTTP-API resource id violates the charset law ${HTTP_API_RESOURCE_ID_CHARSET}: ${describeValue(candidate)}. `\n      + 'Ids must stay URL-unreserved — the frontend substitutes them into URLs without encoding, and websocket room names parse on \\':\\'.',\n    );\n  }\n}\n"]}

package/dist/esm/http-api-binding/http-api-binding.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-api-binding.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/http-api-binding/http-api-binding.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,sBAAsB,EAGvB,MAAM,iDAAiD,CAAC;AAUzD,4GAA4G;AAkE5G;;;;;;;;GAQG;AACH,oBAAY,wBAAwB;IAClC,+FAA+F;IAC/F,MAAM,WAAW;IAEjB,kFAAkF;IAClF,OAAO,YAAY;IAEnB,2EAA2E;IAC3E,IAAI,SAAS;IAEb;;;;OAIG;IACH,YAAY,iBAAiB;CAC9B;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,oBAAY,gBAAgB;IAC1B,8FAA8F;IAC9F,MAAM,WAAW;IACjB,6FAA6F;IAC7F,MAAM,WAAW;IACjB,gGAAgG;IAChG,MAAM,WAAW;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,oBAAY,2BAA2B;IACrC;;;OAGG;IACH,eAAe,oBAAoB;IACnC;;;;;OAKG;IACH,gBAAgB,qBAAqB;CACtC;AACD,0DAA0D;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;iBAShC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE,4GAA4G;AAC5G;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,oBAAY,yBAAyB;IACnC,0EAA0E;IAC1E,IAAI,SAAS;IACb,gEAAgE;IAChE,SAAS,cAAc;CACxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;iBAKpC,CAAC;AACH,0DAA0D;AAE1D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E;;;;GAIG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;iBAgD3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAM1F;;;;;;;GAOG;AACH,oBAAY,0BAA0B;IACpC,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,4GAA4G;AAC5G;;GAEG;AACH,oBAAY,6BAA6B;IACvC;;;;OAIG;IACH,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AACH,oBAAY,6BAA6B;IACvC;;;;;;;;;OASG;IACH,IAAI,SAAS;IACb;;;;;;;;OAQG;IACH,OAAO,YAAY;CACpB;AAED;;;;;;GAMG;AACH,oBAAY,sBAAsB;IAChC;;;;;;;;;;;;OAYG;IACH,sBAAsB,2BAA2B;IACjD;;;;;;;;;;;OAWG;IACH,eAAe,oBAAoB;CACpC;AAED,kIAAkI;AAClI,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,6BAA6B,EAAE,sBAAsB,CAAC,CAG9G,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,wBAAwB,EAG9E,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,iCAAiC;IAC5C,2FAA2F;;kBAE3F,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;;QAZ1C,2FAA2F;;;iBAsC3F,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;YAzCzC,2FAA2F;;;;;;iBA+H3F,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,0DAA0D;AAoB1D;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;YA7JhD,2FAA2F;;;;;;iBA6JV,CAAC;AAEpF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,sHAAsH;AACtH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;gBAlKtC,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;gBAA3F,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;gBAA3F,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;gBAA3F,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgL3F,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAmBhF;;;;;;;GAOG;AACH,oBAAY,6BAA6B;IACvC,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,iCAAiC;;;;;;iBAc5C,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,qFAAqF;AACrF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;6BAwC1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AA4IxF,0DAA0D;AAE1D;;;;;;;;GAQG;AACH,4GAA4G;AAC5G,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAtCnC,8FAA8F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAA9F,8FAA8F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAtYlG,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;oBAA3F,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;oBAA3F,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;oBAA3F,2FAA2F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAsYvF,8FAA8F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAA9F,8FAA8F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAiFlG,CAAC;AAwFH;;;;GAIG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAmK1F;AAED,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAgB1F;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE;IAAE,SAAS,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,GACjD,OAAO,CAKT"}
+{"version":3,"file":"http-api-binding.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/http-api-binding/http-api-binding.shared.schemas.ts"],"names":[],"mappings":"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"}