@fern-api/venus-api-sdk 11.7.0 → 12.0.0

package/dist/cjs/serialization/types/TooManyRequestsErrorBodyContentCode.js

@@ -0,0 +1,39 @@
+"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.TooManyRequestsErrorBodyContentCode = void 0;
+const core = __importStar(require("../../core/index.js"));
+exports.TooManyRequestsErrorBodyContentCode = core.serialization.enum_(["RATE_LIMITED"]);

package/dist/cjs/serialization/types/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./Active.js";
+export * from "./ClaimGuestSessionResponse.js";
+export * from "./ClaimGuestSessionResponseStatus.js";
 export * from "./ClaimOrganizationRequest.js";
 export * from "./ClaimOrganizationResponse.js";
 export * from "./ClaimPreviewResponse.js";
@@ -8,14 +10,25 @@ export * from "./ClaimTokenResponse.js";
 export * from "./CreateGuestSessionResponse.js";
 export * from "./CreateOrganizationResponse.js";
 export * from "./CreateTokenResponse.js";
+export * from "./DeleteGuestSessionResponse.js";
+export * from "./DeleteGuestSessionResponseStatus.js";
 export * from "./Expired.js";
+export * from "./GetGuestSessionResponse.js";
+export * from "./GetGuestSessionResponseStatus.js";
+export * from "./GoneErrorBody.js";
+export * from "./GoneErrorBodyContent.js";
+export * from "./GoneErrorBodyContentCode.js";
 export * from "./GuestSessionLimits.js";
+export * from "./GuestSessionUsage.js";
 export * from "./HttpValidationError.js";
 export * from "./JwtResponse.js";
 export * from "./LightweightUser.js";
 export * from "./LinkAccountsResponse.js";
 export * from "./Maven.js";
 export * from "./MavenRegistryToken.js";
+export * from "./NotFoundErrorBody.js";
+export * from "./NotFoundErrorBodyContent.js";
+export * from "./NotFoundErrorBodyContentCode.js";
 export * from "./Npm.js";
 export * from "./NpmRegistryToken.js";
 export * from "./Organization.js";
@@ -26,8 +39,14 @@ export * from "./PypiRegistryToken.js";
 export * from "./RegistryToken.js";
 export * from "./RegistryTokens.js";
 export * from "./Revoked.js";
+export * from "./ServiceUnavailableErrorBody.js";
+export * from "./ServiceUnavailableErrorBodyContent.js";
+export * from "./ServiceUnavailableErrorBodyContentCode.js";
 export * from "./TokenMetadata.js";
 export * from "./TokenStatus.js";
+export * from "./TooManyRequestsErrorBody.js";
+export * from "./TooManyRequestsErrorBodyContent.js";
+export * from "./TooManyRequestsErrorBodyContentCode.js";
 export * from "./User.js";
 export * from "./ValidationError.js";
 export * from "./ValidationErrorLocItem.js";

package/dist/cjs/serialization/types/index.js

@@ -15,6 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Active.js"), exports);
+__exportStar(require("./ClaimGuestSessionResponse.js"), exports);
+__exportStar(require("./ClaimGuestSessionResponseStatus.js"), exports);
 __exportStar(require("./ClaimOrganizationRequest.js"), exports);
 __exportStar(require("./ClaimOrganizationResponse.js"), exports);
 __exportStar(require("./ClaimPreviewResponse.js"), exports);
@@ -24,14 +26,25 @@ __exportStar(require("./ClaimTokenResponse.js"), exports);
 __exportStar(require("./CreateGuestSessionResponse.js"), exports);
 __exportStar(require("./CreateOrganizationResponse.js"), exports);
 __exportStar(require("./CreateTokenResponse.js"), exports);
+__exportStar(require("./DeleteGuestSessionResponse.js"), exports);
+__exportStar(require("./DeleteGuestSessionResponseStatus.js"), exports);
 __exportStar(require("./Expired.js"), exports);
