convex-flutterwave 0.0.1

package/dist/client/index.d.ts

@@ -0,0 +1,192 @@
+import { httpActionGeneric } from "convex/server";
+import type { GenericActionCtx, GenericDataModel } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+export type FlutterwaveOptions = {
+    secretKey: string;
+    webhookSecretHash: string;
+};
+export type FlutterwavePaymentOption = "card" | "account" | "banktransfer" | "ussd" | "nqr" | "mpesa" | "mobilemoneyghana" | "mobilemoneyuganda" | "mobilemoneyrwanda" | "mobilemoneyzambia" | "barter" | "credit" | "opay" | "fawrypay";
+export type InitializeTransactionArgs = {
+    email: string;
+    amount: number;
+    currency?: string;
+    redirectUrl: string;
+    txRef?: string;
+    customerName?: string;
+    customerPhoneNumber?: string;
+    /** Restricts which payment methods Flutterwave's hosted page offers. Omit to offer everything enabled on your account. */
+    paymentOptions?: FlutterwavePaymentOption[];
+    /** Links this checkout to a payment plan, turning it into a subscription. See createPaymentPlan(). */
+    paymentPlan?: string;
+    metadata?: Record<string, unknown>;
+};
+export type InitializeTransactionResult = {
+    paymentLink: string;
+    txRef: string;
+};
+export type VerifyTransactionResult = {
+    status: string;
+    txRef: string;
+    flwRef?: string;
+    transactionId: string;
+    amount: number;
+    currency: string;
+    paymentType?: string;
+    narration?: string;
+    paidAt?: number;
+    customerEmail: string;
+};
+export type CreatePaymentPlanArgs = {
+    name: string;
+    amount: number;
+    interval: "hourly" | "daily" | "weekly" | "monthly" | "quarterly" | "yearly" | "bi-annually";
+    currency?: string;
+    duration?: number;
+};
+export type PaymentPlanResult = {
+    planId: string;
+    name: string;
+    amount: number;
+    interval: string;
+    currency: string;
+    duration?: number;
+    status: string;
+};
+export declare class Flutterwave {
+    private component;
+    private options;
+    webhookHandler: ReturnType<typeof httpActionGeneric>;
+    constructor(component: ComponentApi, options: FlutterwaveOptions);
+    initializeTransaction(ctx: GenericActionCtx<GenericDataModel>, args: InitializeTransactionArgs): Promise<InitializeTransactionResult>;
+    verifyTransaction(ctx: GenericActionCtx<GenericDataModel>, args: {
+        transactionId: string;
+    }): Promise<VerifyTransactionResult>;
+    cancelSubscription(ctx: GenericActionCtx<GenericDataModel>, args: {
+        subscriptionId: string;
+        customerEmail: string;
+    }): Promise<void>;
+    enableSubscription(ctx: GenericActionCtx<GenericDataModel>, args: {
+        subscriptionId: string;
+        customerEmail: string;
+    }): Promise<void>;
+    createPaymentPlan(ctx: GenericActionCtx<GenericDataModel>, args: CreatePaymentPlanArgs): Promise<PaymentPlanResult>;
+    listPaymentPlans(_ctx: GenericActionCtx<GenericDataModel>): Promise<PaymentPlanResult[]>;
+    /**
+     * Flutterwave has no "subscription created" webhook — a subscription is
+     * created implicitly the first time a customer pays through a checkout
+     * initialized with `paymentPlan`, and that charge webhook doesn't carry
+     * the subscription's own id (only the plan id). This reads the customer's
+     * subscriptions straight from Flutterwave's Subscriptions API and upserts
+     * them locally — call it after a plan-linked checkout returns, or from a
+     * manual "sync" action, as a reliable way to populate subscription state.
+     */
+    private fetchFlutterwaveSubscriptions;
+    syncCustomerSubscriptions(ctx: GenericActionCtx<GenericDataModel>, args: {
+        email: string;
+    }): Promise<number>;
+    /**
+     * Attributes every subscription on a given plan to one email, regardless
+     * of what Flutterwave itself has on file as that subscription's customer.
+     * This is unsafe to reach for by default — a real plan can have many
+     * subscribers — but it's exactly what's needed when Flutterwave's
+     * test-mode sandbox has substituted its own fixed customer identity for
+     * every subscription (see the README's Subscriptions section), making
+     * email-based sync unable to find anything at all. Reach for it only
+     * where you already know (or, in a single-developer test/demo context,
+     * can safely assume) there's one subscriber to claim — the example app
+     * uses it as a fallback for exactly that reason.
+     */
+    syncSubscriptionsByPlan(ctx: GenericActionCtx<GenericDataModel>, args: {
+        planId: string;
+        email: string;
+    }): Promise<number>;
+    getTransaction(ctx: RunQueryCtx, args: {
+        txRef: string;
+    }): Promise<{
+        _creationTime: number;
+        _id: string;
+        amount: number;
+        createdAt: number;
+        currency: string;
+        customerEmail: string;
+        flwRef?: string;
+        metadata?: string;
+        narration?: string;
+        paidAt?: number;
+        paymentType?: string;
+        status: "pending" | "successful" | "failed" | "cancelled";
+        transactionId?: string;
+        txRef: string;
+        updatedAt: number;
+    } | null>;
+    listTransactions(ctx: RunQueryCtx, args: {
+        customerEmail: string;
+        limit?: number;
+    }): Promise<{
+        _creationTime: number;
+        _id: string;
+        amount: number;
+        createdAt: number;
+        currency: string;
+        customerEmail: string;
+        flwRef?: string;
+        metadata?: string;
+        narration?: string;
+        paidAt?: number;
+        paymentType?: string;
+        status: "pending" | "successful" | "failed" | "cancelled";
+        transactionId?: string;
+        txRef: string;
+        updatedAt: number;
+    }[]>;
+    getSubscription(ctx: RunQueryCtx, args: {
+        subscriptionId: string;
+    }): Promise<{
+        _creationTime: number;
+        _id: string;
+        amount?: number;
+        createdAt: number;
+        customerEmail: string;
+        planId?: string;
+        status: "active" | "cancelled";
+        subscriptionId: string;
+        updatedAt: number;
+    } | null>;
+    listSubscriptions(ctx: RunQueryCtx, args: {
+        customerEmail: string;
+    }): Promise<{
+        _creationTime: number;
+        _id: string;
+        amount?: number;
+        createdAt: number;
+        customerEmail: string;
+        planId?: string;
+        status: "active" | "cancelled";
+        subscriptionId: string;
+        updatedAt: number;
+    }[]>;
+    hasActiveSubscription(ctx: RunQueryCtx, args: {
+        customerEmail: string;
+    }): Promise<boolean>;
+    listRecentEvents(ctx: RunQueryCtx, args?: {
+        limit?: number;
+    }): Promise<{
+        _creationTime: number;
+        _id: string;
+        eventId: string;
+        eventType: string;
+        payload: string;
+        receivedAt: number;
+        txRef?: string;
+    }[]>;
+    getStats(ctx: RunQueryCtx): Promise<{
+        events: number;
+        subscriptions: number;
+        transactions: number;
+    }>;
+}
+type RunQueryCtx = {
+    runQuery: GenericActionCtx<GenericDataModel>["runQuery"];
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

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

package/dist/client/index.js

@@ -0,0 +1,364 @@
+import { httpActionGeneric } from "convex/server";
+const FLUTTERWAVE_API_BASE = "https://api.flutterwave.com/v3";
+// Flutterwave does not sign webhook payloads. Instead, it echoes back the
+// secret hash you configured in the Dashboard, verbatim, in a `verif-hash`
+// header — verification is a direct (constant-time) string comparison, not
+// an HMAC digest of the request body. See:
+// https://developer.flutterwave.com/docs/integration-guides/webhooks
+function timingSafeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let mismatch = 0;
+    for (let i = 0; i < a.length; i++) {
+        mismatch |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    }
+    return mismatch === 0;
+}
+export class Flutterwave {
+    component;
+    options;
+    webhookHandler;
+    constructor(component, options) {
+        this.component = component;
+        this.options = options;
+        const component_ = component;
+        const webhookSecretHash = options.webhookSecretHash;
+        this.webhookHandler = httpActionGeneric(async (ctx, request) => {
+            const rawBody = await request.text();
+            const signature = request.headers.get("verif-hash");
+            if (!signature) {
+                return new Response(JSON.stringify({ error: "Missing signature" }), {
+                    status: 400,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            if (!timingSafeEqual(webhookSecretHash, signature)) {
+                console.error("convex-flutterwave: webhook signature mismatch");
+                return new Response(JSON.stringify({ error: "Invalid signature" }), {
+                    status: 401,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            let event;
+            try {
+                event = JSON.parse(rawBody);
+            }
+            catch {
+                return new Response(JSON.stringify({ error: "Invalid JSON" }), {
+                    status: 400,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            const data = event.data ?? {};
+            const eventId = data.id !== undefined
+                ? `${event.event}:${data.id}`
+                : `${event.event}:${data.tx_ref ?? crypto.randomUUID()}`;
+            const { alreadyProcessed } = await ctx.runMutation(component_.lib.checkAndRecordEvent, {
+                eventId,
+                eventType: event.event,
+                txRef: data.tx_ref ?? undefined,
+                payload: rawBody,
+            });
+            if (alreadyProcessed) {
+                return new Response(JSON.stringify({ success: true, duplicate: true }), {
+                    status: 200,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            switch (event.event) {
+                case "charge.completed": {
+                    const customer = data.customer;
+                    const status = data.status === "successful" ? "successful" : "failed";
+                    await ctx.runMutation(component_.lib.recordTransaction, {
+                        txRef: data.tx_ref,
+                        flwRef: data.flw_ref ?? undefined,
+                        transactionId: data.id !== undefined ? String(data.id) : undefined,
+                        customerEmail: customer?.email ?? "",
+                        amount: data.amount,
+                        currency: data.currency ?? "NGN",
+                        status,
+                        paymentType: data.payment_type ?? undefined,
+                        narration: data.narration ?? undefined,
+                        paidAt: data.created_at ? new Date(data.created_at).getTime() : undefined,
+                        metadata: data.meta ? JSON.stringify(data.meta) : undefined,
+                    });
+                    break;
+                }
+                case "subscription.cancelled": {
+                    const planId = data.plan ?? undefined;
+                    const customer = data.customer;
+                    if (data.id !== undefined) {
+                        await ctx.runMutation(component_.lib.recordSubscriptionEvent, {
+                            subscriptionId: String(data.id),
+                            customerEmail: customer?.email ?? "",
+                            planId,
+                            amount: data.amount ?? undefined,
+                            status: "cancelled",
+                        });
+                    }
+                    break;
+                }
+                default:
+                    break;
+            }
+            return new Response(JSON.stringify({ success: true }), {
+                status: 200,
+                headers: { "Content-Type": "application/json" },
+            });
+        });
+    }
+    async initializeTransaction(ctx, args) {
+        const txRef = args.txRef ?? crypto.randomUUID();
+        const res = await fetch(`${FLUTTERWAVE_API_BASE}/payments`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.options.secretKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                tx_ref: txRef,
+                amount: args.amount,
+                currency: args.currency ?? "NGN",
+                redirect_url: args.redirectUrl,
+                // Flutterwave requires payment_plan as a numeric id, not a string —
+                // this component's own PaymentPlanResult.planId is a string (for
+                // consistency with every other id in this API), so it's converted
+                // here. Sending it as a string doesn't error; Flutterwave just
+                // silently processes the charge as a normal one-time payment
+                // instead of linking it to the plan, so no subscription is created.
+                payment_plan: args.paymentPlan !== undefined ? Number(args.paymentPlan) : undefined,
+                payment_options: args.paymentOptions?.join(", "),
+                customer: {
+                    email: args.email,
+                    name: args.customerName,
+                    phonenumber: args.customerPhoneNumber,
+                },
+                meta: args.metadata,
+            }),
+        });
+        const json = (await res.json());
+        if (json.status !== "success") {
+            throw new Error(json.message ?? "Failed to initialize Flutterwave transaction");
+        }
+        await ctx.runMutation(this.component.lib.recordTransaction, {
+            txRef,
+            customerEmail: args.email,
+            amount: args.amount,
+            currency: args.currency ?? "NGN",
+            status: "pending",
+            metadata: args.metadata ? JSON.stringify(args.metadata) : undefined,
+        });
+        return { paymentLink: json.data.link, txRef };
+    }
+    async verifyTransaction(ctx, args) {
+        const res = await fetch(`${FLUTTERWAVE_API_BASE}/transactions/${encodeURIComponent(args.transactionId)}/verify`, { headers: { Authorization: `Bearer ${this.options.secretKey}` } });
+        const json = (await res.json());
+        if (json.status !== "success") {
+            throw new Error(json.message ?? "Failed to verify Flutterwave transaction");
+        }
+        const data = json.data;
+        const status = data.status === "successful" ? "successful" : "failed";
+        await ctx.runMutation(this.component.lib.recordTransaction, {
+            txRef: data.tx_ref,
+            flwRef: data.flw_ref ?? undefined,
+            transactionId: String(data.id),
+            customerEmail: data.customer?.email ?? "",
+            amount: data.amount,
+            currency: data.currency,
+            status,
+            paymentType: data.payment_type ?? undefined,
+            narration: data.narration ?? undefined,
+            paidAt: data.created_at ? new Date(data.created_at).getTime() : undefined,
+        });
+        // recordTransaction keeps the email the transaction was first created
+        // under rather than whatever Flutterwave just echoed back (see its
+        // comment — test mode rewrites it). Read that back so callers — and
+        // anything they render, like a result screen — see the real address
+        // too, not just what's in the database.
+        const stored = await ctx.runQuery(this.component.lib.getTransaction, { txRef: data.tx_ref });
+        return {
+            status: data.status,
+            txRef: data.tx_ref,
+            flwRef: data.flw_ref ?? undefined,
+            transactionId: String(data.id),
+            amount: data.amount,
+            currency: data.currency,
+            paymentType: data.payment_type ?? undefined,
+            narration: data.narration ?? undefined,
+            paidAt: data.created_at ? new Date(data.created_at).getTime() : undefined,
+            customerEmail: stored?.customerEmail ?? data.customer?.email ?? "",
+        };
+    }
+    async cancelSubscription(ctx, args) {
+        const res = await fetch(`${FLUTTERWAVE_API_BASE}/subscriptions/${encodeURIComponent(args.subscriptionId)}/cancel`, { method: "PUT", headers: { Authorization: `Bearer ${this.options.secretKey}` } });
+        const json = (await res.json());
+        if (json.status !== "success") {
+            throw new Error(json.message ?? "Failed to cancel Flutterwave subscription");
+        }
+        await ctx.runMutation(this.component.lib.recordSubscriptionEvent, {
+            subscriptionId: args.subscriptionId,
+            customerEmail: args.customerEmail,
+            status: "cancelled",
+        });
+    }
+    async enableSubscription(ctx, args) {
+        const res = await fetch(`${FLUTTERWAVE_API_BASE}/subscriptions/${encodeURIComponent(args.subscriptionId)}/activate`, { method: "PUT", headers: { Authorization: `Bearer ${this.options.secretKey}` } });
+        const json = (await res.json());
+        if (json.status !== "success") {
+            throw new Error(json.message ?? "Failed to activate Flutterwave subscription");
+        }
+        await ctx.runMutation(this.component.lib.recordSubscriptionEvent, {
+            subscriptionId: args.subscriptionId,
+            customerEmail: args.customerEmail,
+            status: "active",
+        });
+    }
+    async createPaymentPlan(ctx, args) {
+        const res = await fetch(`${FLUTTERWAVE_API_BASE}/payment-plans`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.options.secretKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                name: args.name,
+                amount: args.amount,
+                interval: args.interval,
+                currency: args.currency ?? "NGN",
+                duration: args.duration,
+            }),
+        });
+        const json = (await res.json());
+        if (json.status !== "success") {
+            throw new Error(json.message ?? "Failed to create Flutterwave payment plan");
+        }
+        return {
+            planId: String(json.data.id),
+            name: json.data.name,
+            amount: json.data.amount,
+            interval: json.data.interval,
+            currency: json.data.currency,
+            duration: json.data.duration,
+            status: json.data.status,
+        };
+    }
+    async listPaymentPlans(_ctx) {
+        const res = await fetch(`${FLUTTERWAVE_API_BASE}/payment-plans`, {
+            headers: { Authorization: `Bearer ${this.options.secretKey}` },
+        });
+        const json = (await res.json());
+        if (json.status !== "success") {
+            throw new Error(json.message ?? "Failed to list Flutterwave payment plans");
+        }
+        return json.data.map((plan) => ({
+            planId: String(plan.id),
+            name: plan.name,
+            amount: plan.amount,
+            interval: plan.interval,
+            currency: plan.currency,
+            duration: plan.duration,
+            status: plan.status,
+        }));
+    }
+    /**
+     * Flutterwave has no "subscription created" webhook — a subscription is
+     * created implicitly the first time a customer pays through a checkout
+     * initialized with `paymentPlan`, and that charge webhook doesn't carry
+     * the subscription's own id (only the plan id). This reads the customer's
+     * subscriptions straight from Flutterwave's Subscriptions API and upserts
+     * them locally — call it after a plan-linked checkout returns, or from a
+     * manual "sync" action, as a reliable way to populate subscription state.
+     */
+    async fetchFlutterwaveSubscriptions(email) {
+        const url = email
+            ? `${FLUTTERWAVE_API_BASE}/subscriptions?email=${encodeURIComponent(email)}`
+            : `${FLUTTERWAVE_API_BASE}/subscriptions`;
+        const res = await fetch(url, { headers: { Authorization: `Bearer ${this.options.secretKey}` } });
+        return await res.json();
+    }
+    async syncCustomerSubscriptions(ctx, args) {
+        const json = await this.fetchFlutterwaveSubscriptions(args.email);
+        if (json.status !== "success") {
+            throw new Error(json.message ?? "Failed to fetch Flutterwave subscriptions");
+        }
+        let subscriptions = json.data ?? [];
+        // Flutterwave's ?email= filter matches against whatever email it has on
+        // file for the subscription — in test mode that's the same "ravesb_
+        // <hash>_" rewritten address seen elsewhere, not the real one, so
+        // filtering by the real email can come back empty even when a matching
+        // subscription exists. Fall back to an unfiltered list and match after
+        // stripping that rewrite, rather than trusting the filter alone.
+        if (subscriptions.length === 0) {
+            const all = await this.fetchFlutterwaveSubscriptions();
+            if (all.status === "success") {
+                subscriptions = (all.data ?? []).filter((sub) => sub.customer?.customer_email?.replace(/^ravesb_[0-9a-f]+_/i, "") === args.email);
+            }
+        }
+        for (const sub of subscriptions) {
+            await ctx.runMutation(this.component.lib.recordSubscriptionEvent, {
+                subscriptionId: String(sub.id),
+                // Use the email the caller queried by, not Flutterwave's own
+                // customer_email field — in test mode Flutterwave rewrites it (e.g.
+                // "ravesb_<hash>_real@email.com"), which would make the record
+                // unfindable by the email a merchant actually knows the customer as.
+                customerEmail: args.email,
+                planId: sub.plan !== undefined ? String(sub.plan) : undefined,
+                amount: sub.amount ?? undefined,
+                status: sub.status === "active" ? "active" : "cancelled",
+            });
+        }
+        return subscriptions.length;
+    }
+    /**
+     * Attributes every subscription on a given plan to one email, regardless
+     * of what Flutterwave itself has on file as that subscription's customer.
+     * This is unsafe to reach for by default — a real plan can have many
+     * subscribers — but it's exactly what's needed when Flutterwave's
+     * test-mode sandbox has substituted its own fixed customer identity for
+     * every subscription (see the README's Subscriptions section), making
+     * email-based sync unable to find anything at all. Reach for it only
+     * where you already know (or, in a single-developer test/demo context,
+     * can safely assume) there's one subscriber to claim — the example app
+     * uses it as a fallback for exactly that reason.
+     */
+    async syncSubscriptionsByPlan(ctx, args) {
+        const json = await this.fetchFlutterwaveSubscriptions();
+        if (json.status !== "success") {
+            throw new Error(json.message ?? "Failed to fetch Flutterwave subscriptions");
+        }
+        const planId = Number(args.planId);
+        const subscriptions = (json.data ?? []).filter((sub) => sub.plan === planId);
+        for (const sub of subscriptions) {
+            await ctx.runMutation(this.component.lib.recordSubscriptionEvent, {
+                subscriptionId: String(sub.id),
+                customerEmail: args.email,
+                planId: String(planId),
+                amount: sub.amount ?? undefined,
+                status: sub.status === "active" ? "active" : "cancelled",
+            });
+        }
+        return subscriptions.length;
+    }
+    async getTransaction(ctx, args) {
+        return await ctx.runQuery(this.component.lib.getTransaction, args);
+    }
+    async listTransactions(ctx, args) {
+        return await ctx.runQuery(this.component.lib.listTransactions, args);
+    }
+    async getSubscription(ctx, args) {
+        return await ctx.runQuery(this.component.lib.getSubscription, args);
+    }
+    async listSubscriptions(ctx, args) {
+        return await ctx.runQuery(this.component.lib.listSubscriptions, args);
+    }
+    async hasActiveSubscription(ctx, args) {
+        return await ctx.runQuery(this.component.lib.hasActiveSubscription, args);
+    }
+    async listRecentEvents(ctx, args) {
+        return await ctx.runQuery(this.component.lib.listRecentEvents, args ?? {});
+    }
+    async getStats(ctx) {
+        return await ctx.runQuery(this.component.lib.getStats, {});
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/component/_generated/api.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import type * as lib from "../lib.js";
+import type { ApiFromModules, FilterApi, FunctionReference } from "convex/server";
+declare const fullApi: ApiFromModules<{
+    lib: typeof lib;
+}>;
+/**
+ * A utility for referencing Convex functions in your app's public API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export declare const api: FilterApi<typeof fullApi, FunctionReference<any, "public">>;
+/**
+ * A utility for referencing Convex functions in your app's internal API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = internal.myModule.myFunction;
+ * ```
+ */
+export declare const internal: FilterApi<typeof fullApi, FunctionReference<any, "internal">>;
+export declare const components: {};
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/component/_generated/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAGvB,QAAA,MAAM,OAAO,EAAE,cAAc,CAAC;IAC5B,GAAG,EAAE,OAAO,GAAG,CAAC;CACjB,CAAiB,CAAC;AAEnB;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,EAAE,SAAS,CACzB,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CACjB,CAAC;AAElB;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAC9B,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CACnB,CAAC;AAElB,eAAO,MAAM,UAAU,EAAqC,EAAE,CAAC"}

package/dist/component/_generated/api.js

@@ -0,0 +1,31 @@
+/* eslint-disable */
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import { anyApi, componentsGeneric } from "convex/server";
+const fullApi = anyApi;
+/**
+ * A utility for referencing Convex functions in your app's public API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export const api = anyApi;
+/**
+ * A utility for referencing Convex functions in your app's internal API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = internal.myModule.myFunction;
+ * ```
+ */
+export const internal = anyApi;
+export const components = componentsGeneric();
+//# sourceMappingURL=api.js.map

package/dist/component/_generated/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AASH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,OAAO,GAER,MAAa,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAGZ,MAAa,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAGjB,MAAa,CAAC;AAElB,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAmB,CAAC"}