pingram 1.0.34 → 1.0.35-alpha.1569

package/dist/generated/src/apis/AccountApi.d.ts

@@ -17,6 +17,7 @@ export interface ConfigureSupabaseSMTPRequest {
 export interface GetUsageHistoryRequest {
     startDate: string;
     endDate: string;
+    groupBy?: string;
 }
 export interface ListInvoicesRequest {
     limit?: number;
@@ -92,18 +93,19 @@ export interface AccountApiInterface {
     getUsage(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUsageResponse>;
     /**
      *
-     * @summary Get historical usage for the authenticated account over a date range.
+     * @summary Get historical usage for the authenticated account over a date range, summed by UTC calendar month or billing cycle from daily counts.
      * @param {string} startDate Start date (YYYY-MM-DD) for the range
      * @param {string} endDate End date (YYYY-MM-DD) for the range
+     * @param {string} [groupBy] calendar (UTC months, default) or billing (account billing cycles)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AccountApiInterface
      */
     getUsageHistoryRaw(requestParameters: GetUsageHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetUsageHistoryResponse>>;
     /**
-     * Get historical usage for the authenticated account over a date range.
+     * Get historical usage for the authenticated account over a date range, summed by UTC calendar month or billing cycle from daily counts.
      */
-    getUsageHistory(startDate: string, endDate: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUsageHistoryResponse>;
+    getUsageHistory(startDate: string, endDate: string, groupBy?: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUsageHistoryResponse>;
     /**
      *
      * @summary List Stripe invoices for the authenticated account, newest first.
@@ -222,13 +224,13 @@ export declare class AccountApi extends runtime.BaseAPI implements AccountApiInt
      */
     getUsage(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUsageResponse>;
     /**
-     * Get historical usage for the authenticated account over a date range.
+     * Get historical usage for the authenticated account over a date range, summed by UTC calendar month or billing cycle from daily counts.
      */
     getUsageHistoryRaw(requestParameters: GetUsageHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetUsageHistoryResponse>>;
     /**
-     * Get historical usage for the authenticated account over a date range.
+     * Get historical usage for the authenticated account over a date range, summed by UTC calendar month or billing cycle from daily counts.
      */
-    getUsageHistory(startDate: string, endDate: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUsageHistoryResponse>;
+    getUsageHistory(startDate: string, endDate: string, groupBy?: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUsageHistoryResponse>;
     /**
      * List Stripe invoices for the authenticated account, newest first.
      */

package/dist/generated/src/apis/AccountApi.js

@@ -259,7 +259,7 @@ class AccountApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
-     * Get historical usage for the authenticated account over a date range.
+     * Get historical usage for the authenticated account over a date range, summed by UTC calendar month or billing cycle from daily counts.
      */
     async getUsageHistoryRaw(requestParameters, initOverrides) {
         if (requestParameters['startDate'] == null) {
@@ -275,6 +275,9 @@ class AccountApi extends runtime.BaseAPI {
         if (requestParameters['endDate'] != null) {
             queryParameters['endDate'] = requestParameters['endDate'];
         }
+        if (requestParameters['groupBy'] != null) {
+            queryParameters['groupBy'] = requestParameters['groupBy'];
+        }
         const headerParameters = {};
         if (this.configuration &&
             (this.configuration.username !== undefined ||
@@ -314,10 +317,10 @@ class AccountApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.GetUsageHistoryResponseFromJSON)(jsonValue));
     }
     /**
-     * Get historical usage for the authenticated account over a date range.
+     * Get historical usage for the authenticated account over a date range, summed by UTC calendar month or billing cycle from daily counts.
      */
-    async getUsageHistory(startDate, endDate, initOverrides) {
-        const response = await this.getUsageHistoryRaw({ startDate: startDate, endDate: endDate }, initOverrides);
+    async getUsageHistory(startDate, endDate, groupBy, initOverrides) {
+        const response = await this.getUsageHistoryRaw({ startDate: startDate, endDate: endDate, groupBy: groupBy }, initOverrides);
         return await response.value();
     }
     /**

package/dist/generated/src/apis/WebhooksApi.d.ts

@@ -30,7 +30,7 @@ export interface UpdateWebhookRequest {
 export interface WebhooksApiInterface {
     /**
      *
-     * @summary Create a webhook.
+     * @summary Create a webhook endpoint. Pingram POSTs signed JSON to the URL when one of the subscribed events happens. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be http or https and should return 2xx.
      * @param {WebhookEndpointUpsertRequest} webhookEndpointUpsertRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -38,38 +38,38 @@ export interface WebhooksApiInterface {
      */
     createWebhookRaw(requestParameters: CreateWebhookRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WebhookEndpoint>>;
     /**
-     * Create a webhook.
+     * Create a webhook endpoint. Pingram POSTs signed JSON to the URL when one of the subscribed events happens. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be http or https and should return 2xx.
      */
     createWebhook(webhookEndpointUpsertRequest: WebhookEndpointUpsertRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WebhookEndpoint>;
     /**
      *
-     * @summary Delete a webhook.
-     * @param {string} endpointId Webhook endpoint id
+     * @summary Delete one webhook endpoint by id from list or create. That URL stops receiving its events. Other endpoints on the account are left as they are.
+     * @param {string} endpointId Id of the webhook endpoint, from list or create.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WebhooksApiInterface
      */
     deleteWebhookRaw(requestParameters: DeleteWebhookRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * Delete a webhook.
+     * Delete one webhook endpoint by id from list or create. That URL stops receiving its events. Other endpoints on the account are left as they are.
      */
     deleteWebhook(endpointId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      *
-     * @summary List webhooks for the current account.
+     * @summary List webhook endpoints on the current account, including each id, URL, subscribed events, and signing secret. Use the id with update or delete.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WebhooksApiInterface
      */
     listWebhooksRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WebhookEndpointsResponse>>;
     /**
-     * List webhooks for the current account.
+     * List webhook endpoints on the current account, including each id, URL, subscribed events, and signing secret. Use the id with update or delete.
      */
     listWebhooks(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WebhookEndpointsResponse>;
     /**
      *
-     * @summary Update a webhook. The signing secret is preserved.
-     * @param {string} endpointId Webhook endpoint id
+     * @summary Replace one webhook endpoint\'s URL and its full event subscription. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it. The URL must be http or https.
+     * @param {string} endpointId Id of the webhook endpoint, from list or create.
      * @param {WebhookEndpointUpsertRequest} webhookEndpointUpsertRequest
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -77,7 +77,7 @@ export interface WebhooksApiInterface {
      */
     updateWebhookRaw(requestParameters: UpdateWebhookRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WebhookEndpoint>>;
     /**
-     * Update a webhook. The signing secret is preserved.
+     * Replace one webhook endpoint\'s URL and its full event subscription. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it. The URL must be http or https.
      */
     updateWebhook(endpointId: string, webhookEndpointUpsertRequest: WebhookEndpointUpsertRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WebhookEndpoint>;
 }
@@ -86,35 +86,35 @@ export interface WebhooksApiInterface {
  */
 export declare class WebhooksApi extends runtime.BaseAPI implements WebhooksApiInterface {
     /**
-     * Create a webhook.
+     * Create a webhook endpoint. Pingram POSTs signed JSON to the URL when one of the subscribed events happens. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be http or https and should return 2xx.
      */
     createWebhookRaw(requestParameters: CreateWebhookRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WebhookEndpoint>>;
     /**
-     * Create a webhook.
+     * Create a webhook endpoint. Pingram POSTs signed JSON to the URL when one of the subscribed events happens. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be http or https and should return 2xx.
      */
     createWebhook(webhookEndpointUpsertRequest: WebhookEndpointUpsertRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WebhookEndpoint>;
     /**
-     * Delete a webhook.
+     * Delete one webhook endpoint by id from list or create. That URL stops receiving its events. Other endpoints on the account are left as they are.
      */
     deleteWebhookRaw(requestParameters: DeleteWebhookRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * Delete a webhook.
+     * Delete one webhook endpoint by id from list or create. That URL stops receiving its events. Other endpoints on the account are left as they are.
      */
     deleteWebhook(endpointId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
-     * List webhooks for the current account.
+     * List webhook endpoints on the current account, including each id, URL, subscribed events, and signing secret. Use the id with update or delete.
      */
     listWebhooksRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WebhookEndpointsResponse>>;
     /**
-     * List webhooks for the current account.
+     * List webhook endpoints on the current account, including each id, URL, subscribed events, and signing secret. Use the id with update or delete.
      */
     listWebhooks(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WebhookEndpointsResponse>;
     /**
-     * Update a webhook. The signing secret is preserved.
+     * Replace one webhook endpoint\'s URL and its full event subscription. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it. The URL must be http or https.
      */
     updateWebhookRaw(requestParameters: UpdateWebhookRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WebhookEndpoint>>;
     /**
-     * Update a webhook. The signing secret is preserved.
+     * Replace one webhook endpoint\'s URL and its full event subscription. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it. The URL must be http or https.
      */
     updateWebhook(endpointId: string, webhookEndpointUpsertRequest: WebhookEndpointUpsertRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WebhookEndpoint>;
 }

package/dist/generated/src/apis/WebhooksApi.js

@@ -54,7 +54,7 @@ const index_1 = require("../models/index");
  */
 class WebhooksApi extends runtime.BaseAPI {
     /**
-     * Create a webhook.
+     * Create a webhook endpoint. Pingram POSTs signed JSON to the URL when one of the subscribed events happens. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be http or https and should return 2xx.
      */
     async createWebhookRaw(requestParameters, initOverrides) {
         if (requestParameters['webhookEndpointUpsertRequest'] == null) {
@@ -102,14 +102,14 @@ class WebhooksApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WebhookEndpointFromJSON)(jsonValue));
     }
     /**
-     * Create a webhook.
+     * Create a webhook endpoint. Pingram POSTs signed JSON to the URL when one of the subscribed events happens. The response includes id and a signing secret starting with pingram_whsecret_. Save it and verify the X-Pingram-Signature header. Updates keep this secret. At most 10 endpoints per account. The URL must be http or https and should return 2xx.
      */
     async createWebhook(webhookEndpointUpsertRequest, initOverrides) {
         const response = await this.createWebhookRaw({ webhookEndpointUpsertRequest: webhookEndpointUpsertRequest }, initOverrides);
         return await response.value();
     }
     /**
-     * Delete a webhook.
+     * Delete one webhook endpoint by id from list or create. That URL stops receiving its events. Other endpoints on the account are left as they are.
      */
     async deleteWebhookRaw(requestParameters, initOverrides) {
         if (requestParameters['endpointId'] == null) {
@@ -156,13 +156,13 @@ class WebhooksApi extends runtime.BaseAPI {
         return new runtime.VoidApiResponse(response);
     }
     /**
-     * Delete a webhook.
+     * Delete one webhook endpoint by id from list or create. That URL stops receiving its events. Other endpoints on the account are left as they are.
      */
     async deleteWebhook(endpointId, initOverrides) {
         await this.deleteWebhookRaw({ endpointId: endpointId }, initOverrides);
     }
     /**
-     * List webhooks for the current account.
+     * List webhook endpoints on the current account, including each id, URL, subscribed events, and signing secret. Use the id with update or delete.
      */
     async listWebhooksRaw(initOverrides) {
         const queryParameters = {};
@@ -205,14 +205,14 @@ class WebhooksApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WebhookEndpointsResponseFromJSON)(jsonValue));
     }
     /**
-     * List webhooks for the current account.
+     * List webhook endpoints on the current account, including each id, URL, subscribed events, and signing secret. Use the id with update or delete.
      */
     async listWebhooks(initOverrides) {
         const response = await this.listWebhooksRaw(initOverrides);
         return await response.value();
     }
     /**
-     * Update a webhook. The signing secret is preserved.
+     * Replace one webhook endpoint\'s URL and its full event subscription. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it. The URL must be http or https.
      */
     async updateWebhookRaw(requestParameters, initOverrides) {
         if (requestParameters['endpointId'] == null) {
@@ -264,7 +264,7 @@ class WebhooksApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WebhookEndpointFromJSON)(jsonValue));
     }
     /**
-     * Update a webhook. The signing secret is preserved.
+     * Replace one webhook endpoint\'s URL and its full event subscription. endpointId comes from list or create. The signing secret stays the same. events is the complete set; omitting an event unsubscribes it. The URL must be http or https.
      */
     async updateWebhook(endpointId, webhookEndpointUpsertRequest, initOverrides) {
         const response = await this.updateWebhookRaw({

package/dist/generated/src/models/CreateAccountRequestPlan.d.ts

@@ -38,9 +38,7 @@ export declare enum CreateAccountRequestPlanTierEnum {
     BUDGET_100 = "budget_100",
     BUDGET_250 = "budget_250",
     BUDGET_500 = "budget_500",
-    BUDGET_1000 = "budget_1000",
-    BUDGET_2000 = "budget_2000",
-    BUDGET_5000 = "budget_5000"
+    BUDGET_1000 = "budget_1000"
 }
 /**
  * Check if a given object implements the CreateAccountRequestPlan interface.

package/dist/generated/src/models/CreateAccountRequestPlan.js

@@ -31,8 +31,6 @@ var CreateAccountRequestPlanTierEnum;
     CreateAccountRequestPlanTierEnum["BUDGET_250"] = "budget_250";
     CreateAccountRequestPlanTierEnum["BUDGET_500"] = "budget_500";
     CreateAccountRequestPlanTierEnum["BUDGET_1000"] = "budget_1000";
-    CreateAccountRequestPlanTierEnum["BUDGET_2000"] = "budget_2000";
-    CreateAccountRequestPlanTierEnum["BUDGET_5000"] = "budget_5000";
 })(CreateAccountRequestPlanTierEnum || (exports.CreateAccountRequestPlanTierEnum = CreateAccountRequestPlanTierEnum = {}));
 /**
  * Check if a given object implements the CreateAccountRequestPlan interface.

package/dist/generated/src/models/GetUsageHistoryQuery.d.ts

@@ -27,6 +27,12 @@ export interface GetUsageHistoryQuery {
      * @memberof GetUsageHistoryQuery
      */
     endDate: string;
+    /**
+     * calendar = UTC calendar months (YYYY-MM). billing = account billing cycles (YYYY-MM-DD period start). Defaults to calendar.
+     * @type {string}
+     * @memberof GetUsageHistoryQuery
+     */
+    groupBy?: string;
 }
 /**
  * Check if a given object implements the GetUsageHistoryQuery interface.

package/dist/generated/src/models/GetUsageHistoryQuery.js

@@ -37,7 +37,8 @@ function GetUsageHistoryQueryFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         startDate: json['startDate'],
-        endDate: json['endDate']
+        endDate: json['endDate'],
+        groupBy: json['groupBy'] == null ? undefined : json['groupBy']
     };
 }
 function GetUsageHistoryQueryToJSON(json) {
@@ -49,6 +50,7 @@ function GetUsageHistoryQueryToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         startDate: value['startDate'],
-        endDate: value['endDate']
+        endDate: value['endDate'],
+        groupBy: value['groupBy']
     };
 }

package/dist/generated/src/models/GetUsageHistoryResponse.d.ts

@@ -17,7 +17,7 @@ import type { GetUsageHistoryResponseItemsInner } from './GetUsageHistoryRespons
  */
 export interface GetUsageHistoryResponse {
     /**
-     * Array of usage items, one per month in the requested range
+     * Array of usage items, one per calendar month or billing cycle in the range
      * @type {Array<GetUsageHistoryResponseItemsInner>}
      * @memberof GetUsageHistoryResponse
      */

package/dist/generated/src/models/GetUsageHistoryResponseItemsInner.d.ts

@@ -17,7 +17,7 @@ import type { GetUsageHistoryResponseItemsInnerCounts } from './GetUsageHistoryR
  */
 export interface GetUsageHistoryResponseItemsInner {
     /**
-     * Year-month (YYYY-MM) for this usage period
+     * YYYY-MM for calendar months, or YYYY-MM-DD billing-period start.
      * @type {string}
      * @memberof GetUsageHistoryResponseItemsInner
      */

package/dist/generated/src/models/WebhookEndpoint.d.ts

@@ -22,19 +22,19 @@ export interface WebhookEndpoint {
      */
     id: string;
     /**
-     * Destination URL that receives webhook event payloads.
+     * Destination URL that receives signed JSON event payloads.
      * @type {string}
      * @memberof WebhookEndpoint
      */
     webhook: string;
     /**
-     * List of subscribed event types for this endpoint.
+     * Subscribed event types for this endpoint.
      * @type {Array<string>}
      * @memberof WebhookEndpoint
      */
     events: Array<WebhookEndpointEventsEnum>;
     /**
-     * HMAC secret for verifying webhook signatures. Use this with your X-Pingram-Signature verification.
+     * HMAC secret for verifying X-Pingram-Signature. Returned on create and list; updates keep the same secret. Format: pingram_whsecret_...
      * @type {string}
      * @memberof WebhookEndpoint
      */

package/dist/generated/src/models/WebhookEndpointUpsertRequest.d.ts

@@ -16,13 +16,13 @@
  */
 export interface WebhookEndpointUpsertRequest {
     /**
-     * Destination URL that receives webhook event payloads. Must be a valid http(s) URL.
+     * Public http or https URL that accepts POST with a JSON event body. Return 2xx to acknowledge. Requests include X-Pingram-Id, X-Pingram-Signature (v1 HMAC-SHA256), and X-Pingram-Timestamp.
      * @type {string}
      * @memberof WebhookEndpointUpsertRequest
      */
     webhook: string;
     /**
-     * List of event types that should be forwarded to the webhook URL.
+     * Full set of event types to deliver to this URL. Omitting an event on update unsubscribes it. Inbound SMS to the free shared number only works when that person has already received a text from this number. Inbound SMS to a dedicated number works normally.
      * @type {Array<string>}
      * @memberof WebhookEndpointUpsertRequest
      */

package/dist/generated/src/models/WebhookEndpointsResponseEndpointsInner.d.ts

@@ -22,19 +22,19 @@ export interface WebhookEndpointsResponseEndpointsInner {
      */
     id: string;
     /**
-     * Destination URL that receives webhook event payloads.
+     * Destination URL that receives signed JSON event payloads.
      * @type {string}
      * @memberof WebhookEndpointsResponseEndpointsInner
      */
     webhook: string;
     /**
-     * List of subscribed event types for this endpoint.
+     * Subscribed event types for this endpoint.
      * @type {Array<string>}
      * @memberof WebhookEndpointsResponseEndpointsInner
      */
     events: Array<WebhookEndpointsResponseEndpointsInnerEventsEnum>;
     /**
-     * HMAC secret for verifying webhook signatures. Use this with your X-Pingram-Signature verification.
+     * HMAC secret for verifying X-Pingram-Signature. Returned on create and list; updates keep the same secret. Format: pingram_whsecret_...
      * @type {string}
      * @memberof WebhookEndpointsResponseEndpointsInner
      */

package/dist/src/client.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Pingram = void 0;
 const src_1 = require("../generated/src");
 // SDK version for User-Agent header (injected at codegen time)
-const SDK_VERSION = '1.0.34';
+const SDK_VERSION = '1.0.35';
 const USER_AGENT = `pingram-node/${SDK_VERSION}`;
 const src_2 = require("../generated/src");
 const src_3 = require("../generated/src");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pingram",
-  "version": "1.0.34",
+  "version": "1.0.35-alpha.1569",
   "description": "Official Node.js SDK for Pingram - Send notifications via Email, SMS, Push, In-App, and more",
   "main": "dist/index.js",
   "module": "dist/index.js",