@interfere/sdk 8.1.2 → 9.0.0

package/docs/models/session-source.md

@@ -0,0 +1,17 @@
+# SessionSource
+
+How the server resolved the sessionId for this envelope.
+
+## Example Usage
+
+```typescript
+import { SessionSource } from "@interfere/sdk/models";
+
+let value: SessionSource = "client";
+```
+
+## Values
+
+```typescript
+"header" | "async_context" | "fallback" | "client"
+```

package/docs/models/source-map-to-generated.md

@@ -0,0 +1,14 @@
+# SourceMapToGenerated
+
+## Example Usage
+
+```typescript
+import { SourceMapToGenerated } from "@interfere/sdk/models";
+
+let value: SourceMapToGenerated = {};
+```
+
+## Fields
+
+| Field       | Type        | Required    | Description |
+| ----------- | ----------- | ----------- | ----------- |

package/docs/models/source-provider.md

@@ -0,0 +1,15 @@
+# SourceProvider
+
+## Example Usage
+
+```typescript
+import { SourceProvider } from "@interfere/sdk/models";
+
+let value: SourceProvider = "github";
+```
+
+## Values
+
+```typescript
+"github"
+```

package/docs/models/surface-ref.md

@@ -0,0 +1,19 @@
+# SurfaceRef
+
+## Example Usage
+
+```typescript
+import { SurfaceRef } from "@interfere/sdk/models";
+
+let value: SurfaceRef = {
+  id: "<id>",
+  slug: "<value>",
+};
+```
+
+## Fields
+
+| Field              | Type               | Required           | Description        |
+| ------------------ | ------------------ | ------------------ | ------------------ |
+| `id`               | *string*           | :heavy_check_mark: | N/A                |
+| `slug`             | *string*           | :heavy_check_mark: | N/A                |

package/docs/models/surface.md

@@ -0,0 +1,27 @@
+# Surface
+
+## Example Usage
+
+```typescript
+import { Surface } from "@interfere/sdk/models";
+
+let value: Surface = {
+  id: "<id>",
+  slug: "<value>",
+  allowDirectIngestion: false,
+  sourceProvider: "github",
+  destinationProvider: "vercel",
+  sdkConfig: {},
+};
+```
+
+## Fields
+
+| Field                                                           | Type                                                            | Required                                                        | Description                                                     |
+| --------------------------------------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------- |
+| `id`                                                            | *string*                                                        | :heavy_check_mark:                                              | N/A                                                             |
+| `slug`                                                          | *string*                                                        | :heavy_check_mark:                                              | N/A                                                             |
+| `allowDirectIngestion`                                          | *boolean*                                                       | :heavy_check_mark:                                              | N/A                                                             |
+| `sourceProvider`                                                | [models.SourceProvider](../models/source-provider.md)           | :heavy_check_mark:                                              | N/A                                                             |
+| `destinationProvider`                                           | [models.DestinationProvider](../models/destination-provider.md) | :heavy_check_mark:                                              | N/A                                                             |
+| `sdkConfig`                                                     | [models.SDKConfig](../models/sdk-config.md)                     | :heavy_check_mark:                                              | N/A                                                             |

package/docs/models/ui-event-envelope.md

