@dodopayments/sveltekit 0.1.1 → 0.1.3

package/README.md

@@ -25,15 +25,28 @@ All the examples below assume you're using SvelteKit App Router.
 ```typescript
 // src/routes/api/checkout/+server.ts
 import { Checkout } from "@dodopayments/sveltekit";
-import { DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_RETURN_URL, DODO_PAYMENTS_ENVIRONMENT } from '$env/static/private';
+import {
+  DODO_PAYMENTS_API_KEY,
+  DODO_PAYMENTS_RETURN_URL,
+  DODO_PAYMENTS_ENVIRONMENT,
+} from "$env/static/private";
 
 const checkoutGetHandler = Checkout({
-    bearerToken: DODO_PAYMENTS_API_KEY,
-    returnUrl: DODO_PAYMENTS_RETURN_URL,
-    environment: environment,
-    type: "static", // optional, defaults to 'static'
+  bearerToken: DODO_PAYMENTS_API_KEY,
+  returnUrl: DODO_PAYMENTS_RETURN_URL,
+  environment: DODO_PAYMENTS_ENVIRONMENT,
+  type: "static",
+});
+
+const checkoutPostHandler = Checkout({
+  bearerToken: DODO_PAYMENTS_API_KEY,
+  returnUrl: DODO_PAYMENTS_RETURN_URL,
+  environment: DODO_PAYMENTS_ENVIRONMENT,
+  type: "session", // or "dynamic" for dynamic link
 });
+
 export const GET = checkoutGetHandler.GET;
+export const POST = checkoutPostHandler.POST;
 ```
 
 ---
@@ -44,11 +57,15 @@ export const GET = checkoutGetHandler.GET;
 //
 // src/routes/api/checkout/+server.ts
 import { CustomerPortal } from "@dodopayments/sveltekit";
-import { DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_RETURN_URL, DODO_PAYMENTS_ENVIRONMENT } from '$env/static/private';
+import {
+  DODO_PAYMENTS_API_KEY,
+  DODO_PAYMENTS_RETURN_URL,
+  DODO_PAYMENTS_ENVIRONMENT,
+} from "$env/static/private";
 
 const customerPortalHandler = CustomerPortal({
-    bearerToken: DODO_PAYMENTS_API_KEY,
-    environment: environment,
+  bearerToken: DODO_PAYMENTS_API_KEY,
+  environment: environment,
 });
 
 export const GET = customerPortalHandler.GET;
@@ -69,16 +86,20 @@ Returns 400 if `customer_id` is missing.
 // src/routes/api/webhook/+server.ts
 // /api/checkout/+server.ts
 import { Webhooks } from "@dodopayments/sveltekit";
-import { DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_RETURN_URL, DODO_PAYMENTS_ENVIRONMENT, DODO_PAYMENTS_WEBHOOK_KEY } from '$env/static/private';
+import {
+  DODO_PAYMENTS_API_KEY,
+  DODO_PAYMENTS_RETURN_URL,
+  DODO_PAYMENTS_ENVIRONMENT,
+  DODO_PAYMENTS_WEBHOOK_KEY,
+} from "$env/static/private";
 
 export const POST = Webhooks({
-    webhookKey: DODO_PAYMENTS_WEBHOOK_KEY,
-    onPayload: async (payload) => {
-        //Handle payload here
-        console.log(payload);
-    }
+  webhookKey: DODO_PAYMENTS_WEBHOOK_KEY,
+  onPayload: async (payload) => {
+    //Handle payload here
+    console.log(payload);
+  },
 });
