@trycourier/courier 7.10.1 → 7.11.0

package/src/resources/notifications/notifications.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as NotificationsAPI from './notifications';
 import * as Shared from '../shared';
 import * as ChecksAPI from './checks';
 import {
@@ -26,7 +25,7 @@ export class Notifications extends APIResource {
    *
    * @example
    * ```ts
-   * const notificationTemplateGetResponse =
+   * const notificationTemplateResponse =
    *   await client.notifications.create({
    *     notification: {
    *       name: 'Welcome Email',
@@ -43,10 +42,7 @@ export class Notifications extends APIResource {
    *   });
    * ```
    */
-  create(
-    body: NotificationCreateParams,
-    options?: RequestOptions,
-  ): APIPromise<NotificationTemplateGetResponse> {
+  create(body: NotificationCreateParams, options?: RequestOptions): APIPromise<NotificationTemplateResponse> {
     return this._client.post('/notifications', { body, ...options });
   }
 
@@ -56,7 +52,7 @@ export class Notifications extends APIResource {
    *
    * @example
    * ```ts
-   * const notificationTemplateGetResponse =
+   * const notificationTemplateResponse =
    *   await client.notifications.retrieve('id');
    * ```
    */
@@ -64,7 +60,7 @@ export class Notifications extends APIResource {
     id: string,
     query: NotificationRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<NotificationTemplateGetResponse> {
+  ): APIPromise<NotificationTemplateResponse> {
     return this._client.get(path`/notifications/${id}`, { query, ...options });
   }
 
@@ -217,7 +213,7 @@ export class Notifications extends APIResource {
    *
    * @example
    * ```ts
-   * const notificationTemplateGetResponse =
+   * const notificationTemplateResponse =
    *   await client.notifications.replace('id', {
    *     notification: {
    *       name: 'Updated Name',
@@ -238,7 +234,7 @@ export class Notifications extends APIResource {
     id: string,
     body: NotificationReplaceParams,
     options?: RequestOptions,
-  ): APIPromise<NotificationTemplateGetResponse> {
+  ): APIPromise<NotificationTemplateResponse> {
     return this._client.put(path`/notifications/${id}`, { body, ...options });
   }
 
@@ -513,8 +509,8 @@ export namespace NotificationLocalePutRequest {
  */
 export interface NotificationTemplateCreateRequest {
   /**
-   * Full document shape used in POST and PUT request bodies, and returned inside the
-   * GET response envelope.
+   * Core template fields used in POST and PUT request bodies (nested under a
+   * `notification` key) and returned at the top level in responses.
    */
   notification: NotificationTemplatePayload;
 
@@ -526,58 +522,8 @@ export interface NotificationTemplateCreateRequest {
 }
 
 /**
- * Envelope response for GET /notifications/{id}. The notification object mirrors
- * the POST/PUT input shape. Nullable fields return null when unset.
- */
-export interface NotificationTemplateGetResponse {
-  /**
-   * Epoch milliseconds when the template was created.
-   */
-  created: number;
-
-  /**
-   * User ID of the creator.
-   */
-  creator: string;
-
-  /**
-   * Full document shape used in POST and PUT request bodies, and returned inside the
-   * GET response envelope.
-   */
-  notification: NotificationTemplateGetResponse.Notification;
-
-  /**
-   * The template state. Always uppercase.
-   */
-  state: 'DRAFT' | 'PUBLISHED';
-
-  /**
-   * Epoch milliseconds of last update.
-   */
-  updated?: number;
-
-  /**
-   * User ID of the last updater.
-   */
-  updater?: string;
-}
-
-export namespace NotificationTemplateGetResponse {
-  /**
-   * Full document shape used in POST and PUT request bodies, and returned inside the
-   * GET response envelope.
-   */
-  export interface Notification extends NotificationsAPI.NotificationTemplatePayload {
-    /**
-     * The template ID.
-     */
-    id: string;
-  }
-}
-
-/**
- * Full document shape used in POST and PUT request bodies, and returned inside the
- * GET response envelope.
+ * Core template fields used in POST and PUT request bodies (nested under a
+ * `notification` key) and returned at the top level in responses.
  */
 export interface NotificationTemplatePayload {
   /**
@@ -645,6 +591,42 @@ export interface NotificationTemplatePublishRequest {
   version?: string;
 }
 
+/**
+ * Response for GET /notifications/{id}, POST /notifications, and PUT
+ * /notifications/{id}. Returns all template fields at the top level.
+ */
+export interface NotificationTemplateResponse extends NotificationTemplatePayload {
+  /**
+   * The template ID.
+   */
+  id: string;
+
+  /**
+   * Epoch milliseconds when the template was created.
+   */
+  created: number;
+
+  /**
+   * User ID of the creator.
+   */
+  creator: string;
+
+  /**
+   * The template state. Always uppercase.
+   */
+  state: 'DRAFT' | 'PUBLISHED';
+
+  /**
+   * Epoch milliseconds of last update.
+   */
+  updated?: number;
+
+  /**
+   * User ID of the last updater.
+   */
+  updater?: string;
+}
+
 /**
  * Template state. Defaults to `DRAFT`.
  */
@@ -689,8 +671,8 @@ export interface NotificationTemplateSummary {
  */
 export interface NotificationTemplateUpdateRequest {
   /**
-   * Full document shape used in POST and PUT request bodies, and returned inside the
-   * GET response envelope.
+   * Core template fields used in POST and PUT request bodies (nested under a
+   * `notification` key) and returned at the top level in responses.
    */
   notification: NotificationTemplatePayload;
 
@@ -753,14 +735,14 @@ export namespace NotificationListResponse {
      */
     event_ids: Array<string>;
 
-    note: string;
-
     routing: Shared.MessageRouting;
 
     topic_id: string;
 
     updated_at: number;
 
+    note?: string;
+
     tags?: Notification.Tags | null;
 
     title?: string | null;
@@ -789,8 +771,8 @@ export type NotificationRetrieveContentResponse = NotificationContentGetResponse
 
 export interface NotificationCreateParams {
   /**
-   * Full document shape used in POST and PUT request bodies, and returned inside the
-   * GET response envelope.
+   * Core template fields used in POST and PUT request bodies (nested under a
+   * `notification` key) and returned at the top level in responses.
    */
   notification: NotificationTemplatePayload;
 
@@ -946,8 +928,8 @@ export namespace NotificationPutLocaleParams {
 
 export interface NotificationReplaceParams {
   /**
-   * Full document shape used in POST and PUT request bodies, and returned inside the
-   * GET response envelope.
+   * Core template fields used in POST and PUT request bodies (nested under a
+   * `notification` key) and returned at the top level in responses.
    */
   notification: NotificationTemplatePayload;
 
@@ -980,9 +962,9 @@ export declare namespace Notifications {
     type NotificationGetContent as NotificationGetContent,
     type NotificationLocalePutRequest as NotificationLocalePutRequest,
     type NotificationTemplateCreateRequest as NotificationTemplateCreateRequest,
-    type NotificationTemplateGetResponse as NotificationTemplateGetResponse,
     type NotificationTemplatePayload as NotificationTemplatePayload,
     type NotificationTemplatePublishRequest as NotificationTemplatePublishRequest,
+    type NotificationTemplateResponse as NotificationTemplateResponse,
     type NotificationTemplateState as NotificationTemplateState,
     type NotificationTemplateSummary as NotificationTemplateSummary,
     type NotificationTemplateUpdateRequest as NotificationTemplateUpdateRequest,

package/src/resources/tenants/index.ts

@@ -6,6 +6,7 @@ export {
   type TemplateListResponse,
   type TemplateRetrieveParams,
   type TemplateListParams,
+  type TemplateDeleteParams,
   type TemplatePublishParams,
   type TemplateReplaceParams,
 } from './templates/index';

package/src/resources/tenants/templates/index.ts

@@ -5,6 +5,7 @@ export {
   type TemplateListResponse,
   type TemplateRetrieveParams,
   type TemplateListParams,
+  type TemplateDeleteParams,
   type TemplatePublishParams,
   type TemplateReplaceParams,
 } from './templates';

package/src/resources/tenants/templates/templates.ts

@@ -6,6 +6,7 @@ import * as TenantsAPI from '../tenants';
 import * as VersionsAPI from './versions';
 import { VersionRetrieveParams, Versions } from './versions';
 import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
@@ -50,6 +51,29 @@ export class Templates extends APIResource {
     return this._client.get(path`/tenants/${tenantID}/templates`, { query, ...options });
   }
 
+  /**
+   * Deletes the tenant's notification template with the given `template_id`.
+   *
+   * Returns **204 No Content** with an empty body on success.
+   *
+   * Returns **404** if there is no template with this ID for the tenant, including a
+   * second `DELETE` after a successful removal.
+   *
+   * @example
+   * ```ts
+   * await client.tenants.templates.delete('template_id', {
+   *   tenant_id: 'tenant_id',
+   * });
+   * ```
+   */
+  delete(templateID: string, params: TemplateDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { tenant_id } = params;
+    return this._client.delete(path`/tenants/${tenant_id}/templates/${templateID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
   /**
    * Publishes a specific version of a notification template for a tenant.
    *
@@ -174,6 +198,13 @@ export interface TemplateListParams {
   limit?: number | null;
 }
 
+export interface TemplateDeleteParams {
+  /**
+   * Id of the tenant that owns the template.
+   */
+  tenant_id: string;
+}
+
 export interface TemplatePublishParams {
   /**
    * Path param: Id of the tenant that owns the template.
@@ -214,6 +245,7 @@ export declare namespace Templates {
     type TemplateListResponse as TemplateListResponse,
     type TemplateRetrieveParams as TemplateRetrieveParams,
     type TemplateListParams as TemplateListParams,
+    type TemplateDeleteParams as TemplateDeleteParams,
     type TemplatePublishParams as TemplatePublishParams,
     type TemplateReplaceParams as TemplateReplaceParams,
   };

package/src/resources/tenants/tenants.ts

@@ -7,6 +7,7 @@ import * as PreferencesAPI from './preferences/preferences';
 import { Preferences } from './preferences/preferences';
 import * as TemplatesAPI from './templates/templates';
 import {
+  TemplateDeleteParams,
   TemplateListParams,
   TemplateListResponse,
   TemplatePublishParams,
@@ -463,6 +464,7 @@ export declare namespace Tenants {
     type TemplateListResponse as TemplateListResponse,
     type TemplateRetrieveParams as TemplateRetrieveParams,
     type TemplateListParams as TemplateListParams,
+    type TemplateDeleteParams as TemplateDeleteParams,
     type TemplatePublishParams as TemplatePublishParams,
     type TemplateReplaceParams as TemplateReplaceParams,
   };

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.10.1'; // x-release-please-version
+export const VERSION = '7.11.0'; // x-release-please-version

package/uploads.d.mts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/uploads.d.ts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.js";
 //# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,kCAA+B"}

package/uploads.mjs

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.10.1";
+export declare const VERSION = "7.11.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.10.1";
+export declare const VERSION = "7.11.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '7.10.1'; // x-release-please-version
+exports.VERSION = '7.11.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '7.10.1'; // x-release-please-version
+export const VERSION = '7.11.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map