@nizam-os/dashboard-sdk 7.1.1 → 8.0.0

package/dist/Client.d.ts

@@ -3,6 +3,7 @@ import { ActivityClient } from "./api/resources/activity/client/Client.js";
 import { AssetsClient } from "./api/resources/assets/client/Client.js";
 import { AssignmentsClient } from "./api/resources/assignments/client/Client.js";
 import { FilesClient } from "./api/resources/files/client/Client.js";
+import { ImportsClient } from "./api/resources/imports/client/Client.js";
 import { InvitesClient } from "./api/resources/invites/client/Client.js";
 import { JobsClient } from "./api/resources/jobs/client/Client.js";
 import { LookupsClient } from "./api/resources/lookups/client/Client.js";
@@ -28,6 +29,7 @@ export declare class NizamDashboardClient {
     protected _assignments: AssignmentsClient | undefined;
     protected _files: FilesClient | undefined;
     protected _positions: PositionsClient | undefined;
+    protected _imports: ImportsClient | undefined;
     protected _invites: InvitesClient | undefined;
     protected _jobs: JobsClient | undefined;
     protected _lookups: LookupsClient | undefined;
@@ -44,6 +46,7 @@ export declare class NizamDashboardClient {
     get assignments(): AssignmentsClient;
     get files(): FilesClient;
     get positions(): PositionsClient;
+    get imports(): ImportsClient;
     get invites(): InvitesClient;
     get jobs(): JobsClient;
     get lookups(): LookupsClient;

package/dist/Client.js

@@ -40,16 +40,17 @@ const Client_js_2 = require("./api/resources/activity/client/Client.js");
 const Client_js_3 = require("./api/resources/assets/client/Client.js");
 const Client_js_4 = require("./api/resources/assignments/client/Client.js");
 const Client_js_5 = require("./api/resources/files/client/Client.js");
-const Client_js_6 = require("./api/resources/invites/client/Client.js");
-const Client_js_7 = require("./api/resources/jobs/client/Client.js");
-const Client_js_8 = require("./api/resources/lookups/client/Client.js");
-const Client_js_9 = require("./api/resources/memberships/client/Client.js");
-const Client_js_10 = require("./api/resources/operators/client/Client.js");
-const Client_js_11 = require("./api/resources/organizations/client/Client.js");
-const Client_js_12 = require("./api/resources/positions/client/Client.js");
-const Client_js_13 = require("./api/resources/realtime/client/Client.js");
-const Client_js_14 = require("./api/resources/taskAttempts/client/Client.js");
-const Client_js_15 = require("./api/resources/users/client/Client.js");
+const Client_js_6 = require("./api/resources/imports/client/Client.js");
+const Client_js_7 = require("./api/resources/invites/client/Client.js");
+const Client_js_8 = require("./api/resources/jobs/client/Client.js");
+const Client_js_9 = require("./api/resources/lookups/client/Client.js");
+const Client_js_10 = require("./api/resources/memberships/client/Client.js");
+const Client_js_11 = require("./api/resources/operators/client/Client.js");
+const Client_js_12 = require("./api/resources/organizations/client/Client.js");
+const Client_js_13 = require("./api/resources/positions/client/Client.js");
+const Client_js_14 = require("./api/resources/realtime/client/Client.js");
+const Client_js_15 = require("./api/resources/taskAttempts/client/Client.js");
+const Client_js_16 = require("./api/resources/users/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class NizamDashboardClient {
@@ -69,37 +70,40 @@ class NizamDashboardClient {
         return (this._files ?? (this._files = new Client_js_5.FilesClient(this._options)));
     }
     get positions() {
-        return (this._positions ?? (this._positions = new Client_js_12.PositionsClient(this._options)));
+        return (this._positions ?? (this._positions = new Client_js_13.PositionsClient(this._options)));
+    }
+    get imports() {
+        return (this._imports ?? (this._imports = new Client_js_6.ImportsClient(this._options)));
     }
     get invites() {
-        return (this._invites ?? (this._invites = new Client_js_6.InvitesClient(this._options)));
+        return (this._invites ?? (this._invites = new Client_js_7.InvitesClient(this._options)));
     }
     get jobs() {
-        return (this._jobs ?? (this._jobs = new Client_js_7.JobsClient(this._options)));
+        return (this._jobs ?? (this._jobs = new Client_js_8.JobsClient(this._options)));
     }
     get lookups() {
-        return (this._lookups ?? (this._lookups = new Client_js_8.LookupsClient(this._options)));
+        return (this._lookups ?? (this._lookups = new Client_js_9.LookupsClient(this._options)));
     }
     get users() {
-        return (this._users ?? (this._users = new Client_js_15.UsersClient(this._options)));
+        return (this._users ?? (this._users = new Client_js_16.UsersClient(this._options)));
     }
     get activeOrganization() {
         return (this._activeOrganization ?? (this._activeOrganization = new Client_js_1.ActiveOrganizationClient(this._options)));
     }
     get memberships() {
-        return (this._memberships ?? (this._memberships = new Client_js_9.MembershipsClient(this._options)));
+        return (this._memberships ?? (this._memberships = new Client_js_10.MembershipsClient(this._options)));
     }
     get operators() {
-        return (this._operators ?? (this._operators = new Client_js_10.OperatorsClient(this._options)));
+        return (this._operators ?? (this._operators = new Client_js_11.OperatorsClient(this._options)));
     }
     get organizations() {
-        return (this._organizations ?? (this._organizations = new Client_js_11.OrganizationsClient(this._options)));
+        return (this._organizations ?? (this._organizations = new Client_js_12.OrganizationsClient(this._options)));
     }
     get realtime() {
-        return (this._realtime ?? (this._realtime = new Client_js_13.RealtimeClient(this._options)));
+        return (this._realtime ?? (this._realtime = new Client_js_14.RealtimeClient(this._options)));
     }
     get taskAttempts() {
-        return (this._taskAttempts ?? (this._taskAttempts = new Client_js_14.TaskAttemptsClient(this._options)));
+        return (this._taskAttempts ?? (this._taskAttempts = new Client_js_15.TaskAttemptsClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

package/dist/api/errors/BadRequestError.js

@@ -48,7 +48,7 @@ class BadRequestError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "BadRequestError";
     }
 }
 exports.BadRequestError = BadRequestError;

package/dist/api/errors/ConflictError.js

@@ -48,7 +48,7 @@ class ConflictError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "ConflictError";
     }
 }
 exports.ConflictError = ConflictError;

package/dist/api/errors/ContentTooLargeError.js

@@ -48,7 +48,7 @@ class ContentTooLargeError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "ContentTooLargeError";
     }
 }
 exports.ContentTooLargeError = ContentTooLargeError;

