@raideno/convex-stripe 0.3.4 → 0.3.5

package/README.md

@@ -17,9 +17,9 @@ Stripe [syncing](./documentation/references/tables.md), subscriptions, [checkout
     - [7. Run the `sync` Action](#7-run-the-sync-action)
     - [8. Start Building](#8-start-building)
   - [Configuration](#configuration)
+    - [Schema Configuration](#schema-configuration)
     - [Stripe Configuration](#stripe-configuration)
     - [Sync Configuration](#sync-configuration)
-      - [Table Selection](#table-selection)
       - [Catalog (Unstable)](#catalog-unstable)
       - [Webhook Configuration](#webhook-configuration)
       - [Portal Configuration](#portal-configuration)
@@ -113,8 +113,7 @@ export default defineSchema({
 });
 ```
 
-> [!WARNING]
-> Ensure that your table configuration in `convex/schema.ts` matches your `sync.tables` configuration in `convex/stripe.ts` exactly! If your `sync.tables` tries to sync a table that is excluded from your schema, Convex Stripe will throw a runtime error when processing webhooks.
+The package will only sync the tables you defined.
 
 See [Tables Reference](./documentation/references/tables.md) for the full list of tables and their schemas.
 
@@ -125,16 +124,16 @@ Call `internalConvexStripe` with your Stripe credentials and sync configuration.
 ```ts
 // convex/stripe.ts
 
-import { internalConvexStripe, syncAllTables } from "@raideno/convex-stripe/server";
+import { internalConvexStripe } from "@raideno/convex-stripe/server";
+
+import schema from "./schema";
 
 export const { stripe, store, sync } = internalConvexStripe({
+  schema: schema,
   stripe: {
     secret_key: process.env.STRIPE_SECRET_KEY!,
     account_webhook_secret: process.env.STRIPE_ACCOUNT_WEBHOOK_SECRET!,
   },
-  sync: {
-    tables: syncAllTables(),
-  },
 });
 ```
 
@@ -260,6 +259,9 @@ The `internalConvexStripe` function accepts a configuration object and an option
 ```ts
 const { stripe, store, sync } = internalConvexStripe(configuration, options);
 ```
+### Schema Configuration
+
+The `schema` key holds your convex app schema, from it the package will infer which stripe tables should be synced or not depending on what stripeTables where defined.
 
 ### Stripe Configuration
 
@@ -276,29 +278,6 @@ The `stripe` key in the configuration object holds your Stripe credentials and A
 
 The `sync` key controls which tables are synced and allows you to define catalog items, webhook endpoints, and billing portal configuration.
 
-#### Table Selection
-
-Three helper functions are provided to control which Stripe tables are synced into Convex:
-
-```ts
-import {
-  syncAllTables,
-  syncAllTablesExcept,
-  syncOnlyTables,
-} from "@raideno/convex-stripe/server";
-
-// Sync all 24 tables (default)
-{ tables: syncAllTables() }
-
-// Sync all tables except specific ones
-{ tables: syncAllTablesExcept(["stripeReviews", "stripePlans"]) }
-
-// Sync only specific tables
-{ tables: syncOnlyTables(["stripeCustomers", "stripeSubscriptions", "stripeProducts", "stripePrices"]) }
-```
-
-All 24 available tables are listed in the [Synced Tables](#synced-tables) section.
-
 #### Catalog (Unstable)
 
 The `sync.catalog` key lets you pre-define products and prices that should exist in Stripe. When the `sync` action is called with `{ catalog: true }`, the library ensures these objects exist in your Stripe account.
@@ -307,7 +286,6 @@ The `sync.catalog` key lets you pre-define products and prices that should exist
 internalConvexStripe({
   // ...
   sync: {
-    tables: syncAllTables(),
     catalog: {
       products: [
         { name: "Pro Plan", metadata: { convex_stripe_key: "pro" } },
@@ -502,15 +480,17 @@ Then update your configuration to include it:
 ```ts
 // convex/stripe.ts
 
+import { internalConvexStripe } from "@raideno/convex-stripe/server";
+
+import schema from "./schema";
+
 export const { stripe, store, sync } = internalConvexStripe({
+  schema: schema,
   stripe: {
     secret_key: process.env.STRIPE_SECRET_KEY!,
     account_webhook_secret: process.env.STRIPE_ACCOUNT_WEBHOOK_SECRET!,
     connect_webhook_secret: process.env.STRIPE_CONNECT_WEBHOOK_SECRET!,
-  },
-  sync: {
-    tables: syncAllTables(),
-  },
+  }
 });
 ```
 

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import { GenericActionCtx } from 'convex/server';
 import { GenericDataModel } from 'convex/server';
 import { GenericId } from 'convex/values';
 import { GenericMutationCtx } from 'convex/server';
+import { GenericSchema } from 'convex/server';
 import { HttpRouter } from 'convex/server';
 import { Infer } from 'convex/values';
 import { RegisteredAction } from 'convex/server';
@@ -176,6 +177,7 @@ declare type InferArgs<S extends ArgSchema> = {
 };
 
 export declare interface InputConfiguration {
+    schema: SchemaDefinition<GenericSchema, true>;
     stripe: {
         /** Stripe API version to pin against (recommended for stability). */
         version?: default_2.StripeConfig["apiVersion"];
@@ -189,7 +191,7 @@ export declare interface InputConfiguration {
          */
         connect_webhook_secret?: string;
     };
-    sync: {
+    sync?: {
         catalog?: {
             /** Products to ensure exist in Stripe (optional bootstrap). */
             products?: default_2.ProductCreateParams[];
@@ -235,7 +237,7 @@ export declare interface InputConfiguration {
         /** Optional Billing Portal configuration to create/sync. */
         portal?: default_2.BillingPortal.ConfigurationCreateParams;
         /** Which Stripe tables you want to sync into Convex. */
-        tables: Record<keyof typeof stripeTables, boolean>;
+        tables?: Record<keyof typeof stripeTables, boolean>;
     };
     callbacks?: {
         /** Called after a row is inserted/upserted/deleted in your Stripe tables. */
@@ -282,7 +284,11 @@ export declare type InternalConfiguration = RecursiveDeepRequired<InputConfigura
  *   },
  * });
  */
-export declare const internalConvexStripe: (configuration_: InputConfiguration, options_?: InputOptions) => {
+export declare const internalConvexStripe: (configuration_: InputConfiguration & {
+    sync?: {
+        tables?: never;
+    };
+}, options_?: InputOptions) => {
     stripe: {
         /** Raw HTTP handler descriptors. Prefer `addHttpRoutes` unless you need manual control. */
         http: {
@@ -318,7 +324,7 @@ export declare const internalConvexStripe: (configuration_: InputConfiguration,
          * stripe.addHttpRoutes(http);
          * export default http;
          */
-        addHttpRoutes: (http: HttpRouter, config?: InputConfiguration) => void;
+        addHttpRoutes: (http: HttpRouter) => void;
         /**
          * Opens a Stripe Billing Portal session for an existing customer.
          * Use this to let users manage their subscription, invoices, and payment methods.
@@ -9312,12 +9318,6 @@ export declare const SYNC_HANDLERS: readonly [{
     }, configuration: InternalConfiguration, options: InternalOptions) => Promise<void>;
 }];
 
-export declare const syncAllTables: () => Record<keyof typeof stripeTables, boolean>;
-
-export declare const syncAllTablesExcept: (tables: Array<keyof typeof stripeTables>) => Record<keyof typeof stripeTables, boolean>;
-
-export declare const syncOnlyTables: (tables: Array<keyof typeof stripeTables>) => Record<keyof typeof stripeTables, boolean>;
-
 export declare const WEBHOOK_HANDLERS: readonly [WebhookHandler<"account.updated">, WebhookHandler<"billing_portal.configuration.created" | "billing_portal.configuration.updated">, WebhookHandler<"capability.updated">, WebhookHandler<"charge.captured" | "charge.expired" | "charge.failed" | "charge.pending" | "charge.refunded" | "charge.succeeded" | "charge.updated">, WebhookHandler<"checkout.session.async_payment_failed" | "checkout.session.async_payment_succeeded" | "checkout.session.completed" | "checkout.session.expired">, WebhookHandler<"coupon.created" | "coupon.deleted" | "coupon.updated">, WebhookHandler<"credit_note.created" | "credit_note.updated" | "credit_note.voided">, WebhookHandler<"customer.created" | "customer.deleted" | "customer.updated">, WebhookHandler<"charge.dispute.closed" | "charge.dispute.created" | "charge.dispute.funds_reinstated" | "charge.dispute.funds_withdrawn" | "charge.dispute.updated">, WebhookHandler<"radar.early_fraud_warning.created" | "radar.early_fraud_warning.updated">, WebhookHandler<"invoice.created" | "invoice.deleted" | "invoice.finalization_failed" | "invoice.finalized" | "invoice.marked_uncollectible" | "invoice.overdue" | "invoice.overpaid" | "invoice.paid" | "invoice.payment_action_required" | "invoice.payment_failed" | "invoice.payment_succeeded" | "invoice.sent" | "invoice.upcoming" | "invoice.updated" | "invoice.voided" | "invoice.will_be_due">, WebhookHandler<"mandate.updated">, WebhookHandler<"payment_intent.amount_capturable_updated" | "payment_intent.canceled" | "payment_intent.created" | "payment_intent.partially_funded" | "payment_intent.payment_failed" | "payment_intent.processing" | "payment_intent.requires_action" | "payment_intent.succeeded">, WebhookHandler<"payment_method.attached" | "payment_method.automatically_updated" | "payment_method.detached" | "payment_method.updated">, WebhookHandler<"payout.canceled" | "payout.created" | "payout.failed" | "payout.paid" | "payout.reconciliation_completed" | "payout.updated">, WebhookHandler<"plan.created" | "plan.deleted" | "plan.updated">, WebhookHandler<"price.created" | "price.deleted" | "price.updated">, WebhookHandler<"product.created" | "product.deleted" | "product.updated">, WebhookHandler<"promotion_code.created" | "promotion_code.updated">, WebhookHandler<"charge.refund.updated" | "refund.created" | "refund.failed" | "refund.updated">, WebhookHandler<"review.closed" | "review.opened">, WebhookHandler<"setup_intent.canceled" | "setup_intent.created" | "setup_intent.requires_action" | "setup_intent.setup_failed" | "setup_intent.succeeded">, WebhookHandler<"subscription_schedule.aborted" | "subscription_schedule.canceled" | "subscription_schedule.completed" | "subscription_schedule.created" | "subscription_schedule.expiring" | "subscription_schedule.released" | "subscription_schedule.updated">, WebhookHandler<"customer.subscription.created" | "customer.subscription.deleted" | "customer.subscription.paused" | "customer.subscription.pending_update_applied" | "customer.subscription.pending_update_expired" | "customer.subscription.resumed" | "customer.subscription.trial_will_end" | "customer.subscription.updated">, WebhookHandler<"customer.tax_id.created" | "customer.tax_id.deleted" | "customer.tax_id.updated">, WebhookHandler<"transfer.created" | "transfer.reversed" | "transfer.updated">];
 
 declare type WebhookHandler<TEvents extends default_2.Event.Type> = {

package/dist/server.js

@@ -5612,21 +5612,6 @@ const stripeTables = {
   }).index("byAccountId", ["accountId"]).index(BY_STRIPE_ID_INDEX_NAME, ["capabilityId"])
 };
 defineSchema(stripeTables);
-const syncAllTables = () => Object.fromEntries(
-  Object.keys(stripeTables).map((table) => [table, true])
-);
-const syncAllTablesExcept = (tables) => Object.fromEntries(
-  Object.keys(stripeTables).map((table) => [
-    table,
-    !tables.includes(table)
-  ])
-);
-const syncOnlyTables = (tables) => Object.fromEntries(
-  Object.keys(stripeTables).map((table) => [
-    table,
-    tables.includes(table)
-  ])
-);
 const allStripeTablesExcept = (tables) => Object.fromEntries(
   Object.entries(stripeTables).map(([table, definition]) => [
     table,
@@ -5640,6 +5625,7 @@ const onlyStripeTables = (tables) => Object.fromEntries(
   ])
 );
 const DEFAULT_CONFIGURATION = {
+  schema: void 0,
   stripe: {
     version: "2025-08-27.basil",
     secret_key: "",
@@ -5659,42 +5645,42 @@ const DEFAULT_CONFIGURATION = {
     }
   },
   sync: {
-    catalog: {
-      products: [],
-      prices: [],
-      metadataKey: "convex_stripe_key",
-      behavior: {
-        onExisting: "update",
-        onMissingKey: "create"
-      }
-    },
     tables: {
       stripeAccounts: true,
+      stripeBillingPortalConfigurations: true,
       stripeCapabilities: true,
-      stripeTransfers: true,
+      stripeCharges: true,
+      stripeCheckoutSessions: true,
       stripeCoupons: true,
+      stripeCreditNotes: true,
       stripeCustomers: true,
+      stripeDisputes: true,
+      stripeEarlyFraudWarnings: true,
+      stripeInvoices: true,
+      stripeMandates: true,
+      stripePaymentIntents: true,
+      stripePaymentMethods: true,
+      stripePayouts: true,
+      stripePlans: true,
       stripePrices: true,
       stripeProducts: true,
       stripePromotionCodes: true,
-      stripeSubscriptions: true,
-      stripePayouts: true,
-      stripeCheckoutSessions: true,
-      stripePaymentIntents: true,
       stripeRefunds: true,
-      stripeInvoices: true,
       stripeReviews: true,
-      stripeCharges: true,
-      stripeCreditNotes: true,
-      stripeDisputes: true,
-      stripeEarlyFraudWarnings: true,
-      stripePaymentMethods: true,
-      stripePlans: true,
       stripeSetupIntents: true,
+      stripeSubscriptions: true,
       stripeSubscriptionSchedules: true,
       stripeTaxIds: true,
-      stripeMandates: true,
-      stripeBillingPortalConfigurations: true
+      stripeTransfers: true
+    },
+    catalog: {
+      products: [],
+      prices: [],
+      metadataKey: "convex_stripe_key",
+      behavior: {
+        onExisting: "update",
+        onMissingKey: "create"
+      }
     },
     webhooks: {
       account: {
@@ -5763,8 +5749,13 @@ const DEFAULT_CONFIGURATION = {
     }
   }
 };
-const normalizeConfiguration = (config) => {
-  return deepmerge(DEFAULT_CONFIGURATION, config);
+const normalizeConfiguration = (configuration) => {
+  const output = deepmerge(DEFAULT_CONFIGURATION, configuration);
+  const stripeTableNames = Object.keys(stripeTables);
+  output.sync.tables = Object.fromEntries(
+    Object.keys(configuration.schema.tables).filter((table) => stripeTableNames.includes(table)).map((table) => [table, true])
+  );
+  return output;
 };
 const DEFAULT_OPTIONS = {
   store: "store",
@@ -9527,8 +9518,7 @@ const internalConvexStripe = (configuration_, options_) => {
        * stripe.addHttpRoutes(http);
        * export default http;
        */
-      addHttpRoutes: (http, config) => {
-        config = normalizeConfiguration(config || configuration_);
+      addHttpRoutes: (http) => {
         http.route({
           path: http_.webhook.path,
           method: http_.webhook.method,
@@ -9679,8 +9669,5 @@ export {
   defineWebhookHandler,
   internalConvexStripe,
   onlyStripeTables,
-  stripeTables,
-  syncAllTables,
-  syncAllTablesExcept,
-  syncOnlyTables
+  stripeTables
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raideno/convex-stripe",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Easy stripe billing for convex apps.",
   "keywords": [
     "billing",