@raideno/convex-stripe 0.2.4 → 0.2.5

package/dist/index.d.ts

@@ -5,11 +5,13 @@ import { GenericDataModel } from 'convex/server';
 import { GenericId } from 'convex/values';
 import { GenericMutationCtx } from 'convex/server';
 import { HttpRouter } from 'convex/server';
+import { Infer } from 'convex/values';
 import { RegisteredAction } from 'convex/server';
 import { RegisteredMutation } from 'convex/server';
 import { RoutableMethod } from 'convex/server';
 import { SchemaDefinition } from 'convex/server';
 import { TableDefinition } from 'convex/server';
+import { Validator } from 'convex/values';
 import { VAny } from 'convex/values';
 import { VArray } from 'convex/values';
 import { VBoolean } from 'convex/values';
@@ -21,6 +23,18 @@ import { VRecord } from 'convex/values';
 import { VString } from 'convex/values';
 import { VUnion } from 'convex/values';
 
+declare type AllRedirectHandlers = (typeof REDIRECT_HANDLERS)[number];
+
+declare type ArgSchema = Record<string, Validator<any, "optional" | "required", any>>;
+
+export declare function buildSignedReturnUrl<O extends ReturnOrigin>({ configuration, origin, failureUrl, targetUrl, data, }: {
+    configuration: InternalConfiguration;
+    origin: O;
+    failureUrl?: string;
+    targetUrl: string;
+    data: ReturnDataMap[O];
+}): Promise<string>;
+
 export declare type CallbackAfterChange = (context: GenericMutationCtx<any>, operation: "upsert" | "delete" | "insert", event: CallbackEvent) => Promise<void>;
 
 export declare type CallbackEvent = {
@@ -149,6 +163,14 @@ declare const CreateCustomerImplementation: {
     }>;
 };
 
+export declare function defineRedirectHandler<const T extends readonly string[], S extends ArgSchema = {}>(handler: RedirectHandler<T, S>): RedirectHandler<T, S>;
+
+declare type InferArgs<S extends ArgSchema> = {
+    [K in keyof S as S[K] extends Validator<any, "required", any> ? K : never]: Infer<S[K]>;
+} & {
+    [K in keyof S as S[K] extends Validator<any, "optional", any> ? K : never]?: Infer<S[K]>;
+};
+
 export declare interface InputConfiguration {
     stripe: {
         /** Stripe API version to pin against (recommended for stability). */
@@ -220,8 +242,12 @@ export declare interface InputConfiguration {
      * Document your intended behavior here.
      */
     detached?: boolean;
-    /** TTL for redirect state (ms). */
-    redirectTtlMs?: number;
+    redirect?: {
+        /** TTL for redirect state (ms). */
+        ttlMs?: number;
+        /** Additional handlers for redirect-based flows (e.g. Checkout, OAuth). */
+        handlers?: Array<ReturnType<typeof defineRedirectHandler>>;
+    };
 }
 
 export declare type InputOptions = Partial<InternalOptions>;
@@ -445,9 +471,9 @@ export declare const internalConvexStripe: (configuration_: InputConfiguration,
     store: RegisteredMutation<"internal", {
     id?: any;
     value?: any;
+    data?: any;
     indexName?: string | undefined;
     idField?: string | undefined;
-    data?: any;
     idValue?: any;
     field?: string | undefined;
     operation: string;
@@ -1632,6 +1658,22 @@ declare type RecursiveDeepRequired<T> = T extends (...args: any[]) => any ? T :
     [K in keyof T]-?: RecursiveDeepRequired<T[K]>;
 } : T;
 
+declare const REDIRECT_HANDLERS: RedirectHandler<readonly string[], ArgSchema>[];
+
+export declare type RedirectHandler<TOrigins extends readonly string[], S extends ArgSchema = {}> = {
+    origins: TOrigins;
+    data?: S;
+    handle: (origin: TOrigins[number], context: GenericActionCtx<StripeDataModel>, data: InferArgs<S>, configuration: InternalConfiguration, options: InternalOptions) => Promise<void>;
+};
+
+declare const RETURN_ORIGINS: string[];
+
+declare type ReturnDataMap = {
+    [H in AllRedirectHandlers as H["origins"][number]]: H extends RedirectHandler<any, infer S> ? InferArgs<S> : never;
+};
+
+declare type ReturnOrigin = (typeof RETURN_ORIGINS)[number];
+
 declare type StripeDataModel = DataModelFromSchemaDefinition<typeof stripeSchema>;
 
 declare const stripeSchema: SchemaDefinition<    {

package/dist/server.js

@@ -5628,7 +5628,10 @@ const DEFAULT_CONFIGURATION = {
     account_webhook_secret: "",
     connect_webhook_secret: ""
   },
-  redirectTtlMs: 15 * 60 * 1e3,
+  redirect: {
+    ttlMs: 15 * 60 * 1e3,
+    handlers: []
+  },
   detached: false,
   callbacks: {
     afterChange: async () => {
@@ -6322,7 +6325,7 @@ async function buildSignedReturnUrl({
     data,
     targetUrl,
     failureUrl,
-    exp: Date.now() + configuration.redirectTtlMs
+    exp: Date.now() + configuration.redirect.ttlMs
   };
   const data_ = toBase64Url(JSON.stringify(payload));
   const expected = await signData(
@@ -6365,10 +6368,11 @@ REDIRECT_HANDLERS.map(
   (handler) => handler.origins
 ).flat();
 const redirectImplementation = async (configuration, options, context, request) => {
+  const handlers = [...REDIRECT_HANDLERS, ...configuration.redirect.handlers];
   const url = new URL(request.url);
   const segments = url.pathname.split("/").filter(Boolean);
   const origin_ = segments[segments.length - 1];
-  if (!origin_ || !REDIRECT_HANDLERS.map((handler) => handler.origins).flat().includes(origin_)) {
+  if (!origin_ || !handlers.map((handler) => handler.origins).flat().includes(origin_)) {
     return new Response("Invalid return origin", { status: 400 });
   }
   const origin = origin_;
@@ -6419,7 +6423,7 @@ const redirectImplementation = async (configuration, options, context, request)
     }
     return new Response("Invalid target", { status: 400 });
   }
-  for (const handler of REDIRECT_HANDLERS) {
+  for (const handler of handlers) {
     if (handler.origins.includes(origin)) {
       try {
         await handler.handle(
@@ -9864,6 +9868,8 @@ const internalConvexStripe = (configuration_, options_) => {
 };
 export {
   Logger,
+  buildSignedReturnUrl,
+  defineRedirectHandler,
   internalConvexStripe,
   stripeTables,
   syncAllTables,

package/package.json

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