@futdevpro/ccap 1.1.2881 → 1.1.2933

package/server/build/src/_modules/external-sessions/_modules/claude-code/_enums/cc-status.enum.d.ts

@@ -2,16 +2,23 @@
  * Claude Code session állapotgép (state machine).
  * Lehetséges átmenetek:
  *   creating → starting → running ↔ waiting_input
- *   running → completed | errored | terminated | stalled
- *   waiting_input → running | errored | terminated | stalled
+ *   running → completed | errored | terminated | stalled | blocked
+ *   waiting_input → running | errored | terminated | stalled | blocked
  *   stalled → running (bármely új event érkezésére) | terminated
  *   errored → terminated
  *   completed → running (resume)
+ *   blocked → running (rate-limit reset → auto-trigger 'continue' prompt) | terminated
  *
  * A `stalled` nem-terminál állapot: a REQ-CC-STATUS-001 időalapú korrektor
  * állítja be, amikor egy `running`/`waiting-input` session-ből 5-10 percig
  * egyetlen új event sem érkezik. Új event érkezésekor automatikusan visszavált
  * `running`-ra (lásd `CC_Monitoring_ControlService.updateActivity`).
+ *
+ * A `blocked` nem-terminál állapot: a REQ-CC-BLOCKED-USAGE-LIMIT-001 (cycle 812)
+ * Usage Limit Error / rate-limit-reached eseményre állítja be. A reset időpontig
+ * minden új user-üzenet queue-ba kerül, scheduled trigger-ek skippelnek.
+ * Reset után automatikus „continue" prompt indítja újra a session-t (NEM a
+ * queued üzenettel, hanem külön continue-vel — utána a queue-drain kézbesít).
  */
 export declare enum CC_Status_Type {
     /** Session objektum létrejött, CLI process még nem indult. */
@@ -24,6 +31,12 @@ export declare enum CC_Status_Type {
     waitingInput = "waiting-input",
     /** Timeout-alapú korrektor megállítottnak jelzi — nincs új event N percig; új event → running. */
     stalled = "stalled",
+    /**
+     * REQ-CC-BLOCKED-USAGE-LIMIT-001 (cycle 812): Usage Limit / rate-limit miatt
+     * blokkolt — a reset időpontig nem fogadhat input-ot. Auto-resume a reset-kor
+     * `continue` prompt-tal, utána queue-drain.
+     */
+    blocked = "blocked",
     /** Hiba történt, de session recoverable. */
     errored = "errored",
     /** CLI process normálisan lezárult. */

package/server/build/src/_modules/external-sessions/_modules/claude-code/_enums/cc-status.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cc-status.enum.d.ts","sourceRoot":"","sources":["../../../../../../../src/_modules/external-sessions/_modules/claude-code/_enums/cc-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,oBAAY,cAAc;IACxB,8DAA8D;IAC9D,QAAQ,aAAa;IACrB,yDAAyD;IACzD,QAAQ,aAAa;IACrB,wDAAwD;IACxD,OAAO,YAAY;IACnB,qCAAqC;IACrC,YAAY,kBAAkB;IAC9B,kGAAkG;IAClG,OAAO,YAAY;IACnB,4CAA4C;IAC5C,OAAO,YAAY;IACnB,uCAAuC;IACvC,SAAS,cAAc;IACvB,mCAAmC;IACnC,UAAU,eAAe;CAC1B"}
+{"version":3,"file":"cc-status.enum.d.ts","sourceRoot":"","sources":["../../../../../../../src/_modules/external-sessions/_modules/claude-code/_enums/cc-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,oBAAY,cAAc;IACxB,8DAA8D;IAC9D,QAAQ,aAAa;IACrB,yDAAyD;IACzD,QAAQ,aAAa;IACrB,wDAAwD;IACxD,OAAO,YAAY;IACnB,qCAAqC;IACrC,YAAY,kBAAkB;IAC9B,kGAAkG;IAClG,OAAO,YAAY;IACnB;;;;OAIG;IACH,OAAO,YAAY;IACnB,4CAA4C;IAC5C,OAAO,YAAY;IACnB,uCAAuC;IACvC,SAAS,cAAc;IACvB,mCAAmC;IACnC,UAAU,eAAe;CAC1B"}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_enums/cc-status.enum.js

@@ -5,16 +5,23 @@ exports.CC_Status_Type = void 0;
  * Claude Code session állapotgép (state machine).
  * Lehetséges átmenetek:
  *   creating → starting → running ↔ waiting_input
- *   running → completed | errored | terminated | stalled
- *   waiting_input → running | errored | terminated | stalled
+ *   running → completed | errored | terminated | stalled | blocked
+ *   waiting_input → running | errored | terminated | stalled | blocked
  *   stalled → running (bármely új event érkezésére) | terminated
  *   errored → terminated
  *   completed → running (resume)
+ *   blocked → running (rate-limit reset → auto-trigger 'continue' prompt) | terminated
  *
  * A `stalled` nem-terminál állapot: a REQ-CC-STATUS-001 időalapú korrektor
  * állítja be, amikor egy `running`/`waiting-input` session-ből 5-10 percig
  * egyetlen új event sem érkezik. Új event érkezésekor automatikusan visszavált
  * `running`-ra (lásd `CC_Monitoring_ControlService.updateActivity`).
+ *
+ * A `blocked` nem-terminál állapot: a REQ-CC-BLOCKED-USAGE-LIMIT-001 (cycle 812)
+ * Usage Limit Error / rate-limit-reached eseményre állítja be. A reset időpontig
+ * minden új user-üzenet queue-ba kerül, scheduled trigger-ek skippelnek.
+ * Reset után automatikus „continue" prompt indítja újra a session-t (NEM a
+ * queued üzenettel, hanem külön continue-vel — utána a queue-drain kézbesít).
  */
 var CC_Status_Type;
 (function (CC_Status_Type) {
@@ -28,6 +35,12 @@ var CC_Status_Type;
     CC_Status_Type["waitingInput"] = "waiting-input";
     /** Timeout-alapú korrektor megállítottnak jelzi — nincs új event N percig; új event → running. */
     CC_Status_Type["stalled"] = "stalled";
+    /**
+     * REQ-CC-BLOCKED-USAGE-LIMIT-001 (cycle 812): Usage Limit / rate-limit miatt
+     * blokkolt — a reset időpontig nem fogadhat input-ot. Auto-resume a reset-kor
+     * `continue` prompt-tal, utána queue-drain.
+     */
+    CC_Status_Type["blocked"] = "blocked";
     /** Hiba történt, de session recoverable. */
     CC_Status_Type["errored"] = "errored";
     /** CLI process normálisan lezárult. */

package/server/build/src/_modules/external-sessions/_modules/claude-code/_enums/cc-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"cc-status.enum.js","sourceRoot":"","sources":["../../../../../../../src/_modules/external-sessions/_modules/claude-code/_enums/cc-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;GAcG;AACH,IAAY,cAiBX;AAjBD,WAAY,cAAc;IACxB,8DAA8D;IAC9D,uCAAqB,CAAA;IACrB,yDAAyD;IACzD,uCAAqB,CAAA;IACrB,wDAAwD;IACxD,qCAAmB,CAAA;IACnB,qCAAqC;IACrC,gDAA8B,CAAA;IAC9B,kGAAkG;IAClG,qCAAmB,CAAA;IACnB,4CAA4C;IAC5C,qCAAmB,CAAA;IACnB,uCAAuC;IACvC,yCAAuB,CAAA;IACvB,mCAAmC;IACnC,2CAAyB,CAAA;AAC3B,CAAC,EAjBW,cAAc,8BAAd,cAAc,QAiBzB"}
+{"version":3,"file":"cc-status.enum.js","sourceRoot":"","sources":["../../../../../../../src/_modules/external-sessions/_modules/claude-code/_enums/cc-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,IAAY,cAuBX;AAvBD,WAAY,cAAc;IACxB,8DAA8D;IAC9D,uCAAqB,CAAA;IACrB,yDAAyD;IACzD,uCAAqB,CAAA;IACrB,wDAAwD;IACxD,qCAAmB,CAAA;IACnB,qCAAqC;IACrC,gDAA8B,CAAA;IAC9B,kGAAkG;IAClG,qCAAmB,CAAA;IACnB;;;;OAIG;IACH,qCAAmB,CAAA;IACnB,4CAA4C;IAC5C,qCAAmB,CAAA;IACnB,uCAAuC;IACvC,yCAAuB,CAAA;IACvB,mCAAmC;IACnC,2CAAyB,CAAA;AAC3B,CAAC,EAvBW,cAAc,8BAAd,cAAc,QAuBzB"}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.d.ts

@@ -0,0 +1,49 @@
+import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+/**
+ * CC Account Usage Event — append-only timeline (REQ-CC-USAGE-DASHBOARD-001 cycle 878).
+ *
+ * Minden usage-frissítésre (akár stream-driven `rate_limit_event`-ből, akár
+ * az auto-pull / manual-pull `/api/oauth/usage`-ból) egy új rekordot dobunk
+ * be ebbe a kollekcióba. NEM upsert — minden esemény külön sorként él, hogy
+ * **trend-elemzés és metrika-építés** (pl. „mennyit használt a user az utóbbi
+ * 7 napban", „milyen ütemben égeti", „mikor érte el a limit-et utoljára")
+ * lehetséges legyen.
+ *
+ * **Indexelt mezők:** `accountKey`, `windowType`, `lastObservedByCcapId`,
+ * `observedAt` — a leggyakoribb query-mintákhoz (account-szűrés + idő-tartomány).
+ *
+ * **NEM helyettesíti** a `CC_AccountUsageState` DBNT-t — az a *legutóbbi*
+ * snapshot per `(accountKey, windowType)`, gyors lookup-hoz; ez a *teljes
+ * történet* trend-megjelenítéshez. A két DBNT együtt él.
+ */
+export declare class CC_AccountUsageEvent extends DyFM_Metadata {
+    /** A `CC_Account` rekord stable kulcsa — az event ezt az account-ot érinti. */
+    accountKey: string;
+    /** Window-typeName: `five_hour` | `seven_day` | `seven_day_opus` | `seven_day_sonnet` | `extra_usage`. */
+    windowType: string;
+    /** Utilization fraction 0..1 (a CLI / Anthropic által szolgáltatott; lehet undefined ha nem értelmezhető). */
+    utilization?: number;
+    /** Reset timestamp ms (unix-seconds * 1000 vagy ISO-parsolt). */
+    resetsAtMs?: number;
+    /** Klasszifikáció a snapshot pillanatában: `reached` | `approaching` | `info`. */
+    lastObservedStatus?: string;
+    /** Forrás: `stream` (CC session rate_limit_event chunk) vagy `pull` (auto/manual /api/oauth/usage probe). */
+    source?: string;
+    /** Mely CCAP instance jelezte (akár stream-driven sessionből, akár pull-ból). */
+    lastObservedByCcapId?: string;
+    /** Stream-driven esetben a CC session id, ami küldte. `pull` source-nál üres / `pool-refresh`. */
+    lastObservedBySessionId?: string;
+    /** Az esemény timestamp-je (snapshot rögzítésének ideje). */
+    observedAt?: Date;
+    constructor(set?: CC_AccountUsageEvent);
+}
+/**
+ * MongoDB dataParams: `ccap_cc_account_usage_event` collection. Append-only —
+ * sose törlünk, sose update-elünk meglévő rekordot. A trend-query mintákhoz
+ * a `(accountKey, observedAt)` és `(lastObservedByCcapId, observedAt)` compound
+ * index lenne ideális; Slice 1-ben single-field-indexek (a Mongo bő mintázatra
+ * single-field is acceptable, compound index a Slice 4 instance-mapping
+ * mintára Slice utánra hagyva).
+ */
+export declare const ccapCcAccountUsageEvent_dataParams: DyFM_DataModel_Params<CC_AccountUsageEvent>;
+//# sourceMappingURL=cc-account-usage-event.data-model.d.ts.map

package/server/build/src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cc-account-usage-event.data-model.d.ts","sourceRoot":"","sources":["../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAe,MAAM,uBAAuB,CAAC;AAE1F;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAM;IAExB,0GAA0G;IAC1G,UAAU,EAAE,MAAM,CAAM;IAExB,8GAA8G;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iFAAiF;IACjF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,kGAAkG;IAClG,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,IAAI,CAAC;gBAEN,GAAG,CAAC,EAAE,oBAAoB;CAOvC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,EAAE,qBAAqB,CAAC,oBAAoB,CAcvF,CAAC"}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ccapCcAccountUsageEvent_dataParams = exports.CC_AccountUsageEvent = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * CC Account Usage Event — append-only timeline (REQ-CC-USAGE-DASHBOARD-001 cycle 878).
+ *
+ * Minden usage-frissítésre (akár stream-driven `rate_limit_event`-ből, akár
+ * az auto-pull / manual-pull `/api/oauth/usage`-ból) egy új rekordot dobunk
+ * be ebbe a kollekcióba. NEM upsert — minden esemény külön sorként él, hogy
+ * **trend-elemzés és metrika-építés** (pl. „mennyit használt a user az utóbbi
+ * 7 napban", „milyen ütemben égeti", „mikor érte el a limit-et utoljára")
+ * lehetséges legyen.
+ *
+ * **Indexelt mezők:** `accountKey`, `windowType`, `lastObservedByCcapId`,
+ * `observedAt` — a leggyakoribb query-mintákhoz (account-szűrés + idő-tartomány).
+ *
+ * **NEM helyettesíti** a `CC_AccountUsageState` DBNT-t — az a *legutóbbi*
+ * snapshot per `(accountKey, windowType)`, gyors lookup-hoz; ez a *teljes
+ * történet* trend-megjelenítéshez. A két DBNT együtt él.
+ */
+class CC_AccountUsageEvent extends fsm_dynamo_1.DyFM_Metadata {
+    /** A `CC_Account` rekord stable kulcsa — az event ezt az account-ot érinti. */
+    accountKey = '';
+    /** Window-typeName: `five_hour` | `seven_day` | `seven_day_opus` | `seven_day_sonnet` | `extra_usage`. */
+    windowType = '';
+    /** Utilization fraction 0..1 (a CLI / Anthropic által szolgáltatott; lehet undefined ha nem értelmezhető). */
+    utilization;
+    /** Reset timestamp ms (unix-seconds * 1000 vagy ISO-parsolt). */
+    resetsAtMs;
+    /** Klasszifikáció a snapshot pillanatában: `reached` | `approaching` | `info`. */
+    lastObservedStatus;
+    /** Forrás: `stream` (CC session rate_limit_event chunk) vagy `pull` (auto/manual /api/oauth/usage probe). */
+    source;
+    /** Mely CCAP instance jelezte (akár stream-driven sessionből, akár pull-ból). */
+    lastObservedByCcapId;
+    /** Stream-driven esetben a CC session id, ami küldte. `pull` source-nál üres / `pool-refresh`. */
+    lastObservedBySessionId;
+    /** Az esemény timestamp-je (snapshot rögzítésének ideje). */
+    observedAt;
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.CC_AccountUsageEvent = CC_AccountUsageEvent;
+/**
+ * MongoDB dataParams: `ccap_cc_account_usage_event` collection. Append-only —
+ * sose törlünk, sose update-elünk meglévő rekordot. A trend-query mintákhoz
+ * a `(accountKey, observedAt)` és `(lastObservedByCcapId, observedAt)` compound
+ * index lenne ideális; Slice 1-ben single-field-indexek (a Mongo bő mintázatra
+ * single-field is acceptable, compound index a Slice 4 instance-mapping
+ * mintára Slice utánra hagyva).
+ */
+exports.ccapCcAccountUsageEvent_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'ccap_cc_account_usage_event',
+    properties: {
+        accountKey: { type: 'string', required: true, index: true },
+        windowType: { type: 'string', required: true, index: true },
+        utilization: { type: 'number' },
+        resetsAtMs: { type: 'number' },
+        lastObservedStatus: { type: 'string' },
+        source: { type: 'string', index: true },
+        lastObservedByCcapId: { type: 'string', index: true },
+        lastObservedBySessionId: { type: 'string' },
+        observedAt: { type: 'date', index: true },
+    },
+});
+//# sourceMappingURL=cc-account-usage-event.data-model.js.map

package/server/build/src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cc-account-usage-event.data-model.js","sourceRoot":"","sources":["../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.ts"],"names":[],"mappings":";;;AAAA,sDAA0F;AAE1F;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,oBAAqB,SAAQ,0BAAa;IACrD,+EAA+E;IAC/E,UAAU,GAAW,EAAE,CAAC;IAExB,0GAA0G;IAC1G,UAAU,GAAW,EAAE,CAAC;IAExB,8GAA8G;IAC9G,WAAW,CAAU;IAErB,iEAAiE;IACjE,UAAU,CAAU;IAEpB,kFAAkF;IAClF,kBAAkB,CAAU;IAE5B,6GAA6G;IAC7G,MAAM,CAAU;IAEhB,iFAAiF;IACjF,oBAAoB,CAAU;IAE9B,kGAAkG;IAClG,uBAAuB,CAAU;IAEjC,6DAA6D;IAC7D,UAAU,CAAQ;IAElB,YAAY,GAA0B;QACpC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEX,IAAI,GAAG,EAAE,CAAC;YACR,wBAAW,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF;AAnCD,oDAmCC;AAED;;;;;;;GAOG;AACU,QAAA,kCAAkC,GAC7C,IAAI,kCAAqB,CAAuB;IAC9C,QAAQ,EAAE,6BAA6B;IACvC,UAAU,EAAE;QACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QAC3D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QAC3D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE;QACvC,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE;QACrD,uBAAuB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3C,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE;KAC1C;CACF,CAAC,CAAC"}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cc-account-usage-event.data-model.spec.d.ts.map

package/server/build/src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cc-account-usage-event.data-model.spec.d.ts","sourceRoot":"","sources":["../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.spec.ts"],"names":[],"mappings":""}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.spec.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cc_account_usage_event_data_model_1 = require("./cc-account-usage-event.data-model");
+describe('CC_AccountUsageEvent data model', () => {
+    it('üres konstruktorral létrehozható', () => {
+        const m = new cc_account_usage_event_data_model_1.CC_AccountUsageEvent();
+        expect(m).toBeDefined();
+        expect(m.accountKey).toBe('');
+        expect(m.windowType).toBe('');
+    });
+    it('set paraméterrel inicializálja a mezőket', () => {
+        const set = {
+            accountKey: 'k1',
+            windowType: 'five_hour',
+            utilization: 0.45,
+            resetsAtMs: 1_900_000_000_000,
+            lastObservedStatus: 'approaching',
+            source: 'pull',
+            lastObservedByCcapId: 'ccap-1',
+            lastObservedBySessionId: 'pool-refresh',
+            observedAt: new Date('2026-05-09T10:00:00.000Z'),
+        };
+        const m = new cc_account_usage_event_data_model_1.CC_AccountUsageEvent(set);
+        expect(m.accountKey).toBe('k1');
+        expect(m.windowType).toBe('five_hour');
+        expect(m.utilization).toBe(0.45);
+        expect(m.source).toBe('pull');
+        expect(m.lastObservedByCcapId).toBe('ccap-1');
+    });
+    it('dataParams dataName ccap_cc_account_usage_event', () => {
+        expect(cc_account_usage_event_data_model_1.ccapCcAccountUsageEvent_dataParams.dataName).toBe('ccap_cc_account_usage_event');
+    });
+    it('dataParams: accountKey + windowType kötelező + indexelt', () => {
+        const props = cc_account_usage_event_data_model_1.ccapCcAccountUsageEvent_dataParams.properties;
+        expect(props.accountKey).toEqual(jasmine.objectContaining({ type: 'string', required: true, index: true }));
+        expect(props.windowType).toEqual(jasmine.objectContaining({ type: 'string', required: true, index: true }));
+    });
+    it('dataParams: source / lastObservedByCcapId / observedAt indexelt (trend-query)', () => {
+        const props = cc_account_usage_event_data_model_1.ccapCcAccountUsageEvent_dataParams.properties;
+        expect(props.source.index).toBe(true);
+        expect(props.lastObservedByCcapId.index).toBe(true);
+        expect(props.observedAt.index).toBe(true);
+    });
+});
+//# sourceMappingURL=cc-account-usage-event.data-model.spec.js.map

package/server/build/src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cc-account-usage-event.data-model.spec.js","sourceRoot":"","sources":["../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_models/data-models/cc-account-usage-event.data-model.spec.ts"],"names":[],"mappings":";;AAAA,2FAG6C;AAE7C,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAE/C,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAyB,IAAI,wDAAoB,EAAE,CAAC;QAC3D,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,GAAG,GAAkC;YACzC,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,WAAW;YACvB,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,iBAAiB;YAC7B,kBAAkB,EAAE,aAAa;YACjC,MAAM,EAAE,MAAM;YACd,oBAAoB,EAAE,QAAQ;YAC9B,uBAAuB,EAAE,cAAc;YACvC,UAAU,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;SACjD,CAAC;QACF,MAAM,CAAC,GAAyB,IAAI,wDAAoB,CAAC,GAA2B,CAAC,CAAC;QACtF,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,sEAAkC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,KAAK,GAA4B,sEAAkC,CAAC,UAAU,CAAC;QACrF,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5G,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,KAAK,GAAwC,sEAAkC,CAAC,UAAU,CAAC;QACjG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_routes/cc-account/cc-account-route.control-service.d.ts

@@ -1,5 +1,6 @@
 import { DyNTS_SingletonService } from '@futdevpro/nts-dynamo';
 import { CC_Account } from '../../_models/data-models/cc-account.data-model';
+import { CC_AccountUsageEvent } from '../../_models/data-models/cc-account-usage-event.data-model';
 import { CC_AccountUsageState } from '../../_models/data-models/cc-account-usage-state.data-model';
 /**
  * REST handler delegáció a CC Account endpoint-okhoz
@@ -18,6 +19,15 @@ export declare class CC_AccountRoute_ControlService extends DyNTS_SingletonServi
     static readonly ACCOUNT_KEY_PATTERN: RegExp;
     /** displayName max hossz — limit a `/list` response méretére (Dashboard pollolható). */
     static readonly DISPLAY_NAME_MAX_LENGTH: number;
+    /** Email max hossz — RFC 5321 (320 char). */
+    static readonly EMAIL_MAX_LENGTH: number;
+    /**
+     * Email alap-formátum check (cycle 876). NEM teljes RFC 5322 — csak a triviális
+     * szakmányos validáció (`local@domain.tld`). A fő cél: a UI-bind ne fogadjon
+     * el véletlen szóközös / üres / random stringet. A teljes RFC 5322 implementálás
+     * túlzás (a server NEM authentikál ezzel — pure metadata).
+     */
+    static readonly EMAIL_BASIC_PATTERN: RegExp;
     /** Kontroll-karakter regex — sose engedjük be DB-be (későbbi UI-render zavart okozna). */
     static readonly CONTROL_CHAR_PATTERN: RegExp;
     static getInstance(): CC_AccountRoute_ControlService;
@@ -53,6 +63,25 @@ export declare class CC_AccountRoute_ControlService extends DyNTS_SingletonServi
     }): Promise<{
         items: CC_AccountUsageState[];
     }>;
+    /**
+     * GET /cc-account/:accountKey/usage-history?windowType=&fromMs=&toMs=
+     *
+     * Történeti usage-event-lista (cycle 878). Append-only timeline a
+     * `ccap_cc_account_usage_event` collection-ből, opcionális szűrésekkel:
+     *   - `windowType` (one of `five_hour|seven_day|seven_day_opus|seven_day_sonnet|extra_usage`)
+     *   - `fromMs` / `toMs` (Unix ms timestamps az `observedAt`-ra)
+     *
+     * Sorrend: rögzítés szerinti (insert-order, opcionális explicit `observedAt`-rendezés
+     * a kliens-oldalon). A Dashboard chart-rendere ebből építi a trend-vonalat.
+     */
+    handleGetAccountUsageHistory(params: {
+        accountKey: string;
+        query: unknown;
+    }): Promise<{
+        items: CC_AccountUsageEvent[];
+    }>;
+    /** Query-param parse pozitív integer ms timestamp-re. */
+    private parsePositiveInt;
     /**
      * POST /cc-account/:accountKey/refresh-usage — aktív usage-pull az Anthropic
      * `/api/oauth/usage` endpoint-jával (REQ-CC-USAGE-DASHBOARD-001 cycle 873).
@@ -88,7 +117,13 @@ export declare class CC_AccountRoute_ControlService extends DyNTS_SingletonServi
             items: CC_AccountUsageState[];
         }[];
     }>;
-    /** PATCH /cc-account/:accountKey — user-readable display-name átírása. */
+    /**
+     * PATCH /cc-account/:accountKey — user-editable mezők frissítése: `displayName`
+     * és/vagy `email` (cycle 876). Mindkettő opcionális — ha mindkettő hiányzik
+     * → 400. Ha az `email` empty/null → kitörli (clear). Validáció: displayName
+     * 200-char cap + control-char tiltás (mint korábban); email RFC-szerű alap-
+     * formátum-check (`@` + `.`) és 320-char cap (RFC 5321).
+     */
     handleRenameAccount(params: {
         accountKey: string;
         body: Record<string, unknown>;

package/server/build/src/_modules/external-sessions/_modules/claude-code/_routes/cc-account/cc-account-route.control-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cc-account-route.control-service.d.ts","sourceRoot":"","sources":["../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_routes/cc-account/cc-account-route.control-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAC;AAInG;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA+B,SAAQ,sBAAsB;IAExE,iGAAiG;IACjG,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAoB;IAE/D,wFAAwF;IACxF,MAAM,CAAC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAO;IAEtD,0FAA0F;IAC1F,MAAM,CAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAA2B;IAEvE,MAAM,CAAC,WAAW,IAAI,8BAA8B;IAIpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CACe;IAE9C,2DAA2D;IACrD,kBAAkB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAK5D;;;OAGG;IACG,0BAA0B,IAAI,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9F,2DAA2D;IACrD,gBAAgB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAe3E;;;;;;;;;OASG;IACG,qBAAqB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IASvG;;;;;;;;;;OAUG;IACG,yBAAyB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACvE,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IA8FF;;;;;;;;;;OAUG;IACG,wBAAwB,IAAI,OAAO,CAAC;QACxC,SAAS,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,oBAAoB,EAAE,CAAA;SAAE,EAAE,CAAC;KAChE,CAAC;IA0BF,0EAA0E;IACpE,mBAAmB,CAAC,MAAM,EAAE;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GAAG,OAAO,CAAC,UAAU,CAAC;IAiEvB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;CAgBjC"}
+{"version":3,"file":"cc-account-route.control-service.d.ts","sourceRoot":"","sources":["../../../../../../../../src/_modules/external-sessions/_modules/claude-code/_routes/cc-account/cc-account-route.control-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAC;AAKnG;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA+B,SAAQ,sBAAsB;IAExE,iGAAiG;IACjG,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAoB;IAE/D,wFAAwF;IACxF,MAAM,CAAC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAO;IAEtD,6CAA6C;IAC7C,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAO;IAE/C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAgC;IAE3E,0FAA0F;IAC1F,MAAM,CAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAA2B;IAEvE,MAAM,CAAC,WAAW,IAAI,8BAA8B;IAIpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CACe;IAE9C,2DAA2D;IACrD,kBAAkB,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAK5D;;;OAGG;IACG,0BAA0B,IAAI,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9F,2DAA2D;IACrD,gBAAgB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAe3E;;;;;;;;;OASG;IACG,qBAAqB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IASvG;;;;;;;;;;OAUG;IACG,4BAA4B,CAAC,MAAM,EAAE;QACzC,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAyB9C,yDAAyD;IACzD,OAAO,CAAC,gBAAgB;IAUxB;;;;;;;;;;OAUG;IACG,yBAAyB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACvE,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IA8FF;;;;;;;;;;OAUG;IACG,wBAAwB,IAAI,OAAO,CAAC;QACxC,SAAS,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,oBAAoB,EAAE,CAAA;SAAE,EAAE,CAAC;KAChE,CAAC;IA0BF;;;;;;OAMG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAChC,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GAAG,OAAO,CAAC,UAAU,CAAC;IAmIvB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;CAgBjC"}

package/server/build/src/_modules/external-sessions/_modules/claude-code/_routes/cc-account/cc-account-route.control-service.js

@@ -4,6 +4,7 @@ exports.CC_AccountRoute_ControlService = void 0;
 const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
 const nts_dynamo_1 = require("@futdevpro/nts-dynamo");
 const cc_account_pool_control_service_1 = require("../../_services/core/account/cc-account-pool.control-service");
+const cc_account_usage_event_data_service_1 = require("../../_services/core/account/cc-account-usage-event.data-service");
 const cc_account_usage_state_data_service_1 = require("../../_services/core/account/cc-account-usage-state.data-service");
 /**
  * REST handler delegáció a CC Account endpoint-okhoz
@@ -22,6 +23,15 @@ class CC_AccountRoute_ControlService extends nts_dynamo_1.DyNTS_SingletonService
     static ACCOUNT_KEY_PATTERN = /^[a-f0-9]{12}$/;
     /** displayName max hossz — limit a `/list` response méretére (Dashboard pollolható). */
     static DISPLAY_NAME_MAX_LENGTH = 200;
+    /** Email max hossz — RFC 5321 (320 char). */
+    static EMAIL_MAX_LENGTH = 320;
+    /**
+     * Email alap-formátum check (cycle 876). NEM teljes RFC 5322 — csak a triviális
+     * szakmányos validáció (`local@domain.tld`). A fő cél: a UI-bind ne fogadjon
+     * el véletlen szóközös / üres / random stringet. A teljes RFC 5322 implementálás
+     * túlzás (a server NEM authentikál ezzel — pure metadata).
+     */
+    static EMAIL_BASIC_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
     /** Kontroll-karakter regex — sose engedjük be DB-be (későbbi UI-render zavart okozna). */
     static CONTROL_CHAR_PATTERN = /[\u0000-\u001F\u007F]/;
     static getInstance() {
@@ -73,6 +83,48 @@ class CC_AccountRoute_ControlService extends nts_dynamo_1.DyNTS_SingletonService
         const items = await ds.listByAccountKey(params.accountKey);
         return { items: items };
     }
+    /**
+     * GET /cc-account/:accountKey/usage-history?windowType=&fromMs=&toMs=
+     *
+     * Történeti usage-event-lista (cycle 878). Append-only timeline a
+     * `ccap_cc_account_usage_event` collection-ből, opcionális szűrésekkel:
+     *   - `windowType` (one of `five_hour|seven_day|seven_day_opus|seven_day_sonnet|extra_usage`)
+     *   - `fromMs` / `toMs` (Unix ms timestamps az `observedAt`-ra)
+     *
+     * Sorrend: rögzítés szerinti (insert-order, opcionális explicit `observedAt`-rendezés
+     * a kliens-oldalon). A Dashboard chart-rendere ebből építi a trend-vonalat.
+     */
+    async handleGetAccountUsageHistory(params) {
+        this.validateAccountKeyFormat(params.accountKey);
+        const queryRec = params.query != null && typeof params.query === 'object' && !Array.isArray(params.query)
+            ? params.query
+            : {};
+        const windowType = typeof queryRec.windowType === 'string'
+            ? queryRec.windowType
+            : undefined;
+        const fromMs = this.parsePositiveInt(queryRec.fromMs);
+        const toMs = this.parsePositiveInt(queryRec.toMs);
+        const ds = new cc_account_usage_event_data_service_1.CC_AccountUsageEvent_DataService({
+            issuer: 'cc-account-route:get-usage-history',
+        });
+        const items = await ds.listByAccountInRange({
+            accountKey: params.accountKey,
+            windowType: windowType,
+            fromMs: fromMs,
+            toMs: toMs,
+        });
+        return { items: items };
+    }
+    /** Query-param parse pozitív integer ms timestamp-re. */
+    parsePositiveInt(raw) {
+        if (typeof raw === 'string' && raw !== '') {
+            const parsed = Number(raw);
+            if (!isNaN(parsed) && parsed > 0) {
+                return parsed;
+            }
+        }
+        return undefined;
+    }
     /**
      * POST /cc-account/:accountKey/refresh-usage — aktív usage-pull az Anthropic
      * `/api/oauth/usage` endpoint-jával (REQ-CC-USAGE-DASHBOARD-001 cycle 873).
@@ -203,59 +255,130 @@ class CC_AccountRoute_ControlService extends nts_dynamo_1.DyNTS_SingletonService
         }
         return { instances: instances };
     }
-    /** PATCH /cc-account/:accountKey — user-readable display-name átírása. */
+    /**
+     * PATCH /cc-account/:accountKey — user-editable mezők frissítése: `displayName`
+     * és/vagy `email` (cycle 876). Mindkettő opcionális — ha mindkettő hiányzik
+     * → 400. Ha az `email` empty/null → kitörli (clear). Validáció: displayName
+     * 200-char cap + control-char tiltás (mint korábban); email RFC-szerű alap-
+     * formátum-check (`@` + `.`) és 320-char cap (RFC 5321).
+     */
     async handleRenameAccount(params) {
         this.validateAccountKeyFormat(params.accountKey);
-        const displayNameRaw = params.body?.displayName;
-        if (typeof displayNameRaw !== 'string') {
-            throw new fsm_dynamo_1.DyFM_Error({
-                message: 'CC Account rename: displayName is required and must be a string.',
-                errorCode: 'CCAP-CC-ACCOUNT-RENAME-INVALID',
-                status: 400,
-                error: new Error('Invalid displayName: not a string'),
-                additionalContent: { accountKey: params.accountKey, providedDisplayNameType: typeof displayNameRaw },
-            });
-        }
-        const trimmed = displayNameRaw.trim();
-        if (trimmed === '') {
-            throw new fsm_dynamo_1.DyFM_Error({
-                message: 'CC Account rename: displayName must be non-empty after trim.',
-                errorCode: 'CCAP-CC-ACCOUNT-RENAME-INVALID',
-                status: 400,
-                error: new Error('Invalid displayName: empty'),
-                additionalContent: { accountKey: params.accountKey, rawLength: displayNameRaw.length },
-            });
+        const fields = {};
+        let anyFieldProvided = false;
+        // displayName (opcionális, de ha jelen → validáljuk).
+        if (params.body?.displayName !== undefined) {
+            anyFieldProvided = true;
+            const raw = params.body.displayName;
+            if (typeof raw !== 'string') {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    message: 'CC Account update: displayName must be a string.',
+                    errorCode: 'CCAP-CC-ACCOUNT-RENAME-INVALID',
+                    status: 400,
+                    error: new Error('Invalid displayName: not a string'),
+                    additionalContent: { accountKey: params.accountKey, providedType: typeof raw },
+                });
+            }
+            const trimmed = raw.trim();
+            if (trimmed === '') {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    message: 'CC Account update: displayName must be non-empty after trim.',
+                    errorCode: 'CCAP-CC-ACCOUNT-RENAME-INVALID',
+                    status: 400,
+                    error: new Error('Invalid displayName: empty'),
+                    additionalContent: { accountKey: params.accountKey, rawLength: raw.length },
+                });
+            }
+            if (trimmed.length > CC_AccountRoute_ControlService.DISPLAY_NAME_MAX_LENGTH) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    message: `CC Account update: displayName exceeds max length`
+                        + ` (${CC_AccountRoute_ControlService.DISPLAY_NAME_MAX_LENGTH} chars).`,
+                    errorCode: 'CCAP-CC-ACCOUNT-RENAME-INVALID',
+                    status: 400,
+                    error: new Error(`Invalid displayName: too long (${trimmed.length} chars)`),
+                    additionalContent: {
+                        accountKey: params.accountKey,
+                        providedLength: trimmed.length,
+                        maxLength: CC_AccountRoute_ControlService.DISPLAY_NAME_MAX_LENGTH,
+                    },
+                });
+            }
+            if (CC_AccountRoute_ControlService.CONTROL_CHAR_PATTERN.test(trimmed)) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    message: 'CC Account update: displayName must not contain control characters.',
+                    errorCode: 'CCAP-CC-ACCOUNT-RENAME-INVALID',
+                    status: 400,
+                    error: new Error('Invalid displayName: contains control characters'),
+                    additionalContent: { accountKey: params.accountKey },
+                });
+            }
+            fields.displayName = trimmed;
         }
