convex-flutterwave 0.0.1

package/dist/component/lib.js

@@ -0,0 +1,223 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server.js";
+const transactionStatusValidator = v.union(v.literal("pending"), v.literal("successful"), v.literal("failed"), v.literal("cancelled"));
+const subscriptionStatusValidator = v.union(v.literal("active"), v.literal("cancelled"));
+const transactionValidator = v.object({
+    _id: v.id("transactions"),
+    _creationTime: v.number(),
+    txRef: v.string(),
+    flwRef: v.optional(v.string()),
+    transactionId: v.optional(v.string()),
+    customerEmail: v.string(),
+    amount: v.number(),
+    currency: v.string(),
+    status: transactionStatusValidator,
+    paymentType: v.optional(v.string()),
+    narration: v.optional(v.string()),
+    paidAt: v.optional(v.number()),
+    metadata: v.optional(v.string()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+});
+const subscriptionValidator = v.object({
+    _id: v.id("subscriptions"),
+    _creationTime: v.number(),
+    subscriptionId: v.string(),
+    customerEmail: v.string(),
+    planId: v.optional(v.string()),
+    amount: v.optional(v.number()),
+    status: subscriptionStatusValidator,
+    createdAt: v.number(),
+    updatedAt: v.number(),
+});
+const webhookEventValidator = v.object({
+    _id: v.id("webhookEvents"),
+    _creationTime: v.number(),
+    eventId: v.string(),
+    eventType: v.string(),
+    txRef: v.optional(v.string()),
+    payload: v.string(),
+    receivedAt: v.number(),
+});
+// ─── Queries ────────────────────────────────────────────────────────────────
+export const getTransaction = query({
+    args: { txRef: v.string() },
+    returns: v.union(v.null(), transactionValidator),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("transactions")
+            .withIndex("by_txRef", (q) => q.eq("txRef", args.txRef))
+            .first();
+    },
+});
+export const listTransactions = query({
+    args: { customerEmail: v.string(), limit: v.optional(v.number()) },
+    returns: v.array(transactionValidator),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("transactions")
+            .withIndex("by_customerEmail", (q) => q.eq("customerEmail", args.customerEmail))
+            .order("desc")
+            .take(args.limit ?? 50);
+    },
+});
+export const getSubscription = query({
+    args: { subscriptionId: v.string() },
+    returns: v.union(v.null(), subscriptionValidator),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("subscriptions")
+            .withIndex("by_subscriptionId", (q) => q.eq("subscriptionId", args.subscriptionId))
+            .first();
+    },
+});
+export const listSubscriptions = query({
+    args: { customerEmail: v.string() },
+    returns: v.array(subscriptionValidator),
+    handler: async (ctx, args) => {
+        return await ctx.db
+            .query("subscriptions")
+            .withIndex("by_customerEmail", (q) => q.eq("customerEmail", args.customerEmail))
+            .order("desc")
+            .collect();
+    },
+});
+export const hasActiveSubscription = query({
+    args: { customerEmail: v.string() },
+    returns: v.boolean(),
+    handler: async (ctx, args) => {
+        const sub = await ctx.db
+            .query("subscriptions")
+            .withIndex("by_customerEmail", (q) => q.eq("customerEmail", args.customerEmail))
+            .order("desc")
+            .first();
+        return sub?.status === "active";
+    },
+});
+export const listRecentEvents = query({
+    args: { limit: v.optional(v.number()) },
+    returns: v.array(webhookEventValidator),
+    handler: async (ctx, args) => {
+        return await ctx.db.query("webhookEvents").order("desc").take(args.limit ?? 50);
+    },
+});
+export const getStats = query({
+    args: {},
+    returns: v.object({ transactions: v.number(), subscriptions: v.number(), events: v.number() }),
+    handler: async (ctx) => {
+        const [transactions, subscriptions, events] = await Promise.all([
+            ctx.db.query("transactions").collect(),
+            ctx.db.query("subscriptions").collect(),
+            ctx.db.query("webhookEvents").collect(),
+        ]);
+        return { transactions: transactions.length, subscriptions: subscriptions.length, events: events.length };
+    },
+});
+// ─── Mutations ──────────────────────────────────────────────────────────────
+export const recordTransaction = mutation({
+    args: {
+        txRef: v.string(),
+        flwRef: v.optional(v.string()),
+        transactionId: v.optional(v.string()),
+        customerEmail: v.string(),
+        amount: v.number(),
+        currency: v.string(),
+        status: transactionStatusValidator,
+        paymentType: v.optional(v.string()),
+        narration: v.optional(v.string()),
+        paidAt: v.optional(v.number()),
+        metadata: v.optional(v.string()),
+    },
+    returns: v.id("transactions"),
+    handler: async (ctx, args) => {
+        const now = Date.now();
+        const existing = await ctx.db
+            .query("transactions")
+            .withIndex("by_txRef", (q) => q.eq("txRef", args.txRef))
+            .first();
+        if (existing) {
+            // Keep the email the merchant originally passed to initializeTransaction
+            // rather than whatever the webhook/verify response echoes back. Some
+            // processors (Flutterwave's test mode, notably) rewrite the customer
+            // email in their own responses — e.g. prefixing it with a sandbox
+            // routing tag like "ravesb_<hash>_" — which would otherwise silently
+            // overwrite the real address callers query by.
+            const { customerEmail: _incomingEmail, ...rest } = args;
+            await ctx.db.patch(existing._id, { ...rest, updatedAt: now });
+            return existing._id;
+        }
+        return await ctx.db.insert("transactions", {
+            ...args,
+            createdAt: now,
+            updatedAt: now,
+        });
+    },
+});
+export const recordSubscriptionEvent = mutation({
+    args: {
+        subscriptionId: v.string(),
+        customerEmail: v.string(),
+        planId: v.optional(v.string()),
+        amount: v.optional(v.number()),
+        status: subscriptionStatusValidator,
+    },
+    returns: v.id("subscriptions"),
+    handler: async (ctx, args) => {
+        const now = Date.now();
+        const existing = await ctx.db
+            .query("subscriptions")
+            .withIndex("by_subscriptionId", (q) => q.eq("subscriptionId", args.subscriptionId))
+            .first();
+        if (existing) {
+            // Same reasoning as recordTransaction: don't let a later webhook or
+            // sync call overwrite the email a subscription was first recorded
+            // under with a processor-mangled value.
+            const { customerEmail: _incomingEmail, ...rest } = args;
+            await ctx.db.patch(existing._id, { ...rest, updatedAt: now });
+            return existing._id;
+        }
+        return await ctx.db.insert("subscriptions", {
+            ...args,
+            createdAt: now,
+            updatedAt: now,
+        });
+    },
+});
+export const updateSubscriptionStatus = mutation({
+    args: {
+        subscriptionId: v.string(),
+        status: subscriptionStatusValidator,
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const existing = await ctx.db
+            .query("subscriptions")
+            .withIndex("by_subscriptionId", (q) => q.eq("subscriptionId", args.subscriptionId))
+            .first();
+        if (!existing)
+            return null;
+        await ctx.db.patch(existing._id, { status: args.status, updatedAt: Date.now() });
+        return null;
+    },
+});
+export const checkAndRecordEvent = mutation({
+    args: {
+        eventId: v.string(),
+        eventType: v.string(),
+        txRef: v.optional(v.string()),
+        payload: v.string(),
+    },
+    returns: v.object({ alreadyProcessed: v.boolean() }),
+    handler: async (ctx, args) => {
+        const existing = await ctx.db
+            .query("webhookEvents")
+            .withIndex("by_eventId", (q) => q.eq("eventId", args.eventId))
+            .first();
+        if (existing) {
+            return { alreadyProcessed: true };
+        }
+        await ctx.db.insert("webhookEvents", { ...args, receivedAt: Date.now() });
+        return { alreadyProcessed: false };
+    },
+});
+//# sourceMappingURL=lib.js.map

