@barndoor-ai/sdk 1.2.0 → 2.0.0-dev.g37b8897

package/dist/esm/apis/NotificationApi.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Barndoor.ai Public API
+ * Unified public API specification for Barndoor.ai platform
+ *
+ * The version of the OpenAPI document: 2.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime.js';
+import { type ChannelListResponse } from '../models/ChannelListResponse.js';
+import { type ChannelOptionsResponse } from '../models/ChannelOptionsResponse.js';
+import { type ChannelResponse } from '../models/ChannelResponse.js';
+import { type ChannelTestResponse } from '../models/ChannelTestResponse.js';
+import { type ChannelUpsertRequest } from '../models/ChannelUpsertRequest.js';
+import { type WebhookSecretResponse } from '../models/WebhookSecretResponse.js';
+export interface DeleteAlertChannelRequest {
+    /**
+     *
+     */
+    channelId: string;
+}
+export interface RegenerateAlertChannelSecretRequest {
+    /**
+     *
+     */
+    channelId: string;
+}
+export interface TestAlertChannelRequest {
+    /**
+     *
+     */
+    channelId: string;
+}
+export interface UpsertAlertChannelRequest {
+    /**
+     *
+     */
+    channelUpsertRequest: ChannelUpsertRequest;
+}
+/**
+ *
+ */
+export declare class NotificationApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for deleteAlertChannel without sending the request
+     */
+    deleteAlertChannelRequestOpts(requestParameters: DeleteAlertChannelRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Deletes one channel; its subscriptions cascade and any stored secret is removed. Irreversible — to stop delivery reversibly, upsert the channel with `enabled: false` instead.
+     * Delete a channel
+     */
+    deleteAlertChannelRaw(requestParameters: DeleteAlertChannelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Deletes one channel; its subscriptions cascade and any stored secret is removed. Irreversible — to stop delivery reversibly, upsert the channel with `enabled: false` instead.
+     * Delete a channel
+     */
+    deleteAlertChannel(requestParameters: DeleteAlertChannelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for getMyAlertChannel without sending the request
+     */
+    getMyAlertChannelRequestOpts(): Promise<runtime.RequestOpts>;
+    /**
+     * Returns the authenticated caller\'s own `in_app` and `user_email` channels. Always self-scoped — there is no way to read another user\'s personal channels, and no user parameter to pass.
+     * List the caller\'s personal channels
+     */
+    getMyAlertChannelRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChannelListResponse>>;
+    /**
+     * Returns the authenticated caller\'s own `in_app` and `user_email` channels. Always self-scoped — there is no way to read another user\'s personal channels, and no user parameter to pass.
+     * List the caller\'s personal channels
+     */
+    getMyAlertChannel(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChannelListResponse>;
+    /**
+     * Creates request options for listAlertChannelOptions without sending the request
+     */
+    listAlertChannelOptionsRequestOpts(): Promise<runtime.RequestOpts>;
+    /**
+     * Returns every alert type this organization may subscribe a channel to, plus the category and severity label vocabularies those types reference.  Read this before building a subscription set. The alert-type enum grows over time and is gated per organization, so this endpoint — not a hardcoded list — is the authoritative answer to what `subscriptions[].alert_type` accepts. Subscribing to a type absent here is accepted but never delivers.
+     * List the subscribable alert vocabulary
+     */
+    listAlertChannelOptionsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChannelOptionsResponse>>;
+    /**
+     * Returns every alert type this organization may subscribe a channel to, plus the category and severity label vocabularies those types reference.  Read this before building a subscription set. The alert-type enum grows over time and is gated per organization, so this endpoint — not a hardcoded list — is the authoritative answer to what `subscriptions[].alert_type` accepts. Subscribing to a type absent here is accepted but never delivers.
+     * List the subscribable alert vocabulary
+     */
+    listAlertChannelOptions(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChannelOptionsResponse>;
+    /**
+     * Creates request options for listAlertChannels without sending the request
+     */
+    listAlertChannelsRequestOpts(): Promise<runtime.RequestOpts>;
+    /**
+     * Returns the organization\'s org-wide channels — `email`, `webhook`, `slack`, `teams` — with their current subscription sets. Personal channels are not included here; read those from `/channels/user`. Unpaginated. Secrets are never returned: a webhook\'s signing secret and a Teams workflow URL surface only as the `has_signing_secret` / `has_workflow_url` flags.
+     * List the organization\'s shared channels
+     */
+    listAlertChannelsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChannelListResponse>>;
+    /**
+     * Returns the organization\'s org-wide channels — `email`, `webhook`, `slack`, `teams` — with their current subscription sets. Personal channels are not included here; read those from `/channels/user`. Unpaginated. Secrets are never returned: a webhook\'s signing secret and a Teams workflow URL surface only as the `has_signing_secret` / `has_workflow_url` flags.
+     * List the organization\'s shared channels
+     */
+    listAlertChannels(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChannelListResponse>;
+    /**
+     * Creates request options for regenerateAlertChannelSecret without sending the request
+     */
+    regenerateAlertChannelSecretRequestOpts(requestParameters: RegenerateAlertChannelSecretRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Generates a new Standard Webhooks signing secret for a `webhook` channel and returns it once, in this response. The previous secret stops verifying immediately, so deploy the new one to your receiver before the next alert fires. Use this if the secret from channel creation was lost or needs rotating; there is no endpoint that reads the current secret.
+     * Rotate a webhook channel\'s signing secret
+     */
+    regenerateAlertChannelSecretRaw(requestParameters: RegenerateAlertChannelSecretRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WebhookSecretResponse>>;
+    /**
+     * Generates a new Standard Webhooks signing secret for a `webhook` channel and returns it once, in this response. The previous secret stops verifying immediately, so deploy the new one to your receiver before the next alert fires. Use this if the secret from channel creation was lost or needs rotating; there is no endpoint that reads the current secret.
+     * Rotate a webhook channel\'s signing secret
+     */
+    regenerateAlertChannelSecret(requestParameters: RegenerateAlertChannelSecretRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WebhookSecretResponse>;
+    /**
+     * Creates request options for testAlertChannel without sending the request
+     */
+    testAlertChannelRequestOpts(requestParameters: TestAlertChannelRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Sends a stock connectivity-test message through the channel\'s real transport, so you can verify a webhook receiver, email address, Slack channel, or Teams workflow actually works. It is not an alert: nothing is persisted, no other channel is notified, and it does not depend on the channel\'s subscriptions.  A transport failure is reported as `200` with `ok: false` and an `error` string — the request succeeded, the delivery did not.
+     * Send a test message through a channel
+     */
+    testAlertChannelRaw(requestParameters: TestAlertChannelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChannelTestResponse>>;
+    /**
+     * Sends a stock connectivity-test message through the channel\'s real transport, so you can verify a webhook receiver, email address, Slack channel, or Teams workflow actually works. It is not an alert: nothing is persisted, no other channel is notified, and it does not depend on the channel\'s subscriptions.  A transport failure is reported as `200` with `ok: false` and an `error` string — the request succeeded, the delivery did not.
+     * Send a test message through a channel
+     */
+    testAlertChannel(requestParameters: TestAlertChannelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChannelTestResponse>;
+    /**
+     * Creates request options for upsertAlertChannel without sending the request
+     */
+    upsertAlertChannelRequestOpts(requestParameters: UpsertAlertChannelRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Upserts one channel and **replaces** its subscription set.  Without `id`, the channel is keyed on its type\'s natural identity, so an identical call is idempotent rather than duplicating: `email` by address, `webhook` by URL, `slack` by channel id, personal types by (organization, type, caller). With `id` it is an authoritative edit of that row — the only way to update a `teams` channel, whose natural identity is a secret URL.  `subscriptions` is replaced wholesale, not merged: send the complete desired set, and expect an omitted list to unsubscribe the channel from everything.  Creating a `webhook` channel reveals its signing secret in `signing_secret` ONCE; it is not readable afterwards. The secret is only generated when the row is new, so a retried create that lands after the first succeeded returns `signing_secret: null`. If you need a secret and got `null`, call `POST /channels/{channel_id}/regenerate-secret`.
+     * Create or update a notification channel
+     */
+    upsertAlertChannelRaw(requestParameters: UpsertAlertChannelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChannelResponse>>;
+    /**
+     * Upserts one channel and **replaces** its subscription set.  Without `id`, the channel is keyed on its type\'s natural identity, so an identical call is idempotent rather than duplicating: `email` by address, `webhook` by URL, `slack` by channel id, personal types by (organization, type, caller). With `id` it is an authoritative edit of that row — the only way to update a `teams` channel, whose natural identity is a secret URL.  `subscriptions` is replaced wholesale, not merged: send the complete desired set, and expect an omitted list to unsubscribe the channel from everything.  Creating a `webhook` channel reveals its signing secret in `signing_secret` ONCE; it is not readable afterwards. The secret is only generated when the row is new, so a retried create that lands after the first succeeded returns `signing_secret: null`. If you need a secret and got `null`, call `POST /channels/{channel_id}/regenerate-secret`.
+     * Create or update a notification channel
+     */
+    upsertAlertChannel(requestParameters: UpsertAlertChannelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChannelResponse>;
+}

package/dist/esm/apis/NotificationApi.js

@@ -0,0 +1,405 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Barndoor.ai Public API
+ * Unified public API specification for Barndoor.ai platform
+ *
+ * The version of the OpenAPI document: 2.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime.js';
+import { ChannelListResponseFromJSON, } from '../models/ChannelListResponse.js';
+import { ChannelOptionsResponseFromJSON, } from '../models/ChannelOptionsResponse.js';
+import { ChannelResponseFromJSON, } from '../models/ChannelResponse.js';
+import { ChannelTestResponseFromJSON, } from '../models/ChannelTestResponse.js';
+import { ChannelUpsertRequestToJSON, } from '../models/ChannelUpsertRequest.js';
+import { WebhookSecretResponseFromJSON, } from '../models/WebhookSecretResponse.js';
+/**
+ *
+ */
+export class NotificationApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for deleteAlertChannel without sending the request
+     */
+    async deleteAlertChannelRequestOpts(requestParameters) {
+        if (requestParameters['channelId'] == null) {
+            throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling deleteAlertChannel().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/notification/public/v1/channels/{channel_id}`;
+        urlPath = urlPath.replace('{channel_id}', encodeURIComponent(String(requestParameters['channelId'])));
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Deletes one channel; its subscriptions cascade and any stored secret is removed. Irreversible — to stop delivery reversibly, upsert the channel with `enabled: false` instead.
+     * Delete a channel
+     */
+    async deleteAlertChannelRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.deleteAlertChannelRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.VoidApiResponse(response);
+    }
+    /**
+     * Deletes one channel; its subscriptions cascade and any stored secret is removed. Irreversible — to stop delivery reversibly, upsert the channel with `enabled: false` instead.
+     * Delete a channel
+     */
+    async deleteAlertChannel(requestParameters, initOverrides) {
+        await this.deleteAlertChannelRaw(requestParameters, initOverrides);
+    }
+    /**
+     * Creates request options for getMyAlertChannel without sending the request
+     */
+    async getMyAlertChannelRequestOpts() {
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/notification/public/v1/channels/user`;
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Returns the authenticated caller\'s own `in_app` and `user_email` channels. Always self-scoped — there is no way to read another user\'s personal channels, and no user parameter to pass.
+     * List the caller\'s personal channels
+     */
+    async getMyAlertChannelRaw(initOverrides) {
+        const requestOptions = await this.getMyAlertChannelRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => ChannelListResponseFromJSON(jsonValue));
+    }
+    /**
+     * Returns the authenticated caller\'s own `in_app` and `user_email` channels. Always self-scoped — there is no way to read another user\'s personal channels, and no user parameter to pass.
+     * List the caller\'s personal channels
+     */
+    async getMyAlertChannel(initOverrides) {
+        const response = await this.getMyAlertChannelRaw(initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for listAlertChannelOptions without sending the request
+     */
+    async listAlertChannelOptionsRequestOpts() {
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/notification/public/v1/channels/options`;
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Returns every alert type this organization may subscribe a channel to, plus the category and severity label vocabularies those types reference.  Read this before building a subscription set. The alert-type enum grows over time and is gated per organization, so this endpoint — not a hardcoded list — is the authoritative answer to what `subscriptions[].alert_type` accepts. Subscribing to a type absent here is accepted but never delivers.
+     * List the subscribable alert vocabulary
+     */
+    async listAlertChannelOptionsRaw(initOverrides) {
+        const requestOptions = await this.listAlertChannelOptionsRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => ChannelOptionsResponseFromJSON(jsonValue));
+    }
+    /**
+     * Returns every alert type this organization may subscribe a channel to, plus the category and severity label vocabularies those types reference.  Read this before building a subscription set. The alert-type enum grows over time and is gated per organization, so this endpoint — not a hardcoded list — is the authoritative answer to what `subscriptions[].alert_type` accepts. Subscribing to a type absent here is accepted but never delivers.
+     * List the subscribable alert vocabulary
+     */
+    async listAlertChannelOptions(initOverrides) {
+        const response = await this.listAlertChannelOptionsRaw(initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for listAlertChannels without sending the request
+     */
+    async listAlertChannelsRequestOpts() {
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/notification/public/v1/channels`;
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Returns the organization\'s org-wide channels — `email`, `webhook`, `slack`, `teams` — with their current subscription sets. Personal channels are not included here; read those from `/channels/user`. Unpaginated. Secrets are never returned: a webhook\'s signing secret and a Teams workflow URL surface only as the `has_signing_secret` / `has_workflow_url` flags.
+     * List the organization\'s shared channels
+     */
+    async listAlertChannelsRaw(initOverrides) {
+        const requestOptions = await this.listAlertChannelsRequestOpts();
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => ChannelListResponseFromJSON(jsonValue));
+    }
+    /**
+     * Returns the organization\'s org-wide channels — `email`, `webhook`, `slack`, `teams` — with their current subscription sets. Personal channels are not included here; read those from `/channels/user`. Unpaginated. Secrets are never returned: a webhook\'s signing secret and a Teams workflow URL surface only as the `has_signing_secret` / `has_workflow_url` flags.
+     * List the organization\'s shared channels
+     */
+    async listAlertChannels(initOverrides) {
+        const response = await this.listAlertChannelsRaw(initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for regenerateAlertChannelSecret without sending the request
+     */
+    async regenerateAlertChannelSecretRequestOpts(requestParameters) {
+        if (requestParameters['channelId'] == null) {
+            throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling regenerateAlertChannelSecret().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/notification/public/v1/channels/{channel_id}/regenerate-secret`;
+        urlPath = urlPath.replace('{channel_id}', encodeURIComponent(String(requestParameters['channelId'])));
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Generates a new Standard Webhooks signing secret for a `webhook` channel and returns it once, in this response. The previous secret stops verifying immediately, so deploy the new one to your receiver before the next alert fires. Use this if the secret from channel creation was lost or needs rotating; there is no endpoint that reads the current secret.
+     * Rotate a webhook channel\'s signing secret
+     */
+    async regenerateAlertChannelSecretRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.regenerateAlertChannelSecretRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => WebhookSecretResponseFromJSON(jsonValue));
+    }
+    /**
+     * Generates a new Standard Webhooks signing secret for a `webhook` channel and returns it once, in this response. The previous secret stops verifying immediately, so deploy the new one to your receiver before the next alert fires. Use this if the secret from channel creation was lost or needs rotating; there is no endpoint that reads the current secret.
+     * Rotate a webhook channel\'s signing secret
+     */
+    async regenerateAlertChannelSecret(requestParameters, initOverrides) {
+        const response = await this.regenerateAlertChannelSecretRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for testAlertChannel without sending the request
+     */
+    async testAlertChannelRequestOpts(requestParameters) {
+        if (requestParameters['channelId'] == null) {
+            throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling testAlertChannel().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/notification/public/v1/channels/{channel_id}/test`;
+        urlPath = urlPath.replace('{channel_id}', encodeURIComponent(String(requestParameters['channelId'])));
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+    /**
+     * Sends a stock connectivity-test message through the channel\'s real transport, so you can verify a webhook receiver, email address, Slack channel, or Teams workflow actually works. It is not an alert: nothing is persisted, no other channel is notified, and it does not depend on the channel\'s subscriptions.  A transport failure is reported as `200` with `ok: false` and an `error` string — the request succeeded, the delivery did not.
+     * Send a test message through a channel
+     */
+    async testAlertChannelRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.testAlertChannelRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => ChannelTestResponseFromJSON(jsonValue));
+    }
+    /**
+     * Sends a stock connectivity-test message through the channel\'s real transport, so you can verify a webhook receiver, email address, Slack channel, or Teams workflow actually works. It is not an alert: nothing is persisted, no other channel is notified, and it does not depend on the channel\'s subscriptions.  A transport failure is reported as `200` with `ok: false` and an `error` string — the request succeeded, the delivery did not.
+     * Send a test message through a channel
+     */
+    async testAlertChannel(requestParameters, initOverrides) {
+        const response = await this.testAlertChannelRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Creates request options for upsertAlertChannel without sending the request
+     */
+    async upsertAlertChannelRequestOpts(requestParameters) {
+        if (requestParameters['channelUpsertRequest'] == null) {
+            throw new runtime.RequiredError('channelUpsertRequest', 'Required parameter "channelUpsertRequest" was null or undefined when calling upsertAlertChannel().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            // oauth required
+            const oauthToken = await this.configuration.accessToken("OAuth2", ["openid", "profile", "email"]);
+            if (oauthToken) {
+                headerParameters["Authorization"] = oauthToken.startsWith("Bearer ") ? oauthToken : `Bearer ${oauthToken}`;
+            }
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiKey", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/api/notification/public/v1/channels`;
+        return {
+            path: urlPath,
+            method: 'PUT',
+            headers: headerParameters,
+            query: queryParameters,
+            body: ChannelUpsertRequestToJSON(requestParameters['channelUpsertRequest']),
+        };
+    }
+    /**
+     * Upserts one channel and **replaces** its subscription set.  Without `id`, the channel is keyed on its type\'s natural identity, so an identical call is idempotent rather than duplicating: `email` by address, `webhook` by URL, `slack` by channel id, personal types by (organization, type, caller). With `id` it is an authoritative edit of that row — the only way to update a `teams` channel, whose natural identity is a secret URL.  `subscriptions` is replaced wholesale, not merged: send the complete desired set, and expect an omitted list to unsubscribe the channel from everything.  Creating a `webhook` channel reveals its signing secret in `signing_secret` ONCE; it is not readable afterwards. The secret is only generated when the row is new, so a retried create that lands after the first succeeded returns `signing_secret: null`. If you need a secret and got `null`, call `POST /channels/{channel_id}/regenerate-secret`.
+     * Create or update a notification channel
+     */
+    async upsertAlertChannelRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.upsertAlertChannelRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => ChannelResponseFromJSON(jsonValue));
+    }
+    /**
+     * Upserts one channel and **replaces** its subscription set.  Without `id`, the channel is keyed on its type\'s natural identity, so an identical call is idempotent rather than duplicating: `email` by address, `webhook` by URL, `slack` by channel id, personal types by (organization, type, caller). With `id` it is an authoritative edit of that row — the only way to update a `teams` channel, whose natural identity is a secret URL.  `subscriptions` is replaced wholesale, not merged: send the complete desired set, and expect an omitted list to unsubscribe the channel from everything.  Creating a `webhook` channel reveals its signing secret in `signing_secret` ONCE; it is not readable afterwards. The secret is only generated when the row is new, so a retried create that lands after the first succeeded returns `signing_secret: null`. If you need a secret and got `null`, call `POST /channels/{channel_id}/regenerate-secret`.
+     * Create or update a notification channel
+     */
+    async upsertAlertChannel(requestParameters, initOverrides) {
+        const response = await this.upsertAlertChannelRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}