+__exportStar(require("./GetGuestSessionResponse.js"), exports);
+__exportStar(require("./GetGuestSessionResponseStatus.js"), exports);
+__exportStar(require("./GoneErrorBody.js"), exports);
+__exportStar(require("./GoneErrorBodyContent.js"), exports);
+__exportStar(require("./GoneErrorBodyContentCode.js"), exports);
 __exportStar(require("./GuestSessionLimits.js"), exports);
+__exportStar(require("./GuestSessionUsage.js"), exports);
 __exportStar(require("./HttpValidationError.js"), exports);
 __exportStar(require("./JwtResponse.js"), exports);
 __exportStar(require("./LightweightUser.js"), exports);
 __exportStar(require("./LinkAccountsResponse.js"), exports);
 __exportStar(require("./Maven.js"), exports);
 __exportStar(require("./MavenRegistryToken.js"), exports);
+__exportStar(require("./NotFoundErrorBody.js"), exports);
+__exportStar(require("./NotFoundErrorBodyContent.js"), exports);
+__exportStar(require("./NotFoundErrorBodyContentCode.js"), exports);
 __exportStar(require("./Npm.js"), exports);
 __exportStar(require("./NpmRegistryToken.js"), exports);
 __exportStar(require("./Organization.js"), exports);
@@ -42,8 +55,14 @@ __exportStar(require("./PypiRegistryToken.js"), exports);
 __exportStar(require("./RegistryToken.js"), exports);
 __exportStar(require("./RegistryTokens.js"), exports);
 __exportStar(require("./Revoked.js"), exports);
+__exportStar(require("./ServiceUnavailableErrorBody.js"), exports);
+__exportStar(require("./ServiceUnavailableErrorBodyContent.js"), exports);
+__exportStar(require("./ServiceUnavailableErrorBodyContentCode.js"), exports);
 __exportStar(require("./TokenMetadata.js"), exports);
 __exportStar(require("./TokenStatus.js"), exports);
