@nizam-os/operator-sdk 3.0.0 → 5.0.0

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

@@ -11,7 +11,7 @@ export declare class FilesClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<FilesClient.Options>;
     constructor(options: FilesClient.Options);
     /**
-     * The active organization's files ordered by `created_at` descending (pass `sort=created_at` for ascending). `kind` / `status` accept comma-separated values; `subject_type` + `subject_id` narrow to the files documenting one business entity. Pagination is bidirectional (`starting_after` / `ending_before`).
+     * The active organization's files ordered by `created_at` descending by default. `kind` / `status` accept comma-separated values; `subject_type` + `subject_id` narrow to the files documenting one business entity. Pagination is bidirectional (`starting_after` / `ending_before`).
      *
      * @param {NizamOperatorRuntime.ListFilesRequest} request
      * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -41,6 +41,7 @@ export declare class FilesClient {
      * @throws {@link NizamOperatorRuntime.BadRequestError}
      * @throws {@link NizamOperatorRuntime.UnauthorizedError}
      * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.ConflictError}
      * @throws {@link NizamOperatorRuntime.ContentTooLargeError}
      * @throws {@link NizamOperatorRuntime.UnprocessableEntityError}
      * @throws {@link NizamOperatorRuntime.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

@@ -47,7 +47,7 @@ class FilesClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * The active organization's files ordered by `created_at` descending (pass `sort=created_at` for ascending). `kind` / `status` accept comma-separated values; `subject_type` + `subject_id` narrow to the files documenting one business entity. Pagination is bidirectional (`starting_after` / `ending_before`).
+     * The active organization's files ordered by `created_at` descending by default. `kind` / `status` accept comma-separated values; `subject_type` + `subject_id` narrow to the files documenting one business entity. Pagination is bidirectional (`starting_after` / `ending_before`).
      *
      * @param {NizamOperatorRuntime.ListFilesRequest} request
      * @param {FilesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -72,11 +72,11 @@ class FilesClient {
     async __listFiles(request = {}, requestOptions) {
         const { kind, status, subject_type: subjectType, subject_id: subjectId, sort, limit, starting_after: startingAfter, ending_before: endingBefore, } = request;
         const _queryParams = {
-            kind,
-            status,
+            kind: Array.isArray(kind) ? kind.map((item) => item) : kind != null ? kind : undefined,
+            status: Array.isArray(status) ? status.map((item) => item) : status != null ? status : undefined,
             subject_type: subjectType,
             subject_id: subjectId,
-            sort,
+            sort: Array.isArray(sort) ? sort.map((item) => item) : sort != null ? sort : undefined,
             limit,
             starting_after: startingAfter,
             ending_before: endingBefore,
@@ -137,6 +137,7 @@ class FilesClient {
      * @throws {@link NizamOperatorRuntime.BadRequestError}
      * @throws {@link NizamOperatorRuntime.UnauthorizedError}
      * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.ConflictError}
      * @throws {@link NizamOperatorRuntime.ContentTooLargeError}
      * @throws {@link NizamOperatorRuntime.UnprocessableEntityError}
      * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
@@ -144,6 +145,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",
@@ -157,8 +159,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)) ??
@@ -168,7 +171,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,
@@ -189,6 +192,8 @@ class FilesClient {
                     throw new NizamOperatorRuntime.UnauthorizedError(_response.error.body, _response.rawResponse);
                 case 403:
                     throw new NizamOperatorRuntime.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new NizamOperatorRuntime.ConflictError(_response.error.body, _response.rawResponse);
                 case 413:
                     throw new NizamOperatorRuntime.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). */
@@ -36,6 +39,7 @@ export declare namespace InitiateFileUploadRequest {
         readonly ImportReport: "import_report";
         readonly SignedDocument: "signed_document";
         readonly ProductImage: "product_image";
+        readonly DataExport: "data_export";
     };
     type Kind = (typeof Kind)[keyof typeof Kind];
 }

