@nizam-os/carrier-sdk 2.5.2 → 2.6.0

package/dist/api/resources/files/client/requests/CreateFileDownloadUrlRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         id: "00000000-0000-0000-0000-000000000000"
+ *     }
+ */
+export interface CreateFileDownloadUrlRequest {
+    id: string;
+}

package/dist/api/resources/files/client/requests/CreateFileDownloadUrlRequest.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/files/client/requests/DeleteFileRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         id: "00000000-0000-0000-0000-000000000000"
+ *     }
+ */
+export interface DeleteFileRequest {
+    id: string;
+}

package/dist/api/resources/files/client/requests/DeleteFileRequest.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/files/client/requests/GetFileRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         id: "00000000-0000-0000-0000-000000000000"
+ *     }
+ */
+export interface GetFileRequest {
+    id: string;
+}

package/dist/api/resources/files/client/requests/GetFileRequest.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/files/client/requests/InitiateFileUploadRequest.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @example
+ *     {
+ *         kind: "profile_picture",
+ *         subject_type: "task_attempt",
+ *         subject_id: "b3c4d5e6-7f8a-9b0c-1d2e-3f4a5b6c7d8e",
+ *         filename: "pod-photo.jpg",
+ *         content_type: "image/jpeg",
+ *         size_bytes: 2048576,
+ *         checksum_sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
+ *     }
+ */
+export interface InitiateFileUploadRequest {
+    /** What the bytes are for the platform — fixes the policy applied to them. */
+    kind: InitiateFileUploadRequest.Kind;
+    /** Type of the business entity this file documents (optional at upload time; can also be attached later). */
+    subject_type?: string;
+    /** Id of the business entity this file documents. Requires subject_type. */
+    subject_id?: string;
+    /** Original filename; served back via Content-Disposition on download. */
+    filename: string;
+    /** Declared MIME type. Must be on the kind's allow-list; re-verified by server-side detection at completion. */
+    content_type: string;
+    /** Exact byte size of the file. Verified against storage at completion. */
+    size_bytes?: number;
+    /** SHA-256 of the content as 64 lowercase hex characters (compute with crypto.subtle.digest). Re-verified server-side by the scan pipeline. */
+    checksum_sha256: string;
+}
+export declare namespace InitiateFileUploadRequest {
+    /** What the bytes are for the platform — fixes the policy applied to them. */
+    const Kind: {
+        readonly ProfilePicture: "profile_picture";
+        readonly ChatAttachment: "chat_attachment";
+        readonly TaskPodPhoto: "task_pod_photo";
+        readonly ImportSource: "import_source";
+        readonly ImportReport: "import_report";
+        readonly SignedDocument: "signed_document";
+        readonly ProductImage: "product_image";
+    };
+    type Kind = (typeof Kind)[keyof typeof Kind];
+}

package/dist/api/resources/files/client/requests/InitiateFileUploadRequest.js

@@ -0,0 +1,17 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InitiateFileUploadRequest = void 0;
+var InitiateFileUploadRequest;
+(function (InitiateFileUploadRequest) {
+    /** What the bytes are for the platform — fixes the policy applied to them. */
+    InitiateFileUploadRequest.Kind = {
+        ProfilePicture: "profile_picture",
+        ChatAttachment: "chat_attachment",
+        TaskPodPhoto: "task_pod_photo",
+        ImportSource: "import_source",
+        ImportReport: "import_report",
+        SignedDocument: "signed_document",
+        ProductImage: "product_image",
+    };
+})(InitiateFileUploadRequest || (exports.InitiateFileUploadRequest = InitiateFileUploadRequest = {}));

package/dist/api/resources/files/client/requests/ListFilesRequest.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @example
+ *     {
+ *         subject_type: "<string>",
+ *         subject_id: "00000000-0000-0000-0000-000000000000",
+ *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+ *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+ *     }
+ */
+export interface ListFilesRequest {
+    /** Filter by file kind. Comma-separated; values: `profile_picture`, `chat_attachment`, `task_pod_photo`, `import_source`, `import_report`, `signed_document`, `product_image`. */
+    kind?: string | string[];
+    /** Filter by lifecycle status. Comma-separated; values: `active`, `quarantined`, `deleted`. */
+    status?: string | string[];
+    /** Filter by the documented entity's type (pairs with `subject_id`). */
+    subject_type?: string;
+    /** Filter by the documented entity's id (requires `subject_type`). */
+    subject_id?: string;
+    /** Sort order. Allowed fields: `created_at`. Prefix a field with `-` for descending (e.g. `-created_at`); unknown fields are rejected with `400 validation_failed`. */
+    sort?: string | 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/files/client/requests/ListFilesRequest.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/files/client/requests/ResumeFileUploadRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         id: "00000000-0000-0000-0000-000000000000"
+ *     }
+ */
+export interface ResumeFileUploadRequest {
+    id: string;
+}

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