+__exportStar(require("./TooManyRequestsErrorBody.js"), exports);
+__exportStar(require("./TooManyRequestsErrorBodyContent.js"), exports);
+__exportStar(require("./TooManyRequestsErrorBodyContentCode.js"), exports);
 __exportStar(require("./User.js"), exports);
 __exportStar(require("./ValidationError.js"), exports);
 __exportStar(require("./ValidationErrorLocItem.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "11.7.0";
+export declare const SDK_VERSION = "12.0.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "11.7.0";
+exports.SDK_VERSION = "12.0.0";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@fern-api/venus-api-sdk",
-        "X-Fern-SDK-Version": "11.7.0",
-        "User-Agent": "@fern-api/venus-api-sdk/11.7.0",
+        "X-Fern-SDK-Version": "12.0.0",
+        "User-Agent": "@fern-api/venus-api-sdk/12.0.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -28,4 +28,57 @@ export declare class GuestSessionClient {
      */
     create(request: FernVenusApi.CreateGuestSessionRequest, requestOptions?: GuestSessionClient.RequestOptions): core.HttpResponsePromise<core.APIResponse<FernVenusApi.CreateGuestSessionResponse, FernVenusApi.guestSession.create.Error>>;
     private __create;
+    /**
+     * Read a guest session: where it is in its life, when it runs out and how much of its
+     * budget is spent.
+     * Opened by the session's own token, by the claim secret (sent as `X-Fern-Claim-Secret`,
+     * which is what the claim page holds), or by the user who claimed it. Anything else is
+     * told the session does not exist.
+     *
+     * @param {FernVenusApi.GetGuestSessionsSessionIdGetRequest} request
+     * @param {GuestSessionClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.guestSession.get({
+     *         sessionId: "session_id"
+     *     })
+     */
+    get(request: FernVenusApi.GetGuestSessionsSessionIdGetRequest, requestOptions?: GuestSessionClient.RequestOptions): core.HttpResponsePromise<core.APIResponse<FernVenusApi.GetGuestSessionResponse, FernVenusApi.guestSession.get.Error>>;
+    private __get;
+    /**
+     * Take a guest session down. Its token stops working at once and nothing more can be
+     * built or published with it.
+     * The session's own token or its claim secret takes it down (`deleted`); a Fern operator's
+     * service credential takes it down for abuse (`takenDown`). Anything else is told the
+     * session does not exist. Calling it again answers the same; a claimed session cannot be
+     * taken down here, its work belongs to an organization now.
+     *
+     * @param {FernVenusApi.DeleteGuestSessionsSessionIdDeleteRequest} request
+     * @param {GuestSessionClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.guestSession.delete({
+     *         sessionId: "session_id"
+     *     })
+     */
+    delete(request: FernVenusApi.DeleteGuestSessionsSessionIdDeleteRequest, requestOptions?: GuestSessionClient.RequestOptions): core.HttpResponsePromise<core.APIResponse<FernVenusApi.DeleteGuestSessionResponse, FernVenusApi.guestSession.delete.Error>>;
+    private __delete;
+    /**
+     * Claim a guest session: make its work the caller's, for keeps.
+     * Needs two things: the claim secret (`X-Fern-Claim-Secret`, from the claim URL) and a
+     * signed-in person (`Authorization`). With `organizationId`, the caller must already be an
+     * admin of that organization and the session's work is moved into it. Without, the
+     * session's own organization becomes the caller's, with them as its first admin.
+     * Claiming revokes the guest token. Safe to retry: the claimant may call it again.
+     *
+     * @param {FernVenusApi.ClaimGuestSessionRequest} request
+     * @param {GuestSessionClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.guestSession.claim({
+     *         sessionId: "session_id"
+     *     })
+     */
+    claim(request: FernVenusApi.ClaimGuestSessionRequest, requestOptions?: GuestSessionClient.RequestOptions): core.HttpResponsePromise<core.APIResponse<FernVenusApi.ClaimGuestSessionResponse, FernVenusApi.guestSession.claim.Error>>;
+    private __claim;
 }

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

@@ -8,8 +8,19 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 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 serializers from "../../../../serialization/index.mjs";
 import * as FernVenusApi from "../../../index.mjs";
@@ -92,6 +103,30 @@ export class GuestSessionClient {
                             },
                             rawResponse: _response.rawResponse,
                         };
+                    case 429:
+                        return {
+                            data: {
+                                ok: false,
+                                error: FernVenusApi.guestSession.create.Error.tooManyRequestsError(serializers.TooManyRequestsErrorBody.parseOrThrow(_response.error.body, {
+                                    unrecognizedObjectKeys: "passthrough",
+                                    allowUnrecognizedUnionMembers: true,
+                                    allowUnrecognizedEnumValues: true,
+                                    skipValidation: true,
+                                    breadcrumbsPrefix: ["response"],
+                                })),
+                                rawResponse: _response.rawResponse,
+                            },
+                            rawResponse: _response.rawResponse,
+                        };
+                    case 503:
+                        return {
+                            data: {
+                                ok: false,
+                                error: FernVenusApi.guestSession.create.Error.serviceUnavailableError(_response.error.body),
+                                rawResponse: _response.rawResponse,
+                            },
+                            rawResponse: _response.rawResponse,
+                        };
                 }
             }
             return {
@@ -104,4 +139,294 @@ export class GuestSessionClient {
             };
         });
     }