package/dist/api/errors/ForbiddenError.js

@@ -48,7 +48,7 @@ class ForbiddenError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "ForbiddenError";
     }
 }
 exports.ForbiddenError = ForbiddenError;

package/dist/api/errors/GoneError.js

@@ -48,7 +48,7 @@ class GoneError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "GoneError";
     }
 }
 exports.GoneError = GoneError;

package/dist/api/errors/InternalServerError.js

@@ -48,7 +48,7 @@ class InternalServerError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "InternalServerError";
     }
 }
 exports.InternalServerError = InternalServerError;

package/dist/api/errors/NotFoundError.js

@@ -48,7 +48,7 @@ class NotFoundError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "NotFoundError";
     }
 }
 exports.NotFoundError = NotFoundError;

package/dist/api/errors/TooManyRequestsError.js

@@ -48,7 +48,7 @@ class TooManyRequestsError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "TooManyRequestsError";
     }
 }
 exports.TooManyRequestsError = TooManyRequestsError;

package/dist/api/errors/UnauthorizedError.js

@@ -48,7 +48,7 @@ class UnauthorizedError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "UnauthorizedError";
     }
 }
 exports.UnauthorizedError = UnauthorizedError;

package/dist/api/errors/UnprocessableEntityError.js

@@ -48,7 +48,7 @@ class UnprocessableEntityError extends errors.NizamDashboardError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "UnprocessableEntityError";
     }
 }
 exports.UnprocessableEntityError = UnprocessableEntityError;

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