@@ -0,0 +1,45 @@
+# UiEventEnvelope
+
+## Example Usage
+
+```typescript
+import { UiEventEnvelope } from "@interfere/sdk/models";
+
+let value: UiEventEnvelope = {
+  type: "ui_event",
+  buildId: "<id>",
+  clientTs: 615985,
+  environment: "production",
+  releaseId: "<id>",
+  runtime: "browser",
+  sessionId: "f662ea43-7ae3-4e28-a92a-19a8e07571d1",
+  uuid: "c7111390-2e43-4f1e-b3f8-3ffcc21e5989",
+  v: 3318.86,
+  payload: {
+    event: {
+      "key": "<value>",
+      "key1": "<value>",
+      "key2": "<value>",
+    },
+  },
+};
+```
+
+## Fields
+
+| Field                                                    | Type                                                     | Required                                                 | Description                                              |
+| -------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------- |
+| `type`                                                   | *"ui_event"*                                             | :heavy_check_mark:                                       | N/A                                                      |
+| `buildId`                                                | *string*                                                 | :heavy_check_mark:                                       | N/A                                                      |
+| `clientTs`                                               | *number*                                                 | :heavy_check_mark:                                       | N/A                                                      |
+| `context`                                                | *models.EnvelopeContext*                                 | :heavy_minus_sign:                                       | N/A                                                      |
+| `environment`                                            | [models.Environment](../models/environment.md)           | :heavy_check_mark:                                       | Deployment environment the SDK is running in.            |
+| `producerVersion`                                        | *string*                                                 | :heavy_minus_sign:                                       | N/A                                                      |
+| `releaseId`                                              | *string*                                                 | :heavy_check_mark:                                       | N/A                                                      |
+| `runtime`                                                | [models.RuntimeEnum](../models/runtime-enum.md)          | :heavy_check_mark:                                       | JavaScript runtime the SDK is running in.                |
+| `sdkStack`                                               | *string*[]                                               | :heavy_minus_sign:                                       | N/A                                                      |
+| `sessionId`                                              | *string*                                                 | :heavy_check_mark:                                       | N/A                                                      |
+| `sessionSource`                                          | [models.SessionSource](../models/session-source.md)      | :heavy_minus_sign:                                       | How the server resolved the sessionId for this envelope. |
+| `uuid`                                                   | *string*                                                 | :heavy_check_mark:                                       | N/A                                                      |
+| `v`                                                      | *number*                                                 | :heavy_check_mark:                                       | N/A                                                      |
+| `payload`                                                | [models.UiEventPayload](../models/ui-event-payload.md)   | :heavy_check_mark:                                       | Payload for a UI event envelope.                         |

package/docs/models/ui-event-payload.md

@@ -0,0 +1,23 @@
+# UiEventPayload
+
+Payload for a UI event envelope.
+
+## Example Usage
+
+```typescript
+import { UiEventPayload } from "@interfere/sdk/models";
+
+let value: UiEventPayload = {
+  event: {
+    "key": "<value>",
+    "key1": "<value>",
+    "key2": "<value>",
+  },
+};
+```
+
+## Fields
+
+| Field                 | Type                  | Required              | Description           |
+| --------------------- | --------------------- | --------------------- | --------------------- |
+| `event`               | Record<string, *any*> | :heavy_check_mark:    | N/A                   |

package/docs/models/upload-source-maps-metadata.md

@@ -0,0 +1,23 @@
+# UploadSourceMapsMetadata
+
+Metadata attached alongside uploaded source map files.
+
+## Example Usage
+
+```typescript
+import { UploadSourceMapsMetadata } from "@interfere/sdk/models";
+
+let value: UploadSourceMapsMetadata = {
+  sourceMapToGenerated: {},
+  hashes: {},
+};
+```
+
+## Fields
+
+| Field                                                               | Type                                                                | Required                                                            | Description                                                         |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| `sourceMapToGenerated`                                              | [models.SourceMapToGenerated](../models/source-map-to-generated.md) | :heavy_check_mark:                                                  | N/A                                                                 |
+| `hashes`                                                            | [models.Hashes](../models/hashes.md)                                | :heavy_check_mark:                                                  | N/A                                                                 |
+| `debugIds`                                                          | [models.DebugIds](../models/debug-ids.md)                           | :heavy_minus_sign:                                                  | N/A                                                                 |
+| `sourceFileCount`                                                   | *number*                                                            | :heavy_minus_sign:                                                  | N/A                                                                 |

package/docs/models/vercel-release-destination-provider.md

@@ -0,0 +1,15 @@
+# VercelReleaseDestinationProvider
+
+## Example Usage
+
+```typescript
+import { VercelReleaseDestinationProvider } from "@interfere/sdk/models";
+
+let value: VercelReleaseDestinationProvider = "vercel";
+```
+
+## Values
+
+```typescript
+"vercel"
+```

