@rivetkit/engine-api-full 2.0.4-rc.1

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@rivetkit/engine-api-full",
+  "version": "2.0.4-rc.1",
+  "repository": "https://github.com/rivet-gg/rivet/tree/main/sdks/typescript",
+  "files": [
+    "dist",
+    "types",
+    "core.d.ts",
+    "serialization.d.ts"
+  ],
+  "exports": {
+    ".": {
+      "node": {
+        "import": "./dist/node/esm/index.js",
+        "require": "./dist/node/cjs/index.js"
+      },
+      "import": "./dist/browser/esm/index.js",
+      "require": "./dist/browser/cjs/index.js",
+      "default": "./dist/browser/cjs/index.js",
+      "types": "./types/index.d.ts"
+    },
+    "./core": {
+      "node": {
+        "import": "./dist/node/esm/core.js",
+        "require": "./dist/node/cjs/core.js"
+      },
+      "import": "./dist/browser/esm/core.js",
+      "require": "./dist/browser/cjs/core.js",
+      "default": "./dist/browser/cjs/core.js",
+      "types": "./types/core/index.d.ts"
+    },
+    "./serialization": {
+      "node": {
+        "import": "./dist/node/esm/serialization.js",
+        "require": "./dist/node/cjs/serialization.js"
+      },
+      "import": "./dist/browser/esm/serialization.js",
+      "require": "./dist/browser/cjs/serialization.js",
+      "default": "./dist/browser/cjs/serialization.js",
+      "types": "./types/serialization/index.d.ts"
+    }
+  },
+  "types": "./types/index.d.ts",
+  "dependencies": {
+    "form-data": "^4.0.4",
+    "js-base64": "^3.7.8",
+    "node-fetch": "^2.7.0",
+    "qs": "^6.14.0",
+    "readable-stream": "^4.7.0",
+    "url-join": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "17.0.33",
+    "@types/node-fetch": "2.6.11",
+    "@types/qs": "6.9.8",
+    "@types/readable-stream": "^4.0.21",
+    "@types/url-join": "4.0.1",
+    "esbuild": "^0.19.12",
+    "prettier": "2.7.1",
+    "typescript": "5.8.2"
+  },
+  "scripts": {
+    "compile": "tsc",
+    "bundle": "node build.js",
+    "build": "pnpm compile && pnpm bundle"
+  }
+}

package/types/Client.d.ts

