@solvapay/server 1.0.9-preview.1 → 1.0.9

package/dist/fetch/index.d.cts

@@ -0,0 +1,112 @@
+type WebhookEventType = 'payment.succeeded' | 'payment.failed' | 'payment.refunded' | 'payment.refund_failed' | 'purchase.created' | 'purchase.updated' | 'purchase.cancelled' | 'purchase.expired' | 'purchase.suspended' | 'customer.created' | 'customer.updated' | 'customer.deleted' | 'checkout_session.created';
+interface WebhookProduct {
+    reference: string;
+}
+interface CustomerWebhookObject {
+    id: string;
+    created: number;
+    product: WebhookProduct | null;
+    reference?: string;
+    name?: string;
+    email?: string;
+    telephone?: string;
+    status?: string;
+}
+type WebhookPayloadObject = Record<string, unknown>;
+type WebhookEventObjectMap = {
+    'payment.succeeded': WebhookPayloadObject;
+    'payment.failed': WebhookPayloadObject;
+    'payment.refunded': WebhookPayloadObject;
+    'payment.refund_failed': WebhookPayloadObject;
+    'purchase.created': WebhookPayloadObject;
+    'purchase.updated': WebhookPayloadObject;
+    'purchase.cancelled': WebhookPayloadObject;
+    'purchase.expired': WebhookPayloadObject;
+    'purchase.suspended': WebhookPayloadObject;
+    'customer.created': CustomerWebhookObject;
+    'customer.updated': CustomerWebhookObject;
+    'customer.deleted': CustomerWebhookObject;
+    'checkout_session.created': WebhookPayloadObject;
+};
+type WebhookEventForType<TType extends WebhookEventType> = {
+    id: string;
+    type: TType;
+    created: number;
+    api_version: string;
+    data: {
+        object: WebhookEventObjectMap[TType];
+        previous_attributes: Record<string, unknown> | null;
+    };
+    livemode: boolean;
+    request: {
+        id: string | null;
+        idempotency_key: string | null;
+    };
+};
+type WebhookEvent = {
+    [TType in WebhookEventType]: WebhookEventForType<TType>;
+}[WebhookEventType];
+
+/**
+ * Fetch-first `(req: Request) => Promise<Response>` handlers for every
+ * SolvaPay route, plus the `solvapayWebhook` factory. Wraps the pure
+ * `*Core` helpers from `../helpers` with CORS + JSON serialisation so
+ * the edge-runtime entry point (Deno / Supabase Edge / Cloudflare
+ * Workers / Bun / Next edge / Vercel Functions) is a one-liner:
+ *
+ * ```ts
+ * import { checkPurchase } from '@solvapay/server/fetch'
+ * Deno.serve(checkPurchase)
+ * ```
+ *
+ * Lifted verbatim from `@solvapay/fetch@1.0.0` when the standalone
+ * package was folded into `@solvapay/server` as the `./fetch` subpath
+ * export. Three substantive tweaks captured in the move:
+ *
+ *  1. `*Core` imports are relative (`'../helpers'`), not self-imports
+ *     through `'@solvapay/server'` — avoids the re-export indirection
+ *     and keeps the build tree-shake-friendly.
+ *  2. `verifyWebhook` imports from `'../edge'` explicitly so the
+ *     `./fetch` subpath is deterministically Web Crypto regardless of
+ *     which export condition a consumer's bundler selects for
+ *     `@solvapay/server` (the root entry's `node:crypto` variant was
+ *     the wrong choice on edge runtimes and the bundler-selected
+ *     default could swing either way).
+ *  3. `await verifyWebhook(...)` — the previous call was un-awaited.
+ *     Worked by accident on Deno because the `deno` export condition
+ *     resolved `@solvapay/server` to `./dist/edge.js` (async Web Crypto
+ *     variant), and passing the Promise through `options.onEvent` got
+ *     coerced to the event object in most handlers. Latent bug —
+ *     surfaced as "event is a Promise" in strict TypeScript handlers
+ *     that destructured `event.type` synchronously. The `await` makes
+ *     the handler return the parsed `WebhookEvent` deterministically.
+ */
+
+declare function checkPurchase(req: Request): Promise<Response>;
+declare function trackUsage(req: Request): Promise<Response>;
+declare function createPaymentIntent(req: Request): Promise<Response>;
+declare function processPayment(req: Request): Promise<Response>;
+declare function createTopupPaymentIntent(req: Request): Promise<Response>;
+declare function customerBalance(req: Request): Promise<Response>;
+declare function cancelRenewal(req: Request): Promise<Response>;
+declare function reactivateRenewal(req: Request): Promise<Response>;
+declare function activatePlan(req: Request): Promise<Response>;
+declare function getPaymentMethod(req: Request): Promise<Response>;
+declare function listPlans(req: Request): Promise<Response>;
+declare function syncCustomer(req: Request): Promise<Response>;
+declare function createCheckoutSession(req: Request): Promise<Response>;
+declare function createCustomerSession(req: Request): Promise<Response>;
+declare function getMerchant(req: Request): Promise<Response>;
+declare function getProduct(req: Request): Promise<Response>;
+interface SolvapayWebhookOptions {
+    secret?: string;
+    onEvent: (event: WebhookEvent) => void | Promise<void>;
+}
+declare function solvapayWebhook(options: SolvapayWebhookOptions): (req: Request) => Promise<Response>;
+
+interface CorsConfig {
+    origins: string[];
+}
+declare function configureCors(config: CorsConfig): void;
+
+export { type SolvapayWebhookOptions, activatePlan, cancelRenewal, checkPurchase, configureCors, createCheckoutSession, createCustomerSession, createPaymentIntent, createTopupPaymentIntent, customerBalance, getMerchant, getPaymentMethod, getProduct, listPlans, processPayment, reactivateRenewal, solvapayWebhook, syncCustomer, trackUsage };

package/dist/fetch/index.d.ts

@@ -0,0 +1,112 @@
+type WebhookEventType = 'payment.succeeded' | 'payment.failed' | 'payment.refunded' | 'payment.refund_failed' | 'purchase.created' | 'purchase.updated' | 'purchase.cancelled' | 'purchase.expired' | 'purchase.suspended' | 'customer.created' | 'customer.updated' | 'customer.deleted' | 'checkout_session.created';
+interface WebhookProduct {
+    reference: string;
+}
+interface CustomerWebhookObject {
+    id: string;
+    created: number;
+    product: WebhookProduct | null;
+    reference?: string;
+    name?: string;
+    email?: string;
+    telephone?: string;
+    status?: string;
+}
+type WebhookPayloadObject = Record<string, unknown>;
+type WebhookEventObjectMap = {
+    'payment.succeeded': WebhookPayloadObject;
+    'payment.failed': WebhookPayloadObject;
+    'payment.refunded': WebhookPayloadObject;
+    'payment.refund_failed': WebhookPayloadObject;
+    'purchase.created': WebhookPayloadObject;
+    'purchase.updated': WebhookPayloadObject;
+    'purchase.cancelled': WebhookPayloadObject;
+    'purchase.expired': WebhookPayloadObject;
+    'purchase.suspended': WebhookPayloadObject;
+    'customer.created': CustomerWebhookObject;
+    'customer.updated': CustomerWebhookObject;
+    'customer.deleted': CustomerWebhookObject;
+    'checkout_session.created': WebhookPayloadObject;
+};
+type WebhookEventForType<TType extends WebhookEventType> = {
+    id: string;
+    type: TType;
+    created: number;
+    api_version: string;
+    data: {
+        object: WebhookEventObjectMap[TType];
+        previous_attributes: Record<string, unknown> | null;
+    };
+    livemode: boolean;
+    request: {
+        id: string | null;
+        idempotency_key: string | null;
+    };
+};
+type WebhookEvent = {
+    [TType in WebhookEventType]: WebhookEventForType<TType>;
+}[WebhookEventType];
+
+/**
+ * Fetch-first `(req: Request) => Promise<Response>` handlers for every
+ * SolvaPay route, plus the `solvapayWebhook` factory. Wraps the pure
+ * `*Core` helpers from `../helpers` with CORS + JSON serialisation so
+ * the edge-runtime entry point (Deno / Supabase Edge / Cloudflare
+ * Workers / Bun / Next edge / Vercel Functions) is a one-liner:
+ *
+ * ```ts
+ * import { checkPurchase } from '@solvapay/server/fetch'
+ * Deno.serve(checkPurchase)
+ * ```
+ *
+ * Lifted verbatim from `@solvapay/fetch@1.0.0` when the standalone
+ * package was folded into `@solvapay/server` as the `./fetch` subpath
+ * export. Three substantive tweaks captured in the move:
+ *
+ *  1. `*Core` imports are relative (`'../helpers'`), not self-imports
+ *     through `'@solvapay/server'` — avoids the re-export indirection
+ *     and keeps the build tree-shake-friendly.
+ *  2. `verifyWebhook` imports from `'../edge'` explicitly so the
+ *     `./fetch` subpath is deterministically Web Crypto regardless of
+ *     which export condition a consumer's bundler selects for
+ *     `@solvapay/server` (the root entry's `node:crypto` variant was
+ *     the wrong choice on edge runtimes and the bundler-selected
+ *     default could swing either way).
+ *  3. `await verifyWebhook(...)` — the previous call was un-awaited.
+ *     Worked by accident on Deno because the `deno` export condition
+ *     resolved `@solvapay/server` to `./dist/edge.js` (async Web Crypto
+ *     variant), and passing the Promise through `options.onEvent` got
+ *     coerced to the event object in most handlers. Latent bug —
+ *     surfaced as "event is a Promise" in strict TypeScript handlers
+ *     that destructured `event.type` synchronously. The `await` makes
+ *     the handler return the parsed `WebhookEvent` deterministically.
+ */
+
+declare function checkPurchase(req: Request): Promise<Response>;
+declare function trackUsage(req: Request): Promise<Response>;
+declare function createPaymentIntent(req: Request): Promise<Response>;
+declare function processPayment(req: Request): Promise<Response>;
+declare function createTopupPaymentIntent(req: Request): Promise<Response>;
+declare function customerBalance(req: Request): Promise<Response>;
+declare function cancelRenewal(req: Request): Promise<Response>;
+declare function reactivateRenewal(req: Request): Promise<Response>;
+declare function activatePlan(req: Request): Promise<Response>;
+declare function getPaymentMethod(req: Request): Promise<Response>;
+declare function listPlans(req: Request): Promise<Response>;
+declare function syncCustomer(req: Request): Promise<Response>;
+declare function createCheckoutSession(req: Request): Promise<Response>;
+declare function createCustomerSession(req: Request): Promise<Response>;
+declare function getMerchant(req: Request): Promise<Response>;
+declare function getProduct(req: Request): Promise<Response>;
+interface SolvapayWebhookOptions {
+    secret?: string;
+    onEvent: (event: WebhookEvent) => void | Promise<void>;
+}
+declare function solvapayWebhook(options: SolvapayWebhookOptions): (req: Request) => Promise<Response>;
+
+interface CorsConfig {
+    origins: string[];
+}
+declare function configureCors(config: CorsConfig): void;
+
+export { type SolvapayWebhookOptions, activatePlan, cancelRenewal, checkPurchase, configureCors, createCheckoutSession, createCustomerSession, createPaymentIntent, createTopupPaymentIntent, customerBalance, getMerchant, getPaymentMethod, getProduct, listPlans, processPayment, reactivateRenewal, solvapayWebhook, syncCustomer, trackUsage };