package/docs/models/vercel-release-destination.md

@@ -0,0 +1,31 @@
+# VercelReleaseDestination
+
+Release destination metadata for a Vercel deployment.
+
+## Example Usage
+
+```typescript
+import { VercelReleaseDestination } from "@interfere/sdk/models";
+
+let value: VercelReleaseDestination = {
+  provider: "vercel",
+  destinationReleaseId: "<id>",
+  environment: "<value>",
+  deploymentId: "<id>",
+  deploymentUrl: "https://front-kinase.biz",
+  environmentName: null,
+  environmentTarget: "<value>",
+};
+```
+
+## Fields
+
+| Field                                                                                       | Type                                                                                        | Required                                                                                    | Description                                                                                 |
+| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| `provider`                                                                                  | [models.VercelReleaseDestinationProvider](../models/vercel-release-destination-provider.md) | :heavy_check_mark:                                                                          | N/A                                                                                         |
+| `destinationReleaseId`                                                                      | *string*                                                                                    | :heavy_check_mark:                                                                          | N/A                                                                                         |
+| `environment`                                                                               | *string*                                                                                    | :heavy_check_mark:                                                                          | N/A                                                                                         |
+| `deploymentId`                                                                              | *string*                                                                                    | :heavy_check_mark:                                                                          | N/A                                                                                         |
+| `deploymentUrl`                                                                             | *string*                                                                                    | :heavy_check_mark:                                                                          | N/A                                                                                         |
+| `environmentName`                                                                           | *string*                                                                                    | :heavy_check_mark:                                                                          | N/A                                                                                         |
+| `environmentTarget`                                                                         | *string*                                                                                    | :heavy_check_mark:                                                                          | N/A                                                                                         |

package/docs/sdks/config/README.md