+    /**
+     * Read a guest session: where it is in its life, when it runs out and how much of its
+     * budget is spent.
+     * Opened by the session's own token, by the claim secret (sent as `X-Fern-Claim-Secret`,
+     * which is what the claim page holds), or by the user who claimed it. Anything else is
+     * told the session does not exist.
+     *
+     * @param {FernVenusApi.GetGuestSessionsSessionIdGetRequest} request
+     * @param {GuestSessionClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.guestSession.get({
+     *         sessionId: "session_id"
+     *     })
+     */
+    get(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__get(request, requestOptions));
+    }
+    __get(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { sessionId, fernClaimSecret } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Fern-Claim-Secret": fernClaimSecret }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `guest-sessions/${core.url.encodePathParam(sessionId)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: {
+                        ok: true,
+                        body: serializers.GetGuestSessionResponse.parseOrThrow(_response.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }),
+                        headers: _response.headers,
+                        rawResponse: _response.rawResponse,
+                    },
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        return {
+                            data: {
+                                ok: false,
+                                error: FernVenusApi.guestSession.get.Error.notFoundError(serializers.NotFoundErrorBody.parseOrThrow(_response.error.body, {
+                                    unrecognizedObjectKeys: "passthrough",
+                                    allowUnrecognizedUnionMembers: true,
+                                    allowUnrecognizedEnumValues: true,
+                                    skipValidation: true,
+                                    breadcrumbsPrefix: ["response"],
+                                })),
+                                rawResponse: _response.rawResponse,
+                            },
+                            rawResponse: _response.rawResponse,
+                        };
+                    case 410:
+                        return {
+                            data: {
+                                ok: false,
+                                error: FernVenusApi.guestSession.get.Error.goneError(serializers.GoneErrorBody.parseOrThrow(_response.error.body, {
+                                    unrecognizedObjectKeys: "passthrough",
+                                    allowUnrecognizedUnionMembers: true,
+                                    allowUnrecognizedEnumValues: true,
+                                    skipValidation: true,
+                                    breadcrumbsPrefix: ["response"],
+                                })),
+                                rawResponse: _response.rawResponse,
+                            },
+                            rawResponse: _response.rawResponse,
+                        };
+                    case 422:
+                        return {
+                            data: {
+                                ok: false,
+                                error: FernVenusApi.guestSession.get.Error.unprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                                    unrecognizedObjectKeys: "passthrough",
+                                    allowUnrecognizedUnionMembers: true,
+                                    allowUnrecognizedEnumValues: true,
+                                    skipValidation: true,
+                                    breadcrumbsPrefix: ["response"],
+                                })),
+                                rawResponse: _response.rawResponse,
+                            },
+                            rawResponse: _response.rawResponse,
+                        };
+                    case 503:
+                        return {
+                            data: {
+                                ok: false,
+                                error: FernVenusApi.guestSession.get.Error.serviceUnavailableError(_response.error.body),
+                                rawResponse: _response.rawResponse,
+                            },
+                            rawResponse: _response.rawResponse,
+                        };
+                }
+            }
+            return {
+                data: {
+                    ok: false,
+                    error: FernVenusApi.guestSession.get.Error._unknown(_response.error),
+                    rawResponse: _response.rawResponse,
+                },
+                rawResponse: _response.rawResponse,
+            };
+        });
+    }
+    /**
+     * Take a guest session down. Its token stops working at once and nothing more can be
+     * built or published with it.
+     * The session's own token or its claim secret takes it down (`deleted`); a Fern operator's
+     * service credential takes it down for abuse (`takenDown`). Anything else is told the
+     * session does not exist. Calling it again answers the same; a claimed session cannot be
+     * taken down here, its work belongs to an organization now.
+     *
+     * @param {FernVenusApi.DeleteGuestSessionsSessionIdDeleteRequest} request
+     * @param {GuestSessionClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.guestSession.delete({
+     *         sessionId: "session_id"
+     *     })
+     */
+    delete(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(request, requestOptions));
+    }
+    __delete(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { sessionId } = 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 _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `guest-sessions/${core.url.encodePathParam(sessionId)}`),
+                method: "DELETE",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: {
+                        ok: true,
+                        body: serializers.DeleteGuestSessionResponse.parseOrThrow(_response.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }),
+                        headers: _response.headers,
+                        rawResponse: _response.rawResponse,
+                    },
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        return {
+                            data: {
+                                ok: false,
+                                error: FernVenusApi.guestSession.delete.Error.unprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                                    unrecognizedObjectKeys: "passthrough",
+                                    allowUnrecognizedUnionMembers: true,
+                                    allowUnrecognizedEnumValues: true,
+                                    skipValidation: true,
+                                    breadcrumbsPrefix: ["response"],
+                                })),
+                                rawResponse: _response.rawResponse,
+                            },
+                            rawResponse: _response.rawResponse,
+                        };
+                }
+            }
+            return {
+                data: {
+                    ok: false,
+                    error: FernVenusApi.guestSession.delete.Error._unknown(_response.error),
+                    rawResponse: _response.rawResponse,
+                },
+                rawResponse: _response.rawResponse,
+            };
+        });
+    }
+    /**
+     * Claim a guest session: make its work the caller's, for keeps.
+     * Needs two things: the claim secret (`X-Fern-Claim-Secret`, from the claim URL) and a
+     * signed-in person (`Authorization`). With `organizationId`, the caller must already be an
+     * admin of that organization and the session's work is moved into it. Without, the
+     * session's own organization becomes the caller's, with them as its first admin.
+     * Claiming revokes the guest token. Safe to retry: the claimant may call it again.
+     *
+     * @param {FernVenusApi.ClaimGuestSessionRequest} request
+     * @param {GuestSessionClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.guestSession.claim({
+     *         sessionId: "session_id"
+     *     })
+     */
+    claim(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__claim(request, requestOptions));
+    }
+    __claim(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const { sessionId } = request, _body = __rest(request, ["sessionId"]);
+            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 _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `guest-sessions/${core.url.encodePathParam(sessionId)}/claim`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.ClaimGuestSessionRequest.jsonOrThrow(_body, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: ((_e = (_c = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _c !== void 0 ? _c : (_d = this._options) === null || _d === void 0 ? void 0 : _d.timeoutInSeconds) !== null && _e !== void 0 ? _e : 60) * 1000,
+                maxRetries: (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_h = this._options) === null || _h === void 0 ? void 0 : _h.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: {
+                        ok: true,
+                        body: serializers.ClaimGuestSessionResponse.parseOrThrow(_response.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }),
+                        headers: _response.headers,
+                        rawResponse: _response.rawResponse,
+                    },
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        return {
+                            data: {
+                                ok: false,
+                                error: FernVenusApi.guestSession.claim.Error.unprocessableEntityError(serializers.HttpValidationError.parseOrThrow(_response.error.body, {
+                                    unrecognizedObjectKeys: "passthrough",
+                                    allowUnrecognizedUnionMembers: true,
+                                    allowUnrecognizedEnumValues: true,
+                                    skipValidation: true,
+                                    breadcrumbsPrefix: ["response"],
+                                })),
+                                rawResponse: _response.rawResponse,
+                            },
+                            rawResponse: _response.rawResponse,
+                        };
+                }
+            }
+            return {
+                data: {
+                    ok: false,
+                    error: FernVenusApi.guestSession.claim.Error._unknown(_response.error),
+                    rawResponse: _response.rawResponse,
+                },
+                rawResponse: _response.rawResponse,
+            };
+        });
+    }
 }