package/dist/component/lib.js.map

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

package/dist/component/schema.d.ts

@@ -0,0 +1,73 @@
+declare const _default: import("convex/server").SchemaDefinition<{
+    transactions: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        flwRef?: string | undefined;
+        metadata?: string | undefined;
+        narration?: string | undefined;
+        paidAt?: number | undefined;
+        paymentType?: string | undefined;
+        transactionId?: string | undefined;
+        txRef: string;
+        customerEmail: string;
+        amount: number;
+        status: "cancelled" | "pending" | "successful" | "failed";
+        currency: string;
+        createdAt: number;
+        updatedAt: number;
+    }, {
+        txRef: import("convex/values").VString<string, "required">;
+        flwRef: import("convex/values").VString<string | undefined, "optional">;
+        transactionId: import("convex/values").VString<string | undefined, "optional">;
+        customerEmail: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        status: import("convex/values").VUnion<"cancelled" | "pending" | "successful" | "failed", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"successful", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"cancelled", "required">], "required", never>;
+        paymentType: import("convex/values").VString<string | undefined, "optional">;
+        narration: import("convex/values").VString<string | undefined, "optional">;
+        paidAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        metadata: import("convex/values").VString<string | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "txRef" | "customerEmail" | "amount" | "status" | "currency" | "flwRef" | "metadata" | "narration" | "paidAt" | "paymentType" | "transactionId" | "createdAt" | "updatedAt">, {
+        by_txRef: ["txRef", "_creationTime"];
+        by_customerEmail: ["customerEmail", "_creationTime"];
+    }, {}, {}>;
+    subscriptions: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        amount?: number | undefined;
+        planId?: string | undefined;
+        subscriptionId: string;
+        customerEmail: string;
+        status: "active" | "cancelled";
+        createdAt: number;
+        updatedAt: number;
+    }, {
+        subscriptionId: import("convex/values").VString<string, "required">;
+        customerEmail: import("convex/values").VString<string, "required">;
+        planId: import("convex/values").VString<string | undefined, "optional">;
+        amount: import("convex/values").VFloat64<number | undefined, "optional">;
+        status: import("convex/values").VUnion<"active" | "cancelled", [import("convex/values").VLiteral<"active", "required">, import("convex/values").VLiteral<"cancelled", "required">], "required", never>;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "subscriptionId" | "customerEmail" | "amount" | "planId" | "status" | "createdAt" | "updatedAt">, {
+        by_subscriptionId: ["subscriptionId", "_creationTime"];
+        by_customerEmail: ["customerEmail", "_creationTime"];
+        by_status: ["status", "_creationTime"];
+    }, {}, {}>;
+    webhookEvents: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        txRef?: string | undefined;
+        eventId: string;
+        eventType: string;
+        payload: string;
+        receivedAt: number;
+    }, {
+        eventId: import("convex/values").VString<string, "required">;
+        eventType: import("convex/values").VString<string, "required">;
+        txRef: import("convex/values").VString<string | undefined, "optional">;
+        payload: import("convex/values").VString<string, "required">;
+        receivedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "eventId" | "eventType" | "payload" | "txRef" | "receivedAt">, {
+        by_eventId: ["eventId", "_creationTime"];
+        by_eventType: ["eventType", "_creationTime"];
+    }, {}, {}>;
+}, true>;
+export default _default;
+//# sourceMappingURL=schema.d.ts.map

