@nizam-os/operator-sdk 5.0.0 → 6.0.0

package/dist/Client.d.ts

@@ -1,3 +1,4 @@
+import { AssetsClient } from "./api/resources/assets/client/Client.js";
 import { DevicesClient } from "./api/resources/devices/client/Client.js";
 import { FilesClient } from "./api/resources/files/client/Client.js";
 import { InvitesClient } from "./api/resources/invites/client/Client.js";
@@ -22,6 +23,7 @@ export declare class NizamOperatorRuntimeClient {
     protected _invites: InvitesClient | undefined;
     protected _lookups: LookupsClient | undefined;
     protected _users: UsersClient | undefined;
+    protected _assets: AssetsClient | undefined;
     protected _devices: DevicesClient | undefined;
     protected _positions: PositionsClient | undefined;
     protected _notificationPreferences: NotificationPreferencesClient | undefined;
@@ -33,6 +35,7 @@ export declare class NizamOperatorRuntimeClient {
     get invites(): InvitesClient;
     get lookups(): LookupsClient;
     get users(): UsersClient;
+    get assets(): AssetsClient;
     get devices(): DevicesClient;
     get positions(): PositionsClient;
     get notificationPreferences(): NotificationPreferencesClient;

package/dist/Client.js

@@ -35,16 +35,17 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NizamOperatorRuntimeClient = void 0;
-const Client_js_1 = require("./api/resources/devices/client/Client.js");
-const Client_js_2 = require("./api/resources/files/client/Client.js");
-const Client_js_3 = require("./api/resources/invites/client/Client.js");
-const Client_js_4 = require("./api/resources/lookups/client/Client.js");
-const Client_js_5 = require("./api/resources/notificationPreferences/client/Client.js");
-const Client_js_6 = require("./api/resources/notifications/client/Client.js");
-const Client_js_7 = require("./api/resources/positions/client/Client.js");
-const Client_js_8 = require("./api/resources/realtime/client/Client.js");
-const Client_js_9 = require("./api/resources/taskAttempts/client/Client.js");
-const Client_js_10 = require("./api/resources/users/client/Client.js");
+const Client_js_1 = require("./api/resources/assets/client/Client.js");
+const Client_js_2 = require("./api/resources/devices/client/Client.js");
+const Client_js_3 = require("./api/resources/files/client/Client.js");
+const Client_js_4 = require("./api/resources/invites/client/Client.js");
+const Client_js_5 = require("./api/resources/lookups/client/Client.js");
+const Client_js_6 = require("./api/resources/notificationPreferences/client/Client.js");
+const Client_js_7 = require("./api/resources/notifications/client/Client.js");
+const Client_js_8 = require("./api/resources/positions/client/Client.js");
+const Client_js_9 = require("./api/resources/realtime/client/Client.js");
+const Client_js_10 = require("./api/resources/taskAttempts/client/Client.js");
+const Client_js_11 = require("./api/resources/users/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class NizamOperatorRuntimeClient {
@@ -52,34 +53,37 @@ class NizamOperatorRuntimeClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     get files() {
-        return (this._files ?? (this._files = new Client_js_2.FilesClient(this._options)));
+        return (this._files ?? (this._files = new Client_js_3.FilesClient(this._options)));
     }
     get invites() {
-        return (this._invites ?? (this._invites = new Client_js_3.InvitesClient(this._options)));
+        return (this._invites ?? (this._invites = new Client_js_4.InvitesClient(this._options)));
     }
     get lookups() {
-        return (this._lookups ?? (this._lookups = new Client_js_4.LookupsClient(this._options)));
+        return (this._lookups ?? (this._lookups = new Client_js_5.LookupsClient(this._options)));
     }
     get users() {
-        return (this._users ?? (this._users = new Client_js_10.UsersClient(this._options)));
+        return (this._users ?? (this._users = new Client_js_11.UsersClient(this._options)));
+    }
+    get assets() {
+        return (this._assets ?? (this._assets = new Client_js_1.AssetsClient(this._options)));
     }
     get devices() {
-        return (this._devices ?? (this._devices = new Client_js_1.DevicesClient(this._options)));
+        return (this._devices ?? (this._devices = new Client_js_2.DevicesClient(this._options)));
     }
     get positions() {
-        return (this._positions ?? (this._positions = new Client_js_7.PositionsClient(this._options)));
+        return (this._positions ?? (this._positions = new Client_js_8.PositionsClient(this._options)));
     }
     get notificationPreferences() {
-        return (this._notificationPreferences ?? (this._notificationPreferences = new Client_js_5.NotificationPreferencesClient(this._options)));
+        return (this._notificationPreferences ?? (this._notificationPreferences = new Client_js_6.NotificationPreferencesClient(this._options)));
     }
     get notifications() {
-        return (this._notifications ?? (this._notifications = new Client_js_6.NotificationsClient(this._options)));
+        return (this._notifications ?? (this._notifications = new Client_js_7.NotificationsClient(this._options)));
     }
     get realtime() {
-        return (this._realtime ?? (this._realtime = new Client_js_8.RealtimeClient(this._options)));
+        return (this._realtime ?? (this._realtime = new Client_js_9.RealtimeClient(this._options)));
     }
     get taskAttempts() {
-        return (this._taskAttempts ?? (this._taskAttempts = new Client_js_9.TaskAttemptsClient(this._options)));
+        return (this._taskAttempts ?? (this._taskAttempts = new Client_js_10.TaskAttemptsClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

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

@@ -0,0 +1,54 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as NizamOperatorRuntime from "../../../index.js";
+export declare namespace AssetsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Universal physical-hardware master — vehicles, drones, robots, trailers, containers, equipment. Kind-discriminated.
+ */
+export declare class AssetsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AssetsClient.Options>;
+    constructor(options: AssetsClient.Options);
+    /**
+     * Returns the assets the authenticated operator is currently assigned to operate — and only those. Deny-by-default: an operator with no active assignment sees an empty list. Resolved through the narrow `operate` (assigned-operator) relation, never the owning-org `view` surface, so it never exposes a whole tenant. Ordered by `created_at` descending; bidirectional cursor pagination (`starting_after` / `ending_before`).
+     *
+     * @param {NizamOperatorRuntime.ListMyAssetsRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.assets.listMyAssets({
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listMyAssets(request?: NizamOperatorRuntime.ListMyAssetsRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamOperatorRuntime.OperatorAsset>;
+    private __listMyAssets;
+    /**
+     * Returns one asset the authenticated operator is assigned to operate. Resolved through the `operate` (assigned-operator) relation only — never the owning-org `view` surface. An asset the operator is not assigned to (or that does not exist) returns 404, indistinguishable from a missing id so the endpoint can't be used to probe for assets.
+     *
+     * @param {NizamOperatorRuntime.GetMyAssetRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.NotFoundError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.assets.getMyAsset({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    getMyAsset(request: NizamOperatorRuntime.GetMyAssetRequest, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<NizamOperatorRuntime.OperatorAsset>;
+    private __getMyAsset;
+}

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

@@ -0,0 +1,184 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssetsClient = void 0;
+const BaseClient_js_1 = require("../../../../BaseClient.js");
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
+const errors = __importStar(require("../../../../errors/index.js"));
+const NizamOperatorRuntime = __importStar(require("../../../index.js"));
+/**
+ * Universal physical-hardware master — vehicles, drones, robots, trailers, containers, equipment. Kind-discriminated.
+ */
+class AssetsClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Returns the assets the authenticated operator is currently assigned to operate — and only those. Deny-by-default: an operator with no active assignment sees an empty list. Resolved through the narrow `operate` (assigned-operator) relation, never the owning-org `view` surface, so it never exposes a whole tenant. Ordered by `created_at` descending; bidirectional cursor pagination (`starting_after` / `ending_before`).
+     *
+     * @param {NizamOperatorRuntime.ListMyAssetsRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.assets.listMyAssets({
+     *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+     *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+     *     })
+     */
+    listMyAssets(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listMyAssets(request, requestOptions));
+    }
+    async __listMyAssets(request = {}, requestOptions) {
+        const { limit, starting_after: startingAfter, ending_before: endingBefore } = request;
+        const _queryParams = {
+            limit,
+            starting_after: startingAfter,
+            ending_before: endingBefore,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamOperatorRuntimeEnvironment.Production, "v1/me/assets"),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new NizamOperatorRuntime.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamOperatorRuntime.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamOperatorRuntime.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamOperatorRuntime.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamOperatorRuntimeError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/me/assets");
+    }
+    /**
+     * Returns one asset the authenticated operator is assigned to operate. Resolved through the `operate` (assigned-operator) relation only — never the owning-org `view` surface. An asset the operator is not assigned to (or that does not exist) returns 404, indistinguishable from a missing id so the endpoint can't be used to probe for assets.
+     *
+     * @param {NizamOperatorRuntime.GetMyAssetRequest} request
+     * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamOperatorRuntime.UnauthorizedError}
+     * @throws {@link NizamOperatorRuntime.ForbiddenError}
+     * @throws {@link NizamOperatorRuntime.NotFoundError}
+     * @throws {@link NizamOperatorRuntime.TooManyRequestsError}
+     * @throws {@link NizamOperatorRuntime.InternalServerError}
+     *
+     * @example
+     *     await client.assets.getMyAsset({
+     *         id: "00000000-0000-0000-0000-000000000000"
+     *     })
+     */
+    getMyAsset(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getMyAsset(request, requestOptions));
+    }
+    async __getMyAsset(request, requestOptions) {
+        const { id } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamOperatorRuntimeEnvironment.Production, `v1/me/assets/${core.url.encodePathParam(id)}`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new NizamOperatorRuntime.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamOperatorRuntime.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new NizamOperatorRuntime.NotFoundError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new NizamOperatorRuntime.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamOperatorRuntime.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamOperatorRuntimeError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/me/assets/{id}");
+    }
+}
+exports.AssetsClient = AssetsClient;

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

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

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

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

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

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

package/dist/api/resources/assets/client/requests/GetMyAssetRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,15 @@
+/**
+ * @example
+ *     {
+ *         starting_after: "Y3Vyc29yX25leHRfMDFKNVE=",
+ *         ending_before: "Y3Vyc29yX25leHRfMDFKNVE="
+ *     }
+ */
+export interface ListMyAssetsRequest {
+    /** Page size. Default 20, maximum 100. Out-of-range values are silently clamped; the response body's `limit` field reflects what was applied. */
+    limit?: number;
+    /** Opaque cursor — return the page starting strictly after this entity in the sort order. Mutually exclusive with `ending_before`. */
+    starting_after?: string;
+    /** Opaque cursor — return the page ending strictly before this entity in the sort order. Mutually exclusive with `starting_after`. */
+    ending_before?: string;
+}

package/dist/api/resources/assets/client/requests/ListMyAssetsRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

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

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

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

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

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

package/dist/api/resources/assets/exports.js

@@ -0,0 +1,21 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssetsClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "AssetsClient", { enumerable: true, get: function () { return Client_js_1.AssetsClient; } });
+__exportStar(require("./client/index.js"), exports);

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

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

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

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

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

@@ -1,3 +1,5 @@
+export * from "./assets/client/requests/index.js";
+export * as assets from "./assets/index.js";
 export * from "./devices/client/requests/index.js";
 export * as devices from "./devices/index.js";
 export * from "./files/client/requests/index.js";

package/dist/api/resources/index.js

@@ -36,7 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.users = exports.taskAttempts = exports.realtime = exports.positions = exports.notifications = exports.notificationPreferences = exports.lookups = exports.invites = exports.files = exports.devices = void 0;
+exports.users = exports.taskAttempts = exports.realtime = exports.positions = exports.notifications = exports.notificationPreferences = exports.lookups = exports.invites = exports.files = exports.devices = exports.assets = void 0;
+__exportStar(require("./assets/client/requests/index.js"), exports);
+exports.assets = __importStar(require("./assets/index.js"));
 __exportStar(require("./devices/client/requests/index.js"), exports);
 exports.devices = __importStar(require("./devices/index.js"));
 __exportStar(require("./files/client/requests/index.js"), exports);

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

@@ -0,0 +1,13 @@
+/**
+ * Resolved human identity of an activity actor.
+ */
+export interface ActivityCauser {
+    /** Actor id — mirrors `causer_id`; null for system/scheduled rows. */
+    id?: string | undefined;
+    /** Actor type — mirrors `causer_type`; null for system/scheduled rows. */
+    type?: string | undefined;
+    /** Renderable actor label — the resolved name, or a stable "System" / "Unknown" fallback. Never null. */
+    display_name?: string | undefined;
+    /** Secondary line — a user's email; null for operators and system. */
+    subtitle?: string | undefined;
+}

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

@@ -1,3 +1,4 @@
+import type * as NizamOperatorRuntime from "../index.js";
 /**
  * One entry in an organization's activity feed (append-only audit timeline).
  */
@@ -18,6 +19,7 @@ export interface ActivityResource {
     causer_type?: string | undefined;
     /** Id of the actor that performed the action. Null for system/scheduled actions. */
     causer_id?: string | undefined;
+    causer: NizamOperatorRuntime.ActivityCauser;
     /** Optional UI filtering bucket. */
     log_name?: string | undefined;
     /** When the activity was recorded — the authoritative timestamp. */

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

@@ -0,0 +1,28 @@
+/**
+ * Create a new task.
+ */
+export interface CreateTaskRequest {
+    /** The kind of stop. */
+    type: CreateTaskRequest.Type;
+    /** Executor organization to delegate the task to (cross-org). Optional. */
+    executor_organization_id?: string | undefined;
+    /** Merchant the task belongs to. Optional. */
+    merchant_id?: string | undefined;
+    /** Free-form notes. */
+    notes?: string | undefined;
+}
+export declare namespace CreateTaskRequest {
+    /** The kind of stop. */
+    const Type: {
+        readonly Pickup: "pickup";
+        readonly Dropoff: "dropoff";
+        readonly Service: "service";
+        readonly Return: "return";
+        readonly Exchange: "exchange";
+        readonly EndAtHub: "end_at_hub";
+        readonly EndAtDriverAddress: "end_at_driver_address";
+        readonly RouteLoad: "route_load";
+        readonly Break: "break";
+    };
+    type Type = (typeof Type)[keyof typeof Type];
+}

package/dist/api/types/CreateTaskRequest.js

@@ -0,0 +1,19 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateTaskRequest = void 0;
+var CreateTaskRequest;
+(function (CreateTaskRequest) {
+    /** The kind of stop. */
+    CreateTaskRequest.Type = {
+        Pickup: "pickup",
+        Dropoff: "dropoff",
+        Service: "service",
+        Return: "return",
+        Exchange: "exchange",
+        EndAtHub: "end_at_hub",
+        EndAtDriverAddress: "end_at_driver_address",
+        RouteLoad: "route_load",
+        Break: "break",
+    };
+})(CreateTaskRequest || (exports.CreateTaskRequest = CreateTaskRequest = {}));

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

@@ -0,0 +1,27 @@
+import type * as NizamOperatorRuntime from "../index.js";
+/**
+ * Envelope for paginated list responses (opaque cursor pagination).
+ */
+export interface ListResponseTask {
+    /** Object type discriminator. Always `list` for this envelope. */
+    object?: ListResponseTask.Object_ | undefined;
+    /** Page of resources. Empty array when there are no matches. */
+    data?: NizamOperatorRuntime.Task[] | undefined;
+    /** True when more pages exist; pass `next_cursor` as `?starting_after=` to fetch the next page. */
+    has_more?: boolean | undefined;
+    /** True when earlier pages exist; pass `prev_cursor` as `?ending_before=` to fetch the previous page. */
+    has_previous?: boolean | undefined;
+    /** Opaque cursor for the next page. `null` on the last page. */
+    next_cursor?: string | undefined;
+    /** Opaque cursor for the previous page. `null` on the first page. */
+    prev_cursor?: string | undefined;
+    /** Page size that produced this response. */
+    limit?: number | undefined;
+}
+export declare namespace ListResponseTask {
+    /** Object type discriminator. Always `list` for this envelope. */
+    const Object_: {
+        readonly List: "list";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/ListResponseTask.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListResponseTask = void 0;
+var ListResponseTask;
+(function (ListResponseTask) {
+    /** Object type discriminator. Always `list` for this envelope. */
+    ListResponseTask.Object_ = {
+        List: "list",
+    };
+})(ListResponseTask || (exports.ListResponseTask = ListResponseTask = {}));

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

@@ -0,0 +1,64 @@
+/**
+ * An asset as seen by an operator assigned to operate it — the operational identity fields, without the dashboard's lifecycle-management hints.
+ */
+export interface OperatorAsset {
+    /** Stable UUID. */
+    id: string;
+    /** Top-level kind. */
+    kind: OperatorAsset.Kind;
+    /** Sub-kind within the kind (free-form). */
+    sub_kind?: string | undefined;
+    /** SAE J3016 autonomy level 0..5. */
+    autonomy_level?: number | undefined;
+    /** Lifecycle status. */
+    status: OperatorAsset.Status;
+    /** Display name. */
+    name?: string | undefined;
+    /** Vehicle Identification Number. */
+    vin?: string | undefined;
+    /** License plate. */
+    plate_number?: string | undefined;
+    /** Manufacturer. */
+    make?: string | undefined;
+    /** Model designation. */
+    model?: string | undefined;
+    /** Model year. */
+    year?: number | undefined;
+    /** Owning organization id. */
+    organization_id?: string | undefined;
+    /** Current primary operator (active assignment, role=primary). */
+    current_primary_operator_id?: string | undefined;
+    /** Object type discriminator. */
+    object: OperatorAsset.Object_;
+}
+export declare namespace OperatorAsset {
+    /** Top-level kind. */
+    const Kind: {
+        readonly GroundVehicle: "ground_vehicle";
+        readonly AerialVehicle: "aerial_vehicle";
+        readonly MarineVehicle: "marine_vehicle";
+        readonly Robot: "robot";
+        readonly Agv: "agv";
+        readonly Trailer: "trailer";
+        readonly Container: "container";
+        readonly Pallet: "pallet";
+        readonly Equipment: "equipment";
+    };
+    type Kind = (typeof Kind)[keyof typeof Kind];
+    /** Lifecycle status. */
+    const Status: {
+        readonly Active: "active";
+        readonly Maintenance: "maintenance";
+        readonly OutOfService: "out_of_service";
+        readonly Retired: "retired";
+        readonly Sold: "sold";
+        readonly Inactive: "inactive";
+        readonly Lost: "lost";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+    /** Object type discriminator. */
+    const Object_: {
+        readonly Asset: "asset";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/OperatorAsset.js

@@ -0,0 +1,33 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperatorAsset = void 0;
+var OperatorAsset;
+(function (OperatorAsset) {
+    /** Top-level kind. */
+    OperatorAsset.Kind = {
+        GroundVehicle: "ground_vehicle",
+        AerialVehicle: "aerial_vehicle",
+        MarineVehicle: "marine_vehicle",
+        Robot: "robot",
+        Agv: "agv",
+        Trailer: "trailer",
+        Container: "container",
+        Pallet: "pallet",
+        Equipment: "equipment",
+    };
+    /** Lifecycle status. */
+    OperatorAsset.Status = {
+        Active: "active",
+        Maintenance: "maintenance",
+        OutOfService: "out_of_service",
+        Retired: "retired",
+        Sold: "sold",
+        Inactive: "inactive",
+        Lost: "lost",
+    };
+    /** Object type discriminator. */
+    OperatorAsset.Object_ = {
+        Asset: "asset",
+    };
+})(OperatorAsset || (exports.OperatorAsset = OperatorAsset = {}));

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

@@ -0,0 +1,41 @@
+/**
+ * A unit of work — the reference resource for per-verb relationship authorization.
+ */
+export interface Task {
+    /** Stable UUID. */
+    id: string;
+    /** The kind of stop. */
+    type: Task.Type;
+    /** Free-form notes (the editable content). */
+    notes?: string | undefined;
+    /** Owning organization id. */
+    organization_id: string;
+    /** Executor organization the task is delegated to (cross-org), if any. */
+    executor_organization_id?: string | undefined;
+    /** Merchant the task belongs to, if any. */
+    merchant_id?: string | undefined;
+    /** The user who created (owns) the task — the SpiceDB `task#owner`. */
+    owner_id?: string | undefined;
+    /** Object type discriminator. */
+    object: Task.Object_;
+}
+export declare namespace Task {
+    /** The kind of stop. */
+    const Type: {
+        readonly Pickup: "pickup";
+        readonly Dropoff: "dropoff";
+        readonly Service: "service";
+        readonly Return: "return";
+        readonly Exchange: "exchange";
+        readonly EndAtHub: "end_at_hub";
+        readonly EndAtDriverAddress: "end_at_driver_address";
+        readonly RouteLoad: "route_load";
+        readonly Break: "break";
+    };
+    type Type = (typeof Type)[keyof typeof Type];
+    /** Object type discriminator. */
+    const Object_: {
+        readonly Task: "task";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/Task.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.Task = void 0;
+var Task;
+(function (Task) {
+    /** The kind of stop. */
+    Task.Type = {
+        Pickup: "pickup",
+        Dropoff: "dropoff",
+        Service: "service",
+        Return: "return",
+        Exchange: "exchange",
+        EndAtHub: "end_at_hub",
+        EndAtDriverAddress: "end_at_driver_address",
+        RouteLoad: "route_load",
+        Break: "break",
+    };
+    /** Object type discriminator. */
+    Task.Object_ = {
+        Task: "task",
+    };
+})(Task || (exports.Task = Task = {}));

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

@@ -0,0 +1,7 @@
+/**
+ * Update a task (set-only partial update).
+ */
+export interface UpdateTaskRequest {
+    /** Free-form notes. */
+    notes?: string | undefined;
+}

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

@@ -9,6 +9,8 @@ export interface User {
     /** Keycloak Organization id the user belongs to. Null for cross-tenant platform admins. */
     organization_id?: string | undefined;
     roles: string[];
+    /** The caller's effective permission ids for the active organization (epic #317): the union of catalog grants for every role they hold. Gate actions on these (`can("asset:create")`) rather than role strings, so frontend and backend reference the one catalog and cannot drift. Coarse and instance-independent; per-instance authority ('may delete THIS asset') is enforced server-side at the mutation, never precomputed here. */
+    permissions: User.Permissions.Item[];
     /** Email shadowed from Keycloak. Null until the user completes a profile. */
     email?: string | undefined;
     /** Display name shadowed from Keycloak. */
@@ -34,6 +36,28 @@ export declare namespace User {
         readonly Admin: "admin";
     };
     type Portal = (typeof Portal)[keyof typeof Portal];
+    type Permissions = Permissions.Item[];
+    namespace Permissions {
+        const Item: {
+            readonly ActivityReadAll: "activity:read:all";
+            readonly AssetCreate: "asset:create";
+            readonly AssetDelete: "asset:delete";
+            readonly AssetDispose: "asset:dispose";
+            readonly AssetExport: "asset:export";
+            readonly AssetImport: "asset:import";
+            readonly AssetRead: "asset:read";
+            readonly AssetTransition: "asset:transition";
+            readonly AssetUpdate: "asset:update";
+            readonly KeycloakProjectionAdminister: "keycloak-projection:administer";
+            readonly NotificationDeliveryRead: "notification-delivery:read";
+            readonly OrgMaintenanceAdminister: "org-maintenance:administer";
+            readonly ServiceAccountAdminister: "service-account:administer";
+            readonly TaskCreate: "task:create";
+            readonly UserAdminister: "user:administer";
+            readonly UserInvite: "user:invite";
+        };
+        type Item = (typeof Item)[keyof typeof Item];
+    }
     /** Object type discriminator. */
     const Object_: {
         readonly User: "user";

package/dist/api/types/User.js

@@ -14,6 +14,27 @@ var User;
         PlatformStaff: "platform_staff",
         Admin: "admin",
     };
+    let Permissions;
+    (function (Permissions) {
+        Permissions.Item = {
+            ActivityReadAll: "activity:read:all",
+            AssetCreate: "asset:create",
+            AssetDelete: "asset:delete",
+            AssetDispose: "asset:dispose",
+            AssetExport: "asset:export",
+            AssetImport: "asset:import",
+            AssetRead: "asset:read",
+            AssetTransition: "asset:transition",
+            AssetUpdate: "asset:update",
+            KeycloakProjectionAdminister: "keycloak-projection:administer",
+            NotificationDeliveryRead: "notification-delivery:read",
+            OrgMaintenanceAdminister: "org-maintenance:administer",
+            ServiceAccountAdminister: "service-account:administer",
+            TaskCreate: "task:create",
+            UserAdminister: "user:administer",
+            UserInvite: "user:invite",
+        };
+    })(Permissions = User.Permissions || (User.Permissions = {}));
     /** Object type discriminator. */
     User.Object_ = {
         User: "user",

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

@@ -1,4 +1,5 @@
 export * from "./ActiveOrganization.js";
+export * from "./ActivityCauser.js";
 export * from "./ActivityResource.js";
 export * from "./AllowedTransitions.js";
 export * from "./AllowedTransitionsRequest.js";
@@ -17,6 +18,7 @@ export * from "./CreateImportRequest.js";
 export * from "./CreateInviteRequest.js";
 export * from "./CreateOperatorRequest.js";
 export * from "./CreateOrganizationRequest.js";
+export * from "./CreateTaskRequest.js";
 export * from "./CreateTeleoperatedOperatorRequest.js";
 export * from "./Currency.js";
 export * from "./Device.js";
@@ -51,6 +53,7 @@ export * from "./ListResponseNotificationDeadLetter.js";
 export * from "./ListResponseOperatorPosition.js";
 export * from "./ListResponseOrganization.js";
 export * from "./ListResponsePosition.js";
+export * from "./ListResponseTask.js";
 export * from "./ListResponseTimezone.js";
 export * from "./ListResponseUserResource.js";
 export * from "./Membership.js";
@@ -69,6 +72,7 @@ export * from "./NotificationsMarkedRead.js";
 export * from "./NotificationUnreadCount.js";
 export * from "./OpenAssignmentRequest.js";
 export * from "./Operator.js";
+export * from "./OperatorAsset.js";
 export * from "./OperatorPosition.js";
 export * from "./Organization.js";
 export * from "./Position.js";
@@ -77,11 +81,13 @@ export * from "./QuietHours.js";
 export * from "./RealtimeTicket.js";
 export * from "./ReconcileResponse.js";
 export * from "./SetActiveOrganizationRequest.js";
+export * from "./Task.js";
 export * from "./TaskAttemptPhoto.js";
 export * from "./TaskAttemptPhotoThumbnail.js";
 export * from "./Timezone.js";
 export * from "./UpdateAssetRequest.js";
 export * from "./UpdateOrganizationRequest.js";
+export * from "./UpdateTaskRequest.js";
 export * from "./UploadInitiation.js";
 export * from "./UploadInitiationPart.js";
 export * from "./User.js";

package/dist/api/types/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ActiveOrganization.js"), exports);
+__exportStar(require("./ActivityCauser.js"), exports);
 __exportStar(require("./ActivityResource.js"), exports);
 __exportStar(require("./AllowedTransitions.js"), exports);
 __exportStar(require("./AllowedTransitionsRequest.js"), exports);
@@ -33,6 +34,7 @@ __exportStar(require("./CreateImportRequest.js"), exports);
 __exportStar(require("./CreateInviteRequest.js"), exports);
 __exportStar(require("./CreateOperatorRequest.js"), exports);
 __exportStar(require("./CreateOrganizationRequest.js"), exports);
+__exportStar(require("./CreateTaskRequest.js"), exports);
 __exportStar(require("./CreateTeleoperatedOperatorRequest.js"), exports);
 __exportStar(require("./Currency.js"), exports);
 __exportStar(require("./Device.js"), exports);
@@ -67,6 +69,7 @@ __exportStar(require("./ListResponseNotificationDeadLetter.js"), exports);
 __exportStar(require("./ListResponseOperatorPosition.js"), exports);
 __exportStar(require("./ListResponseOrganization.js"), exports);
 __exportStar(require("./ListResponsePosition.js"), exports);
+__exportStar(require("./ListResponseTask.js"), exports);
 __exportStar(require("./ListResponseTimezone.js"), exports);
 __exportStar(require("./ListResponseUserResource.js"), exports);
 __exportStar(require("./Membership.js"), exports);
@@ -85,6 +88,7 @@ __exportStar(require("./NotificationsMarkedRead.js"), exports);
 __exportStar(require("./NotificationUnreadCount.js"), exports);
 __exportStar(require("./OpenAssignmentRequest.js"), exports);
 __exportStar(require("./Operator.js"), exports);
+__exportStar(require("./OperatorAsset.js"), exports);
 __exportStar(require("./OperatorPosition.js"), exports);
 __exportStar(require("./Organization.js"), exports);
 __exportStar(require("./Position.js"), exports);
@@ -93,11 +97,13 @@ __exportStar(require("./QuietHours.js"), exports);
 __exportStar(require("./RealtimeTicket.js"), exports);
 __exportStar(require("./ReconcileResponse.js"), exports);
 __exportStar(require("./SetActiveOrganizationRequest.js"), exports);
+__exportStar(require("./Task.js"), exports);
 __exportStar(require("./TaskAttemptPhoto.js"), exports);
 __exportStar(require("./TaskAttemptPhotoThumbnail.js"), exports);
 __exportStar(require("./Timezone.js"), exports);
 __exportStar(require("./UpdateAssetRequest.js"), exports);
 __exportStar(require("./UpdateOrganizationRequest.js"), exports);
+__exportStar(require("./UpdateTaskRequest.js"), exports);
 __exportStar(require("./UploadInitiation.js"), exports);
 __exportStar(require("./UploadInitiationPart.js"), exports);
 __exportStar(require("./User.js"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nizam-os/operator-sdk",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "Nizam Operator API SDK for TypeScript / JavaScript.",
   "license": "MIT",
   "private": false,