@nizam-os/dashboard-sdk 9.0.0 → 10.0.0

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

@@ -43,12 +43,14 @@ export declare class AssetsClient {
      * @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.assets.createAsset({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "ground_vehicle",
      *         name: "Truck 7",
      *         autonomy_level: 0
@@ -56,6 +58,7 @@ export declare class AssetsClient {
      *
      * @example
      *     await client.assets.createAsset({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "aerial_vehicle",
      *         name: "Delivery Drone D-12",
      *         autonomy_level: 4
@@ -63,6 +66,7 @@ export declare class AssetsClient {
      *
      * @example
      *     await client.assets.createAsset({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "robot",
      *         name: "Picker Bot 3",
      *         autonomy_level: 5
@@ -70,6 +74,7 @@ export declare class AssetsClient {
      *
      * @example
      *     await client.assets.createAsset({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "container"
      *     })
      */

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

@@ -139,12 +139,14 @@ class AssetsClient {
      * @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.assets.createAsset({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "ground_vehicle",
      *         name: "Truck 7",
      *         autonomy_level: 0
@@ -152,6 +154,7 @@ class AssetsClient {
      *
      * @example
      *     await client.assets.createAsset({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "aerial_vehicle",
      *         name: "Delivery Drone D-12",
      *         autonomy_level: 4
@@ -159,6 +162,7 @@ class AssetsClient {
      *
      * @example
      *     await client.assets.createAsset({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "robot",
      *         name: "Picker Bot 3",
      *         autonomy_level: 5
@@ -166,6 +170,7 @@ class AssetsClient {
      *
      * @example
      *     await client.assets.createAsset({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "container"
      *     })
      */
@@ -173,8 +178,9 @@ class AssetsClient {
         return core.HttpResponsePromise.fromPromise(this.__createAsset(request, requestOptions));
     }
     async __createAsset(request, requestOptions) {
+        const { "Idempotency-Key": idempotencyKey, ..._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)) ??
@@ -184,7 +190,7 @@ class AssetsClient {
             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,
@@ -202,6 +208,8 @@ class AssetsClient {
                     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/assets/client/requests/CreateAssetRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         kind: "ground_vehicle",
  *         name: "Truck 7",
  *         autonomy_level: 0
@@ -8,6 +9,7 @@
  *
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         kind: "aerial_vehicle",
  *         name: "Delivery Drone D-12",
  *         autonomy_level: 4
@@ -15,6 +17,7 @@
  *
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         kind: "robot",
  *         name: "Picker Bot 3",
  *         autonomy_level: 5
@@ -22,10 +25,13 @@
  *
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         kind: "container"
  *     }
  */
 export interface CreateAssetRequest {
+    /** 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;
     /** Top-level kind. */
     kind: CreateAssetRequest.Kind;
     /** Display name. */

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

@@ -29,6 +29,7 @@ export declare class AssignmentsClient {
      *
      * @example
      *     await client.assignments.openAssignment({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         asset_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         operator_id: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
      *         role: "primary"
@@ -36,6 +37,7 @@ export declare class AssignmentsClient {
      *
      * @example
      *     await client.assignments.openAssignment({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         asset_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         operator_id: "d2e3f4a5-6b7c-8d9e-0f1a-2b3c4d5e6f7a",
      *         role: "safety_monitor"

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

@@ -65,6 +65,7 @@ class AssignmentsClient {
      *
      * @example
      *     await client.assignments.openAssignment({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         asset_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         operator_id: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
      *         role: "primary"
@@ -72,6 +73,7 @@ class AssignmentsClient {
      *
      * @example
      *     await client.assignments.openAssignment({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         asset_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         operator_id: "d2e3f4a5-6b7c-8d9e-0f1a-2b3c4d5e6f7a",
      *         role: "safety_monitor"
@@ -81,8 +83,9 @@ class AssignmentsClient {
         return core.HttpResponsePromise.fromPromise(this.__openAssignment(request, requestOptions));
     }
     async __openAssignment(request, requestOptions) {
+        const { "Idempotency-Key": idempotencyKey, ..._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)) ??
@@ -92,7 +95,7 @@ class AssignmentsClient {
             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,

package/dist/api/resources/assignments/client/requests/OpenAssignmentRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         asset_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
  *         operator_id: "c1d2e3f4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  *         role: "primary"
@@ -8,12 +9,15 @@
  *
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         asset_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
  *         operator_id: "d2e3f4a5-6b7c-8d9e-0f1a-2b3c4d5e6f7a",
  *         role: "safety_monitor"
  *     }
  */
 export interface OpenAssignmentRequest {
+    /** 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;
     /** Asset id. */
     asset_id: string;
     /** Operator id. */

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

@@ -41,6 +41,7 @@ export declare class FilesClient {
      * @throws {@link NizamDashboard.BadRequestError}
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.ConflictError}
      * @throws {@link NizamDashboard.ContentTooLargeError}
      * @throws {@link NizamDashboard.UnprocessableEntityError}
      * @throws {@link NizamDashboard.TooManyRequestsError}
@@ -48,6 +49,7 @@ export declare class FilesClient {
      *
      * @example
      *     await client.files.initiateFileUpload({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "profile_picture",
      *         subject_type: "task_attempt",
      *         subject_id: "b3c4d5e6-7f8a-9b0c-1d2e-3f4a5b6c7d8e",

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

@@ -134,6 +134,7 @@ class FilesClient {
      * @throws {@link NizamDashboard.BadRequestError}
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.ConflictError}
      * @throws {@link NizamDashboard.ContentTooLargeError}
      * @throws {@link NizamDashboard.UnprocessableEntityError}
      * @throws {@link NizamDashboard.TooManyRequestsError}
@@ -141,6 +142,7 @@ class FilesClient {
      *
      * @example
      *     await client.files.initiateFileUpload({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "profile_picture",
      *         subject_type: "task_attempt",
      *         subject_id: "b3c4d5e6-7f8a-9b0c-1d2e-3f4a5b6c7d8e",
@@ -154,8 +156,9 @@ class FilesClient {
         return core.HttpResponsePromise.fromPromise(this.__initiateFileUpload(request, requestOptions));
     }
     async __initiateFileUpload(request, requestOptions) {
+        const { "Idempotency-Key": idempotencyKey, ..._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)) ??
@@ -165,7 +168,7 @@ class FilesClient {
             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,
@@ -183,6 +186,8 @@ class FilesClient {
                     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 413:
                     throw new NizamDashboard.ContentTooLargeError(_response.error.body, _response.rawResponse);
                 case 422:

package/dist/api/resources/files/client/requests/InitiateFileUploadRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         kind: "profile_picture",
  *         subject_type: "task_attempt",
  *         subject_id: "b3c4d5e6-7f8a-9b0c-1d2e-3f4a5b6c7d8e",
@@ -11,6 +12,8 @@
  *     }
  */
 export interface InitiateFileUploadRequest {
+    /** 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;
     /** What the bytes are for the platform — fixes the policy applied to them. */
     kind: InitiateFileUploadRequest.Kind;
     /** Type of the business entity this file documents (optional at upload time; can also be attached later). */

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

@@ -19,6 +19,7 @@ export declare class ImportsClient {
      * @throws {@link NizamDashboard.BadRequestError}
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.ConflictError}
      * @throws {@link NizamDashboard.ContentTooLargeError}
      * @throws {@link NizamDashboard.UnprocessableEntityError}
      * @throws {@link NizamDashboard.TooManyRequestsError}
@@ -26,6 +27,7 @@ export declare class ImportsClient {
      *
      * @example
      *     await client.imports.createImport({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "import_fleet_assets_xlsx",
      *         filename: "fleet-assets.xlsx",
      *         content_type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",

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

@@ -55,6 +55,7 @@ class ImportsClient {
      * @throws {@link NizamDashboard.BadRequestError}
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.ConflictError}
      * @throws {@link NizamDashboard.ContentTooLargeError}
      * @throws {@link NizamDashboard.UnprocessableEntityError}
      * @throws {@link NizamDashboard.TooManyRequestsError}
@@ -62,6 +63,7 @@ class ImportsClient {
      *
      * @example
      *     await client.imports.createImport({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         kind: "import_fleet_assets_xlsx",
      *         filename: "fleet-assets.xlsx",
      *         content_type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
@@ -73,8 +75,9 @@ class ImportsClient {
         return core.HttpResponsePromise.fromPromise(this.__createImport(request, requestOptions));
     }
     async __createImport(request, requestOptions) {
+        const { "Idempotency-Key": idempotencyKey, ..._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)) ??
@@ -84,7 +87,7 @@ class ImportsClient {
             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,
@@ -102,6 +105,8 @@ class ImportsClient {
                     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 413:
                     throw new NizamDashboard.ContentTooLargeError(_response.error.body, _response.rawResponse);
                 case 422:

package/dist/api/resources/imports/client/requests/CreateImportRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         kind: "import_fleet_assets_xlsx",
  *         filename: "fleet-assets.xlsx",
  *         content_type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
@@ -9,6 +10,8 @@
  *     }
  */
 export interface CreateImportRequest {
+    /** 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;
     /** The import kind to run (lowercase). */
     kind: string;
     /** Original filename of the source file. */

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

@@ -19,14 +19,17 @@ export declare class InvitesClient {
      * @param {NizamDashboard.CreateInviteRequest} request
      * @param {InvitesClient.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.invites.createInvite({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         email: "ali@nizam.ai",
      *         role: "admin"
@@ -34,6 +37,7 @@ export declare class InvitesClient {
      *
      * @example
      *     await client.invites.createInvite({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         email: "jordan@example.com",
      *         role: "dispatcher",
@@ -42,6 +46,7 @@ export declare class InvitesClient {
      *
      * @example
      *     await client.invites.createInvite({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         email: "auditor@partner.example",
      *         role: "viewer",

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

@@ -55,14 +55,17 @@ class InvitesClient {
      * @param {NizamDashboard.CreateInviteRequest} request
      * @param {InvitesClient.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.invites.createInvite({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         email: "ali@nizam.ai",
      *         role: "admin"
@@ -70,6 +73,7 @@ class InvitesClient {
      *
      * @example
      *     await client.invites.createInvite({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         email: "jordan@example.com",
      *         role: "dispatcher",
@@ -78,6 +82,7 @@ class InvitesClient {
      *
      * @example
      *     await client.invites.createInvite({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         email: "auditor@partner.example",
      *         role: "viewer",
@@ -88,8 +93,9 @@ class InvitesClient {
         return core.HttpResponsePromise.fromPromise(this.__createInvite(request, requestOptions));
     }
     async __createInvite(request, requestOptions) {
+        const { "Idempotency-Key": idempotencyKey, ..._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)) ??
@@ -99,7 +105,7 @@ class InvitesClient {
             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,
@@ -111,10 +117,14 @@ class InvitesClient {
         }
         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 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/invites/client/requests/CreateInviteRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
  *         email: "ali@nizam.ai",
  *         role: "admin"
@@ -8,6 +9,7 @@
  *
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
  *         email: "jordan@example.com",
  *         role: "dispatcher",
@@ -16,6 +18,7 @@
  *
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
  *         email: "auditor@partner.example",
  *         role: "viewer",
@@ -23,6 +26,8 @@
  *     }
  */
 export interface CreateInviteRequest {
+    /** 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;
     /** Organization the invite is for. */
     organization_id: string;
     /** Recipient email. */

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";

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

@@ -35,8 +35,6 @@ export declare class OrganizationsClient {
     /**
      * Creates a brand-new tenant with the calling user as the founding admin. The id is assigned by Keycloak so the same value identifies the organization in both systems. Slug is derived from the name when not supplied.
      *
-     * Supports the standard `Idempotency-Key` header — submit a UUID (v4 recommended) per logical attempt (same value on retry); malformed keys are rejected with 400 `idempotency.invalid_key`. Successful responses and 4xx domain rejections replay for matching request bodies; transient 5xx responses are never cached, so retrying with the same key re-executes. Mismatching fingerprints surface as 409 `idempotency.key_conflict`.
-     *
      * @param {NizamDashboard.CreateOrganizationRequest} request
      * @param {OrganizationsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -50,11 +48,13 @@ export declare class OrganizationsClient {
      *
      * @example
      *     await client.organizations.createOrganization({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         name: "Acme Logistics"
      *     })
      *
      * @example
      *     await client.organizations.createOrganization({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         name: "Acme Logistics",
      *         slug: "acme-logistics",
      *         primary_domain: "acme.com",

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

@@ -125,8 +125,6 @@ class OrganizationsClient {
     /**
      * Creates a brand-new tenant with the calling user as the founding admin. The id is assigned by Keycloak so the same value identifies the organization in both systems. Slug is derived from the name when not supplied.
      *
-     * Supports the standard `Idempotency-Key` header — submit a UUID (v4 recommended) per logical attempt (same value on retry); malformed keys are rejected with 400 `idempotency.invalid_key`. Successful responses and 4xx domain rejections replay for matching request bodies; transient 5xx responses are never cached, so retrying with the same key re-executes. Mismatching fingerprints surface as 409 `idempotency.key_conflict`.
-     *
      * @param {NizamDashboard.CreateOrganizationRequest} request
      * @param {OrganizationsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -140,11 +138,13 @@ class OrganizationsClient {
      *
      * @example
      *     await client.organizations.createOrganization({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         name: "Acme Logistics"
      *     })
      *
      * @example
      *     await client.organizations.createOrganization({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         name: "Acme Logistics",
      *         slug: "acme-logistics",
      *         primary_domain: "acme.com",
@@ -158,8 +158,9 @@ class OrganizationsClient {
         return core.HttpResponsePromise.fromPromise(this.__createOrganization(request, requestOptions));
     }
     async __createOrganization(request, requestOptions) {
+        const { "Idempotency-Key": idempotencyKey, ..._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)) ??
@@ -169,7 +170,7 @@ class OrganizationsClient {
             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,

package/dist/api/resources/organizations/client/requests/CreateOrganizationRequest.d.ts

@@ -1,11 +1,13 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         name: "Acme Logistics"
  *     }
  *
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         name: "Acme Logistics",
  *         slug: "acme-logistics",
  *         primary_domain: "acme.com",
@@ -16,6 +18,8 @@
  *     }
  */
 export interface CreateOrganizationRequest {
+    /** 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;
     /** Display name of the organization. */
     name: string;
     /** Optional URL-safe slug. When omitted, the server derives one from the name. */

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

@@ -42,6 +42,7 @@ export declare class TaskAttemptsClient {
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
      * @throws {@link NizamDashboard.NotFoundError}
+     * @throws {@link NizamDashboard.ConflictError}
      * @throws {@link NizamDashboard.ContentTooLargeError}
      * @throws {@link NizamDashboard.UnprocessableEntityError}
      * @throws {@link NizamDashboard.TooManyRequestsError}
@@ -49,6 +50,7 @@ export declare class TaskAttemptsClient {
      *
      * @example
      *     await client.taskAttempts.captureTaskAttemptPhoto({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         attemptId: "00000000-0000-0000-0000-000000000000",
      *         filename: "delivery-door.jpg",
      *         content_type: "image/jpeg",

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

@@ -132,6 +132,7 @@ class TaskAttemptsClient {
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
      * @throws {@link NizamDashboard.NotFoundError}
+     * @throws {@link NizamDashboard.ConflictError}
      * @throws {@link NizamDashboard.ContentTooLargeError}
      * @throws {@link NizamDashboard.UnprocessableEntityError}
      * @throws {@link NizamDashboard.TooManyRequestsError}
@@ -139,6 +140,7 @@ class TaskAttemptsClient {
      *
      * @example
      *     await client.taskAttempts.captureTaskAttemptPhoto({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         attemptId: "00000000-0000-0000-0000-000000000000",
      *         filename: "delivery-door.jpg",
      *         content_type: "image/jpeg",
@@ -154,9 +156,9 @@ class TaskAttemptsClient {
         return core.HttpResponsePromise.fromPromise(this.__captureTaskAttemptPhoto(request, requestOptions));
     }
     async __captureTaskAttemptPhoto(request, requestOptions) {
-        const { attemptId, ..._body } = request;
+        const { attemptId, "Idempotency-Key": idempotencyKey, ..._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)) ??
@@ -186,6 +188,8 @@ class TaskAttemptsClient {
                     throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
                 case 404:
                     throw new NizamDashboard.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new NizamDashboard.ConflictError(_response.error.body, _response.rawResponse);
                 case 413:
                     throw new NizamDashboard.ContentTooLargeError(_response.error.body, _response.rawResponse);
                 case 422:

package/dist/api/resources/taskAttempts/client/requests/CaptureTaskAttemptPhotoRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         attemptId: "00000000-0000-0000-0000-000000000000",
  *         filename: "delivery-door.jpg",
  *         content_type: "image/jpeg",
@@ -14,6 +15,8 @@
  */
 export interface CaptureTaskAttemptPhotoRequest {
     attemptId: string;
+    /** 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;
     /** Original filename. */
     filename: string;
     /** Declared MIME type — POD photos accept image/jpeg, image/png, image/webp, image/heic, image/heif. */

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

@@ -88,6 +88,7 @@ export declare class UsersClient {
      * @param {NizamDashboard.InviteUserRequest} request
      * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link NizamDashboard.BadRequestError}
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
      * @throws {@link NizamDashboard.ConflictError}
@@ -97,12 +98,14 @@ export declare class UsersClient {
      *
      * @example
      *     await client.users.inviteUser({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         email: "newhire@acme.example",
      *         name: "New Hire"
      *     })
      *
      * @example
      *     await client.users.inviteUser({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         email: "newhire@acme.example"
      *     })
      */

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

@@ -271,6 +271,7 @@ class UsersClient {
      * @param {NizamDashboard.InviteUserRequest} request
      * @param {UsersClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link NizamDashboard.BadRequestError}
      * @throws {@link NizamDashboard.UnauthorizedError}
      * @throws {@link NizamDashboard.ForbiddenError}
      * @throws {@link NizamDashboard.ConflictError}
@@ -280,12 +281,14 @@ class UsersClient {
      *
      * @example
      *     await client.users.inviteUser({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         email: "newhire@acme.example",
      *         name: "New Hire"
      *     })
      *
      * @example
      *     await client.users.inviteUser({
+     *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
      *         email: "newhire@acme.example"
      *     })
      */
@@ -293,8 +296,9 @@ class UsersClient {
         return core.HttpResponsePromise.fromPromise(this.__inviteUser(request, requestOptions));
     }
     async __inviteUser(request, requestOptions) {
+        const { "Idempotency-Key": idempotencyKey, ..._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)) ??
@@ -304,7 +308,7 @@ class UsersClient {
             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,
@@ -316,6 +320,8 @@ class UsersClient {
         }
         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:

package/dist/api/resources/users/client/requests/InviteUserRequest.d.ts

@@ -1,16 +1,20 @@
 /**
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         email: "newhire@acme.example",
  *         name: "New Hire"
  *     }
  *
  * @example
  *     {
+ *         "Idempotency-Key": "9f1e6d2a-7c3b-4e5f-8a91-0b2c3d4e5f60",
  *         email: "newhire@acme.example"
  *     }
  */
 export interface InviteUserRequest {
+    /** 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;
     /** Recipient email. */
     email: string;
     /** Display name (optional). */

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

@@ -5,9 +5,9 @@ export interface Device {
     /** Device id. */
     id?: string | undefined;
     /** Push transport. */
-    platform?: string | undefined;
+    platform?: Device.Platform | undefined;
     /** Registration lifecycle. */
-    status?: string | undefined;
+    status?: Device.Status | undefined;
     /** When the device was first registered. */
     registered_at?: string | undefined;
     /** When the registration was last refreshed (last seen). */
@@ -16,6 +16,21 @@ export interface Device {
     object?: Device.Object_ | undefined;
 }
 export declare namespace Device {
+    /** Push transport. */
+    const Platform: {
+        readonly Ios: "ios";
+        readonly Android: "android";
+        readonly Web: "web";
+    };
+    type Platform = (typeof Platform)[keyof typeof Platform];
+    /** Registration lifecycle. */
+    const Status: {
+        readonly Active: "active";
+        readonly Suspended: "suspended";
+        readonly Inactive: "inactive";
+        readonly Expired: "expired";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
     /** Object type discriminator. */
     const Object_: {
         readonly Device: "device";

package/dist/api/types/Device.js

@@ -4,6 +4,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Device = void 0;
 var Device;
 (function (Device) {
+    /** Push transport. */
+    Device.Platform = {
+        Ios: "ios",
+        Android: "android",
+        Web: "web",
+    };
+    /** Registration lifecycle. */
+    Device.Status = {
+        Active: "active",
+        Suspended: "suspended",
+        Inactive: "inactive",
+        Expired: "expired",
+    };
     /** Object type discriminator. */
     Device.Object_ = {
         Device: "device",

package/package.json

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