@metrifox/angular-sdk 1.0.2 → 2.0.0

package/{lib → dist/lib}/metrifox.module.d.ts

@@ -3,8 +3,8 @@ import { MetrifoxService } from './metrifox.service';
 import { MetrifoxConfig } from './types';
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/common";
-import * as i2 from "./components/customer-portal/customer-portal.component";
-import * as i3 from "./components/pricing-table/pricing-table.component";
+import * as i2 from "../modules/customer-portal/components/customer-portal.component";
+import * as i3 from "../modules/pricing-table/components/pricing-table.component";
 /**
  * Metrifox Angular Module
  *

package/{lib → dist/lib}/metrifox.service.d.ts

@@ -1,6 +1,7 @@
 import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
-import { MetrifoxConfig, Theme, CustomerDetails, Product, ProductPlans, BillingHistory, EntitlementUsage, EntitlementSummary, Wallet, CreditAllocation, Invoice, CustomerPortalTheme, PricingTableTheme, CssVarMap, Localization, LocalizationSettings, WalletSetting, CreateWalletSettings } from './types';
+import { MetrifoxConfig, Theme, CustomerDetails, Product, ProductPlans, BillingHistory, EntitlementUsage, EntitlementSummary, Wallet, CreditAllocation, Invoice, Localization, LocalizationSettings, WalletSetting, CreateWalletSettings, CreditTransaction, SubscriptionSettings } from './types';
+import { setIfDefined as _setIfDefined, customerPortalThemeToCssVars as _customerPortalThemeToCssVars, pricingTableThemeToCssVars as _pricingTableThemeToCssVars, getGradient as _getGradient, getBackgroundImage as _getBackgroundImage } from './utils/theme';
 import * as i0 from "@angular/core";
 /**
  * Error thrown when SDK is not initialized
@@ -108,7 +109,7 @@ export declare class MetrifoxService {
     /**
      * Get credit transactions for an allocation
      */
-    getCreditTransactions(allocationId: string): Observable<any>;
+    getCreditTransactions(allocationId: string): Observable<CreditTransaction[]>;
     /**
      * Read wallet settings for customer
      */
@@ -116,15 +117,15 @@ export declare class MetrifoxService {
     /**
      * Create wallet settings
      */
-    createWalletSettings(payload: CreateWalletSettings): Observable<any>;
+    createWalletSettings(payload: CreateWalletSettings): Observable<unknown>;
     /**
      * Edit wallet settings
      */
-    editWalletSettings(id: string, payload: CreateWalletSettings): Observable<any>;
+    editWalletSettings(id: string, payload: CreateWalletSettings): Observable<unknown>;
     /**
      * Delete wallet settings
      */
-    deleteWalletSettings(id: string): Observable<any>;
+    deleteWalletSettings(id: string): Observable<unknown>;
     /**
      * Cancel subscription (schedule cancellation)
      */
@@ -156,7 +157,17 @@ export declare class MetrifoxService {
      * Get product plans (published plans for a product)
      * Note: Returns Offering[] directly, not ParentOffering[]
      */
-    getProductPlans(productKey?: string, customerKey?: string): Observable<ProductPlans>;
+    getProductPlans(productKey?: string, customerKey?: string, countryCode?: string): Observable<ProductPlans>;
+    /**
+     * Subscription settings for the tenant (e.g. whether customer can self-cancel)
+     */
+    getSubscriptionSettings(): Observable<SubscriptionSettings>;
+    /**
+     * Cancel a scheduled subscription change (upgrade/downgrade/add-on removal / scheduled cancel)
+     */
+    cancelScheduledSubscription(subscriptionId: string): Observable<{
+        message?: string;
+    }>;
     /**
      * Get checkout URL for an offering
      */
@@ -172,14 +183,11 @@ export declare class MetrifoxService {
         billingPeriod?: string;
         localization?: string;
     }): string;
-    /**
-     * Convert CustomerPortal theme to CSS variables
-     */
-    static customerPortalThemeToCssVars(theme: CustomerPortalTheme): CssVarMap;
-    /**
-     * Convert PricingTable theme to CSS variables
-     */
-    static pricingTableThemeToCssVars(theme: PricingTableTheme): CssVarMap;
+    static setIfDefined: typeof _setIfDefined;
+    static customerPortalThemeToCssVars: typeof _customerPortalThemeToCssVars;
+    static pricingTableThemeToCssVars: typeof _pricingTableThemeToCssVars;
+    static getGradient: typeof _getGradient;
+    static getBackgroundImage: typeof _getBackgroundImage;
     static ɵfac: i0.ɵɵFactoryDeclaration<MetrifoxService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MetrifoxService>;
 }

