@tineon/t9n 0.1.2

package/dist/types.d.ts

@@ -0,0 +1,159 @@
+import { z } from "zod";
+export declare const NATIVE_CURRENCIES: readonly ["BTC", "ETH", "BNB", "MATIC", "AVAX", "SOL", "TRX", "LSK", "FLOW", "RON", "SEI", "FTM", "HBAR"];
+export type NativeCurrency = (typeof NATIVE_CURRENCIES)[number];
+export type SupportedCurrency = NativeCurrency;
+export type T9nButtonTheme = "solid" | "light" | "outline";
+export type T9nButtonOptions = {
+    text?: string;
+    className?: string;
+    theme?: T9nButtonTheme;
+    style?: Record<string, string>;
+};
+export type T9nCheckoutStatus = "created" | "awaiting_payment" | "pending_confirmation" | "expired" | "settled" | "failed" | "closed";
+export type T9nHooks = {
+    onOpen?: () => void;
+    onClose?: () => void;
+    onSessionCreated?: (session: {
+        sessionId: string;
+        expiresAt: string;
+    }) => void;
+    onCurrencySelected?: (payload: {
+        currency: string;
+        network: string;
+        depositAddress: string;
+        expectedAmountCrypto: string;
+    }) => void;
+    onStatusChange?: (status: T9nCheckoutStatus) => void;
+    onSuccess?: (payload: {
+        sessionId: string;
+        status: string;
+    }) => void;
+    onFail?: (payload: {
+        sessionId?: string;
+        error: string;
+    }) => void;
+};
+export declare const T9N_DEFAULT_API_BASE_URL = "https://slimepay.com";
+export declare const checkoutConfigSchema: z.ZodObject<{
+    publicKey: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>;
+    amountNgn: z.ZodNumber;
+    currencies: z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">, string[], string[]>;
+    customer: z.ZodObject<{
+        email: z.ZodPipeline<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, z.ZodString>;
+        name: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        reference: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strip", z.ZodTypeAny, {
+        email: string;
+        name?: string | undefined;
+        reference?: string | undefined;
+    }, {
+        email: string;
+        name?: string | undefined;
+        reference?: string | undefined;
+    }>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    callbackUrl: z.ZodOptional<z.ZodString>;
+    apiBaseUrl: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodString>>;
+    button: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        className: z.ZodOptional<z.ZodString>;
+        theme: z.ZodOptional<z.ZodEnum<["solid", "light", "outline"]>>;
+        style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        text?: string | undefined;
+        className?: string | undefined;
+        theme?: "solid" | "light" | "outline" | undefined;
+        style?: Record<string, string> | undefined;
+    }, {
+        text?: string | undefined;
+        className?: string | undefined;
+        theme?: "solid" | "light" | "outline" | undefined;
+        style?: Record<string, string> | undefined;
+    }>>;
+    hooks: z.ZodOptional<z.ZodObject<{
+        onOpen: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+        onClose: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+        onSessionCreated: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+        onCurrencySelected: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+        onStatusChange: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+        onSuccess: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+        onFail: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        onOpen?: ((...args: unknown[]) => unknown) | undefined;
+        onClose?: ((...args: unknown[]) => unknown) | undefined;
+        onSessionCreated?: ((...args: unknown[]) => unknown) | undefined;
+        onCurrencySelected?: ((...args: unknown[]) => unknown) | undefined;
+        onStatusChange?: ((...args: unknown[]) => unknown) | undefined;
+        onSuccess?: ((...args: unknown[]) => unknown) | undefined;
+        onFail?: ((...args: unknown[]) => unknown) | undefined;
+    }, {
+        onOpen?: ((...args: unknown[]) => unknown) | undefined;
+        onClose?: ((...args: unknown[]) => unknown) | undefined;
+        onSessionCreated?: ((...args: unknown[]) => unknown) | undefined;
+        onCurrencySelected?: ((...args: unknown[]) => unknown) | undefined;
+        onStatusChange?: ((...args: unknown[]) => unknown) | undefined;
+        onSuccess?: ((...args: unknown[]) => unknown) | undefined;
+        onFail?: ((...args: unknown[]) => unknown) | undefined;
+    }>>;
+    requestTimeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pollIntervalMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    publicKey: string;
+    amountNgn: number;
+    currencies: string[];
+    customer: {
+        email: string;
+        name?: string | undefined;
+        reference?: string | undefined;
+    };
+    requestTimeoutMs: number;
+    pollIntervalMs: number;
+    metadata?: Record<string, any> | undefined;
+    callbackUrl?: string | undefined;
+    apiBaseUrl?: string | undefined;
+    button?: {
+        text?: string | undefined;
+        className?: string | undefined;
+        theme?: "solid" | "light" | "outline" | undefined;
+        style?: Record<string, string> | undefined;
+    } | undefined;
+    hooks?: {
+        onOpen?: ((...args: unknown[]) => unknown) | undefined;
+        onClose?: ((...args: unknown[]) => unknown) | undefined;
+        onSessionCreated?: ((...args: unknown[]) => unknown) | undefined;
+        onCurrencySelected?: ((...args: unknown[]) => unknown) | undefined;
+        onStatusChange?: ((...args: unknown[]) => unknown) | undefined;
+        onSuccess?: ((...args: unknown[]) => unknown) | undefined;
+        onFail?: ((...args: unknown[]) => unknown) | undefined;
+    } | undefined;
+}, {
+    publicKey: string;
+    amountNgn: number;
+    currencies: string[];
+    customer: {
+        email: string;
+        name?: string | undefined;
+        reference?: string | undefined;
+    };
+    metadata?: Record<string, any> | undefined;
+    callbackUrl?: string | undefined;
+    apiBaseUrl?: string | undefined;
+    button?: {
+        text?: string | undefined;
+        className?: string | undefined;
+        theme?: "solid" | "light" | "outline" | undefined;
+        style?: Record<string, string> | undefined;
+    } | undefined;
+    hooks?: {
+        onOpen?: ((...args: unknown[]) => unknown) | undefined;
+        onClose?: ((...args: unknown[]) => unknown) | undefined;
+        onSessionCreated?: ((...args: unknown[]) => unknown) | undefined;
+        onCurrencySelected?: ((...args: unknown[]) => unknown) | undefined;
+        onStatusChange?: ((...args: unknown[]) => unknown) | undefined;
+        onSuccess?: ((...args: unknown[]) => unknown) | undefined;
+        onFail?: ((...args: unknown[]) => unknown) | undefined;
+    } | undefined;
+    requestTimeoutMs?: number | undefined;
+    pollIntervalMs?: number | undefined;
+}>;
+export type CheckoutConfig = z.infer<typeof checkoutConfigSchema>;

