@stigg/typescript 0.1.0-alpha.7 → 0.1.0-alpha.8

package/src/resources/v1/subscriptions/invoice.ts

@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Invoice extends APIResource {
+  /**
+   * Marks the latest invoice of a subscription as paid in the billing provider. The
+   * invoice must exist and have an OPEN status.
+   */
+  markAsPaid(id: string, options?: RequestOptions): APIPromise<InvoiceMarkAsPaidResponse> {
+    return this._client.post(path`/api/v1/subscriptions/${id}/invoice/paid`, options);
+  }
+}
+
+/**
+ * Response object
+ */
+export interface InvoiceMarkAsPaidResponse {
+  /**
+   * Result of marking a subscription invoice as paid.
+   */
+  data: InvoiceMarkAsPaidResponse.Data;
+}
+
+export namespace InvoiceMarkAsPaidResponse {
+  /**
+   * Result of marking a subscription invoice as paid.
+   */
+  export interface Data {
+    /**
+     * The subscription ID whose invoice was marked as paid
+     */
+    id: string;
+  }
+}
+
+export declare namespace Invoice {
+  export { type InvoiceMarkAsPaidResponse as InvoiceMarkAsPaidResponse };
+}

package/src/resources/v1/subscriptions/subscriptions.ts

@@ -3,6 +3,10 @@
 import { APIResource } from '../../../core/resource';
 import * as FutureUpdateAPI from './future-update';
 import { CancelSubscription, FutureUpdate } from './future-update';
+import * as InvoiceAPI from './invoice';
+import { Invoice, InvoiceMarkAsPaidResponse } from './invoice';
+import * as UsageAPI from './usage';
+import { Usage, UsageChargeUsageParams, UsageChargeUsageResponse, UsageSyncResponse } from './usage';
 import { APIPromise } from '../../../core/api-promise';
 import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