@@ -0,0 +1,250 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "./core";
+import * as Rivet from "./api/index";
+import { Datacenters } from "./api/resources/datacenters/client/Client";
+import { Health } from "./api/resources/health/client/Client";
+import { Metadata } from "./api/resources/metadata/client/Client";
+import { Namespaces } from "./api/resources/namespaces/client/Client";
+import { Runners } from "./api/resources/runners/client/Client";
+export declare namespace RivetClient {
+    interface Options {
+        environment: core.Supplier<string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token: core.Supplier<core.BearerToken>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string>;
+    }
+}
+export declare class RivetClient {
+    protected readonly _options: RivetClient.Options;
+    protected _datacenters: Datacenters | undefined;
+    protected _health: Health | undefined;
+    protected _metadata: Metadata | undefined;
+    protected _namespaces: Namespaces | undefined;
+    protected _runners: Runners | undefined;
+    constructor(_options: RivetClient.Options);
+    get datacenters(): Datacenters;
+    get health(): Health;
+    get metadata(): Metadata;
+    get namespaces(): Namespaces;
+    get runners(): Runners;
+    /**
+     * **If key is some & `include_destroyed` is false**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - GET /actors (multiple DCs based on actor IDs)
+     *
+     *   This path is optimized because we can read the actor IDs fro the key directly from Epoxy with
+     *   stale consistency to determine which datacenter the actor lives in. Under most circumstances,
+     *   this means we don't need to fan out to all datacenters (like normal list does).
+     *
+     *   The reason `include_destroyed` has to be false is Epoxy only stores currently active actors. If
+     *   `include_destroyed` is true, we show all previous iterations of actors with the same key.
+     *
+     * **Otherwise**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - GET /actors (fanout)
+     *
+     * ## Optimized Alternative Routes
+     *
+     * @param {Rivet.ActorsListRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsList({
+     *         namespace: "namespace"
+     *     })
+     */
+    actorsList(request: Rivet.ActorsListRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsListResponse>;
+    /**
+     * **If actor is created in the current datacenter:**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)
+     *
+     * **If actor is created in a different datacenter:**
+     *
+     * 3 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - POST /actors to remote datacenter
+     * - [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)
+     *
+     * actor::get will always be in the same datacenter.
+     *
+     * @param {Rivet.ActorsCreateRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsCreate({
+     *         namespace: "namespace",
+     *         crashPolicy: "restart",
+     *         name: "name",
+     *         runnerNameSelector: "runner_name_selector"
+     *     })
+     */
+    actorsCreate(request: Rivet.ActorsCreateRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsCreateResponse>;
+    /**
+     * **If actor exists**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - GET /actors/{}
+     *
+     * **If actor does not exist and is created in the current datacenter:**
+     *
+     * 2 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)
+     *
+     * **If actor does not exist and is created in a different datacenter:**
+     *
+     * 3 round trips:
+     *
+     * - namespace::ops::resolve_for_name_global
+     * - POST /actors to remote datacenter
+     * - [pegboard::workflows::actor] Create actor workflow (includes Epoxy key allocation)
+     *
+     * actor::get will always be in the same datacenter.
+     *
+     * ## Optimized Alternative Routes
+     *
+     * @param {Rivet.ActorsGetOrCreateRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsGetOrCreate({
+     *         namespace: "namespace",
+     *         crashPolicy: "restart",
+     *         key: "key",
+     *         name: "name",
+     *         runnerNameSelector: "runner_name_selector"
+     *     })
+     */
+    actorsGetOrCreate(request: Rivet.ActorsGetOrCreateRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsGetOrCreateResponse>;
+    /**
+     * 2 round trips:
+     *
+     * - GET /actors/names (fanout)
+     * - [api-peer] namespace::ops::resolve_for_name_global
+     *
+     * @param {Rivet.ActorsListNamesRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsListNames({
+     *         namespace: "namespace"
+     *     })
+     */
+    actorsListNames(request: Rivet.ActorsListNamesRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsListNamesResponse>;
+    /**
+     * 2 round trip:
+     *
+     * - DELETE /actors/{}
+     * - [api-peer] namespace::ops::resolve_for_name_global
+     *
+     * @param {Rivet.RivetId} actorId
+     * @param {Rivet.ActorsDeleteRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsDelete("actor_id", {
+     *         namespace: "namespace"
+     *     })
+     */
+    actorsDelete(actorId: Rivet.RivetId, request: Rivet.ActorsDeleteRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsDeleteResponse>;
+    /**
+     * @param {Rivet.RivetId} actorId
+     * @param {string} key
+     * @param {Rivet.ActorsKvGetRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.actorsKvGet("actor_id", "key", {
+     *         namespace: "namespace"
+     *     })
+     */
+    actorsKvGet(actorId: Rivet.RivetId, key: string, request: Rivet.ActorsKvGetRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.ActorsKvGetResponse>;
+    /**
+     * @param {Rivet.RunnerConfigsListRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsList({
+     *         namespace: "namespace"
+     *     })
+     */
+    runnerConfigsList(request: Rivet.RunnerConfigsListRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsListResponse>;
+    /**
+     * @param {Rivet.RunnerConfigsServerlessHealthCheckRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsServerlessHealthCheck({
+     *         namespace: "namespace",
+     *         url: "url"
+     *     })
+     */
+    runnerConfigsServerlessHealthCheck(request: Rivet.RunnerConfigsServerlessHealthCheckRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsServerlessHealthCheckResponse>;
+    /**
+     * @param {string} runnerName
+     * @param {Rivet.RunnerConfigsUpsertRequestBody} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsUpsert("runner_name", {
+     *         namespace: "namespace",
+     *         datacenters: {
+     *             "key": {}
+     *         }
+     *     })
+     */
+    runnerConfigsUpsert(runnerName: string, request: Rivet.RunnerConfigsUpsertRequestBody, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsUpsertResponse>;
+    /**
+     * @param {string} runnerName
+     * @param {Rivet.RunnerConfigsDeleteRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsDelete("runner_name", {
+     *         namespace: "namespace"
+     *     })
+     */
+    runnerConfigsDelete(runnerName: string, request: Rivet.RunnerConfigsDeleteRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsDeleteResponse>;
+    /**
+     * @param {string} runnerName
+     * @param {Rivet.RunnerConfigsRefreshMetadataRequest} request
+     * @param {RivetClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.runnerConfigsRefreshMetadata("runner_name", {
+     *         namespace: "namespace",
+     *         body: {
+     *             "key": "value"
+     *         }
+     *     })
+     */
+    runnerConfigsRefreshMetadata(runnerName: string, request: Rivet.RunnerConfigsRefreshMetadataRequest, requestOptions?: RivetClient.RequestOptions): Promise<Rivet.RunnerConfigsRefreshMetadataResponse>;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/types/api/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests";

package/types/api/client/requests/ActorsCreateRequest.d.ts

@@ -0,0 +1,22 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         crashPolicy: "restart",
+ *         name: "name",
+ *         runnerNameSelector: "runner_name_selector"
+ *     }
+ */
+export interface ActorsCreateRequest {
+    namespace: string;
+    crashPolicy: Rivet.CrashPolicy;
+    datacenter?: string;
+    input?: string;
+    key?: string;
+    name: string;
+    runnerNameSelector: string;
+}

package/types/api/client/requests/ActorsDeleteRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface ActorsDeleteRequest {
+    namespace: string;
+}

package/types/api/client/requests/ActorsGetOrCreateRequest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         crashPolicy: "restart",
+ *         key: "key",
+ *         name: "name",
+ *         runnerNameSelector: "runner_name_selector"
+ *     }
+ */
+export interface ActorsGetOrCreateRequest {
+    namespace: string;
+    crashPolicy: Rivet.CrashPolicy;
+    datacenter?: string;
+    input?: string;
+    key: string;
+    name: string;
+    runnerNameSelector: string;
+}

package/types/api/client/requests/ActorsKvGetRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface ActorsKvGetRequest {
+    namespace: string;
+}

package/types/api/client/requests/ActorsListNamesRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface ActorsListNamesRequest {
+    namespace: string;
+    limit?: number;
+    cursor?: string;
+}

package/types/api/client/requests/ActorsListRequest.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface ActorsListRequest {
+    namespace: string;
+    name?: string;
+    key?: string;
+    /**
+     * Deprecated.
+     */
+    actorIds?: string;
+    actorId?: Rivet.RivetId | Rivet.RivetId[];
+    includeDestroyed?: boolean;
+    limit?: number;
+    cursor?: string;
+}

package/types/api/client/requests/RunnerConfigsDeleteRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface RunnerConfigsDeleteRequest {
+    namespace: string;
+}

package/types/api/client/requests/RunnerConfigsListRequest.d.ts

@@ -0,0 +1,21 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace"
+ *     }
+ */
+export interface RunnerConfigsListRequest {
+    namespace: string;
+    limit?: number;
+    cursor?: string;
+    variant?: Rivet.RunnerConfigVariant;
+    /**
+     * Deprecated.
+     */
+    runnerNames?: string;
+    runnerName?: string | string[];
+}

package/types/api/client/requests/RunnerConfigsRefreshMetadataRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         body: {
+ *             "key": "value"
+ *         }
+ *     }
+ */
+export interface RunnerConfigsRefreshMetadataRequest {
+    namespace: string;
+    body: Rivet.RunnerConfigsRefreshMetadataRequestBody;
+}

package/types/api/client/requests/RunnerConfigsServerlessHealthCheckRequest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         url: "url"
+ *     }
+ */
+export interface RunnerConfigsServerlessHealthCheckRequest {
+    namespace: string;
+    headers?: Record<string, string>;
+    url: string;
+}

package/types/api/client/requests/RunnerConfigsUpsertRequestBody.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Rivet from "../../index";
+/**
+ * @example
+ *     {
+ *         namespace: "namespace",
+ *         datacenters: {
+ *             "key": {}
+ *         }
+ *     }
+ */
+export interface RunnerConfigsUpsertRequestBody {
+    namespace: string;
+    datacenters: Record<string, Rivet.RunnerConfig>;
+}

package/types/api/client/requests/index.d.ts

@@ -0,0 +1,11 @@
+export { type ActorsListRequest } from "./ActorsListRequest";
+export { type ActorsCreateRequest } from "./ActorsCreateRequest";
+export { type ActorsGetOrCreateRequest } from "./ActorsGetOrCreateRequest";
+export { type ActorsListNamesRequest } from "./ActorsListNamesRequest";
+export { type ActorsDeleteRequest } from "./ActorsDeleteRequest";
+export { type ActorsKvGetRequest } from "./ActorsKvGetRequest";
+export { type RunnerConfigsListRequest } from "./RunnerConfigsListRequest";
+export { type RunnerConfigsServerlessHealthCheckRequest } from "./RunnerConfigsServerlessHealthCheckRequest";
+export { type RunnerConfigsUpsertRequestBody } from "./RunnerConfigsUpsertRequestBody";
+export { type RunnerConfigsDeleteRequest } from "./RunnerConfigsDeleteRequest";
+export { type RunnerConfigsRefreshMetadataRequest } from "./RunnerConfigsRefreshMetadataRequest";

package/types/api/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./resources";
+export * from "./client";

package/types/api/resources/datacenters/client/Client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../../../core";
+import * as Rivet from "../../../index";
+export declare namespace Datacenters {
+    interface Options {
+        environment: core.Supplier<string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token: core.Supplier<core.BearerToken>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string>;
+    }
+}
+export declare class Datacenters {
+    protected readonly _options: Datacenters.Options;
+    constructor(_options: Datacenters.Options);
+    /**
+     * @param {Datacenters.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.datacenters.list()
+     */
+    list(requestOptions?: Datacenters.RequestOptions): Promise<Rivet.DatacentersListResponse>;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/types/api/resources/datacenters/client/index.d.ts

@@ -0,0 +1 @@
+export {};

package/types/api/resources/datacenters/index.d.ts

@@ -0,0 +1 @@
+export * from "./client";

package/types/api/resources/health/client/Client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../../../core";
+import * as Rivet from "../../../index";
+export declare namespace Health {
+    interface Options {
+        environment: core.Supplier<string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token: core.Supplier<core.BearerToken>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string>;
+    }
+}
+export declare class Health {
+    protected readonly _options: Health.Options;
+    constructor(_options: Health.Options);
+    /**
+     * @param {Health.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.health.fanout()
+     */
+    fanout(requestOptions?: Health.RequestOptions): Promise<Rivet.HealthFanoutResponse>;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/types/api/resources/health/client/index.d.ts

@@ -0,0 +1 @@
+export {};

package/types/api/resources/health/index.d.ts

@@ -0,0 +1 @@
+export * from "./client";

package/types/api/resources/index.d.ts

@@ -0,0 +1,7 @@
+export * as datacenters from "./datacenters";
+export * as health from "./health";
+export * as metadata from "./metadata";
+export * as namespaces from "./namespaces";
+export * as runners from "./runners";
+export * from "./namespaces/client/requests";
+export * from "./runners/client/requests";

package/types/api/resources/metadata/client/Client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../../../core";
+import * as Rivet from "../../../index";
+export declare namespace Metadata {
+    interface Options {
+        environment: core.Supplier<string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        token: core.Supplier<core.BearerToken>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string>;
+    }
+}
+export declare class Metadata {
+    protected readonly _options: Metadata.Options;
+    constructor(_options: Metadata.Options);
+    /**
+     * @param {Metadata.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.metadata.get()
+     */
+    get(requestOptions?: Metadata.RequestOptions): Promise<Rivet.MetadataGetResponse>;
+    protected _getAuthorizationHeader(): Promise<string>;
+}