@wildo-ai/saas-models 1.0.1 → 1.1.0

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

@@ -3,26 +3,40 @@
  *
  * Resource configurations for dual-scope guidance state management (USER / ORGANIZATION).
  * Each scope stores flow-level and element-level guidance progress.
- * Uses GuidanceStateSchema as mainSchema across both scopes.
+ * The shared payload schema stays scope-agnostic, while the schema file also owns
+ * the scope-aware persisted variants used by these resource configurations.
  */
-import { GuidanceStateSchema } from './guidance-state.shared.schemas.js';
+import { GuidanceStateSchema, UserGuidanceStateSchema, OrganizationGuidanceStateSchema, } from './guidance-state.shared.schemas.js';
 import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
 import { ResourceOperationRiskLevel } from '../resources/resources.shared.schemas.js';
 import { CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions.js';
 import { ResourceOperationVariantType } from '../resources/resources.shared.schemas.js';
 import { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory.js';
+import { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas.js';
 import { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas.js';
+import { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas.js';
 export const userGuidanceStateResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
-    mainSchema: GuidanceStateSchema,
+    mainSchema: UserGuidanceStateSchema,
     resourceIdentifier: CoreResourceType.USER_GUIDANCE_STATE,
     resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USER_GUIDANCE_STATE],
     resourceRelationships: resourcesRelationships,
     isSystemResource: true,
+    // onParentCreate eager-seeding writes through createAsSystem → opt into the
+    // fail-closed system-write policy (composition-oncreate-lifecycle plan).
+    systemAccessPolicy: {
+        exportSubject: ResourceSystemAccessMode.ALLOWED, create: ResourceSystemAccessMode.ALLOWED
+    },
+    portabilityPolicy: { defaultProvenance: DataPortabilityProvenance.OBSERVED },
     coreOperations: [
         CoreResourceOperation.READ,
         CoreResourceOperation.SEARCH,
         CoreResourceOperation.UPDATE,
         CoreResourceOperation.CREATE,
+        // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition
+        // onParentDelete cascade so the self-healing state row is physically removed
+        // when its owning scope is deleted. Without it the cascade throws
+        // ErrorType.CONFIGURATION on any scope that has a materialized row.
+        CoreResourceOperation.DELETE,
     ],
     customOperation: {},
     operationsConfiguration: {
@@ -72,19 +86,44 @@ export const userGuidanceStateResourceConfiguration_InitializationFactory = (res
                     maxPaginatedResultPerPageLimit: 50,
                 }],
         },
+        // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition
+        // onParentDelete cascade so this self-healing state row is physically removed
+        // when its owning user is deleted. Without a DELETE op the cascade
+        // (deleteChildrenImmediate) throws ErrorType.CONFIGURATION on any user that
+        // has a materialized row — these rows self-heal on first READ, so most active
+        // users have one. Super-admin/HIGH: a privileged teardown, not the APP_USER
+        // self-write. See composition-oncreate-lifecycle plan (systemic DELETE gap).
+        [CoreResourceOperation.DELETE]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                }
+            ],
+        },
     },
 });
 export const organizationGuidanceStateResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
-    mainSchema: GuidanceStateSchema,
+    mainSchema: OrganizationGuidanceStateSchema,
     resourceIdentifier: CoreResourceType.ORGANIZATION_GUIDANCE_STATE,
     resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATION_GUIDANCE_STATE],
     resourceRelationships: resourcesRelationships,
     isSystemResource: true,
+    // onParentCreate eager-seeding writes through createAsSystem → opt into the
+    // fail-closed system-write policy (composition-oncreate-lifecycle plan).
+    systemAccessPolicy: { create: ResourceSystemAccessMode.ALLOWED },
     coreOperations: [
         CoreResourceOperation.READ,
         CoreResourceOperation.SEARCH,
         CoreResourceOperation.UPDATE,
         CoreResourceOperation.CREATE,
+        // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition
+        // onParentDelete cascade so the self-healing state row is physically removed
+        // when its owning scope is deleted. Without it the cascade throws
+        // ErrorType.CONFIGURATION on any scope that has a materialized row.
+        CoreResourceOperation.DELETE,
     ],
     customOperation: {},
     operationsConfiguration: {
@@ -134,6 +173,23 @@ export const organizationGuidanceStateResourceConfiguration_InitializationFactor
                     maxPaginatedResultPerPageLimit: 50,
                 }],
         },
