@studyfetch/sdk 1.1.1 → 1.3.0

package/resources/v1/upload/upload.mjs

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import * as ComponentAPI from "./component.mjs";
+import { Component } from "./component.mjs";
+export class Upload extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.component = new ComponentAPI.Component(this._client);
+    }
+}
+Upload.Component = Component;
+//# sourceMappingURL=upload.mjs.map

package/resources/v1/upload/upload.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.mjs","sourceRoot":"","sources":["../../../src/resources/v1/upload/upload.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EAAE,SAAS,EAAE;AAEpB,MAAM,OAAO,MAAO,SAAQ,WAAW;IAAvC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;CAAA;AAED,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC"}

package/resources/v1/upload.d.mts

@@ -0,0 +1,2 @@
+export * from "./upload/index.mjs";
+//# sourceMappingURL=upload.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.mts","sourceRoot":"","sources":["../../src/resources/v1/upload.ts"],"names":[],"mappings":""}

package/resources/v1/upload.d.ts

@@ -0,0 +1,2 @@
+export * from "./upload/index.js";
+//# sourceMappingURL=upload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/resources/v1/upload.ts"],"names":[],"mappings":""}

package/resources/v1/upload.js

@@ -0,0 +1,6 @@
+"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("./upload/index.js"), exports);
+//# sourceMappingURL=upload.js.map

package/resources/v1/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/resources/v1/upload.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,4DAA+B"}

package/resources/v1/upload.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./upload/index.mjs";
+//# sourceMappingURL=upload.mjs.map

package/resources/v1/upload.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.mjs","sourceRoot":"","sources":["../../src/resources/v1/upload.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/v1/usage.d.mts

