@onkernel/sdk 0.88.0 → 0.91.0

package/src/resources/projects/limits.ts

@@ -18,12 +18,12 @@ export class Limits extends APIResource {
    * @example
    * ```ts
    * const projectLimits = await client.projects.limits.retrieve(
-   *   'id',
+   *   'id_or_name',
    * );
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<ProjectLimits> {
-    return this._client.get(path`/org/projects/${id}/limits`, options);
+  retrieve(idOrName: string, options?: RequestOptions): APIPromise<ProjectLimits> {
+    return this._client.get(path`/org/projects/${idOrName}/limits`, options);
   }
 
   /**
@@ -34,12 +34,12 @@ export class Limits extends APIResource {
    * @example
    * ```ts
    * const projectLimits = await client.projects.limits.update(
-   *   'id',
+   *   'id_or_name',
    * );
    * ```
    */
-  update(id: string, body: LimitUpdateParams, options?: RequestOptions): APIPromise<ProjectLimits> {
-    return this._client.patch(path`/org/projects/${id}/limits`, { body, ...options });
+  update(idOrName: string, body: LimitUpdateParams, options?: RequestOptions): APIPromise<ProjectLimits> {
+    return this._client.patch(path`/org/projects/${idOrName}/limits`, { body, ...options });
   }
 }
 

package/src/resources/projects/projects.ts

@@ -36,11 +36,13 @@ export class Projects extends APIResource {
    *
    * @example
    * ```ts
-   * const project = await client.projects.retrieve('id');
+   * const project = await client.projects.retrieve(
+   *   'id_or_name',
+   * );
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<Project> {
-    return this._client.get(path`/org/projects/${id}`, options);
+  retrieve(idOrName: string, options?: RequestOptions): APIPromise<Project> {
+    return this._client.get(path`/org/projects/${idOrName}`, options);
   }
 
   /**
@@ -48,11 +50,11 @@ export class Projects extends APIResource {
    *
    * @example
    * ```ts
-   * const project = await client.projects.update('id');
+   * const project = await client.projects.update('id_or_name');
    * ```
    */
-  update(id: string, body: ProjectUpdateParams, options?: RequestOptions): APIPromise<Project> {
-    return this._client.patch(path`/org/projects/${id}`, { body, ...options });
+  update(idOrName: string, body: ProjectUpdateParams, options?: RequestOptions): APIPromise<Project> {
+    return this._client.patch(path`/org/projects/${idOrName}`, { body, ...options });
   }
 
   /**
@@ -78,11 +80,11 @@ export class Projects extends APIResource {
    *
    * @example
    * ```ts
-   * await client.projects.delete('id');
+   * await client.projects.delete('id_or_name');
    * ```
    */
-  delete(id: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/org/projects/${id}`, {
+  delete(idOrName: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/org/projects/${idOrName}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -93,7 +95,7 @@ export type ProjectsOffsetPagination = OffsetPagination<Project>;
 
 export interface CreateProjectRequest {
   /**
-   * Project name (1-255 Unicode code points)
+   * Project name (1-255 Unicode code points; cannot contain `/` or `%`)
    */
   name: string;
 }
@@ -127,7 +129,7 @@ export interface Project {
 
 export interface UpdateProjectRequest {
   /**
-   * New project name (1-255 Unicode code points)
+   * New project name (1-255 Unicode code points; cannot contain `/` or `%`)
    */
   name?: string;
 
@@ -139,14 +141,14 @@ export interface UpdateProjectRequest {
 
 export interface ProjectCreateParams {
   /**
-   * Project name (1-255 Unicode code points)
+   * Project name (1-255 Unicode code points; cannot contain `/` or `%`)
    */
   name: string;
 }
 
 export interface ProjectUpdateParams {
   /**
-   * New project name (1-255 Unicode code points)
+   * New project name (1-255 Unicode code points; cannot contain `/` or `%`)
    */
   name?: string;
 

package/src/resources/telemetry/destinations.ts

@@ -0,0 +1,188 @@
+// 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 { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Stream live telemetry events from a browser session, and manage the destinations sessions export them to.
+ */
+export class Destinations extends APIResource {
+  /**
+   * Create an OTLP export destination in the resolved project. Names must be unique
+   * within the project.
+   */
+  create(body: DestinationCreateParams, options?: RequestOptions): APIPromise<OtlpDestination> {
+    return this._client.post('/telemetry/destinations', { body, ...options });
+  }
+
+  /**
+   * Retrieve a single OTLP destination in the resolved project by its ID or name.
+   */
+  retrieve(idOrName: string, options?: RequestOptions): APIPromise<OtlpDestination> {
+    return this._client.get(path`/telemetry/destinations/${idOrName}`, options);
+  }
+
+  /**
+   * Update an OTLP destination. Sessions already exporting to it pick up the new
+   * values without restarting, which makes this the way to rotate credentials
+   * without interrupting export.
+   *
+   * Names must be unique within the project. Renaming is refused with a 409 while a
+   * managed auth connection selects this destination by name, since that connection
+   * resolves the name on every login. Every other field, including `headers`, stays
+   * editable.
+   */
+  update(
+    idOrName: string,
+    body: DestinationUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<OtlpDestination> {
+    return this._client.patch(path`/telemetry/destinations/${idOrName}`, { body, ...options });
+  }
+
+  /**
+   * List OTLP export destinations in the resolved project.
+   */
+  list(
+    query: DestinationListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<OtlpDestinationsOffsetPagination, OtlpDestination> {
+    return this._client.getAPIList('/telemetry/destinations', OffsetPagination<OtlpDestination>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Delete an OTLP destination. Sessions bound to it are still exporting, so the
+   * delete is refused with a 409 while any exist; either wait for those sessions to
+   * end or delete them first. It is refused the same way while a managed auth
+   * connection still selects it, because that connection re-resolves the destination
+   * on every login, and while a managed auth login using it is still in progress.
+   */
+  delete(idOrName: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/telemetry/destinations/${idOrName}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type OtlpDestinationsOffsetPagination = OffsetPagination<OtlpDestination>;
+
+/**
+ * An OTLP endpoint to export browser session telemetry to. Reference one from
+ * `telemetry.export.otlp.destination` when creating a browser to export that
+ * session's captured telemetry to it.
+ */
+export interface OtlpDestination {
+  id: string;
+
+  created_at: string;
+
+  /**
+   * OTLP/HTTP endpoint telemetry is sent to.
+   */
+  endpoint: string;
+
+  /**
+   * Headers sent with each export request. Names are returned in canonical form
+   * (`Authorization`, not `authorization`). Values are returned redacted as empty
+   * strings, so the keys are visible but the credentials are not.
+   */
+  headers: { [key: string]: string };
+
+  /**
+   * Unique within the project. Usable in place of the ID when selecting a
+   * destination, so it cannot be shaped like an ID.
+   */
+  name: string;
+
+  updated_at: string;
+
+  description?: string;
+}
+
+export interface DestinationCreateParams {
+  /**
+   * Base endpoint of the OTLP/HTTP collector, without a signal path. Kernel appends
+   * the signal path itself, so pass `https://api.honeycomb.io` rather than
+   * `https://api.honeycomb.io/v1/logs`. If your provider's docs give you a
+   * signal-specific URL, drop the trailing `/v1/logs`, `/v1/traces`, or
+   * `/v1/metrics` — an endpoint that already carries one is rejected.
+   *
+   * Must be http or https, must resolve to a public address, and must carry no query
+   * string or fragment. Examples: `https://api.honeycomb.io`,
+   * `https://otlp-gateway-prod-us-east-0.grafana.net/otlp`,
+   * `https://otlp.datadoghq.com` (Datadog's OTLP intake for US1, not its logs
+   * intake).
+   */
+  endpoint: string;
+
+  /**
+   * Unique within the project.
+   */
+  name: string;
+
+  description?: string;
+
+  /**
+   * Headers sent with each export request, typically an ingestion key. Encrypted at
+   * rest and returned redacted. Names and values must be valid HTTP header tokens,
+   * and the names and values together cannot exceed 8192 bytes. Names are matched
+   * case-insensitively and stored canonicalized, so supplying two spellings of one
+   * header is rejected.
+   */
+  headers?: { [key: string]: string };
+}
+
+export interface DestinationUpdateParams {
+  description?: string;
+
+  /**
+   * Base endpoint of the OTLP/HTTP collector, without a signal path. Same rules as
+   * on create.
+   */
+  endpoint?: string;
+
+  /**
+   * Edits stored headers key by key rather than replacing the map. A string value
+   * adds or replaces that header, `null` deletes it, and any key you omit is left as
+   * it is. Names are matched case-insensitively, so `authorization` replaces a
+   * stored `Authorization` rather than adding a second entry. This is the credential
+   * rotation path; sessions already exporting pick up the new values without
+   * restarting. Names and values must be valid HTTP header tokens, and the names and
+   * values together cannot exceed 8192 bytes.
+   */
+  headers?: { [key: string]: string | null };
+
+  name?: string;
+}
+
+export interface DestinationListParams extends OffsetPaginationParams {
+  /**
+   * Exact-match filter on destination name using the database collation. In
+   * production, matching is case- and accent-insensitive.
+   */
+  name?: string;
+
+  /**
+   * Case-insensitive substring match against destination name or endpoint. IDs match
+   * by exact value.
+   */
+  query?: string;
+}
+
+export declare namespace Destinations {
+  export {
+    type OtlpDestination as OtlpDestination,
+    type OtlpDestinationsOffsetPagination as OtlpDestinationsOffsetPagination,
+    type DestinationCreateParams as DestinationCreateParams,
+    type DestinationUpdateParams as DestinationUpdateParams,
+    type DestinationListParams as DestinationListParams,
+  };
+}

package/src/resources/telemetry/index.ts

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Destinations,
+  type OtlpDestination,
+  type DestinationCreateParams,
+  type DestinationUpdateParams,
+  type DestinationListParams,
+  type OtlpDestinationsOffsetPagination,
+} from './destinations';
+export { Telemetry } from './telemetry';

package/src/resources/telemetry/telemetry.ts

@@ -0,0 +1,29 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as DestinationsAPI from './destinations';
+import {
+  DestinationCreateParams,
+  DestinationListParams,
+  DestinationUpdateParams,
+  Destinations,
+  OtlpDestination,
+  OtlpDestinationsOffsetPagination,
+} from './destinations';
+
+export class Telemetry extends APIResource {
+  destinations: DestinationsAPI.Destinations = new DestinationsAPI.Destinations(this._client);
+}
+
+Telemetry.Destinations = Destinations;
+
+export declare namespace Telemetry {
+  export {
+    Destinations as Destinations,
+    type OtlpDestination as OtlpDestination,
+    type OtlpDestinationsOffsetPagination as OtlpDestinationsOffsetPagination,
+    type DestinationCreateParams as DestinationCreateParams,
+    type DestinationUpdateParams as DestinationUpdateParams,
+    type DestinationListParams as DestinationListParams,
+  };
+}

package/src/resources/telemetry.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './telemetry/index';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.88.0'; // x-release-please-version
+export const VERSION = '0.91.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.88.0";
+export declare const VERSION = "0.91.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.88.0";
+export declare const VERSION = "0.91.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.88.0'; // x-release-please-version
+exports.VERSION = '0.91.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.88.0'; // x-release-please-version
+export const VERSION = '0.91.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map