@go-avro/avro-js 0.0.51 → 0.0.53

package/dist/billing/fees.d.ts

@@ -1,43 +1,2 @@
 import { PaymentType } from '../types/api/PaymentType';
-export interface PassOnFeeBreakdown {
-    /** Stripe processing fee on the grossed-up amount, in cents. */
-    stripeFee: number;
-    /** Avro application fee on the grossed-up amount, in cents. */
-    avroFee: number;
-    /** Total fee added on top of the subtotal: stripeFee + avroFee. */
-    totalFee: number;
-    /** Gross amount the customer is charged: subtotal + totalFee. */
-    gross: number;
-}
-/**
- * Compute Stripe's processing fee on a gross amount, in cents.
- * Ceiling matches Stripe's worst-case rounding so the merchant is never short.
- */
-export declare function computeStripeFee(grossCents: number, method: PaymentType): number;
-/**
- * Compute Avro's application fee on a gross amount, in cents.
- *
- * Avro's fee is now computed against the gross (matching Stripe's basis)
- * rather than the post-Stripe net. This keeps the pass-on gross-up
- * exactly solvable in closed form.
- */
-export declare function computeAvroFee(grossCents: number): number;
-/**
- * Compute the pass-on fee (in cents) such that, after Stripe and Avro deduct
- * their fees from the gross amount the customer is charged, the merchant
- * receives at least `subtotalCents`.
- *
- * Returns `ZERO_FEE` when `subtotalCents <= 0`.
- *
- * Closed form: a finite set of candidate grosses is derived from each fee
- * regime (avro at the 5¢ floor vs. percentage; ACH stripe at the $5 cap vs.
- * percentage). The smallest candidate that satisfies the invariant
- * `gross - stripeFee(gross) - avroFee(gross) >= subtotal` is selected.
- */
-export declare function computePassOnFee(subtotalCents: number, method: PaymentType): PassOnFeeBreakdown;
-/**
- * Pick the payment method to use when computing the persisted ("default")
- * fee line item amount on a bill. Card if enabled (worst case for the
- * customer), otherwise ACH, otherwise null (no fee should be persisted).
- */
 export declare function defaultPassOnFeeMethod(enabledPaymentMethods: PaymentType[] | null | undefined): PaymentType | null;

package/dist/billing/fees.js

@@ -1,150 +1,4 @@
 import { PaymentType } from '../types/api/PaymentType';
