@veruna/api-contracts 20.0.0 → 20.1.0

package/build/v1/ai-provider/schemas/ai-provider-status.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * AI Provider Status
+ */
 export declare enum AiProviderStatus {
     ACTIVE = "ACTIVE",
     INACTIVE = "INACTIVE"

package/build/v1/ai-provider/schemas/ai-provider-status.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiProviderStatus = void 0;
+/**
+ * AI Provider Status
+ */
 var AiProviderStatus;
 (function (AiProviderStatus) {
     AiProviderStatus["ACTIVE"] = "ACTIVE";

package/build/v1/ai-provider/schemas/ai-provider-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider-status.enum.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/ai-provider-status.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,qCAAiB,CAAA;IACjB,yCAAqB,CAAA;AACzB,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}
+{"version":3,"file":"ai-provider-status.enum.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/ai-provider-status.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,qCAAiB,CAAA;IACjB,yCAAqB,CAAA;AACzB,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}

package/build/v1/ai-provider/schemas/circuit-ban-source.enum.d.ts

@@ -1,3 +1,4 @@
+/** Who caused a circuit event — the automatic breaker or an admin action. */
 export declare enum CircuitBanSource {
     AUTO = "AUTO",
     ADMIN = "ADMIN"

package/build/v1/ai-provider/schemas/circuit-ban-source.enum.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CircuitBanSource = void 0;
+/** Who caused a circuit event — the automatic breaker or an admin action. */
 var CircuitBanSource;
 (function (CircuitBanSource) {
     CircuitBanSource["AUTO"] = "AUTO";

package/build/v1/ai-provider/schemas/circuit-ban-source.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-ban-source.enum.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-ban-source.enum.ts"],"names":[],"mappings":";;;AACA,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,iCAAa,CAAA;IACb,mCAAe,CAAA;AACnB,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}
+{"version":3,"file":"circuit-ban-source.enum.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-ban-source.enum.ts"],"names":[],"mappings":";;;AAAA,6EAA6E;AAC7E,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,iCAAa,CAAA;IACb,mCAAe,CAAA;AACnB,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}

package/build/v1/ai-provider/schemas/circuit-event-kind.enum.d.ts

@@ -1,3 +1,10 @@
+/**
+ * A single circuit-breaker event kind (the capped ban/recover audit log).
+ * TRIP — circuit opened automatically after consecutive infra strikes.
+ * RECOVER — circuit closed after a successful probe.
+ * MANUAL_BAN — an admin force-banned the provider/route.
+ * MANUAL_UNBAN — an admin lifted a ban.
+ */
 export declare enum CircuitEventKind {
     TRIP = "TRIP",
     RECOVER = "RECOVER",

package/build/v1/ai-provider/schemas/circuit-event-kind.enum.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CircuitEventKind = void 0;
+/**
+ * A single circuit-breaker event kind (the capped ban/recover audit log).
+ * TRIP — circuit opened automatically after consecutive infra strikes.
+ * RECOVER — circuit closed after a successful probe.
+ * MANUAL_BAN — an admin force-banned the provider/route.
+ * MANUAL_UNBAN — an admin lifted a ban.
+ */
 var CircuitEventKind;
 (function (CircuitEventKind) {
     CircuitEventKind["TRIP"] = "TRIP";

package/build/v1/ai-provider/schemas/circuit-event-kind.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-event-kind.enum.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-event-kind.enum.ts"],"names":[],"mappings":";;;AAOA,IAAY,gBAKX;AALD,WAAY,gBAAgB;IACxB,iCAAa,CAAA;IACb,uCAAmB,CAAA;IACnB,6CAAyB,CAAA;IACzB,iDAA6B,CAAA;AACjC,CAAC,EALW,gBAAgB,gCAAhB,gBAAgB,QAK3B"}
+{"version":3,"file":"circuit-event-kind.enum.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-event-kind.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,gBAKX;AALD,WAAY,gBAAgB;IACxB,iCAAa,CAAA;IACb,uCAAmB,CAAA;IACnB,6CAAyB,CAAA;IACzB,iDAA6B,CAAA;AACjC,CAAC,EALW,gBAAgB,gCAAhB,gBAAgB,QAK3B"}

package/build/v1/ai-provider/schemas/circuit-event.schema.d.ts

@@ -1,6 +1,10 @@
 import { z } from 'zod';
 import { CircuitBanSource } from './circuit-ban-source.enum';
 import { CircuitEventKind } from './circuit-event-kind.enum';
+/**
+ * One decoded entry from the capped circuit event log (newest first). Powers the
+ * admin "when / why was this banned" analysis panel for both providers and routes.
+ */
 export declare const CircuitEventSchema: z.ZodObject<{
     at: z.ZodString;
     kind: z.ZodEnum<typeof CircuitEventKind>;

package/build/v1/ai-provider/schemas/circuit-event.schema.js

@@ -5,10 +5,16 @@ const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const circuit_ban_source_enum_1 = require("./circuit-ban-source.enum");
 const circuit_event_kind_enum_1 = require("./circuit-event-kind.enum");
+/**
+ * One decoded entry from the capped circuit event log (newest first). Powers the
+ * admin "when / why was this banned" analysis panel for both providers and routes.
+ */
 exports.CircuitEventSchema = zod_1.z.object({
     at: zod_1.z.string().regex(shared_1.DATETIME_REGEX),
     kind: zod_1.z.enum(circuit_event_kind_enum_1.CircuitEventKind),
+    // Ban duration in ms (0 = indefinite / not-applicable for recover & unban).
     durationMs: zod_1.z.number().int().nonnegative(),
+    // Escalation ladder level applied to this ban (0 for non-escalating events).
     escalationLevel: zod_1.z.number().int().nonnegative(),
     source: zod_1.z.enum(circuit_ban_source_enum_1.CircuitBanSource),
     reason: zod_1.z.string().nullable(),

package/build/v1/ai-provider/schemas/circuit-event.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-event.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-event.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAiD;AACjD,uEAA6D;AAC7D,uEAA6D;AAMhD,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;IACpC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC;IAE9B,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAE1C,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC;IAChC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC"}
+{"version":3,"file":"circuit-event.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-event.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAiD;AACjD,uEAA6D;AAC7D,uEAA6D;AAE7D;;;GAGG;AACU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;IACpC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC;IAC9B,4EAA4E;IAC5E,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,6EAA6E;IAC7E,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC;IAChC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC"}

package/build/v1/ai-provider/schemas/circuit-health-response.schema.d.ts

@@ -1,6 +1,9 @@
 import { z } from 'zod';
 import { ApiProvider } from '../../ai-model/schemas/api-provider.enum';
 import { CircuitState } from './circuit-state.enum';
+/**
+ * Runtime circuit-breaker health of a single AI provider.
+ */
 export declare const CircuitProviderHealthSchema: z.ZodObject<{
     provider: z.ZodEnum<typeof ApiProvider>;
     state: z.ZodEnum<typeof CircuitState>;
@@ -11,6 +14,9 @@ export declare const CircuitProviderHealthSchema: z.ZodObject<{
     lastFailureAt: z.ZodNullable<z.ZodString>;
     lastSuccessAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Full snapshot of every provider's circuit state (one row per known provider).
+ */
 export declare const CircuitHealthResponseSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         provider: z.ZodEnum<typeof ApiProvider>;
@@ -23,6 +29,10 @@ export declare const CircuitHealthResponseSchema: z.ZodObject<{
         lastSuccessAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * Single provider's circuit state PLUS its recent ban/recover event log
+ * (the admin "when / why" analysis view).
+ */
 export declare const CircuitProviderHealthWithEventsSchema: z.ZodObject<{
     provider: z.ZodEnum<typeof ApiProvider>;
     state: z.ZodEnum<typeof CircuitState>;

package/build/v1/ai-provider/schemas/circuit-health-response.schema.js

@@ -6,6 +6,9 @@ const shared_1 = require("../../../shared");
 const api_provider_enum_1 = require("../../ai-model/schemas/api-provider.enum");
 const circuit_event_schema_1 = require("./circuit-event.schema");
 const circuit_state_enum_1 = require("./circuit-state.enum");
+/**
+ * Runtime circuit-breaker health of a single AI provider.
+ */
 exports.CircuitProviderHealthSchema = zod_1.z.object({
     provider: zod_1.z.enum(api_provider_enum_1.ApiProvider),
     state: zod_1.z.enum(circuit_state_enum_1.CircuitState),
@@ -16,9 +19,16 @@ exports.CircuitProviderHealthSchema = zod_1.z.object({
     lastFailureAt: zod_1.z.string().regex(shared_1.DATETIME_REGEX).nullable(),
     lastSuccessAt: zod_1.z.string().regex(shared_1.DATETIME_REGEX).nullable(),
 });
+/**
+ * Full snapshot of every provider's circuit state (one row per known provider).
+ */
 exports.CircuitHealthResponseSchema = zod_1.z.object({
     items: zod_1.z.array(exports.CircuitProviderHealthSchema),
 });
+/**
+ * Single provider's circuit state PLUS its recent ban/recover event log
+ * (the admin "when / why" analysis view).
+ */
 exports.CircuitProviderHealthWithEventsSchema = exports.CircuitProviderHealthSchema.extend({
     events: zod_1.z.array(circuit_event_schema_1.CircuitEventSchema),
 });

package/build/v1/ai-provider/schemas/circuit-health-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-health-response.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-health-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAiD;AACjD,gFAAuE;AACvE,iEAA4D;AAC5D,6DAAoD;AAKvC,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,CAAC;IAC7B,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,iCAAY,CAAC;IAC3B,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACnD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC;AAKU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,mCAA2B,CAAC;CAC9C,CAAC,CAAC;AAMU,QAAA,qCAAqC,GAAG,mCAA2B,CAAC,MAAM,CAAC;IACpF,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,yCAAkB,CAAC;CACtC,CAAC,CAAC"}
+{"version":3,"file":"circuit-health-response.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-health-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAiD;AACjD,gFAAuE;AACvE,iEAA4D;AAC5D,6DAAoD;AAEpD;;GAEG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,CAAC;IAC7B,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,iCAAY,CAAC;IAC3B,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACnD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,mCAA2B,CAAC;CAC9C,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,qCAAqC,GAAG,mCAA2B,CAAC,MAAM,CAAC;IACpF,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,yCAAkB,CAAC;CACtC,CAAC,CAAC"}

package/build/v1/ai-provider/schemas/circuit-provider-param.schema.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { ApiProvider } from '../../ai-model/schemas/api-provider.enum';
+/**
+ * Circuit-breaker provider path param.
+ * Error messages: CircuitProviderParam.{field}.{rule}
+ */
 export declare const CircuitProviderParamSchema: z.ZodObject<{
     provider: z.ZodEnum<typeof ApiProvider>;
 }, z.core.$strip>;

package/build/v1/ai-provider/schemas/circuit-provider-param.schema.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CircuitProviderParamSchema = void 0;
 const zod_1 = require("zod");
 const api_provider_enum_1 = require("../../ai-model/schemas/api-provider.enum");
+/**
+ * Circuit-breaker provider path param.
+ * Error messages: CircuitProviderParam.{field}.{rule}
+ */
 exports.CircuitProviderParamSchema = zod_1.z.object({
     provider: zod_1.z.enum(api_provider_enum_1.ApiProvider, { error: 'CircuitProviderParam.provider.invalid' }),
 });

package/build/v1/ai-provider/schemas/circuit-provider-param.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-provider-param.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-provider-param.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,gFAAuE;AAM1D,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,EAAE,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;CACpF,CAAC,CAAC"}
+{"version":3,"file":"circuit-provider-param.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-provider-param.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,gFAAuE;AAEvE;;;GAGG;AACU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,EAAE,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;CACpF,CAAC,CAAC"}

package/build/v1/ai-provider/schemas/circuit-state.enum.d.ts

@@ -1,3 +1,11 @@
+/**
+ * AI provider circuit-breaker state.
+ * CLOSED — healthy, traffic flows normally.
+ * OPEN — tripped after consecutive infra failures; traffic skips this provider
+ *        until the cooldown elapses.
+ * HALF_OPEN — cooldown elapsed; probing with traffic, one success closes it,
+ *        one failure re-opens it.
+ */
 export declare enum CircuitState {
     CLOSED = "CLOSED",
     OPEN = "OPEN",

package/build/v1/ai-provider/schemas/circuit-state.enum.js

@@ -1,6 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CircuitState = void 0;
+/**
+ * AI provider circuit-breaker state.
+ * CLOSED — healthy, traffic flows normally.
+ * OPEN — tripped after consecutive infra failures; traffic skips this provider
+ *        until the cooldown elapses.
+ * HALF_OPEN — cooldown elapsed; probing with traffic, one success closes it,
+ *        one failure re-opens it.
+ */
 var CircuitState;
 (function (CircuitState) {
     CircuitState["CLOSED"] = "CLOSED";

package/build/v1/ai-provider/schemas/circuit-state.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-state.enum.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-state.enum.ts"],"names":[],"mappings":";;;AAQA,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,uCAAuB,CAAA;AAC3B,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}
+{"version":3,"file":"circuit-state.enum.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/circuit-state.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,uCAAuB,CAAA;AAC3B,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}

package/build/v1/ai-provider/schemas/create-provider-request.schema.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { AiProviderStatus } from './ai-provider-status.enum';
+/**
+ * Create Provider Request Schema
+ * Error messages: CreateProviderRequest.{field}.{rule}
+ */
 export declare const CreateProviderRequestSchema: z.ZodObject<{
     title: z.ZodString;
     icon: z.ZodString;

package/build/v1/ai-provider/schemas/create-provider-request.schema.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateProviderRequestSchema = void 0;
 const zod_1 = require("zod");
 const ai_provider_status_enum_1 = require("./ai-provider-status.enum");
+/**
+ * Create Provider Request Schema
+ * Error messages: CreateProviderRequest.{field}.{rule}
+ */
 exports.CreateProviderRequestSchema = zod_1.z.object({
     title: zod_1.z
         .string({ error: 'CreateProviderRequest.title.required' })

package/build/v1/ai-provider/schemas/create-provider-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-provider-request.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/create-provider-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAMhD,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;IAC7D,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SACxD,GAAG,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SACtD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QACzC,OAAO,EAAE,kCAAkC;KAC9C,CAAC;IACN,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,OAAO,CAAC,0CAAgB,CAAC,MAAM,CAAC;IACjE,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SACvD,WAAW,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SAC/D,OAAO,CAAC,CAAC,CAAC;CAClB,CAAC,CAAC"}
+{"version":3,"file":"create-provider-request.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/create-provider-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAE7D;;;GAGG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;IAC7D,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SACxD,GAAG,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SACtD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QACzC,OAAO,EAAE,kCAAkC;KAC9C,CAAC;IACN,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,OAAO,CAAC,0CAAgB,CAAC,MAAM,CAAC;IACjE,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SACvD,WAAW,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SAC/D,OAAO,CAAC,CAAC,CAAC;CAClB,CAAC,CAAC"}

package/build/v1/ai-provider/schemas/get-providers-filters.schema.d.ts

@@ -2,6 +2,10 @@ import { z } from 'zod';
 import { AiProviderStatus } from './ai-provider-status.enum';
 import { AdminProviderSortField } from './admin-provider-sort.enum';
 import { SortOrder } from '../../shared/sort-order.enum';
+/**
+ * Get Providers Filters Schema
+ * Error messages: GetProvidersFilters.{field}.{rule}
+ */
 export declare const GetProvidersFiltersSchema: z.ZodObject<{
     q: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<typeof AiProviderStatus>>;

package/build/v1/ai-provider/schemas/get-providers-filters.schema.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const ai_provider_status_enum_1 = require("./ai-provider-status.enum");
 const admin_provider_sort_enum_1 = require("./admin-provider-sort.enum");
 const sort_order_enum_1 = require("../../shared/sort-order.enum");
+/**
+ * Get Providers Filters Schema
+ * Error messages: GetProvidersFilters.{field}.{rule}
+ */
 exports.GetProvidersFiltersSchema = zod_1.z.object({
     q: zod_1.z.string().max(255).optional(),
     status: zod_1.z.enum(ai_provider_status_enum_1.AiProviderStatus).optional(),

package/build/v1/ai-provider/schemas/get-providers-filters.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-providers-filters.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/get-providers-filters.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAC7D,yEAAoE;AACpE,kEAAyD;AAM5C,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;SAChE,QAAQ,EAAE;IACf,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC9D,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,iDAAsB,CAAC,CAAC,OAAO,CAAC,iDAAsB,CAAC,KAAK,CAAC;IAC5E,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,2BAAS,CAAC,CAAC,OAAO,CAAC,2BAAS,CAAC,GAAG,CAAC;CACtD,CAAC,CAAC"}
+{"version":3,"file":"get-providers-filters.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/get-providers-filters.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAC7D,yEAAoE;AACpE,kEAAyD;AAEzD;;;GAGG;AACU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;SAChE,QAAQ,EAAE;IACf,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC9D,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,iDAAsB,CAAC,CAAC,OAAO,CAAC,iDAAsB,CAAC,KAAK,CAAC;IAC5E,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,2BAAS,CAAC,CAAC,OAAO,CAAC,2BAAS,CAAC,GAAG,CAAC;CACtD,CAAC,CAAC"}

package/build/v1/ai-provider/schemas/provider-response.schema.d.ts

@@ -1,5 +1,8 @@
 import { z } from 'zod';
 import { AiProviderStatus } from './ai-provider-status.enum';
+/**
+ * AI Provider Response Schema
+ */
 export declare const ProviderResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
     title: z.ZodString;

package/build/v1/ai-provider/schemas/provider-response.schema.js

@@ -4,6 +4,9 @@ exports.ProviderResponseSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const ai_provider_status_enum_1 = require("./ai-provider-status.enum");
+/**
+ * AI Provider Response Schema
+ */
 exports.ProviderResponseSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(shared_1.UUID_REGEX),
     title: zod_1.z.string(),

package/build/v1/ai-provider/schemas/provider-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-response.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/provider-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6D;AAC7D,uEAA6D;AAKhD,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAClC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;CAC9C,CAAC,CAAC"}
+{"version":3,"file":"provider-response.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/provider-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6D;AAC7D,uEAA6D;AAE7D;;GAEG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAClC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;CAC9C,CAAC,CAAC"}

package/build/v1/ai-provider/schemas/route-params.schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Provider UUID Param Schema
+ * Error messages: ProviderUuidParam.{field}.{rule}
+ */
 export declare const ProviderUuidParamSchema: z.ZodObject<{
     uuid: z.ZodString;
 }, z.core.$strip>;

package/build/v1/ai-provider/schemas/route-params.schema.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProviderUuidParamSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
+/**
+ * Provider UUID Param Schema
+ * Error messages: ProviderUuidParam.{field}.{rule}
+ */
 exports.ProviderUuidParamSchema = zod_1.z.object({
     uuid: zod_1.z
         .string({ error: 'ProviderUuidParam.uuid.required' })

package/build/v1/ai-provider/schemas/route-params.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-params.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/route-params.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAMhC,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;SACpD,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;CACxE,CAAC,CAAC"}
+{"version":3,"file":"route-params.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/route-params.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAE7C;;;GAGG;AACU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;SACpD,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;CACxE,CAAC,CAAC"}

package/build/v1/ai-provider/schemas/update-provider-request.schema.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { AiProviderStatus } from './ai-provider-status.enum';
+/**
+ * Update Provider Request Schema
+ * Error messages: UpdateProviderRequest.{field}.{rule}
+ */
 export declare const UpdateProviderRequestSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;

package/build/v1/ai-provider/schemas/update-provider-request.schema.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateProviderRequestSchema = void 0;
 const zod_1 = require("zod");
 const ai_provider_status_enum_1 = require("./ai-provider-status.enum");
+/**
+ * Update Provider Request Schema
+ * Error messages: UpdateProviderRequest.{field}.{rule}
+ */
 exports.UpdateProviderRequestSchema = zod_1.z.object({
     title: zod_1.z
         .string()

package/build/v1/ai-provider/schemas/update-provider-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-provider-request.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/update-provider-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAMhD,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,QAAQ,EAAE;IACf,IAAI,EAAE,OAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SACtD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QACzC,OAAO,EAAE,kCAAkC;KAC9C,CAAC;SACD,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SACvD,WAAW,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SAC/D,QAAQ,EAAE;CAClB,CAAC,CAAC"}
+{"version":3,"file":"update-provider-request.schema.js","sourceRoot":"","sources":["../../../../v1/ai-provider/schemas/update-provider-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAE7D;;;GAGG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,QAAQ,EAAE;IACf,IAAI,EAAE,OAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SACtD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QACzC,OAAO,EAAE,kCAAkC;KAC9C,CAAC;SACD,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SACvD,WAAW,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SAC/D,QAAQ,EAAE;CAClB,CAAC,CAAC"}

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

@@ -1,6 +1,17 @@
 import { ErrorMetadata } from '../../shared';
+/**
+ * Errors surfaced by the usage-analytics endpoints. Kept in its own
+ * namespace so the analytics module never depends on billing's error
+ * surface.
+ *
+ * `MESSAGE_NOT_FOUND` deliberately collapses both "no such message"
+ * and "message owned by someone else" — the IDOR-safe guard in the
+ * detail handler returns the same code for both branches so an
+ * attacker can't distinguish.
+ */
 export declare enum AnalyticsErrorCode {
     MESSAGE_NOT_FOUND = "ANALYTICS_MESSAGE_NOT_FOUND",
+    /** `tz` синтаксически прошёл схему, но такой зоны нет в базе IANA. */
     INVALID_TIMEZONE = "ANALYTICS_INVALID_TIMEZONE"
 }
 export declare const ANALYTICS_ERRORS: Record<AnalyticsErrorCode, ErrorMetadata>;

package/build/v1/analytics/analytics.errors.js

@@ -1,9 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ANALYTICS_ERRORS = exports.AnalyticsErrorCode = void 0;
+/**
+ * Errors surfaced by the usage-analytics endpoints. Kept in its own
+ * namespace so the analytics module never depends on billing's error
+ * surface.
+ *
+ * `MESSAGE_NOT_FOUND` deliberately collapses both "no such message"
+ * and "message owned by someone else" — the IDOR-safe guard in the
+ * detail handler returns the same code for both branches so an
+ * attacker can't distinguish.
+ */
 var AnalyticsErrorCode;
 (function (AnalyticsErrorCode) {
     AnalyticsErrorCode["MESSAGE_NOT_FOUND"] = "ANALYTICS_MESSAGE_NOT_FOUND";
+    /** `tz` синтаксически прошёл схему, но такой зоны нет в базе IANA. */
     AnalyticsErrorCode["INVALID_TIMEZONE"] = "ANALYTICS_INVALID_TIMEZONE";
 })(AnalyticsErrorCode || (exports.AnalyticsErrorCode = AnalyticsErrorCode = {}));
 exports.ANALYTICS_ERRORS = {

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

@@ -1 +1 @@
-{"version":3,"file":"analytics.errors.js","sourceRoot":"","sources":["../../../v1/analytics/analytics.errors.ts"],"names":[],"mappings":";;;AAYA,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,uEAAiD,CAAA;IAEjD,qEAA+C,CAAA;AACnD,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAEY,QAAA,gBAAgB,GAA8C;IACvE,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,EAAE;QACpC,IAAI,EAAE,kBAAkB,CAAC,iBAAiB;QAC1C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE;QACnC,IAAI,EAAE,kBAAkB,CAAC,gBAAgB;QACzC,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}
+{"version":3,"file":"analytics.errors.js","sourceRoot":"","sources":["../../../v1/analytics/analytics.errors.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;GASG;AACH,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC1B,uEAAiD,CAAA;IACjD,sEAAsE;IACtE,qEAA+C,CAAA;AACnD,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAEY,QAAA,gBAAgB,GAA8C;IACvE,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,EAAE;QACpC,IAAI,EAAE,kBAAkB,CAAC,iBAAiB;QAC1C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE;QACnC,IAAI,EAAE,kBAAkB,CAAC,gBAAgB;QACzC,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}

package/build/v1/analytics/queries/heatmap.query.d.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * GET /api/v1/analytics/heatmap
+ *
+ * Сообщения пользователя (`role = USER`), сгруппированные по календарным
+ * суткам запрошенной зоны. Сутки режутся на сервере — клиент подставляет
+ * пришедшие даты как есть, без повторного разбора через `new Date()`.
+ */
 export declare namespace AnalyticsHeatmapQuery {
     const Request: z.ZodObject<{
         days: z.ZodDefault<z.ZodCoercedNumber<unknown>>;

package/build/v1/analytics/queries/heatmap.query.js

@@ -4,6 +4,13 @@ exports.AnalyticsHeatmapQuery = void 0;
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * GET /api/v1/analytics/heatmap
+ *
+ * Сообщения пользователя (`role = USER`), сгруппированные по календарным
+ * суткам запрошенной зоны. Сутки режутся на сервере — клиент подставляет
+ * пришедшие даты как есть, без повторного разбора через `new Date()`.
+ */
 var AnalyticsHeatmapQuery;
 (function (AnalyticsHeatmapQuery) {
     AnalyticsHeatmapQuery.Request = schemas_1.UsageHeatmapRequestSchema;

package/build/v1/analytics/queries/heatmap.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"heatmap.query.js","sourceRoot":"","sources":["../../../../v1/analytics/queries/heatmap.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAS9D,IAAiB,qBAAqB,CASrC;AATD,WAAiB,qBAAqB;IACrB,6BAAO,GAAG,mCAAyB,CAAC;IACpC,8BAAQ,GAAG,oCAA0B,CAAC;IAEtC,yBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;IACxC,4BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,qBAAqB,qCAArB,qBAAqB,QASrC"}
+{"version":3,"file":"heatmap.query.js","sourceRoot":"","sources":["../../../../v1/analytics/queries/heatmap.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;;GAMG;AACH,IAAiB,qBAAqB,CASrC;AATD,WAAiB,qBAAqB;IACrB,6BAAO,GAAG,mCAAyB,CAAC;IACpC,8BAAQ,GAAG,oCAA0B,CAAC;IAEtC,yBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;IACxC,4BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,qBAAqB,qCAArB,qBAAqB,QASrC"}

package/build/v1/analytics/queries/list-messages.query.d.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * GET /api/v1/analytics/messages
+ *
+ * Cursor-paginated history of the caller's AI messages with the
+ * user-paid amount, model + provider, finish reason and step count —
+ * the row a click takes the user from to the drill-down.
+ */
 export declare namespace AnalyticsListMessagesQuery {
     const Request: z.ZodObject<{
         from: z.ZodOptional<z.ZodString>;

package/build/v1/analytics/queries/list-messages.query.js

@@ -4,6 +4,13 @@ exports.AnalyticsListMessagesQuery = void 0;
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * GET /api/v1/analytics/messages
+ *
+ * Cursor-paginated history of the caller's AI messages with the
+ * user-paid amount, model + provider, finish reason and step count —
+ * the row a click takes the user from to the drill-down.
+ */
 var AnalyticsListMessagesQuery;
 (function (AnalyticsListMessagesQuery) {
     AnalyticsListMessagesQuery.Request = schemas_1.UsageMessagesListRequestSchema;

package/build/v1/analytics/queries/list-messages.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-messages.query.js","sourceRoot":"","sources":["../../../../v1/analytics/queries/list-messages.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAS9D,IAAiB,0BAA0B,CAS1C;AATD,WAAiB,0BAA0B;IAC1B,kCAAO,GAAG,wCAA8B,CAAC;IACzC,mCAAQ,GAAG,yCAA+B,CAAC;IAE3C,8BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;IACzC,iCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,0BAA0B,0CAA1B,0BAA0B,QAS1C"}
+{"version":3,"file":"list-messages.query.js","sourceRoot":"","sources":["../../../../v1/analytics/queries/list-messages.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;;GAMG;AACH,IAAiB,0BAA0B,CAS1C;AATD,WAAiB,0BAA0B;IAC1B,kCAAO,GAAG,wCAA8B,CAAC;IACzC,mCAAQ,GAAG,yCAA+B,CAAC;IAE3C,8BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;IACzC,iCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,0BAA0B,0CAA1B,0BAA0B,QAS1C"}

package/build/v1/analytics/queries/message-details.query.d.ts

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * GET /api/v1/analytics/messages/:messageId
+ *
+ * Drill-down for one message: header (status/finishReason/model/provider),
+ * totals (internal cost, duration), and the per-step timeline. Mappers
+ * strip every internal/leaky field — see the strip-spec for the full
+ * blacklist.
+ */
 export declare namespace AnalyticsMessageDetailsQuery {
     const Params: z.ZodObject<{
         messageId: z.ZodString;

package/build/v1/analytics/queries/message-details.query.js

@@ -5,6 +5,14 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * GET /api/v1/analytics/messages/:messageId
+ *
+ * Drill-down for one message: header (status/finishReason/model/provider),
+ * totals (internal cost, duration), and the per-step timeline. Mappers
+ * strip every internal/leaky field — see the strip-spec for the full
+ * blacklist.
+ */
 var AnalyticsMessageDetailsQuery;
 (function (AnalyticsMessageDetailsQuery) {
     AnalyticsMessageDetailsQuery.Params = zod_1.z.object({

package/build/v1/analytics/queries/message-details.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-details.query.js","sourceRoot":"","sources":["../../../../v1/analytics/queries/message-details.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA+D;AAC/D,gDAA6C;AAC7C,uEAA8D;AAU9D,IAAiB,4BAA4B,CAY5C;AAZD,WAAiB,4BAA4B;IAC5B,mCAAM,GAAG,OAAC,CAAC,MAAM,CAAC;QAC3B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;KAC/B,CAAC,CAAC;IACU,qCAAQ,GAAG,2CAAiC,CAAC;IAE7C,gCAAG,GAAG,CAAC,SAAiB,EAAE,EAAE,CACrC,mBAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC5C,mCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAZgB,4BAA4B,4CAA5B,4BAA4B,QAY5C"}
+{"version":3,"file":"message-details.query.js","sourceRoot":"","sources":["../../../../v1/analytics/queries/message-details.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA+D;AAC/D,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;;;GAOG;AACH,IAAiB,4BAA4B,CAY5C;AAZD,WAAiB,4BAA4B;IAC5B,mCAAM,GAAG,OAAC,CAAC,MAAM,CAAC;QAC3B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;KAC/B,CAAC,CAAC;IACU,qCAAQ,GAAG,2CAAiC,CAAC;IAE7C,gCAAG,GAAG,CAAC,SAAiB,EAAE,EAAE,CACrC,mBAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC5C,mCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EAZgB,4BAA4B,4CAA5B,4BAA4B,QAY5C"}

package/build/v1/analytics/queries/requests-chart.query.d.ts

@@ -1,5 +1,14 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * GET /api/v1/analytics/requests-chart
+ *
+ * Same shape as the spend chart but `data` carries request counts:
+ *   - LLM steps   → COUNT(DISTINCT external_id)   (one gen = one request)
+ *   - Tool steps  → COUNT(*)                        (one row per call)
+ *
+ * Response unit is always `requests`.
+ */
 export declare namespace AnalyticsRequestsChartQuery {
     const Request: z.ZodObject<{
         from: z.ZodOptional<z.ZodString>;

package/build/v1/analytics/queries/requests-chart.query.js

@@ -4,6 +4,15 @@ exports.AnalyticsRequestsChartQuery = void 0;
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * GET /api/v1/analytics/requests-chart
+ *
+ * Same shape as the spend chart but `data` carries request counts:
+ *   - LLM steps   → COUNT(DISTINCT external_id)   (one gen = one request)
+ *   - Tool steps  → COUNT(*)                        (one row per call)
+ *
+ * Response unit is always `requests`.
+ */
 var AnalyticsRequestsChartQuery;
 (function (AnalyticsRequestsChartQuery) {
     AnalyticsRequestsChartQuery.Request = schemas_1.UsageChartRequestSchema;

package/build/v1/analytics/queries/requests-chart.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"requests-chart.query.js","sourceRoot":"","sources":["../../../../v1/analytics/queries/requests-chart.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAW9D,IAAiB,2BAA2B,CAS3C;AATD,WAAiB,2BAA2B;IAC3B,mCAAO,GAAG,iCAAuB,CAAC;IAClC,oCAAQ,GAAG,kCAAwB,CAAC;IAEpC,+BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC;IAC/C,kCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,2BAA2B,2CAA3B,2BAA2B,QAS3C"}
+{"version":3,"file":"requests-chart.query.js","sourceRoot":"","sources":["../../../../v1/analytics/queries/requests-chart.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;;;;GAQG;AACH,IAAiB,2BAA2B,CAS3C;AATD,WAAiB,2BAA2B;IAC3B,mCAAO,GAAG,iCAAuB,CAAC;IAClC,oCAAQ,GAAG,kCAAwB,CAAC;IAEpC,+BAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC;IAC/C,kCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,2BAA2B,2CAA3B,2BAA2B,QAS3C"}

package/build/v1/analytics/queries/spend-chart.query.d.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * GET /api/v1/analytics/spend-chart
+ *
+ * Stacked-bar series of the caller's spend (in our token currency) over
+ * the requested range, broken down by model (LLM steps) or tool type
+ * (CODE_EXECUTION / WEB_SEARCH / ...). Response unit is always `tokens`.
+ */
 export declare namespace AnalyticsSpendChartQuery {
     const Request: z.ZodObject<{
         from: z.ZodOptional<z.ZodString>;