@d19n/youfibre-odin-sdk 2.0.345 → 2.0.347

package/dist/entities-v2/FrustrationEvent.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * FrustrationEvent Entity Definition
+ *
+ * One row per Odin change that scored an Account: event type, when, weight and weight version, plus a pointer at the source record. Append-only; the timeline and audit trail behind a FrustrationScore. No free text, no personal data.
+ *
+ * @module SupportModule
+ * @entity FrustrationEvent
+ * @schemaId 1ee547d3-e74a-4b6b-9a11-a087cc2d1ce9
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ * Generated from Odin schema definition
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROUTING_KEY_LINK_FRUSTRATION_EVENT_FRUSTRATION_SCORE_DELETED = exports.ROUTING_KEY_LINK_FRUSTRATION_EVENT_FRUSTRATION_SCORE_CREATED = exports.ROUTING_KEY_LINK_FRUSTRATION_EVENT_ACCOUNT_DELETED = exports.ROUTING_KEY_LINK_FRUSTRATION_EVENT_ACCOUNT_CREATED = exports.ROUTING_KEY_FRUSTRATION_EVENT_DEFAULT_DELETED = exports.ROUTING_KEY_FRUSTRATION_EVENT_DEFAULT_UPDATED = exports.ROUTING_KEY_FRUSTRATION_EVENT_DEFAULT_CREATED = exports.ROUTING_KEY_FRUSTRATION_EVENT_DELETED = exports.ROUTING_KEY_FRUSTRATION_EVENT_UPDATED = exports.ROUTING_KEY_FRUSTRATION_EVENT_CREATED = exports.FrustrationEvent = exports.FrustrationEventPropertyKeys = exports.FrustrationEventOrigin = exports.FrustrationEventEventType = exports.FrustrationEventEntityTypes = void 0;
+const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * Available types for FrustrationEvent records
+ */
+var FrustrationEventEntityTypes;
+(function (FrustrationEventEntityTypes) {
+    /** This is the default record type */
+    FrustrationEventEntityTypes["DEFAULT"] = "DEFAULT";
+})(FrustrationEventEntityTypes = exports.FrustrationEventEntityTypes || (exports.FrustrationEventEntityTypes = {}));
+/**
+ * Valid values for FrustrationEvent.EventType
+ *
+ * Which catalogue event this is, E01-E30 (business-processes/frustration-score/04-odin-event-mapping.md).
+ *
+ * @remarks Available options:
+ * - `E01` - E01 Customer opened live chat
+ * - `E02` - E02 Second chat within 48h
+ * - `E03` - E03 Complaint created
+ * - `E04` - E04 Complaint escalated
+ * - `E05` - E05 Engineer visit booked
+ * - `E06` - E06 Engineer visit cancelled
+ * - `E07` - E07 Engineer visit missed
+ * - `E08` - E08 Engineer arrived late
+ * - `E09` - E09 Engineer revisit required
+ * - `E10` - E10 Network outage started
+ * - `E11` - E11 Network outage resolved
+ * - `E12` - E12 Router offline over 24h
+ * - `E13` - E13 ONT offline
+ * - `E14` - E14 Payment failed
+ * - `E15` - E15 Payment overdue
+ * - ... and 15 more
+ */
+var FrustrationEventEventType;
+(function (FrustrationEventEventType) {
+    FrustrationEventEventType["E01_CUSTOMER_OPENED_LIVE_CHAT"] = "E01";
+    FrustrationEventEventType["E02_SECOND_CHAT_WITHIN_48H"] = "E02";
+    FrustrationEventEventType["E03_COMPLAINT_CREATED"] = "E03";
+    FrustrationEventEventType["E04_COMPLAINT_ESCALATED"] = "E04";
+    FrustrationEventEventType["E05_ENGINEER_VISIT_BOOKED"] = "E05";
+    FrustrationEventEventType["E06_ENGINEER_VISIT_CANCELLED"] = "E06";
+    FrustrationEventEventType["E07_ENGINEER_VISIT_MISSED"] = "E07";
+    FrustrationEventEventType["E08_ENGINEER_ARRIVED_LATE"] = "E08";
+    FrustrationEventEventType["E09_ENGINEER_REVISIT_REQUIRED"] = "E09";
+    FrustrationEventEventType["E10_NETWORK_OUTAGE_STARTED"] = "E10";
+    FrustrationEventEventType["E11_NETWORK_OUTAGE_RESOLVED"] = "E11";
+    FrustrationEventEventType["E12_ROUTER_OFFLINE_OVER_24H"] = "E12";
+    FrustrationEventEventType["E13_ONT_OFFLINE"] = "E13";
+    FrustrationEventEventType["E14_PAYMENT_FAILED"] = "E14";
+    FrustrationEventEventType["E15_PAYMENT_OVERDUE"] = "E15";
+    FrustrationEventEventType["E16_DIRECT_DEBIT_FAILED"] = "E16";
+    FrustrationEventEventType["E17_SPEED_TEST_BELOW_EXPECTED"] = "E17";
+    FrustrationEventEventType["E18_PACKAGE_DOWNGRADED"] = "E18";
+    FrustrationEventEventType["E19_PACKAGE_UPGRADED"] = "E19";
+    FrustrationEventEventType["E20_NEGATIVE_CSAT_SURVEY"] = "E20";
+    FrustrationEventEventType["E21_POSITIVE_CSAT_SURVEY"] = "E21";
+    FrustrationEventEventType["E22_TRUSTPILOT_REVIEW"] = "E22";
+    FrustrationEventEventType["E23_BILLING_ADJUSTMENT"] = "E23";
+    FrustrationEventEventType["E24_REFUND_ISSUED"] = "E24";
+    FrustrationEventEventType["E25_REFERRAL_COMPLETED"] = "E25";
+    FrustrationEventEventType["E26_COMPLAINT_RESOLVED"] = "E26";
+    FrustrationEventEventType["E27_SUPPORT_TICKET_CLOSED"] = "E27";
+    FrustrationEventEventType["E28_CUSTOMER_INACTIVE"] = "E28";
+    FrustrationEventEventType["E29_CUSTOMER_USING_APP_REGULARLY"] = "E29";
+    FrustrationEventEventType["E30_NO_ISSUES_FOR_30_DAYS"] = "E30";
+})(FrustrationEventEventType = exports.FrustrationEventEventType || (exports.FrustrationEventEventType = {}));
+/**
+ * Valid values for FrustrationEvent.Origin
+ *
+ * SYSTEM when an RMQ consumer mapped an Odin change; MANUAL when a Team Leader recorded it (AddFrustrationEvent).
+ *
+ * @remarks Available options:
+ * - `MANUAL` - Manual
+ * - `SYSTEM` - System
+ */
+var FrustrationEventOrigin;
+(function (FrustrationEventOrigin) {
+    FrustrationEventOrigin["MANUAL"] = "MANUAL";
+    FrustrationEventOrigin["SYSTEM"] = "SYSTEM";
+})(FrustrationEventOrigin = exports.FrustrationEventOrigin || (exports.FrustrationEventOrigin = {}));
+/**
+ * Property keys for FrustrationEvent
+ * Use these constants instead of string literals for type safety
+ */
+var FrustrationEventPropertyKeys;
+(function (FrustrationEventPropertyKeys) {
+    /** Which catalogue event this is, E01-E30 (business-processes/frustration-score/04-odin-event-mapping.md). */
+    FrustrationEventPropertyKeys["EventType"] = "EventType";
+    /** When the source change happened, from the source record, not when the event was ingested. Decay is measured from here; older than 60 days contributes nothing. */
+    FrustrationEventPropertyKeys["OccurredAt"] = "OccurredAt";
+    /** The points applied when this event was scored, before decay. Negative for positive events. Kept on the row so a later weight change does not rewrite history. */
+    FrustrationEventPropertyKeys["Weight"] = "Weight";
+    /** The Config version the Weight came from. */
+    FrustrationEventPropertyKeys["WeightVersion"] = "WeightVersion";
+    /** The source record type as Module:Entity, e.g. SupportModule:Case. Text so a new source needs no schema change. */
+    FrustrationEventPropertyKeys["SourceEntity"] = "SourceEntity";
+    /** The source record uuid. */
+    FrustrationEventPropertyKeys["SourceRecordId"] = "SourceRecordId";
+    /** The source record number an agent can open, e.g. CS123456 or WO98765. */
+    FrustrationEventPropertyKeys["SourceRecordNumber"] = "SourceRecordNumber";
+    /** Source record id + the transition or field that changed. UNIQUE, so the same Odin change redelivered by RabbitMQ or replayed by a backfill cannot score twice. */
+    FrustrationEventPropertyKeys["IdempotencyKey"] = "IdempotencyKey";
+    /** SYSTEM when an RMQ consumer mapped an Odin change; MANUAL when a Team Leader recorded it (AddFrustrationEvent). */
+    FrustrationEventPropertyKeys["Origin"] = "Origin";
+})(FrustrationEventPropertyKeys = exports.FrustrationEventPropertyKeys || (exports.FrustrationEventPropertyKeys = {}));
+/**
+ * FrustrationEvent entity from SupportModule
+ *
+ * One row per Odin change that scored an Account: event type, when, weight and weight version, plus a pointer at the source record. Append-only; the timeline and audit trail behind a FrustrationScore. No free text, no personal data.
+ *
+ * @module SupportModule
+ * @entity FrustrationEvent
+ * @schemaId 1ee547d3-e74a-4b6b-9a11-a087cc2d1ce9
+ * @recordPrefix CFE
+ * @capabilities searchable, updateable, undeletable, triggerable
+ */
+class FrustrationEvent extends core_1.OdinRecord {
+}
+exports.FrustrationEvent = FrustrationEvent;
+// ============================================
+// RABBITMQ EVENT ROUTING KEYS
+// ============================================
+/**
+ * RabbitMQ routing keys for FrustrationEvent events
+ */
+exports.ROUTING_KEY_FRUSTRATION_EVENT_CREATED = 'SupportModule.FrustrationEvent.SubDbRecordCreated';
+exports.ROUTING_KEY_FRUSTRATION_EVENT_UPDATED = 'SupportModule.FrustrationEvent.SubDbRecordUpdated';
+exports.ROUTING_KEY_FRUSTRATION_EVENT_DELETED = 'SupportModule.FrustrationEvent.SubDbRecordDeleted';
+/**
+ * Type-specific routing keys for FrustrationEvent events
+ * Subscribe to these for events on specific entity types only
+ */
+/** This is the default record type created */
+exports.ROUTING_KEY_FRUSTRATION_EVENT_DEFAULT_CREATED = 'SupportModule.FrustrationEvent.DEFAULT.SubDbRecordCreated';
+/** This is the default record type updated */
+exports.ROUTING_KEY_FRUSTRATION_EVENT_DEFAULT_UPDATED = 'SupportModule.FrustrationEvent.DEFAULT.SubDbRecordUpdated';
+/** This is the default record type deleted */
+exports.ROUTING_KEY_FRUSTRATION_EVENT_DEFAULT_DELETED = 'SupportModule.FrustrationEvent.DEFAULT.SubDbRecordDeleted';
+/** Event: FrustrationEvent__Account link created */
+exports.ROUTING_KEY_LINK_FRUSTRATION_EVENT_ACCOUNT_CREATED = 'SupportModule.FrustrationEvent.Account.SubDbRecordAssociationCreated';
+/** Event: FrustrationEvent__Account link deleted */
+exports.ROUTING_KEY_LINK_FRUSTRATION_EVENT_ACCOUNT_DELETED = 'SupportModule.FrustrationEvent.Account.SubDbRecordAssociationDeleted';
+/** Event: FrustrationEvent__FrustrationScore link created */
+exports.ROUTING_KEY_LINK_FRUSTRATION_EVENT_FRUSTRATION_SCORE_CREATED = 'SupportModule.FrustrationEvent.FrustrationScore.SubDbRecordAssociationCreated';
+/** Event: FrustrationEvent__FrustrationScore link deleted */
+exports.ROUTING_KEY_LINK_FRUSTRATION_EVENT_FRUSTRATION_SCORE_DELETED = 'SupportModule.FrustrationEvent.FrustrationScore.SubDbRecordAssociationDeleted';