@@ -75,6 +75,16 @@ export declare class AssetsClient {
      */
     createAsset(request: NizamDashboard.CreateAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
     private __createAsset;
+    /**
+     * Returns a correctly-shaped XLSX template (header row + one example row) for the bulk asset import. Fill it in and upload it via POST /v1/imports to import assets in bulk.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     */
+    getAssetImportTemplate(requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __getAssetImportTemplate;
     /**
      * @param {NizamDashboard.GetAssetRequest} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -218,6 +218,57 @@ class AssetsClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/assets");
     }
+    /**
+     * Returns a correctly-shaped XLSX template (header row + one example row) for the bulk asset import. Fill it in and upload it via POST /v1/imports to import assets in bulk.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     */
+    getAssetImportTemplate(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getAssetImportTemplate(requestOptions));
+    }
+    async __getAssetImportTemplate(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.NizamDashboardEnvironment.Production, "v1/assets/imports/template"),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            responseType: "binary-response",
+            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 NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamDashboard.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/assets/imports/template");
+    }
     /**
      * @param {NizamDashboard.GetAssetRequest} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -0,0 +1,79 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as NizamDashboard from "../../../index.js";
+export declare namespace ImportsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class ImportsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<ImportsClient.Options>;
+    constructor(options: ImportsClient.Options);
+    /**
+     * Creates a PENDING import job and a presigned upload session for the source file. Upload the file's bytes directly to the returned session, then complete it — the import starts automatically once the file is scanned and ready. Returns 202 with the job handle (poll/cancel via `GET`/`POST /v1/jobs/{id}`), the reserved file id, and the upload session. Rate-limited per organization; rejected with 429 + `Retry-After` when the hourly budget or the concurrent-imports cap is hit.
+     *
+     * @param {NizamDashboard.CreateImportRequest} request
+     * @param {ImportsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.ContentTooLargeError}
+     * @throws {@link NizamDashboard.UnprocessableEntityError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.imports.createImport({
+     *         kind: "import_fleet_assets_xlsx",
+     *         filename: "fleet-assets.xlsx",
+     *         content_type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+     *         size_bytes: 524288,
+     *         checksum_sha256: "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+     *     })
+     */
+    createImport(request: NizamDashboard.CreateImportRequest, requestOptions?: ImportsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ImportSubmission>;
+    private __createImport;
+    /**
+     * The validation errors accumulated for one import, in (row_number, id) ascending order — the natural reading order of the source file. Keyset-paginated (`starting_after` / `ending_before`); no sort parameter. Org-scoped (RLS).
+     *
+     * @param {NizamDashboard.ListImportErrorsRequest} request
+     * @param {ImportsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.NotFoundError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.imports.listImportErrors({
+     *         jobId: "00000000-0000-0000-0000-000000000000",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listImportErrors(request: NizamDashboard.ListImportErrorsRequest, requestOptions?: ImportsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ImportError>;
+    private __listImportErrors;
+    /**
+     * Authorizes the caller (org membership + the import-report kind policy) and issues a short-lived URL for the annotated result report (original columns + an `_errors` column). 409 if the import produced no report (still running, or finished with no errors). POST because issuing a grant is an audited action, not a cacheable read.
+     *
+     * @param {NizamDashboard.CreateImportReportUrlRequest} request
+     * @param {ImportsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.NotFoundError}
+     * @throws {@link NizamDashboard.ConflictError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.imports.createImportReportUrl({
+     *         jobId: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    createImportReportUrl(request: NizamDashboard.CreateImportReportUrlRequest, requestOptions?: ImportsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.FileDownloadUrl>;
+    private __createImportReportUrl;
+}

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

@@ -0,0 +1,262 @@
+"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.ImportsClient = 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 NizamDashboard = __importStar(require("../../../index.js"));
+class ImportsClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Creates a PENDING import job and a presigned upload session for the source file. Upload the file's bytes directly to the returned session, then complete it — the import starts automatically once the file is scanned and ready. Returns 202 with the job handle (poll/cancel via `GET`/`POST /v1/jobs/{id}`), the reserved file id, and the upload session. Rate-limited per organization; rejected with 429 + `Retry-After` when the hourly budget or the concurrent-imports cap is hit.
+     *
+     * @param {NizamDashboard.CreateImportRequest} request
+     * @param {ImportsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.ContentTooLargeError}
+     * @throws {@link NizamDashboard.UnprocessableEntityError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.imports.createImport({
+     *         kind: "import_fleet_assets_xlsx",
+     *         filename: "fleet-assets.xlsx",
+     *         content_type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+     *         size_bytes: 524288,
+     *         checksum_sha256: "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+     *     })
+     */
+    createImport(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createImport(request, requestOptions));
+    }
+    async __createImport(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.NizamDashboardEnvironment.Production, "v1/imports"),
+            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 NizamDashboard.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 413:
+                    throw new NizamDashboard.ContentTooLargeError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new NizamDashboard.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamDashboard.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/imports");
+    }
+    /**
+     * The validation errors accumulated for one import, in (row_number, id) ascending order — the natural reading order of the source file. Keyset-paginated (`starting_after` / `ending_before`); no sort parameter. Org-scoped (RLS).
+     *
+     * @param {NizamDashboard.ListImportErrorsRequest} request
+     * @param {ImportsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.NotFoundError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.imports.listImportErrors({
+     *         jobId: "00000000-0000-0000-0000-000000000000",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listImportErrors(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listImportErrors(request, requestOptions));
+    }
+    async __listImportErrors(request, requestOptions) {
+        const { jobId, 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.NizamDashboardEnvironment.Production, `v1/imports/${core.url.encodePathParam(jobId)}/errors`),
+            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 401:
+                    throw new NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamDashboard.NotFoundError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamDashboard.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/imports/{jobId}/errors");
+    }
+    /**
+     * Authorizes the caller (org membership + the import-report kind policy) and issues a short-lived URL for the annotated result report (original columns + an `_errors` column). 409 if the import produced no report (still running, or finished with no errors). POST because issuing a grant is an audited action, not a cacheable read.
+     *
+     * @param {NizamDashboard.CreateImportReportUrlRequest} request
+     * @param {ImportsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.NotFoundError}
+     * @throws {@link NizamDashboard.ConflictError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.imports.createImportReportUrl({
+     *         jobId: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    createImportReportUrl(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createImportReportUrl(request, requestOptions));
+    }
+    async __createImportReportUrl(request, requestOptions) {
+        const { jobId } = 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.NizamDashboardEnvironment.Production, `v1/imports/${core.url.encodePathParam(jobId)}/report-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 NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamDashboard.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new NizamDashboard.ConflictError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamDashboard.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/imports/{jobId}/report-url");
+    }
+}
+exports.ImportsClient = ImportsClient;

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

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

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

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

package/dist/api/resources/imports/client/requests/CreateImportReportUrlRequest.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/imports/client/requests/CreateImportRequest.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @example
+ *     {
+ *         kind: "import_fleet_assets_xlsx",
+ *         filename: "fleet-assets.xlsx",
+ *         content_type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+ *         size_bytes: 524288,
+ *         checksum_sha256: "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+ *     }
+ */
+export interface CreateImportRequest {
+    /** The import kind to run (lowercase). */
+    kind: string;
+    /** Original filename of the source file. */
+    filename: string;
+    /** Declared MIME type (must be allowed for import sources). */
+    content_type: string;
+    /** Declared byte size of the file. */
+    size_bytes?: number;
+    /** Client-computed SHA-256 of the file, 64 lowercase hex characters. */
+    checksum_sha256?: string;
+}

