@nizam-os/dashboard-sdk 8.1.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/notifications/client/Client.d.ts

@@ -14,7 +14,7 @@ export declare class NotificationsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<NotificationsClient.Options>;
     constructor(options: NotificationsClient.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.
@@ -27,6 +27,8 @@ export declare class NotificationsClient {
      *
      * @example
      *     await client.notifications.listNotifications({
+     *         status: "<string>",
+     *         q: "<string>",
      *         since: "2026-05-20T14:00:00Z",
      *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
      *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
@@ -34,6 +36,38 @@ export declare class NotificationsClient {
      */
     listNotifications(request?: NizamDashboard.ListNotificationsRequest, requestOptions?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ListResponseNotification>;
     private __listNotifications;
+    /**
+     * 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?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.NotificationsArchived>;
+    private __archiveAllNotifications;
+    /**
+     * 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?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.NotificationCounts>;
+    private __getNotificationCounts;
     /**
      * 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).
      *
@@ -51,7 +85,7 @@ export declare class NotificationsClient {
     markAllNotificationsRead(requestOptions?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.NotificationsMarkedRead>;
     private __markAllNotificationsRead;
     /**
-     * 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.
      *
@@ -66,6 +100,25 @@ export declare class NotificationsClient {
      */
     getUnreadNotificationCount(requestOptions?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.NotificationUnreadCount>;
     private __getUnreadNotificationCount;
+    /**
+     * 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: NizamDashboard.ArchiveNotificationRequest, requestOptions?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Notification>;
+    private __archiveNotification;
     /**
      * 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.
      *
@@ -85,4 +138,42 @@ export declare class NotificationsClient {
      */
     markNotificationRead(request: NizamDashboard.MarkNotificationReadRequest, requestOptions?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Notification>;
     private __markNotificationRead;
+    /**
+     * 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: NizamDashboard.UnarchiveNotificationRequest, requestOptions?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Notification>;
+    private __unarchiveNotification;
+    /**
+     * 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: NizamDashboard.MarkNotificationUnreadRequest, requestOptions?: NotificationsClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.Notification>;
+    private __markNotificationUnread;
 }