@pithy-sh/payments 0.3.10 → 0.5.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.
Files changed (215) hide show
  1. package/README.md +11 -3
  2. package/dist/admin/coverage.d.ts.map +1 -1
  3. package/dist/admin/coverage.js +26 -2
  4. package/dist/admin/read.d.ts +48 -1
  5. package/dist/admin/read.d.ts.map +1 -1
  6. package/dist/admin/read.js +89 -2
  7. package/dist/audit/actions.d.ts +13 -0
  8. package/dist/audit/actions.d.ts.map +1 -1
  9. package/dist/audit/actions.js +14 -1
  10. package/dist/capability.d.ts +33 -2
  11. package/dist/capability.d.ts.map +1 -1
  12. package/dist/capability.js +52 -9
  13. package/dist/client/api.d.ts +38 -0
  14. package/dist/client/api.d.ts.map +1 -1
  15. package/dist/client/api.js +59 -1
  16. package/dist/client/hooks.d.ts +63 -1
  17. package/dist/client/hooks.d.ts.map +1 -1
  18. package/dist/client/hooks.js +96 -2
  19. package/dist/client/paddleLink.d.ts +31 -0
  20. package/dist/client/paddleLink.d.ts.map +1 -0
  21. package/dist/client/paddleLink.js +37 -0
  22. package/dist/client/projection.d.ts +29 -0
  23. package/dist/client/projection.d.ts.map +1 -1
  24. package/dist/config/allowances.d.ts +71 -0
  25. package/dist/config/allowances.d.ts.map +1 -0
  26. package/dist/config/allowances.js +115 -0
  27. package/dist/config/config.d.ts +155 -9
  28. package/dist/config/config.d.ts.map +1 -1
  29. package/dist/config/config.js +164 -14
  30. package/dist/data/meterCounter.d.ts +34 -0
  31. package/dist/data/meterCounter.d.ts.map +1 -0
  32. package/dist/data/meterCounter.js +33 -0
  33. package/dist/data/override.d.ts +56 -0
  34. package/dist/data/override.d.ts.map +1 -0
  35. package/dist/data/override.js +58 -0
  36. package/dist/data/paddleIds.d.ts +28 -0
  37. package/dist/data/paddleIds.d.ts.map +1 -0
  38. package/dist/data/paddleIds.js +73 -0
  39. package/dist/data/period.d.ts +10 -0
  40. package/dist/data/period.d.ts.map +1 -0
  41. package/dist/data/period.js +37 -0
  42. package/dist/data/purchase.d.ts +1 -0
  43. package/dist/data/purchase.d.ts.map +1 -1
  44. package/dist/data/purchase.js +1 -0
  45. package/dist/data/tables.d.ts +17 -1
  46. package/dist/data/tables.d.ts.map +1 -1
  47. package/dist/data/tables.js +24 -4
  48. package/dist/data/usageReport.d.ts +68 -0
  49. package/dist/data/usageReport.d.ts.map +1 -0
  50. package/dist/data/usageReport.js +55 -0
  51. package/dist/data/usageRun.d.ts +93 -0
  52. package/dist/data/usageRun.d.ts.map +1 -0
  53. package/dist/data/usageRun.js +50 -0
  54. package/dist/entitlement/allowance.d.ts +100 -0
  55. package/dist/entitlement/allowance.d.ts.map +1 -0
  56. package/dist/entitlement/allowance.js +171 -0
  57. package/dist/entitlement/manual.d.ts +5 -5
  58. package/dist/entitlement/manual.js +3 -3
  59. package/dist/entitlement/meter.d.ts +98 -0
  60. package/dist/entitlement/meter.d.ts.map +1 -0
  61. package/dist/entitlement/meter.js +177 -0
  62. package/dist/entitlement/override.d.ts +119 -0
  63. package/dist/entitlement/override.d.ts.map +1 -0
  64. package/dist/entitlement/override.js +256 -0
  65. package/dist/entitlement/resolver.d.ts +2 -1
  66. package/dist/entitlement/resolver.d.ts.map +1 -1
  67. package/dist/entitlement/resolver.js +32 -1
  68. package/dist/entitlement/unimplementedSubject.d.ts.map +1 -1
  69. package/dist/entitlement/unimplementedSubject.js +3 -2
  70. package/dist/error/errors.d.ts +19 -0
  71. package/dist/error/errors.d.ts.map +1 -1
  72. package/dist/error/errors.js +35 -2
  73. package/dist/http/responses.d.ts +390 -5
  74. package/dist/http/responses.d.ts.map +1 -1
  75. package/dist/http/responses.js +169 -13
  76. package/dist/http/routes.d.ts +6 -2
  77. package/dist/http/routes.d.ts.map +1 -1
  78. package/dist/http/routes.js +478 -52
  79. package/dist/http/schemas.d.ts +75 -1
  80. package/dist/http/schemas.d.ts.map +1 -1
  81. package/dist/http/schemas.js +80 -3
  82. package/dist/http/scopes.d.ts +25 -0
  83. package/dist/http/scopes.d.ts.map +1 -1
  84. package/dist/http/scopes.js +60 -1
  85. package/dist/http/view.d.ts +22 -4
  86. package/dist/http/view.d.ts.map +1 -1
  87. package/dist/http/view.js +88 -7
  88. package/dist/http/webhookGuard.d.ts.map +1 -1
  89. package/dist/http/webhookGuard.js +1 -1
  90. package/dist/index.d.ts +2 -1
  91. package/dist/index.d.ts.map +1 -1
  92. package/dist/index.js +3 -2
  93. package/dist/migrations/0002_allowances.d.ts +26 -0
  94. package/dist/migrations/0002_allowances.d.ts.map +1 -0
  95. package/dist/migrations/0002_allowances.js +62 -0
  96. package/dist/peer.d.ts +1 -0
  97. package/dist/peer.d.ts.map +1 -1
  98. package/dist/projection/event.d.ts +1 -0
  99. package/dist/projection/event.d.ts.map +1 -1
  100. package/dist/projection/event.js +1 -0
  101. package/dist/projection/writer.d.ts.map +1 -1
  102. package/dist/projection/writer.js +3 -1
  103. package/dist/rails/contract.d.ts +6 -0
  104. package/dist/rails/contract.d.ts.map +1 -1
  105. package/dist/rails/google/playApi.d.ts.map +1 -1
  106. package/dist/rails/google/playApi.js +2 -0
  107. package/dist/rails/paddle/events.d.ts.map +1 -1
  108. package/dist/rails/paddle/events.js +2 -1
  109. package/dist/rails/paddle/objects.d.ts +2 -0
  110. package/dist/rails/paddle/objects.d.ts.map +1 -1
  111. package/dist/rails/paddle/objects.js +7 -2
  112. package/dist/rails/paddle/refresh.d.ts +10 -5
  113. package/dist/rails/paddle/refresh.d.ts.map +1 -1
  114. package/dist/rails/paddle/refresh.js +8 -5
  115. package/dist/rails/paddle/refund.d.ts.map +1 -1
  116. package/dist/rails/paddle/refund.js +10 -2
  117. package/dist/rails/paddle/subscription.d.ts.map +1 -1
  118. package/dist/rails/paddle/subscription.js +8 -3
  119. package/dist/rails/paddle/usage.d.ts +11 -0
  120. package/dist/rails/paddle/usage.d.ts.map +1 -0
  121. package/dist/rails/paddle/usage.js +49 -0
  122. package/dist/rails/paddle/verify.d.ts.map +1 -1
  123. package/dist/rails/paddle/verify.js +2 -3
  124. package/dist/rails/quantity.d.ts +12 -0
  125. package/dist/rails/quantity.d.ts.map +1 -0
  126. package/dist/rails/quantity.js +16 -0
  127. package/dist/rails/stripe/checkout.d.ts.map +1 -1
  128. package/dist/rails/stripe/checkout.js +1 -1
  129. package/dist/rails/stripe/objects.d.ts.map +1 -1
  130. package/dist/rails/stripe/objects.js +3 -0
  131. package/dist/rails/stripe/usage.d.ts +10 -0
  132. package/dist/rails/stripe/usage.d.ts.map +1 -0
  133. package/dist/rails/stripe/usage.js +49 -0
  134. package/dist/secret/registry.d.ts.map +1 -1
  135. package/dist/secret/registry.js +3 -2
  136. package/dist/usage/pass.d.ts +120 -0
  137. package/dist/usage/pass.d.ts.map +1 -0
  138. package/dist/usage/pass.js +363 -0
  139. package/dist/usage/reporter.d.ts +36 -0
  140. package/dist/usage/reporter.d.ts.map +1 -0
  141. package/dist/usage/reporter.js +2 -0
  142. package/dist/version.generated.d.ts +1 -1
  143. package/dist/version.generated.d.ts.map +1 -1
  144. package/dist/version.generated.js +1 -1
  145. package/dist/workflows/specs.d.ts +28 -0
  146. package/dist/workflows/specs.d.ts.map +1 -1
  147. package/dist/workflows/specs.js +26 -1
  148. package/dist/workflows/usage.d.ts +38 -0
  149. package/dist/workflows/usage.d.ts.map +1 -0
  150. package/dist/workflows/usage.js +77 -0
  151. package/dist/workflows/worker.js +2 -2
  152. package/dist/workflows/workerConfig.d.ts.map +1 -1
  153. package/dist/workflows/workerConfig.js +8 -2
  154. package/docs/entitlements.md +249 -0
  155. package/docs/lemon-squeezy.md +1 -0
  156. package/docs/paddle.md +18 -2
  157. package/package.json +7 -7
  158. package/pithy.manifest.json +3 -8
  159. package/src/admin/coverage.ts +28 -0
  160. package/src/admin/read.ts +173 -1
  161. package/src/audit/actions.ts +13 -0
  162. package/src/capability.ts +87 -9
  163. package/src/client/api.ts +79 -0
  164. package/src/client/hooks.ts +122 -0
  165. package/src/client/paddleLink.ts +41 -0
  166. package/src/client/projection.ts +31 -0
  167. package/src/config/allowances.ts +211 -0
  168. package/src/config/config.ts +283 -15
  169. package/src/data/meterCounter.ts +38 -0
  170. package/src/data/override.ts +74 -0
  171. package/src/data/paddleIds.ts +74 -0
  172. package/src/data/period.ts +53 -0
  173. package/src/data/purchase.ts +9 -0
  174. package/src/data/tables.ts +25 -1
  175. package/src/data/usageReport.ts +64 -0
  176. package/src/data/usageRun.ts +66 -0
  177. package/src/entitlement/allowance.ts +213 -0
  178. package/src/entitlement/manual.ts +6 -6
  179. package/src/entitlement/meter.ts +252 -0
  180. package/src/entitlement/override.ts +381 -0
  181. package/src/entitlement/resolver.ts +43 -2
  182. package/src/entitlement/unimplementedSubject.ts +3 -4
  183. package/src/error/errors.ts +44 -1
  184. package/src/http/responses.ts +338 -10
  185. package/src/http/routes.ts +1089 -460
  186. package/src/http/schemas.ts +171 -2
  187. package/src/http/scopes.ts +68 -0
  188. package/src/http/view.ts +112 -7
  189. package/src/http/webhookGuard.ts +3 -2
  190. package/src/index.ts +18 -0
  191. package/src/migrations/0002_allowances.ts +149 -0
  192. package/src/projection/event.ts +9 -0
  193. package/src/projection/writer.ts +4 -0
  194. package/src/rails/contract.ts +6 -0
  195. package/src/rails/google/playApi.ts +2 -0
  196. package/src/rails/paddle/events.ts +2 -1
  197. package/src/rails/paddle/fixtures/subscription-charge.json +19 -0
  198. package/src/rails/paddle/objects.ts +6 -0
  199. package/src/rails/paddle/refresh.ts +17 -10
  200. package/src/rails/paddle/refund.ts +10 -2
  201. package/src/rails/paddle/subscription.ts +8 -3
  202. package/src/rails/paddle/usage.ts +66 -0
  203. package/src/rails/paddle/verify.ts +6 -4
  204. package/src/rails/quantity.ts +14 -0
  205. package/src/rails/stripe/checkout.ts +3 -1
  206. package/src/rails/stripe/fixtures/meter-event-created.json +12 -0
  207. package/src/rails/stripe/objects.ts +4 -0
  208. package/src/rails/stripe/usage.ts +61 -0
  209. package/src/secret/registry.ts +3 -2
  210. package/src/usage/pass.ts +539 -0
  211. package/src/usage/reporter.ts +38 -0
  212. package/src/version.generated.ts +1 -1
  213. package/src/workflows/specs.ts +34 -0
  214. package/src/workflows/usage.ts +97 -0
  215. package/src/workflows/workerConfig.ts +9 -3
