@wildo-ai/saas-models 1.0.1

package/dist/esm/compliance/privacy/redaction.shared.schemas.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { RolesSchema } from "../../security/authorizations/roles.shared.schemas.js";
+export var RedactionType;
+(function (RedactionType) {
+    RedactionType["MASK"] = "mask";
+    RedactionType["REMOVE"] = "remove";
+    RedactionType["HASH"] = "hash";
+    RedactionType["ENCRYPT"] = "encrypt";
+})(RedactionType || (RedactionType = {}));
+export const RedationRulesSchema = z.object({
+    fieldPath: z.string(),
+    isRecursive: z.boolean().default(false), // default false - if true, will redaction all nested fields
+    redactionType: z.enum(RedactionType),
+    forRoles: z.array(RolesSchema).optional(),
+});
+//# sourceMappingURL=redaction.shared.schemas.js.map

package/dist/esm/compliance/privacy/redaction.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.shared.schemas.js","sourceRoot":"","sources":["../../../../src/compliance/privacy/redaction.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AAEjF,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,oCAAmB,CAAA;AACrB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAGD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,4DAA4D;IACrG,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}

package/dist/esm/compliance/privacy/sharing.shared.schemas.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sharing.shared.schemas.d.ts.map

package/dist/esm/compliance/privacy/sharing.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharing.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/compliance/privacy/sharing.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/esm/compliance/privacy/sharing.shared.schemas.js

@@ -0,0 +1 @@
+//# sourceMappingURL=sharing.shared.schemas.js.map

package/dist/esm/compliance/privacy/sharing.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharing.shared.schemas.js","sourceRoot":"","sources":["../../../../src/compliance/privacy/sharing.shared.schemas.ts"],"names":[],"mappings":""}

