@astropay/payments-lib 0.0.9 → 0.0.11

package/dist/main.d.ts

@@ -1,4 +1,5 @@
-import { AstroPayPaymentsLib } from './core/astroPayInit';
-import { AstroPayPaymentComponent } from './components/pages/AstroPayPaymentComponent';
-export default AstroPayPaymentsLib;
-export { AstroPayPaymentComponent };
+import { AstroPayCore } from './public/AstroPayCore';
+import { AstroPayFullCheckout } from './public/AstroPayFullCheckout';
+import { AstroPayPayment } from './public/AstroPayPayment';
+export default AstroPayCore;
+export { AstroPayFullCheckout, AstroPayPayment };

package/dist/public/AstroPayCore/index.d.ts

@@ -0,0 +1,56 @@
+import { Component } from '../../components/templates/Component';
+import { APCore } from '../../types';
+/**
+ * AstroPayCore is the main entry point for the AstroPay Payments Library.
+ * It handles initialization, configuration, and lifecycle management of payment components.
+ *
+ * @example
+ * ```ts
+ * // Basic initialization
+ * AstroPayCore.init('app-id');
+ *
+ * ```
+ *
+ * @see {@link APCore} for configuration options
+ */
+export declare class AstroPayCore {
+    private static isInitialized;
+    private static token;
+    private static components;
+    private constructor();
+    /**
+     * Initializes the AstroPay Payments Library.
+     *
+     * @example
+     * ```ts
+     * AstroPayCore.init('app-id',
+     *  {
+     *    environment: 'production', // or 'sandbox'
+     *    theme: 'light' // or 'dark'
+     *    language: 'en' // or 'es'/'pt'
+     *    currencyMode: 'iso' // or 'symbol'
+     *    styles: {
+     *      primaryColor: '#000000',
+     *    }
+     * });
+     * ```
+     *
+     * @param {string} token - The API token required for authentication.
+     * @param {APCore} [config] - Optional configuration settings.
+     */
+    static init(token: string, config?: APCore): void;
+    static registerComponent(component: Component): void;
+    static unregisterComponent(component: Component): void;
+    static getToken(): string;
+    /**
+     * Destroys the AstroPay Payments Library instance, cleaning up any resources
+     * and resetting the initialization state.
+     *
+     * @example
+     * ```ts
+     * AstroPayCore.destroy();
+     * ```
+     */
+    static destroy(): void;
+    static isLibInitialized(): boolean;
+}

package/dist/public/AstroPayFullCheckout/index.d.ts

@@ -0,0 +1,56 @@
+import { Component } from '../../components/templates/Component';
+import { APFullCheckout } from '../../types';
+/**
+ * AstroPayFullCheckout provides a complete payment checkout experience.
+ *
+ * @example
+ * ```ts
+ * const checkout = new AstroPayFullCheckout({
+ *   amount: 100,
+ *   currency: 'USD',
+ *   country: 'BR',
+ *   // Optional props
+ *   showTitle: true,
+ *   showDescription: true,
+ *   onSuccess: () => console.log('Payment successful'),
+ *   onError: () => console.error('Payment failed')
+ * });
+ * ```
+ *
+ * @see {@link APFullCheckout} for all available configuration options
+ */
+export declare class AstroPayFullCheckout extends Component<HTMLDivElement> {
+    private loadingWrapper;
+    private readonly componentProps;
+    constructor(params: APFullCheckout);
+    private createPayment;
+    private renderPaymentMethods;
+    private showSuccessContent;
+    /**
+     * Renders the full checkout experience into the specified DOM container.
+     *
+     * @example
+     * ```ts
+     * const checkoutComponent = new AstroPayFullCheckout(checkoutPaymentSettings);
+     * checkout.render(document.getElementById('payment-container'));
+     * ```
+     *
+     * @param {HTMLElement} container - The DOM element to render the payment component into.
+     */
+    render(container: HTMLElement): void;
+    /**
+     * Destroys the payment component instance, cleaning up all DOM elements
+     * and unregistering from the AstroPay Payments Library.
+     *
+     * @example
+     * ```ts
+     * // Initialize and render component
+     * const checkoutComponent = new AstroPayFullCheckout(checkoutPaymentSettings);
+     * checkout.render(document.getElementById('payment-container'));
+     *
+     * // Later cleanup
+     * checkoutComponent.destroy();
+     * ```
+     */
+    destroy(): void;
+}

