@nizam-os/dashboard-sdk 8.1.0 → 10.0.0

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

@@ -50,7 +50,7 @@ class NotificationsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * The caller's own notifications ordered by `created_at` descending (pass `sort=created_at` for ascending). `unread=true` restricts to unread; `since=` (RFC 3339) returns only items at/after the instant for incremental catch-up after a reconnect. Pagination is bidirectional (`starting_after` / `ending_before`); cursors are bound to the sort direction that minted them.
+     * The caller's own notifications ordered by `created_at` descending (pass `sort=created_at` for ascending). `status` selects the segment — `all` (default; the active inbox, non-archived), `unread`, `read`, or `archived`. `category` and `kind` accept comma-separated values and AND on top of the segment; `q` matches the notification title/body. `since=` (RFC 3339) returns only items at/after the instant for incremental catch-up after a reconnect. Pagination is bidirectional (`starting_after` / `ending_before`); cursors are bound to the sort direction that minted them.
      *
      * @param {NizamDashboard.ListNotificationsRequest} request
      * @param {NotificationsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -63,6 +63,8 @@ class NotificationsClient {
      *
      * @example
      *     await client.notifications.listNotifications({
+     *         status: "<string>",
+     *         q: "<string>",
      *         since: "2026-05-20T14:00:00Z",
      *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
      *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
@@ -72,9 +74,12 @@ class NotificationsClient {
         return core.HttpResponsePromise.fromPromise(this.__listNotifications(request, requestOptions));
     }
     async __listNotifications(request = {}, requestOptions) {
-        const { unread, since, sort, limit, starting_after: startingAfter, ending_before: endingBefore } = request;
+        const { status, category, kind, q, since, sort, limit, starting_after: startingAfter, ending_before: endingBefore, } = request;
         const _queryParams = {
-            unread,
+            status,
+            category,
+            kind,
+            q,
             since: since != null ? since : undefined,
             sort,
             limit,
@@ -128,6 +133,122 @@ class NotificationsClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/notifications");
     }
+    /**
+     * Archives every active notification of the caller in one operation. Returns the number archived (zero when the active inbox was already empty).
+     *
+     * @param {NotificationsClient.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.notifications.archiveAllNotifications()
+     */
+    archiveAllNotifications(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__archiveAllNotifications(requestOptions));
+    }
+    async __archiveAllNotifications(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/notifications/archive_all"),
+            method: "POST",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 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, "POST", "/v1/notifications/archive_all");
+    }
+    /**
+     * The segment-badge roll-up for the active organization: total + unread (active, non-archived), archived, and per-category active total/unread. Computed server-side in one pass so segment badges stay accurate across cursor pages (never inferred from the loaded page). Excludes dismissed (soft-deleted) notifications.
+     *
+     * @param {NotificationsClient.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.notifications.getNotificationCounts()
+     */
+    getNotificationCounts(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getNotificationCounts(requestOptions));
+    }
+    async __getNotificationCounts(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/notifications/counts"),
+            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/notifications/counts");
+    }
     /**
      * Flips every unread notification of the caller to read in one operation. Returns the number of notifications that were flipped (zero when the inbox was already clear).
      *
@@ -190,7 +311,7 @@ class NotificationsClient {
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/notifications/read_all");
     }
     /**
-     * The unread badge count for the active organization. Excludes dismissed (soft-deleted) notifications.
+     * The unread badge count for the active organization. Counts active (non-archived) unread notifications; excludes dismissed (soft-deleted) and archived ones.
      *
      * @param {NotificationsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -250,6 +371,68 @@ class NotificationsClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/notifications/unread_count");
     }
+    /**
+     * Moves a single notification to the archive ("Done") — reversible, not a delete: it leaves the active inbox but stays listable under `status=archived`. Idempotent. 404 if the notification is not the caller's.
+     *
+     * @param {NizamDashboard.ArchiveNotificationRequest} request
+     * @param {NotificationsClient.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.notifications.archiveNotification({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    archiveNotification(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__archiveNotification(request, requestOptions));
+    }
+    async __archiveNotification(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamDashboardEnvironment.Production, `v1/notifications/${core.url.encodePathParam(id)}/archive`),
+            method: "POST",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamDashboard.NotFoundError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamDashboard.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/notifications/{id}/archive");
+    }
     /**
      * Flips a single notification to read. Idempotent — a second call is a no-op that preserves the original read timestamp. 404 if the notification is not the caller's.
      *
@@ -312,5 +495,129 @@ class NotificationsClient {
         }
         return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/notifications/{id}/read");
     }
+    /**
+     * Restores an archived notification to the active inbox — the inverse of archive. Idempotent. 404 if the notification is not the caller's.
+     *
+     * @param {NizamDashboard.UnarchiveNotificationRequest} request
+     * @param {NotificationsClient.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.notifications.unarchiveNotification({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    unarchiveNotification(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__unarchiveNotification(request, requestOptions));
+    }
+    async __unarchiveNotification(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamDashboardEnvironment.Production, `v1/notifications/${core.url.encodePathParam(id)}/unarchive`),
+            method: "POST",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamDashboard.NotFoundError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamDashboard.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/notifications/{id}/unarchive");
+    }
+    /**
+     * Flips a single notification back to unread — the inverse of mark-read. Idempotent. 404 if the notification is not the caller's.
+     *
+     * @param {NizamDashboard.MarkNotificationUnreadRequest} request
+     * @param {NotificationsClient.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.notifications.markNotificationUnread({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    markNotificationUnread(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__markNotificationUnread(request, requestOptions));
+    }
+    async __markNotificationUnread(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamDashboardEnvironment.Production, `v1/notifications/${core.url.encodePathParam(id)}/unread`),
+            method: "POST",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamDashboard.NotFoundError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamDashboard.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/notifications/{id}/unread");
+    }
 }
 exports.NotificationsClient = NotificationsClient;

package/dist/api/resources/notifications/client/requests/ArchiveNotificationRequest.d.ts

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

package/dist/api/resources/notifications/client/requests/ArchiveNotificationRequest.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/notifications/client/requests/ListNotificationsRequest.d.ts

@@ -1,14 +1,22 @@
 /**
  * @example
  *     {
+ *         status: "<string>",
+ *         q: "<string>",
  *         since: "2026-05-20T14:00:00Z",
  *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
  *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
  *     }
  */
 export interface ListNotificationsRequest {
-    /** Restrict to unread notifications. */
-    unread?: boolean;
+    /** Inbox segment. One of: `all` (default — active, non-archived), `unread`, `read`, `archived`. */
+    status?: string;
+    /** Filter by category. Comma-separated; values: `transactional`, `operational`, `alert`, `marketing`, `security`, `system`. */
+    category?: string | string[];
+    /** Filter by notification kind (wire key). Comma-separated; e.g. `membership.joined`. */
+    kind?: string | string[];
+    /** Free-text search over the notification title/body (max 200 chars). */
+    q?: string;
     /** Only notifications created at/after this RFC 3339 instant. */
     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`. */

package/dist/api/resources/notifications/client/requests/MarkNotificationUnreadRequest.d.ts

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

package/dist/api/resources/notifications/client/requests/MarkNotificationUnreadRequest.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/notifications/client/requests/UnarchiveNotificationRequest.d.ts

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

package/dist/api/resources/notifications/client/requests/UnarchiveNotificationRequest.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/notifications/client/requests/index.d.ts

@@ -1,2 +1,5 @@
+export type { ArchiveNotificationRequest } from "./ArchiveNotificationRequest.js";
 export type { ListNotificationsRequest } from "./ListNotificationsRequest.js";
 export type { MarkNotificationReadRequest } from "./MarkNotificationReadRequest.js";
+export type { MarkNotificationUnreadRequest } from "./MarkNotificationUnreadRequest.js";
+export type { UnarchiveNotificationRequest } from "./UnarchiveNotificationRequest.js";

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

@@ -16,38 +16,48 @@ export declare class OperatorsClient {
     /**
      * Creates a new operator (human, autonomous software, or teleoperated). The `kind` discriminator selects the variant.
      *
-     * @param {NizamDashboard.CreateOperatorRequest} request
+     * @param {NizamDashboard.CreateOperatorBody} request
      * @param {OperatorsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link NizamDashboard.BadRequestError}
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.ConflictError}
      * @throws {@link NizamDashboard.UnprocessableEntityError}
      * @throws {@link NizamDashboard.TooManyRequestsError}
      * @throws {@link NizamDashboard.InternalServerError}
      *
      * @example
      *     await client.operators.createOperator({
-     *         kind: "human"
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+     *         body: {
+     *             kind: "human"
+     *         }
      *     })
      *
      * @example
      *     await client.operators.createOperator({
-     *         kind: "autonomous",
-     *         vendor: "Waymo",
-     *         product: "Waymo Driver",
-     *         version: "7.3",
-     *         responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+     *         body: {
+     *             kind: "autonomous",
+     *             vendor: "Waymo",
+     *             product: "Waymo Driver",
+     *             version: "7.3",
+     *             responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+     *         }
      *     })
      *
      * @example
      *     await client.operators.createOperator({
-     *         kind: "teleoperated",
-     *         controller_user_id: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
-     *         responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+     *         body: {
+     *             kind: "teleoperated",
+     *             controller_user_id: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
+     *             responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+     *         }
      *     })
      */
-    createOperator(request: NizamDashboard.CreateOperatorRequest, requestOptions?: OperatorsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Operator>;
+    createOperator(request: NizamDashboard.CreateOperatorBody, requestOptions?: OperatorsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Operator>;
     private __createOperator;
     /**
      * @param {NizamDashboard.GetOperatorRequest} request

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

@@ -52,43 +52,54 @@ class OperatorsClient {
     /**
      * Creates a new operator (human, autonomous software, or teleoperated). The `kind` discriminator selects the variant.
      *
-     * @param {NizamDashboard.CreateOperatorRequest} request
+     * @param {NizamDashboard.CreateOperatorBody} request
      * @param {OperatorsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link NizamDashboard.BadRequestError}
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.ConflictError}
      * @throws {@link NizamDashboard.UnprocessableEntityError}
      * @throws {@link NizamDashboard.TooManyRequestsError}
      * @throws {@link NizamDashboard.InternalServerError}
      *
      * @example
      *     await client.operators.createOperator({
-     *         kind: "human"
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+     *         body: {
+     *             kind: "human"
+     *         }
      *     })
      *
      * @example
      *     await client.operators.createOperator({
-     *         kind: "autonomous",
-     *         vendor: "Waymo",
-     *         product: "Waymo Driver",
-     *         version: "7.3",
-     *         responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+     *         body: {
+     *             kind: "autonomous",
+     *             vendor: "Waymo",
+     *             product: "Waymo Driver",
+     *             version: "7.3",
+     *             responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+     *         }
      *     })
      *
      * @example
      *     await client.operators.createOperator({
-     *         kind: "teleoperated",
-     *         controller_user_id: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
-     *         responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+     *         body: {
+     *             kind: "teleoperated",
+     *             controller_user_id: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
+     *             responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+     *         }
      *     })
      */
     createOperator(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__createOperator(request, requestOptions));
     }
     async __createOperator(request, requestOptions) {
+        const { "Idempotency-Key": idempotencyKey, body: _body } = request;
         const _authRequest = await this._options.authProvider.getAuthRequest();
-        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "Idempotency-Key": idempotencyKey }), 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)) ??
@@ -98,7 +109,7 @@ class OperatorsClient {
             contentType: "application/json",
             queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
             requestType: "json",
-            body: request,
+            body: _body,
             timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
             maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
             abortSignal: requestOptions?.abortSignal,
@@ -116,6 +127,8 @@ class OperatorsClient {
                     throw new NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
                 case 403:
                     throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new NizamDashboard.ConflictError(_response.error.body, _response.rawResponse);
                 case 422:
                     throw new NizamDashboard.UnprocessableEntityError(_response.error.body, _response.rawResponse);
                 case 429:

package/dist/api/resources/operators/client/requests/CreateOperatorBody.d.ts

@@ -0,0 +1,37 @@
+import type * as NizamDashboard from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+ *         body: {
+ *             kind: "human"
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+ *         body: {
+ *             kind: "autonomous",
+ *             vendor: "Waymo",
+ *             product: "Waymo Driver",
+ *             version: "7.3",
+ *             responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
+ *         body: {
+ *             kind: "teleoperated",
+ *             controller_user_id: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
+ *             responsible_party: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f"
+ *         }
+ *     }
+ */
+export interface CreateOperatorBody {
+    /** Optional. Supply a UUID (canonical 8-4-4-4-12 form; lowercase v4 recommended) to make this operation idempotent: the same key on a retry replays the original outcome instead of creating a second resource. 2xx successes and deliberate 4xx domain rejections are cached and replayed for 24h when the request body matches; transient 5xx responses are never cached, so a retry with the same key re-executes. A malformed key is rejected with 400 `idempotency.invalid_key`; reusing a key with a different request body is 409 `idempotency.key_conflict`; a key still in flight is 409 `idempotency.in_progress`. Omit the header and the operation behaves like any other write. */
+    "Idempotency-Key"?: string;
+    body: NizamDashboard.CreateOperatorRequest;
+}

package/dist/api/resources/operators/client/requests/CreateOperatorBody.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/operators/client/requests/index.d.ts

@@ -1 +1,2 @@
+export type { CreateOperatorBody } from "./CreateOperatorBody.js";
 export type { GetOperatorRequest } from "./GetOperatorRequest.js";