package/dist/esm/config/analytics-value-moments.shared.schemas.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Analytics Value Moment Schemas
+ *
+ * Defines value signals and value moments for the analytics system.
+ * Value moments represent meaningful milestones in a user's journey
+ * (TTFV, aha moments, activation stages, anti-patterns).
+ */
+import { z } from 'zod';
+/**
+ * Built-in analytics track event names used by auto-instrumentation.
+ * App-custom events use arbitrary strings via track(name, properties).
+ */
+export declare enum AnalyticsEventName {
+    PAGE_VIEW = "page_view",
+    RESOURCE_OPERATION = "resource_operation",
+    ERROR = "error",
+    USER_LOGIN = "user_login",
+    USER_LOGOUT = "user_logout",
+    USER_STATUS_CHANGED = "user_status_changed",
+    NOTIFICATION = "notification",
+    HOTKEY_USED = "hotkey_used",
+    FEATURE_ACCESSED = "feature_accessed"
+}
+/** Event name prefix for value moments (TTFV, aha, activation). Anti-pattern uses ValueMomentRole.ANTI_PATTERN. */
+export declare const VALUE_MOMENT_EVENT_PREFIX: "value_moment";
+/** Signal type value when ALL mode signals are completed. */
+export declare const VALUE_MOMENT_SIGNAL_ALL_COMPLETED: "all_completed";
+/** Trigger source for ANALYTICS_MOMENT_ACHIEVED events. */
+export declare enum AnalyticsTriggerSource {
+    FRONTEND = "frontend",
+    BACKEND = "backend"
+}
+/** Hotkey key values for HOTKEY_USED analytics events. */
+export declare enum AnalyticsHotkeyKey {
+    COMMAND_MENU = "command_menu",
+    SIDEBAR_TOGGLE = "sidebar_toggle",
+    NOTIFICATIONS = "notifications",
+    QUICK_SWITCHER = "quick_switcher",
+    SHORTCUTS_HELP = "shortcuts_help"
+}
+/** Storage key prefix for achieved moments (suffixed with userId). */
+export declare const ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX: "wildo_analytics_achieved_";
+export declare enum ValueSignalType {
+    RESOURCE_OPERATION = "resource_operation",
+    RESOURCE_STATE = "resource_state",
+    VIEW_VISIT = "view_visit",
+    FEATURE_ACCESS = "feature_access",
+    CUSTOM_EVENT = "custom_event"
+}
+/**
+ * Only primitive values supported — no nested objects or arrays.
+ * The engine evaluates: Object.entries(filter).every(([k, v]) => resource[k] === v)
+ */
+export declare const ValueSignal_FilterSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+export type ValueSignal_Filter = z.infer<typeof ValueSignal_FilterSchema>;
+export declare const ValueSignalSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    signalType: z.ZodLiteral<ValueSignalType.RESOURCE_OPERATION>;
+    resourceType: z.ZodString;
+    operation: z.ZodString;
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    signalType: z.ZodLiteral<ValueSignalType.RESOURCE_STATE>;
+    resourceType: z.ZodString;
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    threshold: z.ZodNumber;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    signalType: z.ZodLiteral<ValueSignalType.VIEW_VISIT>;
+    contentType: z.ZodEnum<{
+        custom: "custom";
+        resource_operation: "resource_operation";
+        composite_view: "composite_view";
+        chart_view: "chart_view";
+        full_custom_view: "full_custom_view";
+        flows_actors_view: "flows_actors_view";
+    }>;
+    viewRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    signalType: z.ZodLiteral<ValueSignalType.FEATURE_ACCESS>;
+    featureId: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    signalType: z.ZodLiteral<ValueSignalType.CUSTOM_EVENT>;
+    eventName: z.ZodString;
+    threshold: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip, core.$ZodObjectExtra>], "signalType">;
+export type ValueSignal = z.infer<typeof ValueSignalSchema>;
+export declare enum ValueMomentMode {
+    /** ANY signal in the list triggers the moment (OR logic) */
+    ANY = "ANY",
+    /** ALL signals must be achieved (AND logic) */
+    ALL = "ALL"
+}
+/**
+ * Semantic role of a value moment.
+ * Determines event naming, persistence behavior, and how the system treats the moment.
+ */
+export declare enum ValueMomentRole {
+    /** Time to First Value — the primary metric. Exactly 0 or 1 per scope per config. */
+    TTFV = "ttfv",
+    /** Aha moment — behavior correlated with retention */
+    AHA_MOMENT = "aha_moment",
+    /** Activation stage — progression milestone */
+    ACTIVATION = "activation",
+    /** Anti-pattern — negative signal correlated with churn/frustration */
+    ANTI_PATTERN = "anti_pattern"
+}
+/**
+ * Scope entity for the value moment.
+ * Determines whose journey is being measured and where achieved state is persisted.
+ */
+export declare enum ValueMomentScope {
+    /** Per-user value moment (default) */
+    USER = "user",
+    /** Per-organization value moment */
+    ORGANIZATION = "organization"
+}
+export declare const ValueMomentCallbackSchema: z.ZodObject<{
+    frontendEvent: z.ZodDefault<z.ZodBoolean>;
+    backendHandler: z.ZodOptional<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type ValueMomentCallback = z.infer<typeof ValueMomentCallbackSchema>;
+export declare const ValueMomentSchema: z.ZodObject<{
+    identifier: z.ZodString;
+    role: z.ZodEnum<typeof ValueMomentRole>;
+    scope: z.ZodDefault<z.ZodEnum<typeof ValueMomentScope>>;
+    signals: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        signalType: z.ZodLiteral<ValueSignalType.RESOURCE_OPERATION>;
+        resourceType: z.ZodString;
+        operation: z.ZodString;
+        filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+        threshold: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        signalType: z.ZodLiteral<ValueSignalType.RESOURCE_STATE>;
+        resourceType: z.ZodString;
+        filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+        threshold: z.ZodNumber;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        signalType: z.ZodLiteral<ValueSignalType.VIEW_VISIT>;
+        contentType: z.ZodEnum<{
+            custom: "custom";
+            resource_operation: "resource_operation";
+            composite_view: "composite_view";
+            chart_view: "chart_view";
+            full_custom_view: "full_custom_view";
+            flows_actors_view: "flows_actors_view";
+        }>;
+        viewRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        signalType: z.ZodLiteral<ValueSignalType.FEATURE_ACCESS>;
+        featureId: z.ZodString;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        signalType: z.ZodLiteral<ValueSignalType.CUSTOM_EVENT>;
+        eventName: z.ZodString;
+        threshold: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip, core.$ZodObjectExtra>], "signalType">>;
+    mode: z.ZodDefault<z.ZodEnum<typeof ValueMomentMode>>;
+    requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    beforeStage: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cooldownMs: z.ZodOptional<z.ZodNumber>;
+    onAchieved: z.ZodOptional<z.ZodObject<{
+        frontendEvent: z.ZodDefault<z.ZodBoolean>;
+        backendHandler: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type ValueMoment = z.infer<typeof ValueMomentSchema>;
+//# sourceMappingURL=analytics-value-moments.shared.schemas.d.ts.map

package/dist/esm/config/analytics-value-moments.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-value-moments.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/config/analytics-value-moments.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B,SAAS,cAAc;IACvB,kBAAkB,uBAAuB;IACzC,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,mBAAmB,wBAAwB;IAC3C,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;CACtC;AAED,mHAAmH;AACnH,eAAO,MAAM,yBAAyB,EAAG,cAAuB,CAAC;AAEjE,6DAA6D;AAC7D,eAAO,MAAM,iCAAiC,EAAG,eAAwB,CAAC;AAE1E,2DAA2D;AAC3D,oBAAY,sBAAsB;IAChC,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED,0DAA0D;AAC1D,oBAAY,kBAAkB;IAC5B,YAAY,iBAAiB;IAC7B,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;CAClC;AAED,sEAAsE;AACtE,eAAO,MAAM,qCAAqC,EAAG,2BAAoC,CAAC;AAI1F,oBAAY,eAAe;IACzB,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IACjC,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;CAC9B;AAID;;;GAGG;AACH,eAAO,MAAM,wBAAwB,oGAGpC,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAuD1E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,oBAAY,eAAe;IACzB,4DAA4D;IAC5D,GAAG,QAAQ;IACX,+CAA+C;IAC/C,GAAG,QAAQ;CACZ;AAED;;;GAGG;AACH,oBAAY,eAAe;IACzB,qFAAqF;IACrF,IAAI,SAAS;IACb,sDAAsD;IACtD,UAAU,eAAe;IACzB,+CAA+C;IAC/C,UAAU,eAAe;IACzB,uEAAuE;IACvE,YAAY,iBAAiB;CAC9B;AAED;;;GAGG;AACH,oBAAY,gBAAgB;IAC1B,sCAAsC;IACtC,IAAI,SAAS;IACb,oCAAoC;IACpC,YAAY,iBAAiB;CAC9B;AAID,eAAO,MAAM,yBAAyB;;;uCAWpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAiD5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/esm/config/analytics-value-moments.shared.schemas.js

@@ -0,0 +1,215 @@
+/**
+ * Analytics Value Moment Schemas
+ *
+ * Defines value signals and value moments for the analytics system.
+ * Value moments represent meaningful milestones in a user's journey
+ * (TTFV, aha moments, activation stages, anti-patterns).
+ */
+import { z } from 'zod';
+/** Navigation content type values for VIEW_VISIT signals. Inlined here — canonical enum lives in saas-frontend-lib (navigation-v3.schemas). */
+const NAVIGATION_CONTENT_TYPES = [
+    'resource_operation',
+    'composite_view',
+    'chart_view',
+    'full_custom_view',
+    'flows_actors_view',
+    'custom',
+];
+// ─── Analytics Event Names (auto-instrumentation) ───────────────
+/**
+ * Built-in analytics track event names used by auto-instrumentation.
+ * App-custom events use arbitrary strings via track(name, properties).
+ */
+export var AnalyticsEventName;
+(function (AnalyticsEventName) {
+    AnalyticsEventName["PAGE_VIEW"] = "page_view";
+    AnalyticsEventName["RESOURCE_OPERATION"] = "resource_operation";
+    AnalyticsEventName["ERROR"] = "error";
+    AnalyticsEventName["USER_LOGIN"] = "user_login";
+    AnalyticsEventName["USER_LOGOUT"] = "user_logout";
+    AnalyticsEventName["USER_STATUS_CHANGED"] = "user_status_changed";
+    AnalyticsEventName["NOTIFICATION"] = "notification";
+    AnalyticsEventName["HOTKEY_USED"] = "hotkey_used";
+    AnalyticsEventName["FEATURE_ACCESSED"] = "feature_accessed";
+})(AnalyticsEventName || (AnalyticsEventName = {}));
+/** Event name prefix for value moments (TTFV, aha, activation). Anti-pattern uses ValueMomentRole.ANTI_PATTERN. */
+export const VALUE_MOMENT_EVENT_PREFIX = 'value_moment';
+/** Signal type value when ALL mode signals are completed. */
+export const VALUE_MOMENT_SIGNAL_ALL_COMPLETED = 'all_completed';
+/** Trigger source for ANALYTICS_MOMENT_ACHIEVED events. */
+export var AnalyticsTriggerSource;
+(function (AnalyticsTriggerSource) {
+    AnalyticsTriggerSource["FRONTEND"] = "frontend";
+    AnalyticsTriggerSource["BACKEND"] = "backend";
+})(AnalyticsTriggerSource || (AnalyticsTriggerSource = {}));
+/** Hotkey key values for HOTKEY_USED analytics events. */
+export var AnalyticsHotkeyKey;
+(function (AnalyticsHotkeyKey) {
+    AnalyticsHotkeyKey["COMMAND_MENU"] = "command_menu";
+    AnalyticsHotkeyKey["SIDEBAR_TOGGLE"] = "sidebar_toggle";
+    AnalyticsHotkeyKey["NOTIFICATIONS"] = "notifications";
+    AnalyticsHotkeyKey["QUICK_SWITCHER"] = "quick_switcher";
+    AnalyticsHotkeyKey["SHORTCUTS_HELP"] = "shortcuts_help";
+})(AnalyticsHotkeyKey || (AnalyticsHotkeyKey = {}));
+/** Storage key prefix for achieved moments (suffixed with userId). */
+export const ANALYTICS_ACHIEVED_STORAGE_KEY_PREFIX = 'wildo_analytics_achieved_';
+// ─── Signal Types ───────────────────────────────────────────────
+export var ValueSignalType;
+(function (ValueSignalType) {
+    ValueSignalType["RESOURCE_OPERATION"] = "resource_operation";
+    ValueSignalType["RESOURCE_STATE"] = "resource_state";
+    ValueSignalType["VIEW_VISIT"] = "view_visit";
+    ValueSignalType["FEATURE_ACCESS"] = "feature_access";
+    ValueSignalType["CUSTOM_EVENT"] = "custom_event";
+})(ValueSignalType || (ValueSignalType = {}));
+// ─── Primitive filter (shallow equality matching only) ──────────
+/**
+ * Only primitive values supported — no nested objects or arrays.
+ * The engine evaluates: Object.entries(filter).every(([k, v]) => resource[k] === v)
+ */
+export const ValueSignal_FilterSchema = z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]));
+// ─── Signal variant schemas (discriminated union on `signalType` — avoids Mongoose reserved `type`) ─────
+const ValueSignal_ResourceOperationSchema = z.object({
+    signalType: z.literal(ValueSignalType.RESOURCE_OPERATION),
+    /** Resource type identifier (e.g., 'PROJECTS', 'REPORTS') */
+    resourceType: z.string().min(1),
+    /** Operation identifier (e.g., CoreResourceOperation.CREATE) */
+    operation: z.string().min(1),
+    /**
+     * Optional resource field filter. Only operations on resources matching this
+     * filter count. Filter evaluation requires the NOTIFY_RESOURCE_SUCCESS event
+     * to carry a `resultSummary` field.
+     */
+    filter: ValueSignal_FilterSchema.optional(),
+    /**
+     * Minimum occurrence count required. When omitted (or 1), the first matching event fires.
+     * When > 1, the engine counts matching events and fires at the N-th occurrence.
+     */
+    threshold: z.number().min(1).optional(),
+});
+const ValueSignal_ResourceStateSchema = z.object({
+    signalType: z.literal(ValueSignalType.RESOURCE_STATE),
+    /** Resource type to count */
+    resourceType: z.string().min(1),
+    /** Field filter for counting */
+    filter: ValueSignal_FilterSchema.optional(),
+    /** Minimum count required to satisfy this signal */
+    threshold: z.number().min(1),
+});
+const ValueSignal_ViewVisitSchema = z.object({
+    signalType: z.literal(ValueSignalType.VIEW_VISIT),
+    /** Navigation content type (e.g., COMPOSITE_VIEW, CHART_VIEW) */
+    contentType: z.enum(NAVIGATION_CONTENT_TYPES),
+    /** Specific view reference. If omitted, any view of this contentType qualifies. */
+    viewRef: z.string().optional(),
+});
+const ValueSignal_FeatureAccessSchema = z.object({
+    signalType: z.literal(ValueSignalType.FEATURE_ACCESS),
+    /** Feature identifier from FeatureDefinition */
+    featureId: z.string().min(1),
+});
+const ValueSignal_CustomEventSchema = z.object({
+    signalType: z.literal(ValueSignalType.CUSTOM_EVENT),
+    /** Custom event name (tracked via useAnalytics().track() or backend emitSignal()) */
+    eventName: z.string().min(1),
+    /** Threshold: number of occurrences before the signal fires. Default: 1 */
+    threshold: z.number().min(1).optional(),
+});
+export const ValueSignalSchema = z.discriminatedUnion('signalType', [
+    ValueSignal_ResourceOperationSchema,
+    ValueSignal_ResourceStateSchema,
+    ValueSignal_ViewVisitSchema,
+    ValueSignal_FeatureAccessSchema,
+    ValueSignal_CustomEventSchema,
+]);
+// ─── Value Moment Enums ─────────────────────────────────────────
+export var ValueMomentMode;
+(function (ValueMomentMode) {
+    /** ANY signal in the list triggers the moment (OR logic) */
+    ValueMomentMode["ANY"] = "ANY";
+    /** ALL signals must be achieved (AND logic) */
+    ValueMomentMode["ALL"] = "ALL";
+})(ValueMomentMode || (ValueMomentMode = {}));
+/**
+ * Semantic role of a value moment.
+ * Determines event naming, persistence behavior, and how the system treats the moment.
+ */
+export var ValueMomentRole;
+(function (ValueMomentRole) {
+    /** Time to First Value — the primary metric. Exactly 0 or 1 per scope per config. */
+    ValueMomentRole["TTFV"] = "ttfv";
+    /** Aha moment — behavior correlated with retention */
+    ValueMomentRole["AHA_MOMENT"] = "aha_moment";
+    /** Activation stage — progression milestone */
+    ValueMomentRole["ACTIVATION"] = "activation";
+    /** Anti-pattern — negative signal correlated with churn/frustration */
+    ValueMomentRole["ANTI_PATTERN"] = "anti_pattern";
+})(ValueMomentRole || (ValueMomentRole = {}));
+/**
+ * Scope entity for the value moment.
+ * Determines whose journey is being measured and where achieved state is persisted.
+ */
+export var ValueMomentScope;
+(function (ValueMomentScope) {
+    /** Per-user value moment (default) */
+    ValueMomentScope["USER"] = "user";
+    /** Per-organization value moment */
+    ValueMomentScope["ORGANIZATION"] = "organization";
+})(ValueMomentScope || (ValueMomentScope = {}));
+// ─── Value Moment Callback ──────────────────────────────────────
+export const ValueMomentCallbackSchema = z.object({
+    /**
+     * Frontend: when true, emits FrontendEvents.ANALYTICS_MOMENT_ACHIEVED on achievement.
+     * App-custom code subscribes and filters by momentIdentifier for custom reactions.
+     */
+    frontendEvent: z.boolean().default(false),
+    /**
+     * Backend: Registered handler identifier to invoke when achieved.
+     * Handler resolved from a registry (similar to resource custom service implementations).
+     */
+    backendHandler: z.string().optional(),
+});
+// ─── Value Moment Definition ────────────────────────────────────
+export const ValueMomentSchema = z.object({
+    /** Unique identifier (used as analytics event name prefix + persistence key) */
+    identifier: z.string().min(1),
+    /**
+     * Semantic role. Determines:
+     * - Event naming: TTFV/AHA_MOMENT/ACTIVATION emit 'value_moment.{id}', ANTI_PATTERN emits 'anti_pattern.{id}'
+     * - Persistence: TTFV/AHA_MOMENT/ACTIVATION are persisted once achieved. ANTI_PATTERN is NOT persisted.
+     * - Engine behavior: ANTI_PATTERN uses cooldownMs + beforeStage.
+     */
+    role: z.enum(ValueMomentRole),
+    /**
+     * Scope entity. Determines whose journey is measured.
+     * USER: per-user (default). ORGANIZATION: per-org.
+     */
+    scope: z.enum(ValueMomentScope).default(ValueMomentScope.USER),
+    /** Signals that compose this value moment */
+    signals: z.array(ValueSignalSchema).min(1),
+    /** Composition mode: ANY = first signal wins, ALL = all signals required */
+    mode: z.enum(ValueMomentMode).default(ValueMomentMode.ANY),
+    /**
+     * Prerequisite moment identifiers. This moment only starts evaluating
+     * AFTER all prerequisite moments have been achieved.
+     */
+    requires: z.array(z.string()).optional(),
+    /**
+     * Inverse prerequisite: this moment only evaluates BEFORE the specified
+     * stage(s) have been achieved. Once any beforeStage moment is achieved,
+     * this moment is permanently suppressed. Primarily used for ANTI_PATTERN role.
+     */
+    beforeStage: z.array(z.string()).optional(),
+    /**
+     * Cooldown in milliseconds between re-firings (only meaningful for ANTI_PATTERN role).
+     * Default: 300_000 (5 minutes) for ANTI_PATTERN, ignored for other roles.
+     */
+    cooldownMs: z.number().min(0).optional(),
+    /**
+     * Callback hooks triggered when the moment is achieved.
+     * - frontendEvent: emits ANALYTICS_MOMENT_ACHIEVED on the EventBus
+     * - backendHandler: invokes a registered handler
+     */
+    onAchieved: ValueMomentCallbackSchema.optional(),
+});
+//# sourceMappingURL=analytics-value-moments.shared.schemas.js.map

package/dist/esm/config/analytics-value-moments.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-value-moments.shared.schemas.js","sourceRoot":"","sources":["../../../src/config/analytics-value-moments.shared.schemas.ts"],"names":[],"mappings":"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"}