@fantastic.dev/better-stripe 0.56.0 → 0.58.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 +18 -0
- package/README.md +5 -1
- package/dist/client/billing/setup-intent-read.d.ts +12 -1
- package/dist/client/billing/setup-intent-read.d.ts.map +1 -1
- package/dist/client/billing/setup-intent-read.js +13 -8
- package/dist/client/billing/setup-intent-read.js.map +1 -1
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +366 -2
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts +183 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +366 -2
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts +183 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
- package/dist/client/index.d.ts +2 -12
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +3 -20
- package/dist/client/index.js.map +1 -1
- package/dist/client/types/triggers.d.ts +3 -1
- package/dist/client/types/triggers.d.ts.map +1 -1
- package/dist/client/usage/allowanceClient.d.ts +51 -0
- package/dist/client/usage/allowanceClient.d.ts.map +1 -0
- package/dist/client/usage/allowanceClient.js +64 -0
- package/dist/client/usage/allowanceClient.js.map +1 -0
- package/dist/client/usage/allowanceTerms.d.ts +64 -0
- package/dist/client/usage/allowanceTerms.d.ts.map +1 -0
- package/dist/client/usage/allowanceTerms.js +101 -0
- package/dist/client/usage/allowanceTerms.js.map +1 -0
- package/dist/client/usage/client.d.ts +2 -2
- package/dist/client/usage/client.d.ts.map +1 -1
- package/dist/client/usage/client.js +4 -4
- package/dist/client/usage/client.js.map +1 -1
- package/dist/client/usage/creditCapacity.d.ts +5 -0
- package/dist/client/usage/creditCapacity.d.ts.map +1 -0
- package/dist/client/usage/creditCapacity.js +47 -0
- package/dist/client/usage/creditCapacity.js.map +1 -0
- package/dist/client/usage/creditClient.d.ts +104 -0
- package/dist/client/usage/creditClient.d.ts.map +1 -0
- package/dist/client/usage/creditClient.js +111 -0
- package/dist/client/usage/creditClient.js.map +1 -0
- package/dist/client/usage/creditDelivery.d.ts +6 -0
- package/dist/client/usage/creditDelivery.d.ts.map +1 -0
- package/dist/client/usage/creditDelivery.js +71 -0
- package/dist/client/usage/creditDelivery.js.map +1 -0
- package/dist/client/usage/creditInvoice.d.ts +6 -0
- package/dist/client/usage/creditInvoice.d.ts.map +1 -0
- package/dist/client/usage/creditInvoice.js +63 -0
- package/dist/client/usage/creditInvoice.js.map +1 -0
- package/dist/client/usage/creditLifecycle.d.ts +14 -0
- package/dist/client/usage/creditLifecycle.d.ts.map +1 -0
- package/dist/client/usage/creditLifecycle.js +90 -0
- package/dist/client/usage/creditLifecycle.js.map +1 -0
- package/dist/client/usage/creditNative.d.ts +20 -0
- package/dist/client/usage/creditNative.d.ts.map +1 -0
- package/dist/client/usage/creditNative.js +100 -0
- package/dist/client/usage/creditNative.js.map +1 -0
- package/dist/client/usage/creditObservation.d.ts +23 -0
- package/dist/client/usage/creditObservation.d.ts.map +1 -0
- package/dist/client/usage/creditObservation.js +54 -0
- package/dist/client/usage/creditObservation.js.map +1 -0
- package/dist/client/usage/creditProofs.d.ts +50 -0
- package/dist/client/usage/creditProofs.d.ts.map +1 -0
- package/dist/client/usage/creditProofs.js +58 -0
- package/dist/client/usage/creditProofs.js.map +1 -0
- package/dist/client/usage/creditProvider.d.ts +11 -0
- package/dist/client/usage/creditProvider.d.ts.map +1 -0
- package/dist/client/usage/creditProvider.js +195 -0
- package/dist/client/usage/creditProvider.js.map +1 -0
- package/dist/client/usage/creditRead.d.ts +47 -0
- package/dist/client/usage/creditRead.d.ts.map +1 -0
- package/dist/client/usage/creditRead.js +18 -0
- package/dist/client/usage/creditRead.js.map +1 -0
- package/dist/client/usage/creditReconciliation.d.ts +20 -0
- package/dist/client/usage/creditReconciliation.d.ts.map +1 -0
- package/dist/client/usage/creditReconciliation.js +157 -0
- package/dist/client/usage/creditReconciliation.js.map +1 -0
- package/dist/client/usage/creditTerms.d.ts +89 -0
- package/dist/client/usage/creditTerms.d.ts.map +1 -0
- package/dist/client/usage/creditTerms.js +76 -0
- package/dist/client/usage/creditTerms.js.map +1 -0
- package/dist/client/usage/creditTransport.fixtures.d.ts +101 -0
- package/dist/client/usage/creditTransport.fixtures.d.ts.map +1 -0
- package/dist/client/usage/creditTransport.fixtures.js +271 -0
- package/dist/client/usage/creditTransport.fixtures.js.map +1 -0
- package/dist/client/usage/deliveryProvider.d.ts.map +1 -1
- package/dist/client/usage/deliveryProvider.js +2 -0
- package/dist/client/usage/deliveryProvider.js.map +1 -1
- package/dist/client/usage/index.d.ts +4 -0
- package/dist/client/usage/index.d.ts.map +1 -1
- package/dist/client/usage/index.js +1 -0
- package/dist/client/usage/index.js.map +1 -1
- package/dist/client/usage/records.d.ts +2 -0
- package/dist/client/usage/records.d.ts.map +1 -1
- package/dist/client/usage/records.js +22 -0
- package/dist/client/usage/records.js.map +1 -1
- package/dist/client/usage/subscriptionTransport.fixtures.d.ts +1 -1
- package/dist/client/usage/subscriptionTransport.fixtures.d.ts.map +1 -1
- package/dist/client/usage/subscriptionTransport.fixtures.js +4 -1
- package/dist/client/usage/subscriptionTransport.fixtures.js.map +1 -1
- package/dist/client/usage/summary.js +2 -2
- package/dist/client/usage/summary.js.map +1 -1
- package/dist/client/usageExports.d.ts +16 -0
- package/dist/client/usageExports.d.ts.map +1 -0
- package/dist/client/usageExports.js +3 -0
- package/dist/client/usageExports.js.map +1 -0
- package/dist/client/webhooks/subscriptionDeleted.d.ts +5 -0
- package/dist/client/webhooks/subscriptionDeleted.d.ts.map +1 -0
- package/dist/client/webhooks/subscriptionDeleted.js +34 -0
- package/dist/client/webhooks/subscriptionDeleted.js.map +1 -0
- package/dist/component/_generated/api.d.ts +18 -0
- package/dist/component/_generated/api.d.ts.map +1 -1
- package/dist/component/_generated/api.js.map +1 -1
- package/dist/component/_generated/component.d.ts +360 -0
- package/dist/component/_generated/component.d.ts.map +1 -1
- package/dist/component/accountClosure/mutations.d.ts.map +1 -1
- package/dist/component/accountClosure/mutations.js +10 -0
- package/dist/component/accountClosure/mutations.js.map +1 -1
- package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
- package/dist/component/balanceFunding/mutations.d.ts +16 -16
- package/dist/component/balanceFunding/preparationHandlers.d.ts +8 -8
- package/dist/component/balanceFunding/queries.d.ts +1 -1
- package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
- package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
- package/dist/component/earnings/triggers.d.ts +352 -18
- package/dist/component/earnings/triggers.d.ts.map +1 -1
- package/dist/component/payoutRelease/queries.d.ts +2 -2
- package/dist/component/payoutRelease/queries.d.ts.map +1 -1
- package/dist/component/schema.d.ts +183 -1
- package/dist/component/schema.js +8 -0
- package/dist/component/schema.js.map +1 -1
- package/dist/component/usage/mutations.d.ts.map +1 -1
- package/dist/component/usage/mutations.js +7 -0
- package/dist/component/usage/mutations.js.map +1 -1
- package/dist/component/usage/schema.d.ts +15 -1
- package/dist/component/usage/schema.d.ts.map +1 -1
- package/dist/component/usage/schema.js +12 -0
- package/dist/component/usage/schema.js.map +1 -1
- package/dist/component/usageAllowance/helpers.d.ts +78 -0
- package/dist/component/usageAllowance/helpers.d.ts.map +1 -0
- package/dist/component/usageAllowance/helpers.js +99 -0
- package/dist/component/usageAllowance/helpers.js.map +1 -0
- package/dist/component/usageAllowance/mutations.d.ts +37 -0
- package/dist/component/usageAllowance/mutations.d.ts.map +1 -0
- package/dist/component/usageAllowance/mutations.js +99 -0
- package/dist/component/usageAllowance/mutations.js.map +1 -0
- package/dist/component/usageAllowance/queries.d.ts +36 -0
- package/dist/component/usageAllowance/queries.d.ts.map +1 -0
- package/dist/component/usageAllowance/queries.js +113 -0
- package/dist/component/usageAllowance/queries.js.map +1 -0
- package/dist/component/usageAllowance/reservations.d.ts +25 -0
- package/dist/component/usageAllowance/reservations.d.ts.map +1 -0
- package/dist/component/usageAllowance/reservations.js +150 -0
- package/dist/component/usageAllowance/reservations.js.map +1 -0
- package/dist/component/usageAllowance/schema.d.ts +77 -0
- package/dist/component/usageAllowance/schema.d.ts.map +1 -0
- package/dist/component/usageAllowance/schema.js +32 -0
- package/dist/component/usageAllowance/schema.js.map +1 -0
- package/dist/component/usageCredits/helpers.d.ts +205 -0
- package/dist/component/usageCredits/helpers.d.ts.map +1 -0
- package/dist/component/usageCredits/helpers.js +129 -0
- package/dist/component/usageCredits/helpers.js.map +1 -0
- package/dist/component/usageCredits/mutations.d.ts +80 -0
- package/dist/component/usageCredits/mutations.d.ts.map +1 -0
- package/dist/component/usageCredits/mutations.js +344 -0
- package/dist/component/usageCredits/mutations.js.map +1 -0
- package/dist/component/usageCredits/purchase.d.ts +23 -0
- package/dist/component/usageCredits/purchase.d.ts.map +1 -0
- package/dist/component/usageCredits/purchase.js +166 -0
- package/dist/component/usageCredits/purchase.js.map +1 -0
- package/dist/component/usageCredits/queries.d.ts +184 -0
- package/dist/component/usageCredits/queries.d.ts.map +1 -0
- package/dist/component/usageCredits/queries.js +243 -0
- package/dist/component/usageCredits/queries.js.map +1 -0
- package/dist/component/usageCredits/reservations.d.ts +16 -0
- package/dist/component/usageCredits/reservations.d.ts.map +1 -0
- package/dist/component/usageCredits/reservations.js +161 -0
- package/dist/component/usageCredits/reservations.js.map +1 -0
- package/dist/component/usageCredits/schema.d.ts +282 -0
- package/dist/component/usageCredits/schema.d.ts.map +1 -0
- package/dist/component/usageCredits/schema.js +92 -0
- package/dist/component/usageCredits/schema.js.map +1 -0
- package/docs/README.md +4 -0
- package/docs/setup-intent-recovery.md +7 -0
- package/docs/usage-credits.md +255 -0
- package/docs/usage-ledger.md +7 -0
- package/docs/usage-limits.md +217 -0
- package/docs/webhooks.md +15 -1
- package/package.json +3 -1
- package/src/client/billing/setup-intent-read.test.ts +40 -0
- package/src/client/billing/setup-intent-read.ts +23 -9
- package/src/client/index.ts +9 -67
- package/src/client/types/triggers.ts +2 -0
- package/src/client/usage/allowanceClient.test.ts +93 -0
- package/src/client/usage/allowanceClient.ts +134 -0
- package/src/client/usage/allowanceTerms.test.ts +131 -0
- package/src/client/usage/allowanceTerms.ts +172 -0
- package/src/client/usage/client.ts +4 -4
- package/src/client/usage/creditCapacity.test.ts +83 -0
- package/src/client/usage/creditCapacity.ts +76 -0
- package/src/client/usage/creditClient.test.ts +221 -0
- package/src/client/usage/creditClient.ts +246 -0
- package/src/client/usage/creditDelivery.ts +105 -0
- package/src/client/usage/creditInvoice.test.ts +149 -0
- package/src/client/usage/creditInvoice.ts +87 -0
- package/src/client/usage/creditLifecycle.ts +175 -0
- package/src/client/usage/creditNative.ts +148 -0
- package/src/client/usage/creditObservation.test.ts +150 -0
- package/src/client/usage/creditObservation.ts +82 -0
- package/src/client/usage/creditProofs.ts +61 -0
- package/src/client/usage/creditProvider.test.ts +202 -0
- package/src/client/usage/creditProvider.ts +304 -0
- package/src/client/usage/creditRead.ts +32 -0
- package/src/client/usage/creditReconciliation.ts +213 -0
- package/src/client/usage/creditTerms.test.ts +48 -0
- package/src/client/usage/creditTerms.ts +140 -0
- package/src/client/usage/creditTransport.fixtures.ts +282 -0
- package/src/client/usage/deliveryProvider.ts +2 -0
- package/src/client/usage/index.ts +16 -0
- package/src/client/usage/record-composition.test.ts +195 -0
- package/src/client/usage/records.ts +26 -0
- package/src/client/usage/subscriptionTransport.fixtures.ts +6 -0
- package/src/client/usage/summary.test.ts +1 -1
- package/src/client/usage/summary.ts +2 -2
- package/src/client/usageExports.ts +56 -0
- package/src/client/webhook-handlers.test.ts +0 -34
- package/src/client/webhooks/subscription-deleted-dispatch.test.ts +61 -0
- package/src/client/webhooks/subscription-deleted.integration.test.ts +313 -0
- package/src/client/webhooks/subscriptionDeleted.ts +56 -0
- package/src/component/_generated/api.ts +18 -0
- package/src/component/_generated/component.ts +486 -0
- package/src/component/accountClosure/mutations.ts +14 -0
- package/src/component/schema.ts +16 -0
- package/src/component/usage/allowance.test.ts +435 -0
- package/src/component/usage/ledger.test.ts +8 -15
- package/src/component/usage/mutations.ts +22 -0
- package/src/component/usage/schema.ts +14 -0
- package/src/component/usageAllowance/helpers.ts +137 -0
- package/src/component/usageAllowance/mutations.ts +139 -0
- package/src/component/usageAllowance/queries.ts +133 -0
- package/src/component/usageAllowance/reservations.ts +220 -0
- package/src/component/usageAllowance/schema.ts +36 -0
- package/src/component/usageCredits/accounting.test.ts +389 -0
- package/src/component/usageCredits/helpers.ts +160 -0
- package/src/component/usageCredits/mutations.ts +451 -0
- package/src/component/usageCredits/purchase.ts +219 -0
- package/src/component/usageCredits/queries.ts +300 -0
- package/src/component/usageCredits/reservations.ts +214 -0
- package/src/component/usageCredits/schema.ts +106 -0
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import type { RunCtx } from "../helpers.js";
|
|
2
|
+
import { UsageCreditClient } from "./creditClient.js";
|
|
3
|
+
import { type UsageScope } from "./records.js";
|
|
4
|
+
import { type UsageAllowanceBinding, type UsageAllowanceStatus, type UsageAllowanceReconciliation, type UsageLimitPolicy } from "./allowanceTerms.js";
|
|
5
|
+
import type { UsageSubscriptionBinding } from "./boundaries.js";
|
|
6
|
+
import type { Id } from "../../component/_generated/dataModel.js";
|
|
7
|
+
export type UsageAllowanceReservation = {
|
|
8
|
+
state: "denied";
|
|
9
|
+
reason: "not_entitled" | "hard_limit";
|
|
10
|
+
revision: number;
|
|
11
|
+
} | {
|
|
12
|
+
state: "reserved" | "committed" | "released";
|
|
13
|
+
reservationId: Id<"usageReservations">;
|
|
14
|
+
revision: number;
|
|
15
|
+
};
|
|
16
|
+
/** Trusted host authorizes policy management and the exact billable activity. */
|
|
17
|
+
export declare class UsageAllowanceClient extends UsageCreditClient {
|
|
18
|
+
configureAllowance(ctx: RunCtx, input: UsageAllowanceBinding & {
|
|
19
|
+
policy: UsageLimitPolicy;
|
|
20
|
+
expectedRevision: number;
|
|
21
|
+
}): Promise<{
|
|
22
|
+
revision: number;
|
|
23
|
+
}>;
|
|
24
|
+
getAllowanceStatus(ctx: RunCtx, input: UsageAllowanceBinding): Promise<UsageAllowanceStatus | null>;
|
|
25
|
+
reconcileAllowance(ctx: RunCtx, input: UsageAllowanceBinding): Promise<UsageAllowanceReconciliation>;
|
|
26
|
+
reserveAllowance(ctx: RunCtx, input: {
|
|
27
|
+
event: unknown;
|
|
28
|
+
subscription: UsageSubscriptionBinding;
|
|
29
|
+
}): Promise<UsageAllowanceReservation>;
|
|
30
|
+
releaseAllowance(ctx: RunCtx, input: {
|
|
31
|
+
scope: UsageScope;
|
|
32
|
+
reservationId: Id<"usageReservations">;
|
|
33
|
+
reason: "work_failed" | "abandoned_before_work";
|
|
34
|
+
}): Promise<any>;
|
|
35
|
+
readAllowanceHistory(ctx: RunCtx, input: UsageAllowanceBinding & {
|
|
36
|
+
limit: number;
|
|
37
|
+
cursor: string | null;
|
|
38
|
+
}): Promise<{
|
|
39
|
+
records: {
|
|
40
|
+
_creationTime: number;
|
|
41
|
+
_id: import("convex/values").GenericId<"usageAllowanceHistory">;
|
|
42
|
+
at: number;
|
|
43
|
+
evidenceJson: string;
|
|
44
|
+
key: string;
|
|
45
|
+
kind: "commit" | "policy" | "release" | "reservation";
|
|
46
|
+
}[];
|
|
47
|
+
cursor: string | null;
|
|
48
|
+
isDone: boolean;
|
|
49
|
+
}>;
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=allowanceClient.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"allowanceClient.d.ts","sourceRoot":"","sources":["../../../src/client/usage/allowanceClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yCAAyC,CAAC;AACvE,MAAM,MAAM,yBAAyB,GACjC;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5E;IACE,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AASN,iFAAiF;AACjF,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,kBAAkB,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAAG;QAC7B,MAAM,EAAE,gBAAgB,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GACA,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAe/B;IACK,kBAAkB,CACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAQtC;IACD,kBAAkB,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,4BAA4B,CAAC,CAKvC;IACD,gBAAgB,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,wBAAwB,CAAA;KAAE,GAChE,OAAO,CAAC,yBAAyB,CAAC,CAgBpC;IACD,gBAAgB,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QACL,KAAK,EAAE,UAAU,CAAC;QAClB,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,EAAE,aAAa,GAAG,uBAAuB,CAAC;KACjD,gBAOF;IACK,oBAAoB,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;OAoBxE;CACF"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { runMutationOrThrow } from "../helpers.js";
|
|
3
|
+
import { componentRef } from "../webhooks/helpers.js";
|
|
4
|
+
import { UsageCreditClient } from "./creditClient.js";
|
|
5
|
+
import { prepareUsageRecord, scopeSchema } from "./records.js";
|
|
6
|
+
import { allowanceBinding, limitPolicy, } from "./allowanceTerms.js";
|
|
7
|
+
const bindingJson = (input) => JSON.stringify(allowanceBinding({
|
|
8
|
+
scope: input.scope,
|
|
9
|
+
binding: input.binding,
|
|
10
|
+
subscription: input.subscription,
|
|
11
|
+
}));
|
|
12
|
+
/** Trusted host authorizes policy management and the exact billable activity. */
|
|
13
|
+
export class UsageAllowanceClient extends UsageCreditClient {
|
|
14
|
+
configureAllowance(ctx, input) {
|
|
15
|
+
const binding = allowanceBinding({
|
|
16
|
+
scope: input.scope,
|
|
17
|
+
binding: input.binding,
|
|
18
|
+
subscription: input.subscription,
|
|
19
|
+
});
|
|
20
|
+
return runMutationOrThrow(ctx, componentRef(this.component, "usageAllowance/mutations/configure"), {
|
|
21
|
+
bindingJson: JSON.stringify(binding),
|
|
22
|
+
policyJson: JSON.stringify(limitPolicy(input.policy, binding)),
|
|
23
|
+
expectedRevision: input.expectedRevision,
|
|
24
|
+
});
|
|
25
|
+
}
|
|
26
|
+
async getAllowanceStatus(ctx, input) {
|
|
27
|
+
const result = (await ctx.runQuery(componentRef(this.component, "usageAllowance/queries/status"), { bindingJson: bindingJson(input) }));
|
|
28
|
+
return result === null
|
|
29
|
+
? null
|
|
30
|
+
: JSON.parse(result);
|
|
31
|
+
}
|
|
32
|
+
reconcileAllowance(ctx, input) {
|
|
33
|
+
return ctx.runQuery(componentRef(this.component, "usageAllowance/queries/reconciliation"), { bindingJson: bindingJson(input) });
|
|
34
|
+
}
|
|
35
|
+
reserveAllowance(ctx, input) {
|
|
36
|
+
const event = prepareUsageRecord(input.event);
|
|
37
|
+
return runMutationOrThrow(ctx, componentRef(this.component, "usageAllowance/mutations/reserve"), {
|
|
38
|
+
inputJson: JSON.stringify({
|
|
39
|
+
scope: event.scope,
|
|
40
|
+
binding: event.binding,
|
|
41
|
+
sourceEventId: event.sourceEventId,
|
|
42
|
+
occurredAt: event.occurredAt,
|
|
43
|
+
quantity: event.quantity,
|
|
44
|
+
}),
|
|
45
|
+
subscriptionJson: JSON.stringify(input.subscription),
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
releaseAllowance(ctx, input) {
|
|
49
|
+
return runMutationOrThrow(ctx, componentRef(this.component, "usageAllowance/mutations/release"), { ...input, scope: scopeSchema.parse(input.scope) });
|
|
50
|
+
}
|
|
51
|
+
async readAllowanceHistory(ctx, input) {
|
|
52
|
+
const limit = z.number().int().min(1).max(100).parse(input.limit), cursor = z.string().min(1).max(2048).nullable().parse(input.cursor);
|
|
53
|
+
const result = (await ctx.runQuery(componentRef(this.component, "usageAllowance/queries/readHistory"), {
|
|
54
|
+
bindingJson: bindingJson(input),
|
|
55
|
+
paginationOpts: { numItems: limit, cursor },
|
|
56
|
+
}));
|
|
57
|
+
return {
|
|
58
|
+
records: result.page,
|
|
59
|
+
cursor: result.isDone ? null : result.continueCursor,
|
|
60
|
+
isDone: result.isDone,
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=allowanceClient.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"allowanceClient.js","sourceRoot":"","sources":["../../../src/client/usage/allowanceClient.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { type PreparedUsageRecord } from "./records.js";
|
|
3
|
+
import type { UsageSubscriptionBinding } from "./boundaries.js";
|
|
4
|
+
export type UsageAllowanceBinding = Pick<PreparedUsageRecord, "scope" | "binding"> & {
|
|
5
|
+
subscription: UsageSubscriptionBinding;
|
|
6
|
+
};
|
|
7
|
+
export declare const usageLimitPolicySchema: z.ZodObject<{
|
|
8
|
+
reset: z.ZodLiteral<"billing_period">;
|
|
9
|
+
rollover: z.ZodLiteral<"none">;
|
|
10
|
+
entitled: z.ZodBoolean;
|
|
11
|
+
overage: z.ZodEnum<{
|
|
12
|
+
allow: "allow";
|
|
13
|
+
reject: "reject";
|
|
14
|
+
}>;
|
|
15
|
+
limit: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
16
|
+
mode: z.ZodLiteral<"none">;
|
|
17
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
18
|
+
mode: z.ZodEnum<{
|
|
19
|
+
hard: "hard";
|
|
20
|
+
soft: "soft";
|
|
21
|
+
}>;
|
|
22
|
+
quantity: z.ZodString;
|
|
23
|
+
}, z.core.$strict>], "mode">;
|
|
24
|
+
}, z.core.$strict>;
|
|
25
|
+
export type UsageLimitPolicy = z.infer<typeof usageLimitPolicySchema>;
|
|
26
|
+
export type UsageAllowanceStatus = {
|
|
27
|
+
revision: number;
|
|
28
|
+
observedAt: number;
|
|
29
|
+
period: UsageSubscriptionBinding["period"];
|
|
30
|
+
accepting: boolean;
|
|
31
|
+
policy: UsageLimitPolicy;
|
|
32
|
+
consumedQuantity: string;
|
|
33
|
+
reservedQuantity: string;
|
|
34
|
+
includedQuantity: string;
|
|
35
|
+
remainingIncludedQuantity: string;
|
|
36
|
+
billableOverageQuantity: string;
|
|
37
|
+
softLimitReached: boolean;
|
|
38
|
+
hardLimitRemainingQuantity: string | null;
|
|
39
|
+
committedEstimate: {
|
|
40
|
+
amountDecimal: string;
|
|
41
|
+
currency: string;
|
|
42
|
+
};
|
|
43
|
+
projectedEstimate: {
|
|
44
|
+
amountDecimal: string;
|
|
45
|
+
currency: string;
|
|
46
|
+
};
|
|
47
|
+
cashCollection: "none";
|
|
48
|
+
};
|
|
49
|
+
export declare function allowanceBinding(input: unknown): UsageAllowanceBinding;
|
|
50
|
+
export declare function limitPolicy(input: unknown, binding: UsageAllowanceBinding): UsageLimitPolicy;
|
|
51
|
+
export declare function allowanceStatus(binding: UsageAllowanceBinding, policy: UsageLimitPolicy, row: {
|
|
52
|
+
consumed: string;
|
|
53
|
+
reserved: string;
|
|
54
|
+
revision: number;
|
|
55
|
+
}, observedAt: number): UsageAllowanceStatus;
|
|
56
|
+
export type UsageAllowanceReconciliation = {
|
|
57
|
+
status: "matched" | "held";
|
|
58
|
+
reason: string;
|
|
59
|
+
consumedScaledQuantity: string;
|
|
60
|
+
reservedScaledQuantity: string;
|
|
61
|
+
acceptedScaledQuantity: string;
|
|
62
|
+
repaired: false;
|
|
63
|
+
};
|
|
64
|
+
//# sourceMappingURL=allowanceTerms.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"allowanceTerms.d.ts","sourceRoot":"","sources":["../../../src/client/usage/allowanceTerms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,mBAAmB,EACnB,OAAO,GAAG,SAAS,CACpB,GAAG;IACF,YAAY,EAAE,wBAAwB,CAAC;CACxC,CAAC;AASF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;kBASjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,iBAAiB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,iBAAiB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CA2BtE;AACD,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,qBAAqB,GAC7B,gBAAgB,CAgBlB;AACD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC7D,UAAU,EAAE,MAAM,GACjB,oBAAoB,CA8DtB;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,KAAK,CAAC;CACjB,CAAC"}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { prepareUsageRecord } from "./records.js";
|
|
3
|
+
import { parseUsageQuantity } from "./contracts.js";
|
|
4
|
+
import { decimalFromScaled } from "./summary.js";
|
|
5
|
+
const seconds = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
|
|
6
|
+
const subscriptionSchema = z.strictObject({
|
|
7
|
+
subscriptionId: z.string().regex(/^sub_[a-zA-Z0-9]+$/),
|
|
8
|
+
subscriptionItemId: z.string().regex(/^si_[a-zA-Z0-9]+$/),
|
|
9
|
+
stripePriceId: z.string().regex(/^price_[a-zA-Z0-9]+$/),
|
|
10
|
+
period: z.strictObject({ start: seconds, end: seconds }),
|
|
11
|
+
interval: z.literal("month"),
|
|
12
|
+
});
|
|
13
|
+
export const usageLimitPolicySchema = z.strictObject({
|
|
14
|
+
reset: z.literal("billing_period"),
|
|
15
|
+
rollover: z.literal("none"),
|
|
16
|
+
entitled: z.boolean(),
|
|
17
|
+
overage: z.enum(["allow", "reject"]),
|
|
18
|
+
limit: z.discriminatedUnion("mode", [
|
|
19
|
+
z.strictObject({ mode: z.literal("none") }),
|
|
20
|
+
z.strictObject({ mode: z.enum(["soft", "hard"]), quantity: z.string() }),
|
|
21
|
+
]),
|
|
22
|
+
});
|
|
23
|
+
export function allowanceBinding(input) {
|
|
24
|
+
const raw = z
|
|
25
|
+
.strictObject({
|
|
26
|
+
scope: z.unknown(),
|
|
27
|
+
binding: z.unknown(),
|
|
28
|
+
subscription: subscriptionSchema,
|
|
29
|
+
})
|
|
30
|
+
.parse(input);
|
|
31
|
+
const event = prepareUsageRecord({
|
|
32
|
+
scope: raw.scope,
|
|
33
|
+
binding: raw.binding,
|
|
34
|
+
sourceEventId: "validation",
|
|
35
|
+
quantity: "0",
|
|
36
|
+
occurredAt: 0,
|
|
37
|
+
});
|
|
38
|
+
if (event.binding.plan.model === "prepaid")
|
|
39
|
+
throw new Error("Use payment-backed prepaid credit accounting");
|
|
40
|
+
if (raw.subscription.period.end <= raw.subscription.period.start ||
|
|
41
|
+
raw.subscription.stripePriceId !== event.binding.stripePriceId)
|
|
42
|
+
throw new Error("Allowance subscription period/price mismatch");
|
|
43
|
+
return {
|
|
44
|
+
scope: event.scope,
|
|
45
|
+
binding: event.binding,
|
|
46
|
+
subscription: raw.subscription,
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
export function limitPolicy(input, binding) {
|
|
50
|
+
const policy = usageLimitPolicySchema.parse(input), precision = binding.binding.plan.unit.precision;
|
|
51
|
+
if (policy.limit.mode !== "none")
|
|
52
|
+
policy.limit.quantity = parseUsageQuantity(policy.limit.quantity, precision).quantity;
|
|
53
|
+
if (binding.binding.plan.model === "pay_as_you_go" &&
|
|
54
|
+
policy.overage === "reject")
|
|
55
|
+
throw new Error("Pay-as-you-go requires an explicit usage cap instead of an included allowance");
|
|
56
|
+
return policy;
|
|
57
|
+
}
|
|
58
|
+
export function allowanceStatus(binding, policy, row, observedAt) {
|
|
59
|
+
const plan = binding.binding.plan, precision = plan.unit.precision;
|
|
60
|
+
const consumed = BigInt(row.consumed), reserved = BigInt(row.reserved), total = consumed + reserved;
|
|
61
|
+
const included = plan.model === "included_overage"
|
|
62
|
+
? BigInt(parseUsageQuantity(plan.includedQuantity, precision).scaledQuantity)
|
|
63
|
+
: 0n;
|
|
64
|
+
const overage = (quantity) => quantity > included ? quantity - included : 0n;
|
|
65
|
+
const quantity = (value) => decimalFromScaled(value, precision);
|
|
66
|
+
const cost = (value) => {
|
|
67
|
+
const [whole, fraction = ""] = plan.rate.unitAmountDecimal.split(".");
|
|
68
|
+
return {
|
|
69
|
+
amountDecimal: decimalFromScaled(overage(value) * BigInt(whole + fraction), precision + fraction.length),
|
|
70
|
+
currency: plan.rate.currency,
|
|
71
|
+
};
|
|
72
|
+
};
|
|
73
|
+
let hard = policy.limit.mode === "hard"
|
|
74
|
+
? BigInt(parseUsageQuantity(policy.limit.quantity, precision).scaledQuantity)
|
|
75
|
+
: null;
|
|
76
|
+
if (policy.overage === "reject")
|
|
77
|
+
hard = hard === null || included < hard ? included : hard;
|
|
78
|
+
return {
|
|
79
|
+
revision: row.revision,
|
|
80
|
+
observedAt,
|
|
81
|
+
period: binding.subscription.period,
|
|
82
|
+
accepting: policy.entitled &&
|
|
83
|
+
observedAt >= binding.subscription.period.start &&
|
|
84
|
+
observedAt < binding.subscription.period.end - 60 &&
|
|
85
|
+
(hard === null || total < hard),
|
|
86
|
+
policy,
|
|
87
|
+
consumedQuantity: quantity(consumed),
|
|
88
|
+
reservedQuantity: quantity(reserved),
|
|
89
|
+
includedQuantity: quantity(included),
|
|
90
|
+
remainingIncludedQuantity: quantity(included > total ? included - total : 0n),
|
|
91
|
+
billableOverageQuantity: quantity(overage(consumed)),
|
|
92
|
+
softLimitReached: policy.limit.mode === "soft" &&
|
|
93
|
+
total >=
|
|
94
|
+
BigInt(parseUsageQuantity(policy.limit.quantity, precision).scaledQuantity),
|
|
95
|
+
hardLimitRemainingQuantity: hard === null ? null : quantity(hard > total ? hard - total : 0n),
|
|
96
|
+
committedEstimate: cost(consumed),
|
|
97
|
+
projectedEstimate: cost(total),
|
|
98
|
+
cashCollection: "none",
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
//# sourceMappingURL=allowanceTerms.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"allowanceTerms.js","sourceRoot":"","sources":["../../../src/client/usage/allowanceTerms.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { UsageAllowanceClient } from "./allowanceClient.js";
|
|
2
2
|
import type { Component, RunCtx } from "../helpers.js";
|
|
3
3
|
import { type PreparedUsageRecord, type UsageScope, type UsageDeliveryState } from "./records.js";
|
|
4
4
|
import { type UsagePageRequest, type UsageSubscriptionBinding, type UsageReceipt } from "./boundaries.js";
|
|
@@ -18,7 +18,7 @@ export type UsageEventView = {
|
|
|
18
18
|
delivery: UsageDeliveryState;
|
|
19
19
|
};
|
|
20
20
|
/** Trusted host facade. Authenticate and authorize each exact scope first. */
|
|
21
|
-
export declare class UsageLedgerClient extends
|
|
21
|
+
export declare class UsageLedgerClient extends UsageAllowanceClient {
|
|
22
22
|
constructor(component: Component);
|
|
23
23
|
record(ctx: RunCtx, opts: RecordUsageOptions): Promise<UsageReceipt>;
|
|
24
24
|
get(ctx: RunCtx, opts: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,wBAAwB,CAAC;IACvC,aAAa,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,wBAAwB,CAAC;IACvC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAiBF,8EAA8E;AAC9E,qBAAa,iBAAkB,SAAQ,oBAAoB;IACzD,YAAY,SAAS,EAAE,SAAS,EAE/B;IACK,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBzE;IACK,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMhC;IACK,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE;;;;OAe1E;CACF"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { UsageAllowanceClient } from "./allowanceClient.js";
|
|
2
2
|
import { runMutationOrThrow } from "../helpers.js";
|
|
3
3
|
import { componentRef } from "../webhooks/helpers.js";
|
|
4
|
-
import {
|
|
4
|
+
import { validateUsageRecordInput, } from "./records.js";
|
|
5
5
|
import { validateUsagePageRequest, } from "./boundaries.js";
|
|
6
6
|
function decode({ event, delivery }) {
|
|
7
7
|
return {
|
|
@@ -17,12 +17,12 @@ function decode({ event, delivery }) {
|
|
|
17
17
|
};
|
|
18
18
|
}
|
|
19
19
|
/** Trusted host facade. Authenticate and authorize each exact scope first. */
|
|
20
|
-
export class UsageLedgerClient extends
|
|
20
|
+
export class UsageLedgerClient extends UsageAllowanceClient {
|
|
21
21
|
constructor(component) {
|
|
22
22
|
super(component);
|
|
23
23
|
}
|
|
24
24
|
async record(ctx, opts) {
|
|
25
|
-
const event =
|
|
25
|
+
const event = validateUsageRecordInput(opts.event);
|
|
26
26
|
const input = {
|
|
27
27
|
scope: event.scope,
|
|
28
28
|
binding: event.binding,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type Stripe from "stripe";
|
|
2
|
+
import type { UsageCreditPurchaseTerms } from "./creditTerms.js";
|
|
3
|
+
/** Read-only, bounded prepayment guard. Pending component intents reserve slots separately. */
|
|
4
|
+
export declare function verifyNativeCreditCapacity(stripe: Stripe, terms: UsageCreditPurchaseTerms, pending: number): Promise<void>;
|
|
5
|
+
//# sourceMappingURL=creditCapacity.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creditCapacity.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditCapacity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,+FAA+F;AAC/F,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,MAAM,iBAoEhB"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { creditRequire } from "./creditNative.js";
|
|
2
|
+
/** Read-only, bounded prepayment guard. Pending component intents reserve slots separately. */
|
|
3
|
+
export async function verifyNativeCreditCapacity(stripe, terms, pending) {
|
|
4
|
+
let cursor, complete = false;
|
|
5
|
+
const candidates = [];
|
|
6
|
+
for (let page = 0; page < 10; page++) {
|
|
7
|
+
const result = await stripe.billing.creditGrants.list({
|
|
8
|
+
customer_account: terms.scope.customerAccount,
|
|
9
|
+
limit: 100,
|
|
10
|
+
...(cursor ? { starting_after: cursor } : {}),
|
|
11
|
+
});
|
|
12
|
+
for (const grant of result.data) {
|
|
13
|
+
creditRequire(grant.customer_account === terms.scope.customerAccount &&
|
|
14
|
+
grant.livemode === terms.scope.livemode, "Native credit inventory scope mismatch");
|
|
15
|
+
if (!grant.voided_at &&
|
|
16
|
+
(grant.expires_at === null || grant.expires_at > Date.now() / 1000))
|
|
17
|
+
candidates.push(grant);
|
|
18
|
+
}
|
|
19
|
+
creditRequire(candidates.length <= 100, "Native credit capacity proof budget exceeded");
|
|
20
|
+
if (!result.has_more) {
|
|
21
|
+
complete = true;
|
|
22
|
+
break;
|
|
23
|
+
}
|
|
24
|
+
const next = result.data[result.data.length - 1]?.id;
|
|
25
|
+
creditRequire(next && next !== cursor, "Native credit capacity inventory incomplete");
|
|
26
|
+
cursor = next;
|
|
27
|
+
}
|
|
28
|
+
creditRequire(complete, "Native credit capacity inventory incomplete");
|
|
29
|
+
let unused = 0;
|
|
30
|
+
for (let start = 0; start < candidates.length; start += 5) {
|
|
31
|
+
const balances = await Promise.all(candidates.slice(start, start + 5).map((grant) => stripe.billing.creditBalanceSummaries.retrieve({
|
|
32
|
+
customer_account: terms.scope.customerAccount,
|
|
33
|
+
filter: { type: "credit_grant", credit_grant: grant.id },
|
|
34
|
+
})));
|
|
35
|
+
for (const balance of balances) {
|
|
36
|
+
creditRequire(balance.livemode === terms.scope.livemode &&
|
|
37
|
+
balance.customer_account === terms.scope.customerAccount &&
|
|
38
|
+
balance.balances.length === 1, "Native credit capacity balance unavailable");
|
|
39
|
+
const value = balance.balances[0].ledger_balance.monetary?.value;
|
|
40
|
+
creditRequire(typeof value === "number" && Number.isSafeInteger(value) && value >= 0, "Native credit capacity amount unavailable");
|
|
41
|
+
if (value > 0)
|
|
42
|
+
unused++;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
creditRequire(Number.isInteger(pending) && pending >= 1 && unused + pending <= 100, "Native unused credit grant capacity exhausted");
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=creditCapacity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creditCapacity.js","sourceRoot":"","sources":["../../../src/client/usage/creditCapacity.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import type { RunCtx } from "../helpers.js";
|
|
2
|
+
import { UsageSubscriptionClient } from "./subscriptionClient.js";
|
|
3
|
+
import { type UsageScope } from "./records.js";
|
|
4
|
+
import type { UsageSubscriptionBinding } from "./boundaries.js";
|
|
5
|
+
import { type UsageCreditBinding, type UsageCreditPurchaseOptions, type UsageCreditBalance } from "./creditTerms.js";
|
|
6
|
+
import type { UsageDeliveryProviderOptions } from "./deliveryProvider.js";
|
|
7
|
+
import type { Id } from "../../component/_generated/dataModel.js";
|
|
8
|
+
/** Trusted host authorizes the exact payer/realm/meter, activity and original terms. */
|
|
9
|
+
export declare class UsageCreditClient extends UsageSubscriptionClient {
|
|
10
|
+
reconcileCreditPurchase(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<{
|
|
11
|
+
status: "unavailable";
|
|
12
|
+
reason: string;
|
|
13
|
+
retryable: boolean;
|
|
14
|
+
observedAt?: undefined;
|
|
15
|
+
value?: undefined;
|
|
16
|
+
} | {
|
|
17
|
+
reason?: undefined;
|
|
18
|
+
retryable?: undefined;
|
|
19
|
+
status: "available";
|
|
20
|
+
observedAt: number;
|
|
21
|
+
value: import("./creditObservation.js").UsageCreditReconciliation;
|
|
22
|
+
}>;
|
|
23
|
+
prepareCreditRefund(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<{
|
|
24
|
+
paymentIntentId: string;
|
|
25
|
+
amount: number;
|
|
26
|
+
currency: string;
|
|
27
|
+
creditGrantId: string;
|
|
28
|
+
creditState: "disabled";
|
|
29
|
+
cashRefund: "required";
|
|
30
|
+
}>;
|
|
31
|
+
cancelCreditPurchase(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<import("./creditTerms.js").UsageCreditPurchase>;
|
|
32
|
+
purchaseCredits(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<{
|
|
33
|
+
purchase: import("./creditTerms.js").UsageCreditPurchase;
|
|
34
|
+
clientSecret: string | null;
|
|
35
|
+
}>;
|
|
36
|
+
observeCreditPurchase(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<import("./creditTerms.js").UsageCreditPurchase>;
|
|
37
|
+
getCreditPurchase(ctx: RunCtx, input: UsageCreditBinding & {
|
|
38
|
+
purchaseId: string;
|
|
39
|
+
}): Promise<import("./creditTerms.js").UsageCreditPurchase | null>;
|
|
40
|
+
resumeCreditAccount(ctx: RunCtx, input: UsageCreditBinding): Promise<any>;
|
|
41
|
+
closeCreditAccount(ctx: RunCtx, input: UsageCreditBinding): Promise<any>;
|
|
42
|
+
getCreditBalance(ctx: RunCtx, input: UsageCreditBinding): Promise<UsageCreditBalance>;
|
|
43
|
+
reserveCredits(ctx: RunCtx, input: {
|
|
44
|
+
event: unknown;
|
|
45
|
+
subscription: UsageSubscriptionBinding;
|
|
46
|
+
}): Promise<{
|
|
47
|
+
reservationId: Id<"usageReservations">;
|
|
48
|
+
state: "reserved" | "committed" | "released";
|
|
49
|
+
}>;
|
|
50
|
+
releaseCredits(ctx: RunCtx, input: {
|
|
51
|
+
scope: UsageScope;
|
|
52
|
+
reservationId: Id<"usageReservations">;
|
|
53
|
+
reason: "work_failed" | "abandoned_before_work";
|
|
54
|
+
}): Promise<any>;
|
|
55
|
+
readCreditHistory(ctx: RunCtx, input: UsageCreditBinding & {
|
|
56
|
+
limit: number;
|
|
57
|
+
cursor: string | null;
|
|
58
|
+
}): Promise<{
|
|
59
|
+
records: {
|
|
60
|
+
_creationTime: number;
|
|
61
|
+
_id: import("convex/values").GenericId<"usageCreditHistory">;
|
|
62
|
+
accountKey: string;
|
|
63
|
+
at: number;
|
|
64
|
+
evidenceJson: string;
|
|
65
|
+
fingerprint: string;
|
|
66
|
+
kind: "closure" | "commit" | "grant" | "observation" | "payment" | "purchase" | "recovery" | "release" | "reservation";
|
|
67
|
+
purchaseKey?: string | undefined;
|
|
68
|
+
sourceKey: string;
|
|
69
|
+
}[];
|
|
70
|
+
cursor: string | null;
|
|
71
|
+
isDone: boolean;
|
|
72
|
+
}>;
|
|
73
|
+
readCreditGrants(ctx: RunCtx, input: UsageCreditBinding & {
|
|
74
|
+
limit: number;
|
|
75
|
+
cursor: string | null;
|
|
76
|
+
}): Promise<{
|
|
77
|
+
records: {
|
|
78
|
+
_creationTime: number;
|
|
79
|
+
_id: import("convex/values").GenericId<"usageCreditGrants">;
|
|
80
|
+
accountKey: string;
|
|
81
|
+
available: string;
|
|
82
|
+
chargeId: string;
|
|
83
|
+
consumed: string;
|
|
84
|
+
creditGrantId: string;
|
|
85
|
+
effectiveAt: number;
|
|
86
|
+
expiresAt: number | null;
|
|
87
|
+
frozen: boolean;
|
|
88
|
+
nativeCreated: number;
|
|
89
|
+
nativeCustomerKey: string;
|
|
90
|
+
nativeExpired?: boolean | undefined;
|
|
91
|
+
nativeObservationJson?: string | undefined;
|
|
92
|
+
nativeUnused: boolean;
|
|
93
|
+
observedAt?: number | undefined;
|
|
94
|
+
paymentIntentId: string;
|
|
95
|
+
proofJson: string;
|
|
96
|
+
purchaseKey: string;
|
|
97
|
+
reserved: string;
|
|
98
|
+
}[];
|
|
99
|
+
cursor: string | null;
|
|
100
|
+
isDone: boolean;
|
|
101
|
+
}>;
|
|
102
|
+
private creditPage;
|
|
103
|
+
}
|
|
104
|
+
//# sourceMappingURL=creditClient.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creditClient.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditClient.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yCAAyC,CAAC;AA+BvE,wFAAwF;AACxF,qBAAa,iBAAkB,SAAQ,uBAAuB;IAC5D,uBAAuB,CACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;;;;;;;;;;OAQtC;IACD,mBAAmB,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;;;;;OAQtC;IACD,oBAAoB,CAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B,2DAQtC;IACD,eAAe,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;OAQtC;IACD,qBAAqB,CACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B,2DAQtC;IACK,iBAAiB,CACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,kEAUnD;IACD,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,gBAUzD;IACD,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,gBAUxD;IACD,gBAAgB,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAK7B;IACD,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,wBAAwB,CAAA;KAAE,GAChE,OAAO,CAAC;QACT,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;QACvC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;KAC9C,CAAC,CAmBD;IACD,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QACL,KAAK,EAAE,UAAU,CAAC;QAClB,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,EAAE,aAAa,GAAG,uBAAuB,CAAC;KACjD,gBAaF;IACD,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;;;;OAOrE;IACD,gBAAgB,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;OAGrE;YACa,UAAU;CAoBzB"}
|