-/**
- * Pass-on (surcharge) fee calculations.
- *
- * When `pass_on_fees` is enabled on a bill, the customer is charged a gross
- * amount that, after Stripe's processing fees and Avro's application fee, leaves
- * the merchant with at least the bill's subtotal. The fee added on top of the
- * subtotal is exposed as a single read-only line item on the bill.
- *
- * Stripe US standard pricing (online):
- *   - Card:          2.9% of gross + 30¢
- *   - ACH (us_bank): 0.8% of gross, capped at $5.00
- * Avro application fee:
- *   - 0.4% of gross, minimum 5¢
- *
- * All amounts are integer cents. All math is closed-form (no iteration).
- *
- * Because both Stripe and Avro fees are charged against the same base (gross),
- * the gross-up reduces to the standard form `G = (B + fixed) / (1 - rate)`
- * within each regime. The integer-ceiling on each candidate guarantees the
- * merchant nets at least the requested subtotal. In rare regime-boundary cases
- * the merchant may net up to 2¢ more than requested — never less.
- */
-// --- Rate constants (per 1000 for integer math where applicable) ---
-const CARD_PCT_PER_1000 = 29; // 2.9%
-const CARD_FIXED_CENTS = 30; // 30¢
-const ACH_PCT_PER_1000 = 8; // 0.8%
-const ACH_CAP_CENTS = 500; // $5.00
-const AVRO_PCT_PER_1000 = 4; // 0.4%
-const AVRO_MIN_CENTS = 5; // 5¢
-const ZERO_FEE = {
-    stripeFee: 0,
-    avroFee: 0,
-    totalFee: 0,
-    gross: 0,
-};
-/**
- * Compute Stripe's processing fee on a gross amount, in cents.
- * Ceiling matches Stripe's worst-case rounding so the merchant is never short.
- */
-export function computeStripeFee(grossCents, method) {
-    if (grossCents <= 0)
-        return 0;
-    if (method === PaymentType.CARD) {
-        return Math.ceil((CARD_PCT_PER_1000 * grossCents) / 1000) + CARD_FIXED_CENTS;
-    }
-    // us_bank_account: percentage capped at $5.00
-    return Math.min(Math.ceil((ACH_PCT_PER_1000 * grossCents) / 1000), ACH_CAP_CENTS);
-}
-/**
- * Compute Avro's application fee on a gross amount, in cents.
- *
- * Avro's fee is now computed against the gross (matching Stripe's basis)
- * rather than the post-Stripe net. This keeps the pass-on gross-up
- * exactly solvable in closed form.
- */
-export function computeAvroFee(grossCents) {
-    if (grossCents <= 0)
-        return AVRO_MIN_CENTS;
-    return Math.max(Math.ceil((AVRO_PCT_PER_1000 * grossCents) / 1000), AVRO_MIN_CENTS);
-}
-/**
- * Compute the pass-on fee (in cents) such that, after Stripe and Avro deduct
- * their fees from the gross amount the customer is charged, the merchant
- * receives at least `subtotalCents`.
- *
- * Returns `ZERO_FEE` when `subtotalCents <= 0`.
- *
- * Closed form: a finite set of candidate grosses is derived from each fee
- * regime (avro at the 5¢ floor vs. percentage; ACH stripe at the $5 cap vs.
- * percentage). The smallest candidate that satisfies the invariant
- * `gross - stripeFee(gross) - avroFee(gross) >= subtotal` is selected.
- */
-export function computePassOnFee(subtotalCents, method) {
-    if (subtotalCents <= 0)
-        return { ...ZERO_FEE };
-    const B = subtotalCents;
-    const candidates = method === PaymentType.CARD ? cardCandidates(B) : achCandidates(B);
-    let best = Number.POSITIVE_INFINITY;
-    for (const g of candidates) {
-        const stripe = computeStripeFee(g, method);
-        const avro = computeAvroFee(g);
-        if (g - stripe - avro >= B && g < best) {
-            best = g;
-        }
-    }
-    if (!Number.isFinite(best)) {
-        // Should never happen — the candidate set covers every regime — but
-        // fall back to a safe overshoot rather than throwing.
-        best = B + Math.ceil(B * 0.05) + CARD_FIXED_CENTS + AVRO_MIN_CENTS;
-    }
-    const stripeFee = computeStripeFee(best, method);
-    const avroFee = computeAvroFee(best);
-    return {
-        stripeFee,
-        avroFee,
-        totalFee: best - B,
-        gross: best,
-    };
-}
-/**
- * Card regime candidates.
- *
- * stripe = ceil(0.029 * G) + 30; avro = max(ceil(0.004 * G), 5).
- *
- * Both ceil()s can each add up to 1¢ relative to the exact rational form, so
- * each candidate carries a baked-in 2¢ (percentage regime) or 1¢ (floor
- * regime) safety margin to guarantee the invariant holds for every B in
- * integer cents — no post-hoc iteration required.
- *
- * 1) Percentage avro:  G * 0.967 ≥ B + 30 + 2
- *      => G = ceil((1000 * B + 32_000) / 967)
- * 2) Floor avro (5¢):  G * 0.971 ≥ B + 30 + 5 + 1
- *      => G = ceil((1000 * B + 36_000) / 971)
- */
-function cardCandidates(B) {
-    return [Math.ceil((1000 * B + 32000) / 967), Math.ceil((1000 * B + 36000) / 971)];
-}
-/**
- * ACH regime candidates.
- *
- * stripe = min(ceil(0.008 * G), 500); avro = max(ceil(0.004 * G), 5).
- *
- * Same ceiling-safety logic as card. Stripe at the $5 cap is a fixed integer
- * so its ceiling-slack disappears in the capped regimes.
- *
- * 1) No-cap percentage avro: G * 0.988 ≥ B + 2
- *      => G = ceil((1000 * (B + 2)) / 988)
- * 2) No-cap floor avro:      G * 0.992 ≥ B + 5 + 1
- *      => G = ceil((1000 * (B + 6)) / 992)
- * 3) Capped percentage avro: G * 0.996 ≥ B + 500 + 1
- *      => G = ceil((1000 * (B + 501)) / 996)
- * 4) Capped floor avro:      G = B + 505
- */
-function achCandidates(B) {
-    return [
-        Math.ceil((1000 * (B + 2)) / 988),
-        Math.ceil((1000 * (B + 6)) / 992),
-        Math.ceil((1000 * (B + 501)) / 996),
-        B + 505,
-    ];
-}
-/**
- * Pick the payment method to use when computing the persisted ("default")
- * fee line item amount on a bill. Card if enabled (worst case for the
- * customer), otherwise ACH, otherwise null (no fee should be persisted).
- */
 export function defaultPassOnFeeMethod(enabledPaymentMethods) {
     if (!enabledPaymentMethods || enabledPaymentMethods.length === 0)
         return null;

package/dist/index.d.ts

@@ -32,8 +32,7 @@ import './client/hooks/proposal';
 import './client/hooks/timecards';
 import './client/hooks/waivers';
 import './client/hooks/email';
-export { computePassOnFee, computeStripeFee, computeAvroFee, defaultPassOnFeeMethod, } from './billing/fees';
-export type { PassOnFeeBreakdown } from './billing/fees';
+export { defaultPassOnFeeMethod } from './billing/fees';
 export * from './types/api';
 export * from './types/auth';
 export * from './types/cache';

package/dist/index.js

@@ -30,7 +30,7 @@ import './client/hooks/proposal';
 import './client/hooks/timecards';
 import './client/hooks/waivers';
 import './client/hooks/email';
-export { computePassOnFee, computeStripeFee, computeAvroFee, defaultPassOnFeeMethod, } from './billing/fees';
+export { defaultPassOnFeeMethod } from './billing/fees';
 export * from './types/api';
 export * from './types/auth';
 export * from './types/cache';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-avro/avro-js",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "description": "JS client for Avro backend integration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",