package/dist/types.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+export const NATIVE_CURRENCIES = [
+    "BTC",
+    "ETH",
+    "BNB",
+    "MATIC",
+    "AVAX",
+    "SOL",
+    "TRX",
+    "LSK",
+    "FLOW",
+    "RON",
+    "SEI",
+    "FTM",
+    "HBAR",
+];
+export const T9N_DEFAULT_API_BASE_URL = "https://slimepay.com";
+const trimmedString = () => z
+    .string()
+    .transform((v) => v.trim())
+    .refine((v) => v.length > 0, { message: "Value is required" });
+export const checkoutConfigSchema = z.object({
+    publicKey: trimmedString().refine((v) => /^pk_(live|test)_[a-zA-Z0-9_]+$/.test(v), {
+        message: "publicKey must follow pk_live_* or pk_test_* format",
+    }),
+    amountNgn: z.number().finite().positive(),
+    currencies: z
+        .array(z.string().transform((v) => v.trim().toUpperCase()))
+        .min(1, { message: "At least one supported native currency is required" })
+        .max(13, { message: "Too many currencies provided" })
+        .superRefine((list, ctx) => {
+        const supported = new Set(NATIVE_CURRENCIES);
+        const seen = new Set();
+        for (const [index, currency] of list.entries()) {
+            if (!supported.has(currency)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `Unsupported currency: ${currency}`,
+                    path: [index],
+                });
+            }
+            if (seen.has(currency)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: "Duplicate currencies are not allowed",
+                    path: [index],
+                });
+            }
+            seen.add(currency);
+        }
+    }),
+    customer: z.object({
+        email: z
+            .string()
+            .transform((v) => v.trim().toLowerCase())
+            .refine((v) => v.length > 0, { message: "customer.email is required" })
+            .pipe(z.string().email("customer.email must be a valid email")),
+        name: z.string().transform((v) => v.trim()).optional(),
+        reference: z.string().transform((v) => v.trim()).optional(),
+    }),
+    metadata: z.record(z.any()).optional(),
+    callbackUrl: z.string().url().optional(),
+    apiBaseUrl: z
+        .string()
+        .transform((v) => v.trim())
+        .pipe(z.string().url("apiBaseUrl must be a valid URL"))
+        .optional(),
+    button: z
+        .object({
+        text: z.string().min(1).optional(),
+        className: z.string().optional(),
+        theme: z.enum(["solid", "light", "outline"]).optional(),
+        style: z.record(z.string()).optional(),
+    })
+        .optional(),
+    hooks: z
+        .object({
+        onOpen: z.function().optional(),
+        onClose: z.function().optional(),
+        onSessionCreated: z.function().optional(),
+        onCurrencySelected: z.function().optional(),
+        onStatusChange: z.function().optional(),
+        onSuccess: z.function().optional(),
+        onFail: z.function().optional(),
+    })
+        .optional(),
+    requestTimeoutMs: z.number().min(3000).max(30000).optional().default(12000),
+    pollIntervalMs: z.number().min(3000).max(15000).optional().default(5000),
+});

package/dist/ui/modal.d.ts

@@ -0,0 +1,45 @@
+export type ModalHandlers = {
+    onSelectCurrency: (currency: string) => Promise<void>;
+    onConfirmPayment: () => Promise<void>;
+    onClose: () => void;
+};
+export declare class CheckoutModal {
+    private currencies;
+    private handlers;
+    private host;
+    private root;
+    private timerEl;
+    private addressEl;
+    private qrEl;
+    private statusEl;
+    private disclaimerEl;
+    private confirmBtn;
+    private copyBtn;
+    private backBtn;
+    private actionsContainer;
+    private selectionSection;
+    private paymentSection;
+    private resultSection;
+    private resultTitle;
+    private resultMessage;
+    private resultIcon;
+    private retryBtn;
+    private resultCloseBtn;
+    private chips;
+    private confirmLabel;
+    private selectedCurrency;
+    constructor(currencies: string[], handlers: ModalHandlers);
+    private mount;
+    private handleCurrencySelect;
+    setConfirmLabel(label: string): void;
+    setTimer(value: string): void;
+    setAddress(address: string): void;
+    setQrPayload(payload: string): void;
+    setStatus(message: string): void;
+    setDisclaimer(message: string): void;
+    setConfirmPending(pending: boolean): void;
+    showResult(status: "success" | "failed", message: string): void;
+    showPaymentView(): void;
+    private resetSelection;
+    close(): void;
+}