package/dist/component/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,wBA8CG"}

package/dist/component/schema.js

@@ -0,0 +1,43 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+export default defineSchema({
+    transactions: defineTable({
+        txRef: v.string(),
+        flwRef: v.optional(v.string()),
+        transactionId: v.optional(v.string()),
+        customerEmail: v.string(),
+        amount: v.number(),
+        currency: v.string(),
+        status: v.union(v.literal("pending"), v.literal("successful"), v.literal("failed"), v.literal("cancelled")),
+        paymentType: v.optional(v.string()),
+        narration: v.optional(v.string()),
+        paidAt: v.optional(v.number()),
+        metadata: v.optional(v.string()),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    })
+        .index("by_txRef", ["txRef"])
+        .index("by_customerEmail", ["customerEmail"]),
+    subscriptions: defineTable({
+        subscriptionId: v.string(),
+        customerEmail: v.string(),
+        planId: v.optional(v.string()),
+        amount: v.optional(v.number()),
+        status: v.union(v.literal("active"), v.literal("cancelled")),
+        createdAt: v.number(),
+        updatedAt: v.number(),
+    })
+        .index("by_subscriptionId", ["subscriptionId"])
+        .index("by_customerEmail", ["customerEmail"])
+        .index("by_status", ["status"]),
+    webhookEvents: defineTable({
+        eventId: v.string(),
+        eventType: v.string(),
+        txRef: v.optional(v.string()),
+        payload: v.string(),
+        receivedAt: v.number(),
+    })
+        .index("by_eventId", ["eventId"])
+        .index("by_eventType", ["eventType"]),
+});
+//# sourceMappingURL=schema.js.map