-        if (trimmed.length > CC_AccountRoute_ControlService.DISPLAY_NAME_MAX_LENGTH) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                message: `CC Account rename: displayName exceeds max length`
-                    + ` (${CC_AccountRoute_ControlService.DISPLAY_NAME_MAX_LENGTH} chars).`,
-                errorCode: 'CCAP-CC-ACCOUNT-RENAME-INVALID',
-                status: 400,
-                error: new Error(`Invalid displayName: too long (${trimmed.length} chars)`),
-                additionalContent: {
-                    accountKey: params.accountKey,
-                    providedLength: trimmed.length,
-                    maxLength: CC_AccountRoute_ControlService.DISPLAY_NAME_MAX_LENGTH,
-                },
-            });
+        // email (opcionális). Empty / null → clear; non-empty → RFC alap-validáció.
+        if (params.body?.email !== undefined) {
+            anyFieldProvided = true;
+            const raw = params.body.email;
+            if (raw === null || (typeof raw === 'string' && raw.trim() === '')) {
+                fields.email = null; // clear
+            }
+            else if (typeof raw === 'string') {
+                const trimmed = raw.trim();
+                if (trimmed.length > CC_AccountRoute_ControlService.EMAIL_MAX_LENGTH) {
+                    throw new fsm_dynamo_1.DyFM_Error({
+                        message: `CC Account update: email exceeds max length`
+                            + ` (${CC_AccountRoute_ControlService.EMAIL_MAX_LENGTH} chars per RFC 5321).`,
+                        errorCode: 'CCAP-CC-ACCOUNT-EMAIL-INVALID',
+                        status: 400,
+                        error: new Error(`Invalid email: too long (${trimmed.length} chars)`),
+                        additionalContent: { accountKey: params.accountKey, providedLength: trimmed.length },
+                    });
+                }
+                if (!CC_AccountRoute_ControlService.EMAIL_BASIC_PATTERN.test(trimmed)) {
+                    throw new fsm_dynamo_1.DyFM_Error({
+                        message: 'CC Account update: email must look like an email address (`local@domain.tld`).',
+                        errorCode: 'CCAP-CC-ACCOUNT-EMAIL-INVALID',
+                        status: 400,
+                        error: new Error('Invalid email: format check failed'),
+                        additionalContent: { accountKey: params.accountKey },
+                    });
+                }
+                if (CC_AccountRoute_ControlService.CONTROL_CHAR_PATTERN.test(trimmed)) {
+                    throw new fsm_dynamo_1.DyFM_Error({
+                        message: 'CC Account update: email must not contain control characters.',
+                        errorCode: 'CCAP-CC-ACCOUNT-EMAIL-INVALID',
+                        status: 400,
+                        error: new Error('Invalid email: contains control characters'),
+                        additionalContent: { accountKey: params.accountKey },
+                    });
+                }
+                fields.email = trimmed;
+            }
+            else {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    message: 'CC Account update: email must be a string or null.',
+                    errorCode: 'CCAP-CC-ACCOUNT-EMAIL-INVALID',
+                    status: 400,
+                    error: new Error('Invalid email: not a string'),
+                    additionalContent: { accountKey: params.accountKey, providedType: typeof raw },
+                });
+            }
         }