@@ -0,0 +1,72 @@
+# Config
+
+## Overview
+
+SDK configuration
+
+### Available Operations
+
+* [get](#get)
+
+## get
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="getConfig" method="get" path="/v1/config/" -->
+```typescript
+import { Interfere } from "@interfere/sdk";
+
+const interfere = new Interfere();
+
+async function run() {
+  const result = await interfere.config.get();
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { InterfereCore } from "@interfere/sdk/core.js";
+import { configGet } from "@interfere/sdk/funcs/config-get.js";
+
+// Use `InterfereCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const interfere = new InterfereCore();
+
+async function run() {
+  const res = await configGet(interfere);
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("configGet failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[models.ConfigResponse](../../models/config-response.md)\>**
+
+### Errors
+
+| Error Type            | Status Code           | Content Type          |
+| --------------------- | --------------------- | --------------------- |
+| errors.ErrorsProblem  | 401                   | application/json      |
+| errors.InterfereError | 4XX, 5XX              | \*/\*                 |

package/docs/sdks/health/README.md

@@ -0,0 +1,72 @@
+# Health
+
+## Overview
+
+Health check
+
+### Available Operations
+
+* [get](#get)
+
+## get
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="getHealth" method="get" path="/health/" -->
+```typescript
+import { Interfere } from "@interfere/sdk";
+
+const interfere = new Interfere();
+
+async function run() {
+  const result = await interfere.health.get();
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { InterfereCore } from "@interfere/sdk/core.js";
+import { healthGet } from "@interfere/sdk/funcs/health-get.js";
+
+// Use `InterfereCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const interfere = new InterfereCore();
+
+async function run() {
+  const res = await healthGet(interfere);
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("healthGet failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[models.HealthOk](../../models/health-ok.md)\>**
+
+### Errors
+
+| Error Type            | Status Code           | Content Type          |
+| --------------------- | --------------------- | --------------------- |
+| errors.HealthError    | 500                   | application/json      |
+| errors.InterfereError | 4XX, 5XX              | \*/\*                 |

package/docs/sdks/ingest/README.md

@@ -0,0 +1,175 @@
+# Ingest
+
+## Overview
+
+Event ingestion
+
+### Available Operations
+
+* [post](#post)
+
+## post
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="ingest" method="post" path="/v1/ingest/" -->
+```typescript
+import { Interfere } from "@interfere/sdk";
+
+const interfere = new Interfere();
+
+async function run() {
+  const result = await interfere.ingest.post([
+    {
+      type: "replay_chunk",
+      buildId: "<id>",
+      clientTs: 870104,
+      environment: "development",
+      releaseId: "<id>",
+      runtime: "edge",
+      sessionId: "a2ba99cd-cfa7-4180-8531-8cf43498cb93",
+      uuid: "c6184cb5-7ebf-4da5-8951-879d34f73aaf",
+      v: 0,
+      payload: {
+        ts: 4133.68,
+        count: 5545.75,
+        events: [],
+      },
+    },
+    {
+      type: "error",
+      buildId: "<id>",
+      clientTs: 706130,
+      environment: "preview",
+      releaseId: "<id>",
+      runtime: "node",
+      sessionId: "eb8dc940-e4b3-4f0b-9d81-9d9129ee39d7",
+      uuid: "9c5d368e-bd79-4dcb-8e41-900825ef821a",
+      v: 0,
+      payload: {
+        exceptions: [
+          {
+            type: "<value>",
+            value: "<value>",
+            frames: [],
+          },
+        ],
+      },
+    },
+    {
+      type: "pageview",
+      buildId: "<id>",
+      clientTs: 505979,
+      environment: "preview",
+      releaseId: "<id>",
+      runtime: "edge",
+      sessionId: "4cc5eb79-5187-4fe2-9d83-d5da5974c1d6",
+      uuid: "cb48001e-3621-433b-af3c-476f1ec7ffe8",
+      v: 0,
+      payload: {
+        url: "https://same-statue.org/",
+      },
+    },
+  ]);
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { InterfereCore } from "@interfere/sdk/core.js";
+import { ingestPost } from "@interfere/sdk/funcs/ingest-post.js";
+
+// Use `InterfereCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const interfere = new InterfereCore();
+
+async function run() {
+  const res = await ingestPost(interfere, [
+    {
+      type: "replay_chunk",
+      buildId: "<id>",
+      clientTs: 870104,
+      environment: "development",
+      releaseId: "<id>",
+      runtime: "edge",
+      sessionId: "a2ba99cd-cfa7-4180-8531-8cf43498cb93",
+      uuid: "c6184cb5-7ebf-4da5-8951-879d34f73aaf",
+      v: 0,
+      payload: {
+        ts: 4133.68,
+        count: 5545.75,
+        events: [],
+      },
+    },
+    {
+      type: "error",
+      buildId: "<id>",
+      clientTs: 706130,
+      environment: "preview",
+      releaseId: "<id>",
+      runtime: "node",
+      sessionId: "eb8dc940-e4b3-4f0b-9d81-9d9129ee39d7",
+      uuid: "9c5d368e-bd79-4dcb-8e41-900825ef821a",
+      v: 0,
+      payload: {
+        exceptions: [
+          {
+            type: "<value>",
+            value: "<value>",
+            frames: [],
+          },
+        ],
+      },
+    },
+    {
+      type: "pageview",
+      buildId: "<id>",
+      clientTs: 505979,
+      environment: "preview",
+      releaseId: "<id>",
+      runtime: "edge",
+      sessionId: "4cc5eb79-5187-4fe2-9d83-d5da5974c1d6",
+      uuid: "cb48001e-3621-433b-af3c-476f1ec7ffe8",
+      v: 0,
+      payload: {
+        url: "https://same-statue.org/",
+      },
+    },
+  ]);
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("ingestPost failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [models.Envelope[]](../../models/.md)                                                                                                                                          | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[models.IngestResponse](../../models/ingest-response.md)\>**
+
+### Errors
+
+| Error Type            | Status Code           | Content Type          |
+| --------------------- | --------------------- | --------------------- |
+| errors.ErrorsProblem  | 401, 429              | application/json      |
+| errors.InterfereError | 4XX, 5XX              | \*/\*                 |