@fern-api/venus-api-sdk 0.22.4 → 0.22.34

package/dist/esm/core/fetcher/signals.mjs

@@ -4,26 +4,14 @@ export function getTimeoutSignal(timeoutMs) {
     const abortId = setTimeout(() => controller.abort(TIMEOUT), timeoutMs);
     return { signal: controller.signal, abortId };
 }
-/**
- * Returns an abort signal that is getting aborted when
- * at least one of the specified abort signals is aborted.
- *
- * Requires at least node.js 18.
- */
 export function anySignal(...args) {
-    // Allowing signals to be passed either as array
-    // of signals or as multiple arguments.
     const signals = (args.length === 1 && Array.isArray(args[0]) ? args[0] : args);
     const controller = new AbortController();
     for (const signal of signals) {
         if (signal.aborted) {
-            // Exiting early if one of the signals
-            // is already aborted.
             controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
             break;
         }
-        // Listening for signals and removing the listeners
-        // when at least one symbol is aborted.
         signal.addEventListener("abort", () => controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason), {
             signal: controller.signal,
         });

package/dist/esm/core/headers.d.mts

@@ -1,2 +1,2 @@
-export declare function mergeHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, string | THeaderValue>;
-export declare function mergeOnlyDefinedHeaders<THeaderValue>(...headersArray: (Record<string, THeaderValue> | null | undefined)[]): Record<string, THeaderValue>;
+export declare function mergeHeaders(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown>;
+export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, unknown> | null | undefined)[]): Record<string, unknown>;

package/dist/esm/core/headers.mjs

