@vitable-inc/vitable-connect 2.0.0 → 3.0.0

package/dist/esm/api/resources/members/client/Client.mjs

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
-import { mergeHeaders } from "../../../../core/headers.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
 import * as core from "../../../../core/index.mjs";
 import * as environments from "../../../../environments.mjs";
 import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
@@ -50,9 +50,9 @@ export class MembersClient {
     __get(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { member_id: memberId } = request;
+            const { member_id: memberId, "X-Vitable-Organization": vitableOrganization } = request;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}`),
                 method: "GET",
@@ -124,9 +124,9 @@ export class MembersClient {
     __listDependents(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { member_id: memberId } = request;
+            const { member_id: memberId, "X-Vitable-Organization": vitableOrganization } = request;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}/dependents`),
                 method: "GET",
@@ -201,9 +201,9 @@ export class MembersClient {
     __listEmployments(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { member_id: memberId } = request;
+            const { member_id: memberId, "X-Vitable-Organization": vitableOrganization } = request;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}/employments`),
                 method: "GET",
@@ -278,9 +278,9 @@ export class MembersClient {
     __listEnrollments(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { member_id: memberId } = request;
+            const { member_id: memberId, "X-Vitable-Organization": vitableOrganization } = request;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}/enrollments`),
                 method: "GET",
@@ -355,9 +355,9 @@ export class MembersClient {
     __getHousehold(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { member_id: memberId } = request;
+            const { member_id: memberId, "X-Vitable-Organization": vitableOrganization } = request;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}/household`),
                 method: "GET",
@@ -432,9 +432,9 @@ export class MembersClient {
     __listIdCards(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { member_id: memberId } = request;
+            const { member_id: memberId, "X-Vitable-Organization": vitableOrganization } = request;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}/id-cards`),
                 method: "GET",
