@formata/limitr-ui 0.1.0

package/README.md

@@ -0,0 +1,30 @@
+# Limitr UI
+Open-source and vibe-code friendly UI library for [Limitr](https://limitr.dev).
+
+## Example
+To show a customer's current Limitr plan information, usage, Stripe subscription details, recent invoices, billing management options, cancel/resume actions, plan selection table, etc, just import and include the limitr-current-plan component like so.
+
+> See [@formata/limitr](https://github.com/dev-formata-io/limitr) for more information on Limitr pricing policies, and check out [Limitr Cloud](https://cloud.limitr.dev) to implement your pricing in a few minutes.
+
+```typescript
+renderCurrentUserSubscription(customerId: string) {
+    const policy: any = this.policy ?? new Limitr();
+    return html`
+        <div class="section">
+            <div class="section-header">
+                <h2 class="section-title">Subscription</h2>
+            </div>
+            <div class="section-content">
+                <limitr-current-plan
+                    .policy=${policy}
+                    .customerId=${customerId}
+                    ?showStripeInfo=${true}
+                    ?cancelImmediately=${false}
+                    ?requestStripeInvoices=${true}
+                    ?requestStripePortalUrl=${true}
+                ></limitr-current-plan>
+            </div>
+        </div>
+    `;
+}
+```

package/dist/current.d.ts

@@ -0,0 +1,84 @@
+import { LimitrElement } from './element.js';
+import { type CSSResult } from "lit";
+import './table.ts';
+/**
+ * Show a customer's current plan & usage information (if any).
+ *
+ * For Stripe integration via Limitr Cloud, the following metadata fields are expected
+ * in customer.metadata:
+ *
+ * - stripe_subscription_id: string - Stripe subscription ID
+ * - stripe_subscription_status: string - Status (active, canceled, past_due, etc.)
+ * - stripe_current_period_start: number - Unix timestamp (ms)
+ * - stripe_current_period_end: number - Unix timestamp (ms)
+ * - stripe_cancel_at_period_end: boolean - Will cancel at end of period
+ * - stripe_customer_id: string - Stripe customer ID
+ * - stripe_payment_method_type: string - Payment method type (card, etc.)
+ * - stripe_payment_method_last4: string - Last 4 digits of payment method
+ * - stripe_payment_method_brand: string - Card brand (visa, mastercard, etc.)
+ *
+ * Coupon metadata fields (populated by Limitr when coupon is applied):
+ * - stripe_coupon_code: string - The coupon/promo code
+ * - stripe_coupon_status: string - 'pending' | 'applied' | 'invalid' | 'expired'
+ * - stripe_coupon_name: string - Display name for the coupon
+ * - stripe_coupon_percent_off: string - Percentage off (if percent-based)
+ * - stripe_coupon_amount_off: string - Amount off in cents (if amount-based)
+ * - stripe_coupon_currency: string - Currency for amount_off coupons
+ * - stripe_coupon_duration: string - 'once' | 'repeating' | 'forever'
+ * - stripe_coupon_duration_in_months: string - Number of months (if repeating)
+ */
+export declare class LimitrCurrentPlan extends LimitrElement {
+    showStripeInfo: boolean;
+    hideUsage: boolean;
+    hideCancel: boolean;
+    cancelImmediately: boolean;
+    theme: 'light' | 'dark';
+    /** When true, emit plan select events only, without setting customer plan on policy. */
+    denyPolicyChanges: boolean;
+    private currentPlan;
+    private currentCustomer;
+    private loading;
+    private showPricingTable;
+    /**
+     * Styles.
+     */
+    static get styles(): CSSResult;
+    connectedCallback(): void;
+    updated(changedProperties: Map<string | number | symbol, unknown>): Promise<void>;
+    protected _internalHideCancel: boolean;
+    private loadData;
+    private handleChangePlan;
+    private handleClosePricingTable;
+    private handlePlanSelected;
+    private handleCancelPlan;
+    private handleResumeSubscription;
+    /**
+     * Pluralize a unit name if needed based on the value.
+     */
+    private pluralizeUnit;
+    private getCouponDetails;
+    /**
+     * Check if subscription status is active/valid (not terminated or never activated)
+     */
+    private hasActiveSubscription;
+    private formatLimitValue;
+    private formatUsageValue;
+    private getUsagePercentage;
+    private getUsageClass;
+    private formatDate;
+    private renderStripeInfo;
+    private renderUsage;
+    /**
+     * Render invoices section if invoices are available in policy.
+     */
+    private renderInvoices;
+    /**
+     * Format currency value
+     */
+    private formatCurrency;
+    /**
+     * Render.
+     */
+    render(): unknown;
+}
+//# sourceMappingURL=current.d.ts.map

package/dist/current.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current.d.ts","sourceRoot":"","sources":["../current.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAO,KAAK,SAAS,EAAiB,MAAM,KAAK,CAAC;AACzD,OAAO,YAAY,CAAC;AAGpB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,iBAAkB,SAAQ,aAAa;IAEhD,cAAc,EAAE,OAAO,CAAS;IAGhC,SAAS,EAAE,OAAO,CAAS;IAG3B,UAAU,EAAE,OAAO,CAAS;IAG5B,iBAAiB,EAAE,OAAO,CAAS;IAGnC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAW;IAGlC,wFAAwF;IACxF,iBAAiB,EAAE,OAAO,CAAS;IAInC,OAAO,CAAC,WAAW,CAAa;IAIhC,OAAO,CAAC,eAAe,CAAa;IAGpC,OAAO,CAAC,OAAO,CAAiB;IAGhC,OAAO,CAAC,gBAAgB,CAAkB;IAG1C;;OAEG;IACH,WAAoB,MAAM,IAAI,SAAS,CA4dtC;IAGQ,iBAAiB;IAMX,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC;IAwBhF,SAAS,CAAC,mBAAmB,EAAE,OAAO,CAAS;YAEjC,QAAQ;IAsBtB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,uBAAuB;YAKjB,kBAAkB;IAahC,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,wBAAwB;IAuBhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IAEH,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,gBAAgB;IA8CxB,OAAO,CAAC,WAAW;IA6CnB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6CtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACM,MAAM,IAAI,OAAO;CAmG7B"}