package/dist/public/AstroPayPayment/index.d.ts

@@ -0,0 +1,55 @@
+import { Component } from '../../components/templates/Component';
+import { APPayment } from '../../types';
+/**
+ * AstroPayPayment provides a streamlined payment component focused on AstroPay's
+ * native payment method.
+ *
+ * @example
+ * ```ts
+ * const payment = new AstroPayPayment({
+ *   amount: 100,
+ *   currency: 'USD',
+ *   country: 'BR'
+ *   // Optional props
+ *   onSuccess: () => console.log('Payment successful'),
+ *   onError: () => console.error('Payment failed')
+ * });
+ * ```
+ *
+ * @see {@link APPayment} for all available configuration options
+ */
+export declare class AstroPayPayment extends Component<HTMLDivElement> {
+    private loadingWrapper;
+    private readonly componentProps;
+    constructor(params: APPayment);
+    private createPayment;
+    private renderAstroPayMethod;
+    private showSuccessContent;
+    /**
+     * Renders the payment component into the specified DOM container.
+     *
+     * @example
+     * ```ts
+     * const paymentComponent = new AstroPayPayment(paymentSettings);
+     * paymentComponent.render(document.getElementById('payment-container'));
+     * ```
+     *
+     * @param {HTMLElement} container - The DOM element to render the payment component into.
+     */
+    render(container: HTMLElement): void;
+    /**
+     * Destroys the payment component instance, cleaning up all DOM elements
+     * and unregistering from the AstroPay Payments Library.
+     *
+     * @example
+     * ```ts
+     * // Initialize and render component
+     * const paymentComponent = new AstroPayPayment(paymentSettings);
+     * paymentComponent.render(container);
+     *
+     * // Later cleanup
+     * paymentComponent.destroy();
+     * ```
+     */
+    destroy(): void;
+}

package/dist/types/index.d.ts

@@ -14,19 +14,30 @@ type APComponentStyles = {
     textSecondaryColor: string;
     fontFamily: string;
     width: string | number;
+    paddingWrapper: string | number;
+    borderRadiusWrapper: string | number;
 };
-type APLibConfig = {
+type APCore = {
     environment?: APEnvironment;
     theme?: APAvailableTheme;
     language?: APAvailableLanguages;
     currencyMode?: APAvailableCurrencyMode;
     styles?: Partial<APComponentStyles>;
 };
-type APPaymentComponent = {
+type APFullCheckout = {
     amount: number;
     currency: string;
     country: string;
     showTitle?: boolean;
     showDescription?: boolean;
+    onSuccess?: () => void;
+    onError?: () => void;
 };
-export type { APLibConfig, APPaymentComponent, APEnvironment, APAvailableTheme, APAvailableLanguages, APAvailableCurrencyMode, APComponentStyles, };
+type APPayment = {
+    amount: number;
+    currency: string;
+    country: string;
+    onSuccess?: () => void;
+    onError?: () => void;
+};
+export type { APEnvironment, APAvailableTheme, APAvailableLanguages, APAvailableCurrencyMode, APComponentStyles, APCore, APFullCheckout, APPayment, };

package/package.json

@@ -1,9 +1,10 @@
 {
-  "version": "0.0.9",
+  "version": "0.0.11",
   "type": "module",
   "name": "@astropay/payments-lib",
   "description": "Official AstroPay payments library for web and mobile.",
   "license": "UNLICENSED",
+  "homepage": "https://www.astropay.com/business",
   "author": {
     "name": "AstroPay",
     "email": "support@astropay.com",
@@ -14,7 +15,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/astropay-it/astropay-payments-lib.git"
+    "url": "https://developers.astropay.com/docs/payments-library"
   },
   "contributors": [
     {
@@ -29,11 +30,10 @@
   ],
   "main": "./dist/astropay-payments-lib.es.js",
   "module": "./dist/astropay-payments-lib.es.js",
-  "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
       "import": "./dist/astropay-payments-lib.es.js",
-      "types": "./dist/types/*"
+      "types": "./dist/main.d.ts"
     },
     "./types": {
       "types": "./dist/types/index.d.ts"
@@ -42,7 +42,7 @@
   "typesVersions": {
     "*": {
       "types/*": [
-        "./dist/types/*"
+        "./dist/types/index.d.ts"
       ]
     }
   },