@checkoutpage/sdk 0.1.2 → 0.1.12

package/README.md

@@ -1,6 +1,6 @@
-# CheckoutPage JavaScript SDK
+# Checkout Page JavaScript SDK
 
-Official JavaScript/TypeScript SDK for the CheckoutPage API.
+Official JavaScript/TypeScript SDK for the Checkout Page API.
 
 ## Installation
 
@@ -23,25 +23,23 @@ yarn add @checkoutpage/sdk
 ## Quick Start
 
 ```typescript
-import { CheckoutPage } from '@checkoutpage/sdk'
+import { createCheckoutPageClient } from '@checkoutpage/sdk';
 
-const checkoutpage = new CheckoutPage({
-  apiKey: 'YOUR_API_KEY',
-})
+const checkoutpage = createCheckoutPageClient({ apiKey: 'YOUR_API_KEY' });
 
 // Get a customer
-const customer = await checkoutpage.customers.get('customer_id')
-console.log(customer)
+const customer = await checkoutpage.customers.get('customer_id');
+console.log(customer);
 ```
 
 ## Authentication
 
-The SDK requires an API key for authentication. You can obtain your API key from the [CheckoutPage Dashboard](https://app.checkoutpage.com).
+The SDK requires an API key for authentication. You can obtain your API key from the [Checkout Page Dashboard](https://checkoutpage.com).
 
 ```typescript
-const checkoutpage = new CheckoutPage({
+const checkoutpage = createCheckoutPageClient({
   apiKey: process.env.CHECKOUTPAGE_API_KEY,
-})
+});
 ```
 
 ### Custom Base URL
@@ -49,10 +47,10 @@ const checkoutpage = new CheckoutPage({
 For testing or custom environments, you can override the base URL:
 
 ```typescript
-const checkoutpage = new CheckoutPage({
+const checkoutpage = createCheckoutPageClient({
   apiKey: 'YOUR_API_KEY',
   baseUrl: 'https://custom-api.example.com',
-})
+});
 ```
 
 ## Usage
@@ -62,7 +60,118 @@ const checkoutpage = new CheckoutPage({
 #### Get a customer
 
 ```typescript
-const customer = await checkoutpage.customers.get('6812fe6e9f39b6760576f01c')
+const customer = await checkoutpage.customers.get('6812fe6e9f39b6760576f01c');
+```
+
+#### List customers
+
+```typescript
+const results = await checkoutpage.customers.list();
+```
+
+### Coupons
+
+#### List coupons
+
+```typescript
+const results = await checkoutpage.coupons.list();
+```
+
+With pagination and filtering:
+
+```typescript
+const results = await checkoutpage.coupons.list({
+  search: '10off',
+  limit: 50,
+});
+```
+
+With cursor-based pagination:
+
+```typescript
+const firstPage = await checkoutpage.coupons.list({ limit: 50 });
+
+const nextPage = await checkoutpage.coupons.list({
+  limit: 50,
+  starting_after: firstPage.data[firstPage.data.length - 1].id,
+});
+
+const previousPage = await checkoutpage.coupons.list({
+  limit: 50,
+  ending_before: nextPage.data[0].id,
+});
+```
+
+#### Create coupon
+
+```typescript
+const results = await checkoutpage.coupons.create({
+  type: 'amount',
+  label: 'Spring Sale',
+  code: 'SPRING25',
+  amountOff: 2500,
+  currency: 'usd',
+  duration: 'once',
+});
+```
+
+### Subscriptions
+
+#### List subscriptions
+
+```typescript
+const results = await checkoutpage.subscriptions.list();
+```
+
+With pagination and filtering:
+
+```typescript
+const results = await checkoutpage.subscriptions.list({
+  search: 'customer@example.com',
+  status: 'active',
+  pageId: '67fcbdac6a91c25ef2d3534a',
+  limit: 50,
+});
+```
+
+With cursor-based pagination:
+
+```typescript
+const firstPage = await checkoutpage.subscriptions.list({ limit: 50 });
+
+const nextPage = await checkoutpage.subscriptions.list({
+  limit: 50,
+  starting_after: firstPage.data[firstPage.data.length - 1].id,
+});
+
+const previousPage = await checkoutpage.subscriptions.list({
+  limit: 50,
+  ending_before: nextPage.data[0].id,
+});
+```
+
+### Payments
+
+#### List payments
+
+```typescript
+const results = await checkoutpage.payments.list();
+```
+
+With cursor-based pagination:
+
+```typescript
+const firstPage = await checkoutpage.payments.list({ limit: 50 });
+
+const nextPage = await checkoutpage.payments.list({
+  limit: 50,
+  starting_after: firstPage.data[firstPage.data.length - 1].id,
+});
+
+const previousPage = await checkoutpage.payments.list({
+  limit: 50,
+  ending_before: firstPage.data[0].id,
+});
 ```
 
 ## Error Handling
@@ -74,24 +183,27 @@ import {
   CheckoutPageError,
   AuthenticationError,
   NotFoundError,
+  ConflictError,
   RateLimitError,
   ValidationError,
   APIError,
-} from '@checkoutpage/sdk'
+} from '@checkoutpage/sdk';
 
 try {
-  const customer = await checkoutpage.customers.get('customer_id')
+  const customer = await checkoutpage.customers.get('customer_id');
 } catch (error) {
   if (error instanceof AuthenticationError) {
-    console.error('Invalid API key')
+    console.error('Invalid API key');
   } else if (error instanceof NotFoundError) {
-    console.error('Customer not found')
+    console.error('Customer not found');
+  } else if (error instanceof ConflictError) {
+    console.error('Resource already exists');
   } else if (error instanceof RateLimitError) {
-    console.error('Rate limit exceeded')
+    console.error('Rate limit exceeded');
   } else if (error instanceof ValidationError) {
-    console.error('Validation error')
+    console.error('Validation error');
   } else if (error instanceof APIError) {
-    console.error('API error:', error.statusCode, error.message)
+    console.error('API error:', error.statusCode, error.message);
   }
 }
 ```
@@ -101,6 +213,7 @@ try {
 - `CheckoutPageError` - Base error class
 - `AuthenticationError` - Invalid API key or authentication failure (401, 403)
 - `NotFoundError` - Resource not found (404)
+- `ConflictError` - Resource already exists (409)
 - `RateLimitError` - Rate limit exceeded (429)
 - `ValidationError` - Request validation failed (400, 422)
 - `APIError` - Generic API error with status code and response
@@ -110,9 +223,9 @@ try {
 The SDK is written in TypeScript and provides full type definitions auto-generated from the OpenAPI specification:
 
 ```typescript
-import type { Customer, Address, Shipping } from '@checkoutpage/sdk'
+import type { Customer, Address, Shipping } from '@checkoutpage/sdk';
 
-const customer: Customer = await checkoutpage.customers.get('customer_id')
+const customer: Customer = await checkoutpage.customers.get('customer_id');
 ```
 
 ### Advanced Type Usage
@@ -120,16 +233,18 @@ const customer: Customer = await checkoutpage.customers.get('customer_id')
 Access all generated types for advanced use cases:
 
 ```typescript
-import type { operations, components, paths } from '@checkoutpage/sdk'
+import type { operations, components, paths } from '@checkoutpage/sdk';
 
 // Get request type for an operation
-type CreateCouponRequest = operations['coupons/create']['requestBody']['content']['application/json']
+type CreateCouponRequest =
+  operations['coupons/create']['requestBody']['content']['application/json'];
 
 // Get response type
-type ListCustomersResponse = operations['customers/list']['responses'][200]['content']['application/json']
+type ListCustomersResponse =
+  operations['customers/list']['responses'][200]['content']['application/json'];
 
 // Access schema components
-type CustomerId = components['schemas']['CustomerId']
+type CustomerId = components['schemas']['CustomerId'];
 ```
 
 See [TYPE_GENERATION.md](../TYPE_GENERATION.md) for more details on working with generated types.
@@ -154,5 +269,5 @@ MIT
 ## Support
 
 - Documentation: https://docs.checkoutpage.com
-- GitHub Issues: https://github.com/checkoutpage/checkoutpage-api-sdk/issues
+- GitHub Issues: https://github.com/checkout-page/checkoutpage-api-sdk/issues
 - Email: support@checkoutpage.com