+        // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition
+        // onParentDelete cascade so this self-healing state row is physically removed
+        // when its owning organization is deleted. Without a DELETE op the cascade
+        // (deleteChildrenImmediate) throws ErrorType.CONFIGURATION on any org that has
+        // a materialized row — these rows self-heal on first READ, so most active orgs
+        // have one. ORG_ADMIN/HIGH: the org-scope admin tier for a privileged teardown.
+        // See composition-oncreate-lifecycle plan (systemic DELETE gap).
+        [CoreResourceOperation.DELETE]: {
+            variants: [
+                {
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_ADMIN],
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                }
+            ],
+        },
     },
 });
-//# sourceMappingURL=guidance-state.shared.resources-config.schemas.js.map
+//# sourceMappingURL=guidance-state.shared.resources-config.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"guidance-state.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/guidance/guidance-state.shared.resources-config.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guidance-state.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/guidance-state.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Guidance State Shared Resource Configurations\n *\n * Resource configurations for dual-scope guidance state management (USER / ORGANIZATION).\n * Each scope stores flow-level and element-level guidance 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  GuidanceStateSchema,\n  UserGuidanceStateSchema,\n  OrganizationGuidanceStateSchema,\n} from './guidance-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';\n\n// ─── USER GUIDANCE STATE ─────────────────────────────────────────────────────\n\ntype UserGuidanceStateCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.DELETE;\n\nexport const userGuidanceStateResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  Record<string, never>,\n  UserGuidanceStateCoreOperations,\n  typeof UserGuidanceStateSchema\n>({\n  mainSchema: UserGuidanceStateSchema,\n  resourceIdentifier: CoreResourceType.USER_GUIDANCE_STATE,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.USER_GUIDANCE_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.OBSERVED },\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_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }\n      ]\n    },\n\n    [CoreResourceOperation.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          requestDto: GuidanceStateSchema.partial(),\n        }\n      ],\n    },\n\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_USER],\n          riskLevel: ResourceOperationRiskLevel.LOW,\n          requestDto: GuidanceStateSchema,\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    // 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 GUIDANCE STATE ─────────────────────────────────────────────\n\ntype OrganizationGuidanceStateCoreOperations =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.DELETE;\n\nexport const organizationGuidanceStateResourceConfiguration_InitializationFactory = (resourcesRelationships: ResourceRelationship[]) => createResourceConfiguration_Initialization<\n  Record<string, never>,\n  OrganizationGuidanceStateCoreOperations,\n  typeof OrganizationGuidanceStateSchema\n>({\n  mainSchema: OrganizationGuidanceStateSchema,\n  resourceIdentifier: CoreResourceType.ORGANIZATION_GUIDANCE_STATE,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATION_GUIDANCE_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.UPDATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN, CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          requestDto: GuidanceStateSchema.partial(),\n        }\n      ],\n    },\n\n    [CoreResourceOperation.CREATE]: {\n      variants: [\n        {\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          roles: [CORE_ORG_ROLES.ORG_ADMIN, CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.MEDIUM,\n          requestDto: GuidanceStateSchema,\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    // 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    // 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/guidance-state.shared.schemas.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { OnboardingStatus } from '../config/frontend/onboarding.shared.schemas.js';
+import { OnboardingStatus } from '../config/frontend/onboarding.shared.schemas';
 /** ──────────────────────────────────────────────────────────────
  * Guidance State — Per-Element State
  * ────────────────────────────────────────────────────────────── */
@@ -9,7 +9,7 @@ export declare const GuidanceElementStateSchema: z.ZodObject<{
     completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     surveyAnswers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
     lastStepIndex: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type GuidanceElementState = z.infer<typeof GuidanceElementStateSchema>;
 /** ──────────────────────────────────────────────────────────────
  * Guidance State — Per-Flow State
@@ -25,17 +25,18 @@ export declare const GuidanceFlowStateSchema: z.ZodObject<{
         completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
         surveyAnswers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
         lastStepIndex: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip>>>;
     triggerCount: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type GuidanceFlowState = z.infer<typeof GuidanceFlowStateSchema>;
 /** ──────────────────────────────────────────────────────────────
  * Guidance State — Top-Level Document
  * ────────────────────────────────────────────────────────────── */
-/** Top-level guidance state document (stored as core resource).
- *  Used identically across scope resources (USER, ORGANIZATION). */
+/** Shared guidance state payload body.
+ *  Scope-specific state resources extend this schema with their owning FK
+ *  (`userId` / `organizationId`) before persistence. */
 export declare const GuidanceStateSchema: z.ZodObject<{
-    flows: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    flows: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         status: z.ZodEnum<typeof OnboardingStatus>;
         startedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
         completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
@@ -45,9 +46,44 @@ export declare const GuidanceStateSchema: z.ZodObject<{
             completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
             surveyAnswers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
             lastStepIndex: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
+        }, z.core.$strip>>>;
         triggerCount: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>>>>>;
+}, z.core.$strip>;
 export type GuidanceState = z.infer<typeof GuidanceStateSchema>;
+export declare const UserGuidanceStateSchema: z.ZodObject<{
+    flows: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<typeof OnboardingStatus>;
+        startedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        dismissedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        elements: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            status: z.ZodEnum<typeof OnboardingStatus>;
+            completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+            surveyAnswers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
+            lastStepIndex: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        triggerCount: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>>>;
+    userId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>>;
+}, z.core.$strip>;
+export type UserGuidanceState = z.infer<typeof UserGuidanceStateSchema>;
+export declare const OrganizationGuidanceStateSchema: z.ZodObject<{
+    flows: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodEnum<typeof OnboardingStatus>;
+        startedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        dismissedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        elements: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            status: z.ZodEnum<typeof OnboardingStatus>;
+            completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+            surveyAnswers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
+            lastStepIndex: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        triggerCount: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>>>;
+    organizationId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>>;
+}, z.core.$strip>;
+export type OrganizationGuidanceState = z.infer<typeof OrganizationGuidanceStateSchema>;
+export type PersistedGuidanceState = UserGuidanceState | OrganizationGuidanceState;
 //# sourceMappingURL=guidance-state.shared.schemas.d.ts.map

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

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

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas.js';
 import { OnboardingStatus } from '../config/frontend/onboarding.shared.schemas.js';
 /** ──────────────────────────────────────────────────────────────
  * Guidance State — Per-Element State
@@ -31,10 +32,20 @@ export const GuidanceFlowStateSchema = z.object({
 /** ──────────────────────────────────────────────────────────────
  * Guidance State — Top-Level Document
  * ────────────────────────────────────────────────────────────── */
-/** Top-level guidance state document (stored as core resource).
- *  Used identically across scope resources (USER, ORGANIZATION). */
+/** Shared guidance state payload body.
+ *  Scope-specific state resources extend this schema with their owning FK
+ *  (`userId` / `organizationId`) before persistence. */
 export const GuidanceStateSchema = z.object({
     /** Map of flowRef → flow state */
-    flows: z.record(z.string(), GuidanceFlowStateSchema).default({}).isSummaryField(),
+    // USAGE — which guidance flows this person has seen and how far through. A record of what they
+    // did in the product, held per user, so a notice must enumerate it.
+    flows: z.record(z.string(), GuidanceFlowStateSchema).default({}).isSummaryField()
+        .dataCategories(PersonalDataCategory.USAGE),
 });
-//# sourceMappingURL=guidance-state.shared.schemas.js.map
+export const UserGuidanceStateSchema = GuidanceStateSchema.extend({
+    userId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),
+});
+export const OrganizationGuidanceStateSchema = GuidanceStateSchema.extend({
+    organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),
+});
+//# sourceMappingURL=guidance-state.shared.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"guidance-state.shared.schemas.js","sourceRoot":"","sources":["../../../src/guidance/guidance-state.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAEhF;;oEAEoE;AAEpE,mCAAmC;AACnC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAChC;wGACoG;IACpG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,qCAAqC;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnH,2CAA2C;IAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAGH;;oEAEoE;AAEpE,qBAAqB;AACrB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtE,kDAAkD;IAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC1C,CAAC,CAAC;AAGH;;oEAEoE;AAEpE;oEACoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,kCAAkC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,cAAc,EAAE;CAClF,CAAC,CAAC"}
+{"version":3,"file":"guidance-state.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/guidance-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,8CAA8C,CAAC;AAEhF;;oEAEoE;AAEpE,mCAAmC;AACnC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAChC;wGACoG;IACpG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,qCAAqC;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnH,2CAA2C;IAC3C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAGH;;oEAEoE;AAEpE,qBAAqB;AACrB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtE,kDAAkD;IAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC1C,CAAC,CAAC;AAGH;;oEAEoE;AAEpE;;wDAEwD;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,kCAAkC;IAClC,+FAA+F;IAC/F,oEAAoE;IACpE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,cAAc,EAAE;SAC9E,cAAc,CAAC,oBAAoB,CAAC,KAAK,CAAC;CAC9C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAChE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;CAC5F,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,+BAA+B,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACxE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE;CACpG,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport { OnboardingStatus } from '../config/frontend/onboarding.shared.schemas';\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance State — Per-Element State\n * ────────────────────────────────────────────────────────────── */\n\n/** Per-element completion state */\nexport const GuidanceElementStateSchema = z.object({\n  status: z.enum(OnboardingStatus),\n  /** Timestamp when this element was completed.\n   *  Uses z.coerce.date() to handle string → Date coercion on parse (stored as ISO strings in DB). */\n  completedAt: z.coerce.date().optional(),\n  /** For surveys: submitted answers */\n  surveyAnswers: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.array(z.string())])).optional(),\n  /** For tours: last completed step index */\n  lastStepIndex: z.number().int().optional(),\n});\nexport type GuidanceElementState = z.infer<typeof GuidanceElementStateSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance State — Per-Flow State\n * ────────────────────────────────────────────────────────────── */\n\n/** Per-flow state */\nexport const GuidanceFlowStateSchema = z.object({\n  status: z.enum(OnboardingStatus),\n  startedAt: z.coerce.date().optional(),\n  completedAt: z.coerce.date().optional(),\n  dismissedAt: z.coerce.date().optional(),\n  /** Element-level state keyed by element ref */\n  elements: z.record(z.string(), GuidanceElementStateSchema).default({}),\n  /** How many times this flow has been triggered */\n  triggerCount: z.number().int().default(0),\n});\nexport type GuidanceFlowState = z.infer<typeof GuidanceFlowStateSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Guidance State — Top-Level Document\n * ────────────────────────────────────────────────────────────── */\n\n/** Shared guidance state payload body.\n *  Scope-specific state resources extend this schema with their owning FK\n *  (`userId` / `organizationId`) before persistence. */\nexport const GuidanceStateSchema = z.object({\n  /** Map of flowRef → flow state */\n  // USAGE — which guidance flows this person has seen and how far through. A record of what they\n  // did in the product, held per user, so a notice must enumerate it.\n  flows: z.record(z.string(), GuidanceFlowStateSchema).default({}).isSummaryField()\n    .dataCategories(PersonalDataCategory.USAGE),\n});\nexport type GuidanceState = z.infer<typeof GuidanceStateSchema>;\n\nexport const UserGuidanceStateSchema = GuidanceStateSchema.extend({\n  userId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type UserGuidanceState = z.infer<typeof UserGuidanceStateSchema>;\n\nexport const OrganizationGuidanceStateSchema = GuidanceStateSchema.extend({\n  organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),\n});\nexport type OrganizationGuidanceState = z.infer<typeof OrganizationGuidanceStateSchema>;\n\nexport type PersistedGuidanceState = UserGuidanceState | OrganizationGuidanceState;\n"]}

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

@@ -0,0 +1,25 @@
+import type { GuidanceState, PersistedGuidanceState } from './guidance-state.shared.schemas';
+import { type LifecycleState, type PersistedLifecycleState } from './lifecycle-state.shared.schemas';
+import type { PersistedProgressionState, ProgressionState } from './progression-state.shared.schemas';
+export declare class GuidanceStateUtils {
+    private constructor();
+    static createInitialGuidanceState(): GuidanceState;
+    static createScopedGuidanceState(scopeOwner: {
+        userId: string;
+    } | {
+        organizationId: string;
+    }): PersistedGuidanceState;
+    static createInitialProgressionState(): ProgressionState;
+    static createScopedProgressionState(scopeOwner: {
+        userId: string;
+    } | {
+        organizationId: string;
+    }): PersistedProgressionState;
+    static createInitialLifecycleState(now?: Date): LifecycleState;
+    static createInitialScopedLifecycleState(scopeOwner: {
+        userId: string;
+    } | {
+        organizationId: string;
+    }, now?: Date): PersistedLifecycleState;
+}
+//# sourceMappingURL=guidance-state.shared.utils.d.ts.map

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

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

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

@@ -0,0 +1,72 @@
+import { LifecycleStage, } from './lifecycle-state.shared.schemas.js';
+export class GuidanceStateUtils {
+    constructor() { }
+    static createInitialGuidanceState() {
+        return {
+            flows: {},
+        };
+    }
+    static createScopedGuidanceState(scopeOwner) {
+        const initialState = GuidanceStateUtils.createInitialGuidanceState();
+        if ('userId' in scopeOwner) {
+            return {
+                ...initialState,
+                userId: scopeOwner.userId,
+            };
+        }
+        return {
+            ...initialState,
+            organizationId: scopeOwner.organizationId,
+        };
+    }
+    static createInitialProgressionState() {
+        return {
+            milestonesAchieved: {},
+            operationCounts: {},
+            totalPoints: 0,
+            categoriesProgress: {},
+        };
+    }
+    static createScopedProgressionState(scopeOwner) {
+        const initialState = GuidanceStateUtils.createInitialProgressionState();
+        if ('userId' in scopeOwner) {
+            return {
+                ...initialState,
+                userId: scopeOwner.userId,
+            };
+        }
+        return {
+            ...initialState,
+            organizationId: scopeOwner.organizationId,
+        };
+    }
+    static createInitialLifecycleState(now = new Date()) {
+        return {
+            currentStage: LifecycleStage.SIGNED_UP,
+            stageEnteredAt: now,
+            stageHistory: [{
+                    stage: LifecycleStage.SIGNED_UP,
+                    enteredAt: now,
+                    trigger: 'auto_create',
+                }],
+            stagesVisited: [LifecycleStage.SIGNED_UP],
+            lastActiveAt: now,
+            activationCriteriaMet: {},
+            engagement: { operationsSinceActivation: 0, activeDates: [] },
+        };
+    }
+    static createInitialScopedLifecycleState(scopeOwner, now = new Date()) {
+        const initialState = GuidanceStateUtils.createInitialLifecycleState(now);
+        if ('userId' in scopeOwner) {
+            return {
+                ...initialState,
+                userId: scopeOwner.userId,
+            };
+        }
+        return {
+            ...initialState,
+            organizationId: scopeOwner.organizationId,
+        };
+    }
+}
+//# sourceMappingURL=guidance-state.shared.utils.js.map

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

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

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

