@nizam-os/carrier-sdk 2.5.3 → 2.6.0

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

@@ -0,0 +1,608 @@
+"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.FilesClient = 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 FilesClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * The active organization's files ordered by `created_at` descending (pass `sort=created_at` for ascending). `kind` / `status` accept comma-separated values; `subject_type` + `subject_id` narrow to the files documenting one business entity. Pagination is bidirectional (`starting_after` / `ending_before`).
+     *
+     * @param {NizamCarrier.ListFilesRequest} request
+     * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.BadRequestError}
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.files.listFiles({
+     *         subject_type: "<string>",
+     *         subject_id: "00000000-0000-0000-0000-000000000000",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listFiles(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listFiles(request, requestOptions));
+    }
+    async __listFiles(request = {}, requestOptions) {
+        const { kind, status, subject_type: subjectType, subject_id: subjectId, sort, limit, starting_after: startingAfter, ending_before: endingBefore, } = request;
+        const _queryParams = {
+            kind,
+            status,
+            subject_type: subjectType,
+            subject_id: subjectId,
+            sort,
+            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/files"),
+            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 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/files");
+    }
+    /**
+     * Validates the declaration against the kind's policy (allowed portals, content types, size ceiling, organization quota), pre-reserves the final file id, and returns presigned part URLs. PUT each part's bytes directly to its URL (repeating the part's `headers` verbatim) and keep each response's `ETag` for completion. Sessions expire after 24h; the part URLs sooner — re-issue them via the resume endpoint.
+     *
+     * @param {NizamCarrier.InitiateFileUploadRequest} request
+     * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.BadRequestError}
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.ContentTooLargeError}
+     * @throws {@link NizamCarrier.UnprocessableEntityError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.files.initiateFileUpload({
+     *         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"
+     *     })
+     */
+    initiateFileUpload(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__initiateFileUpload(request, requestOptions));
+    }
+    async __initiateFileUpload(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.NizamCarrierEnvironment.Production, "v1/files/uploads"),
+            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 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 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/files/uploads");
+    }
+    /**
+     * Returns the session state — which parts are already confirmed — plus fresh presigned URLs for the parts still missing. The IndexedDB-persisted ETags from before the interruption stay valid; only re-upload the missing parts. Uploader-only: other members' sessions read as 404.
+     *
+     * @param {NizamCarrier.ResumeFileUploadRequest} request
+     * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.ConflictError}
+     * @throws {@link NizamCarrier.GoneError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.files.resumeFileUpload({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    resumeFileUpload(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__resumeFileUpload(request, requestOptions));
+    }
+    async __resumeFileUpload(request, requestOptions) {
+        const { id } = 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/files/uploads/${core.url.encodePathParam(id)}`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url.queryBuilder().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 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 409:
+                    throw new NizamCarrier.ConflictError(_response.error.body, _response.rawResponse);
+                case 410:
+                    throw new NizamCarrier.GoneError(_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/files/uploads/{id}");
+    }
+    /**
+     * Aborts the storage-side multipart upload and marks the session aborted. Idempotent: cancelling an already-terminal session is a no-op.
+     *
+     * @param {NizamCarrier.CancelFileUploadRequest} request
+     * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.files.cancelFileUpload({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    cancelFileUpload(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__cancelFileUpload(request, requestOptions));
+    }
+    async __cancelFileUpload(request, requestOptions) {
+        const { id } = 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/files/uploads/${core.url.encodePathParam(id)}`),
+            method: "DELETE",
+            headers: _headers,
+            queryString: core.url.queryBuilder().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 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, "DELETE", "/v1/files/uploads/{id}");
+    }
+    /**
+     * Assembles the file from the reported part ETags, verifies the declared size against storage, detects the real content type from the bytes, creates the file record under the pre-reserved id and enqueues the malware-scan / thumbnail pipeline. Scanned kinds stay undownloadable until the verdict lands (`virus_scan_status: clean`).
+     *
+     * @param {NizamCarrier.CompleteFileUploadRequest} request
+     * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.BadRequestError}
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.ConflictError}
+     * @throws {@link NizamCarrier.GoneError}
+     * @throws {@link NizamCarrier.UnprocessableEntityError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.files.completeFileUpload({
+     *         id: "00000000-0000-0000-0000-000000000000",
+     *         parts: [{
+     *                 part_number: 1,
+     *                 etag: "9bb58f26192e4ba00f01e2e7b136bbd8"
+     *             }]
+     *     })
+     */
+    completeFileUpload(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__completeFileUpload(request, requestOptions));
+    }
+    async __completeFileUpload(request, requestOptions) {
+        const { id, ..._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/files/uploads/${core.url.encodePathParam(id)}/complete`),
+            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 409:
+                    throw new NizamCarrier.ConflictError(_response.error.body, _response.rawResponse);
+                case 410:
+                    throw new NizamCarrier.GoneError(_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/files/uploads/{id}/complete");
+    }
+    /**
+     * Single file view: kind, integrity, lifecycle, scan verdict, subject. Org-scoped: any member of the owning organization can read it. Bytes are served only through the download-url endpoint.
+     *
+     * @param {NizamCarrier.GetFileRequest} request
+     * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.files.getFile({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    getFile(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getFile(request, requestOptions));
+    }
+    async __getFile(request, requestOptions) {
+        const { id } = 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/files/${core.url.encodePathParam(id)}`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url.queryBuilder().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 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/files/{id}");
+    }
+    /**
+     * Soft-deletes the file: it disappears from listings immediately; the bytes are purged later by the lifecycle sweep once the grace period passes. Refused while a regulatory retention hold is in force (409).
+     *
+     * @param {NizamCarrier.DeleteFileRequest} request
+     * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.ConflictError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.files.deleteFile({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    deleteFile(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deleteFile(request, requestOptions));
+    }
+    async __deleteFile(request, requestOptions) {
+        const { id } = 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/files/${core.url.encodePathParam(id)}`),
+            method: "DELETE",
+            headers: _headers,
+            queryString: core.url.queryBuilder().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 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 409:
+                    throw new NizamCarrier.ConflictError(_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, "DELETE", "/v1/files/{id}");
+    }
+    /**
+     * Authorizes the caller (org membership + the kind's portal allow-list + the scan verdict) and issues a short-lived URL for the bytes — presigned storage, or a signed CDN URL for public kinds when the CDN is enabled. Sensitive kinds append an access-audit row in the same transaction; POST because issuing a grant is an audited action, not a cacheable read.
+     *
+     * @param {NizamCarrier.CreateFileDownloadUrlRequest} request
+     * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamCarrier.UnauthorizedError}
+     * @throws {@link NizamCarrier.ForbiddenError}
+     * @throws {@link NizamCarrier.NotFoundError}
+     * @throws {@link NizamCarrier.ConflictError}
+     * @throws {@link NizamCarrier.TooManyRequestsError}
+     * @throws {@link NizamCarrier.InternalServerError}
+     *
+     * @example
+     *     await client.files.createFileDownloadUrl({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    createFileDownloadUrl(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createFileDownloadUrl(request, requestOptions));
+    }
+    async __createFileDownloadUrl(request, requestOptions) {
+        const { id } = 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/files/${core.url.encodePathParam(id)}/download-url`),
+            method: "POST",
+            headers: _headers,
+            queryString: core.url.queryBuilder().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 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 409:
+                    throw new NizamCarrier.ConflictError(_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/files/{id}/download-url");
+    }
+}
+exports.FilesClient = FilesClient;

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

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

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

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

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

@@ -0,0 +1,15 @@
+import type * as NizamCarrier from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         id: "00000000-0000-0000-0000-000000000000",
+ *         parts: [{
+ *                 part_number: 1,
+ *                 etag: "9bb58f26192e4ba00f01e2e7b136bbd8"
+ *             }]
+ *     }
+ */
+export interface CompleteFileUploadRequest {
+    id: string;
+    parts: NizamCarrier.FileUploadPartReport[];
+}

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

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