minikai 1.17.1 → 1.18.0

package/README.md

@@ -14,6 +14,7 @@ The Minikai TypeScript library provides convenient access to the Minikai APIs fr
 - [Request and Response Types](#request-and-response-types)
 - [Exception Handling](#exception-handling)
 - [File Uploads](#file-uploads)
+- [Binary Response](#binary-response)
 - [Advanced](#advanced)
   - [Subpackage Exports](#subpackage-exports)
   - [Additional Headers](#additional-headers)
@@ -140,6 +141,395 @@ The metadata is used to set the `Content-Length`, `Content-Type`, and `Content-D
 For example, `fs.ReadStream` has a `path` property which the SDK uses to retrieve the file size from the filesystem without loading it into memory.
 
 
+## Binary Response
+
+You can consume binary data from endpoints using the `BinaryResponse` type which lets you choose how to consume the data:
+
+```typescript
+const response = await client.minis.downloadMiniProfilePicture(...);
+const stream: ReadableStream<Uint8Array> = response.stream();
+// const arrayBuffer: ArrayBuffer = await response.arrayBuffer();
+// const blob: Blob = response.blob();
+// const bytes: Uint8Array = response.bytes();
+// You can only use the response body once, so you must choose one of the above methods.
+// If you want to check if the response body has been used, you can use the following property.
+const bodyUsed = response.bodyUsed;
+```
+<details>
+<summary>Save binary response to a file</summary>
+
+<blockquote>
+<details>
+<summary>Node.js</summary>
+
+<blockquote>
+<details>
+<summary>ReadableStream (most-efficient)</summary>
+
+```ts
+import { createWriteStream } from 'fs';
+import { Readable } from 'stream';
+import { pipeline } from 'stream/promises';
+
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const stream = response.stream();
+const nodeStream = Readable.fromWeb(stream);
+const writeStream = createWriteStream('path/to/file');
+
+await pipeline(nodeStream, writeStream);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>ArrayBuffer</summary>
+
+```ts
+import { writeFile } from 'fs/promises';
+
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const arrayBuffer = await response.arrayBuffer();
+await writeFile('path/to/file', Buffer.from(arrayBuffer));
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Blob</summary>
+
+```ts
+import { writeFile } from 'fs/promises';
+
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const blob = await response.blob();
+const arrayBuffer = await blob.arrayBuffer();
+await writeFile('output.bin', Buffer.from(arrayBuffer));
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Bytes (UIntArray8)</summary>
+
+```ts
+import { writeFile } from 'fs/promises';
+
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const bytes = await response.bytes();
+await writeFile('path/to/file', bytes);
+```
+
+</details>
+</blockquote>
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Bun</summary>
+
+<blockquote>
+<details>
+<summary>ReadableStream (most-efficient)</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const stream = response.stream();
+await Bun.write('path/to/file', stream);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>ArrayBuffer</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const arrayBuffer = await response.arrayBuffer();
+await Bun.write('path/to/file', arrayBuffer);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Blob</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const blob = await response.blob();
+await Bun.write('path/to/file', blob);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Bytes (UIntArray8)</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const bytes = await response.bytes();
+await Bun.write('path/to/file', bytes);
+```
+
+</details>
+</blockquote>
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Deno</summary>
+
+<blockquote>
+<details>
+<summary>ReadableStream (most-efficient)</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const stream = response.stream();
+const file = await Deno.open('path/to/file', { write: true, create: true });
+await stream.pipeTo(file.writable);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>ArrayBuffer</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const arrayBuffer = await response.arrayBuffer();
+await Deno.writeFile('path/to/file', new Uint8Array(arrayBuffer));
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Blob</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const blob = await response.blob();
+const arrayBuffer = await blob.arrayBuffer();
+await Deno.writeFile('path/to/file', new Uint8Array(arrayBuffer));
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Bytes (UIntArray8)</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const bytes = await response.bytes();
+await Deno.writeFile('path/to/file', bytes);
+```
+
+</details>
+</blockquote>
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Browser</summary>
+
+<blockquote>
+<details>
+<summary>Blob (most-efficient)</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const blob = await response.blob();
+const url = URL.createObjectURL(blob);
+
+// trigger download
+const a = document.createElement('a');
+a.href = url;
+a.download = 'filename';
+a.click();
+URL.revokeObjectURL(url);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>ReadableStream</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const stream = response.stream();
+const reader = stream.getReader();
+const chunks = [];
+
+while (true) {
+  const { done, value } = await reader.read();
+  if (done) break;
+  chunks.push(value);
+}
+
+const blob = new Blob(chunks);
+const url = URL.createObjectURL(blob);
+
+// trigger download
+const a = document.createElement('a');
+a.href = url;
+a.download = 'filename';
+a.click();
+URL.revokeObjectURL(url);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>ArrayBuffer</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const arrayBuffer = await response.arrayBuffer();
+const blob = new Blob([arrayBuffer]);
+const url = URL.createObjectURL(blob);
+
+// trigger download
+const a = document.createElement('a');
+a.href = url;
+a.download = 'filename';
+a.click();
+URL.revokeObjectURL(url);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Bytes (UIntArray8)</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const bytes = await response.bytes();
+const blob = new Blob([bytes]);
+const url = URL.createObjectURL(blob);
+
+// trigger download
+const a = document.createElement('a');
+a.href = url;
+a.download = 'filename';
+a.click();
+URL.revokeObjectURL(url);
+```
+
+</details>
+</blockquote>
+
+</details>
+</blockquote>
+
+</details>
+</blockquote>
+
+<details>
+<summary>Convert binary response to text</summary>
+
+<blockquote>
+<details>
+<summary>ReadableStream</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const stream = response.stream();
+const text = await new Response(stream).text();
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>ArrayBuffer</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const arrayBuffer = await response.arrayBuffer();
+const text = new TextDecoder().decode(arrayBuffer);
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Blob</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const blob = await response.blob();
+const text = await blob.text();
+```
+
+</details>
+</blockquote>
+
+<blockquote>
+<details>
+<summary>Bytes (UIntArray8)</summary>
+
+```ts
+const response = await client.minis.downloadMiniProfilePicture(...);
+
+const bytes = await response.bytes();
+const text = new TextDecoder().decode(bytes);
+```
+
+</details>
+</blockquote>
+
+</details>
+
 ## Advanced
 
 ### Subpackage Exports

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "minikai",
-        "X-Fern-SDK-Version": "1.17.1",
-        "User-Agent": "minikai/1.17.1",
+        "X-Fern-SDK-Version": "1.18.0",
+        "User-Agent": "minikai/1.18.0",
         "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/resources/minis/client/Client.d.ts

@@ -176,7 +176,7 @@ export declare class MinisClient {
      * Retrieve a single version of a Mini.
      *
      * @param {string} id - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
-     * @param {string} versionId - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
+     * @param {string} versionId
      * @param {MinisClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Minikai.NotFoundError}
@@ -217,4 +217,11 @@ export declare class MinisClient {
      */
     deleteMiniProfilePicture(id: string, requestOptions?: MinisClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteMiniProfilePicture;
+    /**
+     * Download a Mini's profile picture by its stored picture id.
+     *
+     * @throws {@link Minikai.NotFoundError}
+     */
+    downloadMiniProfilePicture(id: string, pictureId: string, requestOptions?: MinisClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __downloadMiniProfilePicture;
 }

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

@@ -656,7 +656,7 @@ class MinisClient {
      * Retrieve a single version of a Mini.
      *
      * @param {string} id - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
-     * @param {string} versionId - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
+     * @param {string} versionId
      * @param {MinisClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Minikai.NotFoundError}
@@ -810,5 +810,48 @@ class MinisClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/api/v1/Minis/{id}/profile-picture");
         });
     }
+    /**
+     * Download a Mini's profile picture by its stored picture id.
+     *
+     * @throws {@link Minikai.NotFoundError}
+     */
+    downloadMiniProfilePicture(id, pictureId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__downloadMiniProfilePicture(id, pictureId, requestOptions));
+    }
+    __downloadMiniProfilePicture(id, pictureId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MinikaiEnvironment.Default, `api/v1/Minis/${core.url.encodePathParam(id)}/profile-picture/${core.url.encodePathParam(pictureId)}`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                responseType: "binary-response",
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new Minikai.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.MinikaiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/Minis/{id}/profile-picture/{pictureId}");
+        });
+    }
 }
 exports.MinisClient = MinisClient;

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

@@ -373,16 +373,9 @@ export declare class RecordsClient {
     /**
      * Download a Record's attachment.
      *
-     * @param {string} recordId - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
-     * @param {string} attachmentId
-     * @param {RecordsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
      * @throws {@link Minikai.NotFoundError}
-     *
-     * @example
-     *     await client.records.downloadAttachment("recordId", "attachmentId")
      */
-    downloadAttachment(recordId: string, attachmentId: string, requestOptions?: RecordsClient.RequestOptions): core.HttpResponsePromise<void>;
+    downloadAttachment(recordId: string, attachmentId: string, requestOptions?: RecordsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __downloadAttachment;
     /**
      * Link a Record to other Records.

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

@@ -1380,14 +1380,7 @@ class RecordsClient {
     /**
      * Download a Record's attachment.
      *
-     * @param {string} recordId - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
-     * @param {string} attachmentId
-     * @param {RecordsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
      * @throws {@link Minikai.NotFoundError}
-     *
-     * @example
-     *     await client.records.downloadAttachment("recordId", "attachmentId")
      */
     downloadAttachment(recordId, attachmentId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__downloadAttachment(recordId, attachmentId, requestOptions));
@@ -1402,6 +1395,7 @@ class RecordsClient {
                 method: "GET",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                responseType: "binary-response",
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -1409,7 +1403,7 @@ class RecordsClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: undefined, rawResponse: _response.rawResponse };
+                return { data: _response.body, rawResponse: _response.rawResponse };
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {

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

@@ -170,4 +170,11 @@ export declare class SkillsClient {
      */
     deleteSkillAsset(id: string, assetName: string, requestOptions?: SkillsClient.RequestOptions): core.HttpResponsePromise<Minikai.SkillDto>;
     private __deleteSkillAsset;
+    /**
+     * Download a skill's asset by id.
+     *
+     * @throws {@link Minikai.NotFoundError}
+     */
+    downloadSkillAsset(id: string, assetId: string, requestOptions?: SkillsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __downloadSkillAsset;
 }

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

@@ -631,5 +631,48 @@ class SkillsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/api/v1/Skills/{id}/assets/{assetName}");
         });
     }
+    /**
+     * Download a skill's asset by id.
+     *
+     * @throws {@link Minikai.NotFoundError}
+     */
+    downloadSkillAsset(id, assetId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__downloadSkillAsset(id, assetId, requestOptions));
+    }
+    __downloadSkillAsset(id, assetId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MinikaiEnvironment.Default, `api/v1/Skills/${core.url.encodePathParam(id)}/assets/${core.url.encodePathParam(assetId)}`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                responseType: "binary-response",
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new Minikai.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.MinikaiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/Skills/{id}/assets/{assetId}");
+        });
+    }
 }
 exports.SkillsClient = SkillsClient;

package/dist/cjs/api/types/StringSegment.d.ts

@@ -0,0 +1,7 @@
+export interface StringSegment {
+    buffer?: (string | null) | undefined;
+    offset?: unknown | undefined;
+    length?: unknown | undefined;
+    value?: (string | null) | undefined;
+    hasValue?: boolean | undefined;
+}

package/dist/cjs/api/types/StringSegment.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -40,6 +40,7 @@ export * from "./SkillAssetType.js";
 export * from "./SkillDto.js";
 export * from "./SkillState.js";
 export * from "./SkillSummaryDto.js";
+export * from "./StringSegment.js";
 export * from "./UpsertRecordDto.js";
 export * from "./UpsertRecordsByExternalUriCommand.js";
 export * from "./UserDto.js";

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

@@ -56,6 +56,7 @@ __exportStar(require("./SkillAssetType.js"), exports);
 __exportStar(require("./SkillDto.js"), exports);
 __exportStar(require("./SkillState.js"), exports);
 __exportStar(require("./SkillSummaryDto.js"), exports);
+__exportStar(require("./StringSegment.js"), exports);
 __exportStar(require("./UpsertRecordDto.js"), exports);
 __exportStar(require("./UpsertRecordsByExternalUriCommand.js"), exports);
 __exportStar(require("./UserDto.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.17.1";
+export declare const SDK_VERSION = "1.18.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.17.1";
+exports.SDK_VERSION = "1.18.0";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "minikai",
-        "X-Fern-SDK-Version": "1.17.1",
-        "User-Agent": "minikai/1.17.1",
+        "X-Fern-SDK-Version": "1.18.0",
+        "User-Agent": "minikai/1.18.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/minis/client/Client.d.mts

@@ -176,7 +176,7 @@ export declare class MinisClient {
      * Retrieve a single version of a Mini.
      *
      * @param {string} id - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
-     * @param {string} versionId - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
+     * @param {string} versionId
      * @param {MinisClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Minikai.NotFoundError}
@@ -217,4 +217,11 @@ export declare class MinisClient {
      */
     deleteMiniProfilePicture(id: string, requestOptions?: MinisClient.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteMiniProfilePicture;
+    /**
+     * Download a Mini's profile picture by its stored picture id.
+     *
+     * @throws {@link Minikai.NotFoundError}
+     */
+    downloadMiniProfilePicture(id: string, pictureId: string, requestOptions?: MinisClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __downloadMiniProfilePicture;
 }

package/dist/esm/api/resources/minis/client/Client.mjs

@@ -620,7 +620,7 @@ export class MinisClient {
      * Retrieve a single version of a Mini.
      *
      * @param {string} id - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
-     * @param {string} versionId - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
+     * @param {string} versionId
      * @param {MinisClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Minikai.NotFoundError}
@@ -774,4 +774,47 @@ export class MinisClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/api/v1/Minis/{id}/profile-picture");
         });
     }
+    /**
+     * Download a Mini's profile picture by its stored picture id.
+     *
+     * @throws {@link Minikai.NotFoundError}
+     */
+    downloadMiniProfilePicture(id, pictureId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__downloadMiniProfilePicture(id, pictureId, requestOptions));
+    }
+    __downloadMiniProfilePicture(id, pictureId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MinikaiEnvironment.Default, `api/v1/Minis/${core.url.encodePathParam(id)}/profile-picture/${core.url.encodePathParam(pictureId)}`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                responseType: "binary-response",
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new Minikai.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.MinikaiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/Minis/{id}/profile-picture/{pictureId}");
+        });
+    }
 }

