@studyfetch/sdk 1.32.0 → 1.34.0

package/resources/v1/usage-analyst.d.mts

@@ -0,0 +1,99 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class UsageAnalyst extends APIResource {
+    /**
+     * Get test results with full question data for user or group
+     *
+     * @example
+     * ```ts
+     * await client.v1.usageAnalyst.getTestQuestions();
+     * ```
+     */
+    getTestQuestions(query?: UsageAnalystGetTestQuestionsParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get all chat messages from sessions for user or group
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.usageAnalyst.listChatMessages();
+     * ```
+     */
+    listChatMessages(query?: UsageAnalystListChatMessagesParams | null | undefined, options?: RequestOptions): APIPromise<UsageAnalystListChatMessagesResponse>;
+    /**
+     * Get all events based on filters
+     *
+     * @example
+     * ```ts
+     * await client.v1.usageAnalyst.listEvents({
+     *   endDate: 'endDate',
+     *   eventType: 'material_created',
+     *   startDate: 'startDate',
+     * });
+     * ```
+     */
+    listEvents(query: UsageAnalystListEventsParams, options?: RequestOptions): APIPromise<void>;
+}
+export interface UsageAnalystListChatMessagesResponse {
+    messages?: Array<UsageAnalystListChatMessagesResponse.Message>;
+    sessionCount?: number;
+    total?: number;
+}
+export declare namespace UsageAnalystListChatMessagesResponse {
+    interface Message {
+        componentId?: string;
+        content?: string;
+        createdAt?: string;
+        metadata?: unknown;
+        role?: 'user' | 'assistant' | 'system';
+        sessionId?: string;
+        userId?: string;
+    }
+}
+export interface UsageAnalystGetTestQuestionsParams {
+    /**
+     * Array of group IDs to filter
+     */
+    groupIds?: Array<string>;
+    /**
+     * User ID to get test results for
+     */
+    userId?: string;
+}
+export interface UsageAnalystListChatMessagesParams {
+    /**
+     * Array of group IDs to filter
+     */
+    groupIds?: Array<string>;
+    /**
+     * User ID to get chat messages for
+     */
+    userId?: string;
+}
+export interface UsageAnalystListEventsParams {
+    /**
+     * End date for filtering (ISO 8601)
+     */
+    endDate: string;
+    /**
+     * Type of usage event to filter
+     */
+    eventType: 'material_created' | 'material_uploaded' | 'material_processed' | 'material_deleted' | 'component_created' | 'component_accessed' | 'component_deleted' | 'component_usage' | 'chat_message_sent' | 'chat_session_started' | 'chat_session_ended' | 'chat_feedback' | 'test_created' | 'test_started' | 'test_completed' | 'test_question_answered' | 'test_retaken' | 'audio_recap_create' | 'assignment_grader_create' | 'api_call' | 'cache_hit' | 'sso_login' | 'sso_logout' | 'student_performance';
+    /**
+     * Start date for filtering (ISO 8601)
+     */
+    startDate: string;
+    /**
+     * Array of group IDs to filter
+     */
+    groupIds?: Array<string>;
+    /**
+     * Array of user IDs to filter
+     */
+    userIds?: Array<string>;
+}
+export declare namespace UsageAnalyst {
+    export { type UsageAnalystListChatMessagesResponse as UsageAnalystListChatMessagesResponse, type UsageAnalystGetTestQuestionsParams as UsageAnalystGetTestQuestionsParams, type UsageAnalystListChatMessagesParams as UsageAnalystListChatMessagesParams, type UsageAnalystListEventsParams as UsageAnalystListEventsParams, };
+}
+//# sourceMappingURL=usage-analyst.d.mts.map

package/resources/v1/usage-analyst.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-analyst.d.mts","sourceRoot":"","sources":["../../src/resources/v1/usage-analyst.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;OAOG;IACH,gBAAgB,CACd,KAAK,GAAE,kCAAkC,GAAG,IAAI,GAAG,SAAc,EACjE,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,IAAI,CAAC;IAQnB;;;;;;;;OAQG;IACH,gBAAgB,CACd,KAAK,GAAE,kCAAkC,GAAG,IAAI,GAAG,SAAc,EACjE,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oCAAoC,CAAC;IAInD;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAK,EAAE,4BAA4B,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO5F;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,EAAE,KAAK,CAAC,oCAAoC,CAAC,OAAO,CAAC,CAAC;IAE/D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yBAAiB,oCAAoC,CAAC;IACpD,UAAiB,OAAO;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QAEvC,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CACF;AAED,MAAM,WAAW,kCAAkC;IACjD;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kCAAkC;IACjD;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EACL,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,wBAAwB,GACxB,cAAc,GACd,oBAAoB,GACpB,0BAA0B,GAC1B,UAAU,GACV,WAAW,GACX,WAAW,GACX,YAAY,GACZ,qBAAqB,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,oCAAoC,IAAI,oCAAoC,EACjF,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/v1/usage-analyst.d.ts

@@ -0,0 +1,99 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class UsageAnalyst extends APIResource {
+    /**
+     * Get test results with full question data for user or group
+     *
+     * @example
+     * ```ts
+     * await client.v1.usageAnalyst.getTestQuestions();
+     * ```
+     */
+    getTestQuestions(query?: UsageAnalystGetTestQuestionsParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get all chat messages from sessions for user or group
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.v1.usageAnalyst.listChatMessages();
+     * ```
+     */
+    listChatMessages(query?: UsageAnalystListChatMessagesParams | null | undefined, options?: RequestOptions): APIPromise<UsageAnalystListChatMessagesResponse>;
+    /**
+     * Get all events based on filters
+     *
+     * @example
+     * ```ts
+     * await client.v1.usageAnalyst.listEvents({
+     *   endDate: 'endDate',
+     *   eventType: 'material_created',
+     *   startDate: 'startDate',
+     * });
+     * ```
+     */
+    listEvents(query: UsageAnalystListEventsParams, options?: RequestOptions): APIPromise<void>;
+}
+export interface UsageAnalystListChatMessagesResponse {
+    messages?: Array<UsageAnalystListChatMessagesResponse.Message>;
+    sessionCount?: number;
+    total?: number;
+}
+export declare namespace UsageAnalystListChatMessagesResponse {
+    interface Message {
+        componentId?: string;
+        content?: string;
+        createdAt?: string;
+        metadata?: unknown;
+        role?: 'user' | 'assistant' | 'system';
+        sessionId?: string;
+        userId?: string;
+    }
+}
+export interface UsageAnalystGetTestQuestionsParams {
+    /**
+     * Array of group IDs to filter
+     */
+    groupIds?: Array<string>;
+    /**
+     * User ID to get test results for
+     */
+    userId?: string;
+}
+export interface UsageAnalystListChatMessagesParams {
+    /**
+     * Array of group IDs to filter
+     */
+    groupIds?: Array<string>;
+    /**
+     * User ID to get chat messages for
+     */
+    userId?: string;
+}
+export interface UsageAnalystListEventsParams {
+    /**
+     * End date for filtering (ISO 8601)
+     */
+    endDate: string;
+    /**
+     * Type of usage event to filter
+     */
+    eventType: 'material_created' | 'material_uploaded' | 'material_processed' | 'material_deleted' | 'component_created' | 'component_accessed' | 'component_deleted' | 'component_usage' | 'chat_message_sent' | 'chat_session_started' | 'chat_session_ended' | 'chat_feedback' | 'test_created' | 'test_started' | 'test_completed' | 'test_question_answered' | 'test_retaken' | 'audio_recap_create' | 'assignment_grader_create' | 'api_call' | 'cache_hit' | 'sso_login' | 'sso_logout' | 'student_performance';
+    /**
+     * Start date for filtering (ISO 8601)
+     */
+    startDate: string;
+    /**
+     * Array of group IDs to filter
+     */
+    groupIds?: Array<string>;
+    /**
+     * Array of user IDs to filter
+     */
+    userIds?: Array<string>;
+}
+export declare namespace UsageAnalyst {
+    export { type UsageAnalystListChatMessagesResponse as UsageAnalystListChatMessagesResponse, type UsageAnalystGetTestQuestionsParams as UsageAnalystGetTestQuestionsParams, type UsageAnalystListChatMessagesParams as UsageAnalystListChatMessagesParams, type UsageAnalystListEventsParams as UsageAnalystListEventsParams, };
+}
+//# sourceMappingURL=usage-analyst.d.ts.map

package/resources/v1/usage-analyst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-analyst.d.ts","sourceRoot":"","sources":["../../src/resources/v1/usage-analyst.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;OAOG;IACH,gBAAgB,CACd,KAAK,GAAE,kCAAkC,GAAG,IAAI,GAAG,SAAc,EACjE,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,IAAI,CAAC;IAQnB;;;;;;;;OAQG;IACH,gBAAgB,CACd,KAAK,GAAE,kCAAkC,GAAG,IAAI,GAAG,SAAc,EACjE,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oCAAoC,CAAC;IAInD;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAK,EAAE,4BAA4B,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO5F;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,EAAE,KAAK,CAAC,oCAAoC,CAAC,OAAO,CAAC,CAAC;IAE/D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yBAAiB,oCAAoC,CAAC;IACpD,UAAiB,OAAO;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QAEvC,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CACF;AAED,MAAM,WAAW,kCAAkC;IACjD;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kCAAkC;IACjD;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EACL,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,wBAAwB,GACxB,cAAc,GACd,oBAAoB,GACpB,0BAA0B,GAC1B,UAAU,GACV,WAAW,GACX,WAAW,GACX,YAAY,GACZ,qBAAqB,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,oCAAoC,IAAI,oCAAoC,EACjF,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/v1/{usage/analyst.js → usage-analyst.js}

@@ -1,16 +1,16 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Analyst = void 0;
-const resource_1 = require("../../../core/resource.js");
-const headers_1 = require("../../../internal/headers.js");
-class Analyst extends resource_1.APIResource {
+exports.UsageAnalyst = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+class UsageAnalyst extends resource_1.APIResource {
     /**
      * Get test results with full question data for user or group
      *
      * @example
      * ```ts
-     * await client.v1.usage.analyst.getTestQuestions();
+     * await client.v1.usageAnalyst.getTestQuestions();
      * ```
      */
     getTestQuestions(query = {}, options) {
@@ -26,7 +26,7 @@ class Analyst extends resource_1.APIResource {
      * @example
      * ```ts
      * const response =
-     *   await client.v1.usage.analyst.listChatMessages();
+     *   await client.v1.usageAnalyst.listChatMessages();
      * ```
      */
     listChatMessages(query = {}, options) {
@@ -37,7 +37,7 @@ class Analyst extends resource_1.APIResource {
      *
      * @example
      * ```ts
-     * await client.v1.usage.analyst.listEvents({
+     * await client.v1.usageAnalyst.listEvents({
      *   endDate: 'endDate',
      *   eventType: 'material_created',
      *   startDate: 'startDate',
@@ -52,5 +52,5 @@ class Analyst extends resource_1.APIResource {
         });
     }
 }
-exports.Analyst = Analyst;
-//# sourceMappingURL=analyst.js.map
+exports.UsageAnalyst = UsageAnalyst;
+//# sourceMappingURL=usage-analyst.js.map

package/resources/v1/usage-analyst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-analyst.js","sourceRoot":"","sources":["../../src/resources/v1/usage-analyst.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAGtD,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;OAOG;IACH,gBAAgB,CACd,QAA+D,EAAE,EACjE,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sCAAsC,EAAE;YAC9D,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,gBAAgB,CACd,QAA+D,EAAE,EACjE,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAmC,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE;YACtD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAvDD,oCAuDC"}

package/resources/v1/{usage/analyst.mjs → usage-analyst.mjs}

@@ -1,13 +1,13 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { APIResource } from "../../../core/resource.mjs";
-import { buildHeaders } from "../../../internal/headers.mjs";
-export class Analyst extends APIResource {
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+export class UsageAnalyst extends APIResource {
     /**
      * Get test results with full question data for user or group
      *
      * @example
      * ```ts
-     * await client.v1.usage.analyst.getTestQuestions();
+     * await client.v1.usageAnalyst.getTestQuestions();
      * ```
      */
     getTestQuestions(query = {}, options) {
@@ -23,7 +23,7 @@ export class Analyst extends APIResource {
      * @example
      * ```ts
      * const response =
-     *   await client.v1.usage.analyst.listChatMessages();
+     *   await client.v1.usageAnalyst.listChatMessages();
      * ```
      */
     listChatMessages(query = {}, options) {
@@ -34,7 +34,7 @@ export class Analyst extends APIResource {
      *
      * @example
      * ```ts
-     * await client.v1.usage.analyst.listEvents({
+     * await client.v1.usageAnalyst.listEvents({
      *   endDate: 'endDate',
      *   eventType: 'material_created',
      *   startDate: 'startDate',
@@ -49,4 +49,4 @@ export class Analyst extends APIResource {
         });
     }
 }
-//# sourceMappingURL=analyst.mjs.map
+//# sourceMappingURL=usage-analyst.mjs.map

package/resources/v1/usage-analyst.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-analyst.mjs","sourceRoot":"","sources":["../../src/resources/v1/usage-analyst.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;AAGvB,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;OAOG;IACH,gBAAgB,CACd,QAA+D,EAAE,EACjE,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sCAAsC,EAAE;YAC9D,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,gBAAgB,CACd,QAA+D,EAAE,EACjE,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAmC,EAAE,OAAwB;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE;YACtD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/v1/usage.d.mts

@@ -1,2 +1,110 @@
-export * from "./usage/index.mjs";
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Usage extends APIResource {
+    /**
+     * Get usage statistics
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.getStats();
+     * ```
+     */
+    getStats(query?: UsageGetStatsParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get usage summary
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.getSummary({
+     *   endDate: 'endDate',
+     *   period: 'hourly',
+     *   startDate: 'startDate',
+     * });
+     * ```
+     */
+    getSummary(query: UsageGetSummaryParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get usage events
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.listEvents();
+     * ```
+     */
+    listEvents(query?: UsageListEventsParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+}
+export interface UsageGetStatsParams {
+    /**
+     * End date for stats (ISO 8601)
+     */
+    endDate?: string;
+    /**
+     * Filter by group ID
+     */
+    groupId?: string;
+    /**
+     * Start date for stats (ISO 8601)
+     */
+    startDate?: string;
+    /**
+     * Filter by user ID
+     */
+    userId?: string;
+}
+export interface UsageGetSummaryParams {
+    /**
+     * End date for summary (ISO 8601)
+     */
+    endDate: string;
+    /**
+     * Summary period
+     */
+    period: 'hourly' | 'daily' | 'monthly';
+    /**
+     * Start date for summary (ISO 8601)
+     */
+    startDate: string;
+    /**
+     * Group results by
+     */
+    groupBy?: 'user' | 'group' | 'model' | 'endpoint';
+}
+export interface UsageListEventsParams {
+    /**
+     * End date for filtering (ISO 8601)
+     */
+    endDate?: string;
+    /**
+     * Filter by event type
+     */
+    eventType?: 'material_created' | 'material_uploaded' | 'material_processed' | 'material_deleted' | 'component_created' | 'component_accessed' | 'component_deleted' | 'component_usage' | 'chat_message_sent' | 'chat_session_started' | 'chat_session_ended' | 'chat_feedback' | 'test_created' | 'test_started' | 'test_completed' | 'test_question_answered' | 'test_retaken' | 'audio_recap_create' | 'assignment_grader_create' | 'api_call' | 'cache_hit' | 'sso_login' | 'sso_logout' | 'student_performance';
+    /**
+     * Filter by group ID
+     */
+    groupId?: string;
+    /**
+     * Number of results to return
+     */
+    limit?: number;
+    /**
+     * Offset for pagination
+     */
+    offset?: number;
+    /**
+     * Filter by resource ID
+     */
+    resourceId?: string;
+    /**
+     * Start date for filtering (ISO 8601)
+     */
+    startDate?: string;
+    /**
+     * Filter by user ID
+     */
+    userId?: string;
+}
+export declare namespace Usage {
+    export { type UsageGetStatsParams as UsageGetStatsParams, type UsageGetSummaryParams as UsageGetSummaryParams, type UsageListEventsParams as UsageListEventsParams, };
+}
 //# sourceMappingURL=usage.d.mts.map

package/resources/v1/usage.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.mts","sourceRoot":"","sources":["../../src/resources/v1/usage.ts"],"names":[],"mappings":""}
+{"version":3,"file":"usage.d.mts","sourceRoot":"","sources":["../../src/resources/v1/usage.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQxG;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAK,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQpF;;;;;;;OAOG;IACH,UAAU,CACR,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,IAAI,CAAC;CAOpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAEvC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EACN,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,wBAAwB,GACxB,cAAc,GACd,oBAAoB,GACpB,0BAA0B,GAC1B,UAAU,GACV,WAAW,GACX,WAAW,GACX,YAAY,GACZ,qBAAqB,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}

package/resources/v1/usage.d.ts

@@ -1,2 +1,110 @@
-export * from "./usage/index.js";
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Usage extends APIResource {
+    /**
+     * Get usage statistics
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.getStats();
+     * ```
+     */
+    getStats(query?: UsageGetStatsParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get usage summary
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.getSummary({
+     *   endDate: 'endDate',
+     *   period: 'hourly',
+     *   startDate: 'startDate',
+     * });
+     * ```
+     */
+    getSummary(query: UsageGetSummaryParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get usage events
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.listEvents();
+     * ```
+     */
+    listEvents(query?: UsageListEventsParams | null | undefined, options?: RequestOptions): APIPromise<void>;
+}
+export interface UsageGetStatsParams {
+    /**
+     * End date for stats (ISO 8601)
+     */
+    endDate?: string;
+    /**
+     * Filter by group ID
+     */
+    groupId?: string;
+    /**
+     * Start date for stats (ISO 8601)
+     */
+    startDate?: string;
+    /**
+     * Filter by user ID
+     */
+    userId?: string;
+}
+export interface UsageGetSummaryParams {
+    /**
+     * End date for summary (ISO 8601)
+     */
+    endDate: string;
+    /**
+     * Summary period
+     */
+    period: 'hourly' | 'daily' | 'monthly';
+    /**
+     * Start date for summary (ISO 8601)
+     */
+    startDate: string;
+    /**
+     * Group results by
+     */
+    groupBy?: 'user' | 'group' | 'model' | 'endpoint';
+}
+export interface UsageListEventsParams {
+    /**
+     * End date for filtering (ISO 8601)
+     */
+    endDate?: string;
+    /**
+     * Filter by event type
+     */
+    eventType?: 'material_created' | 'material_uploaded' | 'material_processed' | 'material_deleted' | 'component_created' | 'component_accessed' | 'component_deleted' | 'component_usage' | 'chat_message_sent' | 'chat_session_started' | 'chat_session_ended' | 'chat_feedback' | 'test_created' | 'test_started' | 'test_completed' | 'test_question_answered' | 'test_retaken' | 'audio_recap_create' | 'assignment_grader_create' | 'api_call' | 'cache_hit' | 'sso_login' | 'sso_logout' | 'student_performance';
+    /**
+     * Filter by group ID
+     */
+    groupId?: string;
+    /**
+     * Number of results to return
+     */
+    limit?: number;
+    /**
+     * Offset for pagination
+     */
+    offset?: number;
+    /**
+     * Filter by resource ID
+     */
+    resourceId?: string;
+    /**
+     * Start date for filtering (ISO 8601)
+     */
+    startDate?: string;
+    /**
+     * Filter by user ID
+     */
+    userId?: string;
+}
+export declare namespace Usage {
+    export { type UsageGetStatsParams as UsageGetStatsParams, type UsageGetSummaryParams as UsageGetSummaryParams, type UsageListEventsParams as UsageListEventsParams, };
+}
 //# sourceMappingURL=usage.d.ts.map

package/resources/v1/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/v1/usage.ts"],"names":[],"mappings":""}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/v1/usage.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQxG;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAK,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQpF;;;;;;;OAOG;IACH,UAAU,CACR,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,IAAI,CAAC;CAOpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAEvC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EACN,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,wBAAwB,GACxB,cAAc,GACd,oBAAoB,GACpB,0BAA0B,GAC1B,UAAU,GACV,WAAW,GACX,WAAW,GACX,YAAY,GACZ,qBAAqB,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}

package/resources/v1/usage.js

@@ -1,6 +1,59 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("../../internal/tslib.js");
-tslib_1.__exportStar(require("./usage/index.js"), exports);
+exports.Usage = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+class Usage extends resource_1.APIResource {
+    /**
+     * Get usage statistics
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.getStats();
+     * ```
+     */
+    getStats(query = {}, options) {
+        return this._client.get('/api/v1/usage/stats', {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Get usage summary
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.getSummary({
+     *   endDate: 'endDate',
+     *   period: 'hourly',
+     *   startDate: 'startDate',
+     * });
+     * ```
+     */
+    getSummary(query, options) {
+        return this._client.get('/api/v1/usage/summary', {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Get usage events
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.listEvents();
+     * ```
+     */
+    listEvents(query = {}, options) {
+        return this._client.get('/api/v1/usage/events', {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Usage = Usage;
 //# sourceMappingURL=usage.js.map

package/resources/v1/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/v1/usage.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAA8B"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/v1/usage.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAGtD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAgD,EAAE,EAAE,OAAwB;QACnF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE;YAC7C,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAA4B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE;YAC/C,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CACR,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE;YAC9C,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAvDD,sBAuDC"}

package/resources/v1/usage.mjs

@@ -1,3 +1,55 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-export * from "./usage/index.mjs";
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+export class Usage extends APIResource {
+    /**
+     * Get usage statistics
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.getStats();
+     * ```
+     */
+    getStats(query = {}, options) {
+        return this._client.get('/api/v1/usage/stats', {
+            query,
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Get usage summary
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.getSummary({
+     *   endDate: 'endDate',
+     *   period: 'hourly',
+     *   startDate: 'startDate',
+     * });
+     * ```
+     */
+    getSummary(query, options) {
+        return this._client.get('/api/v1/usage/summary', {
+            query,
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Get usage events
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.listEvents();
+     * ```
+     */
+    listEvents(query = {}, options) {
+        return this._client.get('/api/v1/usage/events', {
+            query,
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
 //# sourceMappingURL=usage.mjs.map