package/{lib → dist/lib}/types/enum.d.ts

@@ -85,7 +85,8 @@ export declare enum ResetIntervals {
     WEEKLY = "weekly",
     DAILY = "daily",
     BILLING_PERIOD = "billing_period",
-    NEVER = "never"
+    NEVER = "never",
+    NONE = "none"
 }
 /**
  * Enforcement types
@@ -109,7 +110,8 @@ export declare enum BillingInterval {
  */
 export declare enum BillingTimingTypes {
     IN_ADVANCE = "in_advance",
-    IN_ARREARS = "in_arrears"
+    IN_ARREARS = "in_arrears",
+    PAY_AS_YOU_GO = "pay_as_you_go"
 }
 /**
  * Aggregation methods
@@ -154,3 +156,11 @@ export declare enum LocalizationSelection {
     STRICT_AUTO_DETECT = "strict_auto_detect",
     SMART_PRE_FILL = "smart_pre_fill"
 }
+/**
+ * Scheduled subscription change type (upgrade/downgrade/add-on removal / cancel-at-period-end)
+ */
+export declare enum ScheduledChangeType {
+    UPGRADE = "upgrade",
+    DOWNGRADE = "downgrade",
+    ADDON_REMOVE = "addon_remove"
+}

package/{lib → dist/lib}/types/interface.d.ts

@@ -1,5 +1,5 @@
 import { Type } from '@angular/core';
-import { FeatureType, FeatureStatus, SubscriptionStatus, InvoiceStatusType, PriceTypes, ResetIntervals, EnforcementType, AggregationMethods, BillingTimingTypes, FeatureModel, OneOffType, PoolType } from './enum';
+import { FeatureType, FeatureStatus, SubscriptionStatus, InvoiceStatusType, PriceTypes, ResetIntervals, EnforcementType, AggregationMethods, BillingTimingTypes, FeatureModel, OneOffType, PoolType, ScheduledChangeType } from './enum';
 /**
  * Main theme configuration
  */
