@extenshi/pay 0.8.0 → 0.11.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 (76) hide show
  1. package/README.md +134 -19
  2. package/dist/api/mock.d.ts +4 -0
  3. package/dist/api/mock.d.ts.map +1 -1
  4. package/dist/api/pay-api.d.ts +9 -4
  5. package/dist/api/pay-api.d.ts.map +1 -1
  6. package/dist/core/config.d.ts.map +1 -1
  7. package/dist/core/extenshi-pay.d.ts +60 -5
  8. package/dist/core/extenshi-pay.d.ts.map +1 -1
  9. package/dist/core/index.d.ts +3 -1
  10. package/dist/core/index.d.ts.map +1 -1
  11. package/dist/core/storage.d.ts +6 -0
  12. package/dist/core/storage.d.ts.map +1 -1
  13. package/dist/core.d.mts +280 -27
  14. package/dist/core.d.ts +280 -27
  15. package/dist/core.js +566 -44
  16. package/dist/core.js.map +1 -1
  17. package/dist/core.mjs +562 -45
  18. package/dist/core.mjs.map +1 -1
  19. package/dist/extenshi-pay-lite.js +555 -44
  20. package/dist/extenshi-pay-lite.js.map +1 -1
  21. package/dist/extenshi-pay-lite.min.js +3 -3
  22. package/dist/extenshi-pay-lite.min.js.map +1 -1
  23. package/dist/extenshi-pay-lite.mjs +555 -44
  24. package/dist/extenshi-pay-lite.mjs.map +1 -1
  25. package/dist/extenshi-pay.cjs.js +823 -69
  26. package/dist/extenshi-pay.cjs.js.map +1 -1
  27. package/dist/extenshi-pay.d.ts +11 -1
  28. package/dist/extenshi-pay.d.ts.map +1 -1
  29. package/dist/extenshi-pay.js +823 -69
  30. package/dist/extenshi-pay.js.map +1 -1
  31. package/dist/extenshi-pay.min.js +3 -3
  32. package/dist/extenshi-pay.min.js.map +1 -1
  33. package/dist/extenshi-pay.min.mjs +3 -3
  34. package/dist/extenshi-pay.min.mjs.map +1 -1
  35. package/dist/extenshi-pay.mjs +819 -70
  36. package/dist/extenshi-pay.mjs.map +1 -1
  37. package/dist/index.d.mts +305 -27
  38. package/dist/index.d.ts +305 -27
  39. package/dist/lite.d.mts +224 -14
  40. package/dist/lite.d.ts +224 -14
  41. package/dist/lite.d.ts.map +1 -1
  42. package/dist/payment/cloud-backup.d.ts +35 -0
  43. package/dist/payment/cloud-backup.d.ts.map +1 -0
  44. package/dist/payment/entitlement.d.ts +21 -5
  45. package/dist/payment/entitlement.d.ts.map +1 -1
  46. package/dist/payment/recovery.d.ts +4 -2
  47. package/dist/payment/recovery.d.ts.map +1 -1
  48. package/dist/payment/signature.d.ts +29 -3
  49. package/dist/payment/signature.d.ts.map +1 -1
  50. package/dist/payment/trial.d.ts +55 -0
  51. package/dist/payment/trial.d.ts.map +1 -0
  52. package/dist/paywall/i18n.d.ts +3 -0
  53. package/dist/paywall/i18n.d.ts.map +1 -1
  54. package/dist/paywall/icon.d.ts +18 -0
  55. package/dist/paywall/icon.d.ts.map +1 -0
  56. package/dist/paywall/renderer.d.ts +15 -0
  57. package/dist/paywall/renderer.d.ts.map +1 -1
  58. package/dist/paywall.d.mts +27 -1
  59. package/dist/paywall.d.ts +27 -1
  60. package/dist/paywall.js +131 -25
  61. package/dist/paywall.js.map +1 -1
  62. package/dist/paywall.mjs +131 -25
  63. package/dist/paywall.mjs.map +1 -1
  64. package/dist/types/config.d.ts +27 -1
  65. package/dist/types/config.d.ts.map +1 -1
  66. package/dist/types/contract.d.ts +35 -0
  67. package/dist/types/contract.d.ts.map +1 -1
  68. package/dist/types/entitlement.d.ts +37 -1
  69. package/dist/types/entitlement.d.ts.map +1 -1
  70. package/dist/types/events.d.ts +5 -1
  71. package/dist/types/events.d.ts.map +1 -1
  72. package/dist/types/paywall.d.ts +22 -1
  73. package/dist/types/paywall.d.ts.map +1 -1
  74. package/dist/version.d.ts +1 -1
  75. package/dist/version.d.ts.map +1 -1
  76. package/package.json +3 -2
