@fantastic.dev/better-stripe 0.53.0 → 0.55.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 +12 -0
- package/README.md +1 -1
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +226 -34
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts +97 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +226 -34
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts +97 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
- package/dist/client/index.d.ts +8 -0
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +1 -0
- package/dist/client/index.js.map +1 -1
- 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 +3 -3
- package/dist/client/usage/client.js.map +1 -1
- package/dist/client/usage/deliveryClient.d.ts +64 -0
- package/dist/client/usage/deliveryClient.d.ts.map +1 -0
- package/dist/client/usage/deliveryClient.js +60 -0
- package/dist/client/usage/deliveryClient.js.map +1 -0
- package/dist/client/usage/deliveryProtocol.d.ts +130 -0
- package/dist/client/usage/deliveryProtocol.d.ts.map +1 -0
- package/dist/client/usage/deliveryProtocol.js +21 -0
- package/dist/client/usage/deliveryProtocol.js.map +1 -0
- package/dist/client/usage/deliveryProvider.d.ts +32 -0
- package/dist/client/usage/deliveryProvider.d.ts.map +1 -0
- package/dist/client/usage/deliveryProvider.js +127 -0
- package/dist/client/usage/deliveryProvider.js.map +1 -0
- package/dist/client/usage/index.d.ts +8 -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/invoiceObservation.d.ts +38 -0
- package/dist/client/usage/invoiceObservation.d.ts.map +1 -0
- package/dist/client/usage/invoiceObservation.js +157 -0
- package/dist/client/usage/invoiceObservation.js.map +1 -0
- package/dist/client/usage/observationClient.d.ts +83 -0
- package/dist/client/usage/observationClient.d.ts.map +1 -0
- package/dist/client/usage/observationClient.js +157 -0
- package/dist/client/usage/observationClient.js.map +1 -0
- package/dist/client/usage/observationTypes.d.ts +63 -0
- package/dist/client/usage/observationTypes.d.ts.map +1 -0
- package/dist/client/usage/observationTypes.js +59 -0
- package/dist/client/usage/observationTypes.js.map +1 -0
- package/dist/client/usage/providerObservation.d.ts +4 -0
- package/dist/client/usage/providerObservation.d.ts.map +1 -0
- package/dist/client/usage/providerObservation.js +96 -0
- package/dist/client/usage/providerObservation.js.map +1 -0
- package/dist/client/usage/reconciliation.d.ts +12 -0
- package/dist/client/usage/reconciliation.d.ts.map +1 -0
- package/dist/client/usage/reconciliation.js +48 -0
- package/dist/client/usage/reconciliation.js.map +1 -0
- package/dist/client/usage/summary.d.ts +50 -0
- package/dist/client/usage/summary.d.ts.map +1 -0
- package/dist/client/usage/summary.js +110 -0
- package/dist/client/usage/summary.js.map +1 -0
- package/dist/client/webhooks/handler.d.ts.map +1 -1
- package/dist/client/webhooks/handler.js +2 -1
- package/dist/client/webhooks/handler.js.map +1 -1
- package/dist/client/webhooks/meterErrors.d.ts +5 -0
- package/dist/client/webhooks/meterErrors.d.ts.map +1 -0
- package/dist/client/webhooks/meterErrors.js +98 -0
- package/dist/client/webhooks/meterErrors.js.map +1 -0
- package/dist/client/webhooks/v2.d.ts.map +1 -1
- package/dist/client/webhooks/v2.js +5 -0
- package/dist/client/webhooks/v2.js.map +1 -1
- package/dist/component/_generated/api.d.ts +22 -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 +265 -0
- package/dist/component/_generated/component.d.ts.map +1 -1
- package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
- package/dist/component/balanceFunding/mutations.d.ts +27 -27
- package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
- package/dist/component/earnings/triggers.d.ts +206 -18
- package/dist/component/earnings/triggers.d.ts.map +1 -1
- package/dist/component/schema.d.ts +97 -1
- package/dist/component/schema.js +6 -0
- package/dist/component/schema.js.map +1 -1
- package/dist/component/usage/schema.d.ts +101 -1
- package/dist/component/usage/schema.d.ts.map +1 -1
- package/dist/component/usage/schema.js +11 -2
- package/dist/component/usage/schema.js.map +1 -1
- package/dist/component/usageDelivery/bridge.d.ts +25 -0
- package/dist/component/usageDelivery/bridge.d.ts.map +1 -0
- package/dist/component/usageDelivery/bridge.js +45 -0
- package/dist/component/usageDelivery/bridge.js.map +1 -0
- package/dist/component/usageDelivery/fields.d.ts +79 -0
- package/dist/component/usageDelivery/fields.d.ts.map +1 -0
- package/dist/component/usageDelivery/fields.js +39 -0
- package/dist/component/usageDelivery/fields.js.map +1 -0
- package/dist/component/usageDelivery/helpers.d.ts +84 -0
- package/dist/component/usageDelivery/helpers.d.ts.map +1 -0
- package/dist/component/usageDelivery/helpers.js +63 -0
- package/dist/component/usageDelivery/helpers.js.map +1 -0
- package/dist/component/usageDelivery/mutations.d.ts +97 -0
- package/dist/component/usageDelivery/mutations.d.ts.map +1 -0
- package/dist/component/usageDelivery/mutations.js +160 -0
- package/dist/component/usageDelivery/mutations.js.map +1 -0
- package/dist/component/usageDelivery/queries.d.ts +115 -0
- package/dist/component/usageDelivery/queries.d.ts.map +1 -0
- package/dist/component/usageDelivery/queries.js +22 -0
- package/dist/component/usageDelivery/queries.js.map +1 -0
- package/dist/component/usageDelivery/schema.d.ts +79 -0
- package/dist/component/usageDelivery/schema.d.ts.map +1 -0
- package/dist/component/usageDelivery/schema.js +30 -0
- package/dist/component/usageDelivery/schema.js.map +1 -0
- package/dist/component/usageDelivery/steps.d.ts +85 -0
- package/dist/component/usageDelivery/steps.d.ts.map +1 -0
- package/dist/component/usageDelivery/steps.js +161 -0
- package/dist/component/usageDelivery/steps.js.map +1 -0
- package/dist/component/usageDelivery/workflow.d.ts +15 -0
- package/dist/component/usageDelivery/workflow.d.ts.map +1 -0
- package/dist/component/usageDelivery/workflow.js +28 -0
- package/dist/component/usageDelivery/workflow.js.map +1 -0
- package/dist/component/usageObservations/helpers.d.ts +38 -0
- package/dist/component/usageObservations/helpers.d.ts.map +1 -0
- package/dist/component/usageObservations/helpers.js +80 -0
- package/dist/component/usageObservations/helpers.js.map +1 -0
- package/dist/component/usageObservations/history.d.ts +6 -0
- package/dist/component/usageObservations/history.d.ts.map +1 -0
- package/dist/component/usageObservations/history.js +29 -0
- package/dist/component/usageObservations/history.js.map +1 -0
- package/dist/component/usageObservations/mutations.d.ts +6 -0
- package/dist/component/usageObservations/mutations.d.ts.map +1 -0
- package/dist/component/usageObservations/mutations.js +39 -0
- package/dist/component/usageObservations/mutations.js.map +1 -0
- package/dist/component/usageObservations/queries.d.ts +78 -0
- package/dist/component/usageObservations/queries.d.ts.map +1 -0
- package/dist/component/usageObservations/queries.js +131 -0
- package/dist/component/usageObservations/queries.js.map +1 -0
- package/dist/component/usageObservations/schema.d.ts +72 -0
- package/dist/component/usageObservations/schema.d.ts.map +1 -0
- package/dist/component/usageObservations/schema.js +29 -0
- package/dist/component/usageObservations/schema.js.map +1 -0
- package/docs/README.md +5 -1
- package/docs/metering-setup.md +3 -1
- package/docs/usage-delivery.md +143 -0
- package/docs/usage-observations.md +152 -0
- package/package.json +4 -2
- package/src/client/index.ts +34 -0
- package/src/client/usage/client.ts +5 -2
- package/src/client/usage/deliveryClient.ts +130 -0
- package/src/client/usage/deliveryProtocol.ts +26 -0
- package/src/client/usage/deliveryProvider.test.ts +207 -0
- package/src/client/usage/deliveryProvider.ts +155 -0
- package/src/client/usage/index.ts +31 -0
- package/src/client/usage/invoiceObservation.test.ts +195 -0
- package/src/client/usage/invoiceObservation.ts +203 -0
- package/src/client/usage/observationClient.ts +233 -0
- package/src/client/usage/observationTypes.ts +101 -0
- package/src/client/usage/providerObservation.test.ts +207 -0
- package/src/client/usage/providerObservation.ts +124 -0
- package/src/client/usage/reconciliation.test.ts +117 -0
- package/src/client/usage/reconciliation.ts +86 -0
- package/src/client/usage/summary.test.ts +222 -0
- package/src/client/usage/summary.ts +188 -0
- package/src/client/webhooks/handler.ts +2 -1
- package/src/client/webhooks/meterErrors.test.ts +164 -0
- package/src/client/webhooks/meterErrors.ts +118 -0
- package/src/client/webhooks/v2.ts +5 -0
- package/src/component/_generated/api.ts +22 -0
- package/src/component/_generated/component.ts +437 -0
- package/src/component/schema.ts +12 -0
- package/src/component/usage/schema.ts +11 -2
- package/src/component/usageDelivery/bridge.ts +56 -0
- package/src/component/usageDelivery/concurrency.test.ts +62 -0
- package/src/component/usageDelivery/fields.ts +60 -0
- package/src/component/usageDelivery/helpers.ts +77 -0
- package/src/component/usageDelivery/mutations.ts +210 -0
- package/src/component/usageDelivery/queries.ts +25 -0
- package/src/component/usageDelivery/schema.ts +33 -0
- package/src/component/usageDelivery/steps.ts +209 -0
- package/src/component/usageDelivery/workflow.test.ts +402 -0
- package/src/component/usageDelivery/workflow.ts +36 -0
- package/src/component/usageObservations/helpers.ts +95 -0
- package/src/component/usageObservations/history.test.ts +87 -0
- package/src/component/usageObservations/history.ts +39 -0
- package/src/component/usageObservations/mutations.ts +39 -0
- package/src/component/usageObservations/queries.test.ts +162 -0
- package/src/component/usageObservations/queries.ts +145 -0
- package/src/component/usageObservations/schema.ts +40 -0
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import Stripe from "stripe";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import type { Component, RunCtx } from "../helpers.js";
|
|
4
|
+
export declare const usageDeliveryRequest: z.ZodObject<{
|
|
5
|
+
scope: z.ZodObject<{
|
|
6
|
+
stripeAccountId: z.ZodString;
|
|
7
|
+
customerAccount: z.ZodString;
|
|
8
|
+
meterId: z.ZodString;
|
|
9
|
+
livemode: z.ZodBoolean;
|
|
10
|
+
}, z.core.$strict>;
|
|
11
|
+
eventId: z.ZodString;
|
|
12
|
+
attempt: z.ZodNumber;
|
|
13
|
+
definitionVersion: z.ZodLiteral<1>;
|
|
14
|
+
apiVersion: z.ZodString;
|
|
15
|
+
identifier: z.ZodString;
|
|
16
|
+
}, z.core.$strict>;
|
|
17
|
+
export type UsageDeliveryRequest = z.infer<typeof usageDeliveryRequest>;
|
|
18
|
+
export type UsageDeliveryOutcome = {
|
|
19
|
+
status: "accepted";
|
|
20
|
+
created: number;
|
|
21
|
+
} | {
|
|
22
|
+
status: "rate_limited" | "unavailable" | "unknown" | "rejected";
|
|
23
|
+
};
|
|
24
|
+
export type UsageDeliveryProviderOptions = {
|
|
25
|
+
stripeSecretKey?: string;
|
|
26
|
+
httpClient?: Stripe.HttpClient;
|
|
27
|
+
};
|
|
28
|
+
/** Internal host action only. Options never enter component or Workflow state. */
|
|
29
|
+
export declare function deliverUsageProvider(component: Component, ctx: RunCtx, input: UsageDeliveryRequest, options: UsageDeliveryProviderOptions): Promise<UsageDeliveryRequest & {
|
|
30
|
+
outcome: UsageDeliveryOutcome;
|
|
31
|
+
}>;
|
|
32
|
+
//# sourceMappingURL=deliveryProvider.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deliveryProvider.d.ts","sourceRoot":"","sources":["../../../src/client/usage/deliveryProvider.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAOvD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;kBAU/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,cAAc,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,4BAA4B,GAAG;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAChC,CAAC;AACF,kFAAkF;AAClF,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,oBAAoB,GAAG;IAAE,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAuHnE"}
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
import Stripe from "stripe";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { componentRef } from "../webhooks/helpers.js";
|
|
4
|
+
import { resolveStripeApiVersion } from "../apiVersion.js";
|
|
5
|
+
import { scopeSchema } from "./records.js";
|
|
6
|
+
import { verifyRealm, verifyMeter, UsageCatalogError } from "./catalogTypes.js";
|
|
7
|
+
import { subscriptionSnapshot } from "../../component/usage/helpers.js";
|
|
8
|
+
export const usageDeliveryRequest = z.strictObject({
|
|
9
|
+
scope: scopeSchema,
|
|
10
|
+
eventId: z.string().min(1).max(100),
|
|
11
|
+
attempt: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
|
|
12
|
+
definitionVersion: z.literal(1),
|
|
13
|
+
apiVersion: z.string(),
|
|
14
|
+
identifier: z
|
|
15
|
+
.string()
|
|
16
|
+
.regex(/^bs_usage_[a-zA-Z0-9_]+$/)
|
|
17
|
+
.max(100),
|
|
18
|
+
});
|
|
19
|
+
/** Internal host action only. Options never enter component or Workflow state. */
|
|
20
|
+
export async function deliverUsageProvider(component, ctx, input, options) {
|
|
21
|
+
const args = usageDeliveryRequest.parse(input);
|
|
22
|
+
const done = (outcome) => ({ ...args, outcome });
|
|
23
|
+
if (!options.stripeSecretKey)
|
|
24
|
+
return done({ status: "unavailable" });
|
|
25
|
+
let writing = false;
|
|
26
|
+
try {
|
|
27
|
+
const apiVersion = resolveStripeApiVersion(args.apiVersion);
|
|
28
|
+
const stripe = new Stripe(options.stripeSecretKey, {
|
|
29
|
+
apiVersion: apiVersion,
|
|
30
|
+
maxNetworkRetries: 0,
|
|
31
|
+
timeout: 15000,
|
|
32
|
+
...(options.httpClient ? { httpClient: options.httpClient } : {}),
|
|
33
|
+
});
|
|
34
|
+
const read = () => ctx.runQuery(componentRef(component, "usageDelivery/queries/snapshot"), {
|
|
35
|
+
scope: args.scope,
|
|
36
|
+
eventId: args.eventId,
|
|
37
|
+
});
|
|
38
|
+
const saved = await read(), record = JSON.parse(saved.event.recordJson);
|
|
39
|
+
const eligible = (outbox) => outbox.state === "sending" &&
|
|
40
|
+
!outbox.held &&
|
|
41
|
+
outbox.attempts === args.attempt &&
|
|
42
|
+
outbox.definitionVersion === args.definitionVersion &&
|
|
43
|
+
outbox.providerIdentifier === args.identifier &&
|
|
44
|
+
outbox.firstSendAt !== undefined &&
|
|
45
|
+
Date.now() / 1000 - outbox.firstSendAt < 23 * 3600 &&
|
|
46
|
+
(outbox.leaseUntil ?? 0) > Date.now() / 1000 + 60;
|
|
47
|
+
if (!eligible(saved.outbox) ||
|
|
48
|
+
record.binding.apiVersion !== apiVersion ||
|
|
49
|
+
JSON.stringify(record.scope) !== JSON.stringify(args.scope))
|
|
50
|
+
return done({ status: "unknown" });
|
|
51
|
+
const now = Math.floor(Date.now() / 1000);
|
|
52
|
+
if (record.occurredAt < now - 35 * 86400 || record.occurredAt > now + 300)
|
|
53
|
+
return done({ status: "rejected" });
|
|
54
|
+
await verifyRealm(stripe, {
|
|
55
|
+
stripeAccountId: args.scope.stripeAccountId,
|
|
56
|
+
livemode: args.scope.livemode,
|
|
57
|
+
});
|
|
58
|
+
const binding = subscriptionSnapshot(saved.event.subscriptionJson);
|
|
59
|
+
const [meter, subscription] = await Promise.all([
|
|
60
|
+
stripe.billing.meters.retrieve(args.scope.meterId),
|
|
61
|
+
stripe.subscriptions.retrieve(binding.subscriptionId),
|
|
62
|
+
]);
|
|
63
|
+
if (meter.id !== args.scope.meterId ||
|
|
64
|
+
subscription.id !== binding.subscriptionId ||
|
|
65
|
+
subscription.livemode !== args.scope.livemode ||
|
|
66
|
+
subscription.customer_account !== args.scope.customerAccount ||
|
|
67
|
+
(typeof subscription.customer === "string"
|
|
68
|
+
? subscription.customer
|
|
69
|
+
: subscription.customer?.id) !== record.binding.stripeCustomerId)
|
|
70
|
+
return done({ status: "rejected" });
|
|
71
|
+
verifyMeter(meter, {
|
|
72
|
+
scope: args.scope,
|
|
73
|
+
plan: record.binding.plan,
|
|
74
|
+
eventName: record.binding.eventName,
|
|
75
|
+
displayName: meter.display_name,
|
|
76
|
+
});
|
|
77
|
+
if (!eligible((await read()).outbox))
|
|
78
|
+
return done({ status: "unknown" });
|
|
79
|
+
writing = true;
|
|
80
|
+
const response = await stripe.billing.meterEvents.create({
|
|
81
|
+
event_name: record.binding.eventName,
|
|
82
|
+
identifier: args.identifier,
|
|
83
|
+
timestamp: record.occurredAt,
|
|
84
|
+
payload: {
|
|
85
|
+
stripe_customer_id: record.binding.stripeCustomerId,
|
|
86
|
+
value: record.scaledQuantity,
|
|
87
|
+
},
|
|
88
|
+
}, { idempotencyKey: args.identifier });
|
|
89
|
+
if (response.identifier !== args.identifier ||
|
|
90
|
+
response.event_name !== record.binding.eventName ||
|
|
91
|
+
response.livemode !== args.scope.livemode ||
|
|
92
|
+
response.timestamp !== record.occurredAt ||
|
|
93
|
+
response.payload.stripe_customer_id !== record.binding.stripeCustomerId ||
|
|
94
|
+
String(response.payload.value) !== record.scaledQuantity ||
|
|
95
|
+
!Number.isSafeInteger(response.created) ||
|
|
96
|
+
response.created < 0)
|
|
97
|
+
return done({ status: "unknown" });
|
|
98
|
+
return done({ status: "accepted", created: response.created });
|
|
99
|
+
}
|
|
100
|
+
catch (error) {
|
|
101
|
+
if (!writing)
|
|
102
|
+
return done({
|
|
103
|
+
status: error instanceof UsageCatalogError &&
|
|
104
|
+
error.code === "unsupported_scope"
|
|
105
|
+
? "rejected"
|
|
106
|
+
: "unavailable",
|
|
107
|
+
});
|
|
108
|
+
const status = error instanceof Stripe.errors.StripeError ? error.statusCode : undefined;
|
|
109
|
+
if (status === 429)
|
|
110
|
+
return done({ status: "rate_limited" });
|
|
111
|
+
if (status === 401 || status === 403)
|
|
112
|
+
return done({ status: "unavailable" });
|
|
113
|
+
const code = error instanceof Stripe.errors.StripeError ? error.code : undefined;
|
|
114
|
+
if (status === 404 ||
|
|
115
|
+
(status === 400 &&
|
|
116
|
+
code !== undefined &&
|
|
117
|
+
[
|
|
118
|
+
"parameter_invalid_integer",
|
|
119
|
+
"parameter_invalid_empty",
|
|
120
|
+
"parameter_missing",
|
|
121
|
+
"resource_missing",
|
|
122
|
+
].includes(code)))
|
|
123
|
+
return done({ status: "rejected" });
|
|
124
|
+
return done({ status: "unknown" });
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
//# sourceMappingURL=deliveryProvider.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"deliveryProvider.js","sourceRoot":"","sources":["../../../src/client/usage/deliveryProvider.ts"],"names":[],"mappings":"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"}
|
|
@@ -4,4 +4,12 @@ export { prepareUsageRecord } from "./records.js";
|
|
|
4
4
|
export type { UsageScope, PreparedUsageRecord, UsageDeliveryState, } from "./records.js";
|
|
5
5
|
export { assertUsageReplay, validateUsagePageRequest, authorizeUsageRecord, } from "./boundaries.js";
|
|
6
6
|
export type { UsagePeriod, UsagePageRequest, UsageAvailability, UsageAuthorization, UsageObservations, UsageCorrectionRequest, UsageRetentionPolicy, UsageTransitionRequest, UsageSubscriptionBinding, UsageCreditProvenance, UsageCorrectionOutcome, UsageReceipt, UsageHistoryPage, UsageProviderCapabilities, UsageContractPort, } from "./boundaries.js";
|
|
7
|
+
export type { UsageDeliveryRequest, UsageDeliveryOutcome, UsageDeliveryProviderOptions, } from "./deliveryProvider.js";
|
|
8
|
+
export type { UsageDeliveryRef, UsageDeliveryStatus, UsageDeliveryStartOptions, } from "./deliveryClient.js";
|
|
9
|
+
export { usageDeliveryArgs, usageDeliveryResult } from "./deliveryProtocol.js";
|
|
10
|
+
export type { UsageObservationOptions, UsageAggregateValue, UsageAggregateObservation, } from "./observationTypes.js";
|
|
11
|
+
export type { UsageLocalSummary, UsageLocalGroup, UsageCreditSummary, } from "./summary.js";
|
|
12
|
+
export type { UsageComparison } from "./reconciliation.js";
|
|
13
|
+
export type { UsageReconciliationOptions } from "./observationClient.js";
|
|
14
|
+
export type { UsageInvoiceObservation, UsageInvoiceLine, } from "./invoiceObservation.js";
|
|
7
15
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACrE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACrE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,YAAY,EACV,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export { defineUsagePlan, parseUsageQuantity } from "./contracts.js";
|
|
2
2
|
export { prepareUsageRecord } from "./records.js";
|
|
3
3
|
export { assertUsageReplay, validateUsagePageRequest, authorizeUsageRecord, } from "./boundaries.js";
|
|
4
|
+
export { usageDeliveryArgs, usageDeliveryResult } from "./deliveryProtocol.js";
|
|
4
5
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAMlD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAMlD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AA8BzB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type Stripe from "stripe";
|
|
2
|
+
import { type UsageObservationOptions } from "./observationTypes.js";
|
|
3
|
+
import type { UsageAvailability } from "./boundaries.js";
|
|
4
|
+
export type UsageInvoiceLine = {
|
|
5
|
+
lineId: string;
|
|
6
|
+
stripePriceId: string;
|
|
7
|
+
subscriptionItemId: string;
|
|
8
|
+
amount: string;
|
|
9
|
+
currency: string;
|
|
10
|
+
quantity: string | null;
|
|
11
|
+
providerQuantityDecimal: string | null;
|
|
12
|
+
unitAmountDecimal: string | null;
|
|
13
|
+
creditAppliedAmount: string;
|
|
14
|
+
nativePeriod: {
|
|
15
|
+
start: number;
|
|
16
|
+
end: number;
|
|
17
|
+
};
|
|
18
|
+
proration: boolean;
|
|
19
|
+
};
|
|
20
|
+
export type UsageInvoiceObservation = {
|
|
21
|
+
kind: "preview" | "invoice";
|
|
22
|
+
invoiceId: string;
|
|
23
|
+
status: "draft" | "open" | "paid" | "void" | "uncollectible";
|
|
24
|
+
finalized: boolean;
|
|
25
|
+
amountDue: string;
|
|
26
|
+
amountPaid: string;
|
|
27
|
+
total: string;
|
|
28
|
+
currency: string;
|
|
29
|
+
linesComplete: boolean;
|
|
30
|
+
lines: UsageInvoiceLine[];
|
|
31
|
+
meterAmount: UsageAvailability<{
|
|
32
|
+
amount: string;
|
|
33
|
+
currency: string;
|
|
34
|
+
}>;
|
|
35
|
+
paymentEvidence: "not_resolved";
|
|
36
|
+
};
|
|
37
|
+
export declare function observeUsageInvoice(stripe: Stripe, input: UsageObservationOptions, invoiceId?: string): Promise<UsageAvailability<UsageInvoiceObservation>>;
|
|
38
|
+
//# sourceMappingURL=invoiceObservation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"invoiceObservation.d.ts","sourceRoot":"","sources":["../../../src/client/usage/invoiceObservation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,WAAW,EAAE,iBAAiB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,eAAe,EAAE,cAAc,CAAC;CACjC,CAAC;AAcF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,CAAC,CAoJrD"}
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { observationOptions, verifyObservationSource, } from "./observationTypes.js";
|
|
3
|
+
import { UsageCatalogError } from "./catalogTypes.js";
|
|
4
|
+
import { decimalFromScaled } from "./summary.js";
|
|
5
|
+
const idOf = (value) => typeof value === "string" ? value : value?.id;
|
|
6
|
+
function amount(value) {
|
|
7
|
+
if (!Number.isSafeInteger(value))
|
|
8
|
+
throw new Error("Unsafe native amount");
|
|
9
|
+
return String(value);
|
|
10
|
+
}
|
|
11
|
+
function decimal(value) {
|
|
12
|
+
if (value == null)
|
|
13
|
+
return null;
|
|
14
|
+
const text = value.toString();
|
|
15
|
+
if (!/^\d+(\.\d{1,12})?$/.test(text) || text.length > 64)
|
|
16
|
+
throw new Error("Unsupported native decimal");
|
|
17
|
+
return text;
|
|
18
|
+
}
|
|
19
|
+
export async function observeUsageInvoice(stripe, input, invoiceId) {
|
|
20
|
+
const opts = observationOptions(input), observedAt = Math.floor(Date.now() / 1000);
|
|
21
|
+
if (invoiceId !== undefined)
|
|
22
|
+
z.string()
|
|
23
|
+
.regex(/^in_[a-zA-Z0-9]+$/)
|
|
24
|
+
.max(100)
|
|
25
|
+
.parse(invoiceId);
|
|
26
|
+
try {
|
|
27
|
+
if (!(await verifyObservationSource(stripe, opts)))
|
|
28
|
+
return {
|
|
29
|
+
status: "unsupported",
|
|
30
|
+
reason: "provider_binding_mismatch",
|
|
31
|
+
retryable: false,
|
|
32
|
+
};
|
|
33
|
+
const invoice = invoiceId
|
|
34
|
+
? await stripe.invoices.retrieve(invoiceId)
|
|
35
|
+
: await stripe.invoices.createPreview({
|
|
36
|
+
subscription: opts.subscription.subscriptionId,
|
|
37
|
+
customer_account: opts.scope.customerAccount,
|
|
38
|
+
});
|
|
39
|
+
const status = z
|
|
40
|
+
.enum(["draft", "open", "paid", "void", "uncollectible"])
|
|
41
|
+
.safeParse(invoice.status);
|
|
42
|
+
if (!status.success ||
|
|
43
|
+
!invoice.id ||
|
|
44
|
+
invoice.id.length > 100 ||
|
|
45
|
+
(invoiceId && invoice.id !== invoiceId) ||
|
|
46
|
+
invoice.livemode !== opts.scope.livemode ||
|
|
47
|
+
invoice.customer_account !== opts.scope.customerAccount ||
|
|
48
|
+
idOf(invoice.customer) !== opts.binding.stripeCustomerId ||
|
|
49
|
+
idOf(invoice.parent?.subscription_details?.subscription) !==
|
|
50
|
+
opts.subscription.subscriptionId ||
|
|
51
|
+
invoice.currency !== opts.binding.plan.rate.currency)
|
|
52
|
+
return {
|
|
53
|
+
status: "unsupported",
|
|
54
|
+
reason: "invoice_binding_mismatch",
|
|
55
|
+
retryable: false,
|
|
56
|
+
};
|
|
57
|
+
const lines = [];
|
|
58
|
+
let ambiguous = false;
|
|
59
|
+
const linesComplete = !invoice.lines.has_more && invoice.lines.data.length <= 100;
|
|
60
|
+
for (const line of invoice.lines.data.slice(0, 100)) {
|
|
61
|
+
if (line.pricing?.price_details?.price !== opts.binding.stripePriceId)
|
|
62
|
+
continue;
|
|
63
|
+
const parent = line.parent?.subscription_item_details;
|
|
64
|
+
if (parent?.subscription !== opts.subscription.subscriptionId ||
|
|
65
|
+
parent.subscription_item !== opts.subscription.subscriptionItemId ||
|
|
66
|
+
line.currency !== invoice.currency) {
|
|
67
|
+
ambiguous = true;
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
const providerQuantity = decimal(line.quantity_decimal);
|
|
71
|
+
let quantity = null;
|
|
72
|
+
if (providerQuantity !== null) {
|
|
73
|
+
const [whole, fraction = ""] = providerQuantity.split(".");
|
|
74
|
+
quantity = decimalFromScaled(BigInt(whole + fraction), fraction.length + opts.binding.plan.unit.precision);
|
|
75
|
+
}
|
|
76
|
+
const creditApplied = (line.pretax_credit_amounts ?? [])
|
|
77
|
+
.filter((value) => value.type === "credit_balance_transaction")
|
|
78
|
+
.reduce((sum, value) => sum + BigInt(amount(value.amount)), 0n);
|
|
79
|
+
lines.push({
|
|
80
|
+
lineId: line.id,
|
|
81
|
+
stripePriceId: opts.binding.stripePriceId,
|
|
82
|
+
subscriptionItemId: parent.subscription_item,
|
|
83
|
+
amount: amount(line.amount),
|
|
84
|
+
currency: line.currency,
|
|
85
|
+
quantity,
|
|
86
|
+
providerQuantityDecimal: providerQuantity,
|
|
87
|
+
unitAmountDecimal: decimal(line.pricing.unit_amount_decimal),
|
|
88
|
+
creditAppliedAmount: creditApplied.toString(),
|
|
89
|
+
nativePeriod: { start: line.period.start, end: line.period.end },
|
|
90
|
+
proration: parent.proration,
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
const meterAmount = !linesComplete
|
|
94
|
+
? {
|
|
95
|
+
status: "unavailable",
|
|
96
|
+
reason: "invoice_history_incomplete",
|
|
97
|
+
retryable: true,
|
|
98
|
+
}
|
|
99
|
+
: ambiguous
|
|
100
|
+
? {
|
|
101
|
+
status: "unavailable",
|
|
102
|
+
reason: "ambiguous_invoice_items",
|
|
103
|
+
retryable: false,
|
|
104
|
+
}
|
|
105
|
+
: !lines.length
|
|
106
|
+
? {
|
|
107
|
+
status: "unavailable",
|
|
108
|
+
reason: "metered_lines_not_observed",
|
|
109
|
+
retryable: true,
|
|
110
|
+
}
|
|
111
|
+
: {
|
|
112
|
+
status: "available",
|
|
113
|
+
observedAt,
|
|
114
|
+
value: {
|
|
115
|
+
amount: lines
|
|
116
|
+
.reduce((sum, line) => sum + BigInt(line.amount), 0n)
|
|
117
|
+
.toString(),
|
|
118
|
+
currency: invoice.currency,
|
|
119
|
+
},
|
|
120
|
+
};
|
|
121
|
+
return {
|
|
122
|
+
status: "available",
|
|
123
|
+
observedAt,
|
|
124
|
+
value: {
|
|
125
|
+
kind: invoiceId ? "invoice" : "preview",
|
|
126
|
+
invoiceId: invoice.id,
|
|
127
|
+
status: status.data,
|
|
128
|
+
finalized: invoiceId !== undefined &&
|
|
129
|
+
invoice.status !== "draft" &&
|
|
130
|
+
Number.isSafeInteger(invoice.status_transitions?.finalized_at),
|
|
131
|
+
amountDue: amount(invoice.amount_due),
|
|
132
|
+
amountPaid: amount(invoice.amount_paid),
|
|
133
|
+
total: amount(invoice.total),
|
|
134
|
+
currency: invoice.currency,
|
|
135
|
+
linesComplete,
|
|
136
|
+
lines,
|
|
137
|
+
meterAmount,
|
|
138
|
+
paymentEvidence: "not_resolved",
|
|
139
|
+
},
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
catch (error) {
|
|
143
|
+
if (error instanceof UsageCatalogError &&
|
|
144
|
+
error.code === "unsupported_scope")
|
|
145
|
+
return {
|
|
146
|
+
status: "unsupported",
|
|
147
|
+
reason: "unsupported_scope",
|
|
148
|
+
retryable: false,
|
|
149
|
+
};
|
|
150
|
+
return {
|
|
151
|
+
status: "unavailable",
|
|
152
|
+
reason: "invoice_unavailable",
|
|
153
|
+
retryable: true,
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
//# sourceMappingURL=invoiceObservation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"invoiceObservation.js","sourceRoot":"","sources":["../../../src/client/usage/invoiceObservation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import type { UsageDeliveryRef } from "./deliveryClient.js";
|
|
2
|
+
import type { RunCtx } from "../helpers.js";
|
|
3
|
+
import { UsageDeliveryClient } from "./deliveryClient.js";
|
|
4
|
+
import type { UsageDeliveryProviderOptions } from "./deliveryProvider.js";
|
|
5
|
+
import { type UsageObservationOptions, type UsageAggregateObservation } from "./observationTypes.js";
|
|
6
|
+
import type { UsageLocalSummary } from "./summary.js";
|
|
7
|
+
import type { UsageScope } from "./records.js";
|
|
8
|
+
import { type UsagePeriod } from "./boundaries.js";
|
|
9
|
+
export type UsageReconciliationOptions = UsageObservationOptions & {
|
|
10
|
+
maxRecords?: number;
|
|
11
|
+
maxAgeSeconds?: number;
|
|
12
|
+
};
|
|
13
|
+
/** Host authorizes the exact scope and original binding before every call. */
|
|
14
|
+
export declare class UsageObservationClient extends UsageDeliveryClient {
|
|
15
|
+
getSummary(ctx: RunCtx, input: {
|
|
16
|
+
scope: UsageScope;
|
|
17
|
+
period: UsagePeriod;
|
|
18
|
+
maxRecords?: number;
|
|
19
|
+
}): Promise<UsageLocalSummary>;
|
|
20
|
+
getProviderUsage(ctx: RunCtx, input: UsageReconciliationOptions): Promise<UsageAggregateObservation>;
|
|
21
|
+
observeProviderUsage(ctx: RunCtx, input: UsageObservationOptions, options: UsageDeliveryProviderOptions): Promise<UsageAggregateObservation>;
|
|
22
|
+
readDeliveryHistory(ctx: RunCtx, input: UsageDeliveryRef & {
|
|
23
|
+
limit: number;
|
|
24
|
+
cursor: string | null;
|
|
25
|
+
}): Promise<{
|
|
26
|
+
records: {
|
|
27
|
+
sequence: number;
|
|
28
|
+
attempt: number;
|
|
29
|
+
phase: "accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired";
|
|
30
|
+
recordedAt: number;
|
|
31
|
+
created: number | null;
|
|
32
|
+
}[];
|
|
33
|
+
isDone: boolean;
|
|
34
|
+
cursor: string | null;
|
|
35
|
+
legacyHistoryMissing: boolean;
|
|
36
|
+
}>;
|
|
37
|
+
readValidationHistory(ctx: RunCtx, input: UsageDeliveryRef & {
|
|
38
|
+
limit: number;
|
|
39
|
+
cursor: string | null;
|
|
40
|
+
}): Promise<{
|
|
41
|
+
records: {
|
|
42
|
+
providerEventId: string;
|
|
43
|
+
code: "archived_meter" | "meter_event_customer_not_found" | "meter_event_dimension_count_too_high" | "meter_event_invalid_value" | "meter_event_no_customer_defined" | "meter_event_value_not_found" | "no_meter" | "timestamp_in_future" | "timestamp_too_far_in_past";
|
|
44
|
+
observedAt: number;
|
|
45
|
+
}[];
|
|
46
|
+
isDone: boolean;
|
|
47
|
+
cursor: string | null;
|
|
48
|
+
}>;
|
|
49
|
+
readInvoiceUsage(_ctx: RunCtx, input: UsageObservationOptions & {
|
|
50
|
+
invoiceId?: string;
|
|
51
|
+
}, options: UsageDeliveryProviderOptions): Promise<import("./boundaries.js").UsageAvailability<import("./invoiceObservation.js").UsageInvoiceObservation>>;
|
|
52
|
+
getReconciliation(ctx: RunCtx, input: UsageReconciliationOptions): Promise<{
|
|
53
|
+
local: UsageLocalSummary;
|
|
54
|
+
aggregate: UsageAggregateObservation;
|
|
55
|
+
comparison: import("./reconciliation.js").UsageComparison;
|
|
56
|
+
invoice: {
|
|
57
|
+
status: "unavailable";
|
|
58
|
+
reason: string;
|
|
59
|
+
retryable: boolean;
|
|
60
|
+
};
|
|
61
|
+
correctionHistory: {
|
|
62
|
+
status: "unsupported";
|
|
63
|
+
reason: string;
|
|
64
|
+
retryable: boolean;
|
|
65
|
+
};
|
|
66
|
+
}>;
|
|
67
|
+
reconcile(ctx: RunCtx, input: UsageReconciliationOptions, options: UsageDeliveryProviderOptions): Promise<{
|
|
68
|
+
local: UsageLocalSummary;
|
|
69
|
+
aggregate: UsageAggregateObservation;
|
|
70
|
+
comparison: import("./reconciliation.js").UsageComparison;
|
|
71
|
+
invoice: {
|
|
72
|
+
status: "unavailable";
|
|
73
|
+
reason: string;
|
|
74
|
+
retryable: boolean;
|
|
75
|
+
};
|
|
76
|
+
correctionHistory: {
|
|
77
|
+
status: "unsupported";
|
|
78
|
+
reason: string;
|
|
79
|
+
retryable: boolean;
|
|
80
|
+
};
|
|
81
|
+
}>;
|
|
82
|
+
}
|
|
83
|
+
//# sourceMappingURL=observationClient.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observationClient.d.ts","sourceRoot":"","sources":["../../../src/client/usage/observationClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,GAAG;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,8EAA8E;AAC9E,qBAAa,sBAAuB,SAAQ,mBAAmB;IACvD,UAAU,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,OAAO,CAAC,iBAAiB,CAAC,CAY5B;IACK,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,yBAAyB,CAAC,CA0BpC;IACK,oBAAoB,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,yBAAyB,CAAC,CA4BpC;IACK,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;OAkCnE;IACK,qBAAqB,CACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;OA+BnE;IACK,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,uBAAuB,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EACvD,OAAO,EAAE,4BAA4B,mHAgBtC;IACK,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B;;;;;YAehE,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;;YAGT,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;OAGd;IACK,SAAS,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;;;YAdjC,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;;YAGT,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;OAWd;CACF"}
|