@genesis-tech/genesispay-seller 0.8.0 → 0.10.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 +69 -38
- package/README.md +77 -40
- package/dist/client.d.ts +18 -15
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +56 -39
- package/dist/client.js.map +1 -1
- package/dist/customers.d.ts +2 -2
- package/dist/customers.d.ts.map +1 -1
- package/dist/customers.js +5 -5
- package/dist/customers.js.map +1 -1
- package/dist/errors.d.ts +9 -9
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +18 -18
- package/dist/errors.js.map +1 -1
- package/dist/genesispay-settlement.d.ts +30 -0
- package/dist/genesispay-settlement.d.ts.map +1 -0
- package/dist/genesispay-settlement.js +103 -0
- package/dist/genesispay-settlement.js.map +1 -0
- package/dist/index.d.ts +5 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -4
- package/dist/index.js.map +1 -1
- package/dist/invoices.d.ts +2 -2
- package/dist/invoices.d.ts.map +1 -1
- package/dist/invoices.js +7 -7
- package/dist/invoices.js.map +1 -1
- package/dist/mandate-gate.d.ts +5 -5
- package/dist/mandate-gate.d.ts.map +1 -1
- package/dist/mandate-gate.js +4 -4
- package/dist/mandate-gate.js.map +1 -1
- package/dist/mandates.d.ts +4 -4
- package/dist/mandates.d.ts.map +1 -1
- package/dist/mandates.js +9 -9
- package/dist/mandates.js.map +1 -1
- package/dist/payment-gate.js +1 -1
- package/dist/payment-gate.js.map +1 -1
- package/dist/plans.d.ts +2 -2
- package/dist/plans.d.ts.map +1 -1
- package/dist/plans.js +6 -6
- package/dist/plans.js.map +1 -1
- package/dist/products.d.ts +80 -0
- package/dist/products.d.ts.map +1 -0
- package/dist/products.js +154 -0
- package/dist/products.js.map +1 -0
- package/dist/resource.d.ts +2 -2
- package/dist/resource.d.ts.map +1 -1
- package/dist/resource.js +1 -1
- package/dist/resource.js.map +1 -1
- package/dist/webhooks.d.ts +25 -25
- package/dist/webhooks.d.ts.map +1 -1
- package/dist/webhooks.js +30 -29
- package/dist/webhooks.js.map +1 -1
- package/package.json +2 -2
package/dist/payment-gate.js
CHANGED
|
@@ -36,7 +36,7 @@ export function createPaymentGate(config) {
|
|
|
36
36
|
},
|
|
37
37
|
wrap(handler, options) {
|
|
38
38
|
if (typeof options?.verifySettlement !== "function") {
|
|
39
|
-
throw new Error("gate.wrap requires a verifySettlement hook — use
|
|
39
|
+
throw new Error("gate.wrap requires a verifySettlement hook — use genesisPaySettlement({ facilitatorBaseUrl, apiKey }) or provide your own.");
|
|
40
40
|
}
|
|
41
41
|
return async (request, ...args) => {
|
|
42
42
|
const payload = buildPayload(resolveResource(request));
|
package/dist/payment-gate.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"payment-gate.js","sourceRoot":"","sources":["../src/payment-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,8BAA8B,EAC9B,0CAA0C,GAC3C,MAAM,mCAAmC,CAAC;AAQ3C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAuE/D,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,MAAM,OAAO,GAAG,yBAAyB,CAAC,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC;IAC5E,MAAM,eAAe,GAAG,2BAA2B,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,kBAAkB,CAAC;IAE7D,SAAS,YAAY,CAAC,QAAgB;QACpC,OAAO,2BAA2B,CAAC;YACjC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;YAChC,eAAe;YACf,KAAK,EAAE,MAAM;YACb,YAAY,EAAE,OAAO,CAAC,WAAW;YACjC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,KAAK;YAClB,WAAW;YACX,QAAQ;YACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,KAAK,EAAE,MAAM,CAAC,YAAY;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,SAAS,eAAe,CAAC,OAAgB;QACvC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC,QAAQ,CAAC;QACzB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,OAAO;QACL,cAAc,CAAC,QAAgB;YAC7B,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CACF,OAA+B,EAC/B,OAAoB;YAEpB,IAAI,OAAO,OAAO,EAAE,gBAAgB,KAAK,UAAU,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CACb,
|
|
1
|
+
{"version":3,"file":"payment-gate.js","sourceRoot":"","sources":["../src/payment-gate.ts"],"names":[],"mappings":"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"}
|
package/dist/plans.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type
|
|
1
|
+
import { type GenesisPayRequest } from "./resource.js";
|
|
2
2
|
export type SubscriptionPlanStatus = "active" | "archived";
|
|
3
3
|
export type SubscriptionPlan = {
|
|
4
4
|
/** Internal id. Address a plan by `publicId` — that is what the routes take. */
|
|
@@ -57,7 +57,7 @@ export interface PlansResource {
|
|
|
57
57
|
*/
|
|
58
58
|
archive(publicId: string): Promise<SubscriptionPlan>;
|
|
59
59
|
}
|
|
60
|
-
export declare function createPlansResource(request:
|
|
60
|
+
export declare function createPlansResource(request: GenesisPayRequest,
|
|
61
61
|
/**
|
|
62
62
|
* Applies the client's `expectedPayTo` pin to the wallet the server froze
|
|
63
63
|
* onto the plan. A plan's destination is where every future renewal settles,
|
package/dist/plans.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AASA,OAAO,EAOL,KAAK,
|
|
1
|
+
{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AASA,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1D,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACtD;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB;AAC1B;;;;GAIG;AACH,uBAAuB,GAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,IAAe,GAC1E,aAAa,CAwEf;AA6BD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAwBjF"}
|
package/dist/plans.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
// `
|
|
1
|
+
// `genesispay.plans.*` — subscription plans over `/api/v1/plans`.
|
|
2
2
|
//
|
|
3
3
|
// A plan is the recurring sibling of a checkout link: it describes an amount
|
|
4
4
|
// per period and exposes a hosted `checkoutUrl` the customer signs a mandate
|
|
5
5
|
// on. Everything is scoped to the key's own account, so a plan owned by someone
|
|
6
|
-
// else answers 404 (
|
|
6
|
+
// else answers 404 (GenesisPayNotFoundError) rather than 403 — the API is no
|
|
7
7
|
// plan-enumeration oracle, and the SDK does not paper over that.
|
|
8
|
-
import {
|
|
8
|
+
import { GenesisPayConfigError } from "./errors.js";
|
|
9
9
|
import { asRecord, optionalString, requiredString, toAmountString, toCount, oneOf, } from "./resource.js";
|
|
10
10
|
export function createPlansResource(request,
|
|
11
11
|
/**
|
|
@@ -49,7 +49,7 @@ assertPinnedDestination = () => { }) {
|
|
|
49
49
|
if (!Array.isArray(plans)) {
|
|
50
50
|
// A list endpoint that answers 200 without a list is a broken contract,
|
|
51
51
|
// not an old backend. Returning [] here would hide it as "no plans yet".
|
|
52
|
-
throw new
|
|
52
|
+
throw new GenesisPayConfigError(`GenesisPay GET /api/v1/plans returned no plans array: ${JSON.stringify(body)}`);
|
|
53
53
|
}
|
|
54
54
|
// Individual entries stay tolerant: one unusable row must not lose the rest.
|
|
55
55
|
return plans
|
|
@@ -88,14 +88,14 @@ function notFoundMessage(id) {
|
|
|
88
88
|
function requirePublicId(publicId, method) {
|
|
89
89
|
const id = publicId?.trim();
|
|
90
90
|
if (!id) {
|
|
91
|
-
throw new
|
|
91
|
+
throw new GenesisPayConfigError(`${method}(publicId) requires the publicId returned by plans.create().`);
|
|
92
92
|
}
|
|
93
93
|
return id;
|
|
94
94
|
}
|
|
95
95
|
function requirePlan(body, operation) {
|
|
96
96
|
const raw = asRecord(asRecord(body)?.plan);
|
|
97
97
|
if (!raw || typeof raw.publicId !== "string" || !raw.publicId) {
|
|
98
|
-
throw new
|
|
98
|
+
throw new GenesisPayConfigError(`GenesisPay ${operation} returned no plan: ${JSON.stringify(body)}`);
|
|
99
99
|
}
|
|
100
100
|
return toSubscriptionPlan(raw);
|
|
101
101
|
}
|
package/dist/plans.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"plans.js","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"plans.js","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { type GenesisPayRequest } from "./resource.js";
|
|
2
|
+
import type { CheckoutLink } from "./client.js";
|
|
3
|
+
export type Product = {
|
|
4
|
+
publicId: string;
|
|
5
|
+
name: string;
|
|
6
|
+
description: string | null;
|
|
7
|
+
imageUrl: string | null;
|
|
8
|
+
sku: string | null;
|
|
9
|
+
asset: "USDC" | "EURC";
|
|
10
|
+
/** Decimal price in `asset`, as the server normalized it (e.g. "2", "0.5"). */
|
|
11
|
+
price: string;
|
|
12
|
+
/** Same price in 6-decimal minor units, as a string (no precision loss). */
|
|
13
|
+
priceMinor: string;
|
|
14
|
+
/**
|
|
15
|
+
* Only an explicit `true` counts — an older backend that omits the field
|
|
16
|
+
* must not read as "archived", and a product this SDK cannot classify must
|
|
17
|
+
* not silently vanish from a catalogue sync.
|
|
18
|
+
*/
|
|
19
|
+
archived: boolean;
|
|
20
|
+
/** Where a paying buyer's entitlement redirects; null until the seller sets it. */
|
|
21
|
+
fulfilmentUrl: string | null;
|
|
22
|
+
fulfilmentVerifiedAt: string | null;
|
|
23
|
+
createdAt: string;
|
|
24
|
+
};
|
|
25
|
+
export type ProductCreateInput = {
|
|
26
|
+
name: string;
|
|
27
|
+
/** Decimal price, e.g. "2" or "2.00" — never a float. */
|
|
28
|
+
price: string;
|
|
29
|
+
description?: string;
|
|
30
|
+
imageUrl?: string;
|
|
31
|
+
/** The merchant's own key; unique per account, a repeat answers 409. */
|
|
32
|
+
sku?: string;
|
|
33
|
+
/** Defaults to USDC (the only settlement asset during the beta). */
|
|
34
|
+
asset?: "USDC";
|
|
35
|
+
};
|
|
36
|
+
export type ProductPaymentLink = {
|
|
37
|
+
/** The product's one canonical reusable link — mint again and you get the same one. */
|
|
38
|
+
link: CheckoutLink;
|
|
39
|
+
/** True only on the call that actually created the link. */
|
|
40
|
+
created: boolean;
|
|
41
|
+
};
|
|
42
|
+
export interface ProductsResource {
|
|
43
|
+
create(input: ProductCreateInput): Promise<Product>;
|
|
44
|
+
/** Active products; pass `includeArchived: true` for the whole catalogue. */
|
|
45
|
+
list(opts?: {
|
|
46
|
+
includeArchived?: boolean;
|
|
47
|
+
}): Promise<Product[]>;
|
|
48
|
+
retrieve(publicId: string): Promise<Product>;
|
|
49
|
+
/**
|
|
50
|
+
* Set or clear (`null`) the https fulfilment URL — where a paying buyer's
|
|
51
|
+
* entitlement redirects. Changing it resets the server's verification stamp.
|
|
52
|
+
*/
|
|
53
|
+
update(publicId: string, input: {
|
|
54
|
+
fulfilmentUrl: string | null;
|
|
55
|
+
}): Promise<Product>;
|
|
56
|
+
/**
|
|
57
|
+
* Stops NEW payment-link mints; the existing canonical link stays payable
|
|
58
|
+
* (a buyer mid-checkout is not punished for a catalogue edit). Archiving
|
|
59
|
+
* twice is a no-op that returns the same product.
|
|
60
|
+
*/
|
|
61
|
+
archive(publicId: string): Promise<Product>;
|
|
62
|
+
/**
|
|
63
|
+
* Mint the product's canonical reusable payment link, or return the existing
|
|
64
|
+
* one with `created: false`. Idempotent by construction: the one-live-link
|
|
65
|
+
* rule is a database unique index, so even concurrent mints converge on the
|
|
66
|
+
* same link.
|
|
67
|
+
*/
|
|
68
|
+
createPaymentLink(publicId: string): Promise<ProductPaymentLink>;
|
|
69
|
+
}
|
|
70
|
+
export declare function createProductsResource(request: GenesisPayRequest,
|
|
71
|
+
/**
|
|
72
|
+
* Applies the client's `expectedPayTo` pin to the wallet the server froze
|
|
73
|
+
* onto the minted link — the destination every sale of this product settles
|
|
74
|
+
* to, which is exactly the value the pin exists to guard.
|
|
75
|
+
*/
|
|
76
|
+
assertPinnedDestination: ((wallet: unknown, what: string) => void) | undefined,
|
|
77
|
+
/** The client's raw-link mapper, so link shapes cannot drift between resources. */
|
|
78
|
+
toLink: (raw: Record<string, unknown>) => CheckoutLink): ProductsResource;
|
|
79
|
+
export declare function toProduct(raw: Record<string, unknown>): Product;
|
|
80
|
+
//# sourceMappingURL=products.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../src/products.ts"],"names":[],"mappings":"AAWA,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,mFAAmF;IACnF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uFAAuF;IACvF,IAAI,EAAE,YAAY,CAAC;IACnB,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,6EAA6E;IAC7E,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB;AAC1B;;;;GAIG;AACH,uBAAuB,GAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,aAAW;AAC3E,mFAAmF;AACnF,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,YAAY,GACrD,gBAAgB,CA6GlB;AA6BD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAe/D"}
|
package/dist/products.js
ADDED
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
// `genesispay.products.*` — the merchant's catalogue over `/api/v1/products`.
|
|
2
|
+
//
|
|
3
|
+
// A product is what a shop sells; its payable instance is one CANONICAL
|
|
4
|
+
// reusable checkout link, minted (idempotently) with `createPaymentLink`. The
|
|
5
|
+
// price and asset are copied onto the link at mint and never re-read from the
|
|
6
|
+
// catalogue, so editing or archiving a product cannot change what a buyer
|
|
7
|
+
// already sees. Everything is scoped to the key's own account: someone else's
|
|
8
|
+
// product answers 404 (GenesisPayNotFoundError), never 403 — the API is no
|
|
9
|
+
// catalogue-enumeration oracle, and the SDK does not paper over that.
|
|
10
|
+
import { GenesisPayConfigError } from "./errors.js";
|
|
11
|
+
import { asRecord, optionalString, requiredString, toAmountString, oneOf, } from "./resource.js";
|
|
12
|
+
export function createProductsResource(request,
|
|
13
|
+
/**
|
|
14
|
+
* Applies the client's `expectedPayTo` pin to the wallet the server froze
|
|
15
|
+
* onto the minted link — the destination every sale of this product settles
|
|
16
|
+
* to, which is exactly the value the pin exists to guard.
|
|
17
|
+
*/
|
|
18
|
+
assertPinnedDestination = () => { },
|
|
19
|
+
/** The client's raw-link mapper, so link shapes cannot drift between resources. */
|
|
20
|
+
toLink) {
|
|
21
|
+
return {
|
|
22
|
+
create: async (input) => {
|
|
23
|
+
const body = await request({
|
|
24
|
+
method: "POST",
|
|
25
|
+
path: "/api/v1/products",
|
|
26
|
+
operation: "POST /api/v1/products",
|
|
27
|
+
action: "create a product",
|
|
28
|
+
body: {
|
|
29
|
+
name: input.name,
|
|
30
|
+
price: input.price,
|
|
31
|
+
...(input.description ? { description: input.description } : {}),
|
|
32
|
+
...(input.imageUrl ? { imageUrl: input.imageUrl } : {}),
|
|
33
|
+
...(input.sku ? { sku: input.sku } : {}),
|
|
34
|
+
...(input.asset ? { asset: input.asset } : {}),
|
|
35
|
+
},
|
|
36
|
+
});
|
|
37
|
+
return requireProduct(body, "POST /api/v1/products");
|
|
38
|
+
},
|
|
39
|
+
list: async (opts) => {
|
|
40
|
+
const query = opts?.includeArchived ? "?includeArchived=true" : "";
|
|
41
|
+
const body = await request({
|
|
42
|
+
path: `/api/v1/products${query}`,
|
|
43
|
+
operation: "GET /api/v1/products",
|
|
44
|
+
action: "list products",
|
|
45
|
+
});
|
|
46
|
+
const products = asRecord(body)?.products;
|
|
47
|
+
if (!Array.isArray(products)) {
|
|
48
|
+
// A list endpoint that answers 200 without a list is a broken
|
|
49
|
+
// contract, not an old backend. Returning [] would hide it as "no
|
|
50
|
+
// products yet".
|
|
51
|
+
throw new GenesisPayConfigError(`GenesisPay GET /api/v1/products returned no products array: ${JSON.stringify(body)}`);
|
|
52
|
+
}
|
|
53
|
+
// Individual entries stay tolerant: one unusable row must not lose the rest.
|
|
54
|
+
return products
|
|
55
|
+
.map(asRecord)
|
|
56
|
+
.filter((raw) => raw !== null)
|
|
57
|
+
.filter((raw) => typeof raw.publicId === "string" && raw.publicId.length > 0)
|
|
58
|
+
.map(toProduct);
|
|
59
|
+
},
|
|
60
|
+
retrieve: async (publicId) => {
|
|
61
|
+
const id = requirePublicId(publicId, "products.retrieve");
|
|
62
|
+
const body = await request({
|
|
63
|
+
path: `/api/v1/products/${encodeURIComponent(id)}`,
|
|
64
|
+
operation: `GET /api/v1/products/${id}`,
|
|
65
|
+
action: `retrieve product "${id}"`,
|
|
66
|
+
notFoundMessage: notFoundMessage(id),
|
|
67
|
+
});
|
|
68
|
+
return requireProduct(body, `GET /api/v1/products/${id}`);
|
|
69
|
+
},
|
|
70
|
+
update: async (publicId, input) => {
|
|
71
|
+
const id = requirePublicId(publicId, "products.update");
|
|
72
|
+
const body = await request({
|
|
73
|
+
method: "PATCH",
|
|
74
|
+
path: `/api/v1/products/${encodeURIComponent(id)}`,
|
|
75
|
+
operation: `PATCH /api/v1/products/${id}`,
|
|
76
|
+
action: `update product "${id}"`,
|
|
77
|
+
notFoundMessage: notFoundMessage(id),
|
|
78
|
+
body: { fulfilmentUrl: input.fulfilmentUrl },
|
|
79
|
+
});
|
|
80
|
+
return requireProduct(body, `PATCH /api/v1/products/${id}`);
|
|
81
|
+
},
|
|
82
|
+
archive: async (publicId) => {
|
|
83
|
+
const id = requirePublicId(publicId, "products.archive");
|
|
84
|
+
const body = await request({
|
|
85
|
+
method: "POST",
|
|
86
|
+
path: `/api/v1/products/${encodeURIComponent(id)}/archive`,
|
|
87
|
+
operation: `POST /api/v1/products/${id}/archive`,
|
|
88
|
+
action: `archive product "${id}"`,
|
|
89
|
+
notFoundMessage: notFoundMessage(id),
|
|
90
|
+
});
|
|
91
|
+
return requireProduct(body, `POST /api/v1/products/${id}/archive`);
|
|
92
|
+
},
|
|
93
|
+
createPaymentLink: async (publicId) => {
|
|
94
|
+
const id = requirePublicId(publicId, "products.createPaymentLink");
|
|
95
|
+
const body = await request({
|
|
96
|
+
method: "POST",
|
|
97
|
+
path: `/api/v1/products/${encodeURIComponent(id)}/payment-link`,
|
|
98
|
+
operation: `POST /api/v1/products/${id}/payment-link`,
|
|
99
|
+
action: `mint the payment link for product "${id}"`,
|
|
100
|
+
notFoundMessage: notFoundMessage(id),
|
|
101
|
+
hint: (status) => status === 409
|
|
102
|
+
? "An archived product mints no new links, and selling needs a receiving wallet on the account."
|
|
103
|
+
: undefined,
|
|
104
|
+
});
|
|
105
|
+
const record = asRecord(body);
|
|
106
|
+
const rawLink = asRecord(record?.link);
|
|
107
|
+
if (!rawLink || typeof rawLink.publicId !== "string" || !rawLink.publicId) {
|
|
108
|
+
throw new GenesisPayConfigError(`GenesisPay POST /api/v1/products/${id}/payment-link returned no link: ${JSON.stringify(body)}`);
|
|
109
|
+
}
|
|
110
|
+
assertPinnedDestination(rawLink.destinationWallet, "product payment link");
|
|
111
|
+
return {
|
|
112
|
+
link: toLink(rawLink),
|
|
113
|
+
// Only an explicit true: a proxy that drops the field must not report
|
|
114
|
+
// every idempotent re-mint as a fresh link.
|
|
115
|
+
created: record?.created === true,
|
|
116
|
+
};
|
|
117
|
+
},
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
function notFoundMessage(id) {
|
|
121
|
+
return (`No GenesisPay product with publicId "${id}". Check the id and that it ` +
|
|
122
|
+
`belongs to the account this API key authenticates.`);
|
|
123
|
+
}
|
|
124
|
+
function requirePublicId(publicId, method) {
|
|
125
|
+
const id = publicId?.trim();
|
|
126
|
+
if (!id) {
|
|
127
|
+
throw new GenesisPayConfigError(`${method}(publicId) requires the publicId returned by products.create().`);
|
|
128
|
+
}
|
|
129
|
+
return id;
|
|
130
|
+
}
|
|
131
|
+
function requireProduct(body, operation) {
|
|
132
|
+
const raw = asRecord(asRecord(body)?.product);
|
|
133
|
+
if (!raw || typeof raw.publicId !== "string" || !raw.publicId) {
|
|
134
|
+
throw new GenesisPayConfigError(`GenesisPay ${operation} returned no product: ${JSON.stringify(body)}`);
|
|
135
|
+
}
|
|
136
|
+
return toProduct(raw);
|
|
137
|
+
}
|
|
138
|
+
export function toProduct(raw) {
|
|
139
|
+
return {
|
|
140
|
+
publicId: requiredString(raw.publicId),
|
|
141
|
+
name: requiredString(raw.name),
|
|
142
|
+
description: optionalString(raw.description),
|
|
143
|
+
imageUrl: optionalString(raw.imageUrl),
|
|
144
|
+
sku: optionalString(raw.sku),
|
|
145
|
+
asset: oneOf(raw.asset, ["USDC", "EURC"], "USDC"),
|
|
146
|
+
price: toAmountString(raw.price),
|
|
147
|
+
priceMinor: toAmountString(raw.priceMinor),
|
|
148
|
+
archived: raw.archived === true,
|
|
149
|
+
fulfilmentUrl: optionalString(raw.fulfilmentUrl),
|
|
150
|
+
fulfilmentVerifiedAt: optionalString(raw.fulfilmentVerifiedAt),
|
|
151
|
+
createdAt: requiredString(raw.createdAt),
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
//# sourceMappingURL=products.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"products.js","sourceRoot":"","sources":["../src/products.ts"],"names":[],"mappings":"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"}
|
package/dist/resource.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export type
|
|
1
|
+
export type GenesisPayRequestOptions = {
|
|
2
2
|
/** Defaults to GET. */
|
|
3
3
|
method?: "GET" | "POST" | "PATCH";
|
|
4
4
|
/** Path starting with "/", already percent-encoded. */
|
|
@@ -24,7 +24,7 @@ export type PeerPayRequestOptions = {
|
|
|
24
24
|
action: string;
|
|
25
25
|
};
|
|
26
26
|
/** The client's bound request function, as a resource module sees it. */
|
|
27
|
-
export type
|
|
27
|
+
export type GenesisPayRequest = (options: GenesisPayRequestOptions) => Promise<unknown>;
|
|
28
28
|
/** A non-null, non-array object, or null — the shape a mapper can read fields off. */
|
|
29
29
|
export declare function asRecord(value: unknown): Record<string, unknown> | null;
|
|
30
30
|
export declare function optionalString(value: unknown): string | null;
|
package/dist/resource.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,
|
|
1
|
+
{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,wBAAwB,GAAG;IACrC,uBAAuB;IACvB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IACzD;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAExF,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAM9E;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,QAAQ,EAAE,CAAC,GACV,CAAC,CAIH;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG9C;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI3D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIrD;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIlE"}
|
package/dist/resource.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
// one HTTP seam and one set of tolerant wire mappers.
|
|
3
3
|
//
|
|
4
4
|
// The seam exists so a resource module never touches `fetch`, the API key or
|
|
5
|
-
// the base URL — the client owns those and hands down a bound `
|
|
5
|
+
// the base URL — the client owns those and hands down a bound `GenesisPayRequest`.
|
|
6
6
|
// That keeps the error mapping in exactly one place (`throwForErrorResponse`,
|
|
7
7
|
// see ./errors.ts): a resource that built its own request could quietly grow a
|
|
8
8
|
// second, divergent notion of what a 422 means.
|
package/dist/resource.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,sDAAsD;AACtD,EAAE;AACF,6EAA6E;AAC7E,
|
|
1
|
+
{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"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"}
|
package/dist/webhooks.d.ts
CHANGED
|
@@ -5,15 +5,15 @@
|
|
|
5
5
|
* the server grows a type this list does not have.
|
|
6
6
|
*
|
|
7
7
|
* Exported as a runtime array (not only as a type) so a handler can ask
|
|
8
|
-
* `
|
|
8
|
+
* `isKnownGenesisPayEventType(event.type)` before it decides what to do.
|
|
9
9
|
*/
|
|
10
|
-
export declare const
|
|
10
|
+
export declare const GENESISPAY_EVENT_TYPES: readonly ["payment.confirmed", "link.paid", "product.purchased", "agent_payment.pending_approval", "agent_payment.settled", "mandate.active", "mandate.charged", "mandate.charge_failed", "mandate.revoked", "subscription.renewed", "subscription.past_due"];
|
|
11
11
|
/** Union of the event types this SDK version knows. */
|
|
12
|
-
export type
|
|
12
|
+
export type GenesisPayEventType = (typeof GENESISPAY_EVENT_TYPES)[number];
|
|
13
13
|
/** True when `type` is an event type this SDK version knows about. */
|
|
14
|
-
export declare function
|
|
14
|
+
export declare function isKnownGenesisPayEventType(type: string): type is GenesisPayEventType;
|
|
15
15
|
/** Shared envelope; `type`/`data` are pinned per event by the union below. */
|
|
16
|
-
type
|
|
16
|
+
type GenesisPayEventEnvelope<TType extends string, TData> = {
|
|
17
17
|
/** Stable across delivery retries — the idempotency key to dedupe on. */
|
|
18
18
|
id: string;
|
|
19
19
|
type: TType;
|
|
@@ -25,7 +25,7 @@ type PeerPayEventEnvelope<TType extends string, TData> = {
|
|
|
25
25
|
* `PaymentWebhookEventPayload`; amounts stay strings (minor units are `bigint`
|
|
26
26
|
* on the server and would lose precision as a JSON number).
|
|
27
27
|
*/
|
|
28
|
-
export type
|
|
28
|
+
export type GenesisPayPaymentEventData = {
|
|
29
29
|
link: {
|
|
30
30
|
publicId: string;
|
|
31
31
|
title: string;
|
|
@@ -135,7 +135,7 @@ export type PeerPayPaymentEventData = {
|
|
|
135
135
|
occurredAt: string;
|
|
136
136
|
};
|
|
137
137
|
/** `data` of the mandate/subscription events; mirrors `buildMandateWebhookPayload`. */
|
|
138
|
-
export type
|
|
138
|
+
export type GenesisPayMandateEventData = {
|
|
139
139
|
mandate: {
|
|
140
140
|
id: string;
|
|
141
141
|
kind: string;
|
|
@@ -189,19 +189,19 @@ export type PeerPayMandateEventData = {
|
|
|
189
189
|
} | null;
|
|
190
190
|
occurredAt: string;
|
|
191
191
|
};
|
|
192
|
-
export type
|
|
193
|
-
export type
|
|
192
|
+
export type GenesisPayPaymentEvent = GenesisPayEventEnvelope<"payment.confirmed" | "link.paid", GenesisPayPaymentEventData>;
|
|
193
|
+
export type GenesisPayMandateEvent = GenesisPayEventEnvelope<"mandate.active" | "mandate.charged" | "mandate.charge_failed" | "mandate.revoked" | "subscription.renewed" | "subscription.past_due", GenesisPayMandateEventData>;
|
|
194
194
|
/**
|
|
195
195
|
* Agent-payment events are reserved on the server but have no emitter yet, so
|
|
196
196
|
* their payload is deliberately left open rather than invented here.
|
|
197
197
|
*/
|
|
198
|
-
export type
|
|
198
|
+
export type GenesisPayAgentPaymentEvent = GenesisPayEventEnvelope<"agent_payment.pending_approval" | "agent_payment.settled", Record<string, unknown>>;
|
|
199
199
|
/**
|
|
200
200
|
* An event type this SDK version does not know — a newer server talking to an
|
|
201
201
|
* older SDK. It is a *valid* event: `constructEvent` verifies and returns it
|
|
202
|
-
* like any other (see `
|
|
202
|
+
* like any other (see `GenesisPayAnyEvent`), it never throws on the type.
|
|
203
203
|
*/
|
|
204
|
-
export type
|
|
204
|
+
export type GenesisPayUnknownEvent = GenesisPayEventEnvelope<string, Record<string, unknown>>;
|
|
205
205
|
/**
|
|
206
206
|
* Verified webhook delivery, discriminated on `type`:
|
|
207
207
|
*
|
|
@@ -216,26 +216,26 @@ export type PeerPayUnknownEvent = PeerPayEventEnvelope<string, Record<string, un
|
|
|
216
216
|
* one member with a plain `string` type and `event.type === "payment.confirmed"`
|
|
217
217
|
* stops narrowing `data` for all the others too — the exact regression R1 sets
|
|
218
218
|
* out to fix. Forward compatibility therefore lives at runtime (an unknown type
|
|
219
|
-
* is verified and returned, never rejected) plus in `
|
|
220
|
-
* `
|
|
219
|
+
* is verified and returned, never rejected) plus in `GenesisPayAnyEvent` /
|
|
220
|
+
* `GenesisPayUnknownEvent` for handlers that want to model the open world:
|
|
221
221
|
*
|
|
222
222
|
* ```ts
|
|
223
|
-
* const any:
|
|
224
|
-
* if (!
|
|
223
|
+
* const any: GenesisPayAnyEvent = event; // widens, no cast needed
|
|
224
|
+
* if (!isKnownGenesisPayEventType(any.type)) return new Response("ok"); // ack & ignore
|
|
225
225
|
* ```
|
|
226
226
|
*/
|
|
227
|
-
export type
|
|
227
|
+
export type GenesisPayEvent = GenesisPayPaymentEvent | GenesisPayMandateEvent | GenesisPayAgentPaymentEvent;
|
|
228
228
|
/**
|
|
229
229
|
* Open-world view of a delivery: every known event widens to it, and it is the
|
|
230
230
|
* honest type for an event whose `type` this SDK version does not know.
|
|
231
231
|
*/
|
|
232
|
-
export type
|
|
232
|
+
export type GenesisPayAnyEvent = GenesisPayEvent | GenesisPayUnknownEvent;
|
|
233
233
|
/**
|
|
234
234
|
* Thrown for every rejection path: malformed/missing header, missing `t`/`v1`,
|
|
235
235
|
* timestamp outside the tolerance window, signature mismatch, non-JSON body.
|
|
236
236
|
* Messages never contain the secret or the expected signature.
|
|
237
237
|
*/
|
|
238
|
-
export declare class
|
|
238
|
+
export declare class GenesisPaySignatureVerificationError extends Error {
|
|
239
239
|
constructor(message: string);
|
|
240
240
|
}
|
|
241
241
|
export type ConstructEventOptions = {
|
|
@@ -255,23 +255,23 @@ export type ConstructEventOptions = {
|
|
|
255
255
|
* delivery is verified and returned unchanged, so a server that adds a new
|
|
256
256
|
* event type can never turn a customer's webhook route into a 400. Only the
|
|
257
257
|
* signature and the envelope (`id`, `type`, `createdAt`, object `data`) can
|
|
258
|
-
* reject a delivery. Widen to `
|
|
259
|
-
* `
|
|
258
|
+
* reject a delivery. Widen to `GenesisPayAnyEvent` and use
|
|
259
|
+
* `isKnownGenesisPayEventType()` if you want to handle that case explicitly.
|
|
260
260
|
*
|
|
261
|
-
* @throws {
|
|
261
|
+
* @throws {GenesisPaySignatureVerificationError} on any verification failure.
|
|
262
262
|
*
|
|
263
263
|
* @example
|
|
264
264
|
* ```ts
|
|
265
265
|
* const event = await constructEvent(
|
|
266
266
|
* await request.text(),
|
|
267
|
-
* request.headers.get("
|
|
268
|
-
* process.env.
|
|
267
|
+
* request.headers.get("genesispay-signature") ?? "",
|
|
268
|
+
* process.env.GENESISPAY_WEBHOOK_SECRET!,
|
|
269
269
|
* );
|
|
270
270
|
* if (event.type === "payment.confirmed") {
|
|
271
271
|
* fulfil(event.data.link.clientReferenceId, event.data.attempt.txHash);
|
|
272
272
|
* }
|
|
273
273
|
* ```
|
|
274
274
|
*/
|
|
275
|
-
export declare function constructEvent(rawBody: string | Uint8Array, signatureHeader: string, secret: string, opts?: ConstructEventOptions): Promise<
|
|
275
|
+
export declare function constructEvent(rawBody: string | Uint8Array, signatureHeader: string, secret: string, opts?: ConstructEventOptions): Promise<GenesisPayEvent>;
|
|
276
276
|
export {};
|
|
277
277
|
//# sourceMappingURL=webhooks.d.ts.map
|
package/dist/webhooks.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,eAAO,MAAM,
|
|
1
|
+
{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"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"}
|