cloudflare 6.1.0 → 6.2.0

package/src/resources/ddos-protection/advanced-tcp-protection/prefixes/items.ts

@@ -0,0 +1,233 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../resource';
+import * as Core from '../../../../core';
+
+export class Items extends APIResource {
+  /**
+   * Delete the prefix for an account given a UUID.
+   *
+   * @example
+   * ```ts
+   * const item =
+   *   await client.DDoSProtection.advancedTCPProtection.prefixes.items.delete(
+   *     'f174e90a-fafe-4643-bbbc-4a0ed4fc8415',
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  delete(
+    prefixId: string,
+    params: ItemDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ItemDeleteResponse> {
+    const { account_id } = params;
+    return this._client.delete(
+      `/accounts/${account_id}/magic/advanced_tcp_protection/configs/prefixes/${prefixId}`,
+      options,
+    );
+  }
+
+  /**
+   * Update a prefix specified by the given UUID.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.DDoSProtection.advancedTCPProtection.prefixes.items.edit(
+   *     'f174e90a-fafe-4643-bbbc-4a0ed4fc8415',
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  edit(
+    prefixId: string,
+    params: ItemEditParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ItemEditResponse> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.patch(
+        `/accounts/${account_id}/magic/advanced_tcp_protection/configs/prefixes/${prefixId}`,
+        { body, ...options },
+      ) as Core.APIPromise<{ result: ItemEditResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Get a prefix specified by the given UUID.
+   *
+   * @example
+   * ```ts
+   * const item =
+   *   await client.DDoSProtection.advancedTCPProtection.prefixes.items.get(
+   *     'f174e90a-fafe-4643-bbbc-4a0ed4fc8415',
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  get(
+    prefixId: string,
+    params: ItemGetParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ItemGetResponse> {
+    const { account_id } = params;
+    return (
+      this._client.get(
+        `/accounts/${account_id}/magic/advanced_tcp_protection/configs/prefixes/${prefixId}`,
+        options,
+      ) as Core.APIPromise<{ result: ItemGetResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export interface ItemDeleteResponse {
+  errors: Array<ItemDeleteResponse.Error>;
+
+  messages: Array<ItemDeleteResponse.Message>;
+
+  /**
+   * Whether the API call was successful.
+   */
+  success: true;
+}
+
+export namespace ItemDeleteResponse {
+  export interface Error {
+    code: number;
+
+    message: string;
+
+    documentation_url?: string;
+
+    source?: Error.Source;
+  }
+
+  export namespace Error {
+    export interface Source {
+      pointer?: string;
+    }
+  }
+
+  export interface Message {
+    code: number;
+
+    message: string;
+
+    documentation_url?: string;
+
+    source?: Message.Source;
+  }
+
+  export namespace Message {
+    export interface Source {
+      pointer?: string;
+    }
+  }
+}
+
+export interface ItemEditResponse {
+  /**
+   * The unique ID of the prefix.
+   */
+  id: string;
+
+  /**
+   * A comment describing the prefix.
+   */
+  comment: string;
+
+  /**
+   * The creation timestamp of the prefix.
+   */
+  created_on: string;
+
+  /**
+   * Whether to exclude the prefix from protection.
+   */
+  excluded: boolean;
+
+  /**
+   * The last modification timestamp of the prefix.
+   */
+  modified_on: string;
+
+  /**
+   * The prefix in CIDR format.
+   */
+  prefix: string;
+}
+
+export interface ItemGetResponse {
+  /**
+   * The unique ID of the prefix.
+   */
+  id: string;
+
+  /**
+   * A comment describing the prefix.
+   */
+  comment: string;
+
+  /**
+   * The creation timestamp of the prefix.
+   */
+  created_on: string;
+
+  /**
+   * Whether to exclude the prefix from protection.
+   */
+  excluded: boolean;
+
+  /**
+   * The last modification timestamp of the prefix.
+   */
+  modified_on: string;
+
+  /**
+   * The prefix in CIDR format.
+   */
+  prefix: string;
+}
+
+export interface ItemDeleteParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
+export interface ItemEditParams {
+  /**
+   * Path param: Identifier.
+   */
+  account_id: string;
+
+  /**
+   * Body param: A new comment for the prefix. Optional.
+   */
+  comment?: string;
+
+  /**
+   * Body param: Whether to exclude the prefix from protection. Optional.
+   */
+  excluded?: boolean;
+}
+
+export interface ItemGetParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
+export declare namespace Items {
+  export {
+    type ItemDeleteResponse as ItemDeleteResponse,
+    type ItemEditResponse as ItemEditResponse,
+    type ItemGetResponse as ItemGetResponse,
+    type ItemDeleteParams as ItemDeleteParams,
+    type ItemEditParams as ItemEditParams,
+    type ItemGetParams as ItemGetParams,
+  };
+}

