auth0 5.1.0 → 5.3.0

package/dist/esm/management/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/management/core/file/file.mjs

@@ -97,7 +97,7 @@ function tryGetFileSizeFromPath(path) {
             const fileStat = yield fs.promises.stat(path);
             return fileStat.size;
         }
-        catch (fallbackError) {
+        catch (_fallbackError) {
             return undefined;
         }
     });

package/dist/esm/management/core/form-data-utils/FormDataWrapper.mjs

@@ -14,9 +14,9 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
     function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
     function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
 };
+import { toMultipartDataPart } from "../../core/file/index.mjs";
 import { toJson } from "../../core/json.mjs";
 import { RUNTIME } from "../runtime/index.mjs";
-import { toMultipartDataPart } from "../../core/file/index.mjs";
 export function newFormData() {
     return __awaiter(this, void 0, void 0, function* () {
         return new FormDataWrapper();

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

@@ -1,9 +1,10 @@
+export * from "./auth/index.mjs";
+export * from "./base64.mjs";
 export * from "./fetcher/index.mjs";
+export * as file from "./file/index.mjs";
+export * from "./form-data-utils/index.mjs";
+export * as logging from "./logging/index.mjs";
+export * from "./pagination/index.mjs";
 export * from "./runtime/index.mjs";
 export * as url from "./url/index.mjs";
-export * from "./auth/index.mjs";
-export * from "./base64.mjs";
 export * from "./utils/index.mjs";
-export * from "./pagination/index.mjs";
-export * from "./form-data-utils/index.mjs";
-export * as file from "./file/index.mjs";

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

@@ -1,9 +1,10 @@
+export * from "./auth/index.mjs";
+export * from "./base64.mjs";
 export * from "./fetcher/index.mjs";
+export * as file from "./file/index.mjs";
+export * from "./form-data-utils/index.mjs";
+export * as logging from "./logging/index.mjs";
+export * from "./pagination/index.mjs";
 export * from "./runtime/index.mjs";
 export * as url from "./url/index.mjs";
-export * from "./auth/index.mjs";
-export * from "./base64.mjs";
 export * from "./utils/index.mjs";
-export * from "./pagination/index.mjs";
-export * from "./form-data-utils/index.mjs";
-export * as file from "./file/index.mjs";

package/dist/esm/management/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/management/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/management/core/logging/index.d.mts

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

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

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

package/dist/esm/management/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/management/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/management/core/pagination/CustomPager.d.mts

@@ -0,0 +1,82 @@
+import { HttpResponsePromise, type RawResponse, type WithRawResponse } from "../fetcher/index.mjs";
+/**
+ * Parser function type for custom pagination.
+ * SDK authors implement this to define how to extract items and determine pagination state.
+ *
+ * @template TItem The type of items in the paginated response.
+ * @template TRequest The type of the request object.
+ * @template TResponse The type of the API response.
+ */
+export type CustomPagerParser<TItem, TRequest, TResponse> = (request: TRequest, response: WithRawResponse<TResponse>) => Promise<{
+    /** The request to use for fetching the next page, if any */
+    nextRequest?: TRequest;
+    /** Whether there is a next page available */
+    hasNextPage: boolean;
+    /** The request to use for fetching the previous page, if any */
+    previousRequest?: TRequest;
+    /** Whether there is a previous page available */
+    hasPreviousPage: boolean;
+    /** The items extracted from the current response */
+    items: TItem[];
+}>;
+/**
+ * A custom pager for paginated API responses where the pagination logic
+ * must be implemented by the SDK author.
+ *
+ * SDK authors provide a parser callback to extract items and determine
+ * pagination state from responses.
+ *
+ * @template TItem The type of the items in the page.
+ * @template TRequest The type of the request object.
+ * @template TResponse The type of the API response.
+ */
+export declare class CustomPager<TItem, TRequest, TResponse> implements AsyncIterable<TItem> {
+    /** The items from the current page */
+    data: TItem[];
+    /** The raw HTTP response */
+    rawResponse: RawResponse;
+    /** The parsed response object */
+    response: TResponse;
+    private context;
+    private parser;
+    private nextRequest?;
+    private previousRequest?;
+    private _hasNextPage;
+    private _hasPreviousPage;
+    private constructor();
+    /**
+     * @returns whether there is a next page to load
+     */
+    hasNextPage(): boolean;
+    /**
+     * @returns whether there is a previous page to load
+     */
+    hasPreviousPage(): boolean;
+    /**
+     * Retrieves the next page of results.
+     * @returns this pager with updated data
+     * @throws Error if there is no next page
+     */
+    getNextPage(): Promise<this>;
+    /**
+     * Retrieves the previous page of results.
+     * @returns this pager with updated data
+     * @throws Error if there is no previous page
+     */
+    getPreviousPage(): Promise<this>;
+    private iterMessages;
+    [Symbol.asyncIterator](): AsyncIterator<TItem, void, unknown>;
+    /**
+     * Creates a CustomPager by making the initial request and parsing the response.
+     *
+     * @param args.sendRequest Function to send a request and get a response
+     * @param args.initialRequest The initial request to start pagination
+     * @param args.parse The parser function to extract items and pagination state
+     * @returns A new CustomPager instance
+     */
+    static create<TItem, TRequest, TResponse>(args: {
+        sendRequest: (request: TRequest) => HttpResponsePromise<TResponse>;
+        initialRequest: TRequest;
+        parse: CustomPagerParser<TItem, TRequest, TResponse>;
+    }): Promise<CustomPager<TItem, TRequest, TResponse>>;
+}

package/dist/esm/management/core/pagination/CustomPager.mjs

@@ -0,0 +1,172 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+/**
+ * A custom pager for paginated API responses where the pagination logic
+ * must be implemented by the SDK author.
+ *
+ * SDK authors provide a parser callback to extract items and determine
+ * pagination state from responses.
+ *
+ * @template TItem The type of the items in the page.
+ * @template TRequest The type of the request object.
+ * @template TResponse The type of the API response.
+ */
+export class CustomPager {
+    constructor(args) {
+        this.response = args.response;
+        this.rawResponse = args.rawResponse;
+        this.data = args.items;
+        this._hasNextPage = args.hasNextPage;
+        this._hasPreviousPage = args.hasPreviousPage;
+        this.nextRequest = args.nextRequest;
+        this.previousRequest = args.previousRequest;
+        this.context = args.context;
+        this.parser = args.parser;
+    }
+    /**
+     * @returns whether there is a next page to load
+     */
+    hasNextPage() {
+        return this._hasNextPage;
+    }
+    /**
+     * @returns whether there is a previous page to load
+     */
+    hasPreviousPage() {
+        return this._hasPreviousPage;
+    }
+    /**
+     * Retrieves the next page of results.
+     * @returns this pager with updated data
+     * @throws Error if there is no next page
+     */
+    getNextPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this._hasNextPage || !this.nextRequest) {
+                throw new Error("No next page available");
+            }
+            const { data, rawResponse } = yield this.context.sendRequest(this.nextRequest).withRawResponse();
+            const parsed = yield this.parser(this.nextRequest, { data, rawResponse });
+            this.response = data;
+            this.rawResponse = rawResponse;
+            this.data = parsed.items;
+            this._hasNextPage = parsed.hasNextPage;
+            this._hasPreviousPage = parsed.hasPreviousPage;
+            this.context.currentRequest = this.nextRequest;
+            this.nextRequest = parsed.nextRequest;
+            this.previousRequest = parsed.previousRequest;
+            return this;
+        });
+    }
+    /**
+     * Retrieves the previous page of results.
+     * @returns this pager with updated data
+     * @throws Error if there is no previous page
+     */
+    getPreviousPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this._hasPreviousPage || !this.previousRequest) {
+                throw new Error("No previous page available");
+            }
+            const { data, rawResponse } = yield this.context.sendRequest(this.previousRequest).withRawResponse();
+            const parsed = yield this.parser(this.previousRequest, { data, rawResponse });
+            this.response = data;
+            this.rawResponse = rawResponse;
+            this.data = parsed.items;
+            this._hasNextPage = parsed.hasNextPage;
+            this._hasPreviousPage = parsed.hasPreviousPage;
+            this.context.currentRequest = this.previousRequest;
+            this.nextRequest = parsed.nextRequest;
+            this.previousRequest = parsed.previousRequest;
+            return this;
+        });
+    }
+    iterMessages() {
+        return __asyncGenerator(this, arguments, function* iterMessages_1() {
+            for (const item of this.data) {
+                yield yield __await(item);
+            }
+            while (this.hasNextPage()) {
+                yield __await(this.getNextPage());
+                for (const item of this.data) {
+                    yield yield __await(item);
+                }
+            }
+        });
+    }
+    [Symbol.asyncIterator]() {
+        return __asyncGenerator(this, arguments, function* _a() {
+            var _b, e_1, _c, _d;
+            try {
+                for (var _e = true, _f = __asyncValues(this.iterMessages()), _g; _g = yield __await(_f.next()), _b = _g.done, !_b; _e = true) {
+                    _d = _g.value;
+                    _e = false;
+                    const message = _d;
+                    yield yield __await(message);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_e && !_b && (_c = _f.return)) yield __await(_c.call(_f));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+    /**
+     * Creates a CustomPager by making the initial request and parsing the response.
+     *
+     * @param args.sendRequest Function to send a request and get a response
+     * @param args.initialRequest The initial request to start pagination
+     * @param args.parse The parser function to extract items and pagination state
+     * @returns A new CustomPager instance
+     */
+    static create(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { data, rawResponse } = yield args.sendRequest(args.initialRequest).withRawResponse();
+            const parsed = yield args.parse(args.initialRequest, { data, rawResponse });
+            return new CustomPager({
+                response: data,
+                rawResponse,
+                items: parsed.items,
+                hasNextPage: parsed.hasNextPage,
+                hasPreviousPage: parsed.hasPreviousPage,
+                nextRequest: parsed.nextRequest,
+                previousRequest: parsed.previousRequest,
+                context: {
+                    sendRequest: args.sendRequest,
+                    currentRequest: args.initialRequest,
+                },
+                parser: args.parse,
+            });
+        });
+    }
+}

package/dist/esm/management/core/pagination/Page.d.mts

@@ -1,4 +1,4 @@
-import { HttpResponsePromise, type RawResponse } from "../fetcher/index.mjs";
+import type { HttpResponsePromise, RawResponse } from "../fetcher/index.mjs";
 /**
  * A page of results from a paginated API.
  *

package/dist/esm/management/core/pagination/exports.d.mts

@@ -1 +1,2 @@
+export { CustomPager, type CustomPagerParser } from "./CustomPager.mjs";
 export type { Page } from "./Page.mjs";

package/dist/esm/management/core/pagination/exports.mjs

@@ -1 +1 @@
-export {};
+export { CustomPager } from "./CustomPager.mjs";

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

@@ -1 +1,2 @@
+export { CustomPager, type CustomPagerParser } from "./CustomPager.mjs";
 export { Page } from "./Page.mjs";

package/dist/esm/management/core/pagination/index.mjs

@@ -1 +1,2 @@
+export { CustomPager } from "./CustomPager.mjs";
 export { Page } from "./Page.mjs";