@nizam-os/dashboard-sdk 10.0.0 → 11.0.0

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

@@ -14,7 +14,7 @@ export declare class ActivityClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ActivityClient.Options>;
     constructor(options: ActivityClient.Options);
     /**
-     * Newest-first feed of audited events for the caller's active organization (dashboard; tenant-scoped). Platform staff see across tenants. This is the durable, REST source of truth behind the realtime `/topic/organization.<id>.activity` STOMP stream: on reconnect, a client passes `since=<last_seen>` to catch up missed items, then resumes realtime. Each item's `event_id` correlates with the realtime ActivityFeedItem's `id` for deduplication. Sortable: `created_at` (default `-created_at`). Bidirectional opaque cursors via `starting_after` / `ending_before`.
+     * Newest-first feed of audited events for the caller's active organization (dashboard; tenant-scoped). Platform staff see across tenants. This is the durable, REST source of truth behind the realtime `/topic/organization.<id>.activity` STOMP stream: on reconnect, a client passes `since=<last_seen>` to catch up missed items, then resumes realtime. Each item's `event_id` correlates with the realtime ActivityFeedItem's `id` for deduplication. Sortable: `created_at` (default `created_at:desc`). Bidirectional opaque cursors via `starting_after` / `ending_before`.
      *
      * @param {NizamDashboard.ListActivityRequest} request
      * @param {ActivityClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -50,7 +50,7 @@ class ActivityClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Newest-first feed of audited events for the caller's active organization (dashboard; tenant-scoped). Platform staff see across tenants. This is the durable, REST source of truth behind the realtime `/topic/organization.<id>.activity` STOMP stream: on reconnect, a client passes `since=<last_seen>` to catch up missed items, then resumes realtime. Each item's `event_id` correlates with the realtime ActivityFeedItem's `id` for deduplication. Sortable: `created_at` (default `-created_at`). Bidirectional opaque cursors via `starting_after` / `ending_before`.
+     * Newest-first feed of audited events for the caller's active organization (dashboard; tenant-scoped). Platform staff see across tenants. This is the durable, REST source of truth behind the realtime `/topic/organization.<id>.activity` STOMP stream: on reconnect, a client passes `since=<last_seen>` to catch up missed items, then resumes realtime. Each item's `event_id` correlates with the realtime ActivityFeedItem's `id` for deduplication. Sortable: `created_at` (default `created_at:desc`). Bidirectional opaque cursors via `starting_after` / `ending_before`.
      *
      * @param {NizamDashboard.ListActivityRequest} request
      * @param {ActivityClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -75,7 +75,7 @@ class ActivityClient {
         const { since, sort, limit, starting_after: startingAfter, ending_before: endingBefore } = request;
         const _queryParams = {
             since: since != null ? since : undefined,
-            sort,
+            sort: Array.isArray(sort) ? sort.map((item) => item) : sort != null ? sort : undefined,
             limit,
             starting_after: startingAfter,
             ending_before: endingBefore,

package/dist/api/resources/activity/client/requests/ListActivityRequest.d.ts

@@ -1,3 +1,4 @@
+import type * as NizamDashboard from "../../../../index.js";
 /**
  * @example
  *     {
@@ -9,8 +10,8 @@
 export interface ListActivityRequest {
     /** Return only activity at or after this instant (ISO-8601). Pass the last-seen timestamp to reconcile after a realtime disconnect. */
     since?: 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[];
+    /** Sort order. Allowed fields: `created_at`. Append `:asc` or `:desc` to each field (direction required, e.g. `created_at:desc`), comma-separated for multi-sort; unknown fields or directions are rejected with `400 validation_failed`. */
+    sort?: NizamDashboard.ListActivityRequestSortItem | NizamDashboard.ListActivityRequestSortItem[];
     /** 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`. */

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

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

package/dist/api/resources/activity/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);

package/dist/api/resources/activity/types/ListActivityRequestSortItem.d.ts

@@ -0,0 +1,5 @@
+export declare const ListActivityRequestSortItem: {
+    readonly CreatedAtAsc: "created_at:asc";
+    readonly CreatedAtDesc: "created_at:desc";
+};
+export type ListActivityRequestSortItem = (typeof ListActivityRequestSortItem)[keyof typeof ListActivityRequestSortItem];

package/dist/api/resources/activity/types/ListActivityRequestSortItem.js

@@ -0,0 +1,8 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListActivityRequestSortItem = void 0;
+exports.ListActivityRequestSortItem = {
+    CreatedAtAsc: "created_at:asc",
+    CreatedAtDesc: "created_at:desc",
+};

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

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