-        if (CC_AccountRoute_ControlService.CONTROL_CHAR_PATTERN.test(trimmed)) {
+        if (!anyFieldProvided) {
             throw new fsm_dynamo_1.DyFM_Error({
-                message: 'CC Account rename: displayName must not contain control characters.',
+                message: 'CC Account update: at least one of `displayName` or `email` must be provided.',
                 errorCode: 'CCAP-CC-ACCOUNT-RENAME-INVALID',
                 status: 400,
-                error: new Error('Invalid displayName: contains control characters'),
+                error: new Error('No editable fields provided'),
                 additionalContent: { accountKey: params.accountKey },
             });
         }
-        const updated = await this.accountPool_CS.renameAccount(params.accountKey, trimmed);
+        const updated = await this.accountPool_CS.renameAccount(params.accountKey, fields);
         if (updated == null) {
             throw new fsm_dynamo_1.DyFM_Error({
-                message: `CC Account not found for rename: ${params.accountKey}`,
+                message: `CC Account not found for update: ${params.accountKey}`,
                 errorCode: 'CCAP-CC-ACCOUNT-NOT-FOUND',
                 status: 404,
-                error: new Error(`CC Account not found for rename: ${params.accountKey}`),
+                error: new Error(`CC Account not found for update: ${params.accountKey}`),
                 additionalContent: { accountKey: params.accountKey },
             });
         }