@@ -10,6 +14,8 @@ import { path } from '../../../internal/utils/path';
 
 export class Subscriptions extends APIResource {
   futureUpdate: FutureUpdateAPI.FutureUpdate = new FutureUpdateAPI.FutureUpdate(this._client);
+  usage: UsageAPI.Usage = new UsageAPI.Usage(this._client);
+  invoice: InvoiceAPI.Invoice = new InvoiceAPI.Invoice(this._client);
 
   /**
    * Retrieves a subscription by its unique identifier, including plan details,
@@ -787,7 +793,7 @@ export namespace SubscriptionProvisionResponse {
      */
     id: string;
 
-    entitlements: Array<Data.UnionMember0 | Data.UnionMember1> | null;
+    entitlements: Array<Data.UnionObjectVariant0 | Data.UnionObjectVariant1> | null;
 
     /**
      * Provision status: SUCCESS or PAYMENT_REQUIRED
@@ -816,7 +822,7 @@ export namespace SubscriptionProvisionResponse {
   }
 
   export namespace Data {
-    export interface UnionMember0 {
+    export interface UnionObjectVariant0 {
       accessDeniedReason:
         | 'FeatureNotFound'
         | 'CustomerNotFound'
@@ -845,7 +851,7 @@ export namespace SubscriptionProvisionResponse {
        */
       entitlementUpdatedAt?: string;
 
-      feature?: UnionMember0.Feature;
+      feature?: UnionObjectVariant0.Feature;
 
       hasUnlimitedUsage?: boolean;
 
@@ -877,7 +883,7 @@ export namespace SubscriptionProvisionResponse {
       validUntil?: string;
     }
 
-    export namespace UnionMember0 {
+    export namespace UnionObjectVariant0 {
       export interface Feature {
         /**
          * The human-readable name of the entitlement, shown in UI elements.
@@ -901,7 +907,7 @@ export namespace SubscriptionProvisionResponse {
       }
     }
 
-    export interface UnionMember1 {
+    export interface UnionObjectVariant1 {
       accessDeniedReason:
         | 'FeatureNotFound'
         | 'CustomerNotFound'
@@ -922,7 +928,7 @@ export namespace SubscriptionProvisionResponse {
       /**
        * The currency associated with a credit entitlement.
        */
-      currency: UnionMember1.Currency;
+      currency: UnionObjectVariant1.Currency;
 
       currentUsage: number;
 
@@ -953,7 +959,7 @@ export namespace SubscriptionProvisionResponse {
       validUntil?: string;
     }
 
-    export namespace UnionMember1 {
+    export namespace UnionObjectVariant1 {
       /**
        * The currency associated with a credit entitlement.
        */
@@ -3907,6 +3913,8 @@ export interface SubscriptionTransferParams {
 }
 
 Subscriptions.FutureUpdate = FutureUpdate;
+Subscriptions.Usage = Usage;
+Subscriptions.Invoice = Invoice;
 
 export declare namespace Subscriptions {
   export {
@@ -3928,4 +3936,13 @@ export declare namespace Subscriptions {
   };
 
   export { FutureUpdate as FutureUpdate, type CancelSubscription as CancelSubscription };
+
+  export {
+    Usage as Usage,
+    type UsageChargeUsageResponse as UsageChargeUsageResponse,
+    type UsageSyncResponse as UsageSyncResponse,
+    type UsageChargeUsageParams as UsageChargeUsageParams,
+  };
+
+  export { Invoice as Invoice, type InvoiceMarkAsPaidResponse as InvoiceMarkAsPaidResponse };
 }

package/src/resources/v1/subscriptions/usage.ts

@@ -0,0 +1,126 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Usage extends APIResource {
+  /**
+   * Immediately charges usage for a subscription via the billing integration.
+   * Calculates usage since the last charge and creates an invoice.
+   */
+  chargeUsage(
+    id: string,
+    body: UsageChargeUsageParams,
+    options?: RequestOptions,
+  ): APIPromise<UsageChargeUsageResponse> {
+    return this._client.post(path`/api/v1/subscriptions/${id}/usage/charge`, { body, ...options });
+  }
+
+  /**
+   * Triggers a usage sync for a subscription, reporting current usage to the billing
+   * provider.
+   */
+  sync(id: string, options?: RequestOptions): APIPromise<UsageSyncResponse> {
+    return this._client.post(path`/api/v1/subscriptions/${id}/usage/sync`, options);
+  }
+}
+
+/**
+ * Response object
+ */
+export interface UsageChargeUsageResponse {
+  /**
+   * Result of charging subscription usage including the billing period and charged
+   * items.
+   */
+  data: UsageChargeUsageResponse.Data;
+}
+
+export namespace UsageChargeUsageResponse {
+  /**
+   * Result of charging subscription usage including the billing period and charged
+   * items.
+   */
+  export interface Data {
+    /**
+     * The invoice ID in the billing integration
+     */
+    invoiceBillingId: string | null;
+
+    /**
+     * End of the usage billing period
+     */
+    periodEnd: string;
+
+    /**
+     * Start of the usage billing period
+     */
+    periodStart: string;
+
+    /**
+     * The subscription ID for which usage was charged
+     */
+    subscriptionId: string;
+
+    /**
+     * Usage items that were charged
+     */
+    usageCharged: Array<Data.UsageCharged>;
+  }
+
+  export namespace Data {
+    /**
+     * A single usage item that was charged.
+     */
+    export interface UsageCharged {
+      /**
+       * The feature ID for which usage was charged
+       */
+      featureId: string | null;
+
+      /**
+       * The number of units charged
+       */
+      usageAmount: number;
+    }
+  }
+}
+
+/**
+ * Response object
+ */
+export interface UsageSyncResponse {
+  /**
+   * Result of triggering a subscription usage sync.
+   */
+  data: UsageSyncResponse.Data;
+}
+
+export namespace UsageSyncResponse {
+  /**
+   * Result of triggering a subscription usage sync.
+   */
+  export interface Data {
+    /**
+     * Whether usage was synced to the billing provider
+     */
+    triggered: boolean;
+  }
+}
+
+export interface UsageChargeUsageParams {
+  /**
+   * Cutoff date for usage calculation. If not provided, the current time is used.
+   */
+  untilDate?: string;
+}
+
+export declare namespace Usage {
+  export {
+    type UsageChargeUsageResponse as UsageChargeUsageResponse,
+    type UsageSyncResponse as UsageSyncResponse,
+    type UsageChargeUsageParams as UsageChargeUsageParams,
+  };
+}

package/src/resources/v1/v1.ts

@@ -8,15 +8,22 @@ import {
   CouponListParams,
   CouponListResponse,
   CouponListResponsesMyCursorIDPage,
+  CouponUpdateCouponParams,
   Coupons,
 } from './coupons';
-import * as EventsAPI from './events';
-import { EventReportParams, EventReportResponse, Events } from './events';
 import * as ProductsAPI from './products';
 import {
+  ProductArchiveProductResponse,
+  ProductCreateProductParams,
+  ProductCreateProductResponse,
+  ProductDuplicateProductParams,
+  ProductDuplicateProductResponse,
   ProductListProductsParams,
   ProductListProductsResponse,
   ProductListProductsResponsesMyCursorIDPage,
+  ProductUnarchiveProductResponse,
+  ProductUpdateProductParams,
+  ProductUpdateProductResponse,
   Products,
 } from './products';
 import * as UsageAPI from './usage';
@@ -42,6 +49,8 @@ import {
   CustomerUpdateParams,
   Customers,
 } from './customers/customers';
+import * as EventsAPI from './events/events';
+import { EventReportParams, EventReportResponse, Events } from './events/events';
 import * as SubscriptionsAPI from './subscriptions/subscriptions';
 import {
   Subscription,
@@ -120,6 +129,7 @@ export declare namespace V1 {
     type CouponListResponsesMyCursorIDPage as CouponListResponsesMyCursorIDPage,
     type CouponCreateParams as CouponCreateParams,
     type CouponListParams as CouponListParams,
+    type CouponUpdateCouponParams as CouponUpdateCouponParams,
   };
 
   export {
@@ -138,8 +148,16 @@ export declare namespace V1 {
 
   export {
     Products as Products,
+    type ProductArchiveProductResponse as ProductArchiveProductResponse,
+    type ProductCreateProductResponse as ProductCreateProductResponse,
+    type ProductDuplicateProductResponse as ProductDuplicateProductResponse,
     type ProductListProductsResponse as ProductListProductsResponse,
+    type ProductUnarchiveProductResponse as ProductUnarchiveProductResponse,
+    type ProductUpdateProductResponse as ProductUpdateProductResponse,
     type ProductListProductsResponsesMyCursorIDPage as ProductListProductsResponsesMyCursorIDPage,
+    type ProductCreateProductParams as ProductCreateProductParams,
+    type ProductDuplicateProductParams as ProductDuplicateProductParams,
     type ProductListProductsParams as ProductListProductsParams,
+    type ProductUpdateProductParams as ProductUpdateProductParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.7'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.8'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.7";
+export declare const VERSION = "0.1.0-alpha.8";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.7";
+export declare const VERSION = "0.1.0-alpha.8";
 //# 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 = '0.1.0-alpha.7'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.8'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0-alpha.7'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.8'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map