@@ -15,10 +15,10 @@ export declare enum ActivationCriterionType {
 export declare const ActivationCriterionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     criterionType: z.ZodLiteral<ActivationCriterionType.MILESTONE>;
     milestoneRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     criterionType: z.ZodLiteral<ActivationCriterionType.GUIDANCE_COMPLETED>;
     guidanceFlowRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "criterionType">;
+}, z.core.$strip>], "criterionType">;
 export type ActivationCriterion = z.infer<typeof ActivationCriterionSchema>;
 /** ──────────────────────────────────────────────────────────────
  * Activation Criteria — Compound Evaluation
@@ -31,11 +31,11 @@ export declare const ActivationCriteriaSchema: z.ZodObject<{
     criteria: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         criterionType: z.ZodLiteral<ActivationCriterionType.MILESTONE>;
         milestoneRef: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         criterionType: z.ZodLiteral<ActivationCriterionType.GUIDANCE_COMPLETED>;
         guidanceFlowRef: z.ZodString;
-    }, z.core.$strip, core.$ZodObjectExtra>], "criterionType">>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>], "criterionType">>;
+}, z.core.$strip>;
 export type ActivationCriteria = z.infer<typeof ActivationCriteriaSchema>;
 /** ──────────────────────────────────────────────────────────────
  * Engagement Threshold — ACTIVATED → ENGAGED Transition
@@ -43,7 +43,7 @@ export type ActivationCriteria = z.infer<typeof ActivationCriteriaSchema>;
 export declare const EngagementThresholdSchema: z.ZodObject<{
     minOperations: z.ZodDefault<z.ZodNumber>;
     withinDays: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type EngagementThreshold = z.infer<typeof EngagementThresholdSchema>;
 /** ──────────────────────────────────────────────────────────────
  * Lifecycle Configuration — AppConfiguration_Shared.lifecycle
@@ -58,19 +58,19 @@ export declare const LifecycleConfigSchema: z.ZodObject<{
         criteria: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             criterionType: z.ZodLiteral<ActivationCriterionType.MILESTONE>;
             milestoneRef: z.ZodString;
-        }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        }, z.core.$strip>, z.ZodObject<{
             criterionType: z.ZodLiteral<ActivationCriterionType.GUIDANCE_COMPLETED>;
             guidanceFlowRef: z.ZodString;
-        }, z.core.$strip, core.$ZodObjectExtra>], "criterionType">>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip>], "criterionType">>;
+    }, z.core.$strip>>;
     engagementThreshold: z.ZodOptional<z.ZodObject<{
         minOperations: z.ZodDefault<z.ZodNumber>;
         withinDays: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     dormancyThresholdDays: z.ZodDefault<z.ZodNumber>;
     activityDebounceMinutes: z.ZodDefault<z.ZodNumber>;
     dormancyCronSchedule: z.ZodDefault<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type LifecycleConfig = z.infer<typeof LifecycleConfigSchema>;
 /** ──────────────────────────────────────────────────────────────
  * Lifecycle Label Fields — i18n Key Generation Configuration

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

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

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

@@ -77,4 +77,4 @@ export const LIFECYCLE_LABEL_FIELDS = {
     home_welcome_back: ['title', 'message'],
     home_dashboard: ['title', 'description'],
 };
-//# sourceMappingURL=lifecycle-config.shared.schemas.js.map
+//# sourceMappingURL=lifecycle-config.shared.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-config.shared.schemas.js","sourceRoot":"","sources":["../../../src/guidance/lifecycle-config.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;oEAEoE;AAEpE,iCAAiC;AACjC,MAAM,CAAN,IAAY,uBAKX;AALD,WAAY,uBAAuB;IACjC,4CAA4C;IAC5C,kDAAuB,CAAA;IACvB,wCAAwC;IACxC,oEAAyC,CAAA;AAC3C,CAAC,EALW,uBAAuB,KAAvB,uBAAuB,QAKlC;AAED;;oEAEoE;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,kBAAkB,CAAC,eAAe,EAAE;IAC7E,CAAC,CAAC,MAAM,CAAC;QACP,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC;QAC3D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAChC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,kBAAkB,CAAC;QACpE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACnC,CAAC;CACH,CAAC,CAAC;AAGH;;oEAEoE;AAEpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,mFAAmF;IACnF,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3C,mCAAmC;IACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACpD,CAAC,CAAC;AAGH;;oEAEoE;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,yDAAyD;IACzD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACtD,sFAAsF;IACtF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CACnD,CAAC,CAAC;AAGH;;oEAEoE;AAEpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,yEAAyE;IACzE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC;uFACmF;IACnF,kBAAkB,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IACvD;uEACmE;IACnE,mBAAmB,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IACzD;4BACwB;IACxB,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9D;6EACyE;IACzE,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChE;kCAC8B;IAC9B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;CACxD,CAAC,CAAC;AAGH;;oEAEoE;AAEpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;IAC/B,wBAAwB,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;IAClD,iBAAiB,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;IACvC,cAAc,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;CAChC,CAAC"}
+{"version":3,"file":"lifecycle-config.shared.schemas.js","sourceRoot":"","sources":["../../../../src/guidance/lifecycle-config.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;oEAEoE;AAEpE,iCAAiC;AACjC,MAAM,CAAN,IAAY,uBAKX;AALD,WAAY,uBAAuB;IACjC,4CAA4C;IAC5C,kDAAuB,CAAA;IACvB,wCAAwC;IACxC,oEAAyC,CAAA;AAC3C,CAAC,EALW,uBAAuB,KAAvB,uBAAuB,QAKlC;AAED;;oEAEoE;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,kBAAkB,CAAC,eAAe,EAAE;IAC7E,CAAC,CAAC,MAAM,CAAC;QACP,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC;QAC3D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAChC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,kBAAkB,CAAC;QACpE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACnC,CAAC;CACH,CAAC,CAAC;AAGH;;oEAEoE;AAEpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,mFAAmF;IACnF,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3C,mCAAmC;IACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACpD,CAAC,CAAC;AAGH;;oEAEoE;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,yDAAyD;IACzD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACtD,sFAAsF;IACtF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CACnD,CAAC,CAAC;AAGH;;oEAEoE;AAEpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,yEAAyE;IACzE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC;uFACmF;IACnF,kBAAkB,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IACvD;uEACmE;IACnE,mBAAmB,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IACzD;4BACwB;IACxB,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9D;6EACyE;IACzE,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChE;kCAC8B;IAC9B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;CACxD,CAAC,CAAC;AAGH;;oEAEoE;AAEpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;IAC/B,wBAAwB,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;IAClD,iBAAiB,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;IACvC,cAAc,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;CAChC,CAAC","sourcesContent":["import { z } from 'zod';\n\n/** ──────────────────────────────────────────────────────────────\n * Activation Criterion Types\n * ────────────────────────────────────────────────────────────── */\n\n/** Activation criterion types */\nexport enum ActivationCriterionType {\n  /** A specific milestone must be achieved */\n  MILESTONE = 'milestone',\n  /** A guidance flow must be completed */\n  GUIDANCE_COMPLETED = 'guidance_completed',\n}\n\n/** ──────────────────────────────────────────────────────────────\n * Activation Criterion Schemas — Discriminated Union\n * ────────────────────────────────────────────────────────────── */\n\nexport const ActivationCriterionSchema = z.discriminatedUnion('criterionType', [\n  z.object({\n    criterionType: z.literal(ActivationCriterionType.MILESTONE),\n    milestoneRef: z.string().min(1),\n  }),\n  z.object({\n    criterionType: z.literal(ActivationCriterionType.GUIDANCE_COMPLETED),\n    guidanceFlowRef: z.string().min(1),\n  }),\n]);\nexport type ActivationCriterion = z.infer<typeof ActivationCriterionSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Activation Criteria — Compound Evaluation\n * ────────────────────────────────────────────────────────────── */\n\nexport const ActivationCriteriaSchema = z.object({\n  /** ANY = at least one criterion must be met. ALL = every criterion must be met. */\n  mode: z.enum(['ANY', 'ALL']).default('ANY'),\n  /** List of criteria to evaluate */\n  criteria: z.array(ActivationCriterionSchema).min(1),\n});\nexport type ActivationCriteria = z.infer<typeof ActivationCriteriaSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Engagement Threshold — ACTIVATED → ENGAGED Transition\n * ────────────────────────────────────────────────────────────── */\n\nexport const EngagementThresholdSchema = z.object({\n  /** Minimum operations needed to be considered engaged */\n  minOperations: z.number().int().positive().default(10),\n  /** Time window in days — operations must occur within this window after activation */\n  withinDays: z.number().int().positive().default(7),\n});\nexport type EngagementThreshold = z.infer<typeof EngagementThresholdSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Lifecycle Configuration — AppConfiguration_Shared.lifecycle\n * ────────────────────────────────────────────────────────────── */\n\nexport const LifecycleConfigSchema = z.object({\n  /** Master switch — lifecycle system is completely disabled when false */\n  enabled: z.boolean().default(false),\n  /** Activation criteria — what must be achieved for SIGNED_UP → ACTIVATED.\n   *  If omitted, activation only happens via milestone lifecycleTransition field. */\n  activationCriteria: ActivationCriteriaSchema.optional(),\n  /** Engagement threshold — when to transition ACTIVATED → ENGAGED.\n   *  If omitted, ENGAGED stage is skipped (users stay ACTIVATED). */\n  engagementThreshold: EngagementThresholdSchema.optional(),\n  /** Days of inactivity before ACTIVATED/ENGAGED/REACTIVATED → DORMANT.\n   *  Default: 14 days. */\n  dormancyThresholdDays: z.number().int().positive().default(14),\n  /** Debounce interval for lastActiveAt writes (in minutes).\n   *  Default: 30 minutes. Set lower for more precise activity tracking. */\n  activityDebounceMinutes: z.number().int().positive().default(30),\n  /** Cron schedule for dormancy detection batch (cron expression).\n   *  Default: every 6 hours. */\n  dormancyCronSchedule: z.string().default('0 */6 * * *'),\n});\nexport type LifecycleConfig = z.infer<typeof LifecycleConfigSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * Lifecycle Label Fields — i18n Key Generation Configuration\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * Per-section field map for lifecycle i18n key generation.\n * Controls which keys are generated for LabellingTypes.LIFECYCLE.\n * Stage labels are generated from LifecycleStage enum values × these fields.\n */\nexport const LIFECYCLE_LABEL_FIELDS = {\n  stage: ['label', 'description'],\n  home_activation_progress: ['title', 'description'],\n  home_welcome_back: ['title', 'message'],\n  home_dashboard: ['title', 'description'],\n} as const;\n"]}