package/dist/api/resources/files/client/requests/InitiateFileUploadRequest.js

@@ -13,5 +13,6 @@ var InitiateFileUploadRequest;
         ImportReport: "import_report",
         SignedDocument: "signed_document",
         ProductImage: "product_image",
+        DataExport: "data_export",
     };
 })(InitiateFileUploadRequest || (exports.InitiateFileUploadRequest = InitiateFileUploadRequest = {}));

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

@@ -1,3 +1,4 @@
+import type * as NizamOperatorRuntime from "../../../../index.js";
 /**
  * @example
  *     {
@@ -8,16 +9,16 @@
  *     }
  */
 export interface ListFilesRequest {
-    /** Filter by file kind. Comma-separated; values: `profile_picture`, `chat_attachment`, `task_pod_photo`, `import_source`, `import_report`, `signed_document`, `product_image`. */
-    kind?: string | string[];
-    /** Filter by lifecycle status. Comma-separated; values: `active`, `quarantined`, `deleted`. */
-    status?: string | string[];
+    /** Filter by file kind. Comma-separated; matched case-insensitively. */
+    kind?: NizamOperatorRuntime.ListFilesRequestKindItem | NizamOperatorRuntime.ListFilesRequestKindItem[];
+    /** Filter by lifecycle status. Comma-separated; matched case-insensitively. */
+    status?: NizamOperatorRuntime.ListFilesRequestStatusItem | NizamOperatorRuntime.ListFilesRequestStatusItem[];
     /** Filter by the documented entity's type (pairs with `subject_id`). */
     subject_type?: string;
     /** Filter by the documented entity's id (requires `subject_type`). */
     subject_id?: string;
-    /** Sort order. Allowed fields: `created_at`. Prefix a field with `-` for descending (e.g. `-created_at`); unknown fields are rejected with `400 validation_failed`. */
-    sort?: string | string[];
+    /** Sort order. Allowed fields: `created_at`. Append `:asc` or `:desc` to each field (direction required, e.g. `created_at:desc`), comma-separated for multi-sort; unknown fields or directions are rejected with `400 validation_failed`. */
+    sort?: NizamOperatorRuntime.ListFilesRequestSortItem | NizamOperatorRuntime.ListFilesRequestSortItem[];
     /** Page size. Default 20, maximum 100. Out-of-range values are silently clamped; the response body's `limit` field reflects what was applied. */
     limit?: number;
     /** Opaque cursor — return the page starting strictly after this entity in the sort order. Mutually exclusive with `ending_before`. */

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

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

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

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

package/dist/api/resources/files/types/ListFilesRequestKindItem.d.ts

@@ -0,0 +1,11 @@
+export declare const ListFilesRequestKindItem: {
+    readonly ProfilePicture: "profile_picture";
+    readonly ChatAttachment: "chat_attachment";
+    readonly TaskPodPhoto: "task_pod_photo";
+    readonly ImportSource: "import_source";
+    readonly ImportReport: "import_report";
+    readonly SignedDocument: "signed_document";
+    readonly ProductImage: "product_image";
+    readonly DataExport: "data_export";
+};
+export type ListFilesRequestKindItem = (typeof ListFilesRequestKindItem)[keyof typeof ListFilesRequestKindItem];

package/dist/api/resources/files/types/ListFilesRequestKindItem.js

@@ -0,0 +1,14 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListFilesRequestKindItem = void 0;
+exports.ListFilesRequestKindItem = {
+    ProfilePicture: "profile_picture",
+    ChatAttachment: "chat_attachment",
+    TaskPodPhoto: "task_pod_photo",
+    ImportSource: "import_source",
+    ImportReport: "import_report",
+    SignedDocument: "signed_document",
+    ProductImage: "product_image",
+    DataExport: "data_export",
+};

package/dist/api/resources/files/types/ListFilesRequestSortItem.d.ts

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

package/dist/api/resources/files/types/ListFilesRequestSortItem.js

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

package/dist/api/resources/files/types/ListFilesRequestStatusItem.d.ts

@@ -0,0 +1,6 @@
+export declare const ListFilesRequestStatusItem: {
+    readonly Active: "active";
+    readonly Quarantined: "quarantined";
+    readonly Deleted: "deleted";
+};
+export type ListFilesRequestStatusItem = (typeof ListFilesRequestStatusItem)[keyof typeof ListFilesRequestStatusItem];

package/dist/api/resources/files/types/ListFilesRequestStatusItem.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListFilesRequestStatusItem = void 0;
+exports.ListFilesRequestStatusItem = {
+    Active: "active",
+    Quarantined: "quarantined",
+    Deleted: "deleted",
+};

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

@@ -0,0 +1,3 @@
+export * from "./ListFilesRequestKindItem.js";
+export * from "./ListFilesRequestSortItem.js";
+export * from "./ListFilesRequestStatusItem.js";

package/dist/api/resources/files/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ListFilesRequestKindItem.js"), exports);
+__exportStar(require("./ListFilesRequestSortItem.js"), exports);
+__exportStar(require("./ListFilesRequestStatusItem.js"), exports);

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

@@ -2,6 +2,7 @@ export * from "./devices/client/requests/index.js";
 export * as devices from "./devices/index.js";
 export * from "./files/client/requests/index.js";
 export * as files from "./files/index.js";
+export * from "./files/types/index.js";
 export * from "./invites/client/requests/index.js";
 export * as invites from "./invites/index.js";
 export * as lookups from "./lookups/index.js";
@@ -9,6 +10,7 @@ export * from "./notificationPreferences/client/requests/index.js";
 export * as notificationPreferences from "./notificationPreferences/index.js";
 export * from "./notifications/client/requests/index.js";
 export * as notifications from "./notifications/index.js";
+export * from "./notifications/types/index.js";
 export * as positions from "./positions/index.js";
 export * as realtime from "./realtime/index.js";
 export * from "./taskAttempts/client/requests/index.js";

package/dist/api/resources/index.js

@@ -41,6 +41,7 @@ __exportStar(require("./devices/client/requests/index.js"), exports);
 exports.devices = __importStar(require("./devices/index.js"));
 __exportStar(require("./files/client/requests/index.js"), exports);
 exports.files = __importStar(require("./files/index.js"));
+__exportStar(require("./files/types/index.js"), exports);
 __exportStar(require("./invites/client/requests/index.js"), exports);
 exports.invites = __importStar(require("./invites/index.js"));
 exports.lookups = __importStar(require("./lookups/index.js"));
@@ -48,6 +49,7 @@ __exportStar(require("./notificationPreferences/client/requests/index.js"), expo
 exports.notificationPreferences = __importStar(require("./notificationPreferences/index.js"));
 __exportStar(require("./notifications/client/requests/index.js"), exports);
 exports.notifications = __importStar(require("./notifications/index.js"));
+__exportStar(require("./notifications/types/index.js"), exports);
 exports.positions = __importStar(require("./positions/index.js"));
 exports.realtime = __importStar(require("./realtime/index.js"));
 __exportStar(require("./taskAttempts/client/requests/index.js"), exports);

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). `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.
+     * The caller's own notifications ordered by `created_at` descending by default. `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 {NizamOperatorRuntime.ListNotificationsRequest} request
      * @param {NotificationsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -50,7 +50,7 @@ class NotificationsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * The caller's own notifications ordered by `created_at` descending (pass `sort=created_at` for ascending). `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.
+     * The caller's own notifications ordered by `created_at` descending by default. `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 {NizamOperatorRuntime.ListNotificationsRequest} request
      * @param {NotificationsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -81,7 +81,7 @@ class NotificationsClient {
             kind,
             q,
             since: since != null ? since : undefined,
-            sort,
+            sort: Array.isArray(sort) ? sort.map((item) => item) : sort != null ? sort : undefined,
             limit,
             starting_after: startingAfter,
             ending_before: endingBefore,

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

@@ -1,3 +1,4 @@
+import type * as NizamOperatorRuntime from "../../../../index.js";
 /**
  * @example
  *     {
@@ -19,8 +20,8 @@ export interface ListNotificationsRequest {
     q?: string;
     /** Only notifications created at/after this RFC 3339 instant. */
     since?: string;
-    /** Sort order. Allowed fields: `created_at`. Prefix a field with `-` for descending (e.g. `-created_at`); unknown fields are rejected with `400 validation_failed`. */
-    sort?: string | string[];
+    /** Sort order. Allowed fields: `created_at`. Append `:asc` or `:desc` to each field (direction required, e.g. `created_at:desc`), comma-separated for multi-sort; unknown fields or directions are rejected with `400 validation_failed`. */
+    sort?: NizamOperatorRuntime.ListNotificationsRequestSortItem | NizamOperatorRuntime.ListNotificationsRequestSortItem[];
     /** Page size. Default 20, maximum 100. Out-of-range values are silently clamped; the response body's `limit` field reflects what was applied. */
     limit?: number;
     /** Opaque cursor — return the page starting strictly after this entity in the sort order. Mutually exclusive with `ending_before`. */

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

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

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

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

package/dist/api/resources/notifications/types/ListNotificationsRequestSortItem.d.ts

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

package/dist/api/resources/notifications/types/ListNotificationsRequestSortItem.js

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

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

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

package/dist/api/resources/notifications/types/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ListNotificationsRequestSortItem.js"), exports);

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

@@ -42,6 +42,7 @@ export declare class TaskAttemptsClient {
      * @throws {@link NizamOperatorRuntime.UnauthorizedError}
      * @throws {@link NizamOperatorRuntime.ForbiddenError}
      * @throws {@link NizamOperatorRuntime.NotFoundError}
+     * @throws {@link NizamOperatorRuntime.ConflictError}
      * @throws {@link NizamOperatorRuntime.ContentTooLargeError}
      * @throws {@link NizamOperatorRuntime.UnprocessableEntityError}
      * @throws {@link NizamOperatorRuntime.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

@@ -135,6 +135,7 @@ class TaskAttemptsClient {
      * @throws {@link NizamOperatorRuntime.UnauthorizedError}
      * @throws {@link NizamOperatorRuntime.ForbiddenError}
      * @throws {@link NizamOperatorRuntime.NotFoundError}
+     * @throws {@link NizamOperatorRuntime.ConflictError}
      * @throws {@link NizamOperatorRuntime.ContentTooLargeError}
      * @throws {@link NizamOperatorRuntime.UnprocessableEntityError}
      * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
@@ -142,6 +143,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",
@@ -157,9 +159,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)) ??
@@ -192,6 +194,8 @@ class TaskAttemptsClient {
                     throw new NizamOperatorRuntime.ForbiddenError(_response.error.body, _response.rawResponse);
                 case 404:
                     throw new NizamOperatorRuntime.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new NizamOperatorRuntime.ConflictError(_response.error.body, _response.rawResponse);
                 case 413:
                     throw new NizamOperatorRuntime.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/types/ActiveOrganization.d.ts

@@ -8,9 +8,9 @@ export interface ActiveOrganization {
     /** Stored preference (users.last_active_organization_id). Null when the user has never picked. */
     preferred_organization_id?: string | undefined;
     /** All active memberships for the picker UI. */
-    memberships?: NizamOperatorRuntime.MembershipChoice[] | undefined;
+    memberships: NizamOperatorRuntime.MembershipChoice[];
     /** Object type discriminator. */
-    object?: ActiveOrganization.Object_ | undefined;
+    object: ActiveOrganization.Object_;
 }
 export declare namespace ActiveOrganization {
     /** Object type discriminator. */

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

@@ -3,13 +3,13 @@
  */
 export interface ActivityResource {
     /** Stable UUID of this activity row — the resource id and pagination key. */
-    id?: string | undefined;
+    id: string;
     /** Per-publication idempotency key — equal to the realtime ActivityFeedItem's `id` for the same event, so a client can dedupe realtime against REST. Null for directly-written audit rows. */
     event_id?: string | undefined;
     /** Canonical event verb. */
     event?: ActivityResource.Event | undefined;
     /** Human-readable narrative shown in the feed UI. */
-    description?: string | undefined;
+    description: string;
     /** Type of the entity the action targeted (polymorphic subject). */
     subject_type?: string | undefined;
     /** Id of the entity the action targeted. */
@@ -21,9 +21,9 @@ export interface ActivityResource {
     /** Optional UI filtering bucket. */
     log_name?: string | undefined;
     /** When the activity was recorded — the authoritative timestamp. */
-    occurred_at?: string | undefined;
+    occurred_at: string;
     /** Object type discriminator. */
-    object?: ActivityResource.Object_ | undefined;
+    object: ActivityResource.Object_;
 }
 export declare namespace ActivityResource {
     /** Canonical event verb. */

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

@@ -0,0 +1,28 @@
+/**
+ * The lifecycle status transitions legal for an entire asset selection.
+ */
+export interface AllowedTransitions {
+    /** Statuses every selected asset may move to next (the intersection of their legal-transition sets); empty if they share none. */
+    allowed_transitions: AllowedTransitions.AllowedTransitions.Item[];
+    object: AllowedTransitions.Object_;
+}
+export declare namespace AllowedTransitions {
+    type AllowedTransitions = AllowedTransitions.Item[];
+    namespace AllowedTransitions {
+        /** A legal next status. */
+        const Item: {
+            readonly Active: "active";
+            readonly Maintenance: "maintenance";
+            readonly OutOfService: "out_of_service";
+            readonly Retired: "retired";
+            readonly Sold: "sold";
+            readonly Inactive: "inactive";
+            readonly Lost: "lost";
+        };
+        type Item = (typeof Item)[keyof typeof Item];
+    }
+    const Object_: {
+        readonly AllowedTransitions: "allowed_transitions";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/AllowedTransitions.js

@@ -0,0 +1,23 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AllowedTransitions = void 0;
+var AllowedTransitions;
+(function (AllowedTransitions_1) {
+    let AllowedTransitions;
+    (function (AllowedTransitions) {
+        /** A legal next status. */
+        AllowedTransitions.Item = {
+            Active: "active",
+            Maintenance: "maintenance",
+            OutOfService: "out_of_service",
+            Retired: "retired",
+            Sold: "sold",
+            Inactive: "inactive",
+            Lost: "lost",
+        };
+    })(AllowedTransitions = AllowedTransitions_1.AllowedTransitions || (AllowedTransitions_1.AllowedTransitions = {}));
+    AllowedTransitions_1.Object_ = {
+        AllowedTransitions: "allowed_transitions",
+    };
+})(AllowedTransitions || (exports.AllowedTransitions = AllowedTransitions = {}));

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

@@ -0,0 +1,7 @@
+/**
+ * Asset ids whose common legal status transitions to compute.
+ */
+export interface AllowedTransitionsRequest {
+    /** The selected asset ids. */
+    ids: string[];
+}

package/dist/api/types/AllowedTransitionsRequest.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/types/ApiFieldError.d.ts

@@ -1,5 +1,5 @@
 /**
- * One field-level entry inside a 422 validation problem.
+ * One field-level error entry — present on 422 validation failures and on field-level 409 conflicts.
  */
 export interface ApiFieldError {
     /** Dot-notated JSON path matching the request shape. */