@@ -0,0 +1,93 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import { z } from "zod";
4
+ /**
5
+ * Why a subject was not reported on one run. Each is counted and named, and none is ever turned into a
6
+ * number: a skip bills last period's number and leaves a line an operator can act on, where a guess bills a
7
+ * wrong one silently.
8
+ */
9
+ export declare const UsageFindingReason: z.ZodEnum<{
10
+ above_max: "above_max";
11
+ below_min: "below_min";
12
+ negative: "negative";
13
+ not_integer: "not_integer";
14
+ report_failed: "report_failed";
15
+ resolver_failed: "resolver_failed";
16
+ unanswered: "unanswered";
17
+ }>;
18
+ export type UsageFindingReason = z.infer<typeof UsageFindingReason>;
19
+ /** One subject a run did not report, and why. */
20
+ export declare const UsageFinding: z.ZodObject<{
21
+ subjectType: z.ZodEnum<{
22
+ organization: "organization";
23
+ user: "user";
24
+ }>;
25
+ subjectId: z.ZodString;
26
+ productId: z.ZodString;
27
+ reason: z.ZodEnum<{
28
+ above_max: "above_max";
29
+ below_min: "below_min";
30
+ negative: "negative";
31
+ not_integer: "not_integer";
32
+ report_failed: "report_failed";
33
+ resolver_failed: "resolver_failed";
34
+ unanswered: "unanswered";
35
+ }>;
36
+ }, z.core.$strip>;
37
+ export type UsageFinding = z.infer<typeof UsageFinding>;
38
+ /** The most findings one run keeps by name. The counts are always whole; the names are a sample past this. */
39
+ export declare const MAX_USAGE_FINDINGS = 100;
40
+ /**
41
+ * One usage-reporting pass, kept — the row in `pithy_payments_usage_runs`. The same shape and the same
42
+ * reason as `pithy_payments_reconcile_runs`: a silent job and a job that is not running look identical, and
43
+ * a run that reported nothing is the answer to "is it healthy".
44
+ */
45
+ export declare const PaymentsUsageRun: z.ZodObject<{
46
+ id: z.ZodString;
47
+ startedAt: z.ZodCodec<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodDate]>, z.ZodDate>;
48
+ finishedAt: z.ZodCodec<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodDate]>, z.ZodDate>;
49
+ scanned: z.ZodNumber;
50
+ reported: z.ZodNumber;
51
+ sampled: z.ZodNumber;
52
+ alreadyReported: z.ZodNumber;
53
+ skipped: z.ZodNumber;
54
+ invalid: z.ZodNumber;
55
+ failed: z.ZodNumber;
56
+ findings: z.ZodCodec<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodObject<{
57
+ subjectType: z.ZodEnum<{
58
+ organization: "organization";
59
+ user: "user";
60
+ }>;
61
+ subjectId: z.ZodString;
62
+ productId: z.ZodString;
63
+ reason: z.ZodEnum<{
64
+ above_max: "above_max";
65
+ below_min: "below_min";
66
+ negative: "negative";
67
+ not_integer: "not_integer";
68
+ report_failed: "report_failed";
69
+ resolver_failed: "resolver_failed";
70
+ unanswered: "unanswered";
71
+ }>;
72
+ }, z.core.$strip>>]>, z.ZodArray<z.ZodObject<{
73
+ subjectType: z.ZodEnum<{
74
+ organization: "organization";
75
+ user: "user";
76
+ }>;
77
+ subjectId: z.ZodString;
78
+ productId: z.ZodString;
79
+ reason: z.ZodEnum<{
80
+ above_max: "above_max";
81
+ below_min: "below_min";
82
+ negative: "negative";
83
+ not_integer: "not_integer";
84
+ report_failed: "report_failed";
85
+ resolver_failed: "resolver_failed";
86
+ unanswered: "unanswered";
87
+ }>;
88
+ }, z.core.$strip>>>;
89
+ createdAt: z.ZodCodec<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodDate]>, z.ZodDate>;
90
+ }, z.core.$strip>;
91
+ export type PaymentsUsageRun = z.output<typeof PaymentsUsageRun>;
92
+ export type PaymentsUsageRunRow = z.input<typeof PaymentsUsageRun>;
93
+ //# sourceMappingURL=usageRun.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usageRun.d.ts","sourceRoot":"","sources":["../../src/data/usageRun.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;EAI5B,CAAC;AACJ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,iDAAiD;AACjD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;iBAOsC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,8GAA8G;AAC9G,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBgF,CAAC;AAC9G,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AACjE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
@@ -0,0 +1,50 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import { PaymentsSubject } from "./subject.js";
4
+ import { z } from "zod";
5
+ import { SQLiteDate, sqliteJson } from "@pithy-sh/core/src/data/codecs";
6
+ //#region src/data/usageRun.ts
7
+ /**
8
+ * Why a subject was not reported on one run. Each is counted and named, and none is ever turned into a
9
+ * number: a skip bills last period's number and leaves a line an operator can act on, where a guess bills a
10
+ * wrong one silently.
11
+ */
12
+ const UsageFindingReason = z.enum([
13
+ "unanswered",
14
+ "not_integer",
15
+ "negative",
16
+ "below_min",
17
+ "above_max",
18
+ "resolver_failed",
19
+ "report_failed"
20
+ ]).describe("Why a subject was not reported: the resolver answered nothing, answered a non-integer, a negative, a count outside the product's min or max, or threw — or the store refused the report.");
21
+ /** One subject a run did not report, and why. */
22
+ const UsageFinding = z.object({
23
+ subjectType: PaymentsSubject.shape.subjectType.describe("Whether `subjectId` names a user or an organization."),
24
+ subjectId: PaymentsSubject.shape.subjectId.describe("The subject."),
25
+ productId: z.string().describe("The product whose count was not reported."),
26
+ reason: UsageFindingReason.describe("Why.")
27
+ }).describe("One subject a usage run did not report, and why.");
28
+ /** The most findings one run keeps by name. The counts are always whole; the names are a sample past this. */
29
+ const MAX_USAGE_FINDINGS = 100;
30
+ /**
31
+ * One usage-reporting pass, kept — the row in `pithy_payments_usage_runs`. The same shape and the same
32
+ * reason as `pithy_payments_reconcile_runs`: a silent job and a job that is not running look identical, and
33
+ * a run that reported nothing is the answer to "is it healthy".
34
+ */
35
+ const PaymentsUsageRun = z.object({
36
+ id: z.string().describe("The run's UUID."),
37
+ startedAt: SQLiteDate.describe("When the pass began."),
38
+ finishedAt: SQLiteDate.describe("When the pass finished."),
39
+ scanned: z.number().int().nonnegative().describe("Subscriptions examined."),
40
+ reported: z.number().int().nonnegative().describe("Periods a store accepted a report for on this run."),
41
+ sampled: z.number().int().nonnegative().describe("Daily-peak samples taken for a day still open."),
42
+ alreadyReported: z.number().int().nonnegative().describe("Periods found already reported or claimed, so nothing was sent. The replay count."),
43
+ skipped: z.number().int().nonnegative().describe("Subjects whose resolver answered nothing."),
44
+ invalid: z.number().int().nonnegative().describe("Subjects whose resolver answered a non-integer, a negative, or a count outside min and max."),
45
+ failed: z.number().int().nonnegative().describe("Subjects whose resolver threw, or whose report a store refused."),
46
+ findings: sqliteJson(z.array(UsageFinding)).describe(`The subjects not reported, and why — up to 100. The counts above are whole either way.`),
47
+ createdAt: SQLiteDate.describe("When this row was written.")
48
+ }).describe("One usage-reporting pass — when it ran and its tally — the row in `pithy_payments_usage_runs`.");
49
+ //#endregion
50
+ export { MAX_USAGE_FINDINGS, PaymentsUsageRun, UsageFinding, UsageFindingReason };
@@ -0,0 +1,100 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import { type AllowanceDeclarations, type FeatureMap, type QuotaMap, type QuotaValue } from "../config/allowances";
4
+ /**
5
+ * How much a subject may have, resolved — the one implementation of the order every reader shares.
6
+ *
7
+ * **The order, and it fails closed:**
8
+ *
9
+ * 1. The subject's **override**, when it names this allowance. A pin beats everything, `unrestricted`
10
+ * included, so `unrestricted` with `emails: 20000` is unlimited everywhere except email.
11
+ * 2. **`unrestricted`**, when the override carries it: unlimited and on, for every name — including one
12
+ * declared after the override was written, which is why it is a mode and not a list.
13
+ * 3. The **highest** value among every key the subject holds that speaks to this name. `null` (unlimited)
14
+ * beats every number, and a feature is on when any held key turns it on. A customer holding two products
15
+ * is owed the larger of what they bought, and an upgrade overlapping an old subscription's tail must
16
+ * never read as a downgrade for those weeks.
17
+ * 4. **`defaults`**, the free floor, for a name no held key speaks to.
18
+ * 5. **`0` for a quota, `false` for a feature.** Never unlimited. A name that resolved to unlimited because
19
+ * nothing declared it is a paywall that silently does not exist.
20
+ *
21
+ * **The reader takes no key, and that is the point.** A caller does not know which tier the subject is on,
22
+ * and during an upgrade overlap it holds two. Resolving across every held key is what makes a tier ladder
23
+ * unnecessary: an adopter compares numbers, never ranks, and the kit stays without an opinion on whether
24
+ * `growth` outranks `start`.
25
+ *
26
+ * Pure: the caller hands in the held keys and the override row, so the order is testable without a
27
+ * database, and the gate's middleware, the admin read and the meters all reach the same answer.
28
+ */
29
+ /** Where an allowance's value came from. `none` is the hard floor: nothing declared spoke to it. */
30
+ export type AllowanceSource = "unrestricted" | "override" | "plan" | "default" | "none";
31
+ /** What a subject's override says. Sparse: a name it does not carry resolves normally. */
32
+ export interface AllowanceOverride {
33
+ /** Unlimited and on, for every name present and future, except the names the patch pins. */
34
+ unrestricted: boolean;
35
+ /** Pinned quotas, by name. */
36
+ quotas: QuotaMap;
37
+ /** Pinned features, by name. */
38
+ features: FeatureMap;
39
+ }
40
+ /** One resolved value and where it came from. */
41
+ export interface ResolvedValue<T> {
42
+ /** The value. */
43
+ value: T;
44
+ /** Where it came from. */
45
+ source: AllowanceSource;
46
+ /** The entitlement key that supplied it, when `source` is `plan`. Null otherwise. */
47
+ key: string | null;
48
+ }
49
+ /** One quota, resolved: what applies now, and what would apply with the override removed. */
50
+ export interface ResolvedQuota {
51
+ /** The quota name. */
52
+ name: string;
53
+ /** What applies now. */
54
+ effective: ResolvedValue<QuotaValue>;
55
+ /** What would apply with no override — the plan's own number, for a pane to show and revert to. */
56
+ inherited: ResolvedValue<QuotaValue>;
57
+ }
58
+ /** One feature, resolved. */
59
+ export interface ResolvedFeature {
60
+ /** The feature name. */
61
+ name: string;
62
+ /** What applies now. */
63
+ effective: ResolvedValue<boolean>;
64
+ /** What would apply with no override. */
65
+ inherited: ResolvedValue<boolean>;
66
+ }
67
+ /** Every declared allowance for one subject, resolved. */
68
+ export interface ResolvedAllowances {
69
+ /** Every declared quota, by name order. */
70
+ quotas: ResolvedQuota[];
71
+ /** Every declared feature, by name order. */
72
+ features: ResolvedFeature[];
73
+ }
74
+ /** What resolution reads: the declarations, the keys granting now, and the override row if there is one. */
75
+ export interface AllowanceInput {
76
+ /** The project's declarations. */
77
+ declarations: AllowanceDeclarations;
78
+ /** Every entitlement key the subject holds that grants access now. */
79
+ held: ReadonlySet<string>;
80
+ /** The subject's override, or null. */
81
+ override: AllowanceOverride | null;
82
+ }
83
+ /** One quota, resolved through the whole order. */
84
+ export declare function resolveQuota(input: AllowanceInput, name: string): ResolvedQuota;
85
+ /** One feature, resolved through the whole order. */
86
+ export declare function resolveFeature(input: AllowanceInput, name: string): ResolvedFeature;
87
+ /** Every declared quota and feature for one subject. What the admin read projects. */
88
+ export declare function resolveAllowances(input: AllowanceInput): ResolvedAllowances;
89
+ /**
90
+ * Refuse a read of a quota nobody declared, naming it and listing what is declared.
91
+ *
92
+ * **A hard failure, never a default.** `quota(c, "emals")` resolving to `0` would deny quietly, and
93
+ * resolving to unlimited would be a paywall that does not exist — and a typo in a name is exactly the bug
94
+ * that reads as either. `core/internal`, because it is the adopter's code that is wrong, and an operator
95
+ * reading the log is who fixes it.
96
+ */
97
+ export declare function requireDeclaredQuota(declarations: AllowanceDeclarations, name: string): void;
98
+ /** The same refusal for a feature. */
99
+ export declare function requireDeclaredFeature(declarations: AllowanceDeclarations, name: string): void;
100
+ //# sourceMappingURL=allowance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"allowance.d.ts","sourceRoot":"","sources":["../../src/entitlement/allowance.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,qBAAqB,EAG1B,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,oGAAoG;AACpG,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAExF,0FAA0F;AAC1F,MAAM,WAAW,iBAAiB;IAChC,4FAA4F;IAC5F,YAAY,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,MAAM,EAAE,QAAQ,CAAC;IACjB,gCAAgC;IAChC,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,iBAAiB;IACjB,KAAK,EAAE,CAAC,CAAC;IACT,0BAA0B;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,qFAAqF;IACrF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,6FAA6F;AAC7F,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,mGAAmG;IACnG,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACtC;AAED,6BAA6B;AAC7B,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAClC,yCAAyC;IACzC,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACnC;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,4GAA4G;AAC5G,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,YAAY,EAAE,qBAAqB,CAAC;IACpC,sEAAsE;IACtE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACpC;AAqDD,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQ/E;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAYnF;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAK3E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ5F;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ9F"}
@@ -0,0 +1,171 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import { declaredFeatureNames, declaredQuotaNames } from "../config/allowances.js";
4
+ import { InternalError } from "@pithy-sh/core/src/error/pithyError";
5
+ //#region src/entitlement/allowance.ts
6
+ /** Whether `candidate` is more than `current` — `null` is unlimited and beats every number. */
7
+ function larger(candidate, current) {
8
+ if (current === null) return false;
9
+ if (candidate === null) return true;
10
+ return candidate > current;
11
+ }
12
+ /**
13
+ * A quota map's value for a name the caller has already checked is present. `?? 0` would be wrong here and
14
+ * dangerously so: `null` is unlimited, and a nullish fallback reads it as nothing.
15
+ */
16
+ function quotaAt(map, name) {
17
+ const value = map[name];
18
+ return value === void 0 ? 0 : value;
19
+ }
20
+ /** Held keys in a stable order, so the key named as a value's source does not depend on set order. */
21
+ function heldInOrder(held) {
22
+ return [...held].sort();
23
+ }
24
+ /** The value a quota has with no override: highest held, then the floor, then zero. */
25
+ function inheritedQuota(input, name) {
26
+ let best;
27
+ for (const key of heldInOrder(input.held)) {
28
+ const declaration = input.declarations.entitlements[key];
29
+ if (declaration === void 0 || !(name in declaration.quotas)) continue;
30
+ const value = quotaAt(declaration.quotas, name);
31
+ if (best === void 0 || larger(value, best.value)) best = {
32
+ value,
33
+ source: "plan",
34
+ key
35
+ };
36
+ }
37
+ if (best !== void 0) return best;
38
+ const floor = input.declarations.defaults?.quotas;
39
+ if (floor !== void 0 && name in floor) return {
40
+ value: quotaAt(floor, name),
41
+ source: "default",
42
+ key: null
43
+ };
44
+ return {
45
+ value: 0,
46
+ source: "none",
47
+ key: null
48
+ };
49
+ }
50
+ /** The value a feature has with no override: on if any held key says on, then the floor, then off. */
51
+ function inheritedFeature(input, name) {
52
+ let spoke;
53
+ for (const key of heldInOrder(input.held)) {
54
+ const declaration = input.declarations.entitlements[key];
55
+ if (declaration === void 0 || !(name in declaration.features)) continue;
56
+ if (declaration.features[name] === true) return {
57
+ value: true,
58
+ source: "plan",
59
+ key
60
+ };
61
+ spoke ??= {
62
+ value: false,
63
+ source: "plan",
64
+ key
65
+ };
66
+ }
67
+ if (spoke !== void 0) return spoke;
68
+ const floor = input.declarations.defaults?.features;
69
+ if (floor !== void 0 && name in floor) return {
70
+ value: floor[name] === true,
71
+ source: "default",
72
+ key: null
73
+ };
74
+ return {
75
+ value: false,
76
+ source: "none",
77
+ key: null
78
+ };
79
+ }
80
+ /** One quota, resolved through the whole order. */
81
+ function resolveQuota(input, name) {
82
+ const inherited = inheritedQuota(input, name);
83
+ const override = input.override;
84
+ if (override !== null && name in override.quotas) return {
85
+ name,
86
+ effective: {
87
+ value: quotaAt(override.quotas, name),
88
+ source: "override",
89
+ key: null
90
+ },
91
+ inherited
92
+ };
93
+ if (override?.unrestricted) return {
94
+ name,
95
+ effective: {
96
+ value: null,
97
+ source: "unrestricted",
98
+ key: null
99
+ },
100
+ inherited
101
+ };
102
+ return {
103
+ name,
104
+ effective: inherited,
105
+ inherited
106
+ };
107
+ }
108
+ /** One feature, resolved through the whole order. */
109
+ function resolveFeature(input, name) {
110
+ const inherited = inheritedFeature(input, name);
111
+ const override = input.override;
112
+ if (override !== null && name in override.features) return {
113
+ name,
114
+ effective: {
115
+ value: override.features[name] === true,
116
+ source: "override",
117
+ key: null
118
+ },
119
+ inherited
120
+ };
121
+ if (override?.unrestricted) return {
122
+ name,
123
+ effective: {
124
+ value: true,
125
+ source: "unrestricted",
126
+ key: null
127
+ },
128
+ inherited
129
+ };
130
+ return {
131
+ name,
132
+ effective: inherited,
133
+ inherited
134
+ };
135
+ }
136
+ /** Every declared quota and feature for one subject. What the admin read projects. */
137
+ function resolveAllowances(input) {
138
+ return {
139
+ quotas: declaredQuotaNames(input.declarations).map((name) => resolveQuota(input, name)),
140
+ features: declaredFeatureNames(input.declarations).map((name) => resolveFeature(input, name))
141
+ };
142
+ }
143
+ /**
144
+ * Refuse a read of a quota nobody declared, naming it and listing what is declared.
145
+ *
146
+ * **A hard failure, never a default.** `quota(c, "emals")` resolving to `0` would deny quietly, and
147
+ * resolving to unlimited would be a paywall that does not exist — and a typo in a name is exactly the bug
148
+ * that reads as either. `core/internal`, because it is the adopter's code that is wrong, and an operator
149
+ * reading the log is who fixes it.
150
+ */
151
+ function requireDeclaredQuota(declarations, name) {
152
+ const declared = declaredQuotaNames(declarations);
153
+ if (declared.includes(name)) return;
154
+ throw new InternalError({
155
+ message: `No quota "${name}" is declared.`,
156
+ action: "Declare it under `quotas` on an entitlement or in `defaults` in pithy.config.ts, or correct the name.",
157
+ detail: `quota("${name}") names nothing the payments declarations mention. Declared quotas: ${declared.join(", ") || "none"}.`
158
+ });
159
+ }
160
+ /** The same refusal for a feature. */
161
+ function requireDeclaredFeature(declarations, name) {
162
+ const declared = declaredFeatureNames(declarations);
163
+ if (declared.includes(name)) return;
164
+ throw new InternalError({
165
+ message: `No feature "${name}" is declared.`,
166
+ action: "Declare it under `features` on an entitlement or in `defaults` in pithy.config.ts, or correct the name.",
167
+ detail: `feature("${name}") names nothing the payments declarations mention. Declared features: ${declared.join(", ") || "none"}.`
168
+ });
169
+ }
170
+ //#endregion
171
+ export { requireDeclaredFeature, requireDeclaredQuota, resolveAllowances, resolveFeature, resolveQuota };
@@ -36,9 +36,9 @@ import { type PaymentsSubject } from "../data/subject";
36
36
  * exported, and the exported grant takes a {@link PaymentsConfig} it cannot be called without. A caller
