@surgent-dev/surpay-convex 0.1.3 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# @surgent-dev/surpay-convex
+
+## 0.2.0
+
+### Minor Changes
+
+- 809165a: Updated requirement of project ID across a lot of APIs, also deleted some unused ones.
+
+### Patch Changes
+
+- 809165a: Improve SDK reliability and type safety
+
+  - Add configurable request timeouts (30s default) with AbortController
+  - Catch network errors and return as Result failures instead of throwing
+  - Handle invalid JSON responses gracefully
+  - Add proper generics for Convex auth context (removes `any` types)
+  - Fix examples and documentation to match current API
+
+- Updated dependencies [809165a]
+- Updated dependencies [809165a]
+  - @surgent-dev/surpay@0.2.0

package/README.md

@@ -50,6 +50,7 @@ import { api } from "./_generated/api";
 // Inside a Convex action or from client
 const { data, error } = await ctx.runAction(api.surpay.createCheckout, {
   product_id: "prod_123",
+  customer_id: "cust_123", // Optional if using identify()
   price_id: "price_123",
   success_url: "https://example.com/success",
   cancel_url: "https://example.com/cancel",
@@ -69,6 +70,7 @@ import { api } from "./_generated/api";
 
 const { data, error } = await ctx.runAction(api.surpay.check, {
   product_id: "prod_123",
+  customer_id: "cust_123", // Optional if using identify()
 });
 
 if (data?.allowed) {
@@ -82,7 +84,6 @@ if (data?.allowed) {
 import { api } from "./_generated/api";
 
 const { data, error } = await ctx.runAction(api.surpay.getCustomer, {
-  project_id: "proj_123",
   customer_id: "cust_123",
 });
 ```
@@ -92,9 +93,7 @@ const { data, error } = await ctx.runAction(api.surpay.getCustomer, {
 ```typescript
 import { api } from "./_generated/api";
 
-const { data, error } = await ctx.runAction(api.surpay.listCustomers, {
-  project_id: "proj_123",
-});
+const { data, error } = await ctx.runAction(api.surpay.listCustomers, {});
 ```
 
 ### List Subscriptions
@@ -102,17 +101,15 @@ const { data, error } = await ctx.runAction(api.surpay.listCustomers, {
 ```typescript
 import { api } from "./_generated/api";
 
-const { data, error } = await ctx.runAction(api.surpay.listSubscriptions, {
-  project_id: "proj_123",
-});
+const { data, error } = await ctx.runAction(api.surpay.listSubscriptions, {});
 ```
 
 ## API Reference
 
 | Action | Args | Returns |
 |--------|------|---------|
-| `createCheckout` | `product_id`, `price_id?`, `success_url?`, `cancel_url?` | `{ checkout_url: string, customer_id: string }` |
-| `check` | `product_id` | `{ allowed: boolean }` |
-| `getCustomer` | `project_id`, `customer_id` | `CustomerWithDetails` |
-| `listCustomers` | `project_id` | `Customer[]` |
-| `listSubscriptions` | `project_id` | `Subscription[]` |
+| `createCheckout` | `product_id`, `customer_id?`, `price_id?`, `success_url?`, `cancel_url?` | `{ checkout_url: string, customer_id: string }` |
+| `check` | `product_id`, `customer_id?` | `{ allowed: boolean }` |
+| `getCustomer` | `customer_id` | `CustomerWithDetails` |
+| `listCustomers` | - | `Customer[]` |
+| `listSubscriptions` | - | `Subscription[]` |

package/dist/index.d.ts

@@ -1,4 +1,29 @@
-import { Surpay as SurpayClient } from "@surgent-dev/surpay";
+/**
+ * Surpay Convex Integration
+ *
+ * Provides Convex actions that wrap the Surpay SDK with auth context support.
+ *
+ * @example
+ * ```typescript
+ * // convex/surpay.ts
+ * import { Surpay } from "@surgent-dev/surpay-convex";
+ *
+ * const surpay = new Surpay({
+ *   apiKey: process.env.SURPAY_API_KEY!,
+ *   identify: async (ctx) => {
+ *     const identity = await ctx.auth.getUserIdentity();
+ *     if (!identity) return null;
+ *     return {
+ *       customerId: identity.subject,
+ *       customerData: { name: identity.name, email: identity.email },
+ *     };
+ *   },
+ * });
+ * export const { createCheckout, getCustomer, listCustomers, listSubscriptions } = surpay.api();
+ * ```
+ */
+import { GenericActionCtx } from "convex/server";
+import { Surpay as SurpayClient, ResponseCase } from "@surgent-dev/surpay";
 export type IdentifierOpts = {
     customerId: string;
     customerData?: {
@@ -6,22 +31,30 @@ export type IdentifierOpts = {
         email?: string;
     };
 };
-export type SurpayConfig = {
+export type SurpayConfig<Ctx extends GenericActionCtx<any> = GenericActionCtx<any>> = {
     apiKey: string;
     baseUrl?: string;
-    identify: (ctx: any) => Promise<IdentifierOpts | null>;
+    /**
+     * Response key case format.
+     * - 'snake' (default): snake_case keys to match Convex validators
+     * - 'camel': camelCase keys from API responses
+     *
+     * Defaults to 'snake' for Convex validator compatibility.
+     */
+    responseCase?: ResponseCase;
+    identify: (ctx: Ctx) => Promise<IdentifierOpts | null>;
 };
 type PlainError = {
     message: string;
     code?: string;
 };
-export declare class Surpay {
+export declare class Surpay<Ctx extends GenericActionCtx<any> = GenericActionCtx<any>> {
     private client;
     private options;
-    constructor(config: SurpayConfig);
-    getIdentifierOpts(ctx: any): Promise<IdentifierOpts | null>;
+    constructor(config: SurpayConfig<Ctx>);
+    getIdentifierOpts(ctx: Ctx): Promise<IdentifierOpts | null>;
     getAuthParams({ ctx, requireAuth, }: {
-        ctx: any;
+        ctx: Ctx;
         requireAuth?: boolean;
     }): Promise<{
         client: SurpayClient;
@@ -29,10 +62,10 @@ export declare class Surpay {
     }>;
     api(): {
         createCheckout: import("convex/server").RegisteredAction<"public", {
-            price_id?: string | undefined;
-            success_url?: string | undefined;
-            cancel_url?: string | undefined;
-            product_id: string;
+            priceId?: string | undefined;
+            successUrl?: string | undefined;
+            cancelUrl?: string | undefined;
+            productId: string;
         }, Promise<{
             data: null;
             error: PlainError;
@@ -41,7 +74,7 @@ export declare class Surpay {
             error: null;
         }>>;
         check: import("convex/server").RegisteredAction<"public", {
-            product_id: string;
+            productId: string;
         }, Promise<{
             data: null;
             error: PlainError;
@@ -50,7 +83,6 @@ export declare class Surpay {
             error: null;
         }>>;
         getCustomer: import("convex/server").RegisteredAction<"public", {
-            project_id: string;
             customer_id: string;
         }, Promise<{
             data: null;
@@ -59,18 +91,14 @@ export declare class Surpay {
             data: import("@surgent-dev/surpay").CustomerWithDetails;
             error: null;
         }>>;
-        listCustomers: import("convex/server").RegisteredAction<"public", {
-            project_id: string;
-        }, Promise<{
+        listCustomers: import("convex/server").RegisteredAction<"public", {}, Promise<{
             data: null;
             error: PlainError;
         } | {
             data: import("@surgent-dev/surpay").Customer[];
             error: null;
         }>>;
-        listSubscriptions: import("convex/server").RegisteredAction<"public", {
-            project_id: string;
-        }, Promise<{
+        listSubscriptions: import("convex/server").RegisteredAction<"public", {}, Promise<{
             data: null;
             error: PlainError;
         } | {
@@ -80,4 +108,5 @@ export declare class Surpay {
     };
 }
 export * from "./types.js";
+export type { ResponseCase } from "@surgent-dev/surpay";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAS7D,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACxD,CAAC;AAGF,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAwBrD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAe;gBAElB,MAAM,EAAE,YAAY;IAU1B,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI3D,aAAa,CAAC,EAClB,GAAG,EACH,WAAkB,GACnB,EAAE;QACD,GAAG,EAAE,GAAG,CAAC;QACT,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC;IAQ5E,GAAG;;;;;;;kBA5CyC,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;;;kBAAa,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;;;;kBAAa,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;;;kBAAa,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;;;kBAAa,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;CAqGhC;AAED,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAiB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,YAAY,EAAgB,MAAM,qBAAqB,CAAC;AASzF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD,CAAC;AAGF,MAAM,MAAM,YAAY,CAAC,GAAG,SAAS,gBAAgB,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACxD,CAAC;AAGF,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAyBrD,qBAAa,MAAM,CAAC,GAAG,SAAS,gBAAgB,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC;IAC3E,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;IAY/B,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI3D,aAAa,CAAC,EAClB,GAAG,EACH,WAAkB,GACnB,EAAE;QACD,GAAG,EAAE,GAAG,CAAC;QACT,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC;IAQ5E,GAAG;;;;;;;kBA/CyC,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;;;kBAAa,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;;;kBAAa,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;kBAAa,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;kBAAa,IAAI;mBAAS,UAAU;;;mBAAxC,IAAI;;;CA4GhC;AAED,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -23,7 +23,7 @@
  * ```
  */
 import { actionGeneric } from "convex/server";
-import { Surpay as SurpayClient } from "@surgent-dev/surpay";
+import { Surpay as SurpayClient, camelToSnake } from "@surgent-dev/surpay";
 import { CreateCheckoutArgs, CheckArgs, GetCustomerArgs, ListCustomersArgs, ListSubscriptionsArgs, } from "./types.js";
 function toPlainError(error) {
     if (error instanceof Error) {
@@ -44,6 +44,7 @@ async function wrapSdkCall(fn) {
         return { data: null, error: toPlainError(e) };
     }
 }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export class Surpay {
     client;
     options;
@@ -54,6 +55,8 @@ export class Surpay {
         this.client = new SurpayClient({
             apiKey: config.apiKey,
             baseUrl: config.baseUrl ?? envBaseUrl,
+            // Default to snake_case for Convex validator compatibility
+            responseCase: config.responseCase ?? "snake",
         });
     }
     async getIdentifierOpts(ctx) {
@@ -71,9 +74,11 @@ export class Surpay {
             createCheckout: actionGeneric({
                 args: CreateCheckoutArgs,
                 handler: async (ctx, args) => {
-                    const { client, identifierOpts } = await this.getAuthParams({ ctx });
+                    const { client, identifierOpts } = await this.getAuthParams({ ctx: ctx });
+                    // Transform camelCase user args to snake_case for API
+                    const snakeCaseArgs = camelToSnake(args);
                     return wrapSdkCall(() => client.checkout.create({
-                        ...args,
+                        ...snakeCaseArgs,
                         customer_id: identifierOpts.customerId,
                         customer_data: identifierOpts.customerData,
                     }));
@@ -82,9 +87,9 @@ export class Surpay {
             check: actionGeneric({
                 args: CheckArgs,
                 handler: async (ctx, args) => {
-                    const { client, identifierOpts } = await this.getAuthParams({ ctx });
+                    const { client, identifierOpts } = await this.getAuthParams({ ctx: ctx });
                     return wrapSdkCall(() => client.check({
-                        product_id: args.product_id,
+                        product_id: args.productId,
                         customer_id: identifierOpts.customerId,
                     }));
                 },
@@ -92,23 +97,22 @@ export class Surpay {
             getCustomer: actionGeneric({
                 args: GetCustomerArgs,
                 handler: async (ctx, args) => {
-                    const { client, identifierOpts } = await this.getAuthParams({ ctx });
-                    const customerId = args.customer_id || identifierOpts.customerId;
-                    return wrapSdkCall(() => client.customers.get(args.project_id, customerId));
+                    const { client } = await this.getAuthParams({ ctx: ctx, requireAuth: false });
+                    return wrapSdkCall(() => client.customers.get(args.customer_id));
                 },
             }),
             listCustomers: actionGeneric({
                 args: ListCustomersArgs,
-                handler: async (ctx, args) => {
-                    const { client } = await this.getAuthParams({ ctx });
-                    return wrapSdkCall(() => client.customers.list(args.project_id));
+                handler: async (ctx) => {
+                    const { client } = await this.getAuthParams({ ctx: ctx });
+                    return wrapSdkCall(() => client.customers.list());
                 },
             }),
             listSubscriptions: actionGeneric({
                 args: ListSubscriptionsArgs,
-                handler: async (ctx, args) => {
-                    const { client } = await this.getAuthParams({ ctx });
-                    return wrapSdkCall(() => client.subscriptions.list(args.project_id));
+                handler: async (ctx) => {
+                    const { client } = await this.getAuthParams({ ctx: ctx });
+                    return wrapSdkCall(() => client.subscriptions.list());
                 },
             }),
         };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -3,41 +3,31 @@
  */
 import { Infer } from "convex/values";
 export declare const CreateCheckoutArgs: import("convex/values").VObject<{
-    price_id?: string | undefined;
-    success_url?: string | undefined;
-    cancel_url?: string | undefined;
-    product_id: string;
+    priceId?: string | undefined;
+    successUrl?: string | undefined;
+    cancelUrl?: string | undefined;
+    productId: string;
 }, {
-    product_id: import("convex/values").VString<string, "required">;
-    price_id: import("convex/values").VString<string | undefined, "optional">;
-    success_url: import("convex/values").VString<string | undefined, "optional">;
-    cancel_url: import("convex/values").VString<string | undefined, "optional">;
-}, "required", "product_id" | "price_id" | "success_url" | "cancel_url">;
+    productId: import("convex/values").VString<string, "required">;
+    priceId: import("convex/values").VString<string | undefined, "optional">;
+    successUrl: import("convex/values").VString<string | undefined, "optional">;
+    cancelUrl: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "productId" | "priceId" | "successUrl" | "cancelUrl">;
 export type CreateCheckoutArgs = Infer<typeof CreateCheckoutArgs>;
 export declare const CheckArgs: import("convex/values").VObject<{
-    product_id: string;
+    productId: string;
 }, {
-    product_id: import("convex/values").VString<string, "required">;
-}, "required", "product_id">;
+    productId: import("convex/values").VString<string, "required">;
+}, "required", "productId">;
 export type CheckArgs = Infer<typeof CheckArgs>;
-export declare const ListSubscriptionsArgs: import("convex/values").VObject<{
-    project_id: string;
-}, {
-    project_id: import("convex/values").VString<string, "required">;
-}, "required", "project_id">;
+export declare const ListSubscriptionsArgs: import("convex/values").VObject<{}, {}, "required", never>;
 export type ListSubscriptionsArgs = Infer<typeof ListSubscriptionsArgs>;
 export declare const GetCustomerArgs: import("convex/values").VObject<{
-    project_id: string;
     customer_id: string;
 }, {
-    project_id: import("convex/values").VString<string, "required">;
     customer_id: import("convex/values").VString<string, "required">;
-}, "required", "project_id" | "customer_id">;
+}, "required", "customer_id">;
 export type GetCustomerArgs = Infer<typeof GetCustomerArgs>;
-export declare const ListCustomersArgs: import("convex/values").VObject<{
-    project_id: string;
-}, {
-    project_id: import("convex/values").VString<string, "required">;
-}, "required", "project_id">;
+export declare const ListCustomersArgs: import("convex/values").VObject<{}, {}, "required", never>;
 export type ListCustomersArgs = Infer<typeof ListCustomersArgs>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAIzC,eAAO,MAAM,kBAAkB;;;;;;;;;;wEAK7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAIlE,eAAO,MAAM,SAAS;;;;4BAEpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAGhD,eAAO,MAAM,qBAAqB;;;;4BAEhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGxE,eAAO,MAAM,eAAe;;;;;;4CAG1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAG5D,eAAO,MAAM,iBAAiB;;;;4BAE5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAIzC,eAAO,MAAM,kBAAkB;;;;;;;;;;oEAK7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAIlE,eAAO,MAAM,SAAS;;;;2BAEpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAGhD,eAAO,MAAM,qBAAqB,4DAAe,CAAC;AAClD,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGxE,eAAO,MAAM,eAAe;;;;6BAE1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAG5D,eAAO,MAAM,iBAAiB,4DAAe,CAAC;AAC9C,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/types.js

@@ -2,30 +2,25 @@
  * Convex validators for Surpay action arguments
  */
 import { v } from "convex/values";
-// CreateCheckoutArgs: product_id required, price_id/URLs optional
-// Note: customer_id is NOT here - it's injected by the wrapper via identify()
+// CreateCheckoutArgs: productId required, priceId/URLs optional
+// Note: customerId is NOT here - it's injected by the wrapper via identify()
 export const CreateCheckoutArgs = v.object({
-    product_id: v.string(),
-    price_id: v.optional(v.string()),
-    success_url: v.optional(v.string()),
-    cancel_url: v.optional(v.string()),
+    productId: v.string(),
+    priceId: v.optional(v.string()),
+    successUrl: v.optional(v.string()),
+    cancelUrl: v.optional(v.string()),
 });
-// CheckArgs: product_id required
-// Note: customer_id is NOT here - it's injected by the wrapper via identify()
+// CheckArgs: productId required
+// Note: customerId is NOT here - it's injected by the wrapper via identify()
 export const CheckArgs = v.object({
-    product_id: v.string(),
+    productId: v.string(),
 });
-// ListSubscriptions: requires project_id
-export const ListSubscriptionsArgs = v.object({
-    project_id: v.string(),
-});
-// GetCustomer: requires project_id and customer_id
+// ListSubscriptions: no args required (project_id from auth context)
+export const ListSubscriptionsArgs = v.object({});
+// GetCustomer: requires customer_id (project_id from auth context)
 export const GetCustomerArgs = v.object({
-    project_id: v.string(),
     customer_id: v.string(),
 });
-// ListCustomers: requires project_id
-export const ListCustomersArgs = v.object({
-    project_id: v.string(),
-});
+// ListCustomers: no args required (project_id from auth context)
+export const ListCustomersArgs = v.object({});
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAS,MAAM,eAAe,CAAC;AAEzC,kEAAkE;AAClE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACnC,CAAC,CAAC;AAGH,iCAAiC;AACjC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAGH,yCAAyC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAGH,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAGH,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAS,MAAM,eAAe,CAAC;AAEzC,gEAAgE;AAChE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAClC,CAAC,CAAC;AAGH,gCAAgC;AAChC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAGH,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAGlD,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAGH,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "@surgent-dev/surpay-convex",
-  "version": "0.1.3",
+  "version": "0.2.0",
+  "description": "Convex integration for Surpay SDK",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/surgent-dev/surpay-sdk-ts.git",
+    "directory": "packages/surpay-convex"
+  },
+  "homepage": "https://github.com/surgent-dev/surpay-sdk-ts#readme",
+  "bugs": {
+    "url": "https://github.com/surgent-dev/surpay-sdk-ts/issues"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -15,7 +25,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@surgent-dev/surpay": "^0.1.6"
+    "@surgent-dev/surpay": "^0.2.0"
   },
   "peerDependencies": {
     "convex": "^1.25.0"

package/src/index.ts

@@ -22,8 +22,8 @@
  * export const { createCheckout, getCustomer, listCustomers, listSubscriptions } = surpay.api();
  * ```
  */
-import { actionGeneric } from "convex/server";
-import { Surpay as SurpayClient } from "@surgent-dev/surpay";
+import { actionGeneric, GenericActionCtx } from "convex/server";
+import { Surpay as SurpayClient, ResponseCase, camelToSnake } from "@surgent-dev/surpay";
 import {
   CreateCheckoutArgs,
   CheckArgs,
@@ -37,10 +37,19 @@ export type IdentifierOpts = {
   customerData?: { name?: string; email?: string };
 };
 
-export type SurpayConfig = {
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type SurpayConfig<Ctx extends GenericActionCtx<any> = GenericActionCtx<any>> = {
   apiKey: string;
   baseUrl?: string;
-  identify: (ctx: any) => Promise<IdentifierOpts | null>;
+  /**
+   * Response key case format.
+   * - 'snake' (default): snake_case keys to match Convex validators
+   * - 'camel': camelCase keys from API responses
+   *
+   * Defaults to 'snake' for Convex validator compatibility.
+   */
+  responseCase?: ResponseCase;
+  identify: (ctx: Ctx) => Promise<IdentifierOpts | null>;
 };
 
 // Convex can't serialize class instances - convert errors to plain objects
@@ -68,21 +77,24 @@ async function wrapSdkCall<T>(
   }
 }
 
-export class Surpay {
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export class Surpay<Ctx extends GenericActionCtx<any> = GenericActionCtx<any>> {
   private client: SurpayClient;
-  private options: SurpayConfig;
+  private options: SurpayConfig<Ctx>;
 
-  constructor(config: SurpayConfig) {
+  constructor(config: SurpayConfig<Ctx>) {
     this.options = config;
     const g = globalThis as { process?: { env: Record<string, string | undefined> } };
     const envBaseUrl = g.process?.env.SURPAY_BASE_URL;
     this.client = new SurpayClient({
       apiKey: config.apiKey,
       baseUrl: config.baseUrl ?? envBaseUrl,
+      // Default to snake_case for Convex validator compatibility
+      responseCase: config.responseCase ?? "snake",
     });
   }
 
-  async getIdentifierOpts(ctx: any): Promise<IdentifierOpts | null> {
+  async getIdentifierOpts(ctx: Ctx): Promise<IdentifierOpts | null> {
     return await this.options.identify(ctx);
   }
 
@@ -90,7 +102,7 @@ export class Surpay {
     ctx,
     requireAuth = true,
   }: {
-    ctx: any;
+    ctx: Ctx;
     requireAuth?: boolean;
   }): Promise<{ client: SurpayClient; identifierOpts: IdentifierOpts | null }> {
     const identifierOpts = await this.getIdentifierOpts(ctx);
@@ -105,10 +117,17 @@ export class Surpay {
       createCheckout: actionGeneric({
         args: CreateCheckoutArgs,
         handler: async (ctx, args) => {
-          const { client, identifierOpts } = await this.getAuthParams({ ctx });
+          const { client, identifierOpts } = await this.getAuthParams({ ctx: ctx as Ctx });
+          // Transform camelCase user args to snake_case for API
+          const snakeCaseArgs = camelToSnake(args) as unknown as {
+            product_id: string;
+            price_id?: string;
+            success_url?: string;
+            cancel_url?: string;
+          };
           return wrapSdkCall(() =>
             client.checkout.create({
-              ...args,
+              ...snakeCaseArgs,
               customer_id: identifierOpts!.customerId,
               customer_data: identifierOpts!.customerData,
             })
@@ -119,10 +138,10 @@ export class Surpay {
       check: actionGeneric({
         args: CheckArgs,
         handler: async (ctx, args) => {
-          const { client, identifierOpts } = await this.getAuthParams({ ctx });
+          const { client, identifierOpts } = await this.getAuthParams({ ctx: ctx as Ctx });
           return wrapSdkCall(() =>
             client.check({
-              product_id: args.product_id,
+              product_id: args.productId,
               customer_id: identifierOpts!.customerId,
             })
           );
@@ -132,27 +151,24 @@ export class Surpay {
       getCustomer: actionGeneric({
         args: GetCustomerArgs,
         handler: async (ctx, args) => {
-          const { client, identifierOpts } = await this.getAuthParams({ ctx });
-          const customerId = args.customer_id || identifierOpts!.customerId;
-          return wrapSdkCall(() =>
-            client.customers.get(args.project_id, customerId)
-          );
+          const { client } = await this.getAuthParams({ ctx: ctx as Ctx, requireAuth: false });
+          return wrapSdkCall(() => client.customers.get(args.customer_id));
         },
       }),
 
       listCustomers: actionGeneric({
         args: ListCustomersArgs,
-        handler: async (ctx, args) => {
-          const { client } = await this.getAuthParams({ ctx });
-          return wrapSdkCall(() => client.customers.list(args.project_id));
+        handler: async (ctx) => {
+          const { client } = await this.getAuthParams({ ctx: ctx as Ctx });
+          return wrapSdkCall(() => client.customers.list());
         },
       }),
 
       listSubscriptions: actionGeneric({
         args: ListSubscriptionsArgs,
-        handler: async (ctx, args) => {
-          const { client } = await this.getAuthParams({ ctx });
-          return wrapSdkCall(() => client.subscriptions.list(args.project_id));
+        handler: async (ctx) => {
+          const { client } = await this.getAuthParams({ ctx: ctx as Ctx });
+          return wrapSdkCall(() => client.subscriptions.list());
         },
       }),
     };
@@ -160,3 +176,4 @@ export class Surpay {
 }
 
 export * from "./types.js";
+export type { ResponseCase } from "@surgent-dev/surpay";

package/src/types.ts

@@ -3,38 +3,33 @@
  */
 import { v, Infer } from "convex/values";
 
-// CreateCheckoutArgs: product_id required, price_id/URLs optional
-// Note: customer_id is NOT here - it's injected by the wrapper via identify()
+// CreateCheckoutArgs: productId required, priceId/URLs optional
+// Note: customerId is NOT here - it's injected by the wrapper via identify()
 export const CreateCheckoutArgs = v.object({
-  product_id: v.string(),
-  price_id: v.optional(v.string()),
-  success_url: v.optional(v.string()),
-  cancel_url: v.optional(v.string()),
+  productId: v.string(),
+  priceId: v.optional(v.string()),
+  successUrl: v.optional(v.string()),
+  cancelUrl: v.optional(v.string()),
 });
 export type CreateCheckoutArgs = Infer<typeof CreateCheckoutArgs>;
 
-// CheckArgs: product_id required
-// Note: customer_id is NOT here - it's injected by the wrapper via identify()
+// CheckArgs: productId required
+// Note: customerId is NOT here - it's injected by the wrapper via identify()
 export const CheckArgs = v.object({
-  product_id: v.string(),
+  productId: v.string(),
 });
 export type CheckArgs = Infer<typeof CheckArgs>;
 
-// ListSubscriptions: requires project_id
-export const ListSubscriptionsArgs = v.object({
-  project_id: v.string(),
-});
+// ListSubscriptions: no args required (project_id from auth context)
+export const ListSubscriptionsArgs = v.object({});
 export type ListSubscriptionsArgs = Infer<typeof ListSubscriptionsArgs>;
 
-// GetCustomer: requires project_id and customer_id
+// GetCustomer: requires customer_id (project_id from auth context)
 export const GetCustomerArgs = v.object({
-  project_id: v.string(),
   customer_id: v.string(),
 });
 export type GetCustomerArgs = Infer<typeof GetCustomerArgs>;
 
-// ListCustomers: requires project_id
-export const ListCustomersArgs = v.object({
-  project_id: v.string(),
-});
+// ListCustomers: no args required (project_id from auth context)
+export const ListCustomersArgs = v.object({});
 export type ListCustomersArgs = Infer<typeof ListCustomersArgs>;