@iblai/data-layer 1.12.5 → 1.12.7

package/dist/src/features/spend-caps/constants.d.ts

@@ -0,0 +1,66 @@
+import { SERVICES } from '@data-layer/constants';
+export declare const SPEND_CAPS_REDUCER_PATH = "spendCapsApiSlice";
+/**
+ * Error code returned (HTTP 429 body / WebSocket frame) when a hard-block
+ * spend cap is exceeded. Distinguishes a spend-cap block from a genuine
+ * provider rate limit, which also uses status 429.
+ */
+export declare const SPEND_CAP_EXCEEDED_ERROR_CODE = "spend_cap_exceeded";
+export declare const SPEND_CAPS_ENDPOINTS: {
+    GET_TENANT_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string) => string;
+    };
+    UPSERT_TENANT_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string) => string;
+    };
+    DELETE_TENANT_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string) => string;
+    };
+    LIST_AGENT_SPEND_CAPS: {
+        service: SERVICES;
+        path: (org: string) => string;
+    };
+    GET_AGENT_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string, mentorId: string) => string;
+    };
+    UPSERT_AGENT_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string, mentorId: string) => string;
+    };
+    DELETE_AGENT_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string, mentorId: string) => string;
+    };
+    LIST_AGENT_USER_SPEND_CAPS: {
+        service: SERVICES;
+        path: (org: string, mentorId: string) => string;
+    };
+    GET_USER_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string, mentorId: string, username: string) => string;
+    };
+    UPSERT_USER_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string, mentorId: string, username: string) => string;
+    };
+    DELETE_USER_SPEND_CAP: {
+        service: SERVICES;
+        path: (org: string, mentorId: string, username: string) => string;
+    };
+    GET_SPEND_CAP_STATUS: {
+        service: SERVICES;
+        path: (org: string, userId: string) => string;
+    };
+};
+export declare const SPEND_CAPS_QUERY_KEYS: {
+    readonly TENANT_SPEND_CAP: "TENANT_SPEND_CAP";
+    readonly AGENT_SPEND_CAP: "AGENT_SPEND_CAP";
+    readonly AGENT_SPEND_CAPS_LIST: "AGENT_SPEND_CAPS_LIST";
+    readonly AGENT_USER_SPEND_CAPS: "AGENT_USER_SPEND_CAPS";
+    readonly USER_SPEND_CAP: "USER_SPEND_CAP";
+    readonly SPEND_CAP_STATUS: "SPEND_CAP_STATUS";
+};

package/dist/src/features/spend-caps/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api-slice';
+export * from './types';
+export * from './constants';
+export * from './utils';

package/dist/src/features/spend-caps/types.d.ts