@@ -0,0 +1,8 @@
+export type { CancelFileUploadRequest } from "./CancelFileUploadRequest.js";
+export type { CompleteFileUploadRequest } from "./CompleteFileUploadRequest.js";
+export type { CreateFileDownloadUrlRequest } from "./CreateFileDownloadUrlRequest.js";
+export type { DeleteFileRequest } from "./DeleteFileRequest.js";
+export type { GetFileRequest } from "./GetFileRequest.js";
+export { InitiateFileUploadRequest } from "./InitiateFileUploadRequest.js";
+export type { ListFilesRequest } from "./ListFilesRequest.js";
+export type { ResumeFileUploadRequest } from "./ResumeFileUploadRequest.js";

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

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

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

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

package/dist/api/resources/files/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.FilesClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "FilesClient", { enumerable: true, get: function () { return Client_js_1.FilesClient; } });
+__exportStar(require("./client/index.js"), exports);

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

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

package/dist/api/resources/files/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/index.d.ts

@@ -1,5 +1,10 @@
+export * from "./files/client/requests/index.js";
+export * as files from "./files/index.js";
 export * from "./invites/client/requests/index.js";
 export * as invites from "./invites/index.js";
 export * as lookups from "./lookups/index.js";
 export * as realtime from "./realtime/index.js";
+export * from "./taskAttempts/client/requests/index.js";
+export * as taskAttempts from "./taskAttempts/index.js";
+export * from "./users/client/requests/index.js";
 export * as users from "./users/index.js";

package/dist/api/resources/index.js

@@ -36,9 +36,14 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.users = exports.realtime = exports.lookups = exports.invites = void 0;
+exports.users = exports.taskAttempts = exports.realtime = exports.lookups = exports.invites = exports.files = void 0;
+__exportStar(require("./files/client/requests/index.js"), exports);
+exports.files = __importStar(require("./files/index.js"));
 __exportStar(require("./invites/client/requests/index.js"), exports);
 exports.invites = __importStar(require("./invites/index.js"));
 exports.lookups = __importStar(require("./lookups/index.js"));
 exports.realtime = __importStar(require("./realtime/index.js"));
+__exportStar(require("./taskAttempts/client/requests/index.js"), exports);
+exports.taskAttempts = __importStar(require("./taskAttempts/index.js"));
+__exportStar(require("./users/client/requests/index.js"), exports);
 exports.users = __importStar(require("./users/index.js"));

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

@@ -0,0 +1,65 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as NizamCarrier from "../../../index.js";
+export declare namespace TaskAttemptsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class TaskAttemptsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<TaskAttemptsClient.Options>;
+    constructor(options: TaskAttemptsClient.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 {NizamCarrier.ListTaskAttemptPhotosRequest} request
+     * @param {TaskAttemptsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.BadRequestError}
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.taskAttempts.listTaskAttemptPhotos({
+     *         attemptId: "00000000-0000-0000-0000-000000000000",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listTaskAttemptPhotos(request: NizamCarrier.ListTaskAttemptPhotosRequest, requestOptions?: TaskAttemptsClient.RequestOptions): core.HttpResponsePromise<NizamCarrier.TaskAttemptPhoto>;
+    private __listTaskAttemptPhotos;
+    /**
+     * 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 {NizamCarrier.CaptureTaskAttemptPhotoRequest} request
+     * @param {TaskAttemptsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.BadRequestError}
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.ContentTooLargeError}
+     * @throws {@link NizamCarrier.UnprocessableEntityError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.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: NizamCarrier.CaptureTaskAttemptPhotoRequest, requestOptions?: TaskAttemptsClient.RequestOptions): core.HttpResponsePromise<NizamCarrier.UploadInitiation>;
+    private __captureTaskAttemptPhoto;
+}

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

@@ -0,0 +1,208 @@
+"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 NizamCarrier = __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 {NizamCarrier.ListTaskAttemptPhotosRequest} request
+     * @param {TaskAttemptsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.BadRequestError}
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.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.NizamCarrierEnvironment.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 NizamCarrier.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new NizamCarrier.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamCarrier.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamCarrier.NotFoundError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamCarrier.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamCarrier.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamCarrierError({
+                        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 {NizamCarrier.CaptureTaskAttemptPhotoRequest} request
+     * @param {TaskAttemptsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.BadRequestError}
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.ContentTooLargeError}
+     * @throws {@link NizamCarrier.UnprocessableEntityError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.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.NizamCarrierEnvironment.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 NizamCarrier.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new NizamCarrier.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamCarrier.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamCarrier.NotFoundError(_response.error.body, _response.rawResponse);
+                case 413:
+                    throw new NizamCarrier.ContentTooLargeError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new NizamCarrier.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamCarrier.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamCarrier.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamCarrierError({
+                        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 });