@@ -1,4 +1,4 @@
1
- import type { PayEntitlementItem, PayOfferDto, PayWithdrawalWaiver } from './contract.js';
1
+ import type { PayEntitlementItem, PayOfferDto, PaySellerPublic, PayWithdrawalWaiver } from './contract.js';
2
2
  import type { ExtenshiPayError } from './errors.js';
3
3
  export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
4
4
  /** Reserved for future routing; today every environment talks to the same BFF. */
@@ -26,6 +26,20 @@ export interface MockData {
26
26
  * paywall previews the checkbox). `null` previews a seller outside the EEA/UK.
27
27
  */
28
28
  withdrawalWaiver?: PayWithdrawalWaiver | null;
29
+ /**
30
+ * Seller details for the paywall, the license panel and the waiver text.
31
+ * Omitted, the offer carries none (as from an older server); `null`
32
+ * previews a seller without public details, so the paywall disables purchase.
33
+ */
34
+ seller?: PaySellerPublic | null;
35
+ /**
36
+ * Previews a server trial: `days` long, started at `startedAt` (default: when the mock is
37
+ * created). Omitted, the mock application has no trial.
38
+ */
39
+ trial?: {
40
+ days: number;
41
+ startedAt?: string;
42
+ };
29
43
  }
30
44
  export interface ExtenshiPayConfig {
31
45
  /** `pk_ext_` + 32 hex characters, from the project's Monetization tab. */
@@ -47,6 +61,15 @@ export interface ExtenshiPayConfig {
47
61
  onReady?: () => void;
48
62
  onError?: (error: ExtenshiPayError) => void;
49
63
  theme?: ThemeConfig;
64
+ /** Days before the trial's end that `trial:ending` fires (default 2; 0 turns it off). */
65
+ trialEndingDays?: number;
66
+ /**
67
+ * Keep the trial's start date in `storage.sync` and send it back on license checks, so
68
+ * other devices on the same synced browser account share the trial (default true).
69
+ * Only the date is synced, never the installation id. A reinstall still restarts the
70
+ * trial: uninstalling clears `storage.sync`.
71
+ */
72
+ syncTrialStart?: boolean;
50
73
  }
51
74
  export interface ResolvedConfig {
52
75
  publishableKey: string;
@@ -60,8 +83,11 @@ export interface ResolvedConfig {
60
83
  mock: boolean;
61
84
  mockData: MockData | null;
62
85
  theme: ThemeConfig;
86
+ trialEndingDays: number;
87
+ syncTrialStart: boolean;
63
88
  }
64
89
  export declare const DEFAULT_API_URL = "https://bff.extenshi.io";
65
90
  export declare const DEFAULT_CACHE_TTL_MS: number;
66
91
  export declare const MAX_CACHE_TTL_MS: number;
92
+ export declare const DEFAULT_TRIAL_ENDING_DAYS = 2;
67
93
  //# sourceMappingURL=config.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAErE,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;AAElE,MAAM,WAAW,WAAW;IAC3B,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,QAAQ;IACxB,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACnC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAA;CAC7C;AAED,MAAM,WAAW,iBAAiB;IACjC,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAA;IACtB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oGAAoG;IACpG,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qHAAqH;IACrH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC3C,KAAK,CAAC,EAAE,WAAW,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,QAAQ,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,WAAW,CAAA;CAClB;AAED,eAAO,MAAM,eAAe,4BAA4B,CAAA;AACxD,eAAO,MAAM,oBAAoB,QAAiB,CAAA;AAClD,eAAO,MAAM,gBAAgB,QAA0B,CAAA"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}
@@ -100,6 +100,16 @@ export interface PayEntitlementItem {
100
100
  expiresAt: string | null;
101
101
  features: string[];
102
102
  }
103
+ /**
104
+ * The installation's free trial on the server clock: one per installation per application,
105
+ * started at its first license read. Absent when the application has no trial.
106
+ */
107
+ export interface PayTrial {
108
+ /** ISO time of the first license read while the application had a trial. */
109
+ startedAt: string;
110
+ /** ISO `startedAt` plus the application's current trial length. */
111
+ endsAt: string;
112
+ }
103
113
  export interface PayEntitlementPayload {
104
114
  v: typeof PAY_CONTRACT_VERSION;
105
115
  /** Signed application scope; prevents moving a grant to another application. */
@@ -108,6 +118,10 @@ export interface PayEntitlementPayload {
108
118
  entitlements: PayEntitlementItem[];
109
119
  /** ISO timestamp the projection was computed at; the SDK uses it for cache age. */
110
120
  issuedAt: string;
121
+ /** Optional: only for an application with a trial, and absent from older servers. */
122
+ trial?: PayTrial;
123
+ /** Optional: seconds of offline access after `issuedAt`; absent from older servers (48 hours). */
124
+ offlineSeconds?: number;
111
125
  }
112
126
  export interface SignedEntitlement {
113
127
  payload: PayEntitlementPayload;
@@ -161,12 +175,33 @@ export interface PayRestoreSessionResponse {
161
175
  expiresAt: string;
162
176
  url: string;
163
177
  }
178
+ /**
179
+ * `storage`: the buyer turns on the cloud copy of the extension's settings. The
180
+ * hosted page shows the storage disclosure; the claim records consent. Additive:
181
+ * a session without a purpose is a plain restore.
182
+ */
183
+ export declare const PAY_RESTORE_PURPOSES: readonly ["restore", "storage"];
184
+ export type PayRestorePurpose = (typeof PAY_RESTORE_PURPOSES)[number];
185
+ /**
186
+ * Outcome for the cloud copy of settings, present in a complete claim only when
187
+ * the application offers it. A token is returned once; a retried claim rotates it.
188
+ */
189
+ export type PayStorageGrant = {
190
+ state: 'granted';
191
+ token: string;
192
+ } | {
193
+ state: 'unavailable';
194
+ reason: 'NO_CONSENT' | 'LICENSE_REQUIRED';
195
+ };
196
+ /** From `shared-types/storage.ts`: `est_` + 32 random bytes, base64url. */
197
+ export declare const STORAGE_TOKEN_RE: RegExp;
164
198
  export type PayRestoreClaimResponse = {
165
199
  state: 'pending';
166
200
  } | {
167
201
  state: 'complete';
168
202
  endUserRef: string;
169
203
  entitlement: SignedEntitlement;
204
+ storage?: PayStorageGrant;
170
205
  };
171
206
  /** A project-scoped billing profile; provider identifiers are never exposed. */
172
207
  export interface PayPortalAccount {
@@ -1 +1 @@
1
- {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/types/contract.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/types/contract.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import type { PayEntitlementItem, PayPortalAccount, PaySellerPublic } from './contract.js';
1
+ import type { PayEntitlementItem, PayPortalAccount, PayRestorePurpose, PaySellerPublic } from './contract.js';
2
2
  import type { PaywallOptions } from './paywall.js';
3
3
  export type EntitlementSource = 'network' | 'cache' | 'mock' | 'none';
4
4
  /** The SDK's view of the server projection, with `expiresAt` applied locally. */
@@ -15,8 +15,33 @@ export interface Entitlement {
15
15
  requiresOnlineCheck?: boolean;
16
16
  /** Local offline-access deadline; null for mock mode or no cached license. */
17
17
  offlineUntil?: number | null;
18
+ /**
19
+ * Set when the device clock differed from the server's by more than 5 minutes at the last
20
+ * license check. With `requiresOnlineCheck` on a connected device, ask the user to correct
21
+ * the date and time instead of asking them to connect.
22
+ */
23
+ clockSkew?: ClockSkew | null;
18
24
  source: EntitlementSource;
19
25
  }
26
+ export interface ClockSkew {
27
+ /** `ahead`: the device clock is later than the server's. */
28
+ direction: 'ahead' | 'behind';
29
+ /** Size of the difference in milliseconds. */
30
+ ms: number;
31
+ }
32
+ /** `getTrial()`: the free trial from the verified license, on the server's clock. */
33
+ export interface TrialState {
34
+ /** True while the trial runs and the license was checked within the last 48 hours, as for paid access. */
35
+ active: boolean;
36
+ /** ISO time of the installation's first license check while the application had a trial. */
37
+ startedAt: string;
38
+ /** ISO time the trial ends. */
39
+ endsAt: string;
40
+ /** Whole days left, rounded up; 0 once the trial has ended. */
41
+ daysLeft: number;
42
+ /** The trial has days left but the license was not checked within 48 hours: connect to resume it. */
43
+ requiresOnlineCheck: boolean;
44
+ }
20
45
  export interface GetEntitlementOptions {
21
46
  /** Skip the cache TTL and hit the network. */
22
47
  force?: boolean;
@@ -72,10 +97,21 @@ export interface RestoreOptions {
72
97
  pollIntervalMs?: number;
73
98
  signal?: AbortSignal;
74
99
  openUrl?: (url: string) => void | Promise<void>;
100
+ /**
101
+ * `storage` also turns on the cloud copy of settings: the hosted page shows
102
+ * the storage disclosure first. `enableCloudBackup()` passes it. Default: a plain restore.
103
+ */
104
+ purpose?: PayRestorePurpose;
75
105
  }
106
+ /**
107
+ * The cloud copy of settings after a completed restore: `on` (the token is
108
+ * stored), or why it is off. Absent when the application does not offer it.
109
+ */
110
+ export type CloudBackupState = 'on' | 'no_consent' | 'license_required';
76
111
  export type RestoreResult = {
77
112
  state: 'complete';
78
113
  entitlement: Entitlement;
114
+ cloudBackup?: CloudBackupState;
79
115
  } | {
80
116
  state: 'timeout' | 'expired' | 'canceled';
81
117
  };
@@ -1 +1 @@
1
- {"version":3,"file":"entitlement.d.ts","sourceRoot":"","sources":["../../src/types/entitlement.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"entitlement.d.ts","sourceRoot":"","sources":["../../src/types/entitlement.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import type { Entitlement } from './entitlement.js';
1
+ import type { Entitlement, TrialState } from './entitlement.js';
2
2
  import type { ExtenshiPayError } from './errors.js';
3
3
  export interface ExtenshiPayEvents {
4
4
  ready: {
@@ -23,6 +23,10 @@ export interface ExtenshiPayEvents {
23
23
  sku: string;
24
24
  sessionId: string;
25
25
  };
26
+ /** Once per installation and trial, `trialEndingDays` before the end, while the user has no paid access. */
27
+ 'trial:ending': TrialState;
28
+ /** Once per installation and trial, when it has ended, while the user has no paid access. */
29
+ 'trial:ended': TrialState;
26
30
  error: ExtenshiPayError;
27
31
  }
28
32
  export type ExtenshiPayEventName = keyof ExtenshiPayEvents;
@@ -1 +1 @@
1
- {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7B,qBAAqB,EAAE,WAAW,CAAA;IAClC,kBAAkB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE,oBAAoB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,CAAA;IAClF,mBAAmB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,kBAAkB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACtD,KAAK,EAAE,gBAAgB,CAAA;CACvB;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,iBAAiB,CAAA"}
1
+ {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7B,qBAAqB,EAAE,WAAW,CAAA;IAClC,kBAAkB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE,oBAAoB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,CAAA;IAClF,mBAAmB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,kBAAkB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACtD,4GAA4G;IAC5G,cAAc,EAAE,UAAU,CAAA;IAC1B,6FAA6F;IAC7F,aAAa,EAAE,UAAU,CAAA;IACzB,KAAK,EAAE,gBAAgB,CAAA;CACvB;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,iBAAiB,CAAA"}
@@ -35,10 +35,21 @@ export interface PaywallOptions {
35
35
  sku?: string;
36
36
  title?: string;
37
37
  description?: string;
38
- /** Overrides the offer's `features[]`. */
38
+ /**
39
+ * Bullet points, in the user's language (`chrome.i18n.getMessage`). The
40
+ * offer's `features[]` are entitlement keys and are never shown: without
41
+ * this option the paywall has no feature list.
42
+ */
39
43
  features?: string[];
40
44
  /** Free-tier bullets for the comparison templates (`inline`, `fullscreen`). */
41
45
  freeFeatures?: string[];
46
+ /**
47
+ * Header image in place of the template's glyph: a path inside the
48
+ * extension (`icons/icon128.png`) or a `data:image/` URL. Defaults to the
49
+ * largest `manifest.icons` entry on the extension's own pages (popup,
50
+ * options); `false` keeps the glyph. Remote URLs are ignored.
51
+ */
52
+ icon?: string | false;
42
53
  theme?: ThemeConfig;
43
54
  /** Mount point for `inline` mode (default `document.body`). */
44
55
  container?: HTMLElement;
@@ -47,4 +58,14 @@ export interface PaywallOptions {
47
58
  onUpgrade?: (sku: string, consent?: UpgradeConsent) => void;
48
59
  onClose?: () => void;
49
60
  }
61
+ /** `showTrialEnded()`: the paywall with the trial-ended heading, plus an optional feedback button. */
62
+ export interface TrialEndedOptions extends PaywallOptions {
63
+ /**
64
+ * Your feedback form (HTTPS). The SDK opens it with `src=trial_end` added and nothing that
65
+ * identifies the installation. Any other URL is left out and reported through `error`.
66
+ */
67
+ feedbackFormUrl?: string;
68
+ /** Label of the feedback button (default: "Share feedback" in the user's language). */
69
+ feedbackLabel?: string;
70
+ }
50
71
  //# sourceMappingURL=paywall.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"paywall.d.ts","sourceRoot":"","sources":["../../src/types/paywall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAEnF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,oFAAoF;IACpF,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACjC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,IAAI,CAAA;IAC3D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB"}
1
+ {"version":3,"file":"paywall.d.ts","sourceRoot":"","sources":["../../src/types/paywall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAEnF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,oFAAoF;IACpF,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACrB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IACjC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,IAAI,CAAA;IAC3D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,sGAAsG;AACtG,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACxD;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB"}
package/dist/version.d.ts CHANGED
@@ -1,3 +1,3 @@
1
1
  /** Kept in sync with package.json by tests/unit/version.test.ts. */
2
- export declare const VERSION = "0.8.0";
2
+ export declare const VERSION = "0.11.0";
3
3
  //# sourceMappingURL=version.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,eAAO,MAAM,OAAO,UAAU,CAAA"}
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,eAAO,MAAM,OAAO,WAAW,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@extenshi/pay",
3
- "version": "0.8.0",
3
+ "version": "0.11.0",
4
4
  "description": "Lightweight payment SDK for browser extensions",
5
5
  "main": "dist/extenshi-pay.js",
6
6
  "module": "dist/extenshi-pay.mjs",
@@ -91,9 +91,10 @@
91
91
  "@vitest/coverage-v8": "^3.2.7",
92
92
  "eslint": "^8.56.0",
93
93
  "jsdom": "^24.0.0",
94
- "rollup": "^4.63.5",
94
+ "rollup": "^4.68.0",
95
95
  "rollup-plugin-dts": "^6.5.1",
96
96
  "rollup-plugin-terser": "^7.0.2",
97
+ "tslib": "^2.8.1",
97
98
  "typescript": "^5.9.3",
98
99
  "vitest": "^3.2.7"
99
100
  },