@nizam-os/dashboard-sdk 3.0.0 → 4.1.0

package/dist/Client.d.ts

@@ -1,3 +1,4 @@
+import { ActiveOrganizationClient } from "./api/resources/activeOrganization/client/Client.js";
 import { AssetsClient } from "./api/resources/assets/client/Client.js";
 import { AssignmentsClient } from "./api/resources/assignments/client/Client.js";
 import { InvitesClient } from "./api/resources/invites/client/Client.js";
@@ -21,6 +22,7 @@ export declare class NizamDashboardClient {
     protected _invites: InvitesClient | undefined;
     protected _lookups: LookupsClient | undefined;
     protected _users: UsersClient | undefined;
+    protected _activeOrganization: ActiveOrganizationClient | undefined;
     protected _memberships: MembershipsClient | undefined;
     protected _operators: OperatorsClient | undefined;
     protected _organizations: OrganizationsClient | undefined;
@@ -30,6 +32,7 @@ export declare class NizamDashboardClient {
     get invites(): InvitesClient;
     get lookups(): LookupsClient;
     get users(): UsersClient;
+    get activeOrganization(): ActiveOrganizationClient;
     get memberships(): MembershipsClient;
     get operators(): OperatorsClient;
     get organizations(): OrganizationsClient;

package/dist/Client.js

@@ -35,14 +35,15 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NizamDashboardClient = void 0;
-const Client_js_1 = require("./api/resources/assets/client/Client.js");
-const Client_js_2 = require("./api/resources/assignments/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/memberships/client/Client.js");
-const Client_js_6 = require("./api/resources/operators/client/Client.js");
-const Client_js_7 = require("./api/resources/organizations/client/Client.js");
-const Client_js_8 = require("./api/resources/users/client/Client.js");
+const Client_js_1 = require("./api/resources/activeOrganization/client/Client.js");
+const Client_js_2 = require("./api/resources/assets/client/Client.js");
+const Client_js_3 = require("./api/resources/assignments/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/memberships/client/Client.js");
+const Client_js_7 = require("./api/resources/operators/client/Client.js");
+const Client_js_8 = require("./api/resources/organizations/client/Client.js");
+const Client_js_9 = require("./api/resources/users/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class NizamDashboardClient {
@@ -50,28 +51,31 @@ class NizamDashboardClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     get assets() {
-        return (this._assets ?? (this._assets = new Client_js_1.AssetsClient(this._options)));
+        return (this._assets ?? (this._assets = new Client_js_2.AssetsClient(this._options)));
     }
     get assignments() {
-        return (this._assignments ?? (this._assignments = new Client_js_2.AssignmentsClient(this._options)));
+        return (this._assignments ?? (this._assignments = new Client_js_3.AssignmentsClient(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_8.UsersClient(this._options)));
+        return (this._users ?? (this._users = new Client_js_9.UsersClient(this._options)));
+    }
+    get activeOrganization() {
+        return (this._activeOrganization ?? (this._activeOrganization = new Client_js_1.ActiveOrganizationClient(this._options)));
     }
     get memberships() {
-        return (this._memberships ?? (this._memberships = new Client_js_5.MembershipsClient(this._options)));
+        return (this._memberships ?? (this._memberships = new Client_js_6.MembershipsClient(this._options)));
     }
     get operators() {
-        return (this._operators ?? (this._operators = new Client_js_6.OperatorsClient(this._options)));
+        return (this._operators ?? (this._operators = new Client_js_7.OperatorsClient(this._options)));
     }
     get organizations() {
-        return (this._organizations ?? (this._organizations = new Client_js_7.OrganizationsClient(this._options)));
+        return (this._organizations ?? (this._organizations = new Client_js_8.OrganizationsClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

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

@@ -0,0 +1,61 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as NizamDashboard from "../../../index.js";
+export declare namespace ActiveOrganizationClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Get and set the caller's preferred active organization — server-side cross-session memory of the picker choice (#65).
+ */
+export declare class ActiveOrganizationClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<ActiveOrganizationClient.Options>;
+    constructor(options: ActiveOrganizationClient.Options);
+    /**
+     * Returns the active organization the request was actually scoped to, the caller's stored
+     * preference, and the full memberships list. SPA bootstrap uses this to decide post-login
+     * routing without making three separate calls.
+     *
+     * The returned `active_organization_id` mirrors the principal's already-resolved scope —
+     * the value the active-org enricher pinned on this request, after consulting the
+     * X-Nizam-Organization header (if any), the stored preference, and the active memberships.
+     *
+     * @param {ActiveOrganizationClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.activeOrganization.getActiveOrganization()
+     */
+    getActiveOrganization(requestOptions?: ActiveOrganizationClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ActiveOrganization>;
+    private __getActiveOrganization;
+    /**
+     * Persists the caller's "remembered active org" preference. The slug must name an
+     * organization the caller is currently an active member of — otherwise the call fails
+     * with `403 tenant.not_a_member` (same code the X-Nizam-Organization header path uses),
+     * never silently writes the preference for an inaccessible org.
+     *
+     * On success, returns the new bundled state in one round-trip. The cached
+     * membership context for the caller is invalidated so the next request sees the new
+     * preference immediately.
+     *
+     * @param {NizamDashboard.SetActiveOrganizationRequest} request
+     * @param {ActiveOrganizationClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.UnprocessableEntityError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.activeOrganization.setActiveOrganization({
+     *         slug: "acme-logistics"
+     *     })
+     */
+    setActiveOrganization(request: NizamDashboard.SetActiveOrganizationRequest, requestOptions?: ActiveOrganizationClient.RequestOptions): core.HttpResponsePromise<NizamDashboard.ActiveOrganization>;
+    private __setActiveOrganization;
+}

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

@@ -0,0 +1,179 @@
+"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.ActiveOrganizationClient = 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 NizamDashboard = __importStar(require("../../../index.js"));
+/**
+ * Get and set the caller's preferred active organization — server-side cross-session memory of the picker choice (#65).
+ */
+class ActiveOrganizationClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Returns the active organization the request was actually scoped to, the caller's stored
+     * preference, and the full memberships list. SPA bootstrap uses this to decide post-login
+     * routing without making three separate calls.
+     *
+     * The returned `active_organization_id` mirrors the principal's already-resolved scope —
+     * the value the active-org enricher pinned on this request, after consulting the
+     * X-Nizam-Organization header (if any), the stored preference, and the active memberships.
+     *
+     * @param {ActiveOrganizationClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.activeOrganization.getActiveOrganization()
+     */
+    getActiveOrganization(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getActiveOrganization(requestOptions));
+    }
+    async __getActiveOrganization(requestOptions) {
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamDashboardEnvironment.Production, "v1/me/active-organization"),
+            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 NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/me/active-organization");
+    }
+    /**
+     * Persists the caller's "remembered active org" preference. The slug must name an
+     * organization the caller is currently an active member of — otherwise the call fails
+     * with `403 tenant.not_a_member` (same code the X-Nizam-Organization header path uses),
+     * never silently writes the preference for an inaccessible org.
+     *
+     * On success, returns the new bundled state in one round-trip. The cached
+     * membership context for the caller is invalidated so the next request sees the new
+     * preference immediately.
+     *
+     * @param {NizamDashboard.SetActiveOrganizationRequest} request
+     * @param {ActiveOrganizationClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link NizamDashboard.UnauthorizedError}
+     * @throws {@link NizamDashboard.ForbiddenError}
+     * @throws {@link NizamDashboard.UnprocessableEntityError}
+     * @throws {@link NizamDashboard.InternalServerError}
+     *
+     * @example
+     *     await client.activeOrganization.setActiveOrganization({
+     *         slug: "acme-logistics"
+     *     })
+     */
+    setActiveOrganization(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__setActiveOrganization(request, requestOptions));
+    }
+    async __setActiveOrganization(request, requestOptions) {
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.NizamDashboardEnvironment.Production, "v1/me/active-organization"),
+            method: "PATCH",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: request,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new NizamDashboard.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 403:
+                    throw new NizamDashboard.ForbiddenError(_response.error.body, _response.rawResponse);
+                case 422:
+                    throw new NizamDashboard.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                case 500:
+                    throw new NizamDashboard.InternalServerError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.NizamDashboardError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/v1/me/active-organization");
+    }
+}
+exports.ActiveOrganizationClient = ActiveOrganizationClient;

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

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

package/dist/api/resources/activeOrganization/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/activeOrganization/client/requests/SetActiveOrganizationRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         slug: "acme-logistics"
+ *     }
+ */
+export interface SetActiveOrganizationRequest {
+    /** Slug of the organization to make active. Must match an active membership. */
+    slug: string;
+}

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

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

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

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

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

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

package/dist/api/resources/activeOrganization/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.ActiveOrganizationClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "ActiveOrganizationClient", { enumerable: true, get: function () { return Client_js_1.ActiveOrganizationClient; } });
+__exportStar(require("./client/index.js"), exports);

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

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

package/dist/api/resources/activeOrganization/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 "./activeOrganization/client/requests/index.js";
+export * as activeOrganization from "./activeOrganization/index.js";
 export * from "./assets/client/requests/index.js";
 export * as assets from "./assets/index.js";
 export * from "./assignments/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.organizations = exports.operators = exports.memberships = exports.lookups = exports.invites = exports.assignments = exports.assets = void 0;
+exports.users = exports.organizations = exports.operators = exports.memberships = exports.lookups = exports.invites = exports.assignments = exports.assets = exports.activeOrganization = void 0;
+__exportStar(require("./activeOrganization/client/requests/index.js"), exports);
+exports.activeOrganization = __importStar(require("./activeOrganization/index.js"));
 __exportStar(require("./assets/client/requests/index.js"), exports);
 exports.assets = __importStar(require("./assets/index.js"));
 __exportStar(require("./assignments/client/requests/index.js"), exports);

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

@@ -28,7 +28,7 @@ export declare class InvitesClient {
      *     await client.invites.createInvite({
      *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         email: "ali@nizam.ai",
-     *         role: "super_admin",
+     *         role: "dispatcher",
      *         ttl_days: 7
      *     })
      */

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

@@ -64,7 +64,7 @@ class InvitesClient {
      *     await client.invites.createInvite({
      *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
      *         email: "ali@nizam.ai",
-     *         role: "super_admin",
+     *         role: "dispatcher",
      *         ttl_days: 7
      *     })
      */

package/dist/api/resources/invites/client/requests/CreateInviteRequest.d.ts

@@ -3,7 +3,7 @@
  *     {
  *         organization_id: "8f55f0eb-7d3a-4f2c-9c8d-a1b2c3d4e5f6",
  *         email: "ali@nizam.ai",
- *         role: "super_admin",
+ *         role: "dispatcher",
  *         ttl_days: 7
  *     }
  */
@@ -12,15 +12,14 @@ export interface CreateInviteRequest {
     organization_id: string;
     /** Recipient email. */
     email: string;
-    /** Role the recipient will hold after acceptance. Lowercase enum names from MembershipRole. */
+    /** Role the recipient will hold after acceptance. */
     role: CreateInviteRequest.Role;
     /** TTL in days. Defaults to 7. */
     ttl_days?: number;
 }
 export declare namespace CreateInviteRequest {
-    /** Role the recipient will hold after acceptance. Lowercase enum names from MembershipRole. */
+    /** Role the recipient will hold after acceptance. */
     const Role: {
-        readonly SuperAdmin: "super_admin";
         readonly Admin: "admin";
         readonly Dispatcher: "dispatcher";
         readonly Manager: "manager";

package/dist/api/resources/invites/client/requests/CreateInviteRequest.js

@@ -4,9 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateInviteRequest = void 0;
 var CreateInviteRequest;
 (function (CreateInviteRequest) {
-    /** Role the recipient will hold after acceptance. Lowercase enum names from MembershipRole. */
+    /** Role the recipient will hold after acceptance. */
     CreateInviteRequest.Role = {
-        SuperAdmin: "super_admin",
         Admin: "admin",
         Dispatcher: "dispatcher",
         Manager: "manager",

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

@@ -8,7 +8,7 @@ export declare namespace OrganizationsClient {
     }
 }
 /**
- * Organization aggregate — tenant CRUD.
+ * Tenants — the top-level container for users, merchants, and operations.
  */
 export declare class OrganizationsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<OrganizationsClient.Options>;

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

@@ -43,7 +43,7 @@ const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatu
 const errors = __importStar(require("../../../../errors/index.js"));
 const NizamDashboard = __importStar(require("../../../index.js"));
 /**
- * Organization aggregate — tenant CRUD.
+ * Tenants — the top-level container for users, merchants, and operations.
  */
 class OrganizationsClient {
     constructor(options) {

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

@@ -0,0 +1,21 @@
+import type * as NizamDashboard from "../index.js";
+/**
+ * The caller's resolved active organization, stored preference, and full list of memberships.
+ */
+export interface ActiveOrganization {
+    /** ID of the organization the request was actually scoped to. Null when the caller has no active memberships. */
+    active_organization_id?: string | undefined;
+    /** 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?: NizamDashboard.MembershipChoice[] | undefined;
+    /** Object type discriminator (Stripe pattern). */
+    object?: ActiveOrganization.Object_ | undefined;
+}
+export declare namespace ActiveOrganization {
+    /** Object type discriminator (Stripe pattern). */
+    const Object_: {
+        readonly ActiveOrganization: "active_organization";
+    };
+    type Object_ = (typeof Object_)[keyof typeof Object_];
+}

package/dist/api/types/ActiveOrganization.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.ActiveOrganization = void 0;
+var ActiveOrganization;
+(function (ActiveOrganization) {
+    /** Object type discriminator (Stripe pattern). */
+    ActiveOrganization.Object_ = {
+        ActiveOrganization: "active_organization",
+    };
+})(ActiveOrganization || (exports.ActiveOrganization = ActiveOrganization = {}));

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

@@ -22,7 +22,6 @@ export interface Invite {
 export declare namespace Invite {
     /** Role the recipient will hold after acceptance. */
     const Role: {
-        readonly SuperAdmin: "super_admin";
         readonly Admin: "admin";
         readonly Dispatcher: "dispatcher";
         readonly Manager: "manager";

package/dist/api/types/Invite.js

@@ -6,7 +6,6 @@ var Invite;
 (function (Invite) {
     /** Role the recipient will hold after acceptance. */
     Invite.Role = {
-        SuperAdmin: "super_admin",
         Admin: "admin",
         Dispatcher: "dispatcher",
         Manager: "manager",

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

@@ -12,7 +12,6 @@ export interface Membership {
 export declare namespace Membership {
     /** The user's role in this organization. */
     const Role: {
-        readonly SuperAdmin: "super_admin";
         readonly Admin: "admin";
         readonly Dispatcher: "dispatcher";
         readonly Manager: "manager";

package/dist/api/types/Membership.js

@@ -6,7 +6,6 @@ var Membership;
 (function (Membership) {
     /** The user's role in this organization. */
     Membership.Role = {
-        SuperAdmin: "super_admin",
         Admin: "admin",
         Dispatcher: "dispatcher",
         Manager: "manager",

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

@@ -0,0 +1,25 @@
+/**
+ * One of the caller's active memberships — surfaced in the organization.select_required picker body.
+ */
+export interface MembershipChoice {
+    /** Stable id of the organization. */
+    organization_id?: string | undefined;
+    /** URL-safe handle for the organization. */
+    slug?: string | undefined;
+    /** Display name. */
+    name?: string | undefined;
+    /** The caller's role in this organization. Lowercase enum names from MembershipRole. */
+    role?: MembershipChoice.Role | undefined;
+}
+export declare namespace MembershipChoice {
+    /** The caller's role in this organization. Lowercase enum names from MembershipRole. */
+    const Role: {
+        readonly Admin: "admin";
+        readonly Dispatcher: "dispatcher";
+        readonly Manager: "manager";
+        readonly Staff: "staff";
+        readonly Viewer: "viewer";
+        readonly BillingAdmin: "billing_admin";
+    };
+    type Role = (typeof Role)[keyof typeof Role];
+}

package/dist/api/types/MembershipChoice.js

@@ -0,0 +1,16 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MembershipChoice = void 0;
+var MembershipChoice;
+(function (MembershipChoice) {
+    /** The caller's role in this organization. Lowercase enum names from MembershipRole. */
+    MembershipChoice.Role = {
+        Admin: "admin",
+        Dispatcher: "dispatcher",
+        Manager: "manager",
+        Staff: "staff",
+        Viewer: "viewer",
+        BillingAdmin: "billing_admin",
+    };
+})(MembershipChoice || (exports.MembershipChoice = MembershipChoice = {}));

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

@@ -2,7 +2,7 @@
  * A tenant — a logistics company, 3PL, or LSP.
  */
 export interface Organization {
-    /** Stable UUID. Equal to the Keycloak Organization id. */
+    /** Stable UUID owned by Nizam. Pin this value in URLs and external integrations. The matching Keycloak Organization is tracked server-side via a separate keycloak_id bridge and is not exposed over the SDK; do not assume the two ids are equal. */
     id?: string | undefined;
     /** Display name. */
     name?: string | undefined;

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

@@ -1,3 +1,4 @@
+export * from "./ActiveOrganization.js";
 export * from "./ApiFieldError.js";
 export * from "./Asset.js";
 export * from "./Assignment.js";
@@ -19,6 +20,7 @@ export * from "./ListResponseMembership.js";
 export * from "./ListResponseTimezone.js";
 export * from "./ListResponseUserResource.js";
 export * from "./Membership.js";
+export * from "./MembershipChoice.js";
 export * from "./Operator.js";
 export * from "./Organization.js";
 export * from "./ProblemDetail.js";

package/dist/api/types/index.js

@@ -14,6 +14,7 @@ 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("./ActiveOrganization.js"), exports);
 __exportStar(require("./ApiFieldError.js"), exports);
 __exportStar(require("./Asset.js"), exports);
 __exportStar(require("./Assignment.js"), exports);
@@ -35,6 +36,7 @@ __exportStar(require("./ListResponseMembership.js"), exports);
 __exportStar(require("./ListResponseTimezone.js"), exports);
 __exportStar(require("./ListResponseUserResource.js"), exports);
 __exportStar(require("./Membership.js"), exports);
+__exportStar(require("./MembershipChoice.js"), exports);
 __exportStar(require("./Operator.js"), exports);
 __exportStar(require("./Organization.js"), exports);
 __exportStar(require("./ProblemDetail.js"), exports);

package/package.json

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