package/dist/entities-v2/FrustrationScore.d.ts

@@ -0,0 +1,171 @@
+/**
+ * FrustrationScore Entity Definition
+ *
+ * One frustration score (0-100) per Account, recalculated from FrustrationEvents. The pipeline stage is the risk band (Green to Critical). Create upserts on AccountId. Holds Odin identifiers and numbers only, never personal data.
+ *
+ * @module SupportModule
+ * @entity FrustrationScore
+ * @schemaId 26ffc771-d268-48c8-b6eb-1231c418ad4f
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ * Generated from Odin schema definition
+ */
+import { OdinRecord, OdinLink, LinkedOdinRecord } from '@d19n/odin-types/dist/core';
+import { AccountProperties } from './Account';
+import { ContactProperties } from './Contact';
+import { CaseProperties } from './Case';
+import { FrustrationEventProperties } from './FrustrationEvent';
+/**
+ * Available types for FrustrationScore records
+ */
+export declare enum FrustrationScoreEntityTypes {
+    /** This is the default record type */
+    DEFAULT = "DEFAULT"
+}
+/**
+ * Pipeline stage names for DEFAULT FrustrationScore
+ * Pipeline: FrustrationScore
+ * The risk band the score maps to, Green through Critical. Entering Red or Critical raises outreach.
+ */
+export declare enum DefaultFrustrationScoreStageNames {
+    /** Score 0-25. The resting state; a new record starts here at 0. No action. (default) */
+    Green = "Green",
+    /** Score 26-50. Something has gone wrong recently. Dashboard and Case column only; no Case. */
+    Yellow = "Yellow",
+    /** Score 51-75. Repeated or serious problems. Team Leader visibility; delivery is an open decision. */
+    Orange = "Orange",
+    /** Score 76-90. Likely to complain, review badly or leave. Entry raises a proactive-outreach Case, Sla HIGH. */
+    Red = "Red",
+    /** Score 91-100. Immediate proactive contact. Same outreach Case as Red with Sla URGENT. */
+    Critical = "Critical"
+}
+/**
+ * Pipeline stage keys for DEFAULT FrustrationScore
+ * Use these keys when transitioning between stages
+ */
+export declare enum DefaultFrustrationScoreStageKeys {
+    /** Score 0-25. The resting state; a new record starts here at 0. No action. */
+    FrustrationScoreStageGreen = "FrustrationScoreStageGreen",
+    /** Score 26-50. Something has gone wrong recently. Dashboard and Case column only; no Case. */
+    FrustrationScoreStageYellow = "FrustrationScoreStageYellow",
+    /** Score 51-75. Repeated or serious problems. Team Leader visibility; delivery is an open decision. */
+    FrustrationScoreStageOrange = "FrustrationScoreStageOrange",
+    /** Score 76-90. Likely to complain, review badly or leave. Entry raises a proactive-outreach Case, Sla HIGH. */
+    FrustrationScoreStageRed = "FrustrationScoreStageRed",
+    /** Score 91-100. Immediate proactive contact. Same outreach Case as Red with Sla URGENT. */
+    FrustrationScoreStageCritical = "FrustrationScoreStageCritical"
+}
+/**
+ * Property keys for FrustrationScore
+ * Use these constants instead of string literals for type safety
+ */
+export declare enum FrustrationScorePropertyKeys {
+    /** The Account this score belongs to. UNIQUE, and what upsertOnCreate hashes, so a second create for the same Account updates the existing record instead of adding one. */
+    AccountId = "AccountId",
+    /** 0-100, the sum of decayed event contributions floored at 0 and clamped to 100. Kept to two decimals; the band is decided on the half-up rounded value with 3 points of hysteresis. */
+    Score = "Score",
+    /** The CustomerFrustrationScore Config version the last recalculation used. Weights are tuned in the first months; without this a score from last month cannot be explained against this month's weights. */
+    WeightVersion = "WeightVersion",
+    /** JSON: { weightVersion, lines: [{ eventType, sourceRecordNumber, occurredAt, weight, decay, contribution }] }. The explanation an agent reads out; contributions sum to Score. Record numbers only, never free text. Size-capped by the platform, see the spec header. */
+    Breakdown = "Breakdown",
+    /** OccurredAt of the newest FrustrationEvent that contributed. Empty while no event has scored. */
+    LastEventAt = "LastEventAt",
+    /** When Score and Breakdown were last written, by an event or by the nightly decay run. */
+    CalculatedAt = "CalculatedAt"
+}
+/**
+ * Properties for FrustrationScore records
+ *
+ * @see SupportModule:FrustrationScore
+ */
+export interface FrustrationScoreProperties {
+    /** The Account this score belongs to. UNIQUE, and what upsertOnCreate hashes, so a second create for the same Account updates the existing record instead of adding one.
+     *
+     * @type {LOOKUP}
+     * @default
+     */
+    AccountId: string;
+    /** 0-100, the sum of decayed event contributions floored at 0 and clamped to 100. Kept to two decimals; the band is decided on the half-up rounded value with 3 points of hysteresis.
+     *
+     * @type {NUMBER}
+     * @default
+     */
+    Score: number;
+    /** The CustomerFrustrationScore Config version the last recalculation used. Weights are tuned in the first months; without this a score from last month cannot be explained against this month's weights.
+     *
+     * @type {TEXT}
+     * @default
+     */
+    WeightVersion: string;
+    /** JSON: { weightVersion, lines: [{ eventType, sourceRecordNumber, occurredAt, weight, decay, contribution }] }. The explanation an agent reads out; contributions sum to Score. Record numbers only, never free text. Size-capped by the platform, see the spec header.
+     *
+     * @type {TEXT_LONG}
+     * @default
+     */
+    Breakdown: string;
+    /** OccurredAt of the newest FrustrationEvent that contributed. Empty while no event has scored.
+     *
+     * @type {DATE_TIME}
+     * @default
+     */
+    LastEventAt: string;
+    /** When Score and Breakdown were last written, by an event or by the nightly decay run.
+     *
+     * @type {DATE_TIME}
+     * @default
+     */
+    CalculatedAt: string;
+}
+/**
+ * FrustrationScore entity from SupportModule
+ *
+ * One frustration score (0-100) per Account, recalculated from FrustrationEvents. The pipeline stage is the risk band (Green to Critical). Create upserts on AccountId. Holds Odin identifiers and numbers only, never personal data.
+ *
+ * @module SupportModule
+ * @entity FrustrationScore
+ * @schemaId 26ffc771-d268-48c8-b6eb-1231c418ad4f
+ * @recordPrefix CFS
+ * @capabilities searchable, updateable, undeletable, triggerable
+ */
+export declare class FrustrationScore extends OdinRecord<FrustrationScoreProperties> {
+    entity: 'SupportModule:FrustrationScore';
+    type: FrustrationScoreEntityTypes;
+    schemaId: '26ffc771-d268-48c8-b6eb-1231c418ad4f';
+    properties: FrustrationScoreProperties;
+    /** Linked Account records (FrustrationScore__Account) */
+    Account: OdinLink<LinkedOdinRecord<AccountProperties>>;
+    /** Linked Contact records (FrustrationScore__Contact) */
+    Contact: OdinLink<LinkedOdinRecord<ContactProperties>>;
+    /** Linked Case records (FrustrationScore__Case) */
+    Case: OdinLink<LinkedOdinRecord<CaseProperties>>;
+    /** Linked FrustrationEvent records (FrustrationEvent__FrustrationScore) */
+    FrustrationEvent: OdinLink<LinkedOdinRecord<FrustrationEventProperties>>;
+}
+/**
+ * RabbitMQ routing keys for FrustrationScore events
+ */
+export declare const ROUTING_KEY_FRUSTRATION_SCORE_CREATED = "SupportModule.FrustrationScore.SubDbRecordCreated";
+export declare const ROUTING_KEY_FRUSTRATION_SCORE_UPDATED = "SupportModule.FrustrationScore.SubDbRecordUpdated";
+export declare const ROUTING_KEY_FRUSTRATION_SCORE_DELETED = "SupportModule.FrustrationScore.SubDbRecordDeleted";
+/**
+ * Type-specific routing keys for FrustrationScore events
+ * Subscribe to these for events on specific entity types only
+ */
+/** This is the default record type created */
+export declare const ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_CREATED = "SupportModule.FrustrationScore.DEFAULT.SubDbRecordCreated";
+/** This is the default record type updated */
+export declare const ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_UPDATED = "SupportModule.FrustrationScore.DEFAULT.SubDbRecordUpdated";
+/** This is the default record type deleted */
+export declare const ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_DELETED = "SupportModule.FrustrationScore.DEFAULT.SubDbRecordDeleted";
+/** Event: FrustrationScore__Account link created */
+export declare const ROUTING_KEY_LINK_FRUSTRATION_SCORE_ACCOUNT_CREATED = "SupportModule.FrustrationScore.Account.SubDbRecordAssociationCreated";
+/** Event: FrustrationScore__Account link deleted */
+export declare const ROUTING_KEY_LINK_FRUSTRATION_SCORE_ACCOUNT_DELETED = "SupportModule.FrustrationScore.Account.SubDbRecordAssociationDeleted";
+/** Event: FrustrationScore__Contact link created */
+export declare const ROUTING_KEY_LINK_FRUSTRATION_SCORE_CONTACT_CREATED = "SupportModule.FrustrationScore.Contact.SubDbRecordAssociationCreated";
+/** Event: FrustrationScore__Contact link deleted */
+export declare const ROUTING_KEY_LINK_FRUSTRATION_SCORE_CONTACT_DELETED = "SupportModule.FrustrationScore.Contact.SubDbRecordAssociationDeleted";
+/** Event: FrustrationScore__Case link created */
+export declare const ROUTING_KEY_LINK_FRUSTRATION_SCORE_CASE_CREATED = "SupportModule.FrustrationScore.Case.SubDbRecordAssociationCreated";
+/** Event: FrustrationScore__Case link deleted */
+export declare const ROUTING_KEY_LINK_FRUSTRATION_SCORE_CASE_DELETED = "SupportModule.FrustrationScore.Case.SubDbRecordAssociationDeleted";