package/dist/esm/api/resources/guestSession/client/claim.d.mts

@@ -0,0 +1,25 @@
+import type * as core from "../../../../core/index.mjs";
+import * as FernVenusApi from "../../../index.mjs";
+export type Error = FernVenusApi.guestSession.claim.Error.UnprocessableEntityError | FernVenusApi.guestSession.claim.Error._Unknown;
+export declare namespace Error {
+    interface UnprocessableEntityError extends _Utils {
+        statusCode: 422;
+        content: FernVenusApi.HttpValidationError;
+    }
+    interface _Unknown extends _Utils {
+        statusCode: void;
+        content: core.Fetcher.Error;
+    }
+    interface _Utils {
+        _visit: <_Result>(visitor: FernVenusApi.guestSession.claim.Error._Visitor<_Result>) => _Result;
+    }
+    interface _Visitor<_Result> {
+        unprocessableEntityError: (value: FernVenusApi.HttpValidationError) => _Result;
+        _other: (value: core.Fetcher.Error) => _Result;
+    }
+}
+export declare const Error: {
+    readonly unprocessableEntityError: (value: FernVenusApi.HttpValidationError) => FernVenusApi.guestSession.claim.Error.UnprocessableEntityError;
+    readonly _unknown: (fetcherError: core.Fetcher.Error) => FernVenusApi.guestSession.claim.Error._Unknown;
+    readonly _visit: <_Result>(value: FernVenusApi.guestSession.claim.Error, visitor: FernVenusApi.guestSession.claim.Error._Visitor<_Result>) => _Result;
+};

