@nizam-os/operator-sdk 2.5.2 → 2.7.0

package/dist/api/resources/taskAttempts/client/Client.js

@@ -0,0 +1,214 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskAttemptsClient = void 0;
+const BaseClient_js_1 = require("../../../../BaseClient.js");
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
+const errors = __importStar(require("../../../../errors/index.js"));
+const NizamOperatorRuntime = __importStar(require("../../../index.js"));
+class TaskAttemptsClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * The attempt's photos in capture order, each with its scan-gated downloadability and rendered thumbnail variants. Bytes are requested per file via the generic download-URL endpoint (access-logged for this kind).
+     *
+     * @param {NizamOperatorRuntime.ListTaskAttemptPhotosRequest} request
+     * @param {TaskAttemptsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.BadRequestError}
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.NotFoundError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.taskAttempts.listTaskAttemptPhotos({
+     *         attemptId: "00000000-0000-0000-0000-000000000000",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listTaskAttemptPhotos(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listTaskAttemptPhotos(request, requestOptions));
+    }
+    async __listTaskAttemptPhotos(request, requestOptions) {
+        const { attemptId, limit, starting_after: startingAfter, ending_before: endingBefore } = request;
+        const _queryParams = {
+            limit,
+            starting_after: startingAfter,
+            ending_before: endingBefore,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamOperatorRuntimeEnvironment.Production, `v1/task-attempts/${core.url.encodePathParam(attemptId)}/photos`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.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 400:
+                    throw new NizamOperatorRuntime.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new NizamOperatorRuntime.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamOperatorRuntime.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamOperatorRuntime.NotFoundError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamOperatorRuntime.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamOperatorRuntime.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamOperatorRuntimeError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/task-attempts/{attemptId}/photos");
+    }
+    /**
+     * Declares a proof-of-delivery photo upload for the attempt and returns presigned part URLs. PUT the bytes, then complete via the generic file-uploads endpoint — completion records the photo (with the capture facts declared here) atomically and queues the malware scan; the photo becomes downloadable only after a CLEAN verdict.
+     *
+     * @param {NizamOperatorRuntime.CaptureTaskAttemptPhotoRequest} request
+     * @param {TaskAttemptsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.BadRequestError}
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.NotFoundError}
+     * @throws {@link NizamOperatorRuntime.ContentTooLargeError}
+     * @throws {@link NizamOperatorRuntime.UnprocessableEntityError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.taskAttempts.captureTaskAttemptPhoto({
+     *         attemptId: "00000000-0000-0000-0000-000000000000",
+     *         filename: "delivery-door.jpg",
+     *         content_type: "image/jpeg",
+     *         size_bytes: 2048576,
+     *         checksum_sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
+     *         sequence: 0,
+     *         photo_type: "placement",
+     *         caption: "Left at the front door as instructed",
+     *         taken_at: "2026-06-12T09:41:00Z"
+     *     })
+     */
+    captureTaskAttemptPhoto(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__captureTaskAttemptPhoto(request, requestOptions));
+    }
+    async __captureTaskAttemptPhoto(request, requestOptions) {
+        const { attemptId, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamOperatorRuntimeEnvironment.Production, `v1/task-attempts/${core.url.encodePathParam(attemptId)}/photos`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.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 400:
+                    throw new NizamOperatorRuntime.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new NizamOperatorRuntime.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamOperatorRuntime.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamOperatorRuntime.NotFoundError(_response.error.body, _response.rawResponse);
+                case 413:
+                    throw new NizamOperatorRuntime.ContentTooLargeError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new NizamOperatorRuntime.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamOperatorRuntime.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamOperatorRuntime.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamOperatorRuntimeError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/task-attempts/{attemptId}/photos");
+    }
+}
+exports.TaskAttemptsClient = TaskAttemptsClient;

package/dist/api/resources/taskAttempts/client/index.d.ts

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

package/dist/api/resources/taskAttempts/client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./requests/index.js"), exports);

package/dist/api/resources/taskAttempts/client/requests/CaptureTaskAttemptPhotoRequest.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @example
+ *     {
+ *         attemptId: "00000000-0000-0000-0000-000000000000",
+ *         filename: "delivery-door.jpg",
+ *         content_type: "image/jpeg",
+ *         size_bytes: 2048576,
+ *         checksum_sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
+ *         sequence: 0,
+ *         photo_type: "placement",
+ *         caption: "Left at the front door as instructed",
+ *         taken_at: "2026-06-12T09:41:00Z"
+ *     }
+ */
+export interface CaptureTaskAttemptPhotoRequest {
+    attemptId: string;
+    /** Original filename. */
+    filename: string;
+    /** Declared MIME type — POD photos accept image/jpeg, image/png, image/webp, image/heic, image/heif. */
+    content_type: string;
+    /** Exact byte size; verified against storage at completion. */
+    size_bytes?: number;
+    /** Client-computed SHA-256 of the content, lowercase hex; re-verified server-side by the pipeline. */
+    checksum_sha256: string;
+    /** Display order within the attempt; defaults to the next free slot. */
+    sequence?: number;
+    /** Photo category: `proof_of_delivery`, `placement`, `contents`, `damage`, `door`, `signature`, `id_verification`, `barcode`, `site_condition`, `other`. Omit for a free capture. */
+    photo_type?: CaptureTaskAttemptPhotoRequest.PhotoType;
+    /** Operator-entered caption. */
+    caption?: string;
+    /** Capture timestamp from the device (EXIF time) — distinct from the upload time, which may lag over flaky mobile connections. */
+    taken_at?: string;
+}
+export declare namespace CaptureTaskAttemptPhotoRequest {
+    /** Photo category: `proof_of_delivery`, `placement`, `contents`, `damage`, `door`, `signature`, `id_verification`, `barcode`, `site_condition`, `other`. Omit for a free capture. */
+    const PhotoType: {
+        readonly ProofOfDelivery: "proof_of_delivery";
+        readonly Placement: "placement";
+        readonly Contents: "contents";
+        readonly Damage: "damage";
+        readonly Door: "door";
+        readonly Signature: "signature";
+        readonly IdVerification: "id_verification";
+        readonly Barcode: "barcode";
+        readonly SiteCondition: "site_condition";
+        readonly Other: "other";
+    };
+    type PhotoType = (typeof PhotoType)[keyof typeof PhotoType];
+}

package/dist/api/resources/taskAttempts/client/requests/CaptureTaskAttemptPhotoRequest.js

@@ -0,0 +1,20 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptureTaskAttemptPhotoRequest = void 0;
+var CaptureTaskAttemptPhotoRequest;
+(function (CaptureTaskAttemptPhotoRequest) {
+    /** Photo category: `proof_of_delivery`, `placement`, `contents`, `damage`, `door`, `signature`, `id_verification`, `barcode`, `site_condition`, `other`. Omit for a free capture. */
+    CaptureTaskAttemptPhotoRequest.PhotoType = {
+        ProofOfDelivery: "proof_of_delivery",
+        Placement: "placement",
+        Contents: "contents",
+        Damage: "damage",
+        Door: "door",
+        Signature: "signature",
+        IdVerification: "id_verification",
+        Barcode: "barcode",
+        SiteCondition: "site_condition",
+        Other: "other",
+    };
+})(CaptureTaskAttemptPhotoRequest || (exports.CaptureTaskAttemptPhotoRequest = CaptureTaskAttemptPhotoRequest = {}));

package/dist/api/resources/taskAttempts/client/requests/ListTaskAttemptPhotosRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @example
+ *     {
+ *         attemptId: "00000000-0000-0000-0000-000000000000",
+ *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+ *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+ *     }
+ */
+export interface ListTaskAttemptPhotosRequest {
+    attemptId: string;
+    /** Page size. Default 20, maximum 100. Out-of-range values are silently clamped; the response body's `limit` field reflects what was applied. */
+    limit?: number;
+    /** Opaque cursor — return the page starting strictly after this entity in the sort order. Mutually exclusive with `ending_before`. */
+    starting_after?: string;
+    /** Opaque cursor — return the page ending strictly before this entity in the sort order. Mutually exclusive with `starting_after`. */
+    ending_before?: string;
+}

package/dist/api/resources/taskAttempts/client/requests/ListTaskAttemptPhotosRequest.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/api/resources/taskAttempts/client/requests/index.d.ts

@@ -0,0 +1,2 @@
+export { CaptureTaskAttemptPhotoRequest } from "./CaptureTaskAttemptPhotoRequest.js";
+export type { ListTaskAttemptPhotosRequest } from "./ListTaskAttemptPhotosRequest.js";

package/dist/api/resources/taskAttempts/client/requests/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptureTaskAttemptPhotoRequest = void 0;
+var CaptureTaskAttemptPhotoRequest_js_1 = require("./CaptureTaskAttemptPhotoRequest.js");
+Object.defineProperty(exports, "CaptureTaskAttemptPhotoRequest", { enumerable: true, get: function () { return CaptureTaskAttemptPhotoRequest_js_1.CaptureTaskAttemptPhotoRequest; } });

package/dist/api/resources/taskAttempts/exports.d.ts

@@ -0,0 +1,2 @@
+export { TaskAttemptsClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/api/resources/taskAttempts/exports.js

@@ -0,0 +1,21 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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.TaskAttemptsClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "TaskAttemptsClient", { enumerable: true, get: function () { return Client_js_1.TaskAttemptsClient; } });
+__exportStar(require("./client/index.js"), exports);

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

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

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

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./client/index.js"), exports);

package/dist/api/resources/users/client/Client.d.ts

@@ -38,4 +38,47 @@ export declare class UsersClient {
      */
     me(requestOptions?: UsersClient.RequestOptions): core.HttpResponsePromise<NizamOperatorRuntime.User>;
     private __me;
+    /**
+     * Declares a profile-picture upload for the AUTHENTICATED user (the subject is pinned server-side) and returns presigned part URLs. PUT the bytes to the URLs, then complete via the generic file-uploads endpoint — completion re-points the profile and soft-deletes the replaced picture; thumbnails (256/128/64 px) render asynchronously. The reference upload flow of epic #151 (#166).
+     *
+     * @param {NizamOperatorRuntime.InitiateProfilePictureUploadRequest} request
+     * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.BadRequestError}
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.ContentTooLargeError}
+     * @throws {@link NizamOperatorRuntime.UnprocessableEntityError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.users.initiateProfilePictureUpload({
+     *         filename: "avatar.png",
+     *         content_type: "image/png",
+     *         size_bytes: 204857,
+     *         checksum_sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
+     *     })
+     */
+    initiateProfilePictureUpload(request: NizamOperatorRuntime.InitiateProfilePictureUploadRequest, requestOptions?: UsersClient.RequestOptions): core.HttpResponsePromise<NizamOperatorRuntime.UploadInitiation>;
+    private __initiateProfilePictureUpload;
+    /**
+     * 302-redirects to a short-lived URL for the thumbnail variant nearest the requested `size` (smallest rendered variant that still covers it; the original while thumbnails are still rendering). Cross-tenant callers get 404: the picture's file row is only visible inside the organization it was uploaded in (RLS).
+     *
+     * @param {NizamOperatorRuntime.GetUserProfilePictureRequest} request
+     * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.NotFoundError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.users.getUserProfilePicture({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    getUserProfilePicture(request: NizamOperatorRuntime.GetUserProfilePictureRequest, requestOptions?: UsersClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __getUserProfilePicture;
 }

package/dist/api/resources/users/client/Client.js

@@ -116,5 +116,150 @@ class UsersClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/me");
     }
+    /**
+     * Declares a profile-picture upload for the AUTHENTICATED user (the subject is pinned server-side) and returns presigned part URLs. PUT the bytes to the URLs, then complete via the generic file-uploads endpoint — completion re-points the profile and soft-deletes the replaced picture; thumbnails (256/128/64 px) render asynchronously. The reference upload flow of epic #151 (#166).
+     *
+     * @param {NizamOperatorRuntime.InitiateProfilePictureUploadRequest} request
+     * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.BadRequestError}
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.ContentTooLargeError}
+     * @throws {@link NizamOperatorRuntime.UnprocessableEntityError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.users.initiateProfilePictureUpload({
+     *         filename: "avatar.png",
+     *         content_type: "image/png",
+     *         size_bytes: 204857,
+     *         checksum_sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
+     *     })
+     */
+    initiateProfilePictureUpload(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__initiateProfilePictureUpload(request, requestOptions));
+    }
+    async __initiateProfilePictureUpload(request, requestOptions) {
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamOperatorRuntimeEnvironment.Production, "v1/me/profile-picture"),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: request,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.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 400:
+                    throw new NizamOperatorRuntime.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new NizamOperatorRuntime.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamOperatorRuntime.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 413:
+                    throw new NizamOperatorRuntime.ContentTooLargeError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new NizamOperatorRuntime.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamOperatorRuntime.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamOperatorRuntime.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamOperatorRuntimeError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/me/profile-picture");
+    }
+    /**
+     * 302-redirects to a short-lived URL for the thumbnail variant nearest the requested `size` (smallest rendered variant that still covers it; the original while thumbnails are still rendering). Cross-tenant callers get 404: the picture's file row is only visible inside the organization it was uploaded in (RLS).
+     *
+     * @param {NizamOperatorRuntime.GetUserProfilePictureRequest} request
+     * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.NotFoundError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.users.getUserProfilePicture({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    getUserProfilePicture(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getUserProfilePicture(request, requestOptions));
+    }
+    async __getUserProfilePicture(request, requestOptions) {
+        const { id, size } = request;
+        const _queryParams = {
+            size,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamOperatorRuntimeEnvironment.Production, `v1/users/${core.url.encodePathParam(id)}/profile-picture`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: undefined, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new NizamOperatorRuntime.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamOperatorRuntime.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamOperatorRuntime.NotFoundError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamOperatorRuntime.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamOperatorRuntime.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamOperatorRuntimeError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/users/{id}/profile-picture");
+    }
 }
 exports.UsersClient = UsersClient;

package/dist/api/resources/users/client/index.d.ts

@@ -1 +1 @@
-export {};
+export * from "./requests/index.js";

package/dist/api/resources/users/client/index.js

@@ -1,2 +1,17 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./requests/index.js"), exports);

package/dist/api/resources/users/client/requests/GetUserProfilePictureRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @example
+ *     {
+ *         id: "00000000-0000-0000-0000-000000000000"
+ *     }
+ */
+export interface GetUserProfilePictureRequest {
+    id: string;
+    /** Desired bounding-box size in px (rendered variants: 256/128/64). */
+    size?: number;
+}

package/dist/api/resources/users/client/requests/GetUserProfilePictureRequest.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/api/resources/users/client/requests/InitiateProfilePictureUploadRequest.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @example
+ *     {
+ *         filename: "avatar.png",
+ *         content_type: "image/png",
+ *         size_bytes: 204857,
+ *         checksum_sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
+ *     }
+ */
+export interface InitiateProfilePictureUploadRequest {
+    /** Original filename. */
+    filename: string;
+    /** Declared MIME type — profile pictures accept image/jpeg, image/png, image/webp; re-verified server-side at completion. */
+    content_type: string;
+    /** Exact byte size; verified against storage at completion. */
+    size_bytes?: number;
+    /** Client-computed SHA-256 of the content, lowercase hex; re-verified server-side by the pipeline. */
+    checksum_sha256: string;
+}