@trycourier/courier 6.1.0 → 6.1.2

package/api/resources/commons/errors/PaymentRequiredError.js

@@ -27,7 +27,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentRequiredError = void 0;
-const errors = __importStar(require("../../../../errors"));
+const errors = __importStar(require("../../../../errors/index"));
 class PaymentRequiredError extends errors.CourierError {
     constructor(body) {
         super({

package/api/resources/commons/types/AlreadyExists.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface AlreadyExists extends Courier.BaseError {
     type: "invalid_request_error";
 }

package/api/resources/commons/types/BadRequest.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface BadRequest extends Courier.BaseError {
     type: "invalid_request_error";
 }

package/api/resources/commons/types/ChannelPreference.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface ChannelPreference {
     channel: Courier.ChannelClassification;
 }

package/api/resources/commons/types/Conflict.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface Conflict extends Courier.BaseError {
     type: "invalid_request_error";
 }

package/api/resources/commons/types/MessageNotFound.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface MessageNotFound extends Courier.BaseError {
     type: "invalid_request_error";
 }

package/api/resources/commons/types/NotFound.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface NotFound extends Courier.BaseError {
     type: "invalid_request_error";
 }

package/api/resources/commons/types/NotificationPreferenceDetails.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface NotificationPreferenceDetails {
     status: Courier.PreferenceStatus;
     rules?: Courier.Rule[];

package/api/resources/commons/types/NotificationPreferences.d.ts

@@ -1,5 +1,5 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export declare type NotificationPreferences = Record<string, Courier.NotificationPreferenceDetails>;

package/api/resources/commons/types/PaymentRequired.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface PaymentRequired extends Courier.BaseError {
     type: "authorization_error";
 }

package/api/resources/commons/types/RecipientPreferences.d.ts

@@ -1,7 +1,7 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export interface RecipientPreferences {
     categories?: Courier.NotificationPreferences;
     notifications?: Courier.NotificationPreferences;

package/api/resources/commons/types/UserTenantAssociation.d.ts

@@ -3,9 +3,10 @@
  */
 export interface UserTenantAssociation {
     /** User ID for the assocation between tenant and user */
-    user_id: string;
-    type: "user";
+    user_id?: string;
+    type?: "user";
     /** Tenant ID for the assocation between tenant and user */
     tenant_id: string;
-    profile: Record<string, any>;
+    /** Additional metadata to be applied to a user profile when used in a tenant context */
+    profile?: Record<string, any>;
 }

package/api/resources/lists/client/Client.d.ts

@@ -3,7 +3,7 @@
  */
 import * as environments from "../../../../environments";
 import * as core from "../../../../core";
-import * as Courier from "../../..";
+import * as Courier from "../../../index";
 export declare namespace Lists {
     interface Options {
         environment?: core.Supplier<environments.CourierEnvironment | string>;
@@ -16,7 +16,7 @@ export declare namespace Lists {
     }
     interface IdempotentRequestOptions extends RequestOptions {
         idempotencyKey?: string | undefined;
-        idempotencyExpiry?: number | undefined;
+        idempotencyExpiry?: string | undefined;
     }
 }
 export declare class Lists {
@@ -24,48 +24,241 @@ export declare class Lists {
     constructor(_options?: Lists.Options);
     /**
      * Returns all of the lists, with the ability to filter based on a pattern.
+     *
+     * @param {Courier.GetAllListsRequest} request
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link Courier.BadRequestError}
+     *
+     * @example
+     *     await courier.lists.list({
+     *         cursor: "string",
+     *         pattern: "string"
+     *     })
      */
     list(request?: Courier.GetAllListsRequest, requestOptions?: Lists.RequestOptions): Promise<Courier.ListGetAllResponse>;
     /**
      * Returns a list based on the list ID provided.
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link Courier.NotFoundError}
+     *
+     * @example
+     *     await courier.lists.get("string")
      */
     get(listId: string, requestOptions?: Lists.RequestOptions): Promise<Courier.List>;
     /**
      * Create or replace an existing list with the supplied values.
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {Courier.ListPutParams} request
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await courier.lists.update("string", {
+     *         name: "string",
+     *         preferences: {
+     *             categories: {
+     *                 "string": {
+     *                     status: Courier.PreferenceStatus.OptedIn,
+     *                     rules: [{
+     *                             start: "string",
+     *                             until: "string"
+     *                         }],
+     *                     channel_preferences: [{
+     *                             channel: Courier.ChannelClassification.DirectMessage
+     *                         }]
+     *                 }
+     *             },
+     *             notifications: {
+     *                 "string": {
+     *                     status: Courier.PreferenceStatus.OptedIn,
+     *                     rules: [{
+     *                             start: "string",
+     *                             until: "string"
+     *                         }],
+     *                     channel_preferences: [{
+     *                             channel: Courier.ChannelClassification.DirectMessage
+     *                         }]
+     *                 }
+     *             }
+     *         }
+     *     })
      */
     update(listId: string, request: Courier.ListPutParams, requestOptions?: Lists.RequestOptions): Promise<Courier.List>;
     /**
      * Delete a list by list ID.
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await courier.lists.delete("string")
      */
     delete(listId: string, requestOptions?: Lists.RequestOptions): Promise<void>;
     /**
      * Restore a previously deleted list.
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await courier.lists.restore("string")
      */
     restore(listId: string, requestOptions?: Lists.RequestOptions): Promise<void>;
     /**
      * Get the list's subscriptions.
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {Courier.GetSubscriptionForListRequest} request
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link Courier.NotFoundError}
+     *
+     * @example
+     *     await courier.lists.getSubscribers("string", {
+     *         cursor: "string"
+     *     })
      */
     getSubscribers(listId: string, request?: Courier.GetSubscriptionForListRequest, requestOptions?: Lists.RequestOptions): Promise<Courier.ListGetSubscriptionsResponse>;
     /**
      * Subscribes the users to the list, overwriting existing subscriptions. If the list does not exist, it will be automatically created.
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {Courier.SubscribeUsersToListRequest} request
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link Courier.BadRequestError}
+     *
+     * @example
+     *     await courier.lists.updateSubscribers("string", {
+     *         recipients: [{
+     *                 recipientId: "string",
+     *                 preferences: {
+     *                     categories: {
+     *                         "string": {
+     *                             status: Courier.PreferenceStatus.OptedIn,
+     *                             rules: [{
+     *                                     start: "string",
+     *                                     until: "string"
+     *                                 }],
+     *                             channel_preferences: [{
+     *                                     channel: Courier.ChannelClassification.DirectMessage
+     *                                 }]
+     *                         }
+     *                     },
+     *                     notifications: {
+     *                         "string": {
+     *                             status: Courier.PreferenceStatus.OptedIn,
+     *                             rules: [{
+     *                                     start: "string",
+     *                                     until: "string"
+     *                                 }],
+     *                             channel_preferences: [{
+     *                                     channel: Courier.ChannelClassification.DirectMessage
+     *                                 }]
+     *                         }
+     *                     }
+     *                 }
+     *             }]
+     *     })
      */
-    updateSubscribers(listId: string, request: Courier.PutSubscriptionsRecipient[], requestOptions?: Lists.RequestOptions): Promise<void>;
+    updateSubscribers(listId: string, request: Courier.SubscribeUsersToListRequest, requestOptions?: Lists.RequestOptions): Promise<void>;
     /**
      * Subscribes additional users to the list, without modifying existing subscriptions. If the list does not exist, it will be automatically created.
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {Courier.AddSubscribersToList} request
+     * @param {Lists.IdempotentRequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link Courier.BadRequestError}
+     *
+     * @example
+     *     await courier.lists.addSubscribers("string", {
+     *         recipients: [{
+     *                 recipientId: "string",
+     *                 preferences: {
+     *                     categories: {
+     *                         "string": {
+     *                             status: Courier.PreferenceStatus.OptedIn,
+     *                             rules: [{
+     *                                     start: "string",
+     *                                     until: "string"
+     *                                 }],
+     *                             channel_preferences: [{
+     *                                     channel: Courier.ChannelClassification.DirectMessage
+     *                                 }]
+     *                         }
+     *                     },
+     *                     notifications: {
+     *                         "string": {
+     *                             status: Courier.PreferenceStatus.OptedIn,
+     *                             rules: [{
+     *                                     start: "string",
+     *                                     until: "string"
+     *                                 }],
+     *                             channel_preferences: [{
+     *                                     channel: Courier.ChannelClassification.DirectMessage
+     *                                 }]
+     *                         }
+     *                     }
+     *                 }
+     *             }]
+     *     })
      */
-    addSubscribers(listId: string, request: Courier.PutSubscriptionsRecipient[], requestOptions?: Lists.IdempotentRequestOptions): Promise<void>;
+    addSubscribers(listId: string, request: Courier.AddSubscribersToList, requestOptions?: Lists.IdempotentRequestOptions): Promise<void>;
     /**
      * Subscribe a user to an existing list (note: if the List does not exist, it will be automatically created).
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {string} userId - A unique identifier representing the recipient associated with the list
+     * @param {Courier.SubscribeUserToListRequest} request
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await courier.lists.subscribe("string", "string", {
+     *         preferences: {
+     *             categories: {
+     *                 "string": {
+     *                     status: Courier.PreferenceStatus.OptedIn,
+     *                     rules: [{
+     *                             start: "string",
+     *                             until: "string"
+     *                         }],
+     *                     channel_preferences: [{
+     *                             channel: Courier.ChannelClassification.DirectMessage
+     *                         }]
+     *                 }
+     *             },
+     *             notifications: {
+     *                 "string": {
+     *                     status: Courier.PreferenceStatus.OptedIn,
+     *                     rules: [{
+     *                             start: "string",
+     *                             until: "string"
+     *                         }],
+     *                     channel_preferences: [{
+     *                             channel: Courier.ChannelClassification.DirectMessage
+     *                         }]
+     *                 }
+     *             }
+     *         }
+     *     })
      */
     subscribe(listId: string, userId: string, request?: Courier.SubscribeUserToListRequest, requestOptions?: Lists.RequestOptions): Promise<void>;
     /**
      * Delete a subscription to a list by list ID and user ID.
+     *
+     * @param {string} listId - A unique identifier representing the list you wish to retrieve.
+     * @param {string} userId - A unique identifier representing the recipient associated with the list
+     * @param {Lists.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link Courier.NotFoundError}
+     *
+     * @example
+     *     await courier.lists.unsubscribe("string", "string")
      */
     unsubscribe(listId: string, userId: string, requestOptions?: Lists.RequestOptions): Promise<void>;
     protected _getAuthorizationHeader(): Promise<string>;