-
 ```
 
 ---
@@ -113,7 +134,7 @@ Here's how you should structure your response:
 
 If Checkout Route Handler is selected:
 
-Purpose: This handler redirects users to the Dodo Payments checkout page.
+Purpose: This handler manages different types of checkout flows. All checkout types (static, dynamic, and sessions) return JSON responses with checkout URLs for programmatic handling.
 File Creation: Create a new file at app/checkout/route.ts in your SvelteKit project.
 
 Code Snippet:
@@ -125,15 +146,15 @@ import { DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_RETURN_URL, DODO_PAYMENTS_ENVIRONM
 const checkoutGetHandler = Checkout({
     bearerToken: DODO_PAYMENTS_API_KEY,
     returnUrl: DODO_PAYMENTS_RETURN_URL,
-    environment: environment,
-    type: "static", // optional, defaults to 'static'
+    environment: DODO_PAYMENTS_ENVIRONMENT,
+    type: "static",
 });
 
 const checkoutPostHandler = Checkout({
     bearerToken: DODO_PAYMENTS_API_KEY,
     returnUrl: DODO_PAYMENTS_RETURN_URL,
-    environment: environment,
-    type: "dynamic", // optional, defaults to 'static'
+    environment: DODO_PAYMENTS_ENVIRONMENT,
+    type: "session", // or "dynamic" for dynamic link
 });
 
 export const GET = checkoutGetHandler.GET;
@@ -147,7 +168,7 @@ Configuration & Usage:
 
     environment: (Optional) Set to "test_mode" for testing, or omit/set to "live_mode" for production.
 
-    type: (Optional) Set to "static" for GET/static checkout, "dynamic" for POST/dynamic checkout. Defaults to "static".
+    type: (Optional) Set to "static" for GET/static checkout, "dynamic" for POST/dynamic checkout, or "session" for POST/checkout sessions.
 
 Static Checkout (GET) Query Parameters:
 
@@ -163,13 +184,24 @@ Static Checkout (GET) Query Parameters:
 
     Metadata (optional): Any query parameter starting with metadata_ (e.g., ?metadata_userId=abc123)
 
-Dynamic Checkout (POST): Parameters are sent as a JSON body. Supports both one-time and recurring payments. For a complete list of supported POST body fields, refer to:
+    Returns: {"checkout_url": "https://checkout.dodopayments.com/..."}
+
+Dynamic Checkout (POST) - Returns JSON with checkout_url: Parameters are sent as a JSON body. Supports both one-time and recurring payments. Returns: {"checkout_url": "https://checkout.dodopayments.com/..."}. For a complete list of supported POST body fields, refer to:
 
     Docs - One Time Payment Product: https://docs.dodopayments.com/api-reference/payments/post-payments
 
     Docs - Subscription Product: https://docs.dodopayments.com/api-reference/subscriptions/post-subscriptions
 
-Error Handling: If productId is missing or other query parameters are invalid, the handler will return a 400 response.
+Checkout Sessions (POST) - (Recommended) A more customizable checkout experience. Returns JSON with checkout_url: Parameters are sent as a JSON body. Supports both one-time and recurring payments. Returns: {"checkout_url": "https://checkout.dodopayments.com/session/..."}. For a complete list of supported POST body fields, refer to:
+
+    Docs - One Time Payment Product: https://docs.dodopayments.com/api-reference/payments/post-payments
+
+    Docs - Subscription Product: https://docs.dodopayments.com/api-reference/subscriptions/post-subscriptions
+
+  Required fields for checkout sessions:
+      product_cart (array): Array of products with product_id and quantity
+
+Error Handling: If productId is missing or other parameters are invalid, the handler will return a 400 response.
 
 If Customer Portal Route Handler is selected:
 
@@ -184,7 +216,7 @@ import { DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_RETURN_URL, DODO_PAYMENTS_ENVIRONM
 
 const customerPortalHandler = CustomerPortal({
     bearerToken: DODO_PAYMENTS_API_KEY,
-    environment: environment,
+    environment: DODO_PAYMENTS_ENVIRONMENT,
 });
 
 export const GET = customerPortalHandler.GET;
@@ -297,7 +329,7 @@ Example .env file:
 DODO_PAYMENTS_API_KEY=your-api-key
 DODO_PAYMENTS_WEBHOOK_KEY=your-webhook-secret
 DODO_PAYMENTS_RETURN_URL=your-return-url
-DODO_PAYMENTS_ENVIRONMENT="test" or "live"
+DODO_PAYMENTS_ENVIRONMENT="test_mode" or "live_mode"
 
 Usage in your code:
 

package/dist/checkout/checkout.d.ts

@@ -1,5 +1,5 @@
-import { type RequestHandler } from '@sveltejs/kit';
-import { type CheckoutHandlerConfig } from '@dodopayments/core/checkout';
+import { type RequestHandler } from "@sveltejs/kit";
+import { type CheckoutHandlerConfig } from "@dodopayments/core/checkout";
 export declare const Checkout: (config: CheckoutHandlerConfig) => {
     GET: RequestHandler;
     POST: RequestHandler;

package/dist/checkout/checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/checkout/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAEL,KAAK,qBAAqB,EAG3B,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,QAAQ,GAAI,QAAQ,qBAAqB;;;CA+DrD,CAAC"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/checkout/checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAEL,KAAK,qBAAqB,EAI3B,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,QAAQ,GAAI,QAAQ,qBAAqB;;;CAmGrD,CAAC"}

package/dist/customer-portal/customer-portal.d.ts

@@ -1,7 +1,7 @@
-import { type RequestHandler } from '@sveltejs/kit';
-import { ClientOptions } from 'dodopayments';
-export type CustomerPortalConfig = Pick<ClientOptions, 'environment' | 'bearerToken'>;
-export declare const CustomerPortal: ({ bearerToken, environment }: CustomerPortalConfig) => {
+import { type RequestHandler } from "@sveltejs/kit";
+import { ClientOptions } from "dodopayments";
+export type CustomerPortalConfig = Pick<ClientOptions, "environment" | "bearerToken">;
+export declare const CustomerPortal: ({ bearerToken, environment, }: CustomerPortalConfig) => {
     GET: RequestHandler;
 };
 //# sourceMappingURL=customer-portal.d.ts.map

package/dist/customer-portal/customer-portal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customer-portal.d.ts","sourceRoot":"","sources":["../../src/customer-portal/customer-portal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAErE,OAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,aAAa,CAAC,CAAC;AAEtF,eAAO,MAAM,cAAc,GAAI,8BAA8B,oBAAoB;;CAqChF,CAAC"}
+{"version":3,"file":"customer-portal.d.ts","sourceRoot":"","sources":["../../src/customer-portal/customer-portal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAErE,OAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,aAAa,EACb,aAAa,GAAG,aAAa,CAC9B,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,+BAG5B,oBAAoB;;CAwCtB,CAAC"}