@@ -0,0 +1,121 @@
+import { SPEND_CAP_EXCEEDED_ERROR_CODE } from './constants';
+export type SpendCapScope = 'tenant' | 'agent' | 'user_agent';
+export type SpendCapIntervalType = 'day' | 'week' | 'month' | 'year';
+export type SpendCapEnforcement = 'block' | 'alert_only';
+export interface SpendCap {
+    id: number;
+    scope: SpendCapScope;
+    platform_key: string;
+    mentor_unique_id: string | null;
+    /** Agent display name — present on agent-scoped caps from the list endpoint. */
+    mentor_name?: string | null;
+    username: string | null;
+    /** User email — present on user-per-agent caps. */
+    email?: string | null;
+    interval_type: SpendCapIntervalType;
+    max_cost_usd: string;
+    enforcement: SpendCapEnforcement;
+    alert_thresholds: number[];
+    enabled: boolean;
+    period_started_at: string | null;
+    current_spend_usd: string;
+    remaining_usd: string;
+    is_exceeded: boolean;
+    last_reconciled_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface SpendCapUpsertRequest {
+    interval_type: SpendCapIntervalType;
+    max_cost_usd: string;
+    enforcement?: SpendCapEnforcement;
+    alert_thresholds?: number[];
+    enabled?: boolean;
+}
+export type SpendCapStatusZone = 'ok' | 'warning' | 'exceeded';
+export interface SpendCapStatusItem {
+    scope: SpendCapScope;
+    interval_type: SpendCapIntervalType;
+    enforcement: SpendCapEnforcement;
+    status: SpendCapStatusZone;
+    percent_used: number;
+    warning_threshold: number | null;
+    mentor_unique_id: string | null;
+    username: string | null;
+}
+export interface SpendCapStatusSummary {
+    status: SpendCapStatusZone;
+    blocked: boolean;
+    caps: SpendCapStatusItem[];
+}
+export interface SpendCapExceededDetails {
+    scope: SpendCapScope;
+    interval_type: SpendCapIntervalType;
+    mentor_unique_id: string | null;
+}
+export interface SpendCapExceededErrorBody {
+    error_code: typeof SPEND_CAP_EXCEEDED_ERROR_CODE;
+    error: string;
+    message: string;
+    details?: SpendCapExceededDetails;
+    status_code?: number;
+}
+export type GetTenantSpendCapArgs = {
+    org: string;
+};
+export type UpsertTenantSpendCapArgs = {
+    org: string;
+    formData: SpendCapUpsertRequest;
+};
+export type DeleteTenantSpendCapArgs = {
+    org: string;
+};
+export type GetAgentSpendCapArgs = {
+    org: string;
+    mentorId: string;
+};
+export type UpsertAgentSpendCapArgs = {
+    org: string;
+    mentorId: string;
+    formData: SpendCapUpsertRequest;
+};
+export type DeleteAgentSpendCapArgs = {
+    org: string;
+    mentorId: string;
+};
+export type ListAgentSpendCapsArgs = {
+    org: string;
+    /** Optional mentor unique_id — server-side filter supported by the endpoint. */
+    mentor?: string;
+};
+export type ListAgentUserSpendCapsArgs = {
+    org: string;
+    mentorId: string;
+};
+export type GetUserSpendCapArgs = {
+    org: string;
+    mentorId: string;
+    username: string;
+};
+export type UpsertUserSpendCapArgs = {
+    org: string;
+    mentorId: string;
+    username: string;
+    formData: SpendCapUpsertRequest;
+};
+export type DeleteUserSpendCapArgs = {
+    org: string;
+    mentorId: string;
+    username: string;
+};
+export type GetSpendCapStatusArgs = {
+    org: string;
+    userId: string;
+    mentor?: string;
+};
+export type PaginatedSpendCapsResponse = {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: SpendCap[];
+};

package/dist/src/features/spend-caps/utils.d.ts

@@ -0,0 +1,12 @@
+import { SpendCapExceededErrorBody } from './types';
+/**
+ * True when `body` is a spend-cap-exceeded error body — an object whose
+ * `error_code` is `'spend_cap_exceeded'`. Works for HTTP 429 bodies and
+ * WebSocket error frames alike.
+ */
+export declare const isSpendCapExceededErrorBody: (body: unknown) => body is SpendCapExceededErrorBody;
+/**
+ * Extract the spend-cap-exceeded body from either a raw error body or an RTK
+ * Query error shape (`{ status, data }`). Returns null for anything else.
+ */
+export declare const getSpendCapExceededError: (error: unknown) => SpendCapExceededErrorBody | null;

package/dist/src/index.d.ts

@@ -112,6 +112,10 @@ export * from './features/disclaimers/types';
 export * from './features/grading/api-slice';
 export * from './features/grading/constants';
 export * from './features/grading/types';
+export * from './features/spend-caps/api-slice';
+export * from './features/spend-caps/constants';
+export * from './features/spend-caps/types';
+export * from './features/spend-caps/utils';
 export * from './features/search/ai-search-api-slice';
 export * from './features/search/types';
 export * from './features/search/constants';

package/dist/tests/features/spend-caps/api-slice.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/features/spend-caps/constants.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/features/spend-caps/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/features/spend-caps/types.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/features/spend-caps/utils.test.d.ts

@@ -0,0 +1 @@
+export {};