package/src/resources/ddos-protection/advanced-tcp-protection/prefixes/prefixes.ts

@@ -0,0 +1,377 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../resource';
+import * as Core from '../../../../core';
+import * as ItemsAPI from './items';
+import {
+  ItemDeleteParams,
+  ItemDeleteResponse,
+  ItemEditParams,
+  ItemEditResponse,
+  ItemGetParams,
+  ItemGetResponse,
+  Items,
+} from './items';
+import { SinglePage, V4PagePaginationArray, type V4PagePaginationArrayParams } from '../../../../pagination';
+
+export class Prefixes extends APIResource {
+  items: ItemsAPI.Items = new ItemsAPI.Items(this._client);
+
+  /**
+   * Create a prefix for an account.
+   *
+   * @example
+   * ```ts
+   * const prefix =
+   *   await client.DDoSProtection.advancedTCPProtection.prefixes.create(
+   *     {
+   *       account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *       comment: 'comment',
+   *       excluded: true,
+   *       prefix: '192.0.2.0/24',
+   *     },
+   *   );
+   * ```
+   */
+  create(params: PrefixCreateParams, options?: Core.RequestOptions): Core.APIPromise<PrefixCreateResponse> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.post(`/accounts/${account_id}/magic/advanced_tcp_protection/configs/prefixes`, {
+        body,
+        ...options,
+      }) as Core.APIPromise<{ result: PrefixCreateResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * List all prefixes for an account.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const prefixListResponse of client.DDoSProtection.advancedTCPProtection.prefixes.list(
+   *   { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: PrefixListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<PrefixListResponsesV4PagePaginationArray, PrefixListResponse> {
+    const { account_id, ...query } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/magic/advanced_tcp_protection/configs/prefixes`,
+      PrefixListResponsesV4PagePaginationArray,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Create multiple prefixes for an account.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const prefixBulkCreateResponse of client.DDoSProtection.advancedTCPProtection.prefixes.bulkCreate(
+   *   {
+   *     account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *     body: [
+   *       {
+   *         comment: 'comment',
+   *         excluded: true,
+   *         prefix: '192.0.2.0/24',
+   *       },
+   *     ],
+   *   },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  bulkCreate(
+    params: PrefixBulkCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<PrefixBulkCreateResponsesSinglePage, PrefixBulkCreateResponse> {
+    const { account_id, body } = params;
+    return this._client.getAPIList(
+      `/accounts/${account_id}/magic/advanced_tcp_protection/configs/prefixes/bulk`,
+      PrefixBulkCreateResponsesSinglePage,
+      { body: body, method: 'post', ...options },
+    );
+  }
+
+  /**
+   * Delete all prefixes for an account.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.DDoSProtection.advancedTCPProtection.prefixes.bulkDelete(
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  bulkDelete(
+    params: PrefixBulkDeleteParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<PrefixBulkDeleteResponse> {
+    const { account_id } = params;
+    return this._client.delete(
+      `/accounts/${account_id}/magic/advanced_tcp_protection/configs/prefixes`,
+      options,
+    );
+  }
+}
+
+export class PrefixListResponsesV4PagePaginationArray extends V4PagePaginationArray<PrefixListResponse> {}
+
+export class PrefixBulkCreateResponsesSinglePage extends SinglePage<PrefixBulkCreateResponse> {}
+
+export interface PrefixCreateResponse {
+  /**
+   * The unique ID of the prefix.
+   */
+  id: string;
+
+  /**
+   * A comment describing the prefix.
+   */
+  comment: string;
+
+  /**
+   * The creation timestamp of the prefix.
+   */
+  created_on: string;
+
+  /**
+   * Whether to exclude the prefix from protection.
+   */
+  excluded: boolean;
+
+  /**
+   * The last modification timestamp of the prefix.
+   */
+  modified_on: string;
+
+  /**
+   * The prefix in CIDR format.
+   */
+  prefix: string;
+}
+
+export interface PrefixListResponse {
+  /**
+   * The unique ID of the prefix.
+   */
+  id: string;
+
+  /**
+   * A comment describing the prefix.
+   */
+  comment: string;
+
+  /**
+   * The creation timestamp of the prefix.
+   */
+  created_on: string;
+
+  /**
+   * Whether to exclude the prefix from protection.
+   */
+  excluded: boolean;
+
+  /**
+   * The last modification timestamp of the prefix.
+   */
+  modified_on: string;
+
+  /**
+   * The prefix in CIDR format.
+   */
+  prefix: string;
+}
+
+export interface PrefixBulkCreateResponse {
+  /**
+   * The unique ID of the prefix.
+   */
+  id: string;
+
+  /**
+   * A comment describing the prefix.
+   */
+  comment: string;
+
+  /**
+   * The creation timestamp of the prefix.
+   */
+  created_on: string;
+
+  /**
+   * Whether to exclude the prefix from protection.
+   */
+  excluded: boolean;
+
+  /**
+   * The last modification timestamp of the prefix.
+   */
+  modified_on: string;
+
+  /**
+   * The prefix in CIDR format.
+   */
+  prefix: string;
+}
+
+export interface PrefixBulkDeleteResponse {
+  errors: Array<PrefixBulkDeleteResponse.Error>;
+
+  messages: Array<PrefixBulkDeleteResponse.Message>;
+
+  /**
+   * Whether the API call was successful.
+   */
+  success: true;
+}
+
+export namespace PrefixBulkDeleteResponse {
+  export interface Error {
+    code: number;
+
+    message: string;
+
+    documentation_url?: string;
+
+    source?: Error.Source;
+  }
+
+  export namespace Error {
+    export interface Source {
+      pointer?: string;
+    }
+  }
+
+  export interface Message {
+    code: number;
+
+    message: string;
+
+    documentation_url?: string;
+
+    source?: Message.Source;
+  }
+
+  export namespace Message {
+    export interface Source {
+      pointer?: string;
+    }
+  }
+}
+
+export interface PrefixCreateParams {
+  /**
+   * Path param: Identifier.
+   */
+  account_id: string;
+
+  /**
+   * Body param: A comment describing the prefix.
+   */
+  comment: string;
+
+  /**
+   * Body param: Whether to exclude the prefix from protection.
+   */
+  excluded: boolean;
+
+  /**
+   * Body param: The prefix to add in CIDR format.
+   */
+  prefix: string;
+}
+
+export interface PrefixListParams extends V4PagePaginationArrayParams {
+  /**
+   * Path param: Identifier.
+   */
+  account_id: string;
+
+  /**
+   * Query param: The direction of ordering (ASC or DESC). Defaults to 'ASC'.
+   */
+  direction?: string;
+
+  /**
+   * Query param: The field to order by. Defaults to 'prefix'.
+   */
+  order?: string;
+}
+
+export interface PrefixBulkCreateParams {
+  /**
+   * Path param: Identifier.
+   */
+  account_id: string;
+
+  /**
+   * Body param
+   */
+  body: Array<PrefixBulkCreateParams.Body>;
+}
+
+export namespace PrefixBulkCreateParams {
+  export interface Body {
+    /**
+     * A comment describing the prefix.
+     */
+    comment: string;
+
+    /**
+     * Whether to exclude the prefix from protection.
+     */
+    excluded: boolean;
+
+    /**
+     * The prefix to add in CIDR format.
+     */
+    prefix: string;
+  }
+}
+
+export interface PrefixBulkDeleteParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
+Prefixes.PrefixListResponsesV4PagePaginationArray = PrefixListResponsesV4PagePaginationArray;
+Prefixes.PrefixBulkCreateResponsesSinglePage = PrefixBulkCreateResponsesSinglePage;
+Prefixes.Items = Items;
+
+export declare namespace Prefixes {
+  export {
+    type PrefixCreateResponse as PrefixCreateResponse,
+    type PrefixListResponse as PrefixListResponse,
+    type PrefixBulkCreateResponse as PrefixBulkCreateResponse,
+    type PrefixBulkDeleteResponse as PrefixBulkDeleteResponse,
+    PrefixListResponsesV4PagePaginationArray as PrefixListResponsesV4PagePaginationArray,
+    PrefixBulkCreateResponsesSinglePage as PrefixBulkCreateResponsesSinglePage,
+    type PrefixCreateParams as PrefixCreateParams,
+    type PrefixListParams as PrefixListParams,
+    type PrefixBulkCreateParams as PrefixBulkCreateParams,
+    type PrefixBulkDeleteParams as PrefixBulkDeleteParams,
+  };
+
+  export {
+    Items as Items,
+    type ItemDeleteResponse as ItemDeleteResponse,
+    type ItemEditResponse as ItemEditResponse,
+    type ItemGetResponse as ItemGetResponse,
+    type ItemDeleteParams as ItemDeleteParams,
+    type ItemEditParams as ItemEditParams,
+    type ItemGetParams as ItemGetParams,
+  };
+}

package/src/resources/ddos-protection/advanced-tcp-protection/prefixes.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './prefixes/index';

package/src/resources/ddos-protection/advanced-tcp-protection/status.ts

@@ -0,0 +1,87 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../resource';
+import * as Core from '../../../core';
+
+export class Status extends APIResource {
+  /**
+   * Update the protection status of the account.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.DDoSProtection.advancedTCPProtection.status.edit(
+   *     {
+   *       account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   *       enabled: true,
+   *     },
+   *   );
+   * ```
+   */
+  edit(params: StatusEditParams, options?: Core.RequestOptions): Core.APIPromise<StatusEditResponse> {
+    const { account_id, ...body } = params;
+    return (
+      this._client.patch(
+        `/accounts/${account_id}/magic/advanced_tcp_protection/configs/tcp_protection_status`,
+        { body, ...options },
+      ) as Core.APIPromise<{ result: StatusEditResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+
+  /**
+   * Get the protection status of the account.
+   *
+   * @example
+   * ```ts
+   * const status =
+   *   await client.DDoSProtection.advancedTCPProtection.status.get(
+   *     { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
+   *   );
+   * ```
+   */
+  get(params: StatusGetParams, options?: Core.RequestOptions): Core.APIPromise<StatusGetResponse> {
+    const { account_id } = params;
+    return (
+      this._client.get(
+        `/accounts/${account_id}/magic/advanced_tcp_protection/configs/tcp_protection_status`,
+        options,
+      ) as Core.APIPromise<{ result: StatusGetResponse }>
+    )._thenUnwrap((obj) => obj.result);
+  }
+}
+
+export interface StatusEditResponse {
+  enabled: boolean;
+}
+
+export interface StatusGetResponse {
+  enabled: boolean;
+}
+
+export interface StatusEditParams {
+  /**
+   * Path param: Identifier.
+   */
+  account_id: string;
+
+  /**
+   * Body param: Enables or disables protection.
+   */
+  enabled: boolean;
+}
+
+export interface StatusGetParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
+export declare namespace Status {
+  export {
+    type StatusEditResponse as StatusEditResponse,
+    type StatusGetResponse as StatusGetResponse,
+    type StatusEditParams as StatusEditParams,
+    type StatusGetParams as StatusGetParams,
+  };
+}