package/dist/entities-v2/FrustrationScore.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * FrustrationScore Entity Definition
+ *
+ * One frustration score (0-100) per Account, recalculated from FrustrationEvents. The pipeline stage is the risk band (Green to Critical). Create upserts on AccountId. Holds Odin identifiers and numbers only, never personal data.
+ *
+ * @module SupportModule
+ * @entity FrustrationScore
+ * @schemaId 26ffc771-d268-48c8-b6eb-1231c418ad4f
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ * Generated from Odin schema definition
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_CASE_DELETED = exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_CASE_CREATED = exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_CONTACT_DELETED = exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_CONTACT_CREATED = exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_ACCOUNT_DELETED = exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_ACCOUNT_CREATED = exports.ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_DELETED = exports.ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_UPDATED = exports.ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_CREATED = exports.ROUTING_KEY_FRUSTRATION_SCORE_DELETED = exports.ROUTING_KEY_FRUSTRATION_SCORE_UPDATED = exports.ROUTING_KEY_FRUSTRATION_SCORE_CREATED = exports.FrustrationScore = exports.FrustrationScorePropertyKeys = exports.DefaultFrustrationScoreStageKeys = exports.DefaultFrustrationScoreStageNames = exports.FrustrationScoreEntityTypes = void 0;
+const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * Available types for FrustrationScore records
+ */
+var FrustrationScoreEntityTypes;
+(function (FrustrationScoreEntityTypes) {
+    /** This is the default record type */
+    FrustrationScoreEntityTypes["DEFAULT"] = "DEFAULT";
+})(FrustrationScoreEntityTypes = exports.FrustrationScoreEntityTypes || (exports.FrustrationScoreEntityTypes = {}));
+/**
+ * Pipeline stage names for DEFAULT FrustrationScore
+ * Pipeline: FrustrationScore
+ * The risk band the score maps to, Green through Critical. Entering Red or Critical raises outreach.
+ */
+var DefaultFrustrationScoreStageNames;
+(function (DefaultFrustrationScoreStageNames) {
+    /** Score 0-25. The resting state; a new record starts here at 0. No action. (default) */
+    DefaultFrustrationScoreStageNames["Green"] = "Green";
+    /** Score 26-50. Something has gone wrong recently. Dashboard and Case column only; no Case. */
+    DefaultFrustrationScoreStageNames["Yellow"] = "Yellow";
+    /** Score 51-75. Repeated or serious problems. Team Leader visibility; delivery is an open decision. */
+    DefaultFrustrationScoreStageNames["Orange"] = "Orange";
+    /** Score 76-90. Likely to complain, review badly or leave. Entry raises a proactive-outreach Case, Sla HIGH. */
+    DefaultFrustrationScoreStageNames["Red"] = "Red";
+    /** Score 91-100. Immediate proactive contact. Same outreach Case as Red with Sla URGENT. */
+    DefaultFrustrationScoreStageNames["Critical"] = "Critical";
+})(DefaultFrustrationScoreStageNames = exports.DefaultFrustrationScoreStageNames || (exports.DefaultFrustrationScoreStageNames = {}));
+/**
+ * Pipeline stage keys for DEFAULT FrustrationScore
+ * Use these keys when transitioning between stages
+ */
+var DefaultFrustrationScoreStageKeys;
+(function (DefaultFrustrationScoreStageKeys) {
+    /** Score 0-25. The resting state; a new record starts here at 0. No action. */
+    DefaultFrustrationScoreStageKeys["FrustrationScoreStageGreen"] = "FrustrationScoreStageGreen";
+    /** Score 26-50. Something has gone wrong recently. Dashboard and Case column only; no Case. */
+    DefaultFrustrationScoreStageKeys["FrustrationScoreStageYellow"] = "FrustrationScoreStageYellow";
+    /** Score 51-75. Repeated or serious problems. Team Leader visibility; delivery is an open decision. */
+    DefaultFrustrationScoreStageKeys["FrustrationScoreStageOrange"] = "FrustrationScoreStageOrange";
+    /** Score 76-90. Likely to complain, review badly or leave. Entry raises a proactive-outreach Case, Sla HIGH. */
+    DefaultFrustrationScoreStageKeys["FrustrationScoreStageRed"] = "FrustrationScoreStageRed";
+    /** Score 91-100. Immediate proactive contact. Same outreach Case as Red with Sla URGENT. */
+    DefaultFrustrationScoreStageKeys["FrustrationScoreStageCritical"] = "FrustrationScoreStageCritical";
+})(DefaultFrustrationScoreStageKeys = exports.DefaultFrustrationScoreStageKeys || (exports.DefaultFrustrationScoreStageKeys = {}));
+/**
+ * Property keys for FrustrationScore
+ * Use these constants instead of string literals for type safety
+ */
+var FrustrationScorePropertyKeys;
+(function (FrustrationScorePropertyKeys) {
+    /** The Account this score belongs to. UNIQUE, and what upsertOnCreate hashes, so a second create for the same Account updates the existing record instead of adding one. */
+    FrustrationScorePropertyKeys["AccountId"] = "AccountId";
+    /** 0-100, the sum of decayed event contributions floored at 0 and clamped to 100. Kept to two decimals; the band is decided on the half-up rounded value with 3 points of hysteresis. */
+    FrustrationScorePropertyKeys["Score"] = "Score";
+    /** The CustomerFrustrationScore Config version the last recalculation used. Weights are tuned in the first months; without this a score from last month cannot be explained against this month's weights. */
+    FrustrationScorePropertyKeys["WeightVersion"] = "WeightVersion";
+    /** JSON: { weightVersion, lines: [{ eventType, sourceRecordNumber, occurredAt, weight, decay, contribution }] }. The explanation an agent reads out; contributions sum to Score. Record numbers only, never free text. Size-capped by the platform, see the spec header. */
+    FrustrationScorePropertyKeys["Breakdown"] = "Breakdown";
+    /** OccurredAt of the newest FrustrationEvent that contributed. Empty while no event has scored. */
+    FrustrationScorePropertyKeys["LastEventAt"] = "LastEventAt";
+    /** When Score and Breakdown were last written, by an event or by the nightly decay run. */
+    FrustrationScorePropertyKeys["CalculatedAt"] = "CalculatedAt";
+})(FrustrationScorePropertyKeys = exports.FrustrationScorePropertyKeys || (exports.FrustrationScorePropertyKeys = {}));
+/**
+ * FrustrationScore entity from SupportModule
+ *
+ * One frustration score (0-100) per Account, recalculated from FrustrationEvents. The pipeline stage is the risk band (Green to Critical). Create upserts on AccountId. Holds Odin identifiers and numbers only, never personal data.
+ *
+ * @module SupportModule
+ * @entity FrustrationScore
+ * @schemaId 26ffc771-d268-48c8-b6eb-1231c418ad4f
+ * @recordPrefix CFS
+ * @capabilities searchable, updateable, undeletable, triggerable
+ */
+class FrustrationScore extends core_1.OdinRecord {
+}
+exports.FrustrationScore = FrustrationScore;
+// ============================================
+// RABBITMQ EVENT ROUTING KEYS
+// ============================================
+/**
+ * RabbitMQ routing keys for FrustrationScore events
+ */
+exports.ROUTING_KEY_FRUSTRATION_SCORE_CREATED = 'SupportModule.FrustrationScore.SubDbRecordCreated';
+exports.ROUTING_KEY_FRUSTRATION_SCORE_UPDATED = 'SupportModule.FrustrationScore.SubDbRecordUpdated';
+exports.ROUTING_KEY_FRUSTRATION_SCORE_DELETED = 'SupportModule.FrustrationScore.SubDbRecordDeleted';
+/**
+ * Type-specific routing keys for FrustrationScore events
+ * Subscribe to these for events on specific entity types only
+ */
+/** This is the default record type created */
+exports.ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_CREATED = 'SupportModule.FrustrationScore.DEFAULT.SubDbRecordCreated';
+/** This is the default record type updated */
+exports.ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_UPDATED = 'SupportModule.FrustrationScore.DEFAULT.SubDbRecordUpdated';
+/** This is the default record type deleted */
+exports.ROUTING_KEY_FRUSTRATION_SCORE_DEFAULT_DELETED = 'SupportModule.FrustrationScore.DEFAULT.SubDbRecordDeleted';
+/** Event: FrustrationScore__Account link created */
+exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_ACCOUNT_CREATED = 'SupportModule.FrustrationScore.Account.SubDbRecordAssociationCreated';
+/** Event: FrustrationScore__Account link deleted */
+exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_ACCOUNT_DELETED = 'SupportModule.FrustrationScore.Account.SubDbRecordAssociationDeleted';
+/** Event: FrustrationScore__Contact link created */
+exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_CONTACT_CREATED = 'SupportModule.FrustrationScore.Contact.SubDbRecordAssociationCreated';
+/** Event: FrustrationScore__Contact link deleted */
+exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_CONTACT_DELETED = 'SupportModule.FrustrationScore.Contact.SubDbRecordAssociationDeleted';
+/** Event: FrustrationScore__Case link created */
+exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_CASE_CREATED = 'SupportModule.FrustrationScore.Case.SubDbRecordAssociationCreated';
+/** Event: FrustrationScore__Case link deleted */
+exports.ROUTING_KEY_LINK_FRUSTRATION_SCORE_CASE_DELETED = 'SupportModule.FrustrationScore.Case.SubDbRecordAssociationDeleted';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d19n/youfibre-odin-sdk",
-  "version": "2.0.345",
+  "version": "2.0.347",
   "description": "",
   "author": "@d19n",
   "license": "UNLICENSED",