@@ -8,134 +8,403 @@ export interface Theme {
     customerPortal?: CustomerPortalTheme;
 }
 /**
- * Customer Portal theme configuration
+ * Customer Portal theme configuration.
+ * Matches the React SDK's CustomerPortalTheme structure exactly.
  */
 export interface CustomerPortalTheme {
+    general?: {
+        linkColor?: string;
+        fontFamily?: string;
+        borderRadius?: string;
+        backgroundColor?: string;
+        containerPadding?: string;
+    };
     tabs?: {
+        tabBackground?: string;
+        tabBorderColor?: string;
+        activeTabBackground?: string;
+        activeTabTextColor?: string;
+        inactiveTabTextColor?: string;
+    };
+    /** Themed select (e.g. country localization in plan section) */
+    select?: {
         background?: string;
         borderColor?: string;
-        activeBackground?: string;
-        activeTextColor?: string;
-        inactiveTextColor?: string;
+        textColor?: string;
+        caretColor?: string;
+        dropdownBackground?: string;
+        dropdownBorderColor?: string;
+        optionTextColor?: string;
+        optionHoverBackground?: string;
     };
-    section?: {
+    sections?: {
         background?: string;
-        titleTextColor?: string;
-        contentBackground?: string;
+        padding?: string;
+        borderColor?: string;
+        borderRadius?: string;
+        content?: {
+            background?: string;
+            padding?: string;
+            borderColor?: string;
+            borderRadius?: string;
+        };
+        summaryBalance?: {
+            background?: string;
+            padding?: string;
+            borderColor?: string;
+            borderRadius?: string;
+            label?: {
+                fontSize?: string;
+                fontWeight?: string;
+                color?: string;
+            };
+            value?: {
+                fontSize?: string;
+                fontWeight?: string;
+                color?: string;
+            };
+            unit?: {
+                fontSize?: string;
+                fontWeight?: string;
+                color?: string;
+            };
+        };
+        header?: {
+            fontSize?: string;
+            fontWeight?: string;
+            color?: string;
+        };
+        label?: {
+            fontSize?: string;
+            fontWeight?: string;
+            color?: string;
+        };
+        value?: {
+            fontSize?: string;
+            fontWeight?: string;
+            color?: string;
+        };
         iconBackground?: string;
         iconColor?: string;
         emptyTextColor?: string;
+        usage?: {
+            barColor?: string;
+            trackColor?: string;
+        };
     };
-    card?: {
-        titleBackground?: string;
-        contentBackground?: string;
-        titleColor?: string;
-        details?: {
-            labelColor?: string;
-            valueColor?: string;
+    buttons?: {
+        primary?: {
+            backgroundColor?: string;
+            border?: {
+                color?: string;
+                width?: string;
+                radius?: string;
+            };
+            typography?: {
+                fontSize?: string;
+                fontWeight?: string;
+                color?: string;
+            };
+        };
+        secondary?: {
+            backgroundColor?: string;
+            border?: {
+                color?: string;
+                width?: string;
+                radius?: string;
+            };
+            typography?: {
+                fontSize?: string;
+                fontWeight?: string;
+                color?: string;
+            };
         };
     };
-    subscription?: {
-        items?: {
+    lineItems?: {
+        parentRow?: {
             background?: string;
             borderColor?: string;
-            textColor?: string;
+            borderRadius?: string;
+            typography?: {
+                label?: {
+                    fontSize?: string;
+                    fontWeight?: string;
+                    color?: string;
+                };
+                quantity?: {
+                    fontSize?: string;
+                    color?: string;
+                };
+            };
+            spacing?: {
+                paddingTop?: string;
+                paddingRight?: string;
+                paddingBottom?: string;
+                paddingLeft?: string;
+            };
+            expandIconColor?: string;
+            expandIconSize?: string;
+        };
+        childRow?: {
+            background?: string;
+            borderColor?: string;
+            borderRadius?: string;
+            typography?: {
+                label?: {
+                    fontSize?: string;
+                    fontWeight?: string;
+                    color?: string;
+                };
+                quantity?: {
+                    fontSize?: string;
+                    color?: string;
+                };
+            };
+            spacing?: {
+                paddingTop?: string;
+                paddingRight?: string;
+                paddingBottom?: string;
+                paddingLeft?: string;
+            };
         };
     };
-    table?: {
+    tables?: {
+        headerBackground?: string;
         headerTextColor?: string;
-        textColor?: string;
+        rowBackgroundOdd?: string;
+        rowBackgroundEven?: string;
+        rowTextColor?: string;
+        borderColor?: string;
+        cellPadding?: string;
+        expandIconColor?: string;
+        typography?: {
+            fontSize?: string;
+            fontWeight?: string;
+            headerFontSize?: string;
+            headerFontWeight?: string;
+        };
+        pagination?: {
+            background?: string;
+            activeBackground?: string;
+            textColor?: string;
+            activeTextColor?: string;
+            borderColor?: string;
+            borderRadius?: string;
+        };
     };
-    button?: {
+    modals?: {
+        overlayColor?: string;
         background?: string;
-        textColor?: string;
+        borderColor?: string;
+        borderRadius?: string;
+        closeButtonColor?: string;
+        header?: {
+            fontSize?: string;
+            fontWeight?: string;
+            color?: string;
+        };
+        title?: {
+            fontSize?: string;
+            fontWeight?: string;
+            color?: string;
+        };
+        description?: {
+            fontSize?: string;
+            fontWeight?: string;
+            color?: string;
+        };
+        footer?: {
+            primary?: {
+                backgroundColor?: string;
+                textColor?: string;
+                borderColor?: string;
+                borderWidth?: string;
+                borderRadius?: string;
+            };
+            secondary?: {
+                backgroundColor?: string;
+                textColor?: string;
+                borderColor?: string;
+                borderWidth?: string;
+                borderRadius?: string;
+            };
+        };
+    };
+    /** Info banners (e.g. scheduled change / undo cancellation) */
+    banners?: {
+        info?: {
+            background?: string;
+            textColor?: string;
+            borderRadius?: string;
+            buttonBorderColor?: string;
+            buttonTextColor?: string;
+        };
+    };
+    plans?: {
+        currentPlanCard?: {
+            header?: {
+                background?: string;
+                textColor?: string;
+            };
+            gradientColor?: string;
+            borderRadius?: string;
+        };
+        planCards?: {
+            background?: string;
+            border?: {
+                color?: string;
+                width?: string;
+                radius?: string;
+            };
+            header?: {
+                background?: string;
+                textColor?: string;
+            };
+            description?: {
+                textColor?: string;
+                textButtonColor?: string;
+            };
+            price?: {
+                amountColor?: string;
+                primaryTextColor?: string;
+                secondaryTextColor?: string;
+                background?: string;
+                borderColor?: string;
+            };
+        };
+        planFeatures?: {
+            textColor?: string;
+            iconColor?: string;
+        };
+        planButton?: {
+            background?: string;
+            textColor?: string;
+            secondaryBackground?: string;
+            secondaryTextColor?: string;
+            textButtonColor?: string;
+        };
+        planToggle?: {
+            background?: string;
+            activeBackground?: string;
+            activeText?: string;
+            inactiveText?: string;
+        };
+        planTags?: {
+            freeTrialBackground?: string;
+            freeTrialText?: string;
+        };
     };
-    filter?: {
-        border?: string;
-        activeBackground?: string;
-        inactiveBackground?: string;
-        activeTextColor?: string;
-        inactiveTextColor?: string;
-        countBackground?: string;
-        countTextColor?: string;
+    popover?: {
+        trigger?: {
+            background?: string;
+            iconColor?: string;
+            borderColor?: string;
+            borderRadius?: string;
+        };
+        menu?: {
+            background?: string;
+            borderColor?: string;
+            borderRadius?: string;
+            /** @deprecated use itemPadding */
+            padding?: string;
+            itemPadding?: string;
+            itemHoverBackground?: string;
+            itemDividerColor?: string;
+            typography?: {
+                fontSize?: string;
+                fontWeight?: string;
+                color?: string;
+                dangerColor?: string;
+            };
+        };
     };
-    linkColor?: string;
-    plan?: PricingTableTheme;
 }
 /**
- * Pricing Table theme configuration
+ * Pricing Table theme configuration.
+ * Matches the React SDK's PricingTableTheme structure exactly.
  */
 export interface PricingTableTheme {
-    card?: CardTheme;
-    button?: ButtonTheme;
-    featureList?: FeatureListTheme;
-    tabs?: TabsTheme;
-    intervalToggle?: IntervalToggleTheme;
-    currentSubscriptionCard?: CurrentSubscriptionCardTheme;
-    freeTrialTag?: FreeTrialTheme;
-    checkoutBar?: CheckoutBarTheme;
-}
-export interface CardTheme {
-    background?: string;
-    borderColor?: string;
-    descriptionColor?: string;
-    header?: CardHeaderTheme;
-    description?: CardDescriptionTheme;
-    price?: CardPriceTheme;
-}
-export interface CardHeaderTheme {
-    background?: string;
-    textColor?: string;
-}
-export interface CardDescriptionTheme {
-    textColor?: string;
-    textButtonColor?: string;
-}
-export interface CardPriceTheme {
-    amountColor?: string;
-    primaryTextColor?: string;
-    secondaryTextColor?: string;
-    textButtonColor?: string;
-    background?: string;
-    borderColor?: string;
-}
-export interface ButtonTheme {
-    background?: string;
-    textColor?: string;
-    secondaryBackground?: string;
-    secondaryTextColor?: string;
-    textButtonColor?: string;
-}
-export interface FeatureListTheme {
-    textColor?: string;
-    iconColor?: string;
-}
-export interface TabsTheme {
-    inactiveText?: string;
-    activeText?: string;
-    indicator?: string;
-    borderColor?: string;
-}
-export interface IntervalToggleTheme {
-    background?: string;
-    activeBackground?: string;
-    activeText?: string;
-    inactiveText?: string;
-}
-export interface CurrentSubscriptionCardTheme {
-    header?: CardHeaderTheme;
-    gradientColor?: string;
-}
-export interface FreeTrialTheme {
-    background?: string;
-    textColor?: string;
-}
-export interface CheckoutBarTheme {
-    background?: string;
-    borderColor?: string;
-    textColor?: string;
-    buttonBackground?: string;
-    buttonTextColor?: string;
+    general?: {
+        fontFamily?: string;
+    };
+    plans?: {
+        currentPlanCard?: {
+            header?: {
+                background?: string;
+                textColor?: string;
+            };
+            gradientColor?: string;
+            borderRadius?: string;
+        };
+        planCards?: {
+            background?: string;
+            border?: {
+                color?: string;
+                width?: string;
+                radius?: string;
+            };
+            header?: {
+                background?: string;
+                textColor?: string;
+            };
+            description?: {
+                textColor?: string;
+                textButtonColor?: string;
+            };
+            price?: {
+                amountColor?: string;
+                primaryTextColor?: string;
+                secondaryTextColor?: string;
+                background?: string;
+                borderColor?: string;
+            };
+        };
+        planFeatures?: {
+            textColor?: string;
+            iconColor?: string;
+        };
+        planButton?: {
+            background?: string;
+            textColor?: string;
+            secondaryBackground?: string;
+            secondaryTextColor?: string;
+            textButtonColor?: string;
+        };
+        planToggle?: {
+            background?: string;
+            activeBackground?: string;
+            activeText?: string;
+            inactiveText?: string;
+        };
+        planTags?: {
+            freeTrialBackground?: string;
+            freeTrialText?: string;
+        };
+    };
+    tabs?: {
+        inactiveText?: string;
+        activeText?: string;
+        indicator?: string;
+        borderColor?: string;
+    };
+    select?: {
+        background?: string;
+        borderColor?: string;
+        textColor?: string;
+        placeholderColor?: string;
+        caretColor?: string;
+        dropdownBackground?: string;
+        dropdownBorderColor?: string;
+        optionTextColor?: string;
+        optionHoverBackground?: string;
+    };
+    checkoutBar?: {
+        background?: string;
+        borderColor?: string;
+        textColor?: string;
+        buttonBackground?: string;
+        buttonTextColor?: string;
+    };
 }
 /**
  * Metrifox SDK initialization configuration
@@ -231,8 +500,19 @@ export interface SubscriptionDetails {
     subscription_items: SubscriptionItem[];
     upcoming_invoice: UpcomingInvoice | null;
     can_update_quantities: boolean;
+    scheduled_change?: ScheduledChangeType | string | null;
+}
+/** Tenant subscription settings from `/sdk/subscription-settings` */
+export interface SubscriptionSettings {
+    id: string;
+    upgrade_strategy: string;
+    downgrade_strategy: string;
+    apply_qty_downgrade_credit: boolean;
+    collection_mode: string;
+    customer_can_cancel: boolean;
 }
 export interface SubscriptionItem {
+    id?: string;
     price_option_id: string;
     name: string;
     currency_code: string;
@@ -242,7 +522,9 @@ export interface SubscriptionItem {
     billing_period_start: string | null;
     billing_period_end: string | null;
     line_source_type: string;
+    source_type?: string;
     is_addon?: boolean;
+    offering_key?: string;
 }
 export interface UpcomingInvoice {
     invoice_id: string;
@@ -412,6 +694,8 @@ export interface CreditTransaction {
     type: string;
     created_at: string;
     description?: string;
+    event_name?: string;
+    quantity?: number;
 }
 export interface WalletSetting {
     id: string;
@@ -480,6 +764,8 @@ export interface Offering {
     base_entitlements_plan_name: string;
     version_id: string;
     is_invoiceable: boolean;
+    product_key?: string;
+    product_currency_code?: string;
 }
 export interface ParentOffering {
     archived_versions: Offering[];
@@ -584,6 +870,7 @@ export interface CreditSystem {
     topup_enabled: boolean;
     reset_interval: string;
     included_usage: number;
+    included_allowance: number;
     carryover_enabled: boolean;
     carryover_action: string;
     expiry_value: number | null;