package/dist/esm/api/resources/records/client/Client.d.mts

@@ -373,16 +373,9 @@ export declare class RecordsClient {
     /**
      * Download a Record's attachment.
      *
-     * @param {string} recordId - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
-     * @param {string} attachmentId
-     * @param {RecordsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
      * @throws {@link Minikai.NotFoundError}
-     *
-     * @example
-     *     await client.records.downloadAttachment("recordId", "attachmentId")
      */
-    downloadAttachment(recordId: string, attachmentId: string, requestOptions?: RecordsClient.RequestOptions): core.HttpResponsePromise<void>;
+    downloadAttachment(recordId: string, attachmentId: string, requestOptions?: RecordsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __downloadAttachment;
     /**
      * Link a Record to other Records.

package/dist/esm/api/resources/records/client/Client.mjs

@@ -1344,14 +1344,7 @@ export class RecordsClient {
     /**
      * Download a Record's attachment.
      *
-     * @param {string} recordId - Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
-     * @param {string} attachmentId
-     * @param {RecordsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
      * @throws {@link Minikai.NotFoundError}
-     *
-     * @example
-     *     await client.records.downloadAttachment("recordId", "attachmentId")
      */
     downloadAttachment(recordId, attachmentId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__downloadAttachment(recordId, attachmentId, requestOptions));
@@ -1366,6 +1359,7 @@ export class RecordsClient {
                 method: "GET",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                responseType: "binary-response",
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -1373,7 +1367,7 @@ export class RecordsClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: undefined, rawResponse: _response.rawResponse };
+                return { data: _response.body, rawResponse: _response.rawResponse };
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {

package/dist/esm/api/resources/skills/client/Client.d.mts

@@ -170,4 +170,11 @@ export declare class SkillsClient {
      */
     deleteSkillAsset(id: string, assetName: string, requestOptions?: SkillsClient.RequestOptions): core.HttpResponsePromise<Minikai.SkillDto>;
     private __deleteSkillAsset;
+    /**
+     * Download a skill's asset by id.
+     *
+     * @throws {@link Minikai.NotFoundError}
+     */
+    downloadSkillAsset(id: string, assetId: string, requestOptions?: SkillsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __downloadSkillAsset;
 }

package/dist/esm/api/resources/skills/client/Client.mjs

@@ -595,4 +595,47 @@ export class SkillsClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/api/v1/Skills/{id}/assets/{assetName}");
         });
     }
+    /**
+     * Download a skill's asset by id.
+     *
+     * @throws {@link Minikai.NotFoundError}
+     */
+    downloadSkillAsset(id, assetId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__downloadSkillAsset(id, assetId, requestOptions));
+    }
+    __downloadSkillAsset(id, assetId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MinikaiEnvironment.Default, `api/v1/Skills/${core.url.encodePathParam(id)}/assets/${core.url.encodePathParam(assetId)}`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                responseType: "binary-response",
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new Minikai.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.MinikaiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/Skills/{id}/assets/{assetId}");
+        });
+    }
 }

