@scaleway/sdk 2.26.0 → 2.27.0

package/dist/api/secret/v1beta1/api.gen.cjs

@@ -0,0 +1,359 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const api = require("../../../scw/api.cjs");
+const marshalling = require("../../../helpers/marshalling.cjs");
+const resourcePaginator = require("../../../scw/fetch/resource-paginator.cjs");
+const marshalling_gen = require("./marshalling.gen.cjs");
+const jsonContentHeaders = {
+  "Content-Type": "application/json; charset=utf-8"
+};
+class API extends api.API {
+  /** Lists the available regions of the API. */
+  static LOCALITIES = ["fr-par", "nl-ams", "pl-waw"];
+  /**
+   * Create a secret. Create a secret in a given region specified by the
+   * `region` parameter.
+   *
+   * @param request - The request {@link CreateSecretRequest}
+   * @returns A Promise of Secret
+   */
+  createSecret = (request) => this.client.fetch(
+    {
+      body: JSON.stringify(
+        marshalling_gen.marshalCreateSecretRequest(request, this.client.settings)
+      ),
+      headers: jsonContentHeaders,
+      method: "POST",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets`
+    },
+    marshalling_gen.unmarshalSecret
+  );
+  /**
+   * Get metadata using the secret's ID. Retrieve the metadata of a secret
+   * specified by the `region` and `secret_id` parameters.
+   *
+   * @param request - The request {@link GetSecretRequest}
+   * @returns A Promise of Secret
+   */
+  getSecret = (request) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}`
+    },
+    marshalling_gen.unmarshalSecret
+  );
+  /**
+   * Update metadata of a secret. Edit a secret's metadata such as name, tag(s),
+   * description and ephemeral policy. The secret to update is specified by the
+   * `secret_id` and `region` parameters.
+   *
+   * @param request - The request {@link UpdateSecretRequest}
+   * @returns A Promise of Secret
+   */
+  updateSecret = (request) => this.client.fetch(
+    {
+      body: JSON.stringify(
+        marshalling_gen.marshalUpdateSecretRequest(request, this.client.settings)
+      ),
+      headers: jsonContentHeaders,
+      method: "PATCH",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}`
+    },
+    marshalling_gen.unmarshalSecret
+  );
+  /**
+   * Delete a secret. Delete a given secret specified by the `region` and
+   * `secret_id` parameters.
+   *
+   * @param request - The request {@link DeleteSecretRequest}
+   */
+  deleteSecret = (request) => this.client.fetch({
+    method: "DELETE",
+    path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}`
+  });
+  pageOfListSecrets = (request = {}) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets`,
+      urlParams: marshalling.urlParams(
+        ["ephemeral", request.ephemeral],
+        ["name", request.name],
+        ["order_by", request.orderBy],
+        ["organization_id", request.organizationId],
+        ["page", request.page],
+        [
+          "page_size",
+          request.pageSize ?? this.client.settings.defaultPageSize
+        ],
+        ["path", request.path],
+        ["project_id", request.projectId],
+        ["tags", request.tags],
+        ["type", request.type]
+      )
+    },
+    marshalling_gen.unmarshalListSecretsResponse
+  );
+  /**
+   * List secrets. Retrieve the list of secrets created within an Organization
+   * and/or Project. You must specify either the `organization_id` or the
+   * `project_id` and the `region`.
+   *
+   * @param request - The request {@link ListSecretsRequest}
+   * @returns A Promise of ListSecretsResponse
+   */
+  listSecrets = (request = {}) => resourcePaginator.enrichForPagination("secrets", this.pageOfListSecrets, request);
+  /**
+   * Browse secrets. Retrieve the list of secrets and folders for the given
+   * prefix. You must specify either the `organization_id` or the `project_id`
+   * and the `region`.
+   *
+   * @param request - The request {@link BrowseSecretsRequest}
+   * @returns A Promise of BrowseSecretsResponse
+   */
+  browseSecrets = (request) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/browse`,
+      urlParams: marshalling.urlParams(
+        ["order_by", request.orderBy],
+        ["page", request.page],
+        [
+          "page_size",
+          request.pageSize ?? this.client.settings.defaultPageSize
+        ],
+        ["prefix", request.prefix],
+        ["project_id", request.projectId],
+        ["tags", request.tags]
+      )
+    },
+    marshalling_gen.unmarshalBrowseSecretsResponse
+  );
+  /**
+   * Enable secret protection. Enable secret protection for a given secret
+   * specified by the `secret_id` parameter. Enabling secret protection means
+   * that your secret can be read and modified, but it cannot be deleted.
+   *
+   * @param request - The request {@link ProtectSecretRequest}
+   * @returns A Promise of Secret
+   */
+  protectSecret = (request) => this.client.fetch(
+    {
+      body: "{}",
+      headers: jsonContentHeaders,
+      method: "POST",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/protect`
+    },
+    marshalling_gen.unmarshalSecret
+  );
+  /**
+   * Disable secret protection. Disable secret protection for a given secret
+   * specified by the `secret_id` parameter. Disabling secret protection means
+   * that your secret can be read, modified and deleted.
+   *
+   * @param request - The request {@link UnprotectSecretRequest}
+   * @returns A Promise of Secret
+   */
+  unprotectSecret = (request) => this.client.fetch(
+    {
+      body: "{}",
+      headers: jsonContentHeaders,
+      method: "POST",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/unprotect`
+    },
+    marshalling_gen.unmarshalSecret
+  );
+  /**
+   * Allow a product to use the secret.
+   *
+   * @param request - The request {@link AddSecretOwnerRequest}
+   */
+  addSecretOwner = (request) => this.client.fetch({
+    body: JSON.stringify(
+      marshalling_gen.marshalAddSecretOwnerRequest(request, this.client.settings)
+    ),
+    headers: jsonContentHeaders,
+    method: "POST",
+    path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/add-owner`
+  });
+  /**
+   * Create a version. Create a version of a given secret specified by the
+   * `region` and `secret_id` parameters.
+   *
+   * @param request - The request {@link CreateSecretVersionRequest}
+   * @returns A Promise of SecretVersion
+   */
+  createSecretVersion = (request) => this.client.fetch(
+    {
+      body: JSON.stringify(
+        marshalling_gen.marshalCreateSecretVersionRequest(request, this.client.settings)
+      ),
+      headers: jsonContentHeaders,
+      method: "POST",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/versions`
+    },
+    marshalling_gen.unmarshalSecretVersion
+  );
+  /**
+   * Get metadata of a secret's version using the secret's ID. Retrieve the
+   * metadata of a secret's given version specified by the `region`, `secret_id`
+   * and `revision` parameters.
+   *
+   * @param request - The request {@link GetSecretVersionRequest}
+   * @returns A Promise of SecretVersion
+   */
+  getSecretVersion = (request) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/versions/${marshalling.validatePathParam("revision", request.revision)}`
+    },
+    marshalling_gen.unmarshalSecretVersion
+  );
+  /**
+   * Update metadata of a version. Edit the metadata of a secret's given
+   * version, specified by the `region`, `secret_id` and `revision` parameters.
+   *
+   * @param request - The request {@link UpdateSecretVersionRequest}
+   * @returns A Promise of SecretVersion
+   */
+  updateSecretVersion = (request) => this.client.fetch(
+    {
+      body: JSON.stringify(
+        marshalling_gen.marshalUpdateSecretVersionRequest(request, this.client.settings)
+      ),
+      headers: jsonContentHeaders,
+      method: "PATCH",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/versions/${marshalling.validatePathParam("revision", request.revision)}`
+    },
+    marshalling_gen.unmarshalSecretVersion
+  );
+  /**
+   * Delete a version. Delete a secret's version and the sensitive data
+   * contained in it. Deleting a version is permanent and cannot be undone.
+   *
+   * @param request - The request {@link DeleteSecretVersionRequest}
+   */
+  deleteSecretVersion = (request) => this.client.fetch({
+    method: "DELETE",
+    path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/versions/${marshalling.validatePathParam("revision", request.revision)}`
+  });
+  pageOfListSecretVersions = (request) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/versions`,
+      urlParams: marshalling.urlParams(
+        ["page", request.page],
+        [
+          "page_size",
+          request.pageSize ?? this.client.settings.defaultPageSize
+        ],
+        ["status", request.status]
+      )
+    },
+    marshalling_gen.unmarshalListSecretVersionsResponse
+  );
+  /**
+   * List versions of a secret using the secret's ID. Retrieve the list of a
+   * given secret's versions specified by the `secret_id` and `region`
+   * parameters.
+   *
+   * @param request - The request {@link ListSecretVersionsRequest}
+   * @returns A Promise of ListSecretVersionsResponse
+   */
+  listSecretVersions = (request) => resourcePaginator.enrichForPagination("versions", this.pageOfListSecretVersions, request);
+  /**
+   * Access a secret's version using the secret's ID. Access sensitive data in a
+   * secret's version specified by the `region`, `secret_id` and `revision`
+   * parameters.
+   *
+   * @param request - The request {@link AccessSecretVersionRequest}
+   * @returns A Promise of AccessSecretVersionResponse
+   */
+  accessSecretVersion = (request) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/versions/${marshalling.validatePathParam("revision", request.revision)}/access`
+    },
+    marshalling_gen.unmarshalAccessSecretVersionResponse
+  );
+  /**
+   * Access a secret's version using the secret's name and path. Access
+   * sensitive data in a secret's version specified by the `region`,
+   * `secret_name`, `secret_path` and `revision` parameters.
+   *
+   * @param request - The request {@link AccessSecretVersionByPathRequest}
+   * @returns A Promise of AccessSecretVersionResponse
+   */
+  accessSecretVersionByPath = (request) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets-by-path/versions/${marshalling.validatePathParam("revision", request.revision)}/access`,
+      urlParams: marshalling.urlParams(
+        [
+          "project_id",
+          request.projectId ?? this.client.settings.defaultProjectId
+        ],
+        ["secret_name", request.secretName],
+        ["secret_path", request.secretPath]
+      )
+    },
+    marshalling_gen.unmarshalAccessSecretVersionResponse
+  );
+  /**
+   * Enable a version. Make a specific version accessible. You must specify the
+   * `region`, `secret_id` and `revision` parameters.
+   *
+   * @param request - The request {@link EnableSecretVersionRequest}
+   * @returns A Promise of SecretVersion
+   */
+  enableSecretVersion = (request) => this.client.fetch(
+    {
+      body: "{}",
+      headers: jsonContentHeaders,
+      method: "POST",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/versions/${marshalling.validatePathParam("revision", request.revision)}/enable`
+    },
+    marshalling_gen.unmarshalSecretVersion
+  );
+  /**
+   * Disable a version. Make a specific version inaccessible. You must specify
+   * the `region`, `secret_id` and `revision` parameters.
+   *
+   * @param request - The request {@link DisableSecretVersionRequest}
+   * @returns A Promise of SecretVersion
+   */
+  disableSecretVersion = (request) => this.client.fetch(
+    {
+      body: "{}",
+      headers: jsonContentHeaders,
+      method: "POST",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/secrets/${marshalling.validatePathParam("secretId", request.secretId)}/versions/${marshalling.validatePathParam("revision", request.revision)}/disable`
+    },
+    marshalling_gen.unmarshalSecretVersion
+  );
+  pageOfListTags = (request = {}) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/secret-manager/v1beta1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/tags`,
+      urlParams: marshalling.urlParams(
+        ["page", request.page],
+        [
+          "page_size",
+          request.pageSize ?? this.client.settings.defaultPageSize
+        ],
+        [
+          "project_id",
+          request.projectId ?? this.client.settings.defaultProjectId
+        ]
+      )
+    },
+    marshalling_gen.unmarshalListTagsResponse
+  );
+  /**
+   * List tags. List all tags associated with secrets within a given Project.
+   *
+   * @param request - The request {@link ListTagsRequest}
+   * @returns A Promise of ListTagsResponse
+   */
+  listTags = (request = {}) => resourcePaginator.enrichForPagination("tags", this.pageOfListTags, request);
+}
+exports.API = API;

package/dist/api/secret/v1beta1/api.gen.d.ts

@@ -0,0 +1,181 @@
+import { API as ParentAPI } from '../../../bridge';
+import type { Region } from '../../../bridge';
+import type { AccessSecretVersionByPathRequest, AccessSecretVersionRequest, AccessSecretVersionResponse, AddSecretOwnerRequest, BrowseSecretsRequest, BrowseSecretsResponse, CreateSecretRequest, CreateSecretVersionRequest, DeleteSecretRequest, DeleteSecretVersionRequest, DisableSecretVersionRequest, EnableSecretVersionRequest, GetSecretRequest, GetSecretVersionRequest, ListSecretVersionsRequest, ListSecretVersionsResponse, ListSecretsRequest, ListSecretsResponse, ListTagsRequest, ListTagsResponse, ProtectSecretRequest, Secret, SecretVersion, UnprotectSecretRequest, UpdateSecretRequest, UpdateSecretVersionRequest } from './types.gen';
+/**
+ * Secret Manager API.
+ *
+ * This API allows you to conveniently store, access and share sensitive data
+ * such as passwords, API keys and certificates.
+ */
+export declare class API extends ParentAPI {
+    /** Lists the available regions of the API. */
+    static readonly LOCALITIES: Region[];
+    /**
+     * Create a secret. Create a secret in a given region specified by the
+     * `region` parameter.
+     *
+     * @param request - The request {@link CreateSecretRequest}
+     * @returns A Promise of Secret
+     */
+    createSecret: (request: Readonly<CreateSecretRequest>) => Promise<Secret>;
+    /**
+     * Get metadata using the secret's ID. Retrieve the metadata of a secret
+     * specified by the `region` and `secret_id` parameters.
+     *
+     * @param request - The request {@link GetSecretRequest}
+     * @returns A Promise of Secret
+     */
+    getSecret: (request: Readonly<GetSecretRequest>) => Promise<Secret>;
+    /**
+     * Update metadata of a secret. Edit a secret's metadata such as name, tag(s),
+     * description and ephemeral policy. The secret to update is specified by the
+     * `secret_id` and `region` parameters.
+     *
+     * @param request - The request {@link UpdateSecretRequest}
+     * @returns A Promise of Secret
+     */
+    updateSecret: (request: Readonly<UpdateSecretRequest>) => Promise<Secret>;
+    /**
+     * Delete a secret. Delete a given secret specified by the `region` and
+     * `secret_id` parameters.
+     *
+     * @param request - The request {@link DeleteSecretRequest}
+     */
+    deleteSecret: (request: Readonly<DeleteSecretRequest>) => Promise<void>;
+    protected pageOfListSecrets: (request?: Readonly<ListSecretsRequest>) => Promise<ListSecretsResponse>;
+    /**
+     * List secrets. Retrieve the list of secrets created within an Organization
+     * and/or Project. You must specify either the `organization_id` or the
+     * `project_id` and the `region`.
+     *
+     * @param request - The request {@link ListSecretsRequest}
+     * @returns A Promise of ListSecretsResponse
+     */
+    listSecrets: (request?: Readonly<ListSecretsRequest>) => Promise<ListSecretsResponse> & {
+        all: () => Promise<Secret[]>;
+        [Symbol.asyncIterator]: () => AsyncGenerator<Secret[], void, void>;
+    };
+    /**
+     * Browse secrets. Retrieve the list of secrets and folders for the given
+     * prefix. You must specify either the `organization_id` or the `project_id`
+     * and the `region`.
+     *
+     * @param request - The request {@link BrowseSecretsRequest}
+     * @returns A Promise of BrowseSecretsResponse
+     */
+    browseSecrets: (request: Readonly<BrowseSecretsRequest>) => Promise<BrowseSecretsResponse>;
+    /**
+     * Enable secret protection. Enable secret protection for a given secret
+     * specified by the `secret_id` parameter. Enabling secret protection means
+     * that your secret can be read and modified, but it cannot be deleted.
+     *
+     * @param request - The request {@link ProtectSecretRequest}
+     * @returns A Promise of Secret
+     */
+    protectSecret: (request: Readonly<ProtectSecretRequest>) => Promise<Secret>;
+    /**
+     * Disable secret protection. Disable secret protection for a given secret
+     * specified by the `secret_id` parameter. Disabling secret protection means
+     * that your secret can be read, modified and deleted.
+     *
+     * @param request - The request {@link UnprotectSecretRequest}
+     * @returns A Promise of Secret
+     */
+    unprotectSecret: (request: Readonly<UnprotectSecretRequest>) => Promise<Secret>;
+    /**
+     * Allow a product to use the secret.
+     *
+     * @param request - The request {@link AddSecretOwnerRequest}
+     */
+    addSecretOwner: (request: Readonly<AddSecretOwnerRequest>) => Promise<void>;
+    /**
+     * Create a version. Create a version of a given secret specified by the
+     * `region` and `secret_id` parameters.
+     *
+     * @param request - The request {@link CreateSecretVersionRequest}
+     * @returns A Promise of SecretVersion
+     */
+    createSecretVersion: (request: Readonly<CreateSecretVersionRequest>) => Promise<SecretVersion>;
+    /**
+     * Get metadata of a secret's version using the secret's ID. Retrieve the
+     * metadata of a secret's given version specified by the `region`, `secret_id`
+     * and `revision` parameters.
+     *
+     * @param request - The request {@link GetSecretVersionRequest}
+     * @returns A Promise of SecretVersion
+     */
+    getSecretVersion: (request: Readonly<GetSecretVersionRequest>) => Promise<SecretVersion>;
+    /**
+     * Update metadata of a version. Edit the metadata of a secret's given
+     * version, specified by the `region`, `secret_id` and `revision` parameters.
+     *
+     * @param request - The request {@link UpdateSecretVersionRequest}
+     * @returns A Promise of SecretVersion
+     */
+    updateSecretVersion: (request: Readonly<UpdateSecretVersionRequest>) => Promise<SecretVersion>;
+    /**
+     * Delete a version. Delete a secret's version and the sensitive data
+     * contained in it. Deleting a version is permanent and cannot be undone.
+     *
+     * @param request - The request {@link DeleteSecretVersionRequest}
+     */
+    deleteSecretVersion: (request: Readonly<DeleteSecretVersionRequest>) => Promise<void>;
+    protected pageOfListSecretVersions: (request: Readonly<ListSecretVersionsRequest>) => Promise<ListSecretVersionsResponse>;
+    /**
+     * List versions of a secret using the secret's ID. Retrieve the list of a
+     * given secret's versions specified by the `secret_id` and `region`
+     * parameters.
+     *
+     * @param request - The request {@link ListSecretVersionsRequest}
+     * @returns A Promise of ListSecretVersionsResponse
+     */
+    listSecretVersions: (request: Readonly<ListSecretVersionsRequest>) => Promise<ListSecretVersionsResponse> & {
+        all: () => Promise<SecretVersion[]>;
+        [Symbol.asyncIterator]: () => AsyncGenerator<SecretVersion[], void, void>;
+    };
+    /**
+     * Access a secret's version using the secret's ID. Access sensitive data in a
+     * secret's version specified by the `region`, `secret_id` and `revision`
+     * parameters.
+     *
+     * @param request - The request {@link AccessSecretVersionRequest}
+     * @returns A Promise of AccessSecretVersionResponse
+     */
+    accessSecretVersion: (request: Readonly<AccessSecretVersionRequest>) => Promise<AccessSecretVersionResponse>;
+    /**
+     * Access a secret's version using the secret's name and path. Access
+     * sensitive data in a secret's version specified by the `region`,
+     * `secret_name`, `secret_path` and `revision` parameters.
+     *
+     * @param request - The request {@link AccessSecretVersionByPathRequest}
+     * @returns A Promise of AccessSecretVersionResponse
+     */
+    accessSecretVersionByPath: (request: Readonly<AccessSecretVersionByPathRequest>) => Promise<AccessSecretVersionResponse>;
+    /**
+     * Enable a version. Make a specific version accessible. You must specify the
+     * `region`, `secret_id` and `revision` parameters.
+     *
+     * @param request - The request {@link EnableSecretVersionRequest}
+     * @returns A Promise of SecretVersion
+     */
+    enableSecretVersion: (request: Readonly<EnableSecretVersionRequest>) => Promise<SecretVersion>;
+    /**
+     * Disable a version. Make a specific version inaccessible. You must specify
+     * the `region`, `secret_id` and `revision` parameters.
+     *
+     * @param request - The request {@link DisableSecretVersionRequest}
+     * @returns A Promise of SecretVersion
+     */
+    disableSecretVersion: (request: Readonly<DisableSecretVersionRequest>) => Promise<SecretVersion>;
+    protected pageOfListTags: (request?: Readonly<ListTagsRequest>) => Promise<ListTagsResponse>;
+    /**
+     * List tags. List all tags associated with secrets within a given Project.
+     *
+     * @param request - The request {@link ListTagsRequest}
+     * @returns A Promise of ListTagsResponse
+     */
+    listTags: (request?: Readonly<ListTagsRequest>) => Promise<ListTagsResponse> & {
+        all: () => Promise<string[]>;
+        [Symbol.asyncIterator]: () => AsyncGenerator<string[], void, void>;
+    };
+}