@extenshi/pay 0.7.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 (111) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +260 -0
  3. package/dist/api/mock.d.ts +35 -0
  4. package/dist/api/mock.d.ts.map +1 -0
  5. package/dist/api/pay-api.d.ts +16 -0
  6. package/dist/api/pay-api.d.ts.map +1 -0
  7. package/dist/api/transport.d.ts +52 -0
  8. package/dist/api/transport.d.ts.map +1 -0
  9. package/dist/core/config.d.ts +5 -0
  10. package/dist/core/config.d.ts.map +1 -0
  11. package/dist/core/event-emitter.d.ts +10 -0
  12. package/dist/core/event-emitter.d.ts.map +1 -0
  13. package/dist/core/extenshi-pay.d.ts +90 -0
  14. package/dist/core/extenshi-pay.d.ts.map +1 -0
  15. package/dist/core/identity.d.ts +13 -0
  16. package/dist/core/identity.d.ts.map +1 -0
  17. package/dist/core/index.d.ts +25 -0
  18. package/dist/core/index.d.ts.map +1 -0
  19. package/dist/core/storage.d.ts +42 -0
  20. package/dist/core/storage.d.ts.map +1 -0
  21. package/dist/core.d.mts +821 -0
  22. package/dist/core.d.ts +821 -0
  23. package/dist/core.esm.js +1681 -0
  24. package/dist/core.esm.js.map +1 -0
  25. package/dist/core.js +1806 -0
  26. package/dist/core.js.map +1 -0
  27. package/dist/core.mjs +1744 -0
  28. package/dist/core.mjs.map +1 -0
  29. package/dist/extenshi-pay-lite.esm.js +1664 -0
  30. package/dist/extenshi-pay-lite.esm.js.map +1 -0
  31. package/dist/extenshi-pay-lite.js +1743 -0
  32. package/dist/extenshi-pay-lite.js.map +1 -0
  33. package/dist/extenshi-pay-lite.min.js +7 -0
  34. package/dist/extenshi-pay-lite.min.js.map +1 -0
  35. package/dist/extenshi-pay-lite.mjs +1727 -0
  36. package/dist/extenshi-pay-lite.mjs.map +1 -0
  37. package/dist/extenshi-pay.cjs.js +2632 -0
  38. package/dist/extenshi-pay.cjs.js.map +1 -0
  39. package/dist/extenshi-pay.d.ts +32 -0
  40. package/dist/extenshi-pay.d.ts.map +1 -0
  41. package/dist/extenshi-pay.esm.js +2496 -0
  42. package/dist/extenshi-pay.esm.js.map +1 -0
  43. package/dist/extenshi-pay.esm.min.js +7 -0
  44. package/dist/extenshi-pay.esm.min.js.map +1 -0
  45. package/dist/extenshi-pay.js +2638 -0
  46. package/dist/extenshi-pay.js.map +1 -0
  47. package/dist/extenshi-pay.min.js +7 -0
  48. package/dist/extenshi-pay.min.js.map +1 -0
  49. package/dist/extenshi-pay.min.mjs +7 -0
  50. package/dist/extenshi-pay.min.mjs.map +1 -0
  51. package/dist/extenshi-pay.mjs +2559 -0
  52. package/dist/extenshi-pay.mjs.map +1 -0
  53. package/dist/index.d.mts +937 -0
  54. package/dist/index.d.ts +937 -0
  55. package/dist/index.d.ts.map +1 -0
  56. package/dist/lite.d.mts +659 -0
  57. package/dist/lite.d.ts +659 -0
  58. package/dist/lite.d.ts.map +1 -0
  59. package/dist/payment/checkout.d.ts +47 -0
  60. package/dist/payment/checkout.d.ts.map +1 -0
  61. package/dist/payment/entitlement.d.ts +76 -0
  62. package/dist/payment/entitlement.d.ts.map +1 -0
  63. package/dist/payment/features.d.ts +12 -0
  64. package/dist/payment/features.d.ts.map +1 -0
  65. package/dist/payment/recovery.d.ts +29 -0
  66. package/dist/payment/recovery.d.ts.map +1 -0
  67. package/dist/payment/signature.d.ts +12 -0
  68. package/dist/payment/signature.d.ts.map +1 -0
  69. package/dist/paywall/billing-profile-picker.d.ts +8 -0
  70. package/dist/paywall/billing-profile-picker.d.ts.map +1 -0
  71. package/dist/paywall/format.d.ts +13 -0
  72. package/dist/paywall/format.d.ts.map +1 -0
  73. package/dist/paywall/index.d.ts +9 -0
  74. package/dist/paywall/index.d.ts.map +1 -0
  75. package/dist/paywall/license-panel.d.ts +10 -0
  76. package/dist/paywall/license-panel.d.ts.map +1 -0
  77. package/dist/paywall/renderer.d.ts +55 -0
  78. package/dist/paywall/renderer.d.ts.map +1 -0
  79. package/dist/paywall/seller-details.d.ts +5 -0
  80. package/dist/paywall/seller-details.d.ts.map +1 -0
  81. package/dist/paywall/strings.d.ts +10 -0
  82. package/dist/paywall/strings.d.ts.map +1 -0
  83. package/dist/paywall/templates.d.ts +14 -0
  84. package/dist/paywall/templates.d.ts.map +1 -0
  85. package/dist/paywall.d.mts +160 -0
  86. package/dist/paywall.d.ts +160 -0
  87. package/dist/paywall.esm.js +442 -0
  88. package/dist/paywall.esm.js.map +1 -0
  89. package/dist/paywall.js +462 -0
  90. package/dist/paywall.js.map +1 -0
  91. package/dist/paywall.mjs +442 -0
  92. package/dist/paywall.mjs.map +1 -0
  93. package/dist/types/config.d.ts +62 -0
  94. package/dist/types/config.d.ts.map +1 -0
  95. package/dist/types/contract.d.ts +172 -0
  96. package/dist/types/contract.d.ts.map +1 -0
  97. package/dist/types/entitlement.d.ts +71 -0
  98. package/dist/types/entitlement.d.ts.map +1 -0
  99. package/dist/types/errors.d.ts +31 -0
  100. package/dist/types/errors.d.ts.map +1 -0
  101. package/dist/types/events.d.ts +29 -0
  102. package/dist/types/events.d.ts.map +1 -0
  103. package/dist/types/index.d.ts +7 -0
  104. package/dist/types/index.d.ts.map +1 -0
  105. package/dist/types/paywall.d.ts +37 -0
  106. package/dist/types/paywall.d.ts.map +1 -0
  107. package/dist/utils/logger.d.ts +16 -0
  108. package/dist/utils/logger.d.ts.map +1 -0
  109. package/dist/version.d.ts +3 -0
  110. package/dist/version.d.ts.map +1 -0
  111. package/package.json +115 -0