package/dist/esm/api/types/StringSegment.d.mts

@@ -0,0 +1,7 @@
+export interface StringSegment {
+    buffer?: (string | null) | undefined;
+    offset?: unknown | undefined;
+    length?: unknown | undefined;
+    value?: (string | null) | undefined;
+    hasValue?: boolean | undefined;
+}

package/dist/esm/api/types/StringSegment.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -40,6 +40,7 @@ export * from "./SkillAssetType.mjs";
 export * from "./SkillDto.mjs";
 export * from "./SkillState.mjs";
 export * from "./SkillSummaryDto.mjs";
+export * from "./StringSegment.mjs";
 export * from "./UpsertRecordDto.mjs";
 export * from "./UpsertRecordsByExternalUriCommand.mjs";
 export * from "./UserDto.mjs";

package/dist/esm/api/types/index.mjs

@@ -40,6 +40,7 @@ export * from "./SkillAssetType.mjs";
 export * from "./SkillDto.mjs";
 export * from "./SkillState.mjs";
 export * from "./SkillSummaryDto.mjs";
+export * from "./StringSegment.mjs";
 export * from "./UpsertRecordDto.mjs";
 export * from "./UpsertRecordsByExternalUriCommand.mjs";
 export * from "./UserDto.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.17.1";
+export declare const SDK_VERSION = "1.18.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "1.17.1";
+export const SDK_VERSION = "1.18.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "minikai",
-    "version": "1.17.1",
+    "version": "1.18.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -1059,7 +1059,7 @@ await client.minis.getMiniVersion("id", "versionId");
 <dl>
 <dd>
 
