Merge branch 'master' into workerd_fixes

Author: jfromaniello

.github/actions/rl-scanner/action.yml

@@ -31,7 +31,7 @@ runs:
     - name: Install RL Wrapper
       shell: bash
       run: |
-        pip install rl-wrapper>=1.0.0 --index-url "https://${{ env.PRODSEC_TOOLS_USER }}:${{ env.PRODSEC_TOOLS_TOKEN }}@a0us.jfrog.io/artifactory/api/pypi/python-local/simple"
+        pip install "rl-wrapper>=1.0.9" --index-url "https://${{ env.PRODSEC_TOOLS_USER }}:${{ env.PRODSEC_TOOLS_TOKEN }}@a0us.jfrog.io/artifactory/api/pypi/python-local/simple"
 
     - name: Run RL Scanner
       shell: bash

src/index.ts

@@ -3,4 +3,5 @@ export * from './auth/index.js';
 export * from './userinfo/index.js';
 export * from './lib/errors.js';
 export * from './lib/models.js';
+export * from './lib/httpResponseHeadersUtils.js';
 export * from './deprecations.js';

src/lib/httpResponseHeadersUtils.ts

@@ -0,0 +1,94 @@
+export interface TokenQuotaLimit {
+  quota: number;
+  remaining: number;
+  resetAfter: number;
+}
+
+export interface TokenQuotaBucket {
+  perHour?: TokenQuotaLimit;
+  perDay?: TokenQuotaLimit;
+}
+
+export class HttpResponseHeadersUtils {
+  /**
+   * Gets the client token quota limits from the provided headers.
+   *
+   * @param headers the HTTP response headers.
+   * @return a TokenQuotaBucket containing client rate limits, or null if not present.
+   */
+  static getClientQuotaLimit(headers: Headers | Record<string, string>): TokenQuotaBucket | null {
+    const getHeaderValue = (key: string): string | null => {
+      if (headers instanceof Headers) {
+        return headers.get(key);
+      }
+      return headers[key] || null;
+    };
+
+    const quotaHeader = getHeaderValue('auth0-client-quota-limit');
+    return quotaHeader ? this.parseQuota(quotaHeader) : null;
+  }
+
+  /**
+   * Gets the organization token quota limits from the provided headers.
+   *
+   * @param headers the HTTP response headers.
+   * @return a TokenQuotaBucket containing organization rate limits, or null if not present.
+   */
+  static getOrganizationQuotaLimit(
+    headers: Headers | Record<string, string>
+  ): TokenQuotaBucket | null {
+    const getHeaderValue = (key: string): string | null => {
+      if (headers instanceof Headers) {
+        return headers.get(key);
+      }
+      return headers[key] || null;
+    };
+
+    const quotaHeader = getHeaderValue('auth0-organization-quota-limit');
+    return quotaHeader ? this.parseQuota(quotaHeader) : null;
+  }
+
+  /**
+   * Parses a token quota string into a TokenQuotaBucket.
+   *
+   * @param tokenQuota the token quota string.
+   * @return a TokenQuotaBucket containing parsed rate limits.
+   */
+  private static parseQuota(tokenQuota: string): TokenQuotaBucket {
+    let perHour: TokenQuotaLimit | undefined;
+    let perDay: TokenQuotaLimit | undefined;
+
+    const parts = tokenQuota.split(',');
+    for (const part of parts) {
+      const attributes = part.split(';');
+      let quota = 0,
+        remaining = 0,
+        resetAfter = 0;
+
+      for (const attribute of attributes) {
+        const [key, value] = attribute.split('=').map((s) => s.trim());
+        if (!key || !value) continue;
+
+        switch (key) {
+          case 'q':
+            quota = parseInt(value, 10);
+            break;
+          case 'r':
+            remaining = parseInt(value, 10);
+            break;
+          case 't':
+            resetAfter = parseInt(value, 10);
+            break;
+        }
+      }
+
+      if (attributes.length > 0 && attributes[0].includes('per_hour')) {
+        perHour = { quota, remaining, resetAfter };
+      } else if (attributes.length > 0 && attributes[0].includes('per_day')) {
+        perDay = { quota, remaining, resetAfter };
+      }
+    }
+
+    return { perHour, perDay };
+  }
+}

src/management/__generated/managers/organizations-manager.ts

@@ -488,7 +488,7 @@ export class OrganizationsManager extends BaseAPI {
   }
 
   /**
-   * Get a specific organization by name
+   * Retrieve details about a single Organization specified by name.
    *
    * Get organization by name
    *
@@ -627,19 +627,25 @@ export class OrganizationsManager extends BaseAPI {
   }
 
   /**
-   * List available organizations. This endpoint supports two types of pagination:
-   * - Offset pagination
-   * - Checkpoint pagination
+   * Retrieve detailed list of all Organizations available in your tenant. For more information, see Auth0 Organizations.
+   *
+   * This endpoint supports two types of pagination:
+   * <ul>
+   * <li>Offset pagination</li>
+   * <li>Checkpoint pagination</li>
+   * </ul>
    *
    * Checkpoint pagination must be used if you need to retrieve more than 1000 organizations.
    *
    * <h2>Checkpoint Pagination</h2>
    *
    * To search by checkpoint, use the following parameters:
-   * - from: Optional id from which to start selection.
-   * - take: The total amount of entries to retrieve when using the from parameter. Defaults to 50.
+   * <ul>
+   * <li><code>from</code>: Optional id from which to start selection.</li>
+   * <li><code>take</code>: The total number of entries to retrieve when using the <code>from</code> parameter. Defaults to 50.</li>
+   * </ul>
    *
-   * Note: The first time you call this endpoint using Checkpoint Pagination, you should omit the <code>from</code> parameter. If there are more results, a <code>next</code> value will be included in the response. You can use this for subsequent API calls. When <code>next</code> is no longer included in the response, this indicates there are no more pages remaining.
+   * <b>Note</b>: The first time you call this endpoint using checkpoint pagination, omit the <code>from</code> parameter. If there are more results, a <code>next</code> value is included in the response. You can use this for subsequent API calls. When <code>next</code> is no longer included in the response, no pages are remaining.
    *
    * Get organizations
    *
@@ -697,7 +703,7 @@ export class OrganizationsManager extends BaseAPI {
   }
 
   /**
-   * Get a specific organization
+   * Retrieve details about a single Organization specified by ID.
    *
    * Get organization
    *
@@ -757,7 +763,7 @@ export class OrganizationsManager extends BaseAPI {
   }
 
   /**
-   * Modify an organization
+   * Update the details of a specific <a href="https://auth0.com/docs/manage-users/organizations/configure-organizations/create-organizations">Organization</a>, such as name and display name, branding options, and metadata.
    *
    * Modify an Organization
    *
@@ -950,7 +956,7 @@ export class OrganizationsManager extends BaseAPI {
   }
 
   /**
-   * Create an organization
+   * Create a new Organization within your tenant.  To learn more about Organization settings, behavior, and configuration options, review <a href="https://auth0.com/docs/manage-users/organizations/create-first-organization">Create Your First Organization</a>.
    *
    * Create an Organization
    *

src/management/__generated/managers/users-manager.ts

@@ -689,7 +689,7 @@ export class UsersManager extends BaseAPI {
   }
 
   /**
-   * This endpoint will retrieve all organizations that the specified user is a member of.
+   * Retrieve list of the specified user's current Organization memberships. User must be specified by user ID. For more information, review <a href="https://auth0.com/docs/manage-users/organizations">Auth0 Organizations</a>.
    *
    * List user's organizations
    *