package/dist/api/resources/imports/client/requests/CreateImportRequest.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/imports/client/requests/ListImportErrorsRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @example
+ *     {
+ *         jobId: "00000000-0000-0000-0000-000000000000",
+ *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+ *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+ *     }
+ */
+export interface ListImportErrorsRequest {
+    jobId: 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/imports/client/requests/ListImportErrorsRequest.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/imports/client/requests/index.d.ts

@@ -0,0 +1,3 @@
+export type { CreateImportReportUrlRequest } from "./CreateImportReportUrlRequest.js";
+export type { CreateImportRequest } from "./CreateImportRequest.js";
+export type { ListImportErrorsRequest } from "./ListImportErrorsRequest.js";

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

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

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

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

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

package/dist/api/resources/imports/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

@@ -8,6 +8,8 @@ export * from "./assignments/client/requests/index.js";
 export * as assignments from "./assignments/index.js";
 export * from "./files/client/requests/index.js";
 export * as files from "./files/index.js";
+export * from "./imports/client/requests/index.js";
+export * as imports from "./imports/index.js";
 export * from "./invites/client/requests/index.js";
 export * as invites from "./invites/index.js";
 export * from "./jobs/client/requests/index.js";

package/dist/api/resources/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.users = exports.taskAttempts = exports.realtime = exports.positions = exports.organizations = exports.operators = exports.memberships = exports.lookups = exports.jobs = exports.invites = exports.files = exports.assignments = exports.assets = exports.activity = exports.activeOrganization = void 0;
+exports.users = exports.taskAttempts = exports.realtime = exports.positions = exports.organizations = exports.operators = exports.memberships = exports.lookups = exports.jobs = exports.invites = exports.imports = exports.files = exports.assignments = exports.assets = exports.activity = exports.activeOrganization = void 0;
 __exportStar(require("./activeOrganization/client/requests/index.js"), exports);
 exports.activeOrganization = __importStar(require("./activeOrganization/index.js"));
 __exportStar(require("./activity/client/requests/index.js"), exports);
@@ -47,6 +47,8 @@ __exportStar(require("./assignments/client/requests/index.js"), exports);
 exports.assignments = __importStar(require("./assignments/index.js"));
 __exportStar(require("./files/client/requests/index.js"), exports);
 exports.files = __importStar(require("./files/index.js"));
+__exportStar(require("./imports/client/requests/index.js"), exports);
+exports.imports = __importStar(require("./imports/index.js"));
 __exportStar(require("./invites/client/requests/index.js"), exports);
 exports.invites = __importStar(require("./invites/index.js"));
 __exportStar(require("./jobs/client/requests/index.js"), exports);

package/dist/api/types/ImportError.d.ts

@@ -0,0 +1,22 @@
+/**
+ * One validation error against one import row: the row number, the offending field (null for a whole-row error), the stable code/message and the raw value.
+ */
+export interface ImportError {
+    /** The 1-based data-row index that failed (header excluded). */
+    row_number?: number | undefined;
+    /** The offending column header, or null for a whole-row error. */
+    field?: string | undefined;
+    /** Stable machine-readable error code. */
+    error_code?: string | undefined;
+    /** Human-readable explanation of the error. */
+    error_message?: string | undefined;
+    /** The raw cell value that failed (truncated), when relevant. */
+    raw_value?: string | undefined;
+    object?: ImportError.Object_ | undefined;
+}
+export declare namespace ImportError {
+    const Object_: {
+        readonly ImportError: "import_error";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/ImportError.js

@@ -0,0 +1,10 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportError = void 0;
+var ImportError;
+(function (ImportError) {
+    ImportError.Object_ = {
+        ImportError: "import_error",
+    };
+})(ImportError || (exports.ImportError = ImportError = {}));

package/dist/api/types/ImportSubmission.d.ts

@@ -0,0 +1,18 @@
+import type * as NizamDashboard from "../index.js";
+/**
+ * Acknowledgement that an import was submitted: the job handle, the reserved source-file id, and the presigned upload session to push the file's bytes through.
+ */
+export interface ImportSubmission {
+    /** The created import job — poll/cancel it via /v1/jobs/{id}. */
+    job_id?: string | undefined;
+    /** The id the uploaded source file will carry. */
+    file_id?: string | undefined;
+    upload?: NizamDashboard.FileUploadSession | undefined;
+    object?: ImportSubmission.Object_ | undefined;
+}
+export declare namespace ImportSubmission {
+    const Object_: {
+        readonly ImportSubmission: "import_submission";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/ImportSubmission.js

@@ -0,0 +1,10 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportSubmission = void 0;
+var ImportSubmission;
+(function (ImportSubmission) {
+    ImportSubmission.Object_ = {
+        ImportSubmission: "import_submission",
+    };
+})(ImportSubmission || (exports.ImportSubmission = ImportSubmission = {}));

package/dist/api/types/Job.d.ts

@@ -12,10 +12,10 @@ export interface Job {
     status?: Job.Status | undefined;
     /** User who submitted the job. Null only if that user was since deleted. */
     requested_by_id?: string | undefined;
-    /** Input handle the job consumes (kind-specific), e.g. an uploaded import file. */
-    source_uri?: string | undefined;
-    /** Artifact produced by a completed job (kind-specific), e.g. a result report. */
-    report_uri?: string | undefined;
+    /** File the job consumes (kind-specific), e.g. an uploaded import file. References a file id; download via the file's own endpoint. */
+    source_file_id?: string | undefined;
+    /** Artifact file produced by the job (kind-specific), e.g. an import's annotated result report. Present on a completed job, or a cancelled one that produced a partial report. */
+    report_file_id?: string | undefined;
     /** Total work items, once the engine has sized the work. Null while unknown. */
     rows_total?: number | undefined;
     /** Work items processed so far (monotonic). */
@@ -49,6 +49,7 @@ export declare namespace Job {
         readonly ServiceAccountApiKeyRegeneration: "service_account_api_key_regeneration";
         readonly FileVirusScan: "file_virus_scan";
         readonly FileThumbnailGeneration: "file_thumbnail_generation";
+        readonly ImportFleetAssetsXlsx: "import_fleet_assets_xlsx";
     };
     type Kind = (typeof Kind)[keyof typeof Kind];
     /** Lifecycle status. Terminal states are `completed`, `failed`, `cancelled`. */

package/dist/api/types/Job.js

@@ -10,6 +10,7 @@ var Job;
         ServiceAccountApiKeyRegeneration: "service_account_api_key_regeneration",
         FileVirusScan: "file_virus_scan",
         FileThumbnailGeneration: "file_thumbnail_generation",
+        ImportFleetAssetsXlsx: "import_fleet_assets_xlsx",
     };
     /** Lifecycle status. Terminal states are `completed`, `failed`, `cancelled`. */
     Job.Status = {

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

@@ -18,6 +18,8 @@ export * from "./FileUploadPart.js";
 export * from "./FileUploadPartReport.js";
 export * from "./FileUploadSession.js";
 export * from "./HeatmapCell.js";
+export * from "./ImportError.js";
+export * from "./ImportSubmission.js";
 export * from "./InternalUserUpdateRequest.js";
 export * from "./Invite.js";
 export * from "./Job.js";

package/dist/api/types/index.js

@@ -34,6 +34,8 @@ __exportStar(require("./FileUploadPart.js"), exports);
 __exportStar(require("./FileUploadPartReport.js"), exports);
 __exportStar(require("./FileUploadSession.js"), exports);
 __exportStar(require("./HeatmapCell.js"), exports);
+__exportStar(require("./ImportError.js"), exports);
+__exportStar(require("./ImportSubmission.js"), exports);
 __exportStar(require("./InternalUserUpdateRequest.js"), exports);
 __exportStar(require("./Invite.js"), exports);
 __exportStar(require("./Job.js"), exports);

package/dist/errors/NizamDashboardError.js

@@ -10,7 +10,7 @@ class NizamDashboardError extends Error {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "NizamDashboardError";
         this.statusCode = statusCode;
         this.body = body;
         this.rawResponse = rawResponse;

package/dist/errors/NizamDashboardTimeoutError.js

@@ -9,7 +9,7 @@ class NizamDashboardTimeoutError extends Error {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "NizamDashboardTimeoutError";
         if (opts?.cause != null) {
             this.cause = opts.cause;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nizam-os/dashboard-sdk",
-  "version": "7.1.1",
+  "version": "8.0.0",
   "description": "Nizam Dashboard API SDK for TypeScript / JavaScript.",
   "license": "MIT",
   "private": false,