package/dist/component/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,eAAe,YAAY,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EACvB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EACnB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CACvB;QACD,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;SAC5B,KAAK,CAAC,kBAAkB,EAAE,CAAC,eAAe,CAAC,CAAC;IAE/C,aAAa,EAAE,WAAW,CAAC;QACzB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;SACC,KAAK,CAAC,mBAAmB,EAAE,CAAC,gBAAgB,CAAC,CAAC;SAC9C,KAAK,CAAC,kBAAkB,EAAE,CAAC,eAAe,CAAC,CAAC;SAC5C,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;IAEjC,aAAa,EAAE,WAAW,CAAC;QACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC;SACC,KAAK,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC;SAChC,KAAK,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC;CACxC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "convex-flutterwave",
+  "description": "Accept payments and subscriptions with Flutterwave in your Convex app. Reactive transactions, subscription state, and webhook ingestion.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sholajegede/convex-flutterwave.git"
+  },
+  "homepage": "https://github.com/sholajegede/convex-flutterwave#readme",
+  "bugs": {
+    "url": "https://github.com/sholajegede/convex-flutterwave/issues"
+  },
+  "version": "0.0.1",
+  "license": "Apache-2.0",
+  "keywords": [
+    "convex",
+    "component",
+    "flutterwave",
+    "payments",
+    "billing",
+    "subscriptions",
+    "webhooks",
+    "africa"
+  ],
+  "type": "module",
+  "scripts": {
+    "dev": "run-p -r 'dev:*'",
+    "dev:backend": "convex dev --typecheck-components",
+    "dev:frontend": "cd example && vite --clearScreen false",
+    "dev:build": "chokidar 'tsconfig*.json' 'src/**/*.ts' -i '**/*.test.ts' -c 'npm run build:codegen' --initial",
+    "predev": "path-exists .env.local dist || (npm run build && convex dev --once)",
+    "build": "tsc --project ./tsconfig.build.json",
+    "build:codegen": "npx convex codegen --component-dir ./src/component && npm run build",
+    "build:clean": "rm -rf dist *.tsbuildinfo && npm run build:codegen",
+    "typecheck": "tsc --noEmit && tsc -p example && tsc -p example/convex",
+    "lint": "eslint .",
+    "all": "run-p -r 'dev:*' 'test:watch'",
+    "test": "vitest run --typecheck",
+    "test:watch": "vitest --typecheck --clearScreen false",
+    "test:debug": "vitest --inspect-brk --no-file-parallelism",
+    "test:coverage": "vitest run --coverage --coverage.reporter=text",
+    "preversion": "npm install --legacy-peer-deps && npm run build:clean && run-p test lint typecheck",
+    "prepublishOnly": "npm whoami || npm login",
+    "alpha": "npm version prerelease --preid alpha && npm publish --tag alpha && git push --follow-tags",
+    "release": "npm version patch && npm publish && git push --follow-tags",
+    "version": "vim -c 'normal o' -c 'normal o## '$npm_package_version CHANGELOG.md && prettier -w CHANGELOG.md && git add CHANGELOG.md"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./test": "./src/test.ts",
+    "./_generated/component.js": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./_generated/component": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./convex.config.js": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    },
+    "./convex.config": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    }
+  },
+  "peerDependencies": {
+    "convex": "^1.34.1"
+  },
+  "devDependencies": {
+    "@convex-dev/eslint-plugin": "^1.2.0",
+    "@edge-runtime/vm": "^5.0.0",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "9.39.4",
+    "@types/node": "^24.12.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.2.0",
+    "chokidar-cli": "3.0.0",
+    "convex": "1.45.0",
+    "convex-test": "0.0.41",
+    "eslint": "9.39.4",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.4.0",
+    "npm-run-all2": "8.0.4",
+    "path-exists-cli": "2.0.0",
+    "pkg-pr-new": "^0.0.66",
+    "prettier": "3.8.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.57.1",
+    "vite": "7.3.1",
+    "vitest": "4.1.0"
+  },
+  "types": "./dist/client/index.d.ts",
+  "module": "./dist/client/index.js"
+}

package/src/client/_generated/_ignore.ts

@@ -0,0 +1 @@
+// This is only here so convex-test can detect a _generated folder