37
37
  * cannot reach the unchecked half from outside this module, and the type says why.
38
38
  *
39
- * Comping a key nothing sells is therefore **declared** rather than achieved by nobody checking:
40
- * `manualEntitlements` in `pithy.config.ts` is where an adopter names the keys they comp but do not sell,
41
- * and those keys are grantable and are published on the catalog read beside the products. The check reads
39
+ * Comping a key nothing sells is therefore **declared** rather than achieved by nobody checking: a key the
40
+ * `entitlements` map in `pithy.config.ts` declares and no product sells is comp-only, grantable, and
41
+ * published on the catalog read beside the products. The check reads
42
42
  * `grantableEntitlements`, so that escape travels with it. Only grants are constrained. A revoke is not, or
43
43
  * dropping a product from the catalog would be irreversible for every account still holding its key — which
44
44
  * is why {@link revokeEntitlement} takes no config, and must never grow one.
@@ -87,8 +87,8 @@ export interface ManualEntitlementOptions {
87
87
  * Grant an entitlement by hand, and hold it against the projection. Idempotent; overwrites whatever the
88
88
  * projection last derived for this key, and survives every later purchase event for it.
89
89
  *
90
- * Refuses a key this project does not define — no product grants it and `manualEntitlements` does not
91
- * declare it — before any row is written. The config is a parameter rather than a closure because a grant
90
+ * Refuses a key this project does not define — the `entitlements` map does not declare it — before any row
91
+ * is written. The config is a parameter rather than a closure because a grant
92
92
  * without one is the defect: see the module doc.
93
93
  */
94
94
  export declare function grantEntitlement(d1: D1Database, config: PaymentsConfig, input: ManualEntitlementInput, options?: ManualEntitlementOptions): Promise<PaymentsEntitlement>;
@@ -12,15 +12,15 @@ import { withD1Retry } from "@pithy-sh/core/src/data/withD1Retry";
12
12
  * Grant an entitlement by hand, and hold it against the projection. Idempotent; overwrites whatever the
13
13
  * projection last derived for this key, and survives every later purchase event for it.
14
14
  *
15
- * Refuses a key this project does not define — no product grants it and `manualEntitlements` does not
16
- * declare it — before any row is written. The config is a parameter rather than a closure because a grant
15
+ * Refuses a key this project does not define — the `entitlements` map does not declare it — before any row
16
+ * is written. The config is a parameter rather than a closure because a grant
17
17
  * without one is the defect: see the module doc.
18
18
  */
19
19
  async function grantEntitlement(d1, config, input, options = {}) {
20
20
  const grantable = grantableEntitlements(config);
21
21
  if (!grantable.has(input.entitlement)) throw new PaymentsEntitlementNotInCatalogError({
22
22
  message: `No entitlement "${input.entitlement}" is defined here.`,
23
- detail: `No product grants "${input.entitlement}" and \`manualEntitlements\` does not declare it. Defined: ${[...grantable].sort().join(", ") || "nothing"}.`
23
+ detail: `\`entitlements\` declares no "${input.entitlement}". Declared: ${[...grantable].sort().join(", ") || "nothing"}.`
24
24
  });
25
25
  return writeEntitlement(d1, input, true, options);
26
26
  }
@@ -0,0 +1,98 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import { type MeterLimit } from "@pithy-sh/core/src/entitlement/entitlement";
4
+ import type { UsageMeter } from "@pithy-sh/core/src/entitlement/meter";
5
+ import type { AllowanceDeclarations } from "../config/allowances";
6
+ import type { KitMeter, PaymentsMeters } from "../config/config";
7
+ import { PaymentsSubject } from "../data/subject";
8
+ import { type PaymentsDatabase } from "../data/tables";
9
+ import { type AllowanceInput } from "./allowance";
10
+ /**
11
+ * The kit's own meters — what the kit counts because it writes the rows.
12
+ *
13
+ * | meter | counted from | enforced by |
14
+ * |----------------|-----------------------|---------------------------------------------|
15
+ * | `emails` | this table, per period | `@pithy-sh/email`, at enqueue, through {@link paymentsUsageMeter} |
16
+ * | `storageBytes` | `pithy_storage_objects` | `@pithy-sh/storage`, through `meterLimit` |
17
+ * | `mediaItems` | `pithy_media_*` | `@pithy-sh/media`, through `meterLimit` |
18
+ *
19
+ * The two that are levels — bytes held, items held — are counted by the capability that holds them, in the
20
+ * statement that writes the row, which is the only place a concurrent burst cannot walk past. Payments only
21
+ * says what the ceiling is. The one that is a flow — emails sent this period — is counted here, in
22
+ * `pithy_payments_meter_counters`, because no row anybody keeps answers "how many this period" once the
23
+ * email capability has pruned its jobs.
24
+ *
25
+ * **Enforcement is opt-in per meter.** Declaring `quotas: { emails: 500 }` makes 500 readable; turning the
26
+ * `emails` meter on makes it binding. A cap that arrives by surprise breaks an adopter already over it.
27
+ *
28
+ * **A counter read that fails refuses, and logs.** Storage already says which way round to err: over-counting
29
+ * briefly and reclaiming is the right way round, and under-counting has no recovery. The cost is stated
30
+ * rather than discovered: a bug of ours becomes a refused send for a paying customer, and a password reset is
31
+ * a bad place to invent a failure. Opt-in enforcement bounds it — an adopter who would rather over-deliver
32
+ * than drop leaves the meter advisory and keeps the check in their own route. Whoever reverses this should
33
+ * have to argue with that paragraph first.
34
+ *
35
+ * **A meter refuses; it never bills.** Nothing here reports a count to a store, and the usage-reporting pass
36
+ * never reads this table: the kit does not sell overage.
37
+ */
38
+ /** What every allowance read and every meter needs from the config. */
39
+ export interface PaymentsAllowances {
40
+ /** The declarations. */
41
+ declarations: AllowanceDeclarations;
42
+ /** Which kit meters enforce. */
43
+ meters: PaymentsMeters;
44
+ }
45
+ /** Whether a kit meter is enforced in this config. Anything not a kit meter is not. */
46
+ export declare function meterEnforced(meters: PaymentsMeters, meter: string): meter is KitMeter;
47
+ /**
48
+ * Everything resolution needs for one subject, read now: the keys granting access and the override row. A
49
+ * caller acting for nobody holds nothing and has no override, and resolves to the floor.
50
+ */
51
+ export declare function allowanceInputFor(db: PaymentsDatabase | undefined, declarations: AllowanceDeclarations, subject: PaymentsSubject | undefined, now: Date): Promise<AllowanceInput>;
52
+ /** The first instant of `now`'s calendar month, in UTC. The period of a subject payments knows no billing period for. */
53
+ export declare function calendarMonthStart(now: Date): Date;
54
+ /**
55
+ * When the subject's current period began: the start of its current billing period where payments knows one,
56
+ * the calendar month where it does not — a free-floor account still has a month.
57
+ *
58
+ * The current period is a granting subscription row whose window holds `now`; `data/period.ts` says which
59
+ * rails' rows state where that period began. Two at once — an upgrade overlapping an old subscription's tail —
60
+ * is answered by the newest, which is the one the customer is now paying for.
61
+ */
62
+ export declare function meterPeriodStart(db: PaymentsDatabase, subject: PaymentsSubject, now: Date): Promise<Date>;
63
+ /**
64
+ * Charge `amount` of `meter` against `subject` — or refuse, and write nothing.
65
+ *
66
+ * **The check and the write are one statement.** An upsert on `(subject, meter, periodStart)` whose update
67
+ * is conditioned on `used + amount <= limit`, with `RETURNING` to read back whether it landed. SQLite
68
+ * evaluates the condition under its write lock, so a burst of concurrent sends is serialized by the database
69
+ * and the first that would pass the limit changes nothing — the guarantee `@pithy-sh/storage`'s conditional
70
+ * insert makes, for the same reason: D1 has no interactive transaction to make two statements one.
71
+ *
72
+ * An unlimited subject — `null`, from a plan or from `unrestricted` — is counted and never refused.
73
+ */
74
+ export declare function chargeMeter(db: PaymentsDatabase, allowances: PaymentsAllowances, charge: {
75
+ subject: PaymentsSubject;
76
+ meter: string;
77
+ amount: number;
78
+ now: Date;
79
+ }): Promise<void>;
80
+ /**
81
+ * The ceiling a capability enforces on a level it counts itself — `storageBytes`, `mediaItems` — for a
82
+ * subject, or `{ enforced: false }` where the meter is advisory and the capability keeps its own.
83
+ *
84
+ * **The ceiling names the organization it covers.** An organization's plan is the organization's, so the
85
+ * capability must sum every member's rows against it, not the caller's alone — `tenant` says so, the same
86
+ * value the holder's `tenant` carries. A user subject, or nobody, is `null`: the caller's own rows.
87
+ */
88
+ export declare function meterLimitFor(db: PaymentsDatabase, allowances: PaymentsAllowances, subject: PaymentsSubject | undefined, meter: string, now: Date): Promise<MeterLimit>;
89
+ /**
90
+ * The meter `@pithy-sh/email` finds among the composed capabilities and charges at enqueue — the env-side
91
+ * half of the seam, for the callers with no request. See `@pithy-sh/core/src/entitlement/meter.ts`.
92
+ *
93
+ * A refusal is the provider's own `payments/quota_exceeded`. Anything else that goes wrong — a malformed
94
+ * holder, a D1 read that throws — is logged and refused as `core/internal`, never let through: see this
95
+ * module's note on which way round to err.
96
+ */
97
+ export declare function paymentsUsageMeter(allowances: PaymentsAllowances, database?: string): UsageMeter;
98
+ //# sourceMappingURL=meter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"meter.d.ts","sourceRoot":"","sources":["../../src/entitlement/meter.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,4CAA4C,CAAC;AACrG,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAKpF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKjE,OAAO,EAA0B,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,aAAa,CAAC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,YAAY,EAAE,qBAAqB,CAAC;IACpC,gCAAgC;IAChC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAEtF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,gBAAgB,GAAG,SAAS,EAChC,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,cAAc,CAAC,CAOzB;AAED,yHAAyH;AACzH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAElD;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB/G;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,gBAAgB,EACpB,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAC7E,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,gBAAgB,EACpB,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,SAAO,GAAG,UAAU,CAuC9F"}