auth0 5.1.0 → 5.2.0

package/README.md

@@ -2,6 +2,7 @@
 
 ![Release](https://img.shields.io/npm/v/auth0)
 [![Codecov](https://img.shields.io/codecov/c/github/auth0/node-auth0)](https://codecov.io/gh/auth0/node-auth0)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/auth0/node-auth0)
 ![Downloads](https://img.shields.io/npm/dw/auth0)
 [![License](https://img.shields.io/:license-mit-blue.svg?style=flat)](https://opensource.org/licenses/MIT)
 [![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fauth0%2Fnode-auth0)
@@ -513,6 +514,48 @@ const response = await client.actions.create(
 controller.abort(); // aborts the request
 ```
 
+### Logging
+
+The SDK supports configurable logging for debugging API requests and responses. By default, logging is silent.
+
+```typescript
+import { ManagementClient } from "auth0";
+
+const client = new ManagementClient({
+    domain: "your-tenant.auth0.com",
+    clientId: "YOUR_CLIENT_ID",
+    clientSecret: "YOUR_CLIENT_SECRET",
+    logging: {
+        level: "debug", // "debug" | "info" | "warn" | "error"
+        silent: false, // Set to false to enable logging output
+    },
+});
+```
+
+You can also provide a custom logger implementation:
+
+```typescript
+import { ManagementClient } from "auth0";
+
+const customLogger = {
+    debug: (msg, ...args) => myLogger.debug(msg, args),
+    info: (msg, ...args) => myLogger.info(msg, args),
+    warn: (msg, ...args) => myLogger.warn(msg, args),
+    error: (msg, ...args) => myLogger.error(msg, args),
+};
+
+const client = new ManagementClient({
+    domain: "your-tenant.auth0.com",
+    clientId: "YOUR_CLIENT_ID",
+    clientSecret: "YOUR_CLIENT_SECRET",
+    logging: {
+        level: "info",
+        logger: customLogger,
+        silent: false,
+    },
+});
+```
+
 ### Access Raw Response Data
 
 The SDK provides access to raw response data, including headers, through the `.withRawResponse()` method.

package/dist/cjs/management/BaseClient.d.ts

@@ -1,10 +1,10 @@
-import * as environments from "./environments.js";
+import { BearerAuthProvider } from "./auth/BearerAuthProvider.js";
 import * as core from "./core/index.js";
-export interface BaseClientOptions {
+import * as environments from "./environments.js";
+export type BaseClientOptions = {
     environment?: core.Supplier<environments.ManagementEnvironment | string>;
     /** Specify a custom URL to connect the client to. */
     baseUrl?: core.Supplier<string>;
-    token: core.Supplier<core.BearerToken>;
     /** Additional headers to include in requests. */
     headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     /** The default maximum time to wait for a response in seconds. */
@@ -14,7 +14,9 @@ export interface BaseClientOptions {
     /** Provide a custom fetch implementation. Useful for platforms that don't have a built-in fetch or need a custom implementation. */
     fetch?: typeof fetch;
     fetcher?: core.FetchFunction;
-}
+    /** Configure logging for the client. */
+    logging?: core.logging.LogConfig | core.logging.Logger;
+} & BearerAuthProvider.AuthOptions;
 export interface BaseRequestOptions {
     /** The maximum time to wait for a response in seconds. */
     timeoutInSeconds?: number;
@@ -27,3 +29,12 @@ export interface BaseRequestOptions {
     /** Additional headers to include in the request. */
     headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
 }
+export type NormalizedClientOptions<T extends BaseClientOptions> = T & {
+    logging: core.logging.Logger;
+    authProvider?: core.AuthProvider;
+};
+export type NormalizedClientOptionsWithAuth<T extends BaseClientOptions> = NormalizedClientOptions<T> & {
+    authProvider: core.AuthProvider;
+};
+export declare function normalizeClientOptions<T extends BaseClientOptions>(options: T): NormalizedClientOptions<T>;
+export declare function normalizeClientOptionsWithAuth<T extends BaseClientOptions>(options: T): NormalizedClientOptionsWithAuth<T>;

package/dist/cjs/management/BaseClient.js

@@ -1,3 +1,53 @@
 "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.normalizeClientOptions = normalizeClientOptions;
+exports.normalizeClientOptionsWithAuth = normalizeClientOptionsWithAuth;
+const BearerAuthProvider_js_1 = require("./auth/BearerAuthProvider.js");
+const core = __importStar(require("./core/index.js"));
+function normalizeClientOptions(options) {
+    return Object.assign(Object.assign({}, options), { logging: core.logging.createLogger(options === null || options === void 0 ? void 0 : options.logging) });
+}
+function normalizeClientOptionsWithAuth(options) {
+    var _a;
+    const normalized = normalizeClientOptions(options);
+    const normalizedWithNoOpAuthProvider = withNoOpAuthProvider(normalized);
+    (_a = normalized.authProvider) !== null && _a !== void 0 ? _a : (normalized.authProvider = new BearerAuthProvider_js_1.BearerAuthProvider(normalizedWithNoOpAuthProvider));
+    return normalized;
+}
+function withNoOpAuthProvider(options) {
+    return Object.assign(Object.assign({}, options), { authProvider: new core.NoOpAuthProvider() });
+}

package/dist/cjs/management/Client.d.ts

@@ -1,134 +1,137 @@
+import { ActionsClient } from "./api/resources/actions/client/Client.js";
+import { AnomalyClient } from "./api/resources/anomaly/client/Client.js";
+import { AttackProtectionClient } from "./api/resources/attackProtection/client/Client.js";
+import { BrandingClient } from "./api/resources/branding/client/Client.js";
+import { ClientGrantsClient } from "./api/resources/clientGrants/client/Client.js";
+import { ClientsClient } from "./api/resources/clients/client/Client.js";
+import { ConnectionProfilesClient } from "./api/resources/connectionProfiles/client/Client.js";
+import { ConnectionsClient } from "./api/resources/connections/client/Client.js";
+import { CustomDomainsClient } from "./api/resources/customDomains/client/Client.js";
+import { DeviceCredentialsClient } from "./api/resources/deviceCredentials/client/Client.js";
+import { EmailsClient } from "./api/resources/emails/client/Client.js";
+import { EmailTemplatesClient } from "./api/resources/emailTemplates/client/Client.js";
+import { EventStreamsClient } from "./api/resources/eventStreams/client/Client.js";
+import { FlowsClient } from "./api/resources/flows/client/Client.js";
+import { FormsClient } from "./api/resources/forms/client/Client.js";
+import { GuardianClient } from "./api/resources/guardian/client/Client.js";
+import { HooksClient } from "./api/resources/hooks/client/Client.js";
+import { JobsClient } from "./api/resources/jobs/client/Client.js";
+import { KeysClient } from "./api/resources/keys/client/Client.js";
+import { LogsClient } from "./api/resources/logs/client/Client.js";
+import { LogStreamsClient } from "./api/resources/logStreams/client/Client.js";
+import { NetworkAclsClient } from "./api/resources/networkAcls/client/Client.js";
+import { OrganizationsClient } from "./api/resources/organizations/client/Client.js";
+import { PromptsClient } from "./api/resources/prompts/client/Client.js";
+import { RefreshTokensClient } from "./api/resources/refreshTokens/client/Client.js";
+import { ResourceServersClient } from "./api/resources/resourceServers/client/Client.js";
+import { RiskAssessmentsClient } from "./api/resources/riskAssessments/client/Client.js";
+import { RolesClient } from "./api/resources/roles/client/Client.js";
+import { RulesClient } from "./api/resources/rules/client/Client.js";
+import { RulesConfigsClient } from "./api/resources/rulesConfigs/client/Client.js";
+import { SelfServiceProfilesClient } from "./api/resources/selfServiceProfiles/client/Client.js";
+import { SessionsClient } from "./api/resources/sessions/client/Client.js";
+import { StatsClient } from "./api/resources/stats/client/Client.js";
+import { SupplementalSignalsClient } from "./api/resources/supplementalSignals/client/Client.js";
+import { TenantsClient } from "./api/resources/tenants/client/Client.js";
+import { TicketsClient } from "./api/resources/tickets/client/Client.js";
+import { TokenExchangeProfilesClient } from "./api/resources/tokenExchangeProfiles/client/Client.js";
+import { UserAttributeProfilesClient } from "./api/resources/userAttributeProfiles/client/Client.js";
+import { UserBlocksClient } from "./api/resources/userBlocks/client/Client.js";
+import { UserGrantsClient } from "./api/resources/userGrants/client/Client.js";
+import { UsersClient } from "./api/resources/users/client/Client.js";
+import { VerifiableCredentialsClient } from "./api/resources/verifiableCredentials/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
-import { Actions } from "./api/resources/actions/client/Client.js";
-import { Branding } from "./api/resources/branding/client/Client.js";
-import { ClientGrants } from "./api/resources/clientGrants/client/Client.js";
-import { Clients } from "./api/resources/clients/client/Client.js";
-import { Connections } from "./api/resources/connections/client/Client.js";
-import { CustomDomains } from "./api/resources/customDomains/client/Client.js";
-import { DeviceCredentials } from "./api/resources/deviceCredentials/client/Client.js";
-import { EmailTemplates } from "./api/resources/emailTemplates/client/Client.js";
-import { EventStreams } from "./api/resources/eventStreams/client/Client.js";
-import { Flows } from "./api/resources/flows/client/Client.js";
-import { Forms } from "./api/resources/forms/client/Client.js";
-import { UserGrants } from "./api/resources/userGrants/client/Client.js";
-import { Hooks } from "./api/resources/hooks/client/Client.js";
-import { Jobs } from "./api/resources/jobs/client/Client.js";
-import { LogStreams } from "./api/resources/logStreams/client/Client.js";
-import { Logs } from "./api/resources/logs/client/Client.js";
-import { NetworkAcls } from "./api/resources/networkAcls/client/Client.js";
-import { Organizations } from "./api/resources/organizations/client/Client.js";
-import { Prompts } from "./api/resources/prompts/client/Client.js";
-import { RefreshTokens } from "./api/resources/refreshTokens/client/Client.js";
-import { ResourceServers } from "./api/resources/resourceServers/client/Client.js";
-import { Roles } from "./api/resources/roles/client/Client.js";
-import { Rules } from "./api/resources/rules/client/Client.js";
-import { RulesConfigs } from "./api/resources/rulesConfigs/client/Client.js";
-import { SelfServiceProfiles } from "./api/resources/selfServiceProfiles/client/Client.js";
-import { Sessions } from "./api/resources/sessions/client/Client.js";
-import { Stats } from "./api/resources/stats/client/Client.js";
-import { SupplementalSignals } from "./api/resources/supplementalSignals/client/Client.js";
-import { Tickets } from "./api/resources/tickets/client/Client.js";
-import { TokenExchangeProfiles } from "./api/resources/tokenExchangeProfiles/client/Client.js";
-import { UserAttributeProfiles } from "./api/resources/userAttributeProfiles/client/Client.js";
-import { UserBlocks } from "./api/resources/userBlocks/client/Client.js";
-import { Users } from "./api/resources/users/client/Client.js";
-import { Anomaly } from "./api/resources/anomaly/client/Client.js";
-import { AttackProtection } from "./api/resources/attackProtection/client/Client.js";
-import { Emails } from "./api/resources/emails/client/Client.js";
-import { Guardian } from "./api/resources/guardian/client/Client.js";
-import { Keys } from "./api/resources/keys/client/Client.js";
-import { RiskAssessments } from "./api/resources/riskAssessments/client/Client.js";
-import { Tenants } from "./api/resources/tenants/client/Client.js";
-import { VerifiableCredentials } from "./api/resources/verifiableCredentials/client/Client.js";
+import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
 export declare namespace ManagementClient {
-    interface Options extends BaseClientOptions {
-    }
+    type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
     }
 }
 export declare class ManagementClient {
-    protected readonly _options: ManagementClient.Options;
-    protected _actions: Actions | undefined;
-    protected _branding: Branding | undefined;
-    protected _clientGrants: ClientGrants | undefined;
-    protected _clients: Clients | undefined;
-    protected _connections: Connections | undefined;
-    protected _customDomains: CustomDomains | undefined;
-    protected _deviceCredentials: DeviceCredentials | undefined;
-    protected _emailTemplates: EmailTemplates | undefined;
-    protected _eventStreams: EventStreams | undefined;
-    protected _flows: Flows | undefined;
-    protected _forms: Forms | undefined;
-    protected _userGrants: UserGrants | undefined;
-    protected _hooks: Hooks | undefined;
-    protected _jobs: Jobs | undefined;
-    protected _logStreams: LogStreams | undefined;
-    protected _logs: Logs | undefined;
-    protected _networkAcls: NetworkAcls | undefined;
-    protected _organizations: Organizations | undefined;
-    protected _prompts: Prompts | undefined;
-    protected _refreshTokens: RefreshTokens | undefined;
-    protected _resourceServers: ResourceServers | undefined;
-    protected _roles: Roles | undefined;
-    protected _rules: Rules | undefined;
-    protected _rulesConfigs: RulesConfigs | undefined;
-    protected _selfServiceProfiles: SelfServiceProfiles | undefined;
-    protected _sessions: Sessions | undefined;
-    protected _stats: Stats | undefined;
-    protected _supplementalSignals: SupplementalSignals | undefined;
-    protected _tickets: Tickets | undefined;
-    protected _tokenExchangeProfiles: TokenExchangeProfiles | undefined;
-    protected _userAttributeProfiles: UserAttributeProfiles | undefined;
-    protected _userBlocks: UserBlocks | undefined;
-    protected _users: Users | undefined;
-    protected _anomaly: Anomaly | undefined;
-    protected _attackProtection: AttackProtection | undefined;
-    protected _emails: Emails | undefined;
-    protected _guardian: Guardian | undefined;
-    protected _keys: Keys | undefined;
-    protected _riskAssessments: RiskAssessments | undefined;
-    protected _tenants: Tenants | undefined;
-    protected _verifiableCredentials: VerifiableCredentials | undefined;
-    constructor(_options: ManagementClient.Options);
-    get actions(): Actions;
-    get branding(): Branding;
-    get clientGrants(): ClientGrants;
-    get clients(): Clients;
-    get connections(): Connections;
-    get customDomains(): CustomDomains;
-    get deviceCredentials(): DeviceCredentials;
-    get emailTemplates(): EmailTemplates;
-    get eventStreams(): EventStreams;
-    get flows(): Flows;
-    get forms(): Forms;
-    get userGrants(): UserGrants;
-    get hooks(): Hooks;
-    get jobs(): Jobs;
-    get logStreams(): LogStreams;
-    get logs(): Logs;
-    get networkAcls(): NetworkAcls;
-    get organizations(): Organizations;
-    get prompts(): Prompts;
-    get refreshTokens(): RefreshTokens;
-    get resourceServers(): ResourceServers;
-    get roles(): Roles;
-    get rules(): Rules;
-    get rulesConfigs(): RulesConfigs;
-    get selfServiceProfiles(): SelfServiceProfiles;
-    get sessions(): Sessions;
-    get stats(): Stats;
-    get supplementalSignals(): SupplementalSignals;
-    get tickets(): Tickets;
-    get tokenExchangeProfiles(): TokenExchangeProfiles;
-    get userAttributeProfiles(): UserAttributeProfiles;
-    get userBlocks(): UserBlocks;
-    get users(): Users;
-    get anomaly(): Anomaly;
-    get attackProtection(): AttackProtection;
-    get emails(): Emails;
-    get guardian(): Guardian;
-    get keys(): Keys;
-    get riskAssessments(): RiskAssessments;
-    get tenants(): Tenants;
-    get verifiableCredentials(): VerifiableCredentials;
+    protected readonly _options: NormalizedClientOptionsWithAuth<ManagementClient.Options>;
+    protected _actions: ActionsClient | undefined;
+    protected _branding: BrandingClient | undefined;
+    protected _clientGrants: ClientGrantsClient | undefined;
+    protected _clients: ClientsClient | undefined;
+    protected _connectionProfiles: ConnectionProfilesClient | undefined;
+    protected _connections: ConnectionsClient | undefined;
+    protected _customDomains: CustomDomainsClient | undefined;
+    protected _deviceCredentials: DeviceCredentialsClient | undefined;
+    protected _emailTemplates: EmailTemplatesClient | undefined;
+    protected _eventStreams: EventStreamsClient | undefined;
+    protected _flows: FlowsClient | undefined;
+    protected _forms: FormsClient | undefined;
+    protected _userGrants: UserGrantsClient | undefined;
+    protected _hooks: HooksClient | undefined;
+    protected _jobs: JobsClient | undefined;
+    protected _logStreams: LogStreamsClient | undefined;
+    protected _logs: LogsClient | undefined;
+    protected _networkAcls: NetworkAclsClient | undefined;
+    protected _organizations: OrganizationsClient | undefined;
+    protected _prompts: PromptsClient | undefined;
+    protected _refreshTokens: RefreshTokensClient | undefined;
+    protected _resourceServers: ResourceServersClient | undefined;
+    protected _roles: RolesClient | undefined;
+    protected _rules: RulesClient | undefined;
+    protected _rulesConfigs: RulesConfigsClient | undefined;
+    protected _selfServiceProfiles: SelfServiceProfilesClient | undefined;
+    protected _sessions: SessionsClient | undefined;
+    protected _stats: StatsClient | undefined;
+    protected _supplementalSignals: SupplementalSignalsClient | undefined;
+    protected _tickets: TicketsClient | undefined;
+    protected _tokenExchangeProfiles: TokenExchangeProfilesClient | undefined;
+    protected _userAttributeProfiles: UserAttributeProfilesClient | undefined;
+    protected _userBlocks: UserBlocksClient | undefined;
+    protected _users: UsersClient | undefined;
+    protected _anomaly: AnomalyClient | undefined;
+    protected _attackProtection: AttackProtectionClient | undefined;
+    protected _emails: EmailsClient | undefined;
+    protected _guardian: GuardianClient | undefined;
+    protected _keys: KeysClient | undefined;
+    protected _riskAssessments: RiskAssessmentsClient | undefined;
+    protected _tenants: TenantsClient | undefined;
+    protected _verifiableCredentials: VerifiableCredentialsClient | undefined;
+    constructor(options: ManagementClient.Options);
+    get actions(): ActionsClient;
+    get branding(): BrandingClient;
+    get clientGrants(): ClientGrantsClient;
+    get clients(): ClientsClient;
+    get connectionProfiles(): ConnectionProfilesClient;
+    get connections(): ConnectionsClient;
+    get customDomains(): CustomDomainsClient;
+    get deviceCredentials(): DeviceCredentialsClient;
+    get emailTemplates(): EmailTemplatesClient;
+    get eventStreams(): EventStreamsClient;
+    get flows(): FlowsClient;
+    get forms(): FormsClient;
+    get userGrants(): UserGrantsClient;
+    get hooks(): HooksClient;
+    get jobs(): JobsClient;
+    get logStreams(): LogStreamsClient;
+    get logs(): LogsClient;
+    get networkAcls(): NetworkAclsClient;
+    get organizations(): OrganizationsClient;
+    get prompts(): PromptsClient;
+    get refreshTokens(): RefreshTokensClient;
+    get resourceServers(): ResourceServersClient;
+    get roles(): RolesClient;
+    get rules(): RulesClient;
+    get rulesConfigs(): RulesConfigsClient;
+    get selfServiceProfiles(): SelfServiceProfilesClient;
+    get sessions(): SessionsClient;
+    get stats(): StatsClient;
+    get supplementalSignals(): SupplementalSignalsClient;
+    get tickets(): TicketsClient;
+    get tokenExchangeProfiles(): TokenExchangeProfilesClient;
+    get userAttributeProfiles(): UserAttributeProfilesClient;
+    get userBlocks(): UserBlocksClient;
+    get users(): UsersClient;
+    get anomaly(): AnomalyClient;
+    get attackProtection(): AttackProtectionClient;
+    get emails(): EmailsClient;
+    get guardian(): GuardianClient;
+    get keys(): KeysClient;
+    get riskAssessments(): RiskAssessmentsClient;
+    get tenants(): TenantsClient;
+    get verifiableCredentials(): VerifiableCredentialsClient;
 }