@onkernel/sdk 0.86.0 → 0.87.0

package/src/resources/audit-logs.ts

@@ -1,251 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import { APIPromise } from '../core/api-promise';
-import { PagePromise, PageTokenPagination, type PageTokenPaginationParams } from '../core/pagination';
-import { buildHeaders } from '../internal/headers';
-import { RequestOptions } from '../internal/request-options';
-import {
-  downloadAuditLogs,
-  type AuditLogDownloadDestination,
-  type AuditLogDownloadOptions,
-  type AuditLogDownloadParams,
-  type AuditLogDownloadProgress,
-  type AuditLogDownloadResult,
-} from '../lib/audit-log-download';
-
-export type {
-  AuditLogDownloadDestination,
-  AuditLogDownloadOptions,
-  AuditLogDownloadParams,
-  AuditLogDownloadProgress,
-  AuditLogDownloadResult,
-} from '../lib/audit-log-download';
-
-/**
- * Read audit log records for the authenticated organization.
- */
-export class AuditLogs extends APIResource {
-  /**
-   * API for searching audit logs. Limited to at most 30 day search, returns up to
-   * 100 records per page. Not recommended for bulk export.
-   */
-  list(
-    query: AuditLogListParams,
-    options?: RequestOptions,
-  ): PagePromise<AuditLogEntriesPageTokenPagination, AuditLogEntry> {
-    return this._client.getAPIList('/audit-logs', PageTokenPagination<AuditLogEntry>, { query, ...options });
-  }
-
-  /**
-   * Download an organization's audit log records for a time range as a file, for
-   * archival, compliance, or offline analysis. For interactive browsing, use GET
-   * /audit-logs.
-   */
-  exportChunk(query: AuditLogExportChunkParams, options?: RequestOptions): APIPromise<Response> {
-    return this._client.get('/audit-logs/export/chunk', {
-      query,
-      ...options,
-      headers: buildHeaders([{ Accept: 'application/octet-stream' }, options?.headers]),
-      __binaryResponse: true,
-    });
-  }
-
-  /**
-   * Download a complete gzip-compressed JSON Lines audit log export to a writable
-   * destination. The SDK verifies every chunk and retries transient transfer
-   * failures. It does not close the destination. If the download fails, the
-   * destination may contain a partial export; use a temporary file and atomic
-   * rename when the completed export must be published atomically.
-   */
-  download(
-    query: AuditLogDownloadParams,
-    destination: AuditLogDownloadDestination,
-    options?: AuditLogDownloadOptions,
-  ): Promise<AuditLogDownloadResult> {
-    return downloadAuditLogs(
-      (chunkQuery, chunkOptions) => this.exportChunk(chunkQuery, chunkOptions),
-      query,
-      destination,
-      this._client.timeout,
-      options,
-    );
-  }
-}
-
-export type AuditLogEntriesPageTokenPagination = PageTokenPagination<AuditLogEntry>;
-
-export interface AuditLogEntry {
-  /**
-   * Authentication strategy used for the request.
-   */
-  auth_strategy: string;
-
-  /**
-   * Client IP address.
-   */
-  client_ip: string;
-
-  /**
-   * Request host.
-   */
-  domain: string;
-
-  /**
-   * Request duration in milliseconds.
-   */
-  duration_ms: number;
-
-  /**
-   * Email of the authenticated user at request time, if any.
-   */
-  email: string;
-
-  /**
-   * HTTP method.
-   */
-  method: string;
-
-  /**
-   * Request path.
-   */
-  path: string;
-
-  /**
-   * Matched API route pattern, if available.
-   */
-  route: string;
-
-  /**
-   * HTTP response status code.
-   */
-  status: number;
-
-  /**
-   * UTC time when the request was received.
-   */
-  timestamp: string;
-
-  /**
-   * User agent header.
-   */
-  user_agent: string;
-
-  /**
-   * ID of the authenticated user, if any.
-   */
-  user_id: string;
-}
-
-export interface AuditLogListParams extends PageTokenPaginationParams {
-  /**
-   * Upper bound (exclusive) for the audit record timestamp.
-   */
-  end: string;
-
-  /**
-   * Lower bound (inclusive) for the audit record timestamp.
-   */
-  start: string;
-
-  /**
-   * Filter by authentication strategy.
-   */
-  auth_strategy?: string;
-
-  /**
-   * Filter out results by HTTP method.
-   */
-  exclude_method?: Array<string>;
-
-  /**
-   * Filter by HTTP method.
-   */
-  method?: string;
-
-  /**
-   * Free-text search over path, user ID, email, client IP, and status.
-   */
-  search?: string;
-
-  /**
-   * Additional user IDs to OR into free-text search.
-   */
-  search_user_id?: Array<string>;
-
-  /**
-   * Filter by service name.
-   */
-  service?: string;
-}
-
-export interface AuditLogExportChunkParams {
-  /**
-   * Upper bound (exclusive) for the audit record timestamp.
-   */
-  end: string;
-
-  /**
-   * Lower bound (inclusive) for the audit record timestamp.
-   */
-  start: string;
-
-  /**
-   * Filter by authentication strategy.
-   */
-  auth_strategy?: string;
-
-  /**
-   * Opaque cursor from X-Next-Cursor for the next chunk of older records.
-   */
-  cursor?: string;
-
-  /**
-   * Filter out results by HTTP method.
-   */
-  exclude_method?: Array<string>;
-
-  /**
-   * Encoding for the returned chunk.
-   */
-  format?: 'jsonl' | 'jsonl.gz';
-
-  /**
-   * Maximum number of records to return in this chunk.
-   */
-  limit?: number;
-
-  /**
-   * Filter by HTTP method.
-   */
-  method?: string;
-
-  /**
-   * Free-text search over path, user ID, email, client IP, and status.
-   */
-  search?: string;
-
-  /**
-   * Additional user IDs to OR into free-text search.
-   */
-  search_user_id?: Array<string>;
-
-  /**
-   * Filter by service name.
-   */
-  service?: string;
-}
-
-export declare namespace AuditLogs {
-  export {
-    type AuditLogEntry as AuditLogEntry,
-    type AuditLogEntriesPageTokenPagination as AuditLogEntriesPageTokenPagination,
-    type AuditLogListParams as AuditLogListParams,
-    type AuditLogExportChunkParams as AuditLogExportChunkParams,
-    type AuditLogDownloadDestination as AuditLogDownloadDestination,
-    type AuditLogDownloadOptions as AuditLogDownloadOptions,
-    type AuditLogDownloadParams as AuditLogDownloadParams,
-    type AuditLogDownloadProgress as AuditLogDownloadProgress,
-    type AuditLogDownloadResult as AuditLogDownloadResult,
-  };
-}
+export * from './audit-logs/index';

