@corti/sdk 0.1.3-alpha → 0.1.3-rc

package/README.md

@@ -1,26 +1,22 @@
-# Corti TypeScript Library
+# Corti JavaScript SDK
 
-[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fcorticph%2Fcorti-sdk-typescript)
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fcorticph%2Fcorti-sdk-javascript)
 [![npm shield](https://img.shields.io/npm/v/@corti/sdk)](https://www.npmjs.com/package/@corti/sdk)
 
-> [!WARNING]
-> This is an **alpha version** of the Corti TypeScript SDK library. As such, there will be breaking changes in future releases as we work toward our beta version. Additionally, types might not always match the actual API reality, and some features may be missing or incomplete. We're actively working to improve the library and would greatly appreciate any feedback if you encounter any inconsistencies or issues 💚
+> This is a **Beta version** of the Corti JavaScript SDK. We are treating it as stable for production use, but
+> there may still be breaking changes before we reach version 1.0. We're actively working to improve the SDK and would greatly
+> appreciate any feedback if you encounter any inconsistencies or issues 💚
 
-The Corti TypeScript library provides convenient access to the Corti API from TypeScript.
+The Corti JavaScript SDK provides convenient access to the Corti API from JavaScript.
 
 ## Installation
 
-> [!NOTE]
-> You must install the alpha version as the latest version is essentially empty. Use the command below to get the functional SDK.
-
 ```sh
-npm i -s @corti/sdk@alpha
+npm i -s @corti/sdk
 ```
 
 ## Reference
 
-A full reference for this library is available [here](REFERENCE-latest.md).
-
 For detailed authentication instructions, see the [Authentication Guide](./AUTHENTICATION.md).
 
 ## Usage
@@ -32,7 +28,7 @@ import { CortiEnvironment, CortiClient } from "@corti/sdk";
 
 // Using client credentials (OAuth2)
 const client = new CortiClient({
-    environment: CortiEnvironment.BetaEu,
+    environment: CortiEnvironment.Eu,
     tenantName: "YOUR_TENANT_NAME",
     auth: {
         clientId: "YOUR_CLIENT_ID",
@@ -42,7 +38,7 @@ const client = new CortiClient({
 
 // Or using a bearer token
 const client = new CortiClient({
-    environment: CortiEnvironment.BetaEu,
+    environment: CortiEnvironment.Eu,
     tenantName: "YOUR_TENANT_NAME",
     auth: {
         accessToken: "YOUR_ACCESS_TOKEN",
@@ -53,6 +49,23 @@ const client = new CortiClient({
     },
 });
 
+// Or using just a refresh function (no initial access token needed)
+const client = new CortiClient({
+    environment: CortiEnvironment.Eu,
+    tenantName: "YOUR_TENANT_NAME",
+    auth: {
+        refreshAccessToken: async (refreshToken?: string) => {
+            // Your custom logic to get a new access token
+            const response = await fetch("https://your-auth-server/refresh", {
+                method: "POST", 
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ refreshToken: refreshToken }),
+            });
+            return response.json();
+        },
+    },
+});
+
 // For user authentication, you can also use Authorization Code Flow
 // See the Authentication Guide for detailed instructions
 
@@ -120,7 +133,7 @@ List endpoints are paginated. The SDK provides an iterator so that you can simpl
 import { CortiEnvironment, CortiClient } from "@corti/sdk";
 
 const client = new CortiClient({
-    environment: CortiEnvironment.BetaEu,
+    environment: CortiEnvironment.Eu,
     tenantName: "YOUR_TENANT_NAME",
     auth: {
         clientId: "YOUR_CLIENT_ID",
@@ -236,8 +249,8 @@ const client = new CortiClient({
 
 ## Contributing
 
-While we value open-source contributions to this SDK, this library is generated programmatically.
-Additions made directly to this library would have to be moved over to our generation code,
+While we value open-source contributions to this SDK, this repo is (mostly) generated programmatically.
+Additions made directly to this code would have to be moved over to our generation code,
 otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
 a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
 an issue first to discuss with us!

package/dist/cjs/Client.js

@@ -63,8 +63,8 @@ class CortiClient {
                 "Tenant-Name": _options === null || _options === void 0 ? void 0 : _options.tenantName,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@corti/sdk",
-                "X-Fern-SDK-Version": "0.1.3-alpha",
-                "User-Agent": "@corti/sdk/0.1.3-alpha",
+                "X-Fern-SDK-Version": "0.1.3-rc",
+                "User-Agent": "@corti/sdk/0.1.3-rc",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/errors/NotFoundError.d.ts

@@ -2,8 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as errors from "../../errors/index.js";
-import * as Corti from "../index.js";
 import * as core from "../../core/index.js";
 export declare class NotFoundError extends errors.CortiError {
-    constructor(body: Corti.ErrorResponse, rawResponse?: core.RawResponse);
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/cjs/api/index.d.ts

@@ -1,3 +1,7 @@
 export * from "./resources/index.js";
 export * from "./types/index.js";
 export * from "./errors/index.js";
+/**
+ * Patch: including custom types to main export of types
+ */
+export * from "../custom/index.js";

package/dist/cjs/api/index.js

@@ -17,3 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./resources/index.js"), exports);
 __exportStar(require("./types/index.js"), exports);
 __exportStar(require("./errors/index.js"), exports);
+/**
+ * Patch: including custom types to main export of types
+ */
+__exportStar(require("../custom/index.js"), exports);

package/dist/cjs/api/resources/documents/client/Client.d.ts

@@ -32,7 +32,7 @@ export declare class Documents {
     protected readonly _options: Documents.Options;
     constructor(_options: Documents.Options);
     /**
-     *  List Documents
+     * List Documents
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Documents.RequestOptions} requestOptions - Request-specific configuration.
@@ -48,7 +48,7 @@ export declare class Documents {
     list(id: Corti.Uuid, requestOptions?: Documents.RequestOptions): core.HttpResponsePromise<Corti.DocumentsListResponse>;
     private __list;
     /**
-     *  Generate Document.
+     * Generate Document.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.DocumentsCreateRequest} request
@@ -75,7 +75,7 @@ export declare class Documents {
     create(id: Corti.Uuid, request: Corti.DocumentsCreateRequest, requestOptions?: Documents.RequestOptions): core.HttpResponsePromise<Corti.DocumentsGetResponse>;
     private __create;
     /**
-     *  Get Document.
+     * Get Document.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.

package/dist/cjs/api/resources/documents/client/Client.js

@@ -56,7 +56,7 @@ class Documents {
         this._options = _options;
     }
     /**
-     *  List Documents
+     * List Documents
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Documents.RequestOptions} requestOptions - Request-specific configuration.
@@ -146,7 +146,7 @@ class Documents {
         });
     }
     /**
-     *  Generate Document.
+     * Generate Document.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.DocumentsCreateRequest} request
@@ -253,7 +253,7 @@ class Documents {
         });
     }
     /**
-     *  Get Document.
+     * Get Document.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} documentId - The document ID representing the context for the request. Must be a valid UUID.
@@ -387,13 +387,7 @@ class Documents {
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
                     case 404:
-                        throw new Corti.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
+                        throw new Corti.NotFoundError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Corti.InternalServerError(_response.error.body, _response.rawResponse);
                     case 504:

package/dist/cjs/api/resources/facts/client/Client.d.ts

@@ -32,6 +32,8 @@ export declare class Facts {
     protected readonly _options: Facts.Options;
     constructor(_options: Facts.Options);
     /**
+     * Returns a list of available fact groups, used to categorize facts associated with an interaction.
+     *
      * @param {Facts.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.InternalServerError}
@@ -42,7 +44,7 @@ export declare class Facts {
     factGroupsList(requestOptions?: Facts.RequestOptions): core.HttpResponsePromise<Corti.FactsFactGroupsListResponse>;
     private __factGroupsList;
     /**
-     *  Retrieves a list of facts for a given interaction.
+     * Retrieves a list of facts for a given interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Facts.RequestOptions} requestOptions - Request-specific configuration.
@@ -55,7 +57,7 @@ export declare class Facts {
     list(id: Corti.Uuid, requestOptions?: Facts.RequestOptions): core.HttpResponsePromise<Corti.FactsListResponse>;
     private __list;
     /**
-     *  Adds new facts to an interaction.
+     * Adds new facts to an interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.FactsCreateRequest} request
@@ -74,7 +76,7 @@ export declare class Facts {
     create(id: Corti.Uuid, request: Corti.FactsCreateRequest, requestOptions?: Facts.RequestOptions): core.HttpResponsePromise<Corti.FactsCreateResponse>;
     private __create;
     /**
-     *  Updates multiple facts associated with an interaction. If the interaction `status = "in progress"`, the updated facts will be sent to the client over WebSocket.
+     * Updates multiple facts associated with an interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.FactsBatchUpdateRequest} request
@@ -92,7 +94,7 @@ export declare class Facts {
     batchUpdate(id: Corti.Uuid, request: Corti.FactsBatchUpdateRequest, requestOptions?: Facts.RequestOptions): core.HttpResponsePromise<Corti.FactsBatchUpdateResponse>;
     private __batchUpdate;
     /**
-     *  Updates an existing fact within a specific interaction. If the interaction `status = "in progress"`, the updated fact will be sent to the client via WebSocket. To discard a fact, simply set `discarded = true`.
+     * Updates an existing fact associated with a specific interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} factId - The unique identifier of the fact to update. Must be a valid UUID.

package/dist/cjs/api/resources/facts/client/Client.js

@@ -56,6 +56,8 @@ class Facts {
         this._options = _options;
     }
     /**
+     * Returns a list of available fact groups, used to categorize facts associated with an interaction.
+     *
      * @param {Facts.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Corti.InternalServerError}
@@ -122,7 +124,7 @@ class Facts {
         });
     }
     /**
-     *  Retrieves a list of facts for a given interaction.
+     * Retrieves a list of facts for a given interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Facts.RequestOptions} requestOptions - Request-specific configuration.
@@ -197,7 +199,7 @@ class Facts {
         });
     }
     /**
-     *  Adds new facts to an interaction.
+     * Adds new facts to an interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.FactsCreateRequest} request
@@ -284,7 +286,7 @@ class Facts {
         });
     }
     /**
-     *  Updates multiple facts associated with an interaction. If the interaction `status = "in progress"`, the updated facts will be sent to the client over WebSocket.
+     * Updates multiple facts associated with an interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.FactsBatchUpdateRequest} request
@@ -370,7 +372,7 @@ class Facts {
         });
     }
     /**
-     *  Updates an existing fact within a specific interaction. If the interaction `status = "in progress"`, the updated fact will be sent to the client via WebSocket. To discard a fact, simply set `discarded = true`.
+     * Updates an existing fact associated with a specific interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} factId - The unique identifier of the fact to update. Must be a valid UUID.

package/dist/cjs/api/resources/facts/client/requests/FactsUpdateRequest.d.ts

@@ -11,8 +11,8 @@ export interface FactsUpdateRequest {
     text?: string;
     /** The updated group key for the fact. */
     group?: string;
-    /** The updated origin of the fact. */
+    /** The updated origin of the fact. Set to 'USER' to indicate a change by an end-user. */
     source?: Corti.CommonSourceEnum;
-    /** Indicates whether the fact should be marked as discarded. */
+    /** Set this to true if discarded by an end-user, then filter out from the document generation request. */
     isDiscarded?: boolean;
 }

package/dist/cjs/api/resources/index.d.ts

@@ -1,12 +1,11 @@
 export * as interactions from "./interactions/index.js";
 export * from "./interactions/types/index.js";
-export * as transcripts from "./transcripts/index.js";
-export * from "./transcripts/types/index.js";
 export * as auth from "./auth/index.js";
 export * from "./auth/types/index.js";
 export * as stream from "./stream/index.js";
 export * as transcribe from "./transcribe/index.js";
 export * as recordings from "./recordings/index.js";
+export * as transcripts from "./transcripts/index.js";
 export * as facts from "./facts/index.js";
 export * as documents from "./documents/index.js";
 export * as templates from "./templates/index.js";

package/dist/cjs/api/resources/index.js

@@ -36,16 +36,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.templates = exports.documents = exports.facts = exports.recordings = exports.transcribe = exports.stream = exports.auth = exports.transcripts = exports.interactions = void 0;
+exports.templates = exports.documents = exports.facts = exports.transcripts = exports.recordings = exports.transcribe = exports.stream = exports.auth = exports.interactions = void 0;
 exports.interactions = __importStar(require("./interactions/index.js"));
 __exportStar(require("./interactions/types/index.js"), exports);
-exports.transcripts = __importStar(require("./transcripts/index.js"));
-__exportStar(require("./transcripts/types/index.js"), exports);
 exports.auth = __importStar(require("./auth/index.js"));
 __exportStar(require("./auth/types/index.js"), exports);
 exports.stream = __importStar(require("./stream/index.js"));
 exports.transcribe = __importStar(require("./transcribe/index.js"));
 exports.recordings = __importStar(require("./recordings/index.js"));
+exports.transcripts = __importStar(require("./transcripts/index.js"));
 exports.facts = __importStar(require("./facts/index.js"));
 exports.documents = __importStar(require("./documents/index.js"));
 exports.templates = __importStar(require("./templates/index.js"));

package/dist/cjs/api/resources/interactions/client/Client.d.ts

@@ -32,7 +32,7 @@ export declare class Interactions {
     protected readonly _options: Interactions.Options;
     constructor(_options: Interactions.Options);
     /**
-     *  Lists all existing interactions. Results can be filtered by encounter status and patient identifier.
+     * Lists all existing interactions. Results can be filtered by encounter status and patient identifier.
      *
      * @param {Corti.InteractionsListRequest} request
      * @param {Interactions.RequestOptions} requestOptions - Request-specific configuration.
@@ -45,7 +45,7 @@ export declare class Interactions {
      */
     list(request?: Corti.InteractionsListRequest, requestOptions?: Interactions.RequestOptions): Promise<core.Page<Corti.InteractionsGetResponse>>;
     /**
-     *  Creates a new interaction.
+     * Creates a new interaction.
      *
      * @param {Corti.InteractionsCreateRequest} request
      * @param {Interactions.RequestOptions} requestOptions - Request-specific configuration.
@@ -67,7 +67,7 @@ export declare class Interactions {
     create(request: Corti.InteractionsCreateRequest, requestOptions?: Interactions.RequestOptions): core.HttpResponsePromise<Corti.InteractionsCreateResponse>;
     private __create;
     /**
-     *  Retrieves a previously recorded interaction by its unique identifier (interaction ID).
+     * Retrieves a previously recorded interaction by its unique identifier (interaction ID).
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Interactions.RequestOptions} requestOptions - Request-specific configuration.
@@ -81,7 +81,7 @@ export declare class Interactions {
     get(id: Corti.Uuid, requestOptions?: Interactions.RequestOptions): core.HttpResponsePromise<Corti.InteractionsGetResponse>;
     private __get;
     /**
-     *  Deletes an existing interaction.
+     * Deletes an existing interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Interactions.RequestOptions} requestOptions - Request-specific configuration.
@@ -95,7 +95,7 @@ export declare class Interactions {
     delete(id: Corti.Uuid, requestOptions?: Interactions.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     /**
-     *  Modifies an existing interaction by updating specific fields without overwriting the entire record.
+     * Modifies an existing interaction by updating specific fields without overwriting the entire record.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.InteractionsUpdateRequest} request

package/dist/cjs/api/resources/interactions/client/Client.js

@@ -56,7 +56,7 @@ class Interactions {
         this._options = _options;
     }
     /**
-     *  Lists all existing interactions. Results can be filtered by encounter status and patient identifier.
+     * Lists all existing interactions. Results can be filtered by encounter status and patient identifier.
      *
      * @param {Corti.InteractionsListRequest} request
      * @param {Interactions.RequestOptions} requestOptions - Request-specific configuration.
@@ -186,7 +186,7 @@ class Interactions {
         });
     }
     /**
-     *  Creates a new interaction.
+     * Creates a new interaction.
      *
      * @param {Corti.InteractionsCreateRequest} request
      * @param {Interactions.RequestOptions} requestOptions - Request-specific configuration.
@@ -288,7 +288,7 @@ class Interactions {
         });
     }
     /**
-     *  Retrieves a previously recorded interaction by its unique identifier (interaction ID).
+     * Retrieves a previously recorded interaction by its unique identifier (interaction ID).
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Interactions.RequestOptions} requestOptions - Request-specific configuration.
@@ -372,7 +372,7 @@ class Interactions {
         });
     }
     /**
-     *  Deletes an existing interaction.
+     * Deletes an existing interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Interactions.RequestOptions} requestOptions - Request-specific configuration.
@@ -447,7 +447,7 @@ class Interactions {
         });
     }
     /**
-     *  Modifies an existing interaction by updating specific fields without overwriting the entire record.
+     * Modifies an existing interaction by updating specific fields without overwriting the entire record.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.InteractionsUpdateRequest} request

package/dist/cjs/api/resources/recordings/client/Client.d.ts

@@ -4,8 +4,6 @@
 import * as environments from "../../../../environments.js";
 import * as core from "../../../../core/index.js";
 import * as Corti from "../../../index.js";
-import * as fs from "fs";
-import { Blob } from "buffer";
 export declare namespace Recordings {
     interface Options {
         environment: core.Supplier<environments.CortiEnvironment | environments.CortiEnvironmentUrls>;
@@ -34,7 +32,7 @@ export declare class Recordings {
     protected readonly _options: Recordings.Options;
     constructor(_options: Recordings.Options);
     /**
-     *  Retrieve a list of recordings for a given interaction.
+     * Retrieve a list of recordings for a given interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Recordings.RequestOptions} requestOptions - Request-specific configuration.
@@ -50,9 +48,9 @@ export declare class Recordings {
     list(id: Corti.Uuid, requestOptions?: Recordings.RequestOptions): core.HttpResponsePromise<Corti.RecordingsListResponse>;
     private __list;
     /**
-     *  Upload a recording for a given interaction. There is a maximum limit of 60 minutes in length and 150MB in size for recordings.
+     * Upload a recording for a given interaction. There is a maximum limit of 60 minutes in length and 150MB in size for recordings.
      *
-     * @param {File | fs.ReadStream | Blob} bytes
+     * @param {core.file.Uploadable} uploadable
      * @param {Corti.Uuid} id
      * @param {Recordings.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -61,10 +59,10 @@ export declare class Recordings {
      * @throws {@link Corti.InternalServerError}
      * @throws {@link Corti.GatewayTimeoutError}
      */
-    upload(bytes: File | fs.ReadStream | Blob, id: Corti.Uuid, requestOptions?: Recordings.RequestOptions): core.HttpResponsePromise<Corti.RecordingsCreateResponse>;
+    upload(uploadable: core.file.Uploadable, id: Corti.Uuid, requestOptions?: Recordings.RequestOptions): core.HttpResponsePromise<Corti.RecordingsCreateResponse>;
     private __upload;
     /**
-     *  Retrieve a specific recording for a given interaction.
+     * Retrieve a specific recording for a given interaction.
      * @throws {@link Corti.BadRequestError}
      * @throws {@link Corti.ForbiddenError}
      * @throws {@link Corti.NotFoundError}
@@ -74,7 +72,7 @@ export declare class Recordings {
     get(id: Corti.Uuid, recordingId: Corti.Uuid, requestOptions?: Recordings.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __get;
     /**
-     *  Delete a specific recording for a given interaction.
+     * Delete a specific recording for a given interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} recordingId - The unique identifier of the recording. Must be a valid UUID.

package/dist/cjs/api/resources/recordings/client/Client.js

@@ -56,7 +56,7 @@ class Recordings {
         this._options = _options;
     }
     /**
-     *  Retrieve a list of recordings for a given interaction.
+     * Retrieve a list of recordings for a given interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Recordings.RequestOptions} requestOptions - Request-specific configuration.
@@ -146,9 +146,9 @@ class Recordings {
         });
     }
     /**
-     *  Upload a recording for a given interaction. There is a maximum limit of 60 minutes in length and 150MB in size for recordings.
+     * Upload a recording for a given interaction. There is a maximum limit of 60 minutes in length and 150MB in size for recordings.
      *
-     * @param {File | fs.ReadStream | Blob} bytes
+     * @param {core.file.Uploadable} uploadable
      * @param {Corti.Uuid} id
      * @param {Recordings.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -157,23 +157,24 @@ class Recordings {
      * @throws {@link Corti.InternalServerError}
      * @throws {@link Corti.GatewayTimeoutError}
      */
-    upload(bytes, id, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__upload(bytes, id, requestOptions));
+    upload(uploadable, id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__upload(uploadable, id, requestOptions));
     }
-    __upload(bytes, id, requestOptions) {
+    __upload(uploadable, id, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
+            const _binaryUploadRequest = yield core.file.toBinaryUploadRequest(uploadable);
             const _response = yield core.fetcher({
                 url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment)).base, `interactions/${encodeURIComponent(serializers.Uuid.jsonOrThrow(id, { omitUndefined: true }))}/recordings/`),
                 method: "POST",
                 headers: (0, headers_js_1.mergeHeaders)((_b = this._options) === null || _b === void 0 ? void 0 : _b.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
                     Authorization: yield this._getAuthorizationHeader(),
                     "Tenant-Name": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.tenantName,
-                }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                }), _binaryUploadRequest.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/octet-stream",
                 requestType: "bytes",
                 duplex: "half",
-                body: bytes,
+                body: _binaryUploadRequest.body,
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -238,7 +239,7 @@ class Recordings {
         });
     }
     /**
-     *  Retrieve a specific recording for a given interaction.
+     * Retrieve a specific recording for a given interaction.
      * @throws {@link Corti.BadRequestError}
      * @throws {@link Corti.ForbiddenError}
      * @throws {@link Corti.NotFoundError}
@@ -279,13 +280,7 @@ class Recordings {
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
                     case 404:
-                        throw new Corti.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
+                        throw new Corti.NotFoundError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Corti.InternalServerError(_response.error.body, _response.rawResponse);
                     case 504:
@@ -322,7 +317,7 @@ class Recordings {
         });
     }
     /**
-     *  Delete a specific recording for a given interaction.
+     * Delete a specific recording for a given interaction.
      *
      * @param {Corti.Uuid} id - The unique identifier of the interaction. Must be a valid UUID.
      * @param {Corti.Uuid} recordingId - The unique identifier of the recording. Must be a valid UUID.
@@ -367,13 +362,7 @@ class Recordings {
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
                     case 404:
-                        throw new Corti.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            skipValidation: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
+                        throw new Corti.NotFoundError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new Corti.InternalServerError(_response.error.body, _response.rawResponse);
                     case 504:

package/dist/cjs/api/resources/templates/client/Client.d.ts

@@ -32,7 +32,7 @@ export declare class Templates {
     protected readonly _options: Templates.Options;
     constructor(_options: Templates.Options);
     /**
-     *  Retrieves a list of template sections with optional filters for organization and language.
+     * Retrieves a list of template sections with optional filters for organization and language.
      *
      * @param {Corti.TemplatesSectionListRequest} request
      * @param {Templates.RequestOptions} requestOptions - Request-specific configuration.
@@ -46,7 +46,7 @@ export declare class Templates {
     sectionList(request?: Corti.TemplatesSectionListRequest, requestOptions?: Templates.RequestOptions): core.HttpResponsePromise<Corti.TemplatesSectionListResponse>;
     private __sectionList;
     /**
-     *  Retrieves a list of templates with optional filters for organization, language, and status.
+     * Retrieves a list of templates with optional filters for organization, language, and status.
      *
      * @param {Corti.TemplatesListRequest} request
      * @param {Templates.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/templates/client/Client.js

@@ -56,7 +56,7 @@ class Templates {
         this._options = _options;
     }
     /**
-     *  Retrieves a list of template sections with optional filters for organization and language.
+     * Retrieves a list of template sections with optional filters for organization and language.
      *
      * @param {Corti.TemplatesSectionListRequest} request
      * @param {Templates.RequestOptions} requestOptions - Request-specific configuration.
@@ -147,7 +147,7 @@ class Templates {
         });
     }
     /**
-     *  Retrieves a list of templates with optional filters for organization, language, and status.
+     * Retrieves a list of templates with optional filters for organization, language, and status.
      *
      * @param {Corti.TemplatesListRequest} request
      * @param {Templates.RequestOptions} requestOptions - Request-specific configuration.