cloudflare 4.3.0 → 4.4.0

package/src/resources/magic-transit/connectors/connectors.ts

@@ -250,7 +250,7 @@ export namespace ConnectorGetResponse {
 
 export interface ConnectorUpdateParams {
   /**
-   * Path param:
+   * Path param: Account identifier
    */
   account_id: string;
 
@@ -281,12 +281,15 @@ export interface ConnectorUpdateParams {
 }
 
 export interface ConnectorListParams {
+  /**
+   * Account identifier
+   */
   account_id: string;
 }
 
 export interface ConnectorEditParams {
   /**
-   * Path param:
+   * Path param: Account identifier
    */
   account_id: string;
 
@@ -317,6 +320,9 @@ export interface ConnectorEditParams {
 }
 
 export interface ConnectorGetParams {
+  /**
+   * Account identifier
+   */
   account_id: string;
 }
 

package/src/resources/magic-transit/connectors/events/events.ts

@@ -16,7 +16,11 @@ export class Events extends APIResource {
    * const events =
    *   await client.magicTransit.connectors.events.list(
    *     'connector_id',
-   *     { account_id: 0, from: 0, to: 0 },
+   *     {
+   *       account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *       from: 0,
+   *       to: 0,
+   *     },
    *   );
    * ```
    */
@@ -44,7 +48,7 @@ export class Events extends APIResource {
    *     'connector_id',
    *     0,
    *     0,
-   *     { account_id: 0 },
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    *   );
    * ```
    */
@@ -251,9 +255,9 @@ export namespace EventGetResponse {
 
 export interface EventListParams {
   /**
-   * Path param:
+   * Path param: Account identifier
    */
-  account_id: number;
+  account_id: string;
 
   /**
    * Query param:
@@ -277,7 +281,10 @@ export interface EventListParams {
 }
 
 export interface EventGetParams {
-  account_id: number;
+  /**
+   * Account identifier
+   */
+  account_id: string;
 }
 
 Events.Latest = Latest;

package/src/resources/magic-transit/connectors/events/latest.ts

@@ -12,7 +12,7 @@ export class Latest extends APIResource {
    * const latests =
    *   await client.magicTransit.connectors.events.latest.list(
    *     'connector_id',
-   *     { account_id: 0 },
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    *   );
    * ```
    */
@@ -192,7 +192,10 @@ export namespace LatestListResponse {
 }
 
 export interface LatestListParams {
-  account_id: number;
+  /**
+   * Account identifier
+   */
+  account_id: string;
 }
 
 export declare namespace Latest {

package/src/resources/magic-transit/connectors/snapshots/latest.ts

@@ -12,7 +12,7 @@ export class Latest extends APIResource {
    * const latests =
    *   await client.magicTransit.connectors.snapshots.latest.list(
    *     'connector_id',
-   *     { account_id: 0 },
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    *   );
    * ```
    */
@@ -1284,7 +1284,10 @@ export namespace LatestListResponse {
 }
 
 export interface LatestListParams {
-  account_id: number;
+  /**
+   * Account identifier
+   */
+  account_id: string;
 }
 
 export declare namespace Latest {

package/src/resources/magic-transit/connectors/snapshots/snapshots.ts

@@ -16,7 +16,11 @@ export class Snapshots extends APIResource {
    * const snapshots =
    *   await client.magicTransit.connectors.snapshots.list(
    *     'connector_id',
-   *     { account_id: 0, from: 0, to: 0 },
+   *     {
+   *       account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *       from: 0,
+   *       to: 0,
+   *     },
    *   );
    * ```
    */
@@ -43,7 +47,7 @@ export class Snapshots extends APIResource {
    *   await client.magicTransit.connectors.snapshots.get(
    *     'connector_id',
    *     0,
-   *     { account_id: 0 },
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
    *   );
    * ```
    */
@@ -1331,9 +1335,9 @@ export namespace SnapshotGetResponse {
 
 export interface SnapshotListParams {
   /**
-   * Path param:
+   * Path param: Account identifier
    */
-  account_id: number;
+  account_id: string;
 
   /**
    * Query param:
@@ -1357,7 +1361,10 @@ export interface SnapshotListParams {
 }
 
 export interface SnapshotGetParams {
-  account_id: number;
+  /**
+   * Account identifier
+   */
+  account_id: string;
 }
 
 Snapshots.Latest = Latest;

package/src/resources/memberships.ts

@@ -251,7 +251,7 @@ export namespace MembershipUpdateResponse {
      */
     export interface PermissionGroup {
       /**
-       * Identifier of the group.
+       * Identifier of the permission group.
        */
       id: string;
 
@@ -261,7 +261,7 @@ export namespace MembershipUpdateResponse {
       meta?: PermissionGroup.Meta;
 
       /**
-       * Name of the group.
+       * Name of the permission group.
        */
       name?: string;
     }
@@ -282,7 +282,7 @@ export namespace MembershipUpdateResponse {
      */
     export interface ResourceGroup {
       /**
-       * Identifier of the group.
+       * Identifier of the resource group.
        */
       id: string;
 
@@ -446,7 +446,7 @@ export namespace MembershipGetResponse {
      */
     export interface PermissionGroup {
       /**
-       * Identifier of the group.
+       * Identifier of the permission group.
        */
       id: string;
 
@@ -456,7 +456,7 @@ export namespace MembershipGetResponse {
       meta?: PermissionGroup.Meta;
 
       /**
-       * Name of the group.
+       * Name of the permission group.
        */
       name?: string;
     }
@@ -477,7 +477,7 @@ export namespace MembershipGetResponse {
      */
     export interface ResourceGroup {
       /**
-       * Identifier of the group.
+       * Identifier of the resource group.
        */
       id: string;
 

package/src/resources/network-interconnects/cnis.ts

@@ -592,6 +592,12 @@ export interface CNIListParams {
    * Query param: If specified, only show CNIs associated with the specified slot
    */
   slot?: string | null;
+
+  /**
+   * Query param: If specified, only show cnis associated with the specified tunnel
+   * id
+   */
+  tunnel_id?: string | null;
 }
 
 export interface CNIDeleteParams {

package/src/resources/queues/index.ts

@@ -11,7 +11,6 @@ export {
   type ConsumerGetParams,
 } from './consumers';
 export {
-  MessagePullResponsesSinglePage,
   Messages,
   type MessageAckResponse,
   type MessageBulkPushResponse,

package/src/resources/queues/messages.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../../resource';
 import * as Core from '../../core';
 import * as Shared from '../shared';
-import { SinglePage } from '../../pagination';
 
 export class Messages extends APIResource {
   /**
@@ -59,26 +58,24 @@ export class Messages extends APIResource {
    *
    * @example
    * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const messagePullResponse of client.queues.messages.pull(
+   * const response = await client.queues.messages.pull(
    *   '023e105f4ecef8ad9ca31a8372d0c353',
    *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
-   * )) {
-   *   // ...
-   * }
+   * );
    * ```
    */
   pull(
     queueId: string,
     params: MessagePullParams,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<MessagePullResponsesSinglePage, MessagePullResponse> {
+  ): Core.APIPromise<MessagePullResponse> {
     const { account_id, ...body } = params;
-    return this._client.getAPIList(
-      `/accounts/${account_id}/queues/${queueId}/messages/pull`,
-      MessagePullResponsesSinglePage,
-      { body, method: 'post', ...options },
-    );
+    return (
+      this._client.post(`/accounts/${account_id}/queues/${queueId}/messages/pull`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: MessagePullResponse }>
+    )._thenUnwrap((obj) => obj.result);
   }
 
   /**
@@ -102,8 +99,6 @@ export class Messages extends APIResource {
   }
 }
 
-export class MessagePullResponsesSinglePage extends SinglePage<MessagePullResponse> {}
-
 export interface MessageAckResponse {
   /**
    * The number of messages that were succesfully acknowledged.
@@ -130,21 +125,32 @@ export interface MessageBulkPushResponse {
 }
 
 export interface MessagePullResponse {
-  id?: string;
+  /**
+   * The number of unacknowledged messages in the queue
+   */
+  message_backlog_count?: number;
 
-  attempts?: number;
+  messages?: Array<MessagePullResponse.Message>;
+}
 
-  body?: string;
+export namespace MessagePullResponse {
+  export interface Message {
+    id?: string;
 
-  /**
-   * An ID that represents an "in-flight" message that has been pulled from a Queue.
-   * You must hold on to this ID and use it to acknowledge this message.
-   */
-  lease_id?: string;
+    attempts?: number;
 
-  metadata?: unknown;
+    body?: string;
+
+    /**
+     * An ID that represents an "in-flight" message that has been pulled from a Queue.
+     * You must hold on to this ID and use it to acknowledge this message.
+     */
+    lease_id?: string;
+
+    metadata?: unknown;
 
-  timestamp_ms?: number;
+    timestamp_ms?: number;
+  }
 }
 
 export interface MessagePushResponse {
@@ -311,15 +317,12 @@ export declare namespace MessagePushParams {
   }
 }
 
-Messages.MessagePullResponsesSinglePage = MessagePullResponsesSinglePage;
-
 export declare namespace Messages {
   export {
     type MessageAckResponse as MessageAckResponse,
     type MessageBulkPushResponse as MessageBulkPushResponse,
     type MessagePullResponse as MessagePullResponse,
     type MessagePushResponse as MessagePushResponse,
-    MessagePullResponsesSinglePage as MessagePullResponsesSinglePage,
     type MessageAckParams as MessageAckParams,
     type MessageBulkPushParams as MessageBulkPushParams,
     type MessagePullParams as MessagePullParams,

package/src/resources/queues/queues.ts

@@ -22,7 +22,6 @@ import {
   MessageBulkPushResponse,
   MessagePullParams,
   MessagePullResponse,
-  MessagePullResponsesSinglePage,
   MessagePushParams,
   MessagePushResponse,
   Messages,
@@ -331,7 +330,6 @@ Queues.QueuesSinglePage = QueuesSinglePage;
 Queues.Consumers = Consumers;
 Queues.ConsumersSinglePage = ConsumersSinglePage;
 Queues.Messages = Messages;
-Queues.MessagePullResponsesSinglePage = MessagePullResponsesSinglePage;
 Queues.Purge = Purge;
 
 export declare namespace Queues {
@@ -364,7 +362,6 @@ export declare namespace Queues {
     type MessageBulkPushResponse as MessageBulkPushResponse,
     type MessagePullResponse as MessagePullResponse,
     type MessagePushResponse as MessagePushResponse,
-    MessagePullResponsesSinglePage as MessagePullResponsesSinglePage,
     type MessageAckParams as MessageAckParams,
     type MessageBulkPushParams as MessageBulkPushParams,
     type MessagePullParams as MessagePullParams,

package/src/resources/radar/ai/bots/summary.ts

@@ -35,58 +35,99 @@ export class Summary extends APIResource {
 }
 
 export interface SummaryUserAgentResponse {
+  /**
+   * Metadata for the results.
+   */
   meta: SummaryUserAgentResponse.Meta;
 
   summary_0: Record<string, string>;
 }
 
 export namespace SummaryUserAgentResponse {
+  /**
+   * Metadata for the results.
+   */
   export interface Meta {
+    confidenceInfo: Meta.ConfidenceInfo | null;
+
     dateRange: Array<Meta.DateRange>;
 
+    /**
+     * Timestamp of the last dataset update.
+     */
     lastUpdated: string;
 
-    normalization: string;
-
-    confidenceInfo?: Meta.ConfidenceInfo;
+    /**
+     * Normalization method applied to the results. Refer to
+     * [Normalization methods](https://developers.cloudflare.com/radar/concepts/normalization/).
+     */
+    normalization:
+      | 'PERCENTAGE'
+      | 'MIN0_MAX'
+      | 'MIN_MAX'
+      | 'RAW_VALUES'
+      | 'PERCENTAGE_CHANGE'
+      | 'ROLLING_AVERAGE'
+      | 'OVERLAPPED_PERCENTAGE'
+      | 'RATIO';
+
+    /**
+     * Measurement units for the results.
+     */
+    units: Array<Meta.Unit>;
   }
 
   export namespace Meta {
-    export interface DateRange {
-      /**
-       * Adjusted end of date range.
-       */
-      endTime: string;
+    export interface ConfidenceInfo {
+      annotations: Array<ConfidenceInfo.Annotation>;
 
       /**
-       * Adjusted start of date range.
+       * Provides an indication of how much confidence Cloudflare has in the data.
        */
-      startTime: string;
-    }
-
-    export interface ConfidenceInfo {
-      annotations?: Array<ConfidenceInfo.Annotation>;
-
-      level?: number;
+      level: number;
     }
 
     export namespace ConfidenceInfo {
+      /**
+       * Annotation associated with the result (e.g. outage or other type of event).
+       */
       export interface Annotation {
         dataSource: string;
 
         description: string;
 
+        endDate: string;
+
         eventType: string;
 
+        /**
+         * Whether event is a single point in time or a time range.
+         */
         isInstantaneous: boolean;
 
-        endTime?: string;
-
-        linkedUrl?: string;
+        linkedUrl: string;
 
-        startTime?: string;
+        startDate: string;
       }
     }
+
+    export interface DateRange {
+      /**
+       * Adjusted end of date range.
+       */
+      endTime: string;
+
+      /**
+       * Adjusted start of date range.
+       */
+      startTime: string;
+    }
+
+    export interface Unit {
+      name: string;
+
+      value: string;
+    }
   }
 }