@@ -3,11 +3,12 @@ export function mergeHeaders(...headersArray) {
     for (const [key, value] of headersArray
         .filter((headers) => headers != null)
         .flatMap((headers) => Object.entries(headers))) {
+        const insensitiveKey = key.toLowerCase();
         if (value != null) {
-            result[key] = value;
+            result[insensitiveKey] = value;
         }
-        else if (key in result) {
-            delete result[key];
+        else if (insensitiveKey in result) {
+            delete result[insensitiveKey];
         }
     }
     return result;
@@ -17,8 +18,9 @@ export function mergeOnlyDefinedHeaders(...headersArray) {
     for (const [key, value] of headersArray
         .filter((headers) => headers != null)
         .flatMap((headers) => Object.entries(headers))) {
+        const insensitiveKey = key.toLowerCase();
         if (value != null) {
-            result[key] = value;
+            result[insensitiveKey] = value;
         }
     }
     return result;

package/dist/esm/core/index.d.mts

@@ -1,6 +1,7 @@
 export * from "./auth/index.mjs";
 export * from "./base64.mjs";
 export * from "./fetcher/index.mjs";
+export * as logging from "./logging/index.mjs";
 export * from "./runtime/index.mjs";
 export * as serialization from "./schemas/index.mjs";
 export * as url from "./url/index.mjs";

package/dist/esm/core/index.mjs

@@ -1,6 +1,7 @@
 export * from "./auth/index.mjs";
 export * from "./base64.mjs";
 export * from "./fetcher/index.mjs";
+export * as logging from "./logging/index.mjs";
 export * from "./runtime/index.mjs";
 export * as serialization from "./schemas/index.mjs";
 export * as url from "./url/index.mjs";

package/dist/esm/core/logging/exports.d.mts

@@ -0,0 +1,18 @@
+import * as logger from "./logger.mjs";
+export declare namespace logging {
+    /**
+     * Configuration for logger instances.
+     */
+    type LogConfig = logger.LogConfig;
+    type LogLevel = logger.LogLevel;
+    const LogLevel: typeof logger.LogLevel;
+    type ILogger = logger.ILogger;
+    /**
+     * Console logger implementation that outputs to the console.
+     */
+    type ConsoleLogger = logger.ConsoleLogger;
+    /**
+     * Console logger implementation that outputs to the console.
+     */
+    const ConsoleLogger: typeof logger.ConsoleLogger;
+}

package/dist/esm/core/logging/exports.mjs

@@ -0,0 +1,9 @@
+import * as logger from "./logger.mjs";
+export var logging;
+(function (logging) {
+    logging.LogLevel = logger.LogLevel;
+    /**
+     * Console logger implementation that outputs to the console.
+     */
+    logging.ConsoleLogger = logger.ConsoleLogger;
+})(logging || (logging = {}));

package/dist/esm/core/logging/index.d.mts

@@ -0,0 +1 @@
+export * from "./logger.mjs";

package/dist/esm/core/logging/index.mjs

@@ -0,0 +1 @@
+export * from "./logger.mjs";

package/dist/esm/core/logging/logger.d.mts

@@ -0,0 +1,126 @@
+export declare const LogLevel: {
+    readonly Debug: "debug";
+    readonly Info: "info";
+    readonly Warn: "warn";
+    readonly Error: "error";
+};
+export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+export interface ILogger {
+    /**
+     * Logs a debug message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Logs an info message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Logs a warning message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Logs an error message.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Configuration for logger initialization.
+ */
+export interface LogConfig {
+    /**
+     * Minimum log level to output.
+     * @default LogLevel.Info
+     */
+    level?: LogLevel;
+    /**
+     * Logger implementation to use.
+     * @default new ConsoleLogger()
+     */
+    logger?: ILogger;
+    /**
+     * Whether logging should be silenced.
+     * @default true
+     */
+    silent?: boolean;
+}
+/**
+ * Default console-based logger implementation.
+ */
+export declare class ConsoleLogger implements ILogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Logger class that provides level-based logging functionality.
+ */
+export declare class Logger {
+    private readonly level;
+    private readonly logger;
+    private readonly silent;
+    /**
+     * Creates a new logger instance.
+     * @param config - Logger configuration
+     */
+    constructor(config: Required<LogConfig>);
+    /**
+     * Checks if a log level should be output based on configuration.
+     * @param level - The log level to check
+     * @returns True if the level should be logged
+     */
+    shouldLog(level: LogLevel): boolean;
+    /**
+     * Checks if debug logging is enabled.
+     * @returns True if debug logs should be output
+     */
+    isDebug(): boolean;
+    /**
+     * Logs a debug message if debug logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if info logging is enabled.
+     * @returns True if info logs should be output
+     */
+    isInfo(): boolean;
+    /**
+     * Logs an info message if info logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if warning logging is enabled.
+     * @returns True if warning logs should be output
+     */
+    isWarn(): boolean;
+    /**
+     * Logs a warning message if warning logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Checks if error logging is enabled.
+     * @returns True if error logs should be output
+     */
+    isError(): boolean;
+    /**
+     * Logs an error message if error logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: string, ...args: unknown[]): void;
+}
+export declare function createLogger(config?: LogConfig | Logger): Logger;

package/dist/esm/core/logging/logger.mjs

@@ -0,0 +1,138 @@
+export const LogLevel = {
+    Debug: "debug",
+    Info: "info",
+    Warn: "warn",
+    Error: "error",
+};
+const logLevelMap = {
+    [LogLevel.Debug]: 1,
+    [LogLevel.Info]: 2,
+    [LogLevel.Warn]: 3,
+    [LogLevel.Error]: 4,
+};
+/**
+ * Default console-based logger implementation.
+ */
+export class ConsoleLogger {
+    debug(message, ...args) {
+        console.debug(message, ...args);
+    }
+    info(message, ...args) {
+        console.info(message, ...args);
+    }
+    warn(message, ...args) {
+        console.warn(message, ...args);
+    }
+    error(message, ...args) {
+        console.error(message, ...args);
+    }
+}
+/**
+ * Logger class that provides level-based logging functionality.
+ */
+export class Logger {
+    /**
+     * Creates a new logger instance.
+     * @param config - Logger configuration
+     */
+    constructor(config) {
+        this.level = logLevelMap[config.level];
+        this.logger = config.logger;
+        this.silent = config.silent;
+    }
+    /**
+     * Checks if a log level should be output based on configuration.
+     * @param level - The log level to check
+     * @returns True if the level should be logged
+     */
+    shouldLog(level) {
+        return !this.silent && this.level <= logLevelMap[level];
+    }
+    /**
+     * Checks if debug logging is enabled.
+     * @returns True if debug logs should be output
+     */
+    isDebug() {
+        return this.shouldLog(LogLevel.Debug);
+    }
+    /**
+     * Logs a debug message if debug logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message, ...args) {
+        if (this.isDebug()) {
+            this.logger.debug(message, ...args);
+        }
+    }
+    /**
+     * Checks if info logging is enabled.
+     * @returns True if info logs should be output
+     */
+    isInfo() {
+        return this.shouldLog(LogLevel.Info);
+    }
+    /**
+     * Logs an info message if info logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message, ...args) {
+        if (this.isInfo()) {
+            this.logger.info(message, ...args);
+        }
+    }
+    /**
+     * Checks if warning logging is enabled.
+     * @returns True if warning logs should be output
+     */
+    isWarn() {
+        return this.shouldLog(LogLevel.Warn);
+    }
+    /**
+     * Logs a warning message if warning logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message, ...args) {
+        if (this.isWarn()) {
+            this.logger.warn(message, ...args);
+        }
+    }
+    /**
+     * Checks if error logging is enabled.
+     * @returns True if error logs should be output
+     */
+    isError() {
+        return this.shouldLog(LogLevel.Error);
+    }
+    /**
+     * Logs an error message if error logging is enabled.
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message, ...args) {
+        if (this.isError()) {
+            this.logger.error(message, ...args);
+        }
+    }
+}
+export function createLogger(config) {
+    var _a, _b, _c;
+    if (config == null) {
+        return defaultLogger;
+    }
+    if (config instanceof Logger) {
+        return config;
+    }
+    config = config !== null && config !== void 0 ? config : {};
+    (_a = config.level) !== null && _a !== void 0 ? _a : (config.level = LogLevel.Info);
+    (_b = config.logger) !== null && _b !== void 0 ? _b : (config.logger = new ConsoleLogger());
+    (_c = config.silent) !== null && _c !== void 0 ? _c : (config.silent = true);
+    return new Logger(config);
+}
+const defaultLogger = new Logger({
+    level: LogLevel.Info,
+    logger: new ConsoleLogger(),
+    silent: true,
+});

package/dist/esm/core/runtime/runtime.mjs

@@ -68,6 +68,17 @@ function evaluateRuntime() {
             version: Bun.version,
         };
     }
+    /**
+     * A constant that indicates whether the environment the code is running is in React-Native.
+     * This check should come before Node.js detection since React Native may have a process polyfill.
+     * https://github.com/facebook/react-native/blob/main/packages/react-native/Libraries/Core/setUpNavigator.js
+     */
+    const isReactNative = typeof navigator !== "undefined" && (navigator === null || navigator === void 0 ? void 0 : navigator.product) === "ReactNative";
+    if (isReactNative) {
+        return {
+            type: "react-native",
+        };
+    }
     /**
      * A constant that indicates whether the environment the code is running is Node.JS.
      */
@@ -83,16 +94,6 @@ function evaluateRuntime() {
             parsedVersion: Number(process.versions.node.split(".")[0]),
         };
     }
-    /**
-     * A constant that indicates whether the environment the code is running is in React-Native.
-     * https://github.com/facebook/react-native/blob/main/packages/react-native/Libraries/Core/setUpNavigator.js
-     */
-    const isReactNative = typeof navigator !== "undefined" && (navigator === null || navigator === void 0 ? void 0 : navigator.product) === "ReactNative";
-    if (isReactNative) {
-        return {
-            type: "react-native",
-        };
-    }
     return {
         type: "unknown",
     };

package/dist/esm/core/schemas/Schema.d.mts

@@ -20,6 +20,7 @@ export declare const SchemaType: {
     readonly NUMBER: "number";
     readonly STRING: "string";
     readonly UNKNOWN: "unknown";
+    readonly NEVER: "never";
     readonly RECORD: "record";
     readonly SET: "set";
     readonly UNION: "union";

package/dist/esm/core/schemas/Schema.mjs

@@ -11,6 +11,7 @@ export const SchemaType = {
     NUMBER: "number",
     STRING: "string",
     UNKNOWN: "unknown",
+    NEVER: "never",
     RECORD: "record",
     SET: "set",
     UNION: "union",

package/dist/esm/core/schemas/builders/object/object.mjs

@@ -176,6 +176,7 @@ export function getObjectUtils(schema) {
                         value: raw,
                         transformBase: (rawBase) => schema.parse(rawBase, opts),
                         transformExtension: (rawExtension) => extension.parse(rawExtension, opts),
+                        breadcrumbsPrefix: opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix,
                     });
                 },
                 json: (parsed, opts) => {
@@ -184,6 +185,7 @@ export function getObjectUtils(schema) {
                         value: parsed,
                         transformBase: (parsedBase) => schema.json(parsedBase, opts),
                         transformExtension: (parsedExtension) => extension.json(parsedExtension, opts),
+                        breadcrumbsPrefix: opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix,
                     });
                 },
                 getType: () => SchemaType.OBJECT,
@@ -191,6 +193,8 @@ export function getObjectUtils(schema) {
             return Object.assign(Object.assign(Object.assign(Object.assign({}, baseSchema), getSchemaUtils(baseSchema)), getObjectLikeUtils(baseSchema)), getObjectUtils(baseSchema));
         },
         passthrough: () => {
+            const knownRawKeys = new Set(schema._getRawProperties());
+            const knownParsedKeys = new Set(schema._getParsedProperties());
             const baseSchema = {
                 _getParsedProperties: () => schema._getParsedProperties(),
                 _getRawProperties: () => schema._getRawProperties(),
@@ -199,9 +203,17 @@ export function getObjectUtils(schema) {
                     if (!transformed.ok) {
                         return transformed;
                     }
+                    const extraProperties = {};
+                    if (typeof raw === "object" && raw != null) {
+                        for (const [key, value] of Object.entries(raw)) {
+                            if (!knownRawKeys.has(key)) {
+                                extraProperties[key] = value;
+                            }
+                        }
+                    }
                     return {
                         ok: true,
-                        value: Object.assign(Object.assign({}, raw), transformed.value),
+                        value: Object.assign(Object.assign({}, extraProperties), transformed.value),
                     };
                 },
                 json: (parsed, opts) => {
@@ -209,9 +221,17 @@ export function getObjectUtils(schema) {
                     if (!transformed.ok) {
                         return transformed;
                     }
+                    const extraProperties = {};
+                    if (typeof parsed === "object" && parsed != null) {
+                        for (const [key, value] of Object.entries(parsed)) {
+                            if (!knownParsedKeys.has(key)) {
+                                extraProperties[key] = value;
+                            }
+                        }
+                    }
                     return {
                         ok: true,
-                        value: Object.assign(Object.assign({}, parsed), transformed.value),
+                        value: Object.assign(Object.assign({}, extraProperties), transformed.value),
                     };
                 },
                 getType: () => SchemaType.OBJECT,
@@ -220,7 +240,18 @@ export function getObjectUtils(schema) {
         },
     };
 }
-function validateAndTransformExtendedObject({ extensionKeys, value, transformBase, transformExtension, }) {
+function validateAndTransformExtendedObject({ extensionKeys, value, transformBase, transformExtension, breadcrumbsPrefix = [], }) {
+    if (!isPlainObject(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: getErrorMessageForIncorrectType(value, "object"),
+                },
+            ],
+        };
+    }
     const extensionPropertiesSet = new Set(extensionKeys);
     const [extensionProperties, baseProperties] = partition(keys(value), (key) => extensionPropertiesSet.has(key));
     const transformedBase = transformBase(filterObject(value, baseProperties));

package/dist/esm/core/schemas/builders/primitives/index.d.mts

@@ -1,5 +1,6 @@
 export { any } from "./any.mjs";
 export { boolean } from "./boolean.mjs";
+export { never } from "./never.mjs";
 export { number } from "./number.mjs";
 export { string } from "./string.mjs";
 export { unknown } from "./unknown.mjs";

package/dist/esm/core/schemas/builders/primitives/index.mjs

@@ -1,5 +1,6 @@
 export { any } from "./any.mjs";
 export { boolean } from "./boolean.mjs";
+export { never } from "./never.mjs";
 export { number } from "./number.mjs";
 export { string } from "./string.mjs";
 export { unknown } from "./unknown.mjs";

package/dist/esm/core/schemas/builders/primitives/never.d.mts

@@ -0,0 +1,2 @@
+import { type Schema } from "../../Schema.mjs";
+export declare const never: () => Schema<never, never>;

package/dist/esm/core/schemas/builders/primitives/never.mjs

@@ -0,0 +1,11 @@
+import { SchemaType } from "../../Schema.mjs";
+import { createIdentitySchemaCreator } from "../../utils/createIdentitySchemaCreator.mjs";
+export const never = createIdentitySchemaCreator(SchemaType.NEVER, (_value, { breadcrumbsPrefix = [] } = {}) => ({
+    ok: false,
+    errors: [
+        {
+            path: breadcrumbsPrefix,
+            message: "Expected never",
+        },
+    ],
+}));

package/dist/esm/core/url/join.mjs

@@ -11,7 +11,6 @@ export function join(base, ...segments) {
             url = new URL(base);
         }
         catch (_a) {
-            // Fallback to path joining if URL is malformed
             return joinPath(base, ...segments);
         }
         const lastSegment = segments[segments.length - 1];

package/dist/esm/exports.d.mts

@@ -0,0 +1 @@
+export * from "./core/exports.mjs";

package/dist/esm/exports.mjs

@@ -0,0 +1 @@
+export * from "./core/exports.mjs";

package/dist/esm/index.d.mts

@@ -2,4 +2,5 @@ export * as FernVenusApi from "./api/index.mjs";
 export type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.mjs";
 export { FernVenusApiClient } from "./Client.mjs";
 export { FernVenusApiEnvironment } from "./environments.mjs";
+export * from "./exports.mjs";
 export * as serialization from "./serialization/index.mjs";

package/dist/esm/index.mjs

@@ -1,4 +1,5 @@
 export * as FernVenusApi from "./api/index.mjs";
 export { FernVenusApiClient } from "./Client.mjs";
 export { FernVenusApiEnvironment } from "./environments.mjs";
+export * from "./exports.mjs";
 export * as serialization from "./serialization/index.mjs";

package/dist/esm/serialization/resources/auth/client/getAutopilotToken.d.mts

@@ -0,0 +1,10 @@
+import * as FernVenusApi from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+export declare const Error: core.serialization.Schema<serializers.auth.getAutopilotToken.Error.Raw, FernVenusApi.auth.getAutopilotToken.Error>;
+export declare namespace Error {
+    type Raw = Error.UnauthorizedError;
+    interface UnauthorizedError {
+        error: "UnauthorizedError";
+    }
+}

package/dist/esm/serialization/resources/auth/client/getAutopilotToken.mjs

@@ -0,0 +1,30 @@
+// This file was auto-generated by Fern from our API Definition.
+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 * as FernVenusApi from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+export const Error = core.serialization
+    .union("error", {
+    UnauthorizedError: core.serialization.object({}),
+})
+    .transform({
+    transform: (value) => {
+        switch (value.error) {
+            case "UnauthorizedError":
+                return FernVenusApi.auth.getAutopilotToken.Error.unauthorizedError();
+        }
+    },
+    untransform: (_a) => {
+        var { _visit } = _a, value = __rest(_a, ["_visit"]);
+        return value;
+    },
+});

package/dist/esm/serialization/resources/auth/client/getJwt.d.mts

@@ -0,0 +1,10 @@
+import * as FernVenusApi from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+export declare const Error: core.serialization.Schema<serializers.auth.getJwt.Error.Raw, FernVenusApi.auth.getJwt.Error>;
+export declare namespace Error {
+    type Raw = Error.UnauthorizedError;
+    interface UnauthorizedError {
+        error: "UnauthorizedError";
+    }
+}

package/dist/esm/serialization/resources/auth/client/getJwt.mjs

@@ -0,0 +1,30 @@
+// This file was auto-generated by Fern from our API Definition.
+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 * as FernVenusApi from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+export const Error = core.serialization
+    .union("error", {
+    UnauthorizedError: core.serialization.object({}),
+})
+    .transform({
+    transform: (value) => {
+        switch (value.error) {
+            case "UnauthorizedError":
+                return FernVenusApi.auth.getJwt.Error.unauthorizedError();
+        }
+    },
+    untransform: (_a) => {
+        var { _visit } = _a, value = __rest(_a, ["_visit"]);
+        return value;
+    },
+});