@paid-ai/paid-node 0.5.1 → 1.0.1-alpha0

package/dist/esm/api/resources/customers/client/Client.d.mts

@@ -1,27 +1,10 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as environments from "../../../../environments.mjs";
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
 import * as core from "../../../../core/index.mjs";
 import * as Paid from "../../../index.mjs";
 export declare namespace Customers {
-    interface Options {
-        environment?: core.Supplier<environments.PaidEnvironment | string>;
-        /** Specify a custom URL to connect the client to. */
-        baseUrl?: core.Supplier<string>;
-        token?: core.Supplier<core.BearerToken | undefined>;
-        /** Additional headers to include in requests. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    interface Options extends BaseClientOptions {
     }
-    interface RequestOptions {
-        /** The maximum time to wait for a response in seconds. */
-        timeoutInSeconds?: number;
-        /** The number of times to retry the request. Defaults to 2. */
-        maxRetries?: number;
-        /** A hook to abort the request. */
-        abortSignal?: AbortSignal;
-        /** Additional headers to include in the request. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    interface RequestOptions extends BaseRequestOptions {
     }
 }
 export declare class Customers {
@@ -42,7 +25,20 @@ export declare class Customers {
      * @example
      *     await client.customers.create({
      *         name: "Acme, Inc.",
-     *         externalId: "acme-inc"
+     *         externalId: "acme-inc",
+     *         contacts: [{
+     *                 salutation: "Mr.",
+     *                 firstName: "John",
+     *                 lastName: "Doe",
+     *                 accountName: "Acme, Inc.",
+     *                 email: "john.doe@acme.com",
+     *                 phone: "+1-555-0100",
+     *                 billingStreet: "123 Main Street",
+     *                 billingCity: "San Francisco",
+     *                 billingStateProvince: "CA",
+     *                 billingCountry: "USA",
+     *                 billingPostalCode: "94102"
+     *             }]
      *     })
      */
     create(request: Paid.CustomerCreate, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.Customer>;
@@ -80,6 +76,22 @@ export declare class Customers {
      */
     delete(customerId: string, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
+    /**
+     * @param {string} customerId - The customer ID
+     * @param {Paid.CustomersCheckEntitlementRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.checkEntitlement("customerId", {
+     *         event_name: "event_name",
+     *         view: "all"
+     *     })
+     */
+    checkEntitlement(customerId: string, request: Paid.CustomersCheckEntitlementRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CustomersCheckEntitlementResponse>;
+    private __checkEntitlement;
     /**
      * @param {string} customerId - The customer ID
      * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
@@ -157,5 +169,56 @@ export declare class Customers {
      */
     getUsageByExternalId(externalId: string, request?: Paid.CustomersGetUsageByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.UsageSummariesResponse>;
     private __getUsageByExternalId;
+    /**
+     * Retrieves all payment methods associated with a customer identified by their external ID.
+     *
+     * @param {string} externalId - The external ID of the customer
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.listPaymentMethods("externalId")
+     */
+    listPaymentMethods(externalId: string, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.PaymentMethod[]>;
+    private __listPaymentMethods;
+    /**
+     * Creates a new payment method for a customer using a Stripe confirmation token.
+     *
+     * @param {string} externalId - The external ID of the customer
+     * @param {Paid.CustomersCreatePaymentMethodRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.createPaymentMethod("externalId", {
+     *         confirmationToken: "ctoken_1234567890",
+     *         returnUrl: "https://example.com/payment-method-added",
+     *         metadata: {
+     *             "source": "api"
+     *         }
+     *     })
+     */
+    createPaymentMethod(externalId: string, request: Paid.CustomersCreatePaymentMethodRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.PaymentMethod>;
+    private __createPaymentMethod;
+    /**
+     * Deletes a specific payment method from a customer's account.
+     *
+     * @param {string} externalId - The external ID of the customer
+     * @param {string} paymentMethodId - The ID of the payment method to delete
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.deletePaymentMethod("externalId", "paymentMethodId")
+     */
+    deletePaymentMethod(externalId: string, paymentMethodId: string, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<void>;
+    private __deletePaymentMethod;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }