@nizam-os/dashboard-sdk 5.2.1 → 5.4.0

package/dist/Client.d.ts

@@ -1,4 +1,5 @@
 import { ActiveOrganizationClient } from "./api/resources/activeOrganization/client/Client.js";
+import { ActivityClient } from "./api/resources/activity/client/Client.js";
 import { AssetsClient } from "./api/resources/assets/client/Client.js";
 import { AssignmentsClient } from "./api/resources/assignments/client/Client.js";
 import { InvitesClient } from "./api/resources/invites/client/Client.js";
@@ -6,6 +7,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 { RealtimeClient } from "./api/resources/realtime/client/Client.js";
 import { UsersClient } from "./api/resources/users/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
@@ -17,6 +19,7 @@ export declare namespace NizamDashboardClient {
 }
 export declare class NizamDashboardClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<NizamDashboardClient.Options>;
+    protected _activity: ActivityClient | undefined;
     protected _assets: AssetsClient | undefined;
     protected _assignments: AssignmentsClient | undefined;
     protected _invites: InvitesClient | undefined;
@@ -26,7 +29,9 @@ export declare class NizamDashboardClient {
     protected _memberships: MembershipsClient | undefined;
     protected _operators: OperatorsClient | undefined;
     protected _organizations: OrganizationsClient | undefined;
+    protected _realtime: RealtimeClient | undefined;
     constructor(options: NizamDashboardClient.Options);
+    get activity(): ActivityClient;
     get assets(): AssetsClient;
     get assignments(): AssignmentsClient;
     get invites(): InvitesClient;
@@ -36,6 +41,7 @@ export declare class NizamDashboardClient {
     get memberships(): MembershipsClient;
     get operators(): OperatorsClient;
     get organizations(): OrganizationsClient;
+    get realtime(): RealtimeClient;
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.

package/dist/Client.js

@@ -36,46 +36,54 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NizamDashboardClient = void 0;
 const Client_js_1 = require("./api/resources/activeOrganization/client/Client.js");
-const Client_js_2 = require("./api/resources/assets/client/Client.js");
-const Client_js_3 = require("./api/resources/assignments/client/Client.js");
-const Client_js_4 = require("./api/resources/invites/client/Client.js");
-const Client_js_5 = require("./api/resources/lookups/client/Client.js");
-const Client_js_6 = require("./api/resources/memberships/client/Client.js");
-const Client_js_7 = require("./api/resources/operators/client/Client.js");
-const Client_js_8 = require("./api/resources/organizations/client/Client.js");
-const Client_js_9 = require("./api/resources/users/client/Client.js");
+const Client_js_2 = require("./api/resources/activity/client/Client.js");
+const Client_js_3 = require("./api/resources/assets/client/Client.js");
+const Client_js_4 = require("./api/resources/assignments/client/Client.js");
+const Client_js_5 = require("./api/resources/invites/client/Client.js");
+const Client_js_6 = require("./api/resources/lookups/client/Client.js");
+const Client_js_7 = require("./api/resources/memberships/client/Client.js");
+const Client_js_8 = require("./api/resources/operators/client/Client.js");
+const Client_js_9 = require("./api/resources/organizations/client/Client.js");
+const Client_js_10 = require("./api/resources/realtime/client/Client.js");
+const Client_js_11 = require("./api/resources/users/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class NizamDashboardClient {
     constructor(options) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
+    get activity() {
+        return (this._activity ?? (this._activity = new Client_js_2.ActivityClient(this._options)));
+    }
     get assets() {
-        return (this._assets ?? (this._assets = new Client_js_2.AssetsClient(this._options)));
+        return (this._assets ?? (this._assets = new Client_js_3.AssetsClient(this._options)));
     }
     get assignments() {
-        return (this._assignments ?? (this._assignments = new Client_js_3.AssignmentsClient(this._options)));
+        return (this._assignments ?? (this._assignments = new Client_js_4.AssignmentsClient(this._options)));
     }
     get invites() {
-        return (this._invites ?? (this._invites = new Client_js_4.InvitesClient(this._options)));
+        return (this._invites ?? (this._invites = new Client_js_5.InvitesClient(this._options)));
     }
     get lookups() {
-        return (this._lookups ?? (this._lookups = new Client_js_5.LookupsClient(this._options)));
+        return (this._lookups ?? (this._lookups = new Client_js_6.LookupsClient(this._options)));
     }
     get users() {
-        return (this._users ?? (this._users = new Client_js_9.UsersClient(this._options)));
+        return (this._users ?? (this._users = new Client_js_11.UsersClient(this._options)));
     }
     get activeOrganization() {
         return (this._activeOrganization ?? (this._activeOrganization = new Client_js_1.ActiveOrganizationClient(this._options)));
     }
     get memberships() {
-        return (this._memberships ?? (this._memberships = new Client_js_6.MembershipsClient(this._options)));
+        return (this._memberships ?? (this._memberships = new Client_js_7.MembershipsClient(this._options)));
     }
     get operators() {
-        return (this._operators ?? (this._operators = new Client_js_7.OperatorsClient(this._options)));
+        return (this._operators ?? (this._operators = new Client_js_8.OperatorsClient(this._options)));
     }
     get organizations() {
-        return (this._organizations ?? (this._organizations = new Client_js_8.OrganizationsClient(this._options)));
+        return (this._organizations ?? (this._organizations = new Client_js_9.OrganizationsClient(this._options)));
+    }
+    get realtime() {
+        return (this._realtime ?? (this._realtime = new Client_js_10.RealtimeClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

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

@@ -55,6 +55,11 @@ export declare class ActiveOrganizationClient {
      *     await client.activeOrganization.setActiveOrganization({
      *         slug: "acme-logistics"
      *     })
+     *
+     * @example
+     *     await client.activeOrganization.setActiveOrganization({
+     *         slug: "globex-freight"
+     *     })
      */
     setActiveOrganization(request: NizamDashboard.SetActiveOrganizationRequest, requestOptions?: ActiveOrganizationClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ActiveOrganization>;
     private __setActiveOrganization;

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

@@ -129,6 +129,11 @@ class ActiveOrganizationClient {
      *     await client.activeOrganization.setActiveOrganization({
      *         slug: "acme-logistics"
      *     })
+     *
+     * @example
+     *     await client.activeOrganization.setActiveOrganization({
+     *         slug: "globex-freight"
+     *     })
      */
     setActiveOrganization(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__setActiveOrganization(request, requestOptions));

package/dist/api/resources/activeOrganization/client/requests/SetActiveOrganizationRequest.d.ts

@@ -3,6 +3,11 @@
  *     {
  *         slug: "acme-logistics"
  *     }
+ *
+ * @example
+ *     {
+ *         slug: "globex-freight"
+ *     }
  */
 export interface SetActiveOrganizationRequest {
     /** Slug of the organization to make active. Must match an active membership. */

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

@@ -0,0 +1,36 @@
+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 ActivityClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Organization activity feed — the append-only timeline of what happened, and the durable source of truth behind realtime dashboard updates.
+ */
+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`.
+     *
+     * @param {NizamDashboard.ListActivityRequest} request
+     * @param {ActivityClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.activity.listActivity({
+     *         since: "2026-05-20T14:00:00Z",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listActivity(request?: NizamDashboard.ListActivityRequest, requestOptions?: ActivityClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ListResponseActivityResource>;
+    private __listActivity;
+}

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

@@ -0,0 +1,128 @@
+"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.ActivityClient = 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"));
+/**
+ * Organization activity feed — the append-only timeline of what happened, and the durable source of truth behind realtime dashboard updates.
+ */
+class ActivityClient {
+    constructor(options) {
+        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`.
+     *
+     * @param {NizamDashboard.ListActivityRequest} request
+     * @param {ActivityClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.activity.listActivity({
+     *         since: "2026-05-20T14:00:00Z",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listActivity(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listActivity(request, requestOptions));
+    }
+    async __listActivity(request = {}, requestOptions) {
+        const { since, sort, limit, starting_after: startingAfter, ending_before: endingBefore } = request;
+        const _queryParams = {
+            since: since != null ? since : undefined,
+            sort,
+            limit,
+            starting_after: startingAfter,
+            ending_before: endingBefore,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamDashboardEnvironment.Production, "v1/activity"),
+            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 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/activity");
+    }
+}
+exports.ActivityClient = ActivityClient;

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * @example
+ *     {
+ *         since: "2026-05-20T14:00:00Z",
+ *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+ *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+ *     }
+ */
+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;
+    /** Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported. */
+    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/activity/client/requests/ListActivityRequest.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/activity/client/requests/index.d.ts

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

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

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

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

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

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

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

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

package/dist/api/resources/activity/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/assets/client/Client.d.ts

@@ -13,6 +13,26 @@ export declare namespace AssetsClient {
 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. With `q`: ranked full-text search across name, VIN, code, plate, serial, call sign, make, model and sub-kind — accent-insensitive, language-agnostic (epic #97). Search results are ordered by relevance and support forward-only cursors (`starting_after`). `highlight=true` adds a `<mark>`-wrapped match snippet.
+     *
+     * @param {NizamDashboard.ListAssetsRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.assets.listAssets({
+     *         q: "<string>",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listAssets(request?: NizamDashboard.ListAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ListResponseAssetListItem>;
+    private __listAssets;
     /**
      * Creates a new asset (vehicle, drone, robot, container, equipment, ...) owned by the active organization.
      *
@@ -31,6 +51,25 @@ export declare class AssetsClient {
      *         name: "Truck 7",
      *         autonomy_level: 0
      *     })
+     *
+     * @example
+     *     await client.assets.createAsset({
+     *         kind: "aerial_vehicle",
+     *         name: "Delivery Drone D-12",
+     *         autonomy_level: 4
+     *     })
+     *
+     * @example
+     *     await client.assets.createAsset({
+     *         kind: "robot",
+     *         name: "Picker Bot 3",
+     *         autonomy_level: 5
+     *     })
+     *
+     * @example
+     *     await client.assets.createAsset({
+     *         kind: "container"
+     *     })
      */
     createAsset(request: NizamDashboard.CreateAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Asset>;
     private __createAsset;

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

@@ -49,6 +49,81 @@ class AssetsClient {
     constructor(options) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
+    /**
+     * Without `q`: the org's assets ordered by `created_at` descending. With `q`: ranked full-text search across name, VIN, code, plate, serial, call sign, make, model and sub-kind — accent-insensitive, language-agnostic (epic #97). Search results are ordered by relevance and support forward-only cursors (`starting_after`). `highlight=true` adds a `<mark>`-wrapped match snippet.
+     *
+     * @param {NizamDashboard.ListAssetsRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.BadRequestError}
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.assets.listAssets({
+     *         q: "<string>",
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listAssets(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listAssets(request, requestOptions));
+    }
+    async __listAssets(request = {}, requestOptions) {
+        const { q, highlight, limit, starting_after: startingAfter, ending_before: endingBefore } = request;
+        const _queryParams = {
+            q,
+            highlight,
+            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/assets"),
+            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 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/assets");
+    }
     /**
      * Creates a new asset (vehicle, drone, robot, container, equipment, ...) owned by the active organization.
      *
@@ -67,6 +142,25 @@ class AssetsClient {
      *         name: "Truck 7",
      *         autonomy_level: 0
      *     })
+     *
+     * @example
+     *     await client.assets.createAsset({
+     *         kind: "aerial_vehicle",
+     *         name: "Delivery Drone D-12",
+     *         autonomy_level: 4
+     *     })
+     *
+     * @example
+     *     await client.assets.createAsset({
+     *         kind: "robot",
+     *         name: "Picker Bot 3",
+     *         autonomy_level: 5
+     *     })
+     *
+     * @example
+     *     await client.assets.createAsset({
+     *         kind: "container"
+     *     })
      */
     createAsset(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__createAsset(request, requestOptions));

package/dist/api/resources/assets/client/requests/CreateAssetRequest.d.ts

@@ -5,6 +5,25 @@
  *         name: "Truck 7",
  *         autonomy_level: 0
  *     }
+ *
+ * @example
+ *     {
+ *         kind: "aerial_vehicle",
+ *         name: "Delivery Drone D-12",
+ *         autonomy_level: 4
+ *     }
+ *
+ * @example
+ *     {
+ *         kind: "robot",
+ *         name: "Picker Bot 3",
+ *         autonomy_level: 5
+ *     }
+ *
+ * @example
+ *     {
+ *         kind: "container"
+ *     }
  */
 export interface CreateAssetRequest {
     /** Top-level kind. */

package/dist/api/resources/assets/client/requests/ListAssetsRequest.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @example
+ *     {
+ *         q: "<string>",
+ *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+ *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+ *     }
+ */
+export interface ListAssetsRequest {
+    /** Free-text search query (max 200 chars). */
+    q?: string;
+    /** Include a highlighted match snippet per hit (search mode only). */
+    highlight?: boolean;
+    /** 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/assets/client/requests/ListAssetsRequest.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/assets/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export { CreateAssetRequest } from "./CreateAssetRequest.js";
 export type { GetAssetRequest } from "./GetAssetRequest.js";
+export type { ListAssetsRequest } from "./ListAssetsRequest.js";