@fantastic.dev/better-stripe 0.60.1 → 0.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +3 -1
- package/dist/client/usage/index.d.ts +2 -0
- package/dist/client/usage/index.d.ts.map +1 -1
- package/dist/react/index.d.ts +12 -0
- package/dist/react/index.d.ts.map +1 -1
- package/dist/react/index.js +7 -0
- package/dist/react/index.js.map +1 -1
- package/dist/react/workflows/Pagination.d.ts +1 -0
- package/dist/react/workflows/Pagination.d.ts.map +1 -1
- package/dist/react/workflows/Pagination.js +1 -0
- package/dist/react/workflows/Pagination.js.map +1 -1
- package/dist/react/workflows/Usage.fixtures.d.ts +17 -0
- package/dist/react/workflows/Usage.fixtures.d.ts.map +1 -0
- package/dist/react/workflows/Usage.fixtures.js +79 -0
- package/dist/react/workflows/Usage.fixtures.js.map +1 -0
- package/dist/react/workflows/Usage.types.d.ts +25 -0
- package/dist/react/workflows/Usage.types.d.ts.map +1 -0
- package/dist/react/workflows/Usage.types.js +11 -0
- package/dist/react/workflows/Usage.types.js.map +1 -0
- package/dist/react/workflows/UsageAllowance.d.ts +14 -0
- package/dist/react/workflows/UsageAllowance.d.ts.map +1 -0
- package/dist/react/workflows/UsageAllowance.js +21 -0
- package/dist/react/workflows/UsageAllowance.js.map +1 -0
- package/dist/react/workflows/UsageBilling.d.ts +20 -0
- package/dist/react/workflows/UsageBilling.d.ts.map +1 -0
- package/dist/react/workflows/UsageBilling.js +40 -0
- package/dist/react/workflows/UsageBilling.js.map +1 -0
- package/dist/react/workflows/UsageCredits.d.ts +14 -0
- package/dist/react/workflows/UsageCredits.d.ts.map +1 -0
- package/dist/react/workflows/UsageCredits.js +25 -0
- package/dist/react/workflows/UsageCredits.js.map +1 -0
- package/dist/react/workflows/UsageHistory.d.ts +40 -0
- package/dist/react/workflows/UsageHistory.d.ts.map +1 -0
- package/dist/react/workflows/UsageHistory.js +74 -0
- package/dist/react/workflows/UsageHistory.js.map +1 -0
- package/dist/react/workflows/UsageSummary.d.ts +19 -0
- package/dist/react/workflows/UsageSummary.d.ts.map +1 -0
- package/dist/react/workflows/UsageSummary.js +54 -0
- package/dist/react/workflows/UsageSummary.js.map +1 -0
- package/dist/react/workflows/usage-format.d.ts +11 -0
- package/dist/react/workflows/usage-format.d.ts.map +1 -0
- package/dist/react/workflows/usage-format.js +43 -0
- package/dist/react/workflows/usage-format.js.map +1 -0
- package/dist/react/workflows/usage-scope.d.ts +5 -0
- package/dist/react/workflows/usage-scope.d.ts.map +1 -0
- package/dist/react/workflows/usage-scope.js +26 -0
- package/dist/react/workflows/usage-scope.js.map +1 -0
- package/docs/README.md +2 -0
- package/docs/react-api.md +4 -0
- package/docs/usage-react.md +182 -0
- package/package.json +2 -1
- package/src/client/usage/index.ts +3 -0
- package/src/react/index.ts +20 -0
- package/src/react/workflows/Pagination.tsx +2 -0
- package/src/react/workflows/Usage.fixtures.ts +88 -0
- package/src/react/workflows/Usage.test.tsx +373 -0
- package/src/react/workflows/Usage.types.ts +39 -0
- package/src/react/workflows/UsageAllowance.tsx +114 -0
- package/src/react/workflows/UsageBilling.tsx +90 -0
- package/src/react/workflows/UsageCredits.tsx +112 -0
- package/src/react/workflows/UsageHistory.test.tsx +206 -0
- package/src/react/workflows/UsageHistory.tsx +154 -0
- package/src/react/workflows/UsageSummary.tsx +204 -0
- package/src/react/workflows/usage-format.ts +48 -0
- package/src/react/workflows/usage-scope.ts +42 -0
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { getChargeCurrencyMetadata } from "../../client/charge-currency.js";
|
|
2
|
+
/** Native metered rates/estimates use minor currency decimals. Preserve fractional cents and large quantities. */
|
|
3
|
+
export function formatUsageEstimate(
|
|
4
|
+
amountDecimal: string,
|
|
5
|
+
currency: string,
|
|
6
|
+
): string | null {
|
|
7
|
+
const metadata = getChargeCurrencyMetadata(currency);
|
|
8
|
+
if (!metadata || !/^\d+(?:\.\d+)?$/.test(amountDecimal)) return null;
|
|
9
|
+
const [whole, fraction = ""] = amountDecimal.split(".");
|
|
10
|
+
const digits = (whole + fraction).replace(/^0+(?=\d)/, "");
|
|
11
|
+
const scale = metadata.apiDecimals + fraction.length;
|
|
12
|
+
const padded = digits.padStart(scale + 1, "0");
|
|
13
|
+
const major = scale ? padded.slice(0, -scale) : padded;
|
|
14
|
+
let minor = scale ? padded.slice(-scale).replace(/0+$/, "") : "";
|
|
15
|
+
if (metadata.displayDecimals === 0 && minor) return null;
|
|
16
|
+
minor = minor.padEnd(metadata.displayDecimals, "0");
|
|
17
|
+
return `${major}${minor ? "." + minor : ""} ${metadata.currency.toUpperCase()}`;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** Normalize only the visual progress position; keep all visible quantities exact. */
|
|
21
|
+
export function allowanceProgress(value: {
|
|
22
|
+
consumedQuantity: string;
|
|
23
|
+
reservedQuantity: string;
|
|
24
|
+
includedQuantity: string;
|
|
25
|
+
}): number | null {
|
|
26
|
+
const quantities = [
|
|
27
|
+
value.consumedQuantity,
|
|
28
|
+
value.reservedQuantity,
|
|
29
|
+
value.includedQuantity,
|
|
30
|
+
];
|
|
31
|
+
if (quantities.some((quantity) => !/^\d{1,18}(?:\.\d{1,6})?$/.test(quantity)))
|
|
32
|
+
return null;
|
|
33
|
+
const [consumed, reserved, included] = quantities.map((quantity) => {
|
|
34
|
+
const [whole, fraction = ""] = quantity.split(".");
|
|
35
|
+
return BigInt(whole + fraction.padEnd(6, "0"));
|
|
36
|
+
});
|
|
37
|
+
if (included === 0n) return null;
|
|
38
|
+
const ratio = ((consumed + reserved) * 10000n) / included;
|
|
39
|
+
return Number(ratio > 10000n ? 10000n : ratio);
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** Numeric usage periods can exceed Date's supported display range. */
|
|
43
|
+
export function formatUsageTime(seconds: number): string {
|
|
44
|
+
const value = new Date(seconds * 1000);
|
|
45
|
+
return Number.isFinite(value.getTime())
|
|
46
|
+
? value.toISOString()
|
|
47
|
+
: "Time unavailable";
|
|
48
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import type { UsageBillingSnapshot, UsageViewScope } from "./Usage.types.js";
|
|
2
|
+
import type { UsageLocalSummary } from "../../client/usage/summary.js";
|
|
3
|
+
export function usageSummaryMatches(
|
|
4
|
+
scope: UsageViewScope,
|
|
5
|
+
value: UsageLocalSummary,
|
|
6
|
+
) {
|
|
7
|
+
return (
|
|
8
|
+
value.period.start === scope.period.start &&
|
|
9
|
+
value.period.end === scope.period.end &&
|
|
10
|
+
value.groups.every(
|
|
11
|
+
(group) =>
|
|
12
|
+
group.binding.plan.rate.currency.toLowerCase() ===
|
|
13
|
+
scope.currency.toLowerCase() &&
|
|
14
|
+
(group.estimate.status !== "available" ||
|
|
15
|
+
group.estimate.value.currency.toLowerCase() ===
|
|
16
|
+
scope.currency.toLowerCase()),
|
|
17
|
+
)
|
|
18
|
+
);
|
|
19
|
+
}
|
|
20
|
+
export function usageSnapshotMatches(
|
|
21
|
+
scope: UsageViewScope,
|
|
22
|
+
value: UsageBillingSnapshot,
|
|
23
|
+
) {
|
|
24
|
+
const periodMatches = (period: { start: number; end: number }) =>
|
|
25
|
+
period.start === scope.period.start && period.end === scope.period.end;
|
|
26
|
+
const currencyMatches = (currency: string) =>
|
|
27
|
+
currency.toLowerCase() === scope.currency.toLowerCase();
|
|
28
|
+
return (
|
|
29
|
+
(value.summary.status !== "available" ||
|
|
30
|
+
usageSummaryMatches(scope, value.summary.value)) &&
|
|
31
|
+
(value.provider?.status !== "available" ||
|
|
32
|
+
periodMatches(value.provider.value.period)) &&
|
|
33
|
+
(value.allowance?.status !== "available" ||
|
|
34
|
+
!value.allowance.value ||
|
|
35
|
+
(periodMatches(value.allowance.value.period) &&
|
|
36
|
+
currencyMatches(value.allowance.value.committedEstimate.currency) &&
|
|
37
|
+
currencyMatches(value.allowance.value.projectedEstimate.currency))) &&
|
|
38
|
+
(value.credits?.status !== "available" ||
|
|
39
|
+
currencyMatches(value.credits.value.currency)) &&
|
|
40
|
+
(!value.purchase || currencyMatches(value.purchase.currency))
|
|
41
|
+
);
|
|
42
|
+
}
|