@nizam-os/dashboard-sdk 4.0.0 → 4.2.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/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>;
@@ -16,6 +16,8 @@ export declare class OrganizationsClient {
     /**
      * Creates a brand-new tenant with the calling user as the founding admin. The id is assigned by Keycloak so the same value identifies the organization in both systems. Slug is derived from the name when not supplied.
      *
+     * Supports the standard `Idempotency-Key` header — submit a UUID v4 per logical attempt (same value on retry). Cached responses replay for matching request bodies; mismatching fingerprints surface as 409 `idempotency.key_conflict`.
+     *
      * @param {NizamDashboard.CreateOrganizationRequest} request
      * @param {OrganizationsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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) {
@@ -52,6 +52,8 @@ class OrganizationsClient {
     /**
      * Creates a brand-new tenant with the calling user as the founding admin. The id is assigned by Keycloak so the same value identifies the organization in both systems. Slug is derived from the name when not supplied.
      *
+     * Supports the standard `Idempotency-Key` header — submit a UUID v4 per logical attempt (same value on retry). Cached responses replay for matching request bodies; mismatching fingerprints surface as 409 `idempotency.key_conflict`.
+     *
      * @param {NizamDashboard.CreateOrganizationRequest} request
      * @param {OrganizationsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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/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/MembershipDriftResponse.d.ts

@@ -0,0 +1,13 @@
+/**
+ * One org with divergent membership sets.
+ */
+export interface MembershipDriftResponse {
+    /** Nizam organization id. */
+    organization_id?: string | undefined;
+    /** Matching Keycloak organization id. */
+    keycloak_id?: string | undefined;
+    /** User ids present in the Nizam member set but not in KC. */
+    in_nizam_only?: string[] | undefined;
+    /** User ids present in the KC member set but not in Nizam. */
+    in_kc_only?: string[] | undefined;
+}

package/dist/api/types/MembershipDriftResponse.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/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;
@@ -16,6 +16,8 @@ export interface Organization {
     owner_user_id?: string | undefined;
     /** When this organization was created. */
     created_at?: string | undefined;
+    /** Populated ONLY on the POST /v1/organizations create response — the active organization id Nizam pinned for the founder as part of the same transaction that created the org. Null on every other endpoint (GET, list, membership embeds). Per issue #67 phase 1, the SPA writes its active-org cookie from this field instead of issuing a follow-up PATCH /v1/me/active-organization. */
+    active_organization_id?: string | undefined;
     /** Object type discriminator (Stripe pattern). */
     object?: Organization.Object_ | undefined;
 }

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

@@ -0,0 +1,12 @@
+import type * as NizamDashboard from "../index.js";
+/**
+ * Drift report for a single aggregate reconciliation.
+ */
+export interface ReconcileResponse {
+    /** Nizam org ids whose stored keycloak_id no longer resolves on the KC side. */
+    nizam_has_kc_missing?: string[] | undefined;
+    /** KC org ids with no matching Nizam organizations.keycloak_id row. */
+    kc_has_nizam_missing?: string[] | undefined;
+    /** Per-org membership-set divergences (KC vs Nizam). */
+    membership_divergent?: NizamDashboard.MembershipDriftResponse[] | undefined;
+}

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

@@ -1,3 +1,4 @@
+export * from "./ActiveOrganization.js";
 export * from "./ApiFieldError.js";
 export * from "./Asset.js";
 export * from "./Assignment.js";
@@ -19,9 +20,12 @@ export * from "./ListResponseMembership.js";
 export * from "./ListResponseTimezone.js";
 export * from "./ListResponseUserResource.js";
 export * from "./Membership.js";
+export * from "./MembershipChoice.js";
+export * from "./MembershipDriftResponse.js";
 export * from "./Operator.js";
 export * from "./Organization.js";
 export * from "./ProblemDetail.js";
+export * from "./ReconcileResponse.js";
 export * from "./Timezone.js";
 export * from "./User.js";
 export * from "./UserResource.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,9 +36,12 @@ __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("./MembershipDriftResponse.js"), exports);
 __exportStar(require("./Operator.js"), exports);
 __exportStar(require("./Organization.js"), exports);
 __exportStar(require("./ProblemDetail.js"), exports);
+__exportStar(require("./ReconcileResponse.js"), exports);
 __exportStar(require("./Timezone.js"), exports);
 __exportStar(require("./User.js"), exports);
 __exportStar(require("./UserResource.js"), exports);

package/dist/core/fetcher/getResponseBody.js

@@ -3,6 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getResponseBody = getResponseBody;
 const json_js_1 = require("../json.js");
 const BinaryResponse_js_1 = require("./BinaryResponse.js");
+// Pins the upstream Response so undici's FinalizationRegistry can't GC it and cancel the body stream.
+function retainResponse(target, response) {
+    Object.defineProperty(target, "__fern_response_ref", {
+        value: response,
+        enumerable: false,
+        configurable: true,
+        writable: false,
+    });
+}
 async function getResponseBody(response, responseType) {
     switch (responseType) {
         case "binary-response":
@@ -21,6 +30,7 @@ async function getResponseBody(response, responseType) {
                     },
                 };
             }
+            retainResponse(response.body, response);
             return response.body;
         case "streaming":
             if (response.body == null) {
@@ -32,6 +42,7 @@ async function getResponseBody(response, responseType) {
                     },
                 };
             }
+            retainResponse(response.body, response);
             return response.body;
         case "text":
             return await response.text();

package/package.json

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