@@ -0,0 +1,160 @@
1
+ declare const PAY_OFFER_KINDS: readonly ["one_time", "subscription", "lifetime"];
2
+ type PayOfferKind = (typeof PAY_OFFER_KINDS)[number];
3
+ declare const PAY_OFFER_INTERVALS: readonly ["month", "year"];
4
+ type PayOfferInterval = (typeof PAY_OFFER_INTERVALS)[number];
5
+ /** ISO-4217 lowercase, matching what every gateway returns. */
6
+ declare const PAY_CURRENCIES: readonly ["usd", "eur", "gbp"];
7
+ type PayCurrency = (typeof PAY_CURRENCIES)[number];
8
+ interface PayOfferDto {
9
+ sku: string;
10
+ kind: PayOfferKind;
11
+ interval: PayOfferInterval | null;
12
+ amountMinor: number;
13
+ currency: PayCurrency;
14
+ title: string;
15
+ description: string | null;
16
+ features: string[];
17
+ }
18
+ /** Public author-provided contact details. Not a claim of identity verification. */
19
+ interface PaySellerPublic {
20
+ displayName: string;
21
+ /** HTTPS support page or plain email address. */
22
+ supportUrl: string;
23
+ termsUrl: string | null;
24
+ }
25
+
26
+ interface ThemeConfig {
27
+ /** `auto` follows `prefers-color-scheme`. */
28
+ mode?: 'light' | 'dark' | 'auto';
29
+ primaryColor?: string;
30
+ fontFamily?: string;
31
+ borderRadius?: string;
32
+ /** Appended verbatim inside the paywall's shadow root. */
33
+ customCss?: string;
34
+ }
35
+
36
+ type PaywallMode = 'modal' | 'inline' | 'sidebar' | 'fullscreen' | 'minimal';
37
+ /** Every user-visible string the SDK adds on top of the templates (English only; iteration 12 T9 swaps locales). */
38
+ interface PaywallStrings {
39
+ title: string;
40
+ description: string;
41
+ upgrade: string;
42
+ cancel: string;
43
+ dismiss: string;
44
+ remindLater: string;
45
+ continueFree: string;
46
+ checkoutUnavailable: string;
47
+ periodMonth: string;
48
+ periodYear: string;
49
+ periodOnce: string;
50
+ footer: string;
51
+ restorePurchase: string;
52
+ }
53
+ interface PaywallOptions {
54
+ /** Template to render (default `modal`). */
55
+ mode?: PaywallMode;
56
+ /** Offer to feature; defaults to the first active offer. */
57
+ sku?: string;
58
+ title?: string;
59
+ description?: string;
60
+ /** Overrides the offer's `features[]`. */
61
+ features?: string[];
62
+ /** Free-tier bullets for the comparison templates (`inline`, `fullscreen`). */
63
+ freeFeatures?: string[];
64
+ theme?: ThemeConfig;
65
+ /** Mount point for `inline` mode (default `document.body`). */
66
+ container?: HTMLElement;
67
+ strings?: Partial<PaywallStrings>;
68
+ onUpgrade?: (sku: string) => void;
69
+ onClose?: () => void;
70
+ }
71
+
72
+ interface FormattedPrice {
73
+ /** Currency symbol/code as the locale renders it (`$`, `€`, `US$`). */
74
+ currency: string;
75
+ /** Numeric part (`9.99`, `9,99`). */
76
+ amount: string;
77
+ /** The whole formatted price (`$9.99`). */
78
+ full: string;
79
+ }
80
+ declare function formatPrice(amountMinor: number, currency: string, locale?: string | null): FormattedPrice;
81
+ declare function periodLabel(offer: PayOfferDto, strings: PaywallStrings): string;
82
+
83
+ /**
84
+ * The one paywall renderer.
85
+ *
86
+ * Renders a template from `@extenshi/paywall-templates` into a Shadow DOM
87
+ * host so the templates' resets never leak into the extension page (and vice
88
+ * versa). Placeholders (`{{title}}`, `{{price}}` …) are filled from the offer
89
+ * and the strings dictionary, every value HTML-escaped; buttons are bound with
90
+ * `addEventListener` on `data-ep-action` (no inline handlers, no scripts).
91
+ */
92
+
93
+ interface PaywallView {
94
+ mode: PaywallMode;
95
+ title: string;
96
+ description: string;
97
+ features: string[];
98
+ freeFeatures: string[];
99
+ brandName: string;
100
+ offer: PayOfferDto | null;
101
+ checkoutEnabled: boolean;
102
+ mock?: boolean;
103
+ recoveryEnabled?: boolean;
104
+ seller?: PaySellerPublic | null;
105
+ locale: string | null;
106
+ theme: ThemeConfig;
107
+ strings: Partial<PaywallStrings>;
108
+ container?: HTMLElement;
109
+ }
110
+ interface PaywallRendererCallbacks {
111
+ onUpgrade: (sku: string) => void;
112
+ onClose: () => void;
113
+ onRestore?: () => void;
114
+ }
115
+ declare const PAYWALL_HOST_CLASS = "extenshi-paywall-host";
116
+ declare function escapeHtml(value: string): string;
117
+ declare function substitute(html: string, content: Record<string, string>): string;
118
+ declare function buildContent(view: PaywallView, strings: PaywallStrings): Record<string, string>;
119
+ declare function themeCss(theme: ThemeConfig): string;
120
+ declare function resolveThemeMode(theme: ThemeConfig): 'light' | 'dark';
121
+ declare class PaywallRenderer {
122
+ private readonly callbacks;
123
+ private host;
124
+ private keyHandler;
125
+ constructor(callbacks: PaywallRendererCallbacks);
126
+ isVisible(): boolean;
127
+ /** Returns the host element; its shadow root holds the rendered template. */
128
+ show(view: PaywallView): HTMLElement;
129
+ hide(): void;
130
+ private prune;
131
+ private bind;
132
+ private reveal;
133
+ private close;
134
+ }
135
+
136
+ /**
137
+ * Every string the SDK adds on top of the templates. English only for now;
138
+ * iteration 12 T9 / 13 replaces this dictionary per locale. Do not add
139
+ * promotional claims here without marketing/legal review (see
140
+ * .claude/modules/paywall-templates.md).
141
+ */
142
+
143
+ declare const DEFAULT_STRINGS: PaywallStrings;
144
+
145
+ /**
146
+ * The five templates from `@extenshi/paywall-templates`, inlined at build
147
+ * time by build/paywall-templates-plugin.mjs. No runtime fetch, no
148
+ * `web_accessible_resources`, no remote code.
149
+ */
150
+
151
+ interface PaywallTemplate {
152
+ html: string;
153
+ css: string;
154
+ }
155
+ declare const PAYWALL_SHARED_CSS: string;
156
+ declare const PAYWALL_TEMPLATES: Record<PaywallMode, PaywallTemplate>;
157
+ declare const PAYWALL_MODES: PaywallMode[];
158
+
159
+ export { DEFAULT_STRINGS, PAYWALL_HOST_CLASS, PAYWALL_MODES, PAYWALL_SHARED_CSS, PAYWALL_TEMPLATES, PaywallRenderer, buildContent, escapeHtml, formatPrice, periodLabel, resolveThemeMode, substitute, themeCss };
160
+ export type { FormattedPrice, PaywallMode, PaywallOptions, PaywallRendererCallbacks, PaywallStrings, PaywallTemplate, PaywallView, ThemeConfig };