package/dist/api/resources/activity/types/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("./ListActivityRequestSortItem.js"), exports);

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

@@ -14,7 +14,7 @@ export declare class AssetsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AssetsClient.Options>;
     constructor(options: AssetsClient.Options);
     /**
-     * Without `q`: the org's assets ordered by `created_at` descending (or an explicit `sort`). With `q`: ranked search across name, VIN, code, plate, serial, call sign, make, model and sub-kind — accent-insensitive and language-agnostic (epic #97). Matching is hybrid: whole words and word-prefixes (type-ahead — `pick` finds `Picker Bot 3`) plus substrings and typos (`ick`, or a misspelled `sprintr`, still match). `q` results are ordered by relevance unless `sort` is given, in which case the search narrows the rows and `sort` orders them. Allowed sort fields: `created_at`, `name`, `plate_number` — a single field, `-` prefix for descending. `status` / `kind` accept comma-separated values and narrow every mode. Pagination is bidirectional (`starting_after` / `ending_before`); cursors are bound to the sort that minted them — switching sorts restarts from the first page. `highlight=true` adds a `<mark>`-wrapped match snippet (relevance mode only).
+     * Without `q`: the org's assets ordered by `created_at` descending (or an explicit `sort`). With `q`: ranked search across name, VIN, code, plate, serial, call sign, make, model and sub-kind — accent-insensitive and language-agnostic (epic #97). Matching is hybrid: whole words and word-prefixes (type-ahead — `pick` finds `Picker Bot 3`) plus substrings and typos (`ick`, or a misspelled `sprintr`, still match). `q` results are ordered by relevance unless `sort` is given, in which case the search narrows the rows and `sort` orders them. Sort by a single column — the allowed fields and direction grammar are enumerated on the `sort` parameter; `status` and `kind` sort by their domain order (status lifecycle, kind grouping), not the stored code or the tenant-relabeled display string. As filters, `status` / `kind` accept comma-separated values and narrow every mode. Pagination is bidirectional (`starting_after` / `ending_before`); cursors are bound to the sort that minted them — switching sorts restarts from the first page. `highlight=true` adds a `<mark>`-wrapped match snippet (relevance mode only).
      *
      * @param {NizamDashboard.ListAssetsRequest} request
      * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -28,6 +28,8 @@ export declare class AssetsClient {
      * @example
      *     await client.assets.listAssets({
      *         q: "<string>",
+     *         created_on_or_after: "2026-05-20",
+     *         created_on_or_before: "2026-05-20",
      *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
      *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
      *     })
@@ -80,6 +82,48 @@ export declare class AssetsClient {
      */
     createAsset(request: NizamDashboard.CreateAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
     private __createAsset;
+    /**
+     * Returns the lifecycle statuses EVERY asset in the selection may legally move to next — the intersection of each asset's legal-transition set (the same matrix the per-asset `allowed_transitions` field and the transition verbs enforce). The status picker calls this so a bulk change offers only moves legal for the WHOLE selection, instead of offering every status and relying on per-row 409s. Ids that don't resolve to a live asset in your organization are ignored; a selection that shares no common next status (e.g. it includes a terminal sold/lost asset) returns an empty list. It is a read — re-asserting it is free.
+     *
+     * @param {NizamDashboard.AllowedTransitionsRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.UnprocessableEntityError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.assets.assetAllowedTransitions({
+     *         ids: ["8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6"]
+     *     })
+     */
+    assetAllowedTransitions(request: NizamDashboard.AllowedTransitionsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.AllowedTransitions>;
+    private __assetAllowedTransitions;
+    /**
+     * Generates a CSV / XLSX / JSON file of the selected assets with the chosen columns and returns a short-lived download URL the browser follows to download it. Columns are emitted in the requested order; `kind` and `status` carry their stored code (re-importable), not the tenant's display label. The id count is capped — this exports an explicit selection. POST because generating + storing the file and logging the egress is an audited action, not a cacheable read.
+     *
+     * @param {NizamDashboard.ExportAssetsRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.UnprocessableEntityError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.assets.exportAssets({
+     *         format: "xlsx",
+     *         fields: ["id", "name", "status"],
+     *         ids: ["8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6"]
+     *     })
+     */
+    exportAssets(request: NizamDashboard.ExportAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.FileDownloadUrl>;
+    private __exportAssets;
     /**
      * 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.
      *
@@ -107,4 +151,195 @@ export declare class AssetsClient {
      */
     getAsset(request: NizamDashboard.GetAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
     private __getAsset;
+    /**
+     * Soft-deletes the asset: it disappears from listings immediately and frees its VIN for re-registration. Assignments and historical records are left untouched. There is no synchronous bulk-delete endpoint — delete a selection by fanning out per-id requests (each is naturally idempotent).
+     *
+     * @param {NizamDashboard.DeleteAssetRequest} request
+     * @param {AssetsClient.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.assets.deleteAsset({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    deleteAsset(request: NizamDashboard.DeleteAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __deleteAsset;
+    /**
+     * Set-only partial update of an asset's mutable fields — display name, sub-kind, autonomy level, and the vehicle identity (VIN, plate, make, model, year). Omitted or null fields are left unchanged. An asset's `kind` is immutable and lifecycle `status` moves through dedicated transitions, so neither is editable here.
+     *
+     * @param {NizamDashboard.UpdateAssetRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.NotFoundError}
+     * @throws {@link NizamDashboard.ConflictError}
+     * @throws {@link NizamDashboard.UnprocessableEntityError}
+     * @throws {@link NizamDashboard.TooManyRequestsError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.assets.updateAsset({
+     *         id: "00000000-0000-0000-0000-000000000000",
+     *         name: "Truck 7B"
+     *     })
+     *
+     * @example
+     *     await client.assets.updateAsset({
+     *         id: "00000000-0000-0000-0000-000000000000",
+     *         vin: "1HGCM82633A004352",
+     *         plate_number: "AB-123-CD",
+     *         make: "Volvo",
+     *         model: "FH16",
+     *         year: 2024
+     *     })
+     */
+    updateAsset(request: NizamDashboard.UpdateAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
+    private __updateAsset;
+    /**
+     * Returns the asset to `active` service. Idempotent no-op if already active; an illegal edge (e.g. from a terminal sold/lost asset) → 409 `asset.invalid_transition`. No body — fan out per id for a bulk change.
+     *
+     * @param {NizamDashboard.ActivateAssetRequest} request
+     * @param {AssetsClient.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.assets.activateAsset({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    activateAsset(request: NizamDashboard.ActivateAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
+    private __activateAsset;
+    /**
+     * Marks the asset `inactive` (idle but still in-fleet). Idempotent no-op if already inactive; an illegal edge → 409 `asset.invalid_transition`. No body.
+     *
+     * @param {NizamDashboard.DeactivateAssetRequest} request
+     * @param {AssetsClient.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.assets.deactivateAsset({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    deactivateAsset(request: NizamDashboard.DeactivateAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
+    private __deactivateAsset;
+    /**
+     * Moves the asset into `maintenance`. Idempotent no-op if already in maintenance; an illegal edge → 409 `asset.invalid_transition`. No body.
+     *
+     * @param {NizamDashboard.EnterAssetMaintenanceRequest} request
+     * @param {AssetsClient.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.assets.enterAssetMaintenance({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    enterAssetMaintenance(request: NizamDashboard.EnterAssetMaintenanceRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
+    private __enterAssetMaintenance;
+    /**
+     * Marks the asset `lost` — a terminal state; the asset has left the fleet and accepts no further transitions. Idempotent no-op if already lost; an illegal edge → 409 `asset.invalid_transition`. No body.
+     *
+     * @param {NizamDashboard.ReportAssetLostRequest} request
+     * @param {AssetsClient.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.assets.reportAssetLost({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    reportAssetLost(request: NizamDashboard.ReportAssetLostRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
+    private __reportAssetLost;
+    /**
+     * Retires the asset (`retired`) — decommissioned but still owned; it may later be reactivated, sold, or reported lost. Idempotent no-op if already retired; an illegal edge → 409 `asset.invalid_transition`. No body.
+     *
+     * @param {NizamDashboard.RetireAssetRequest} request
+     * @param {AssetsClient.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.assets.retireAsset({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    retireAsset(request: NizamDashboard.RetireAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
+    private __retireAsset;
+    /**
+     * Marks the asset `sold` — a terminal state; the asset has left the fleet and accepts no further transitions. Idempotent no-op if already sold; an illegal edge → 409 `asset.invalid_transition`. No body.
+     *
+     * @param {NizamDashboard.SellAssetRequest} request
+     * @param {AssetsClient.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.assets.sellAsset({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    sellAsset(request: NizamDashboard.SellAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
+    private __sellAsset;
+    /**
+     * Moves the asset `out_of_service`. Idempotent no-op if already out of service; an illegal edge → 409 `asset.invalid_transition`. No body.
+     *
+     * @param {NizamDashboard.TakeAssetOutOfServiceRequest} request
+     * @param {AssetsClient.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.assets.takeAssetOutOfService({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    takeAssetOutOfService(request: NizamDashboard.TakeAssetOutOfServiceRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
+    private __takeAssetOutOfService;
 }