@vertebr/admin 0.4.0 → 0.5.0

package/dist/connectors/payments/connector.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paymentsConnector = paymentsConnector;
+const errors_1 = require("../../errors");
+function formatMoney(cents, currency) {
+    try {
+        return new Intl.NumberFormat("en-US", {
+            style: "currency",
+            currency: currency.toUpperCase() || "USD",
+        }).format(cents / 100);
+    }
+    catch {
+        return `${(cents / 100).toFixed(2)} ${currency}`.trim();
+    }
+}
+function sessionsResource(provider, group, sessionLimit, includeRefunds) {
+    const actions = includeRefunds && provider.refund
+        ? {
+            refund: {
+                label: "Refund",
+                input: {
+                    amount: {
+                        type: "number",
+                        label: "Amount (cents, blank = full)",
+                        required: false,
+                    },
+                    reason: {
+                        type: "string",
+                        label: "Reason",
+                        required: false,
+                    },
+                },
+                run: async (row, input, ctx) => {
+                    if (!provider.refund) {
+                        throw new errors_1.VertebrBadRequestError("Refunds are not configured.");
+                    }
+                    const data = (row ?? {});
+                    const session = {
+                        id: String(data.id ?? ""),
+                        status: String(data.status ?? ""),
+                        paymentStatus: String(data.paymentStatus ?? ""),
+                        amountTotal: typeof data.amountTotal === "number"
+                            ? data.amountTotal
+                            : Number(data.amountTotal ?? 0),
+                        currency: String(data.currency ?? "usd"),
+                        amountLabel: typeof data.amountLabel === "string"
+                            ? data.amountLabel
+                            : undefined,
+                        customerEmail: typeof data.customerEmail === "string"
+                            ? data.customerEmail
+                            : undefined,
+                        createdAt: String(data.createdAt ?? ""),
+                        paymentIntentId: typeof data.paymentIntentId === "string"
+                            ? data.paymentIntentId
+                            : undefined,
+                        refundable: data.refundable === true,
+                        metadata: data.metadata && typeof data.metadata === "object"
+                            ? data.metadata
+                            : undefined,
+                        provider: typeof data.provider === "string" ? data.provider : undefined,
+                    };
+                    if (!session.id) {
+                        throw new errors_1.VertebrBadRequestError("Missing session id.");
+                    }
+                    if (session.refundable === false) {
+                        throw new errors_1.VertebrBadRequestError("This session is not refundable.");
+                    }
+                    const amountRaw = input?.amount;
+                    const amount = amountRaw === undefined ||
+                        amountRaw === null ||
+                        String(amountRaw).trim() === ""
+                        ? undefined
+                        : Number(amountRaw);
+                    if (amount !== undefined &&
+                        (!Number.isFinite(amount) || amount <= 0)) {
+                        throw new errors_1.VertebrBadRequestError("Invalid refund amount.");
+                    }
+                    await provider.refund(session, {
+                        amount,
+                        reason: typeof input?.reason === "string"
+                            ? input.reason.trim() || undefined
+                            : undefined,
+                    }, ctx);
+                    return { ok: true };
+                },
+            },
+        }
+        : undefined;
+    return {
+        id: `${provider.id}-sessions`,
+        label: `${provider.label} sessions`,
+        group,
+        schema: {
+            id: { type: "string", readOnly: true, label: "Session" },
+            status: { type: "string", readOnly: true, label: "Status" },
+            paymentStatus: { type: "string", readOnly: true, label: "Payment" },
+            amountLabel: { type: "string", readOnly: true, label: "Amount" },
+            amountTotal: { type: "number", readOnly: true, label: "Amount (cents)" },
+            currency: { type: "string", readOnly: true, label: "Currency" },
+            customerEmail: { type: "string", readOnly: true, label: "Customer" },
+            createdAt: { type: "string", readOnly: true, label: "Created" },
+            paymentIntentId: {
+                type: "string",
+                readOnly: true,
+                label: "Payment intent",
+            },
+            provider: { type: "string", readOnly: true, label: "Provider" },
+        },
+        list: async (ctx) => {
+            const sessions = await provider.listSessions({ limit: sessionLimit }, ctx);
+            return sessions.map((session) => ({
+                ...session,
+                amountLabel: session.amountLabel ??
+                    formatMoney(session.amountTotal, session.currency),
+                provider: session.provider ?? provider.id,
+            }));
+        },
+        get: async (id, ctx) => {
+            if (provider.getSession) {
+                const session = await provider.getSession(id, ctx);
+                if (!session)
+                    return undefined;
+                return {
+                    ...session,
+                    amountLabel: session.amountLabel ??
+                        formatMoney(session.amountTotal, session.currency),
+                    provider: session.provider ?? provider.id,
+                };
+            }
+            const sessions = await provider.listSessions({ limit: sessionLimit }, ctx);
+            const session = sessions.find((item) => item.id === id);
+            if (!session)
+                return undefined;
+            return {
+                ...session,
+                amountLabel: session.amountLabel ??
+                    formatMoney(session.amountTotal, session.currency),
+                provider: session.provider ?? provider.id,
+            };
+        },
+        actions,
+        permissions: { create: false, update: false, delete: false },
+    };
+}
+function discountsResource(provider, group) {
+    return {
+        id: `${provider.id}-discounts`,
+        label: `${provider.label} discounts`,
+        group,
+        schema: {
+            id: { type: "string", readOnly: true },
+            label: { type: "string", readOnly: true, label: "Name" },
+            code: { type: "string", readOnly: true, label: "Code" },
+            offerLabel: { type: "string", readOnly: true, label: "Offer" },
+            expiresLabel: { type: "string", readOnly: true, label: "Expires" },
+            active: { type: "boolean", readOnly: true, label: "Active" },
+        },
+        list: async (ctx) => {
+            if (!provider.listDiscounts)
+                return [];
+            return provider.listDiscounts(ctx);
+        },
+        permissions: { create: false, update: false, delete: false },
+    };
+}
+function webhookHealthResource(provider, group) {
+    return {
+        id: `${provider.id}-webhook`,
+        label: `${provider.label} webhook`,
+        group,
+        schema: {
+            id: { type: "string", readOnly: true },
+            status: { type: "string", readOnly: true, label: "Status" },
+            label: { type: "string", readOnly: true, label: "Health" },
+            lastEventAt: { type: "string", readOnly: true, label: "Last event" },
+            detail: { type: "string", readOnly: true, label: "Detail" },
+        },
+        list: async (ctx) => {
+            if (!provider.webhookHealth) {
+                return [
+                    {
+                        id: "webhook",
+                        status: "unknown",
+                        label: "Not configured",
+                        detail: "Provider did not implement webhookHealth.",
+                    },
+                ];
+            }
+            const health = await provider.webhookHealth(ctx);
+            return [health];
+        },
+        permissions: { create: false, update: false, delete: false },
+    };
+}
+/**
+ * Provider-agnostic payments admin surface.
+ *
+ * @example
+ * const stripe = stripePaymentsProvider({ client: getStripe() });
+ * vertebrAdmin.use(paymentsConnector({
+ *   provider: stripe,
+ *   panels: ["sessions", "discounts", "webhookHealth", "refunds"],
+ * }));
+ * // mail.discounts: (ctx) => toMailDiscountOptions(await stripe.listDiscounts?.(ctx) ?? [])
+ */
+function paymentsConnector(options) {
+    const provider = options.provider;
+    const group = options.group ?? "Payments";
+    const panels = new Set(options.panels ?? ["sessions"]);
+    const sessionLimit = options.sessionLimit ?? 50;
+    return {
+        id: options.id ?? `payments-${provider.id}`,
+        register(admin) {
+            if (panels.has("sessions")) {
+                admin.resource(sessionsResource(provider, group, sessionLimit, panels.has("refunds")));
+            }
+            if (panels.has("discounts") && provider.listDiscounts) {
+                admin.resource(discountsResource(provider, group));
+            }
+            if (panels.has("webhookHealth")) {
+                admin.resource(webhookHealthResource(provider, group));
+            }
+        },
+    };
+}
+//# sourceMappingURL=connector.js.map

