@nizam-os/dashboard-sdk 6.4.0 → 6.5.0

package/dist/Client.d.ts

@@ -8,6 +8,7 @@ import { LookupsClient } from "./api/resources/lookups/client/Client.js";
 import { MembershipsClient } from "./api/resources/memberships/client/Client.js";
 import { OperatorsClient } from "./api/resources/operators/client/Client.js";
 import { OrganizationsClient } from "./api/resources/organizations/client/Client.js";
+import { PositionsClient } from "./api/resources/positions/client/Client.js";
 import { RealtimeClient } from "./api/resources/realtime/client/Client.js";
 import { UsersClient } from "./api/resources/users/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
@@ -23,6 +24,7 @@ export declare class NizamDashboardClient {
     protected _activity: ActivityClient | undefined;
     protected _assets: AssetsClient | undefined;
     protected _assignments: AssignmentsClient | undefined;
+    protected _positions: PositionsClient | undefined;
     protected _invites: InvitesClient | undefined;
     protected _jobs: JobsClient | undefined;
     protected _lookups: LookupsClient | undefined;
@@ -36,6 +38,7 @@ export declare class NizamDashboardClient {
     get activity(): ActivityClient;
     get assets(): AssetsClient;
     get assignments(): AssignmentsClient;
+    get positions(): PositionsClient;
     get invites(): InvitesClient;
     get jobs(): JobsClient;
     get lookups(): LookupsClient;

package/dist/Client.js

@@ -45,8 +45,9 @@ const Client_js_7 = require("./api/resources/lookups/client/Client.js");
 const Client_js_8 = require("./api/resources/memberships/client/Client.js");
 const Client_js_9 = require("./api/resources/operators/client/Client.js");
 const Client_js_10 = require("./api/resources/organizations/client/Client.js");
-const Client_js_11 = require("./api/resources/realtime/client/Client.js");
-const Client_js_12 = require("./api/resources/users/client/Client.js");
+const Client_js_11 = require("./api/resources/positions/client/Client.js");
+const Client_js_12 = require("./api/resources/realtime/client/Client.js");
+const Client_js_13 = require("./api/resources/users/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class NizamDashboardClient {
@@ -62,6 +63,9 @@ class NizamDashboardClient {
     get assignments() {
         return (this._assignments ?? (this._assignments = new Client_js_4.AssignmentsClient(this._options)));
     }
+    get positions() {
+        return (this._positions ?? (this._positions = new Client_js_11.PositionsClient(this._options)));
+    }
     get invites() {
         return (this._invites ?? (this._invites = new Client_js_5.InvitesClient(this._options)));
     }
@@ -72,7 +76,7 @@ class NizamDashboardClient {
         return (this._lookups ?? (this._lookups = new Client_js_7.LookupsClient(this._options)));
     }
     get users() {
-        return (this._users ?? (this._users = new Client_js_12.UsersClient(this._options)));
+        return (this._users ?? (this._users = new Client_js_13.UsersClient(this._options)));
     }
     get activeOrganization() {
         return (this._activeOrganization ?? (this._activeOrganization = new Client_js_1.ActiveOrganizationClient(this._options)));
@@ -87,7 +91,7 @@ class NizamDashboardClient {
         return (this._organizations ?? (this._organizations = new Client_js_10.OrganizationsClient(this._options)));
     }
     get realtime() {
-        return (this._realtime ?? (this._realtime = new Client_js_11.RealtimeClient(this._options)));
+        return (this._realtime ?? (this._realtime = new Client_js_12.RealtimeClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

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

@@ -17,6 +17,8 @@ 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 "./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.realtime = exports.positions = exports.organizations = exports.operators = exports.memberships = exports.lookups = exports.jobs = exports.invites = 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);
@@ -56,6 +56,8 @@ __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("./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;
+}

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

@@ -0,0 +1,21 @@
+/**
+ * @example
+ *     {
+ *         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="
+ *     }
+ */
+export interface ListPositionsRequest {
+    operator_id?: string;
+    start: string;
+    end: 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/positions/client/requests/ListPositionsRequest.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/positions/client/requests/index.d.ts

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

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

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

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

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

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

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

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

package/dist/api/resources/positions/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/types/HeatmapCell.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Aggregated position count for one H3 hex cell.
+ */
+export interface HeatmapCell {
+    /** H3 cell index, lowercase hex (string — H3 indexes exceed the JS safe-integer range). */
+    h3_cell?: string | undefined;
+    /** H3 resolution of the cell (9 or 11). */
+    h3_res?: number | undefined;
+    /** Number of positions recorded in the cell over the window. */
+    count?: number | undefined;
+    object?: HeatmapCell.Object_ | undefined;
+}
+export declare namespace HeatmapCell {
+    const Object_: {
+        readonly HeatmapCell: "heatmap_cell";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/HeatmapCell.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.HeatmapCell = void 0;
+var HeatmapCell;
+(function (HeatmapCell) {
+    HeatmapCell.Object_ = {
+        HeatmapCell: "heatmap_cell",
+    };
+})(HeatmapCell || (exports.HeatmapCell = HeatmapCell = {}));

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

@@ -0,0 +1,27 @@
+import type * as NizamDashboard from "../index.js";
+/**
+ * Envelope for paginated list responses (Stripe-style cursor pagination).
+ */
+export interface ListResponseHeatmapCell {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    object?: ListResponseHeatmapCell.Object_ | undefined;
+    /** Page of resources. Empty array when there are no matches. */
+    data?: NizamDashboard.HeatmapCell[] | undefined;
+    /** True when more pages exist; pass `next_cursor` as `?starting_after=` to fetch the next page. */
+    has_more?: boolean | undefined;
+    /** True when earlier pages exist; pass `prev_cursor` as `?ending_before=` to fetch the previous page. */
+    has_previous?: boolean | undefined;
+    /** Opaque cursor for the next page. `null` on the last page. */
+    next_cursor?: string | undefined;
+    /** Opaque cursor for the previous page. `null` on the first page. */
+    prev_cursor?: string | undefined;
+    /** Page size that produced this response. */
+    limit?: number | undefined;
+}
+export declare namespace ListResponseHeatmapCell {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    const Object_: {
+        readonly List: "list";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/ListResponseHeatmapCell.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListResponseHeatmapCell = void 0;
+var ListResponseHeatmapCell;
+(function (ListResponseHeatmapCell) {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    ListResponseHeatmapCell.Object_ = {
+        List: "list",
+    };
+})(ListResponseHeatmapCell || (exports.ListResponseHeatmapCell = ListResponseHeatmapCell = {}));

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

@@ -0,0 +1,27 @@
+import type * as NizamDashboard from "../index.js";
+/**
+ * Envelope for paginated list responses (Stripe-style cursor pagination).
+ */
+export interface ListResponseOperatorPosition {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    object?: ListResponseOperatorPosition.Object_ | undefined;
+    /** Page of resources. Empty array when there are no matches. */
+    data?: NizamDashboard.OperatorPosition[] | undefined;
+    /** True when more pages exist; pass `next_cursor` as `?starting_after=` to fetch the next page. */
+    has_more?: boolean | undefined;
+    /** True when earlier pages exist; pass `prev_cursor` as `?ending_before=` to fetch the previous page. */
+    has_previous?: boolean | undefined;
+    /** Opaque cursor for the next page. `null` on the last page. */
+    next_cursor?: string | undefined;
+    /** Opaque cursor for the previous page. `null` on the first page. */
+    prev_cursor?: string | undefined;
+    /** Page size that produced this response. */
+    limit?: number | undefined;
+}
+export declare namespace ListResponseOperatorPosition {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    const Object_: {
+        readonly List: "list";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/ListResponseOperatorPosition.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListResponseOperatorPosition = void 0;
+var ListResponseOperatorPosition;
+(function (ListResponseOperatorPosition) {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    ListResponseOperatorPosition.Object_ = {
+        List: "list",
+    };
+})(ListResponseOperatorPosition || (exports.ListResponseOperatorPosition = ListResponseOperatorPosition = {}));

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

@@ -0,0 +1,27 @@
+import type * as NizamDashboard from "../index.js";
+/**
+ * Envelope for paginated list responses (Stripe-style cursor pagination).
+ */
+export interface ListResponsePosition {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    object?: ListResponsePosition.Object_ | undefined;
+    /** Page of resources. Empty array when there are no matches. */
+    data?: NizamDashboard.Position[] | undefined;
+    /** True when more pages exist; pass `next_cursor` as `?starting_after=` to fetch the next page. */
+    has_more?: boolean | undefined;
+    /** True when earlier pages exist; pass `prev_cursor` as `?ending_before=` to fetch the previous page. */
+    has_previous?: boolean | undefined;
+    /** Opaque cursor for the next page. `null` on the last page. */
+    next_cursor?: string | undefined;
+    /** Opaque cursor for the previous page. `null` on the first page. */
+    prev_cursor?: string | undefined;
+    /** Page size that produced this response. */
+    limit?: number | undefined;
+}
+export declare namespace ListResponsePosition {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    const Object_: {
+        readonly List: "list";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/ListResponsePosition.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListResponsePosition = void 0;
+var ListResponsePosition;
+(function (ListResponsePosition) {
+    /** Object type discriminator (Stripe pattern). Always `list` for this envelope. */
+    ListResponsePosition.Object_ = {
+        List: "list",
+    };
+})(ListResponsePosition || (exports.ListResponsePosition = ListResponsePosition = {}));

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

@@ -0,0 +1,12 @@
+/**
+ * A short-lived MQTT publish credential for the position ingest broker.
+ */
+export interface MqttToken {
+    /** JWT to present as the MQTT CONNECT password. The CONNECT username must be the operator id embedded in the token's operator_id claim. */
+    token?: string | undefined;
+    /** Seconds until the token expires. Re-mint before this elapses to stay connected. */
+    expires_in?: number | undefined;
+    /** The only topic this credential may publish to: nizam/{organizationId}/operators/{operatorId}/location. */
+    topic?: string | undefined;
+    object?: string | undefined;
+}

package/dist/api/types/MqttToken.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/types/OperatorPosition.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The current position of one operator.
+ */
+export interface OperatorPosition {
+    /** Operator id. */
+    operator_id?: string | undefined;
+    /** Latitude (WGS84). */
+    lat?: number | undefined;
+    /** Longitude (WGS84). */
+    lng?: number | undefined;
+    /** Direction of travel, compass degrees [0,360). */
+    heading?: number | undefined;
+    /** Course over ground, compass degrees [0,360). */
+    bearing?: number | undefined;
+    /** Ground speed, km/h. */
+    speed?: number | undefined;
+    /** Altitude above the WGS84 ellipsoid, metres. */
+    altitude?: number | undefined;
+    /** Device-time of the fix. */
+    captured_at?: string | undefined;
+    object?: OperatorPosition.Object_ | undefined;
+}
+export declare namespace OperatorPosition {
+    const Object_: {
+        readonly OperatorPosition: "operator_position";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/OperatorPosition.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.OperatorPosition = void 0;
+var OperatorPosition;
+(function (OperatorPosition) {
+    OperatorPosition.Object_ = {
+        OperatorPosition: "operator_position",
+    };
+})(OperatorPosition || (exports.OperatorPosition = OperatorPosition = {}));

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

@@ -0,0 +1,30 @@
+/**
+ * One recorded GPS position of an operator.
+ */
+export interface Position {
+    /** Position id. */
+    id?: string | undefined;
+    /** Operator the fix belongs to. */
+    operator_id?: string | undefined;
+    /** Latitude (WGS84). */
+    lat?: number | undefined;
+    /** Longitude (WGS84). */
+    lng?: number | undefined;
+    /** Direction of travel, compass degrees [0,360). */
+    heading?: number | undefined;
+    /** Course over ground toward the destination, compass degrees [0,360). */
+    bearing?: number | undefined;
+    /** Ground speed, km/h. */
+    speed?: number | undefined;
+    /** Altitude above the WGS84 ellipsoid, metres. */
+    altitude?: number | undefined;
+    /** Device-time the fix was captured (authoritative). */
+    recorded_at?: string | undefined;
+    object?: Position.Object_ | undefined;
+}
+export declare namespace Position {
+    const Object_: {
+        readonly Position: "position";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/Position.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.Position = void 0;
+var Position;
+(function (Position) {
+    Position.Object_ = {
+        Position: "position",
+    };
+})(Position || (exports.Position = Position = {}));

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

@@ -12,6 +12,7 @@ export * from "./CreateHumanOperatorRequest.js";
 export * from "./CreateOperatorRequest.js";
 export * from "./CreateTeleoperatedOperatorRequest.js";
 export * from "./Currency.js";
+export * from "./HeatmapCell.js";
 export * from "./InternalUserUpdateRequest.js";
 export * from "./Invite.js";
 export * from "./Job.js";
@@ -22,17 +23,23 @@ export * from "./ListResponseAssetListItem.js";
 export * from "./ListResponseBusinessCategory.js";
 export * from "./ListResponseCountry.js";
 export * from "./ListResponseCurrency.js";
+export * from "./ListResponseHeatmapCell.js";
 export * from "./ListResponseJob.js";
 export * from "./ListResponseLanguage.js";
 export * from "./ListResponseMembership.js";
+export * from "./ListResponseOperatorPosition.js";
 export * from "./ListResponseOrganization.js";
+export * from "./ListResponsePosition.js";
 export * from "./ListResponseTimezone.js";
 export * from "./ListResponseUserResource.js";
 export * from "./Membership.js";
 export * from "./MembershipChoice.js";
 export * from "./MembershipDriftResponse.js";
+export * from "./MqttToken.js";
 export * from "./Operator.js";
+export * from "./OperatorPosition.js";
 export * from "./Organization.js";
+export * from "./Position.js";
 export * from "./ProblemDetail.js";
 export * from "./RealtimeTicket.js";
 export * from "./ReconcileResponse.js";

package/dist/api/types/index.js

@@ -28,6 +28,7 @@ __exportStar(require("./CreateHumanOperatorRequest.js"), exports);
 __exportStar(require("./CreateOperatorRequest.js"), exports);
 __exportStar(require("./CreateTeleoperatedOperatorRequest.js"), exports);
 __exportStar(require("./Currency.js"), exports);
+__exportStar(require("./HeatmapCell.js"), exports);
 __exportStar(require("./InternalUserUpdateRequest.js"), exports);
 __exportStar(require("./Invite.js"), exports);
 __exportStar(require("./Job.js"), exports);
@@ -38,17 +39,23 @@ __exportStar(require("./ListResponseAssetListItem.js"), exports);
 __exportStar(require("./ListResponseBusinessCategory.js"), exports);
 __exportStar(require("./ListResponseCountry.js"), exports);
 __exportStar(require("./ListResponseCurrency.js"), exports);
+__exportStar(require("./ListResponseHeatmapCell.js"), exports);
 __exportStar(require("./ListResponseJob.js"), exports);
 __exportStar(require("./ListResponseLanguage.js"), exports);
 __exportStar(require("./ListResponseMembership.js"), exports);
+__exportStar(require("./ListResponseOperatorPosition.js"), exports);
 __exportStar(require("./ListResponseOrganization.js"), exports);
+__exportStar(require("./ListResponsePosition.js"), exports);
 __exportStar(require("./ListResponseTimezone.js"), exports);
 __exportStar(require("./ListResponseUserResource.js"), exports);
 __exportStar(require("./Membership.js"), exports);
 __exportStar(require("./MembershipChoice.js"), exports);
 __exportStar(require("./MembershipDriftResponse.js"), exports);
+__exportStar(require("./MqttToken.js"), exports);
 __exportStar(require("./Operator.js"), exports);
+__exportStar(require("./OperatorPosition.js"), exports);
 __exportStar(require("./Organization.js"), exports);
+__exportStar(require("./Position.js"), exports);
 __exportStar(require("./ProblemDetail.js"), exports);
 __exportStar(require("./RealtimeTicket.js"), exports);
 __exportStar(require("./ReconcileResponse.js"), exports);

package/package.json

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