@@ -509,14 +509,14 @@ export class MembersClient {
         return __awaiter(this, void 0, void 0, function* () {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { member_id: memberId, limit, page, status } = request;
+                const { member_id: memberId, limit, page, status, "X-Vitable-Organization": vitableOrganization, } = request;
                 const _queryParams = {
                     limit,
                     page,
                     status: status != null ? status : undefined,
                 };
                 const _authRequest = yield this._options.authProvider.getAuthRequest();
-                const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+                const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
                 const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                     url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, `v1/members/${core.url.encodePathParam(memberId)}/qualifying-life-events`),
                     method: "GET",
@@ -607,14 +607,14 @@ export class MembersClient {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { limit, page, search } = request;
+                const { limit, page, search, "X-Vitable-Organization": vitableOrganization } = request;
                 const _queryParams = {
                     limit,
                     page,
                     search,
                 };
                 const _authRequest = yield this._options.authProvider.getAuthRequest();
-                const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+                const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Vitable-Organization": vitableOrganization }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
                 const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
                     url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.VitableConnectEnvironment.Production, "v2/members"),
                     method: "GET",

package/dist/esm/api/resources/members/client/requests/GetHouseholdMembersRequest.d.mts

@@ -7,4 +7,6 @@ import type * as VitableConnect from "../../../../index.mjs";
  */
 export interface GetHouseholdMembersRequest {
     member_id: VitableConnect.MemberId;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
 }

package/dist/esm/api/resources/members/client/requests/GetMembersRequest.d.mts

@@ -8,4 +8,6 @@ import type * as VitableConnect from "../../../../index.mjs";
 export interface GetMembersRequest {
     /** Unique member identifier (mbr_*) */
     member_id: VitableConnect.MemberId;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
 }

package/dist/esm/api/resources/members/client/requests/ListDependentsMembersRequest.d.mts

@@ -7,4 +7,6 @@ import type * as VitableConnect from "../../../../index.mjs";
  */
 export interface ListDependentsMembersRequest {
     member_id: VitableConnect.MemberId;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
 }

package/dist/esm/api/resources/members/client/requests/ListEmploymentsMembersRequest.d.mts

@@ -7,4 +7,6 @@ import type * as VitableConnect from "../../../../index.mjs";
  */
 export interface ListEmploymentsMembersRequest {
     member_id: VitableConnect.MemberId;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
 }

package/dist/esm/api/resources/members/client/requests/ListEnrollmentsMembersRequest.d.mts

@@ -7,4 +7,6 @@ import type * as VitableConnect from "../../../../index.mjs";
  */
 export interface ListEnrollmentsMembersRequest {
     member_id: VitableConnect.MemberId;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
 }

package/dist/esm/api/resources/members/client/requests/ListIdCardsMembersRequest.d.mts

@@ -7,4 +7,6 @@ import type * as VitableConnect from "../../../../index.mjs";
  */
 export interface ListIdCardsMembersRequest {
     member_id: VitableConnect.MemberId;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
 }

package/dist/esm/api/resources/members/client/requests/ListMembersRequest.d.mts

@@ -13,4 +13,6 @@ export interface ListMembersRequest {
     page?: VitableConnect.Page;
     /** Case-insensitive search across member name, email, and phone number; exact match on member id (prefixed or raw uuid) */
     search?: VitableConnect.MemberSearch;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
 }

package/dist/esm/api/resources/members/client/requests/ListQualifyingLifeEventsMembersRequest.d.mts

@@ -16,4 +16,6 @@ export interface ListQualifyingLifeEventsMembersRequest {
     page?: VitableConnect.Page;
     /** Optional. Filter to a single QLE status; omit to return all statuses. */
     status?: VitableConnect.Status;
+    /** Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`. */
+    "X-Vitable-Organization"?: VitableConnect.XVitableOrganization;
 }

package/dist/esm/api/resources/organizations/client/Client.d.mts

@@ -14,7 +14,7 @@ export declare class OrganizationsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<OrganizationsClient.Options>;
     constructor(options?: OrganizationsClient.Options);
     /**
-     * Lists the organizations the authenticated caller is an active member of (paginated). Returns an empty list when the caller belongs to no organizations.
+     * Lists the organizations the authenticated caller is an active member of (paginated), each with the role the caller holds in it. Returns an empty list when the caller belongs to no organizations.
      *
      * @param {OrganizationsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -35,7 +35,7 @@ export declare class OrganizationsClient {
     list(requestOptions?: OrganizationsClient.RequestOptions): core.HttpResponsePromise<VitableConnect.OrganizationsListResponse>;
     private __list;
     /**
-     * Onboards the authenticated user's partner Organization: creates the local Organization + the creator's admin membership atomically, then mirrors it to WorkOS (creates the WorkOS org and binds the creator as admin). 409 `organization_already_exists` when the user already has an organization (v0: one organization per user).
+     * Onboards the authenticated user's partner Organization: creates the local Organization + the creator's admin membership atomically, then mirrors it to WorkOS (creates the WorkOS org and binds the creator as admin). A user may hold several organizations and selects which one a request acts as with the `X-Vitable-Organization` header. The founder's email domain is claimed only when no other organization holds it, so a taken domain is left with its owner rather than rejected.
      *
      * @param {VitableConnect.CreateOrganizationRequest} request
      * @param {OrganizationsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/organizations/client/Client.mjs

@@ -24,7 +24,7 @@ export class OrganizationsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * Lists the organizations the authenticated caller is an active member of (paginated). Returns an empty list when the caller belongs to no organizations.
+     * Lists the organizations the authenticated caller is an active member of (paginated), each with the role the caller holds in it. Returns an empty list when the caller belongs to no organizations.
      *
      * @param {OrganizationsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -97,7 +97,7 @@ export class OrganizationsClient {
         });
     }
     /**
-     * Onboards the authenticated user's partner Organization: creates the local Organization + the creator's admin membership atomically, then mirrors it to WorkOS (creates the WorkOS org and binds the creator as admin). 409 `organization_already_exists` when the user already has an organization (v0: one organization per user).
+     * Onboards the authenticated user's partner Organization: creates the local Organization + the creator's admin membership atomically, then mirrors it to WorkOS (creates the WorkOS org and binds the creator as admin). A user may hold several organizations and selects which one a request acts as with the `X-Vitable-Organization` header. The founder's email domain is claimed only when no other organization holds it, so a taken domain is left with its owner rather than rejected.
      *
      * @param {VitableConnect.CreateOrganizationRequest} request
      * @param {OrganizationsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/organizations/client/requests/CreateOrganizationRequest.d.mts

@@ -10,5 +10,5 @@ export interface CreateOrganizationRequest {
     /** Legal or trading name of the organization. */
     name: string;
     /** Category of organization being onboarded. */
-    type?: VitableConnect.CreateOrganizationRequestType | null;
+    type?: VitableConnect.OrganizationType | null;
 }

package/dist/esm/api/types/OrganizationMembership.d.mts

@@ -0,0 +1,38 @@
+import type * as VitableConnect from "../index.mjs";
+export interface OrganizationMembership {
+    /** Prefixed organization identifier (`org_<base64-encoded-uuid>`). */
+    id: string;
+    /** Human-readable organization name. */
+    name: string;
+    /**
+     * Partner type (e.g. BROKERAGE, TPA).
+     *
+     * * `BROKERAGE` - Brokerage
+     * * `TPA` - TPA
+     * * `GENERAL_AGENT` - General Agent
+     * * `CHANNEL_PARTNER` - Channel Partner
+     * * `CONSULTING_FIRM` - Consulting Firm
+     * * `API_PLATFORM` - API Platform
+     */
+    type: VitableConnect.OrganizationType | null;
+    /** IdP-issued tenant id (WorkOS org id). */
+    idp_org_id: string | null;
+    /**
+     * IdP that minted idp_org_id (e.g. 'workos').
+     *
+     * * `workos` - WorkOS
+     * * `vitable` - Vitable
+     */
+    idp_provider: VitableConnect.IdpProvider | null;
+    /** Whether this organization reads across every organization. */
+    super_in: boolean;
+    /**
+     * The caller's role in this organization.
+     *
+     * * `ADMIN` - Admin
+     * * `OPERATIONS` - Operations
+     * * `SALES` - Sales
+     * * `ENROLLMENT_AGENT` - Enrollment Agent
+     */
+    role: VitableConnect.OrganizationUserRole;
+}

package/dist/esm/api/types/OrganizationMembership.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/OrganizationType.d.mts

@@ -1,10 +1,10 @@
 /**
- * * `BROKERAGE` - Brokerage
+ * * `BROKERAGE` - BROKERAGE
  * * `TPA` - TPA
- * * `GENERAL_AGENT` - General Agent
- * * `CHANNEL_PARTNER` - Channel Partner
- * * `CONSULTING_FIRM` - Consulting Firm
- * * `API_PLATFORM` - API Platform
+ * * `GENERAL_AGENT` - GENERAL_AGENT
+ * * `CHANNEL_PARTNER` - CHANNEL_PARTNER
+ * * `CONSULTING_FIRM` - CONSULTING_FIRM
+ * * `API_PLATFORM` - API_PLATFORM
  */
 export declare const OrganizationType: {
     readonly Brokerage: "BROKERAGE";

package/dist/esm/api/types/OrganizationType.mjs

@@ -1,11 +1,11 @@
 // This file was auto-generated by Fern from our API Definition.
 /**
- * * `BROKERAGE` - Brokerage
+ * * `BROKERAGE` - BROKERAGE
  * * `TPA` - TPA
- * * `GENERAL_AGENT` - General Agent
- * * `CHANNEL_PARTNER` - Channel Partner
- * * `CONSULTING_FIRM` - Consulting Firm
- * * `API_PLATFORM` - API Platform
+ * * `GENERAL_AGENT` - GENERAL_AGENT
+ * * `CHANNEL_PARTNER` - CHANNEL_PARTNER
+ * * `CONSULTING_FIRM` - CONSULTING_FIRM
+ * * `API_PLATFORM` - API_PLATFORM
  */
 export const OrganizationType = {
     Brokerage: "BROKERAGE",

package/dist/esm/api/types/OrganizationUserRole.d.mts

@@ -0,0 +1,13 @@
+/**
+ * * `ADMIN` - Admin
+ * * `OPERATIONS` - Operations
+ * * `SALES` - Sales
+ * * `ENROLLMENT_AGENT` - Enrollment Agent
+ */
+export declare const OrganizationUserRole: {
+    readonly Admin: "ADMIN";
+    readonly Operations: "OPERATIONS";
+    readonly Sales: "SALES";
+    readonly EnrollmentAgent: "ENROLLMENT_AGENT";
+};
+export type OrganizationUserRole = (typeof OrganizationUserRole)[keyof typeof OrganizationUserRole];

package/dist/esm/api/types/OrganizationUserRole.mjs

@@ -0,0 +1,13 @@
+// This file was auto-generated by Fern from our API Definition.
+/**
+ * * `ADMIN` - Admin
+ * * `OPERATIONS` - Operations
+ * * `SALES` - Sales
+ * * `ENROLLMENT_AGENT` - Enrollment Agent
+ */
+export const OrganizationUserRole = {
+    Admin: "ADMIN",
+    Operations: "OPERATIONS",
+    Sales: "SALES",
+    EnrollmentAgent: "ENROLLMENT_AGENT",
+};

package/dist/esm/api/types/OrganizationsListResponse.d.mts

@@ -4,7 +4,7 @@ import type * as VitableConnect from "../index.mjs";
  */
 export interface OrganizationsListResponse {
     /** This page of organizations. */
-    organizations: VitableConnect.Organization[];
+    organizations: VitableConnect.OrganizationMembership[];
     /** Total number of organizations the caller belongs to. */
     total: number;
 }

package/dist/esm/api/types/XVitableOrganization.d.mts

@@ -0,0 +1,4 @@
+/**
+ * Organization to act as for this request (e.g. `org_SGVsbG8gV29ybGQ`). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 `organization_required`. A malformed value returns 400 `invalid_organization_header`, and naming an organization you do not have access to returns 403 `organization_access_denied`.
+ */
+export type XVitableOrganization = string;

package/dist/esm/api/types/XVitableOrganization.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -32,7 +32,6 @@ export * from "./ContributionTier.mjs";
 export * from "./CoverageTier.mjs";
 export * from "./CreatedAfter.mjs";
 export * from "./CreatedBefore.mjs";
-export * from "./CreateOrganizationRequestType.mjs";
 export * from "./DeductionDetail.mjs";
 export * from "./DeductionFrequency.mjs";
 export * from "./DigitalBenefitCard.mjs";
@@ -135,8 +134,10 @@ export * from "./OrganizationEmployer.mjs";
 export * from "./OrganizationEmployerListResponse.mjs";
 export * from "./OrganizationHrisProvider.mjs";
 export * from "./OrganizationHrisProvidersResponse.mjs";
+export * from "./OrganizationMembership.mjs";
 export * from "./OrganizationsListResponse.mjs";
 export * from "./OrganizationType.mjs";
+export * from "./OrganizationUserRole.mjs";
 export * from "./Page.mjs";
 export * from "./Pagination.mjs";
 export * from "./PayrollAccessSetupStatus.mjs";
@@ -173,3 +174,4 @@ export * from "./WebhookDelivery.mjs";
 export * from "./WebhookEvent.mjs";
 export * from "./WebhookEventListResponse.mjs";
 export * from "./WebhookEventResponse.mjs";
+export * from "./XVitableOrganization.mjs";

package/dist/esm/api/types/index.mjs

@@ -32,7 +32,6 @@ export * from "./ContributionTier.mjs";
 export * from "./CoverageTier.mjs";
 export * from "./CreatedAfter.mjs";
 export * from "./CreatedBefore.mjs";
-export * from "./CreateOrganizationRequestType.mjs";
 export * from "./DeductionDetail.mjs";
 export * from "./DeductionFrequency.mjs";
 export * from "./DigitalBenefitCard.mjs";
@@ -135,8 +134,10 @@ export * from "./OrganizationEmployer.mjs";
 export * from "./OrganizationEmployerListResponse.mjs";
 export * from "./OrganizationHrisProvider.mjs";
 export * from "./OrganizationHrisProvidersResponse.mjs";
+export * from "./OrganizationMembership.mjs";
 export * from "./OrganizationsListResponse.mjs";
 export * from "./OrganizationType.mjs";
+export * from "./OrganizationUserRole.mjs";
 export * from "./Page.mjs";
 export * from "./Pagination.mjs";
 export * from "./PayrollAccessSetupStatus.mjs";
@@ -173,3 +174,4 @@ export * from "./WebhookDelivery.mjs";
 export * from "./WebhookEvent.mjs";
 export * from "./WebhookEventListResponse.mjs";
 export * from "./WebhookEventResponse.mjs";
+export * from "./XVitableOrganization.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.0";
+export declare const SDK_VERSION = "3.0.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "2.0.0";
+export const SDK_VERSION = "3.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vitable-inc/vitable-connect",
-    "version": "2.0.0",
+    "version": "3.0.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -1513,7 +1513,7 @@ await client.employers.updateSettings({
 </dl>
 </details>
 
-<details><summary><code>client.employers.<a href="/src/api/resources/employers/client/Client.ts">listHrisProviders</a>() -> VitableConnect.OrganizationHrisProvidersResponse</code></summary>
+<details><summary><code>client.employers.<a href="/src/api/resources/employers/client/Client.ts">listHrisProviders</a>({ ...params }) -> VitableConnect.OrganizationHrisProvidersResponse</code></summary>
 <dl>
 <dd>
 
@@ -1556,6 +1556,14 @@ await client.employers.listHrisProviders();
 <dl>
 <dd>
 
+**request:** `VitableConnect.ListHrisProvidersEmployersRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `EmployersClient.RequestOptions` 
     
 </dd>
@@ -2618,7 +2626,7 @@ const response = page.response;
 <dl>
 <dd>
 
-Lists the organizations the authenticated caller is an active member of (paginated). Returns an empty list when the caller belongs to no organizations.
+Lists the organizations the authenticated caller is an active member of (paginated), each with the role the caller holds in it. Returns an empty list when the caller belongs to no organizations.
 </dd>
 </dl>
 </dd>
@@ -2673,7 +2681,7 @@ await client.organizations.list();
 <dl>
 <dd>
 
-Onboards the authenticated user's partner Organization: creates the local Organization + the creator's admin membership atomically, then mirrors it to WorkOS (creates the WorkOS org and binds the creator as admin). 409 `organization_already_exists` when the user already has an organization (v0: one organization per user).
+Onboards the authenticated user's partner Organization: creates the local Organization + the creator's admin membership atomically, then mirrors it to WorkOS (creates the WorkOS org and binds the creator as admin). A user may hold several organizations and selects which one a request acts as with the `X-Vitable-Organization` header. The founder's email domain is claimed only when no other organization holds it, so a taken domain is left with its owner rather than rejected.
 </dd>
 </dl>
 </dd>

package/dist/cjs/api/types/CreateOrganizationRequestType.d.ts

@@ -1,17 +0,0 @@
-/**
- * * `BROKERAGE` - BROKERAGE
- * * `TPA` - TPA
- * * `GENERAL_AGENT` - GENERAL_AGENT
- * * `CHANNEL_PARTNER` - CHANNEL_PARTNER
- * * `CONSULTING_FIRM` - CONSULTING_FIRM
- * * `API_PLATFORM` - API_PLATFORM
- */
-export declare const CreateOrganizationRequestType: {
-    readonly Brokerage: "BROKERAGE";
-    readonly Tpa: "TPA";
-    readonly GeneralAgent: "GENERAL_AGENT";
-    readonly ChannelPartner: "CHANNEL_PARTNER";
-    readonly ConsultingFirm: "CONSULTING_FIRM";
-    readonly ApiPlatform: "API_PLATFORM";
-};
-export type CreateOrganizationRequestType = (typeof CreateOrganizationRequestType)[keyof typeof CreateOrganizationRequestType];

package/dist/cjs/api/types/CreateOrganizationRequestType.js

@@ -1,20 +0,0 @@
-"use strict";
-// This file was auto-generated by Fern from our API Definition.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateOrganizationRequestType = void 0;
-/**
- * * `BROKERAGE` - BROKERAGE
- * * `TPA` - TPA
- * * `GENERAL_AGENT` - GENERAL_AGENT
- * * `CHANNEL_PARTNER` - CHANNEL_PARTNER
- * * `CONSULTING_FIRM` - CONSULTING_FIRM
- * * `API_PLATFORM` - API_PLATFORM
- */
-exports.CreateOrganizationRequestType = {
-    Brokerage: "BROKERAGE",
-    Tpa: "TPA",
-    GeneralAgent: "GENERAL_AGENT",
-    ChannelPartner: "CHANNEL_PARTNER",
-    ConsultingFirm: "CONSULTING_FIRM",
-    ApiPlatform: "API_PLATFORM",
-};

package/dist/esm/api/types/CreateOrganizationRequestType.d.mts

@@ -1,17 +0,0 @@
-/**
- * * `BROKERAGE` - BROKERAGE
- * * `TPA` - TPA
- * * `GENERAL_AGENT` - GENERAL_AGENT
- * * `CHANNEL_PARTNER` - CHANNEL_PARTNER
- * * `CONSULTING_FIRM` - CONSULTING_FIRM
- * * `API_PLATFORM` - API_PLATFORM
- */
-export declare const CreateOrganizationRequestType: {
-    readonly Brokerage: "BROKERAGE";
-    readonly Tpa: "TPA";
-    readonly GeneralAgent: "GENERAL_AGENT";
-    readonly ChannelPartner: "CHANNEL_PARTNER";
-    readonly ConsultingFirm: "CONSULTING_FIRM";
-    readonly ApiPlatform: "API_PLATFORM";
-};
-export type CreateOrganizationRequestType = (typeof CreateOrganizationRequestType)[keyof typeof CreateOrganizationRequestType];

package/dist/esm/api/types/CreateOrganizationRequestType.mjs

@@ -1,17 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-/**
- * * `BROKERAGE` - BROKERAGE
- * * `TPA` - TPA
- * * `GENERAL_AGENT` - GENERAL_AGENT
- * * `CHANNEL_PARTNER` - CHANNEL_PARTNER
- * * `CONSULTING_FIRM` - CONSULTING_FIRM
- * * `API_PLATFORM` - API_PLATFORM
- */
-export const CreateOrganizationRequestType = {
-    Brokerage: "BROKERAGE",
-    Tpa: "TPA",
-    GeneralAgent: "GENERAL_AGENT",
-    ChannelPartner: "CHANNEL_PARTNER",
-    ConsultingFirm: "CONSULTING_FIRM",
-    ApiPlatform: "API_PLATFORM",
-};