@veruna/api-contracts 20.0.0 → 20.2.0

package/build/v1/engagement/schemas/analytics-revenue.schema.d.ts

@@ -11,6 +11,10 @@ export declare const RevenueKindSchema: z.ZodObject<{
     kind: z.ZodString;
     amount: z.ZodString;
 }, z.core.$strip>;
+/**
+ * Revenue NET of refunds, in kopecks (RUB×100), as decimal strings: paid orders by paid_at
+ * minus successful refunds by refund time (a refund reduces the week it happened in).
+ */
 export declare const EngagementRevenueResponseSchema: z.ZodObject<{
     total: z.ZodString;
     byPeriod: z.ZodArray<z.ZodObject<{

package/build/v1/engagement/schemas/analytics-revenue.schema.js

@@ -16,6 +16,10 @@ exports.RevenueKindSchema = zod_1.z.object({
         .string()
         .describe('Net revenue of this order kind, kopecks (RUB×100), decimal string'),
 });
+/**
+ * Revenue NET of refunds, in kopecks (RUB×100), as decimal strings: paid orders by paid_at
+ * minus successful refunds by refund time (a refund reduces the week it happened in).
+ */
 exports.EngagementRevenueResponseSchema = zod_1.z.object({
     total: zod_1.z.string().describe('Net revenue for the window, kopecks (RUB×100), decimal string'),
     byPeriod: zod_1.z.array(exports.RevenuePeriodSchema),

package/build/v1/engagement/schemas/analytics-revenue.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"analytics-revenue.schema.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/analytics-revenue.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAEX,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAChC,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;CAC5F,CAAC,CAAC;AAEU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACvF,MAAM,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,mEAAmE,CAAC;CACrF,CAAC,CAAC;AAMU,QAAA,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;IAC3F,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,2BAAmB,CAAC;IACtC,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,yBAAiB,CAAC;CACrC,CAAC,CAAC"}
+{"version":3,"file":"analytics-revenue.schema.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/analytics-revenue.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAEX,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAChC,EAAE,EAAE,OAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;CAC5F,CAAC,CAAC;AAEU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IACvF,MAAM,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,mEAAmE,CAAC;CACrF,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;IAC3F,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,2BAAmB,CAAC;IACtC,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,yBAAiB,CAAC;CACrC,CAAC,CAAC"}

package/build/v1/engagement/schemas/engagement-preferences.schema.d.ts

@@ -1,7 +1,16 @@
 import { z } from 'zod';
+/**
+ * Read view of the user's lifecycle-messaging preferences. `lifecycleOptedOut`
+ * reflects the suppression table (EMAIL widened with ALL): true means the user
+ * has opted out of marketing/lifecycle sends.
+ */
 export declare const EngagementPreferencesResponseSchema: z.ZodObject<{
     lifecycleOptedOut: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * Mutation of the user's lifecycle-messaging preference. Setting
+ * `lifecycleOptedOut=true` writes an ALL/UNSUBSCRIBE suppression; false lifts it.
+ */
 export declare const UpdateEngagementPreferencesRequestSchema: z.ZodObject<{
     lifecycleOptedOut: z.ZodBoolean;
 }, z.core.$strip>;

package/build/v1/engagement/schemas/engagement-preferences.schema.js

@@ -2,9 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateEngagementPreferencesRequestSchema = exports.EngagementPreferencesResponseSchema = void 0;
 const zod_1 = require("zod");
+/**
+ * Read view of the user's lifecycle-messaging preferences. `lifecycleOptedOut`
+ * reflects the suppression table (EMAIL widened with ALL): true means the user
+ * has opted out of marketing/lifecycle sends.
+ */
 exports.EngagementPreferencesResponseSchema = zod_1.z.object({
     lifecycleOptedOut: zod_1.z.boolean(),
 });
+/**
+ * Mutation of the user's lifecycle-messaging preference. Setting
+ * `lifecycleOptedOut=true` writes an ALL/UNSUBSCRIBE suppression; false lifts it.
+ */
 exports.UpdateEngagementPreferencesRequestSchema = zod_1.z.object({
     lifecycleOptedOut: zod_1.z.boolean({
         error: 'UpdateEngagementPreferencesRequest.lifecycleOptedOut.required',

package/build/v1/engagement/schemas/engagement-preferences.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"engagement-preferences.schema.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/engagement-preferences.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAOX,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE;CACjC,CAAC,CAAC;AAMU,QAAA,wCAAwC,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7D,iBAAiB,EAAE,OAAC,CAAC,OAAO,CAAC;QACzB,KAAK,EAAE,+DAA+D;KACzE,CAAC;CACL,CAAC,CAAC"}
+{"version":3,"file":"engagement-preferences.schema.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/engagement-preferences.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;GAIG;AACU,QAAA,mCAAmC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE;CACjC,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,wCAAwC,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7D,iBAAiB,EAAE,OAAC,CAAC,OAAO,CAAC;QACzB,KAAK,EAAE,+DAA+D;KACzE,CAAC;CACL,CAAC,CAAC"}

package/build/v1/engagement/schemas/lifecycle-campaign.enum.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Stable key for every lifecycle campaign (one trigger → one campaign).
+ * Used as lifecycle_sends.campaign_key and as the prefix of the dedupe key
+ * (`lifecycle:{campaignKey}:{userId}:{cycleId?}`).
+ */
 export declare enum LifecycleCampaign {
     VERIFY_NUDGE_1 = "VERIFY_NUDGE_1",
     VERIFY_NUDGE_2 = "VERIFY_NUDGE_2",

package/build/v1/engagement/schemas/lifecycle-campaign.enum.js

@@ -1,8 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LifecycleCampaign = void 0;
+/**
+ * Stable key for every lifecycle campaign (one trigger → one campaign).
+ * Used as lifecycle_sends.campaign_key and as the prefix of the dedupe key
+ * (`lifecycle:{campaignKey}:{userId}:{cycleId?}`).
+ */
 var LifecycleCampaign;
 (function (LifecycleCampaign) {
+    // Acquisition / onboarding funnel
     LifecycleCampaign["VERIFY_NUDGE_1"] = "VERIFY_NUDGE_1";
     LifecycleCampaign["VERIFY_NUDGE_2"] = "VERIFY_NUDGE_2";
     LifecycleCampaign["WELCOME"] = "WELCOME";
@@ -14,18 +20,23 @@ var LifecycleCampaign;
     LifecycleCampaign["SPENT_ALL_DAY1_PROMO"] = "SPENT_ALL_DAY1_PROMO";
     LifecycleCampaign["STREAK_AT_RISK"] = "STREAK_AT_RISK";
     LifecycleCampaign["STREAK_LOST"] = "STREAK_LOST";
+    // Re-engagement / winback
     LifecycleCampaign["REENGAGE_LOW"] = "REENGAGE_LOW";
     LifecycleCampaign["WINBACK_1"] = "WINBACK_1";
+    // Abandoned cart / checkout recovery
     LifecycleCampaign["CART_ABANDONED"] = "CART_ABANDONED";
     LifecycleCampaign["CART_ABANDONED_REMINDER"] = "CART_ABANDONED_REMINDER";
     LifecycleCampaign["OFFER_EXPIRING_REMINDER"] = "OFFER_EXPIRING_REMINDER";
+    // Subscription lifecycle (billing-driven)
     LifecycleCampaign["RENEWAL_NOTICE_3D"] = "RENEWAL_NOTICE_3D";
     LifecycleCampaign["PURCHASE_CONFIRMED"] = "PURCHASE_CONFIRMED";
     LifecycleCampaign["SUBSCRIPTION_CANCELLED_WINBACK"] = "SUBSCRIPTION_CANCELLED_WINBACK";
     LifecycleCampaign["PAYMENT_FAILED"] = "PAYMENT_FAILED";
     LifecycleCampaign["SUBSCRIPTION_EXPIRED"] = "SUBSCRIPTION_EXPIRED";
     LifecycleCampaign["LOW_BALANCE"] = "LOW_BALANCE";
+    // Free→paid: engaged free user who ran out of tokens → subscription upsell.
     LifecycleCampaign["LIMIT_REACHED_UPSELL"] = "LIMIT_REACHED_UPSELL";
+    // Repeat package buyer (no subscription) → cheaper-subscription upgrade nudge.
     LifecycleCampaign["PACKAGE_UPGRADE_OFFER"] = "PACKAGE_UPGRADE_OFFER";
 })(LifecycleCampaign || (exports.LifecycleCampaign = LifecycleCampaign = {}));
 //# sourceMappingURL=lifecycle-campaign.enum.js.map

package/build/v1/engagement/schemas/lifecycle-campaign.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-campaign.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/lifecycle-campaign.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,iBAoCX;AApCD,WAAY,iBAAiB;IAEzB,sDAAiC,CAAA;IACjC,sDAAiC,CAAA;IACjC,wCAAmB,CAAA;IACnB,oEAA+C,CAAA;IAC/C,oEAA+C,CAAA;IAC/C,8DAAyC,CAAA;IACzC,wDAAmC,CAAA;IACnC,8DAAyC,CAAA;IACzC,kEAA6C,CAAA;IAC7C,sDAAiC,CAAA;IACjC,gDAA2B,CAAA;IAG3B,kDAA6B,CAAA;IAC7B,4CAAuB,CAAA;IAGvB,sDAAiC,CAAA;IACjC,wEAAmD,CAAA;IACnD,wEAAmD,CAAA;IAGnD,4DAAuC,CAAA;IACvC,8DAAyC,CAAA;IACzC,sFAAiE,CAAA;IACjE,sDAAiC,CAAA;IACjC,kEAA6C,CAAA;IAC7C,gDAA2B,CAAA;IAG3B,kEAA6C,CAAA;IAG7C,oEAA+C,CAAA;AACnD,CAAC,EApCW,iBAAiB,iCAAjB,iBAAiB,QAoC5B"}
+{"version":3,"file":"lifecycle-campaign.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/lifecycle-campaign.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,iBAoCX;AApCD,WAAY,iBAAiB;IACzB,kCAAkC;IAClC,sDAAiC,CAAA;IACjC,sDAAiC,CAAA;IACjC,wCAAmB,CAAA;IACnB,oEAA+C,CAAA;IAC/C,oEAA+C,CAAA;IAC/C,8DAAyC,CAAA;IACzC,wDAAmC,CAAA;IACnC,8DAAyC,CAAA;IACzC,kEAA6C,CAAA;IAC7C,sDAAiC,CAAA;IACjC,gDAA2B,CAAA;IAE3B,0BAA0B;IAC1B,kDAA6B,CAAA;IAC7B,4CAAuB,CAAA;IAEvB,qCAAqC;IACrC,sDAAiC,CAAA;IACjC,wEAAmD,CAAA;IACnD,wEAAmD,CAAA;IAEnD,0CAA0C;IAC1C,4DAAuC,CAAA;IACvC,8DAAyC,CAAA;IACzC,sFAAiE,CAAA;IACjE,sDAAiC,CAAA;IACjC,kEAA6C,CAAA;IAC7C,gDAA2B,CAAA;IAE3B,4EAA4E;IAC5E,kEAA6C,CAAA;IAE7C,+EAA+E;IAC/E,oEAA+C,CAAA;AACnD,CAAC,EApCW,iBAAiB,iCAAjB,iBAAiB,QAoC5B"}

package/build/v1/engagement/schemas/lifecycle-stage.enum.d.ts

@@ -1,10 +1,27 @@
+/**
+ * Stage of a user inside the lifecycle/growth funnel.
+ * Persisted on user_lifecycle_states.stage and driven by an explicit
+ * state machine in the engagement domain (no scattered status `if`s).
+ *
+ * The ladder runs REGISTERED → VERIFIED → ACTIVATED → ENGAGED → PAYING → SCALED, with
+ * PAST_DUE, DORMANT, REACTIVATED and CHURNED hanging off it. The money half (PAYING and
+ * beyond) exists because the funnel has to answer where revenue is won and lost, not only
+ * whether someone is using the product — a user can be ENGAGED for months and never pay.
+ *
+ * Stage is "where the user is now", not "the best they ever were": a paying user who goes
+ * quiet becomes DORMANT. `user_subscriptions` stays the source of truth for money; this
+ * column answers funnel questions.
+ */
 export declare enum LifecycleStage {
     REGISTERED = "REGISTERED",
     VERIFIED = "VERIFIED",
     ACTIVATED = "ACTIVATED",
     ENGAGED = "ENGAGED",
+    /** Has paid at least once and the purchase is live. */
     PAYING = "PAYING",
+    /** Moved up a plan while already paying — the expansion step. */
     SCALED = "SCALED",
+    /** Was paying, renewal charge failed, still inside grace. This is the "don't lose the payer" band. */
     PAST_DUE = "PAST_DUE",
     DORMANT = "DORMANT",
     REACTIVATED = "REACTIVATED",

package/build/v1/engagement/schemas/lifecycle-stage.enum.js

@@ -1,14 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LifecycleStage = void 0;
+/**
+ * Stage of a user inside the lifecycle/growth funnel.
+ * Persisted on user_lifecycle_states.stage and driven by an explicit
+ * state machine in the engagement domain (no scattered status `if`s).
+ *
+ * The ladder runs REGISTERED → VERIFIED → ACTIVATED → ENGAGED → PAYING → SCALED, with
+ * PAST_DUE, DORMANT, REACTIVATED and CHURNED hanging off it. The money half (PAYING and
+ * beyond) exists because the funnel has to answer where revenue is won and lost, not only
+ * whether someone is using the product — a user can be ENGAGED for months and never pay.
+ *
+ * Stage is "where the user is now", not "the best they ever were": a paying user who goes
+ * quiet becomes DORMANT. `user_subscriptions` stays the source of truth for money; this
+ * column answers funnel questions.
+ */
 var LifecycleStage;
 (function (LifecycleStage) {
     LifecycleStage["REGISTERED"] = "REGISTERED";
     LifecycleStage["VERIFIED"] = "VERIFIED";
     LifecycleStage["ACTIVATED"] = "ACTIVATED";
     LifecycleStage["ENGAGED"] = "ENGAGED";
+    /** Has paid at least once and the purchase is live. */
     LifecycleStage["PAYING"] = "PAYING";
+    /** Moved up a plan while already paying — the expansion step. */
     LifecycleStage["SCALED"] = "SCALED";
+    /** Was paying, renewal charge failed, still inside grace. This is the "don't lose the payer" band. */
     LifecycleStage["PAST_DUE"] = "PAST_DUE";
     LifecycleStage["DORMANT"] = "DORMANT";
     LifecycleStage["REACTIVATED"] = "REACTIVATED";

package/build/v1/engagement/schemas/lifecycle-stage.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-stage.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/lifecycle-stage.enum.ts"],"names":[],"mappings":";;;AAcA,IAAY,cAcX;AAdD,WAAY,cAAc;IACtB,2CAAyB,CAAA;IACzB,uCAAqB,CAAA;IACrB,yCAAuB,CAAA;IACvB,qCAAmB,CAAA;IAEnB,mCAAiB,CAAA;IAEjB,mCAAiB,CAAA;IAEjB,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;IACnB,6CAA2B,CAAA;IAC3B,qCAAmB,CAAA;AACvB,CAAC,EAdW,cAAc,8BAAd,cAAc,QAczB"}
+{"version":3,"file":"lifecycle-stage.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/lifecycle-stage.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;GAaG;AACH,IAAY,cAcX;AAdD,WAAY,cAAc;IACtB,2CAAyB,CAAA;IACzB,uCAAqB,CAAA;IACrB,yCAAuB,CAAA;IACvB,qCAAmB,CAAA;IACnB,uDAAuD;IACvD,mCAAiB,CAAA;IACjB,iEAAiE;IACjE,mCAAiB,CAAA;IACjB,sGAAsG;IACtG,uCAAqB,CAAA;IACrB,qCAAmB,CAAA;IACnB,6CAA2B,CAAA;IAC3B,qCAAmB,CAAA;AACvB,CAAC,EAdW,cAAc,8BAAd,cAAc,QAczB"}

package/build/v1/engagement/schemas/rfm-segment.enum.d.ts

@@ -1,3 +1,10 @@
+/**
+ * RFM-derived behavioural segment, recomputed by the weekly RFM batch
+ * and stored on user_lifecycle_states.rfm_segment. NEW marks users with
+ * insufficient history to score; NEEDS_ATTENTION is the explicit residual
+ * band for scored users (R/F/M all present) who match no stronger band —
+ * typically medium-recency, low-frequency users worth a nudge.
+ */
 export declare enum RfmSegment {
     CHAMPIONS = "CHAMPIONS",
     LOYALISTS = "LOYALISTS",

package/build/v1/engagement/schemas/rfm-segment.enum.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RfmSegment = void 0;
+/**
+ * RFM-derived behavioural segment, recomputed by the weekly RFM batch
+ * and stored on user_lifecycle_states.rfm_segment. NEW marks users with
+ * insufficient history to score; NEEDS_ATTENTION is the explicit residual
+ * band for scored users (R/F/M all present) who match no stronger band —
+ * typically medium-recency, low-frequency users worth a nudge.
+ */
 var RfmSegment;
 (function (RfmSegment) {
     RfmSegment["CHAMPIONS"] = "CHAMPIONS";

package/build/v1/engagement/schemas/rfm-segment.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"rfm-segment.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/rfm-segment.enum.ts"],"names":[],"mappings":";;;AAOA,IAAY,UASX;AATD,WAAY,UAAU;IAClB,qCAAuB,CAAA;IACvB,qCAAuB,CAAA;IACvB,qCAAuB,CAAA;IACvB,iCAAmB,CAAA;IACnB,yCAA2B,CAAA;IAC3B,2BAAa,CAAA;IACb,iDAAmC,CAAA;IACnC,yBAAW,CAAA;AACf,CAAC,EATW,UAAU,0BAAV,UAAU,QASrB"}
+{"version":3,"file":"rfm-segment.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/rfm-segment.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,UASX;AATD,WAAY,UAAU;IAClB,qCAAuB,CAAA;IACvB,qCAAuB,CAAA;IACvB,qCAAuB,CAAA;IACvB,iCAAmB,CAAA;IACnB,yCAA2B,CAAA;IAC3B,2BAAa,CAAA;IACb,iDAAmC,CAAA;IACnC,yBAAW,CAAA;AACf,CAAC,EATW,UAAU,0BAAV,UAAU,QASrB"}

package/build/v1/engagement/schemas/suppression-channel.enum.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Channel scope of a suppression entry. ALL suppresses every channel for
+ * the recipient; the others mirror NotificationChannel for per-channel
+ * opt-out / bounce handling.
+ */
 export declare enum SuppressionChannel {
     ALL = "ALL",
     EMAIL = "EMAIL",

package/build/v1/engagement/schemas/suppression-channel.enum.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SuppressionChannel = void 0;
+/**
+ * Channel scope of a suppression entry. ALL suppresses every channel for
+ * the recipient; the others mirror NotificationChannel for per-channel
+ * opt-out / bounce handling.
+ */
 var SuppressionChannel;
 (function (SuppressionChannel) {
     SuppressionChannel["ALL"] = "ALL";

package/build/v1/engagement/schemas/suppression-channel.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"suppression-channel.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/suppression-channel.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC1B,iCAAW,CAAA;IACX,qCAAe,CAAA;IACf,2CAAqB,CAAA;IACrB,iCAAW,CAAA;IACX,mCAAa,CAAA;IACb,uCAAiB,CAAA;AACrB,CAAC,EAPW,kBAAkB,kCAAlB,kBAAkB,QAO7B"}
+{"version":3,"file":"suppression-channel.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/suppression-channel.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC1B,iCAAW,CAAA;IACX,qCAAe,CAAA;IACf,2CAAqB,CAAA;IACrB,iCAAW,CAAA;IACX,mCAAa,CAAA;IACb,uCAAiB,CAAA;AACrB,CAAC,EAPW,kBAAkB,kCAAlB,kBAAkB,QAO7B"}

package/build/v1/engagement/schemas/suppression-reason.enum.d.ts

@@ -1,7 +1,16 @@
+/**
+ * Why a recipient was permanently suppressed from lifecycle messaging.
+ * Transactional messages (verification code, password reset) are exempt
+ * from suppression.
+ */
 export declare enum SuppressionReason {
     UNSUBSCRIBE = "UNSUBSCRIBE",
     HARD_BOUNCE = "HARD_BOUNCE",
     SPAM_COMPLAINT = "SPAM_COMPLAINT",
+    /**
+     * @deprecated Sunset is no longer a suppression row: it is the CHURNED lifecycle stage. Kept so
+     * rows written by the old rule (and the manual lift script) still parse.
+     */
     SUNSET = "SUNSET",
     ADMIN = "ADMIN"
 }

package/build/v1/engagement/schemas/suppression-reason.enum.js

@@ -1,11 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SuppressionReason = void 0;
+/**
+ * Why a recipient was permanently suppressed from lifecycle messaging.
+ * Transactional messages (verification code, password reset) are exempt
+ * from suppression.
+ */
 var SuppressionReason;
 (function (SuppressionReason) {
     SuppressionReason["UNSUBSCRIBE"] = "UNSUBSCRIBE";
     SuppressionReason["HARD_BOUNCE"] = "HARD_BOUNCE";
     SuppressionReason["SPAM_COMPLAINT"] = "SPAM_COMPLAINT";
+    /**
+     * @deprecated Sunset is no longer a suppression row: it is the CHURNED lifecycle stage. Kept so
+     * rows written by the old rule (and the manual lift script) still parse.
+     */
     SuppressionReason["SUNSET"] = "SUNSET";
     SuppressionReason["ADMIN"] = "ADMIN";
 })(SuppressionReason || (exports.SuppressionReason = SuppressionReason = {}));

package/build/v1/engagement/schemas/suppression-reason.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"suppression-reason.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/suppression-reason.enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,iBAUX;AAVD,WAAY,iBAAiB;IACzB,gDAA2B,CAAA;IAC3B,gDAA2B,CAAA;IAC3B,sDAAiC,CAAA;IAKjC,sCAAiB,CAAA;IACjB,oCAAe,CAAA;AACnB,CAAC,EAVW,iBAAiB,iCAAjB,iBAAiB,QAU5B"}
+{"version":3,"file":"suppression-reason.enum.js","sourceRoot":"","sources":["../../../../v1/engagement/schemas/suppression-reason.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,iBAUX;AAVD,WAAY,iBAAiB;IACzB,gDAA2B,CAAA;IAC3B,gDAA2B,CAAA;IAC3B,sDAAiC,CAAA;IACjC;;;OAGG;IACH,sCAAiB,CAAA;IACjB,oCAAe,CAAA;AACnB,CAAC,EAVW,iBAAiB,iCAAjB,iBAAiB,QAU5B"}

package/build/v1/feedback/feedback.constants.d.ts

@@ -1,6 +1,9 @@
+/** Shared bounds of the product-feedback survey — the API, the DB check and the UI agree here. */
 export declare const FEEDBACK_RATING_MIN = 1;
 export declare const FEEDBACK_RATING_MAX = 5;
 export declare const FEEDBACK_COMMENT_MAX_LENGTH = 2000;
+/** Управляющие символы, кроме табуляции и переводов строк: NUL Postgres в TEXT не принимает. */
 export declare const FEEDBACK_COMMENT_CONTROL_CHARACTERS: RegExp;
+/** Пагинация админского списка. */
 export declare const FEEDBACK_ADMIN_PAGE_LIMIT_MAX = 100;
 export declare const FEEDBACK_ADMIN_PAGE_LIMIT_DEFAULT = 20;

package/build/v1/feedback/feedback.constants.js

@@ -1,10 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FEEDBACK_ADMIN_PAGE_LIMIT_DEFAULT = exports.FEEDBACK_ADMIN_PAGE_LIMIT_MAX = exports.FEEDBACK_COMMENT_CONTROL_CHARACTERS = exports.FEEDBACK_COMMENT_MAX_LENGTH = exports.FEEDBACK_RATING_MAX = exports.FEEDBACK_RATING_MIN = void 0;
+/** Shared bounds of the product-feedback survey — the API, the DB check and the UI agree here. */
 exports.FEEDBACK_RATING_MIN = 1;
 exports.FEEDBACK_RATING_MAX = 5;
 exports.FEEDBACK_COMMENT_MAX_LENGTH = 2000;
+/** Управляющие символы, кроме табуляции и переводов строк: NUL Postgres в TEXT не принимает. */
 exports.FEEDBACK_COMMENT_CONTROL_CHARACTERS = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/;
+/** Пагинация админского списка. */
 exports.FEEDBACK_ADMIN_PAGE_LIMIT_MAX = 100;
 exports.FEEDBACK_ADMIN_PAGE_LIMIT_DEFAULT = 20;
 //# sourceMappingURL=feedback.constants.js.map

package/build/v1/feedback/feedback.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"feedback.constants.js","sourceRoot":"","sources":["../../../v1/feedback/feedback.constants.ts"],"names":[],"mappings":";;;AACa,QAAA,mBAAmB,GAAG,CAAC,CAAC;AACxB,QAAA,mBAAmB,GAAG,CAAC,CAAC;AACxB,QAAA,2BAA2B,GAAG,IAAI,CAAC;AAGnC,QAAA,mCAAmC,GAAG,gDAAgD,CAAC;AAGvF,QAAA,6BAA6B,GAAG,GAAG,CAAC;AACpC,QAAA,iCAAiC,GAAG,EAAE,CAAC"}
+{"version":3,"file":"feedback.constants.js","sourceRoot":"","sources":["../../../v1/feedback/feedback.constants.ts"],"names":[],"mappings":";;;AAAA,kGAAkG;AACrF,QAAA,mBAAmB,GAAG,CAAC,CAAC;AACxB,QAAA,mBAAmB,GAAG,CAAC,CAAC;AACxB,QAAA,2BAA2B,GAAG,IAAI,CAAC;AAEhD,gGAAgG;AACnF,QAAA,mCAAmC,GAAG,gDAAgD,CAAC;AAEpG,mCAAmC;AACtB,QAAA,6BAA6B,GAAG,GAAG,CAAC;AACpC,QAAA,iCAAiC,GAAG,EAAE,CAAC"}

package/build/v1/feedback/feedback.errors.d.ts

@@ -1,5 +1,6 @@
 import { ErrorMetadata } from '../../shared';
 export declare enum FeedbackErrorCode {
+    /** Комментарий без оценки — комментировать нечего. */
     FEEDBACK_RATING_REQUIRED = "FEEDBACK_RATING_REQUIRED"
 }
 export declare const FEEDBACK_ERRORS: Record<FeedbackErrorCode, ErrorMetadata>;

package/build/v1/feedback/feedback.errors.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FEEDBACK_ERRORS = exports.FeedbackErrorCode = void 0;
 var FeedbackErrorCode;
 (function (FeedbackErrorCode) {
+    /** Комментарий без оценки — комментировать нечего. */
     FeedbackErrorCode["FEEDBACK_RATING_REQUIRED"] = "FEEDBACK_RATING_REQUIRED";
 })(FeedbackErrorCode || (exports.FeedbackErrorCode = FeedbackErrorCode = {}));
 exports.FEEDBACK_ERRORS = {

package/build/v1/feedback/feedback.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"feedback.errors.js","sourceRoot":"","sources":["../../../v1/feedback/feedback.errors.ts"],"names":[],"mappings":";;;AAEA,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAEzB,0EAAqD,CAAA;AACzD,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B;AAEY,QAAA,eAAe,GAA6C;IACrE,CAAC,iBAAiB,CAAC,wBAAwB,CAAC,EAAE;QAC1C,IAAI,EAAE,iBAAiB,CAAC,wBAAwB;QAChD,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}
+{"version":3,"file":"feedback.errors.js","sourceRoot":"","sources":["../../../v1/feedback/feedback.errors.ts"],"names":[],"mappings":";;;AAEA,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,sDAAsD;IACtD,0EAAqD,CAAA;AACzD,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B;AAEY,QAAA,eAAe,GAA6C;IACrE,CAAC,iBAAiB,CAAC,wBAAwB,CAAC,EAAE;QAC1C,IAAI,EAAE,iBAAiB,CAAC,wBAAwB;QAChD,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}

package/build/v1/feedback/schemas/admin-feedback.schema.d.ts

@@ -1,6 +1,10 @@
 import { z } from 'zod';
 import { SortOrder } from '../../shared/sort-order.enum';
 import { FeedbackStatus } from './feedback-status.enum';
+/**
+ * Admin list filters
+ * Error messages: AdminListFeedbackRequest.{field}.{rule}
+ */
 export declare const AdminListFeedbackRequestSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<typeof FeedbackStatus>>;
     minRating: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -29,6 +33,7 @@ export declare const AdminFeedbackRatingBucketSchema: z.ZodObject<{
     rating: z.ZodNumber;
     count: z.ZodNumber;
 }, z.core.$strip>;
+/** Сводка по всей таблице: фильтры списка на неё не влияют. */
 export declare const AdminFeedbackSummarySchema: z.ZodObject<{
     averageRating: z.ZodNullable<z.ZodString>;
     ratedCount: z.ZodNumber;

package/build/v1/feedback/schemas/admin-feedback.schema.js

@@ -6,6 +6,10 @@ const regex_1 = require("../../../shared/regex");
 const sort_order_enum_1 = require("../../shared/sort-order.enum");
 const feedback_constants_1 = require("../feedback.constants");
 const feedback_status_enum_1 = require("./feedback-status.enum");
+/**
+ * Admin list filters
+ * Error messages: AdminListFeedbackRequest.{field}.{rule}
+ */
 exports.AdminListFeedbackRequestSchema = zod_1.z.object({
     status: zod_1.z
         .nativeEnum(feedback_status_enum_1.FeedbackStatus, { error: 'AdminListFeedbackRequest.status.invalid' })
@@ -46,7 +50,9 @@ exports.AdminFeedbackListItemSchema = zod_1.z.object({
     status: zod_1.z.nativeEnum(feedback_status_enum_1.FeedbackStatus),
     rating: zod_1.z.number().int().min(feedback_constants_1.FEEDBACK_RATING_MIN).max(feedback_constants_1.FEEDBACK_RATING_MAX).nullable(),
     comment: zod_1.z.string().nullable(),
+    /** Сколько раз закрыл звёзды, не оценив. */
     dismissCount: zod_1.z.number().int().nonnegative(),
+    /** Сколько раз закрыл поле комментария после оценки. */
     commentDismissCount: zod_1.z.number().int().nonnegative(),
     ratedAt: zod_1.z.string().datetime({ offset: true }).nullable(),
     dismissedAt: zod_1.z.string().datetime({ offset: true }).nullable(),
@@ -57,10 +63,13 @@ exports.AdminFeedbackRatingBucketSchema = zod_1.z.object({
     rating: zod_1.z.number().int().min(feedback_constants_1.FEEDBACK_RATING_MIN).max(feedback_constants_1.FEEDBACK_RATING_MAX),
     count: zod_1.z.number().int().nonnegative(),
 });
+/** Сводка по всей таблице: фильтры списка на неё не влияют. */
 exports.AdminFeedbackSummarySchema = zod_1.z.object({
+    /** Средняя оценка; null — оценок нет. Decimal-строка с фиксированным округлением. */
     averageRating: zod_1.z.string().nullable(),
     ratedCount: zod_1.z.number().int().nonnegative(),
     commentedCount: zod_1.z.number().int().nonnegative(),
+    /** Раскладка по шкале целиком — пустые оценки приходят нулями. */
     ratingDistribution: zod_1.z.array(exports.AdminFeedbackRatingBucketSchema),
 });
 exports.AdminListFeedbackResponseSchema = zod_1.z.object({

package/build/v1/feedback/schemas/admin-feedback.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-feedback.schema.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/admin-feedback.schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"admin-feedback.schema.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/admin-feedback.schema.ts"],"names":[],"mappings":"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"}

package/build/v1/feedback/schemas/feedback-ask.enum.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Что клиент рисует прямо сейчас: RATING — звёзды, COMMENT — поле комментария к уже
+ * поставленной оценке, null — ничего. Сервер считает это сам, клиент правила цикла не повторяет.
+ */
 export declare enum FeedbackAsk {
     RATING = "RATING",
     COMMENT = "COMMENT"

package/build/v1/feedback/schemas/feedback-ask.enum.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeedbackAsk = void 0;
+/**
+ * Что клиент рисует прямо сейчас: RATING — звёзды, COMMENT — поле комментария к уже
+ * поставленной оценке, null — ничего. Сервер считает это сам, клиент правила цикла не повторяет.
+ */
 var FeedbackAsk;
 (function (FeedbackAsk) {
     FeedbackAsk["RATING"] = "RATING";

package/build/v1/feedback/schemas/feedback-ask.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"feedback-ask.enum.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/feedback-ask.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,WAGX;AAHD,WAAY,WAAW;IACnB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACvB,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB"}
+{"version":3,"file":"feedback-ask.enum.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/feedback-ask.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,WAGX;AAHD,WAAY,WAAW;IACnB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACvB,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB"}

package/build/v1/feedback/schemas/feedback-state.schema.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { FeedbackAsk } from './feedback-ask.enum';
 import { FeedbackStatus } from './feedback-status.enum';
+/** Ответ и чтения, и записи: после любого действия клиент сразу знает, что рисовать дальше. */
 export declare const FeedbackStateResponseSchema: z.ZodObject<{
     status: z.ZodNullable<z.ZodEnum<typeof FeedbackStatus>>;
     ask: z.ZodNullable<z.ZodEnum<typeof FeedbackAsk>>;

package/build/v1/feedback/schemas/feedback-state.schema.js

@@ -5,6 +5,7 @@ const zod_1 = require("zod");
 const feedback_constants_1 = require("../feedback.constants");
 const feedback_ask_enum_1 = require("./feedback-ask.enum");
 const feedback_status_enum_1 = require("./feedback-status.enum");
+/** Ответ и чтения, и записи: после любого действия клиент сразу знает, что рисовать дальше. */
 exports.FeedbackStateResponseSchema = zod_1.z.object({
     status: zod_1.z.nativeEnum(feedback_status_enum_1.FeedbackStatus).nullable(),
     ask: zod_1.z.nativeEnum(feedback_ask_enum_1.FeedbackAsk).nullable(),

package/build/v1/feedback/schemas/feedback-state.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"feedback-state.schema.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/feedback-state.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,8DAAiF;AACjF,2DAAkD;AAClD,iEAAwD;AAG3C,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,OAAC,CAAC,UAAU,CAAC,qCAAc,CAAC,CAAC,QAAQ,EAAE;IAC/C,GAAG,EAAE,OAAC,CAAC,UAAU,CAAC,+BAAW,CAAC,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,wCAAmB,CAAC,CAAC,GAAG,CAAC,wCAAmB,CAAC,CAAC,QAAQ,EAAE;IACrF,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}
+{"version":3,"file":"feedback-state.schema.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/feedback-state.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,8DAAiF;AACjF,2DAAkD;AAClD,iEAAwD;AAExD,+FAA+F;AAClF,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,OAAC,CAAC,UAAU,CAAC,qCAAc,CAAC,CAAC,QAAQ,EAAE;IAC/C,GAAG,EAAE,OAAC,CAAC,UAAU,CAAC,+BAAW,CAAC,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,wCAAmB,CAAC,CAAC,GAAG,CAAC,wCAAmB,CAAC,CAAC,QAAQ,EAAE;IACrF,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/build/v1/feedback/schemas/feedback-status.enum.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Что человек сделал с опросом — хранимый факт, который со временем сам не меняется.
+ * Что показывать прямо сейчас, говорит {@link FeedbackAsk}: он считается на чтении.
+ *
+ * DISMISSED — закрыл, не оценив; FILLED — оценка есть (комментарий опционален).
+ * Пока человек ничего не сделал, строки нет и статус — `null`.
+ */
 export declare enum FeedbackStatus {
     DISMISSED = "DISMISSED",
     FILLED = "FILLED"

package/build/v1/feedback/schemas/feedback-status.enum.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeedbackStatus = void 0;
+/**
+ * Что человек сделал с опросом — хранимый факт, который со временем сам не меняется.
+ * Что показывать прямо сейчас, говорит {@link FeedbackAsk}: он считается на чтении.
+ *
+ * DISMISSED — закрыл, не оценив; FILLED — оценка есть (комментарий опционален).
+ * Пока человек ничего не сделал, строки нет и статус — `null`.
+ */
 var FeedbackStatus;
 (function (FeedbackStatus) {
     FeedbackStatus["DISMISSED"] = "DISMISSED";

package/build/v1/feedback/schemas/feedback-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"feedback-status.enum.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/feedback-status.enum.ts"],"names":[],"mappings":";;;AAOA,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,yCAAuB,CAAA;IACvB,mCAAiB,CAAA;AACrB,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}
+{"version":3,"file":"feedback-status.enum.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/feedback-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,yCAAuB,CAAA;IACvB,mCAAiB,CAAA;AACrB,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}

package/build/v1/feedback/schemas/submit-feedback-request.schema.d.ts

@@ -1,5 +1,11 @@
 import { z } from 'zod';
 import { FeedbackAsk } from './feedback-ask.enum';
+/**
+ * Submit feedback request schema — либо ответ (оценка и/или комментарий), либо закрытие.
+ * `dismissed` — что именно человек закрыл (тот `ask`, который клиент рисовал): закрытие
+ * устаревшей вкладки, где ещё висят звёзды, не съедает попытку получить комментарий.
+ * Error messages: SubmitFeedbackRequest.{field}.{rule}
+ */
 export declare const SubmitFeedbackRequestSchema: z.ZodObject<{
     rating: z.ZodOptional<z.ZodNumber>;
     comment: z.ZodOptional<z.ZodString>;

package/build/v1/feedback/schemas/submit-feedback-request.schema.js

@@ -4,6 +4,12 @@ exports.SubmitFeedbackRequestSchema = void 0;
 const zod_1 = require("zod");
 const feedback_constants_1 = require("../feedback.constants");
 const feedback_ask_enum_1 = require("./feedback-ask.enum");
+/**
+ * Submit feedback request schema — либо ответ (оценка и/или комментарий), либо закрытие.
+ * `dismissed` — что именно человек закрыл (тот `ask`, который клиент рисовал): закрытие
+ * устаревшей вкладки, где ещё висят звёзды, не съедает попытку получить комментарий.
+ * Error messages: SubmitFeedbackRequest.{field}.{rule}
+ */
 exports.SubmitFeedbackRequestSchema = zod_1.z
     .object({
     rating: zod_1.z

package/build/v1/feedback/schemas/submit-feedback-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"submit-feedback-request.schema.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/submit-feedback-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,8DAK+B;AAC/B,2DAAkD;AAQrC,QAAA,2BAA2B,GAAG,OAAC;KACvC,MAAM,CAAC;IACJ,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;SACxD,GAAG,CAAC,wCAAmB,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACzE,GAAG,CAAC,wCAAmB,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACzE,QAAQ,EAAE;IACf,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;SAC1D,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SACxD,GAAG,CAAC,gDAA2B,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SAClF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,wDAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACjE,OAAO,EAAE,uCAAuC;KACnD,CAAC;SACD,QAAQ,EAAE;IACf,SAAS,EAAE,OAAC;SACP,UAAU,CAAC,+BAAW,EAAE,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;SAC7E,QAAQ,EAAE;CAClB,CAAC;KACD,MAAM,CACH,CAAC,IAAI,EAAE,EAAE,CACL,IAAI,CAAC,SAAS,KAAK,SAAS;IACxB,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;IACzD,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EACjE,EAAE,OAAO,EAAE,oCAAoC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CACpE,CAAC"}
+{"version":3,"file":"submit-feedback-request.schema.js","sourceRoot":"","sources":["../../../../v1/feedback/schemas/submit-feedback-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,8DAK+B;AAC/B,2DAAkD;AAElD;;;;;GAKG;AACU,QAAA,2BAA2B,GAAG,OAAC;KACvC,MAAM,CAAC;IACJ,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;SACxD,GAAG,CAAC,wCAAmB,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACzE,GAAG,CAAC,wCAAmB,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACzE,QAAQ,EAAE;IACf,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;SAC1D,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SACxD,GAAG,CAAC,gDAA2B,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;SAClF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,wDAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACjE,OAAO,EAAE,uCAAuC;KACnD,CAAC;SACD,QAAQ,EAAE;IACf,SAAS,EAAE,OAAC;SACP,UAAU,CAAC,+BAAW,EAAE,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;SAC7E,QAAQ,EAAE;CAClB,CAAC;KACD,MAAM,CACH,CAAC,IAAI,EAAE,EAAE,CACL,IAAI,CAAC,SAAS,KAAK,SAAS;IACxB,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;IACzD,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EACjE,EAAE,OAAO,EAAE,oCAAoC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CACpE,CAAC"}