@nizam-os/dashboard-sdk 6.4.0 → 7.0.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

@@ -6,6 +6,8 @@ export * from "./assets/client/requests/index.js";
 export * as assets from "./assets/index.js";
 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 "./invites/client/requests/index.js";
 export * as invites from "./invites/index.js";
 export * from "./jobs/client/requests/index.js";
@@ -17,6 +19,10 @@ export * from "./operators/client/requests/index.js";
 export * as operators from "./operators/index.js";
 export * from "./organizations/client/requests/index.js";
 export * as organizations from "./organizations/index.js";
+export * from "./positions/client/requests/index.js";
+export * as positions from "./positions/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,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.users = exports.realtime = exports.organizations = exports.operators = exports.memberships = exports.lookups = exports.jobs = exports.invites = 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.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);
@@ -45,6 +45,8 @@ __exportStar(require("./assets/client/requests/index.js"), exports);
 exports.assets = __importStar(require("./assets/index.js"));
 __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("./invites/client/requests/index.js"), exports);
 exports.invites = __importStar(require("./invites/index.js"));
 __exportStar(require("./jobs/client/requests/index.js"), exports);
@@ -56,6 +58,10 @@ __exportStar(require("./operators/client/requests/index.js"), exports);
 exports.operators = __importStar(require("./operators/index.js"));
 __exportStar(require("./organizations/client/requests/index.js"), exports);
 exports.organizations = __importStar(require("./organizations/index.js"));
+__exportStar(require("./positions/client/requests/index.js"), exports);
+exports.positions = __importStar(require("./positions/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/positions/client/Client.d.ts

@@ -0,0 +1,73 @@
+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 PositionsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class PositionsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<PositionsClient.Options>;
+    constructor(options: PositionsClient.Options);
+    /**
+     * Keyset-paginated track over a required [start, end) device-time window (max 31 days — the window drives partition pruning). Optionally narrowed to one operator.
+     *
+     * @param {NizamDashboard.ListPositionsRequest} request
+     * @param {PositionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.positions.listPositions({
+     *         operator_id: "00000000-0000-0000-0000-000000000000",
+     *         start: "2026-05-20T14:00:00Z",
+     *         end: "2026-05-20T14:00:00Z",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listPositions(request: NizamDashboard.ListPositionsRequest, requestOptions?: PositionsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ListResponsePosition>;
+    private __listPositions;
+    /**
+     * Live snapshot for initial map load and STOMP-reconnect reconciliation. Served from the Redis hot cache (positions fresher than ~60s); a cold cache falls back to the most recent recorded position per operator over the last 15 minutes. Unpaginated by design: the result is bounded by the fleet's currently-reporting operators.
+     *
+     * @param {PositionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.positions.listCurrentPositions()
+     */
+    listCurrentPositions(requestOptions?: PositionsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ListResponseOperatorPosition>;
+    private __listCurrentPositions;
+    /**
+     * Counts recorded positions per H3 hex cell (resolution 9 ≈ 150 m or 11 ≈ 24 m) inside a `bbox` viewport over a device-time window (default: the last 24 hours). Cells are returned as hex strings — H3 indexes exceed the JavaScript safe-integer range. Unpaginated: bounded by the viewport's cell cover (max 4096 cells).
+     *
+     * @param {NizamDashboard.GetPositionsHeatmapRequest} request
+     * @param {PositionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.positions.getPositionsHeatmap({
+     *         bbox: "<string>",
+     *         start: "2026-05-20T14:00:00Z",
+     *         end: "2026-05-20T14:00:00Z"
+     *     })
+     */
+    getPositionsHeatmap(request: NizamDashboard.GetPositionsHeatmapRequest, requestOptions?: PositionsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ListResponseHeatmapCell>;
+    private __getPositionsHeatmap;
+}

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

@@ -0,0 +1,266 @@
+"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.PositionsClient = 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 PositionsClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Keyset-paginated track over a required [start, end) device-time window (max 31 days — the window drives partition pruning). Optionally narrowed to one operator.
+     *
+     * @param {NizamDashboard.ListPositionsRequest} request
+     * @param {PositionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.positions.listPositions({
+     *         operator_id: "00000000-0000-0000-0000-000000000000",
+     *         start: "2026-05-20T14:00:00Z",
+     *         end: "2026-05-20T14:00:00Z",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listPositions(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listPositions(request, requestOptions));
+    }
+    async __listPositions(request, requestOptions) {
+        const { operator_id: operatorId, start, end, limit, starting_after: startingAfter, ending_before: endingBefore, } = request;
+        const _queryParams = {
+            operator_id: operatorId,
+            start,
+            end,
+            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/fleet/positions"),
+            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 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 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/fleet/positions");
+    }
+    /**
+     * Live snapshot for initial map load and STOMP-reconnect reconciliation. Served from the Redis hot cache (positions fresher than ~60s); a cold cache falls back to the most recent recorded position per operator over the last 15 minutes. Unpaginated by design: the result is bounded by the fleet's currently-reporting operators.
+     *
+     * @param {PositionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.positions.listCurrentPositions()
+     */
+    listCurrentPositions(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listCurrentPositions(requestOptions));
+    }
+    async __listCurrentPositions(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/fleet/positions/current"),
+            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 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 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/fleet/positions/current");
+    }
+    /**
+     * Counts recorded positions per H3 hex cell (resolution 9 ≈ 150 m or 11 ≈ 24 m) inside a `bbox` viewport over a device-time window (default: the last 24 hours). Cells are returned as hex strings — H3 indexes exceed the JavaScript safe-integer range. Unpaginated: bounded by the viewport's cell cover (max 4096 cells).
+     *
+     * @param {NizamDashboard.GetPositionsHeatmapRequest} request
+     * @param {PositionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.positions.getPositionsHeatmap({
+     *         bbox: "<string>",
+     *         start: "2026-05-20T14:00:00Z",
+     *         end: "2026-05-20T14:00:00Z"
+     *     })
+     */
+    getPositionsHeatmap(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getPositionsHeatmap(request, requestOptions));
+    }
+    async __getPositionsHeatmap(request, requestOptions) {
+        const { h3_res: h3Res, bbox, start, end } = request;
+        const _queryParams = {
+            h3_res: h3Res,
+            bbox,
+            start: start != null ? start : undefined,
+            end: end != null ? end : undefined,
+        };
+        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/fleet/positions/heatmap"),
+            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 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 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/fleet/positions/heatmap");
+    }
+}
+exports.PositionsClient = PositionsClient;

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * @example
+ *     {
+ *         bbox: "<string>",
+ *         start: "2026-05-20T14:00:00Z",
+ *         end: "2026-05-20T14:00:00Z"
+ *     }
+ */
+export interface GetPositionsHeatmapRequest {
+    h3_res?: number;
+    bbox: string;
+    start?: string;
+    end?: string;
+}