@novu/api 1.5.0 → 1.6.0

package/src/funcs/subscribersCreate.ts

@@ -3,7 +3,7 @@
  */
 
 import { NovuCore } from "../core.js";
-import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { encodeFormQuery, encodeJSON, encodeSimple } from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
@@ -36,11 +36,13 @@ import { Result } from "../types/fp.js";
 export function subscribersCreate(
   client: NovuCore,
   createSubscriberRequestDto: components.CreateSubscriberRequestDto,
+  failIfExists?: boolean | undefined,
   idempotencyKey?: string | undefined,
   options?: RequestOptions,
 ): APIPromise<
   Result<
     operations.SubscribersControllerCreateSubscriberResponse,
+    | errors.SubscriberResponseDto
     | errors.ErrorDto
     | errors.ValidationErrorDto
     | NovuError
@@ -56,6 +58,7 @@ export function subscribersCreate(
   return new APIPromise($do(
     client,
     createSubscriberRequestDto,
+    failIfExists,
     idempotencyKey,
     options,
   ));
@@ -64,12 +67,14 @@ export function subscribersCreate(
 async function $do(
   client: NovuCore,
   createSubscriberRequestDto: components.CreateSubscriberRequestDto,
+  failIfExists?: boolean | undefined,
   idempotencyKey?: string | undefined,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
       operations.SubscribersControllerCreateSubscriberResponse,
+      | errors.SubscriberResponseDto
       | errors.ErrorDto
       | errors.ValidationErrorDto
       | NovuError
@@ -86,6 +91,7 @@ async function $do(
 > {
   const input: operations.SubscribersControllerCreateSubscriberRequest = {
     createSubscriberRequestDto: createSubscriberRequestDto,
+    failIfExists: failIfExists,
     idempotencyKey: idempotencyKey,
   };
 
@@ -106,6 +112,10 @@ async function $do(
 
   const path = pathToFunc("/v2/subscribers")();
 
+  const query = encodeFormQuery({
+    "failIfExists": payload.failIfExists,
+  });
+
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
     Accept: "application/json",
@@ -151,6 +161,7 @@ async function $do(
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
+    query: query,
     body: body,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
@@ -193,6 +204,7 @@ async function $do(
 
   const [result] = await M.match<
     operations.SubscribersControllerCreateSubscriberResponse,
+    | errors.SubscriberResponseDto
     | errors.ErrorDto
     | errors.ValidationErrorDto
     | NovuError
@@ -209,9 +221,10 @@ async function $do(
       operations.SubscribersControllerCreateSubscriberResponse$inboundSchema,
       { hdrs: true, key: "Result" },
     ),
+    M.jsonErr(409, errors.SubscriberResponseDto$inboundSchema, { hdrs: true }),
     M.jsonErr(414, errors.ErrorDto$inboundSchema),
     M.jsonErr(
-      [400, 401, 403, 404, 405, 409, 413, 415],
+      [400, 401, 403, 404, 405, 413, 415],
       errors.ErrorDto$inboundSchema,
       { hdrs: true },
     ),

package/src/funcs/subscribersCredentialsAppend.ts

@@ -27,10 +27,10 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Create or Partially Update provider credentials
+ * Update provider credentials
  *
  * @remarks
- * Create or Partially credentials for a provider such as **slack** and **FCM**.
+ * Update credentials for a provider such as **slack** and **FCM**.
  *       **providerId** is required field. This API creates the **deviceTokens** or replaces the existing ones.
  */
 export function subscribersCredentialsAppend(

package/src/funcs/{retrieve.ts → subscribersPreferencesBulkUpdate.ts}

@@ -3,13 +3,14 @@
  */
 
 import { NovuCore } from "../core.js";
-import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 import { RequestOptions } from "../lib/sdks.js";
 import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
 import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
 import {
   ConnectionError,
   InvalidRequestError,
@@ -17,6 +18,7 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
 import { NovuError } from "../models/errors/novuerror.js";
 import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
@@ -24,13 +26,25 @@ import * as operations from "../models/operations/index.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
-export function retrieve(
+/**
+ * Bulk update subscriber preferences
+ *
+ * @remarks
+ * Bulk update subscriber preferences by its unique key identifier **subscriberId**.
+ *     This API allows updating multiple workflow preferences in a single request.
+ */
+export function subscribersPreferencesBulkUpdate(
   client: NovuCore,
-  request: operations.LogsControllerGetLogsRequest,
+  bulkUpdateSubscriberPreferencesDto:
+    components.BulkUpdateSubscriberPreferencesDto,
+  subscriberId: string,
+  idempotencyKey?: string | undefined,
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    operations.LogsControllerGetLogsResponseBody,
+    operations.SubscribersControllerBulkUpdateSubscriberPreferencesResponse,
+    | errors.ErrorDto
+    | errors.ValidationErrorDto
     | NovuError
     | ResponseValidationError
     | ConnectionError
@@ -43,19 +57,26 @@ export function retrieve(
 > {
   return new APIPromise($do(
     client,
-    request,
+    bulkUpdateSubscriberPreferencesDto,
+    subscriberId,
+    idempotencyKey,
     options,
   ));
 }
 
 async function $do(
   client: NovuCore,
-  request: operations.LogsControllerGetLogsRequest,
+  bulkUpdateSubscriberPreferencesDto:
+    components.BulkUpdateSubscriberPreferencesDto,
+  subscriberId: string,
+  idempotencyKey?: string | undefined,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
-      operations.LogsControllerGetLogsResponseBody,
+      operations.SubscribersControllerBulkUpdateSubscriberPreferencesResponse,
+      | errors.ErrorDto
+      | errors.ValidationErrorDto
       | NovuError
       | ResponseValidationError
       | ConnectionError
@@ -68,31 +89,42 @@ async function $do(
     APICall,
   ]
 > {
+  const input:
+    operations.SubscribersControllerBulkUpdateSubscriberPreferencesRequest = {
+      bulkUpdateSubscriberPreferencesDto: bulkUpdateSubscriberPreferencesDto,
+      subscriberId: subscriberId,
+      idempotencyKey: idempotencyKey,
+    };
+
   const parsed = safeParse(
-    request,
+    input,
     (value) =>
-      operations.LogsControllerGetLogsRequest$outboundSchema.parse(value),
+      operations
+        .SubscribersControllerBulkUpdateSubscriberPreferencesRequest$outboundSchema
+        .parse(value),
     "Input validation failed",
   );
   if (!parsed.ok) {
     return [parsed, { status: "invalid" }];
   }
   const payload = parsed.value;
-  const body = null;
-
-  const path = pathToFunc("/v1/logs/requests")();
-
-  const query = encodeFormQuery({
-    "created": payload.created,
-    "limit": payload.limit,
-    "page": payload.page,
-    "statusCode": payload.statusCode,
-    "transactionId": payload.transactionId,
-    "url": payload.url,
-    "url_pattern": payload.url_pattern,
+  const body = encodeJSON("body", payload.BulkUpdateSubscriberPreferencesDto, {
+    explode: true,
   });
 
+  const pathParams = {
+    subscriberId: encodeSimple("subscriberId", payload.subscriberId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/v2/subscribers/{subscriberId}/preferences/bulk")(
+    pathParams,
+  );
+
   const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
     Accept: "application/json",
     "idempotency-key": encodeSimple(
       "idempotency-key",
@@ -108,7 +140,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "LogsController_getLogs",
+    operationID: "SubscribersController_bulkUpdateSubscriberPreferences",
     oAuth2Scopes: [],
 
     resolvedSecurity: requestSecurity,
@@ -132,11 +164,10 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "GET",
+    method: "PATCH",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
-    query: query,
     body: body,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
@@ -148,7 +179,23 @@ async function $do(
 
   const doResult = await client._do(req, {
     context,
-    errorCodes: ["4XX", "5XX"],
+    errorCodes: [
+      "400",
+      "401",
+      "403",
+      "404",
+      "405",
+      "409",
+      "413",
+      "414",
+      "415",
+      "422",
+      "429",
+      "4XX",
+      "500",
+      "503",
+      "5XX",
+    ],
     retryConfig: context.retryConfig,
     retryCodes: context.retryCodes,
   });
@@ -157,8 +204,14 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
-    operations.LogsControllerGetLogsResponseBody,
+    operations.SubscribersControllerBulkUpdateSubscriberPreferencesResponse,
+    | errors.ErrorDto
+    | errors.ValidationErrorDto
     | NovuError
     | ResponseValidationError
     | ConnectionError
@@ -168,10 +221,25 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, operations.LogsControllerGetLogsResponseBody$inboundSchema),
+    M.json(
+      200,
+      operations
+        .SubscribersControllerBulkUpdateSubscriberPreferencesResponse$inboundSchema,
+      { hdrs: true, key: "Result" },
+    ),
+    M.jsonErr(414, errors.ErrorDto$inboundSchema),
+    M.jsonErr(
+      [400, 401, 403, 404, 405, 409, 413, 415],
+      errors.ErrorDto$inboundSchema,
+      { hdrs: true },
+    ),
+    M.jsonErr(422, errors.ValidationErrorDto$inboundSchema, { hdrs: true }),
+    M.fail(429),
+    M.jsonErr(500, errors.ErrorDto$inboundSchema, { hdrs: true }),
+    M.fail(503),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }

package/src/funcs/topicsCreate.ts

@@ -3,7 +3,7 @@
  */
 
 import { NovuCore } from "../core.js";
-import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { encodeFormQuery, encodeJSON, encodeSimple } from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
@@ -30,16 +30,18 @@ import { Result } from "../types/fp.js";
  * Create a topic
  *
  * @remarks
- * Creates a new topic if it does not exist, or updates an existing topic if it already exists
+ * Creates a new topic if it does not exist, or updates an existing topic if it already exists. Use ?failIfExists=true to prevent updates.
  */
 export function topicsCreate(
   client: NovuCore,
   createUpdateTopicRequestDto: components.CreateUpdateTopicRequestDto,
+  failIfExists?: boolean | undefined,
   idempotencyKey?: string | undefined,
   options?: RequestOptions,
 ): APIPromise<
   Result<
     operations.TopicsControllerUpsertTopicResponse,
+    | errors.TopicResponseDto
     | errors.ErrorDto
     | errors.ValidationErrorDto
     | NovuError
@@ -55,6 +57,7 @@ export function topicsCreate(
   return new APIPromise($do(
     client,
     createUpdateTopicRequestDto,
+    failIfExists,
     idempotencyKey,
     options,
   ));
@@ -63,12 +66,14 @@ export function topicsCreate(
 async function $do(
   client: NovuCore,
   createUpdateTopicRequestDto: components.CreateUpdateTopicRequestDto,
+  failIfExists?: boolean | undefined,
   idempotencyKey?: string | undefined,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
       operations.TopicsControllerUpsertTopicResponse,
+      | errors.TopicResponseDto
       | errors.ErrorDto
       | errors.ValidationErrorDto
       | NovuError
@@ -85,6 +90,7 @@ async function $do(
 > {
   const input: operations.TopicsControllerUpsertTopicRequest = {
     createUpdateTopicRequestDto: createUpdateTopicRequestDto,
+    failIfExists: failIfExists,
     idempotencyKey: idempotencyKey,
   };
 
@@ -104,6 +110,10 @@ async function $do(
 
   const path = pathToFunc("/v2/topics")();
 
+  const query = encodeFormQuery({
+    "failIfExists": payload.failIfExists,
+  });
+
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
     Accept: "application/json",
@@ -149,6 +159,7 @@ async function $do(
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
+    query: query,
     body: body,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
@@ -191,6 +202,7 @@ async function $do(
 
   const [result] = await M.match<
     operations.TopicsControllerUpsertTopicResponse,
+    | errors.TopicResponseDto
     | errors.ErrorDto
     | errors.ValidationErrorDto
     | NovuError
@@ -207,9 +219,10 @@ async function $do(
       operations.TopicsControllerUpsertTopicResponse$inboundSchema,
       { hdrs: true, key: "Result" },
     ),
+    M.jsonErr(409, errors.TopicResponseDto$inboundSchema, { hdrs: true }),
     M.jsonErr(414, errors.ErrorDto$inboundSchema),
     M.jsonErr(
-      [400, 401, 403, 404, 405, 409, 413, 415],
+      [400, 401, 403, 404, 405, 413, 415],
       errors.ErrorDto$inboundSchema,
       { hdrs: true },
     ),

package/src/funcs/trigger.ts

@@ -31,9 +31,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  *
- *     Trigger event is the main (and only) way to send notifications to subscribers.
- *     The trigger identifier is used to match the particular workflow associated with it.
- *     Additional information can be passed according the body interface below.
+ *     Trigger event is the main (and only) way to send notifications to subscribers. The trigger identifier is used to match the particular workflow associated with it. Additional information can be passed according the body interface below.
+ *     To prevent duplicate triggers, you can optionally pass a **transactionId** in the request body. If the same **transactionId** is used again, the trigger will be ignored. The retention period depends on your billing tier.
  */
 export function trigger(
   client: NovuCore,

package/src/lib/config.ts

@@ -59,7 +59,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2.3.0",
-  sdkVersion: "1.5.0",
-  genVersion: "2.661.4",
-  userAgent: "speakeasy-sdk/typescript 1.5.0 2.661.4 2.3.0 @novu/api",
+  sdkVersion: "1.6.0",
+  genVersion: "2.684.0",
+  userAgent: "speakeasy-sdk/typescript 1.6.0 2.684.0 2.3.0 @novu/api",
 } as const;

package/src/lib/security.ts

@@ -83,7 +83,10 @@ type SecurityInputOAuth2 = {
 type SecurityInputOAuth2ClientCredentials = {
   type: "oauth2:client_credentials";
   value:
-    | { clientID?: string | undefined; clientSecret?: string | undefined }
+    | {
+      clientID?: string | undefined;
+      clientSecret?: string | undefined;
+    }
     | null
     | string
     | undefined;

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "1.5.0",
+    currentVersion: "1.6.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -30,7 +30,6 @@ import { tool$messagesDeleteByTransactionId } from "./tools/messagesDeleteByTran
 import { tool$messagesRetrieve } from "./tools/messagesRetrieve.js";
 import { tool$notificationsList } from "./tools/notificationsList.js";
 import { tool$notificationsRetrieve } from "./tools/notificationsRetrieve.js";
-import { tool$retrieve } from "./tools/retrieve.js";
 import { tool$subscribersCreate } from "./tools/subscribersCreate.js";
 import { tool$subscribersCreateBulk } from "./tools/subscribersCreateBulk.js";
 import { tool$subscribersCredentialsAppend } from "./tools/subscribersCredentialsAppend.js";
@@ -43,6 +42,7 @@ import { tool$subscribersMessagesUpdateAsSeen } from "./tools/subscribersMessage
 import { tool$subscribersNotificationsFeed } from "./tools/subscribersNotificationsFeed.js";
 import { tool$subscribersNotificationsUnseenCount } from "./tools/subscribersNotificationsUnseenCount.js";
 import { tool$subscribersPatch } from "./tools/subscribersPatch.js";
+import { tool$subscribersPreferencesBulkUpdate } from "./tools/subscribersPreferencesBulkUpdate.js";
 import { tool$subscribersPreferencesList } from "./tools/subscribersPreferencesList.js";
 import { tool$subscribersPreferencesUpdate } from "./tools/subscribersPreferencesUpdate.js";
 import { tool$subscribersPropertiesUpdateOnlineFlag } from "./tools/subscribersPropertiesUpdateOnlineFlag.js";
@@ -80,7 +80,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Novu",
-    version: "1.5.0",
+    version: "1.6.0",
   });
 
   const client = new NovuCore({
@@ -114,7 +114,6 @@ export function createMCPServer(deps: {
   tool(tool$cancel);
   tool(tool$triggerBroadcast);
   tool(tool$triggerBulk);
-  tool(tool$retrieve);
   tool(tool$environmentsGetTags);
   tool(tool$environmentsCreate);
   tool(tool$environmentsList);
@@ -151,6 +150,7 @@ export function createMCPServer(deps: {
   tool(tool$notificationsRetrieve);
   tool(tool$subscribersPreferencesList);
   tool(tool$subscribersPreferencesUpdate);
+  tool(tool$subscribersPreferencesBulkUpdate);
   tool(tool$subscribersTopicsList);
   tool(tool$subscribersCredentialsUpdate);
   tool(tool$subscribersCredentialsAppend);

package/src/mcp-server/tools/subscribersCreate.ts

@@ -10,6 +10,7 @@ import { formatResult, ToolDefinition } from "../tools.js";
 const args = {
   createSubscriberRequestDto:
     components.CreateSubscriberRequestDto$inboundSchema,
+  failIfExists: z.boolean().optional(),
   idempotencyKey: z.string().optional(),
 };
 
@@ -24,6 +25,7 @@ Create a subscriber with the subscriber attributes.
     const [result, apiCall] = await subscribersCreate(
       client,
       args.createSubscriberRequestDto,
+      args.failIfExists,
       args.idempotencyKey,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();

package/src/mcp-server/tools/subscribersCredentialsAppend.ts

@@ -16,9 +16,9 @@ const args = {
 
 export const tool$subscribersCredentialsAppend: ToolDefinition<typeof args> = {
   name: "subscribers-credentials-append",
-  description: `Create or Partially Update provider credentials
+  description: `Update provider credentials
 
-Create or Partially credentials for a provider such as **slack** and **FCM**. 
+Update credentials for a provider such as **slack** and **FCM**. 
       **providerId** is required field. This API creates the **deviceTokens** or replaces the existing ones.`,
   args,
   tool: async (client, args, ctx) => {

package/src/mcp-server/tools/subscribersPreferencesBulkUpdate.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { subscribersPreferencesBulkUpdate } from "../../funcs/subscribersPreferencesBulkUpdate.js";
+import * as components from "../../models/components/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  bulkUpdateSubscriberPreferencesDto:
+    components.BulkUpdateSubscriberPreferencesDto$inboundSchema,
+  subscriberId: z.string(),
+  idempotencyKey: z.string().optional(),
+};
+
+export const tool$subscribersPreferencesBulkUpdate: ToolDefinition<
+  typeof args
+> = {
+  name: "subscribers-preferences-bulk-update",
+  description: `Bulk update subscriber preferences
+
+Bulk update subscriber preferences by its unique key identifier **subscriberId**. 
+    This API allows updating multiple workflow preferences in a single request.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await subscribersPreferencesBulkUpdate(
+      client,
+      args.bulkUpdateSubscriberPreferencesDto,
+      args.subscriberId,
+      args.idempotencyKey,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/topicsCreate.ts

@@ -10,6 +10,7 @@ import { formatResult, ToolDefinition } from "../tools.js";
 const args = {
   createUpdateTopicRequestDto:
     components.CreateUpdateTopicRequestDto$inboundSchema,
+  failIfExists: z.boolean().optional(),
   idempotencyKey: z.string().optional(),
 };
 
@@ -17,12 +18,13 @@ export const tool$topicsCreate: ToolDefinition<typeof args> = {
   name: "topics-create",
   description: `Create a topic
 
-Creates a new topic if it does not exist, or updates an existing topic if it already exists`,
+Creates a new topic if it does not exist, or updates an existing topic if it already exists. Use ?failIfExists=true to prevent updates.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await topicsCreate(
       client,
       args.createUpdateTopicRequestDto,
+      args.failIfExists,
       args.idempotencyKey,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();

package/src/mcp-server/tools/trigger.ts

@@ -17,10 +17,8 @@ export const tool$trigger: ToolDefinition<typeof args> = {
   description: `Trigger event
 
 
-    Trigger event is the main (and only) way to send notifications to subscribers. 
-    The trigger identifier is used to match the particular workflow associated with it. 
-    Additional information can be passed according the body interface below.
-    `,
+    Trigger event is the main (and only) way to send notifications to subscribers. The trigger identifier is used to match the particular workflow associated with it. Additional information can be passed according the body interface below.
+    To prevent duplicate triggers, you can optionally pass a **transactionId** in the request body. If the same **transactionId** is used again, the trigger will be ignored. The retention period depends on your billing tier.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await trigger(