package/dist/connectors/payments/connector.js.map

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

package/dist/connectors/payments/index.d.ts

@@ -0,0 +1,4 @@
+export { paymentsConnector, type PaymentsConnectorOptions, type PaymentsPanel, } from "./connector";
+export { stripePaymentsProvider, type StripeCheckoutSessionLike, type StripePaymentsClient, type StripePaymentsProviderOptions, type StripePromotionCodeLike, } from "./stripe";
+export { toMailDiscountOptions, type ListPaymentSessionsOptions, type PaymentDiscount, type PaymentSession, type PaymentWebhookHealth, type PaymentsProvider, type RefundPaymentOptions, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/payments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/payments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,SAAS,CAAC"}

package/dist/connectors/payments/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toMailDiscountOptions = exports.stripePaymentsProvider = exports.paymentsConnector = void 0;
+var connector_1 = require("./connector");
+Object.defineProperty(exports, "paymentsConnector", { enumerable: true, get: function () { return connector_1.paymentsConnector; } });
+var stripe_1 = require("./stripe");
+Object.defineProperty(exports, "stripePaymentsProvider", { enumerable: true, get: function () { return stripe_1.stripePaymentsProvider; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "toMailDiscountOptions", { enumerable: true, get: function () { return types_1.toMailDiscountOptions; } });
+//# sourceMappingURL=index.js.map

package/dist/connectors/payments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connectors/payments/index.ts"],"names":[],"mappings":";;;AAAA,yCAIqB;AAHnB,8GAAA,iBAAiB,OAAA;AAInB,mCAMkB;AALhB,gHAAA,sBAAsB,OAAA;AAMxB,iCAQiB;AAPf,8GAAA,qBAAqB,OAAA"}

package/dist/connectors/payments/stripe.d.ts

@@ -0,0 +1,99 @@
+import type { HandlerContext } from "../../schema";
+import type { PaymentSession, PaymentWebhookHealth, PaymentsProvider } from "./types";
+/** Minimal Stripe surface — no SDK dependency in Vertebr. */
+export type StripePaymentsClient = {
+    checkout: {
+        sessions: {
+            list: (params: {
+                limit?: number;
+                created?: {
+                    gte?: number;
+                };
+                starting_after?: string;
+            }) => Promise<{
+                data: StripeCheckoutSessionLike[];
+                has_more: boolean;
+            }>;
+            retrieve: (id: string) => Promise<StripeCheckoutSessionLike>;
+        };
+    };
+    refunds: {
+        create: (params: {
+            payment_intent: string;
+            amount?: number;
+            reason?: "duplicate" | "fraudulent" | "requested_by_customer";
+        }) => Promise<unknown>;
+    };
+    promotionCodes: {
+        list: (params: {
+            limit?: number;
+            active?: boolean;
+            starting_after?: string;
+            expand?: string[];
+        }) => Promise<{
+            data: StripePromotionCodeLike[];
+            has_more: boolean;
+        }>;
+    };
+};
+export type StripeCheckoutSessionLike = {
+    id: string;
+    status?: string | null;
+    payment_status?: string | null;
+    amount_total?: number | null;
+    currency?: string | null;
+    customer_details?: {
+        email?: string | null;
+    } | null;
+    customer_email?: string | null;
+    created?: number;
+    url?: string | null;
+    payment_intent?: string | {
+        id?: string;
+    } | null;
+    metadata?: Record<string, string> | null;
+};
+export type StripePromotionCodeLike = {
+    id: string;
+    code?: string | null;
+    active?: boolean | null;
+    expires_at?: number | null;
+    coupon?: string | {
+        id?: string;
+        name?: string | null;
+        percent_off?: number | null;
+        amount_off?: number | null;
+        currency?: string | null;
+        valid?: boolean | null;
+    } | null;
+    metadata?: Record<string, string> | null;
+};
+export type StripePaymentsProviderOptions = {
+    client: StripePaymentsClient;
+    id?: string;
+    label?: string;
+    /**
+     * When set, only sessions whose `metadata[key]` matches `ctx.env` are shown.
+     * MaxerMentality uses `appEnv`.
+     */
+    envMetadataKey?: string;
+    /** Max pages of 100 when listing sessions. @default `3` */
+    maxPages?: number;
+    /** Optional host webhook health (secrets, last event, …). */
+    webhookHealth?: (ctx: HandlerContext) => Promise<PaymentWebhookHealth> | PaymentWebhookHealth;
+    /** Extra session filter after env metadata. */
+    filterSession?: (session: PaymentSession, raw: StripeCheckoutSessionLike, ctx: HandlerContext) => boolean;
+};
+/**
+ * Stripe adapter for `paymentsConnector`. Pass your SDK client — Vertebr does
+ * not depend on the `stripe` package.
+ *
+ * @example
+ * import Stripe from "stripe";
+ * const provider = stripePaymentsProvider({
+ *   client: new Stripe(process.env.STRIPE_SECRET_KEY!),
+ *   envMetadataKey: "appEnv",
+ * });
+ */
+export declare function stripePaymentsProvider(options: StripePaymentsProviderOptions): PaymentsProvider;
+//# sourceMappingURL=stripe.d.ts.map

package/dist/connectors/payments/stripe.d.ts.map

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

package/dist/connectors/payments/stripe.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripePaymentsProvider = stripePaymentsProvider;
+function paymentIntentId(value) {
+    if (!value)
+        return undefined;
+    if (typeof value === "string")
+        return value;
+    return value.id || undefined;
+}
+function formatMoney(cents, currency) {
+    try {
+        return new Intl.NumberFormat("en-US", {
+            style: "currency",
+            currency: currency.toUpperCase() || "USD",
+        }).format(cents / 100);
+    }
+    catch {
+        return `${(cents / 100).toFixed(2)} ${currency}`.trim();
+    }
+}
+function mapSession(raw, providerId) {
+    const currency = (raw.currency ?? "usd").toLowerCase();
+    const amountTotal = raw.amount_total ?? 0;
+    const createdAt = raw.created
+        ? new Date(raw.created * 1000).toISOString()
+        : "";
+    const paymentStatus = raw.payment_status ?? "";
+    return {
+        id: raw.id,
+        status: raw.status ?? "",
+        paymentStatus,
+        amountTotal,
+        currency,
+        amountLabel: formatMoney(amountTotal, currency),
+        customerEmail: raw.customer_details?.email ?? raw.customer_email ?? undefined,
+        createdAt,
+        url: raw.url ?? undefined,
+        paymentIntentId: paymentIntentId(raw.payment_intent),
+        refundable: paymentStatus === "paid" && Boolean(paymentIntentId(raw.payment_intent)),
+        metadata: raw.metadata ?? undefined,
+        provider: providerId,
+    };
+}
+function offerLabelFromCoupon(coupon) {
+    if (typeof coupon.percent_off === "number" && coupon.percent_off > 0) {
+        return `${coupon.percent_off}% off`;
+    }
+    if (typeof coupon.amount_off === "number" && coupon.amount_off > 0) {
+        return formatMoney(coupon.amount_off, coupon.currency ?? "usd");
+    }
+    return undefined;
+}
+function mapPromotionCode(raw) {
+    const coupon = raw.coupon && typeof raw.coupon === "object" ? raw.coupon : null;
+    const code = String(raw.code ?? "").trim();
+    if (!code && !raw.id)
+        return null;
+    const offerLabel = coupon ? offerLabelFromCoupon(coupon) : undefined;
+    const name = String(coupon?.name ?? "").trim();
+    const expiresLabel = raw.expires_at
+        ? `Expires ${new Date(raw.expires_at * 1000).toLocaleDateString("en-US", {
+            month: "short",
+            day: "numeric",
+            year: "numeric",
+        })}`
+        : undefined;
+    return {
+        id: raw.id,
+        label: name || code || raw.id,
+        code: code || undefined,
+        offerLabel,
+        expiresLabel,
+        active: raw.active !== false && coupon?.valid !== false,
+        percentOff: coupon?.percent_off ?? undefined,
+        amountOff: coupon?.amount_off ?? undefined,
+        currency: coupon?.currency ?? undefined,
+    };
+}
+/**
+ * Stripe adapter for `paymentsConnector`. Pass your SDK client — Vertebr does
+ * not depend on the `stripe` package.
+ *
+ * @example
+ * import Stripe from "stripe";
+ * const provider = stripePaymentsProvider({
+ *   client: new Stripe(process.env.STRIPE_SECRET_KEY!),
+ *   envMetadataKey: "appEnv",
+ * });
+ */
+function stripePaymentsProvider(options) {
+    const providerId = options.id ?? "stripe";
+    const label = options.label ?? "Stripe";
+    const maxPages = options.maxPages ?? 3;
+    const envKey = options.envMetadataKey;
+    return {
+        id: providerId,
+        label,
+        async listSessions(listOptions, ctx) {
+            const limit = Math.min(Math.max(listOptions.limit ?? 50, 1), 100);
+            const want = listOptions.limit ?? 50;
+            const out = [];
+            let startingAfter;
+            for (let page = 0; page < maxPages && out.length < want; page += 1) {
+                const listed = await options.client.checkout.sessions.list({
+                    limit,
+                    ...(listOptions.createdGte
+                        ? { created: { gte: listOptions.createdGte } }
+                        : {}),
+                    ...(startingAfter ? { starting_after: startingAfter } : {}),
+                });
+                for (const raw of listed.data) {
+                    const session = mapSession(raw, providerId);
+                    if (envKey &&
+                        String(session.metadata?.[envKey] ?? "") !== String(ctx.env)) {
+                        continue;
+                    }
+                    if (options.filterSession &&
+                        !options.filterSession(session, raw, ctx)) {
+                        continue;
+                    }
+                    out.push(session);
+                    if (out.length >= want)
+                        break;
+                }
+                if (!listed.has_more || listed.data.length === 0)
+                    break;
+                startingAfter = listed.data[listed.data.length - 1]?.id;
+            }
+            return out;
+        },
+        async getSession(id, ctx) {
+            const raw = await options.client.checkout.sessions.retrieve(id);
+            const session = mapSession(raw, providerId);
+            if (envKey &&
+                String(session.metadata?.[envKey] ?? "") !== String(ctx.env)) {
+                return undefined;
+            }
+            if (options.filterSession && !options.filterSession(session, raw, ctx)) {
+                return undefined;
+            }
+            return session;
+        },
+        async listDiscounts(_ctx) {
+            const out = [];
+            let startingAfter;
+            for (let page = 0; page < maxPages; page += 1) {
+                const listed = await options.client.promotionCodes.list({
+                    limit: 100,
+                    active: true,
+                    expand: ["data.coupon"],
+                    ...(startingAfter ? { starting_after: startingAfter } : {}),
+                });
+                for (const raw of listed.data) {
+                    const mapped = mapPromotionCode(raw);
+                    if (mapped)
+                        out.push(mapped);
+                }
+                if (!listed.has_more || listed.data.length === 0)
+                    break;
+                startingAfter = listed.data[listed.data.length - 1]?.id;
+            }
+            return out;
+        },
+        async refund(session, refundOptions, _ctx) {
+            const intent = session.paymentIntentId;
+            if (!intent) {
+                throw new Error("Session has no payment intent to refund.");
+            }
+            const reason = refundOptions?.reason;
+            const stripeReason = reason === "duplicate" ||
+                reason === "fraudulent" ||
+                reason === "requested_by_customer"
+                ? reason
+                : "requested_by_customer";
+            await options.client.refunds.create({
+                payment_intent: intent,
+                ...(refundOptions?.amount
+                    ? { amount: Math.round(refundOptions.amount) }
+                    : {}),
+                reason: stripeReason,
+            });
+        },
+        webhookHealth: options.webhookHealth
+            ? async (ctx) => options.webhookHealth(ctx)
+            : undefined,
+    };
+}
+//# sourceMappingURL=stripe.js.map

package/dist/connectors/payments/stripe.js.map

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

package/dist/connectors/payments/types.d.ts

@@ -0,0 +1,67 @@
+import type { HandlerContext } from "../../schema";
+import type { MailDiscountOption } from "../../types";
+/** Normalized checkout / payment session for admin lists. */
+export type PaymentSession = {
+    id: string;
+    status: string;
+    paymentStatus: string;
+    /** Amount in the smallest currency unit (e.g. cents). */
+    amountTotal: number;
+    currency: string;
+    /** Display string, e.g. `$42.00`. */
+    amountLabel?: string;
+    customerEmail?: string;
+    createdAt: string;
+    url?: string;
+    paymentIntentId?: string;
+    refundable?: boolean;
+    metadata?: Record<string, string>;
+    /** Provider id, e.g. `stripe`. */
+    provider?: string;
+};
+/** Coupon / promotion code for admin + discount emails. */
+export type PaymentDiscount = {
+    id: string;
+    label: string;
+    code?: string;
+    /** e.g. `20% off` or `$10 off`. */
+    offerLabel?: string;
+    expiresLabel?: string;
+    active?: boolean;
+    percentOff?: number;
+    /** Amount off in smallest currency unit. */
+    amountOff?: number;
+    currency?: string;
+};
+export type PaymentWebhookHealth = {
+    id: string;
+    status: "ok" | "warn" | "error" | "unknown";
+    label: string;
+    lastEventAt?: string;
+    detail?: string;
+};
+export type ListPaymentSessionsOptions = {
+    /** Unix seconds — providers may ignore. */
+    createdGte?: number;
+    limit?: number;
+};
+export type RefundPaymentOptions = {
+    amount?: number;
+    reason?: string;
+};
+/**
+ * Host / adapter contract. Vertebr owns admin resources; the provider owns
+ * talking to Stripe, Square, Adyen, or a host facade.
+ */
+export type PaymentsProvider = {
+    id: string;
+    label: string;
+    listSessions: (options: ListPaymentSessionsOptions, ctx: HandlerContext) => Promise<PaymentSession[]>;
+    getSession?: (id: string, ctx: HandlerContext) => Promise<PaymentSession | undefined>;
+    listDiscounts?: (ctx: HandlerContext) => Promise<PaymentDiscount[]>;
+    refund?: (session: PaymentSession, options: RefundPaymentOptions | undefined, ctx: HandlerContext) => Promise<void>;
+    webhookHealth?: (ctx: HandlerContext) => Promise<PaymentWebhookHealth>;
+};
+/** Map provider discounts into mail compose options. */
+export declare function toMailDiscountOptions(discounts: PaymentDiscount[]): MailDiscountOption[];
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/payments/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/connectors/payments/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,CACZ,OAAO,EAAE,0BAA0B,EACnC,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,CACX,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,CACP,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,oBAAoB,GAAG,SAAS,EACzC,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACpC,CAAC;AAEF,wDAAwD;AACxD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,eAAe,EAAE,GAC3B,kBAAkB,EAAE,CAUtB"}