package/src/resources/auth/auth.ts

@@ -21,14 +21,20 @@ import {
   SubmitFieldsRequest,
   SubmitFieldsResponse,
 } from './connections';
+import * as ContextAPI from './context';
+import { AuthContext, Context } from './context';
 
 export class Auth extends APIResource {
+  context: ContextAPI.Context = new ContextAPI.Context(this._client);
   connections: ConnectionsAPI.Connections = new ConnectionsAPI.Connections(this._client);
 }
 
+Auth.Context = Context;
 Auth.Connections = Connections;
 
 export declare namespace Auth {
+  export { Context as Context, type AuthContext as AuthContext };
+
   export {
     Connections as Connections,
     type LoginResponse as LoginResponse,

package/src/resources/auth/connections.ts

@@ -553,6 +553,63 @@ export namespace ManagedAuth {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: BrowserTelemetry.Export;
+  }
+
+  export namespace BrowserTelemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 
   /**
@@ -916,6 +973,63 @@ export namespace ManagedAuthCreateRequest {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: BrowserTelemetry.Export;
+  }
+
+  export namespace BrowserTelemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 
   /**
@@ -1155,6 +1269,63 @@ export namespace ManagedAuthUpdateRequest {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: BrowserTelemetry.Export;
+  }
+
+  export namespace BrowserTelemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 
   /**
@@ -1705,6 +1876,63 @@ export namespace ConnectionCreateParams {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: BrowserTelemetry.Export;
+  }
+
+  export namespace BrowserTelemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 
   /**
@@ -1856,6 +2084,63 @@ export namespace ConnectionUpdateParams {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: BrowserTelemetry.Export;
+  }
+
+  export namespace BrowserTelemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 
   /**
@@ -1977,6 +2262,63 @@ export namespace ConnectionLoginParams {
      * create. enabled=false cannot be combined with browser category settings.
      */
     enabled?: boolean;
+
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export?: BrowserTelemetry.Export;
+  }
+
+  export namespace BrowserTelemetry {
+    /**
+     * Where to export this session's captured telemetry. Omit to capture without
+     * exporting.
+     */
+    export interface Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      otlp?: Export.Otlp;
+    }
+
+    export namespace Export {
+      /**
+       * Export captured telemetry over OTLP to one of the org's configured destinations.
+       */
+      export interface Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        destination?: Otlp.Destination;
+
+        /**
+         * Whether to export captured telemetry over OTLP. Setting destination implies
+         * enabled=true, so this only needs to be set explicitly to disable export
+         * (enabled=false with a destination is rejected).
+         */
+        enabled?: boolean;
+      }
+
+      export namespace Otlp {
+        /**
+         * OTLP destination to export this session's captured telemetry to. Provide either
+         * id or name. Requires telemetry capture to be enabled.
+         */
+        export interface Destination {
+          /**
+           * OTLP destination ID
+           */
+          id?: string;
+
+          /**
+           * OTLP destination name
+           */
+          name?: string;
+        }
+      }
+    }
   }
 
   /**