package/dist/esm/api/resources/guestSession/client/claim.mjs

@@ -0,0 +1,30 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as FernVenusApi from "../../../index.mjs";
+export const Error = {
+    unprocessableEntityError: (value) => {
+        return {
+            content: value,
+            statusCode: 422,
+            _visit: function (visitor) {
+                return FernVenusApi.guestSession.claim.Error._visit(this, visitor);
+            },
+        };
+    },
+    _unknown: (fetcherError) => {
+        return {
+            statusCode: undefined,
+            content: fetcherError,
+            _visit: function (visitor) {
+                return FernVenusApi.guestSession.claim.Error._visit(this, visitor);
+            },
+        };
+    },
+    _visit: (value, visitor) => {
+        switch (value.statusCode) {
+            case 422:
+                return visitor.unprocessableEntityError(value.content);
+            default:
+                return visitor._other(value.content);
+        }
+    },
+};

package/dist/esm/api/resources/guestSession/client/create.d.mts

@@ -1,11 +1,19 @@
 import type * as core from "../../../../core/index.mjs";
 import * as FernVenusApi from "../../../index.mjs";
-export type Error = FernVenusApi.guestSession.create.Error.UnprocessableEntityError | FernVenusApi.guestSession.create.Error._Unknown;
+export type Error = FernVenusApi.guestSession.create.Error.UnprocessableEntityError | FernVenusApi.guestSession.create.Error.TooManyRequestsError | FernVenusApi.guestSession.create.Error.ServiceUnavailableError | FernVenusApi.guestSession.create.Error._Unknown;
 export declare namespace Error {
     interface UnprocessableEntityError extends _Utils {
         statusCode: 422;
         content: FernVenusApi.HttpValidationError;
     }
+    interface TooManyRequestsError extends _Utils {
+        statusCode: 429;
+        content: FernVenusApi.TooManyRequestsErrorBody;
+    }
+    interface ServiceUnavailableError extends _Utils {
+        statusCode: 503;
+        content?: unknown;
+    }
     interface _Unknown extends _Utils {
         statusCode: void;
         content: core.Fetcher.Error;
@@ -15,11 +23,15 @@ export declare namespace Error {
     }
     interface _Visitor<_Result> {
         unprocessableEntityError: (value: FernVenusApi.HttpValidationError) => _Result;
+        tooManyRequestsError: (value: FernVenusApi.TooManyRequestsErrorBody) => _Result;
+        serviceUnavailableError: (value: unknown) => _Result;
         _other: (value: core.Fetcher.Error) => _Result;
     }
 }
 export declare const Error: {
     readonly unprocessableEntityError: (value: FernVenusApi.HttpValidationError) => FernVenusApi.guestSession.create.Error.UnprocessableEntityError;
+    readonly tooManyRequestsError: (value: FernVenusApi.TooManyRequestsErrorBody) => FernVenusApi.guestSession.create.Error.TooManyRequestsError;
+    readonly serviceUnavailableError: (value?: unknown) => FernVenusApi.guestSession.create.Error.ServiceUnavailableError;
     readonly _unknown: (fetcherError: core.Fetcher.Error) => FernVenusApi.guestSession.create.Error._Unknown;
     readonly _visit: <_Result>(value: FernVenusApi.guestSession.create.Error, visitor: FernVenusApi.guestSession.create.Error._Visitor<_Result>) => _Result;
 };