@@ -2,18 +2,294 @@ 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 {
-    chat(body: UsageChatParams, options?: RequestOptions): APIPromise<void>;
-    listEvents(options?: RequestOptions): APIPromise<void>;
-    performance(options?: RequestOptions): APIPromise<void>;
-    retrieveStats(options?: RequestOptions): APIPromise<void>;
-    retrieveSummary(options?: RequestOptions): APIPromise<void>;
-    track(body: UsageTrackParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * 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>;
+    /**
+     * Track chat usage
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.trackChat({
+     *   inputTokens: 0,
+     *   model: 'openai:gpt-4.1',
+     *   outputTokens: 0,
+     *   sessionId: 'sessionId',
+     * });
+     * ```
+     */
+    trackChat(body: UsageTrackChatParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Track general usage event
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.trackEvent({
+     *   eventType: 'material_created',
+     * });
+     * ```
+     */
+    trackEvent(body: UsageTrackEventParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Track performance metrics
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.trackPerformance();
+     * ```
+     */
+    trackPerformance(body: UsageTrackPerformanceParams, options?: RequestOptions): APIPromise<void>;
 }
-export interface UsageChatParams {
+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 UsageTrackParams {
+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' | 'test_created' | 'test_started' | 'test_completed' | 'test_question_answered' | 'test_retaken' | 'audio_recap_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 interface UsageTrackChatParams {
+    /**
+     * Number of input tokens
+     */
+    inputTokens: number;
+    /**
+     * AI model used
+     */
+    model: 'openai:gpt-4.1' | 'openai:gpt-4o' | 'openai:gpt-4o-mini' | 'openai:gpt-4' | 'openai:gpt-3.5-turbo' | 'openai:o1' | 'openai:o1-mini' | 'openai:o3-mini' | 'anthropic:claude-3-opus' | 'anthropic:claude-3-sonnet' | 'anthropic:claude-3-haiku' | 'google:gemini-pro' | 'meta:llama-3';
+    /**
+     * Number of output tokens
+     */
+    outputTokens: number;
+    /**
+     * Chat session ID
+     */
+    sessionId: string;
+    /**
+     * Component ID
+     */
+    componentId?: string;
+    /**
+     * Group ID
+     */
+    groupId?: string;
+    /**
+     * Additional metadata
+     */
+    metadata?: unknown;
+    /**
+     * Number of reasoning tokens
+     */
+    reasoningTokens?: number;
+    /**
+     * User ID
+     */
+    userId?: string;
+}
+export interface UsageTrackEventParams {
+    /**
+     * Type of usage event
+     */
+    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' | 'test_created' | 'test_started' | 'test_completed' | 'test_question_answered' | 'test_retaken' | 'audio_recap_create' | 'api_call' | 'cache_hit' | 'sso_login' | 'sso_logout' | 'student_performance';
+    /**
+     * Whether response was served from cache
+     */
+    cacheHit?: boolean;
+    /**
+     * Component name
+     */
+    componentName?: string;
+    /**
+     * Component type
+     */
+    componentType?: string;
+    /**
+     * Size of content in bytes
+     */
+    contentSize?: number;
+    /**
+     * API endpoint accessed
+     */
+    endpoint?: string;
+    /**
+     * File size in bytes
+     */
+    fileSize?: number;
+    /**
+     * File MIME type
+     */
+    fileType?: string;
+    /**
+     * Group ID for collaborative sessions
+     */
+    groupId?: string;
+    /**
+     * Number of input tokens
+     */
+    inputTokens?: number;
+    /**
+     * Client IP address
+     */
+    ipAddress?: string;
+    /**
+     * Additional metadata
+     */
+    metadata?: unknown;
+    /**
+     * HTTP method used
+     */
+    method?: string;
+    /**
+     * AI model used
+     */
+    model?: 'openai:gpt-4.1' | 'openai:gpt-4o' | 'openai:gpt-4o-mini' | 'openai:gpt-4' | 'openai:gpt-3.5-turbo' | 'openai:o1' | 'openai:o1-mini' | 'openai:o3-mini' | 'anthropic:claude-3-opus' | 'anthropic:claude-3-sonnet' | 'anthropic:claude-3-haiku' | 'google:gemini-pro' | 'meta:llama-3';
+    /**
+     * Number of output tokens
+     */
+    outputTokens?: number;
+    /**
+     * Performance metrics data
+     */
+    performanceData?: unknown;
+    /**
+     * Number of reasoning tokens
+     */
+    reasoningTokens?: number;
+    /**
+     * Resource ID being accessed
+     */
+    resourceId?: string;
+    /**
+     * Type of resource
+     */
+    resourceType?: string;
+    /**
+     * Response time in milliseconds
+     */
+    responseTime?: number;
+    /**
+     * Session ID
+     */
+    sessionId?: string;
+    /**
+     * HTTP status code
+     */
+    statusCode?: number;
+    /**
+     * Total number of tokens
+     */
+    totalTokens?: number;
+    /**
+     * Client user agent
+     */
+    userAgent?: string;
+    /**
+     * User ID
+     */
+    userId?: string;
+}
+export interface UsageTrackPerformanceParams {
+    componentId?: string;
+    metrics?: UsageTrackPerformanceParams.Metrics;
+}
+export declare namespace UsageTrackPerformanceParams {
+    interface Metrics {
+        interactionTime?: number;
+        loadTime?: number;
+        renderTime?: number;
+    }
 }
 export declare namespace Usage {
-    export { type UsageChatParams as UsageChatParams, type UsageTrackParams as UsageTrackParams };
+    export { type UsageGetStatsParams as UsageGetStatsParams, type UsageGetSummaryParams as UsageGetSummaryParams, type UsageListEventsParams as UsageListEventsParams, type UsageTrackChatParams as UsageTrackChatParams, type UsageTrackEventParams as UsageTrackEventParams, type UsageTrackPerformanceParams as UsageTrackPerformanceParams, };
 }
 //# 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":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB,qBAAa,KAAM,SAAQ,WAAW;IACpC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAQvE,UAAU,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOtD,WAAW,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOvD,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOzD,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAO3D,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO1E;AAED,MAAM,WAAW,eAAe;CAAG;AAEnC,MAAM,WAAW,gBAAgB;CAAG;AAEpC,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,KAAK,eAAe,IAAI,eAAe,EAAE,KAAK,gBAAgB,IAAI,gBAAgB,EAAE,CAAC;CAC/F"}
+{"version":3,"file":"usage.d.mts","sourceRoot":"","sources":["../../src/resources/v1/usage.ts"],"names":[],"mappings":"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"}

package/resources/v1/usage.d.ts

@@ -2,18 +2,294 @@ 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 {
-    chat(body: UsageChatParams, options?: RequestOptions): APIPromise<void>;
-    listEvents(options?: RequestOptions): APIPromise<void>;
-    performance(options?: RequestOptions): APIPromise<void>;
-    retrieveStats(options?: RequestOptions): APIPromise<void>;
-    retrieveSummary(options?: RequestOptions): APIPromise<void>;
-    track(body: UsageTrackParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * 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>;
+    /**
+     * Track chat usage
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.trackChat({
+     *   inputTokens: 0,
+     *   model: 'openai:gpt-4.1',
+     *   outputTokens: 0,
+     *   sessionId: 'sessionId',
+     * });
+     * ```
+     */
+    trackChat(body: UsageTrackChatParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Track general usage event
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.trackEvent({
+     *   eventType: 'material_created',
+     * });
+     * ```
+     */
+    trackEvent(body: UsageTrackEventParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Track performance metrics
+     *
+     * @example
+     * ```ts
+     * await client.v1.usage.trackPerformance();
+     * ```
+     */
+    trackPerformance(body: UsageTrackPerformanceParams, options?: RequestOptions): APIPromise<void>;
 }
-export interface UsageChatParams {
+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 UsageTrackParams {
+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' | 'test_created' | 'test_started' | 'test_completed' | 'test_question_answered' | 'test_retaken' | 'audio_recap_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 interface UsageTrackChatParams {
+    /**
+     * Number of input tokens
+     */
+    inputTokens: number;
+    /**
+     * AI model used
+     */
+    model: 'openai:gpt-4.1' | 'openai:gpt-4o' | 'openai:gpt-4o-mini' | 'openai:gpt-4' | 'openai:gpt-3.5-turbo' | 'openai:o1' | 'openai:o1-mini' | 'openai:o3-mini' | 'anthropic:claude-3-opus' | 'anthropic:claude-3-sonnet' | 'anthropic:claude-3-haiku' | 'google:gemini-pro' | 'meta:llama-3';
+    /**
+     * Number of output tokens
+     */
+    outputTokens: number;
+    /**
+     * Chat session ID
+     */
+    sessionId: string;
+    /**
+     * Component ID
+     */
+    componentId?: string;
+    /**
+     * Group ID
+     */
+    groupId?: string;
+    /**
+     * Additional metadata
+     */
+    metadata?: unknown;
+    /**
+     * Number of reasoning tokens
+     */
+    reasoningTokens?: number;
+    /**
+     * User ID
+     */
+    userId?: string;
+}
+export interface UsageTrackEventParams {
+    /**
+     * Type of usage event
+     */
+    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' | 'test_created' | 'test_started' | 'test_completed' | 'test_question_answered' | 'test_retaken' | 'audio_recap_create' | 'api_call' | 'cache_hit' | 'sso_login' | 'sso_logout' | 'student_performance';
+    /**
+     * Whether response was served from cache
+     */
+    cacheHit?: boolean;
+    /**
+     * Component name
+     */
+    componentName?: string;
+    /**
+     * Component type
+     */
+    componentType?: string;
+    /**
+     * Size of content in bytes
+     */
+    contentSize?: number;
+    /**
+     * API endpoint accessed
+     */
+    endpoint?: string;
+    /**
+     * File size in bytes
+     */
+    fileSize?: number;
+    /**
+     * File MIME type
+     */
+    fileType?: string;
+    /**
+     * Group ID for collaborative sessions
+     */
+    groupId?: string;
+    /**
+     * Number of input tokens
+     */
+    inputTokens?: number;
+    /**
+     * Client IP address
+     */
+    ipAddress?: string;
+    /**
+     * Additional metadata
+     */
+    metadata?: unknown;
+    /**
+     * HTTP method used
+     */
+    method?: string;
+    /**
+     * AI model used
+     */
+    model?: 'openai:gpt-4.1' | 'openai:gpt-4o' | 'openai:gpt-4o-mini' | 'openai:gpt-4' | 'openai:gpt-3.5-turbo' | 'openai:o1' | 'openai:o1-mini' | 'openai:o3-mini' | 'anthropic:claude-3-opus' | 'anthropic:claude-3-sonnet' | 'anthropic:claude-3-haiku' | 'google:gemini-pro' | 'meta:llama-3';
+    /**
+     * Number of output tokens
+     */
+    outputTokens?: number;
+    /**
+     * Performance metrics data
+     */
+    performanceData?: unknown;
+    /**
+     * Number of reasoning tokens
+     */
+    reasoningTokens?: number;
+    /**
+     * Resource ID being accessed
+     */
+    resourceId?: string;
+    /**
+     * Type of resource
+     */
+    resourceType?: string;
+    /**
+     * Response time in milliseconds
+     */
+    responseTime?: number;
+    /**
+     * Session ID
+     */
+    sessionId?: string;
+    /**
+     * HTTP status code
+     */
+    statusCode?: number;
+    /**
+     * Total number of tokens
+     */
+    totalTokens?: number;
+    /**
+     * Client user agent
+     */
+    userAgent?: string;
+    /**
+     * User ID
+     */
+    userId?: string;
+}
+export interface UsageTrackPerformanceParams {
+    componentId?: string;
+    metrics?: UsageTrackPerformanceParams.Metrics;
+}
+export declare namespace UsageTrackPerformanceParams {
+    interface Metrics {
+        interactionTime?: number;
+        loadTime?: number;
+        renderTime?: number;
+    }
 }
 export declare namespace Usage {
-    export { type UsageChatParams as UsageChatParams, type UsageTrackParams as UsageTrackParams };
+    export { type UsageGetStatsParams as UsageGetStatsParams, type UsageGetSummaryParams as UsageGetSummaryParams, type UsageListEventsParams as UsageListEventsParams, type UsageTrackChatParams as UsageTrackChatParams, type UsageTrackEventParams as UsageTrackEventParams, type UsageTrackPerformanceParams as UsageTrackPerformanceParams, };
 }
 //# sourceMappingURL=usage.d.ts.map