-**versionId:** `string` — Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
+**versionId:** `string` 
     
 </dd>
 </dl>
@@ -1211,6 +1211,77 @@ await client.minis.deleteMiniProfilePicture("id");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.minis.<a href="/src/api/resources/minis/client/Client.ts">downloadMiniProfilePicture</a>(id, pictureId) -> core.BinaryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Download a Mini's profile picture by its stored picture id.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.minis.downloadMiniProfilePicture("id", "pictureId");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Either the Minikai-assigned Guid for this resource (e.g. `abc12345-1234-1234-1234-123456789abc`) or the resource's `externalUri`, URL-encoded (e.g. `https%3A%2F%2Fpartner.example.com%2Fpatients%2F48291`). Responses always return the canonical Guid in the `id` field.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**pictureId:** `string` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MinisClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2728,7 +2799,7 @@ await client.records.removeAttachments("recordId", {
 </dl>
 </details>
 
-<details><summary><code>client.records.<a href="/src/api/resources/records/client/Client.ts">downloadAttachment</a>(recordId, attachmentId) -> void</code></summary>
+<details><summary><code>client.records.<a href="/src/api/resources/records/client/Client.ts">downloadAttachment</a>(recordId, attachmentId) -> core.BinaryResponse</code></summary>
 <dl>
 <dd>
 
@@ -3998,6 +4069,77 @@ await client.skills.deleteSkillAsset("id", "assetName");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.skills.<a href="/src/api/resources/skills/client/Client.ts">downloadSkillAsset</a>(id, assetId) -> core.BinaryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Download a skill's asset by id.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.skills.downloadSkillAsset("id", "assetId");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**assetId:** `string` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SkillsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>