fluentcart-developer 3.0.0 → 3.0.1

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 (609) hide show
  1. package/LICENSE.md +26 -26
  2. package/README.md +59 -59
  3. package/dist/cards/fluentcart/templates-native.js +1087 -1087
  4. package/dist/cards/fluentcart/tools.js +2309 -2309
  5. package/dist/skills/fluentcart-developer/SKILL.md +108 -108
  6. package/dist/skills/fluentcart-developer/examples/README.md +30 -30
  7. package/dist/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/fluent-cart/checkout.php +32 -32
  8. package/dist/skills/fluentcart-developer/examples/fluentcart-starter-child-theme/functions.php +40 -40
  9. package/dist/skills/fluentcart-developer/examples/sample-custom-addon/fluentcart-custom-addon.php +113 -113
  10. package/dist/skills/fluentcart-developer/examples/sample-custom-payment-gateway/fluentcart-custom-gateway-example.php +148 -148
  11. package/dist/skills/fluentcart-developer/examples/sample-fee-surcharge-plugin/fluentcart-fee-surcharge.php +38 -38
  12. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/README.md +22 -22
  13. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/sample-plugin-with-licensing-sdk.php +79 -79
  14. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/FluentLicensing.php +303 -303
  15. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/LicenseSettings.php +566 -566
  16. package/dist/skills/fluentcart-developer/examples/sample-plugin-with-licensing-sdk/updater/PluginUpdater.php +304 -304
  17. package/dist/skills/fluentcart-developer/examples/sample-shipping-carrier/fluentcart-custom-shipping-carrier.php +61 -61
  18. package/dist/skills/fluentcart-developer/references/api/authentication.md +452 -452
  19. package/dist/skills/fluentcart-developer/references/api/coupons.md +786 -786
  20. package/dist/skills/fluentcart-developer/references/api/customers.md +889 -889
  21. package/dist/skills/fluentcart-developer/references/api/files.md +609 -609
  22. package/dist/skills/fluentcart-developer/references/api/index.md +432 -432
  23. package/dist/skills/fluentcart-developer/references/api/licensing.md +633 -633
  24. package/dist/skills/fluentcart-developer/references/api/order-bump.md +384 -384
  25. package/dist/skills/fluentcart-developer/references/api/orders.md +814 -814
  26. package/dist/skills/fluentcart-developer/references/api/products.md +866 -866
  27. package/dist/skills/fluentcart-developer/references/api/roles-permissions.md +536 -536
  28. package/dist/skills/fluentcart-developer/references/api/subscriptions.md +827 -827
  29. package/dist/skills/fluentcart-developer/references/database/index.md +44 -44
  30. package/dist/skills/fluentcart-developer/references/database/models/activity.md +178 -178
  31. package/dist/skills/fluentcart-developer/references/database/models/applied-coupon.md +291 -291
  32. package/dist/skills/fluentcart-developer/references/database/models/attribute-group.md +239 -239
  33. package/dist/skills/fluentcart-developer/references/database/models/attribute-relation.md +181 -181
  34. package/dist/skills/fluentcart-developer/references/database/models/attribute-term.md +219 -219
  35. package/dist/skills/fluentcart-developer/references/database/models/cart.md +645 -645
  36. package/dist/skills/fluentcart-developer/references/database/models/coupon.md +427 -427
  37. package/dist/skills/fluentcart-developer/references/database/models/customer-addresses.md +348 -348
  38. package/dist/skills/fluentcart-developer/references/database/models/customer-meta.md +156 -156
  39. package/dist/skills/fluentcart-developer/references/database/models/customer.md +584 -584
  40. package/dist/skills/fluentcart-developer/references/database/models/dynamic-model.md +163 -163
  41. package/dist/skills/fluentcart-developer/references/database/models/label-relationship.md +155 -155
  42. package/dist/skills/fluentcart-developer/references/database/models/label.md +153 -153
  43. package/dist/skills/fluentcart-developer/references/database/models/license-activation.md +182 -182
  44. package/dist/skills/fluentcart-developer/references/database/models/license-meta.md +163 -163
  45. package/dist/skills/fluentcart-developer/references/database/models/license-site.md +208 -208
  46. package/dist/skills/fluentcart-developer/references/database/models/license.md +640 -640
  47. package/dist/skills/fluentcart-developer/references/database/models/meta.md +233 -233
  48. package/dist/skills/fluentcart-developer/references/database/models/order-address.md +391 -391
  49. package/dist/skills/fluentcart-developer/references/database/models/order-download-permission.md +144 -144
  50. package/dist/skills/fluentcart-developer/references/database/models/order-item.md +383 -383
  51. package/dist/skills/fluentcart-developer/references/database/models/order-meta.md +303 -303
  52. package/dist/skills/fluentcart-developer/references/database/models/order-operation.md +158 -158
  53. package/dist/skills/fluentcart-developer/references/database/models/order-promotion-stat.md +175 -175
  54. package/dist/skills/fluentcart-developer/references/database/models/order-promotion.md +250 -250
  55. package/dist/skills/fluentcart-developer/references/database/models/order-tax-rate.md +172 -172
  56. package/dist/skills/fluentcart-developer/references/database/models/order-transaction.md +440 -440
  57. package/dist/skills/fluentcart-developer/references/database/models/order.md +727 -727
  58. package/dist/skills/fluentcart-developer/references/database/models/product-detail.md +397 -397
  59. package/dist/skills/fluentcart-developer/references/database/models/product-download.md +258 -258
  60. package/dist/skills/fluentcart-developer/references/database/models/product-meta.md +153 -153
  61. package/dist/skills/fluentcart-developer/references/database/models/product-variation.md +556 -556
  62. package/dist/skills/fluentcart-developer/references/database/models/product.md +580 -580
  63. package/dist/skills/fluentcart-developer/references/database/models/relationships.md +427 -427
  64. package/dist/skills/fluentcart-developer/references/database/models/scheduled-action.md +175 -175
  65. package/dist/skills/fluentcart-developer/references/database/models/shipping-class.md +148 -148
  66. package/dist/skills/fluentcart-developer/references/database/models/shipping-method.md +280 -280
  67. package/dist/skills/fluentcart-developer/references/database/models/shipping-zone.md +205 -205
  68. package/dist/skills/fluentcart-developer/references/database/models/subscription-meta.md +173 -173
  69. package/dist/skills/fluentcart-developer/references/database/models/subscription.md +528 -528
  70. package/dist/skills/fluentcart-developer/references/database/models/tax-class.md +195 -195
  71. package/dist/skills/fluentcart-developer/references/database/models/tax-rate.md +225 -225
  72. package/dist/skills/fluentcart-developer/references/database/models/user-meta.md +166 -166
  73. package/dist/skills/fluentcart-developer/references/database/models/user.md +220 -220
  74. package/dist/skills/fluentcart-developer/references/database/models.md +404 -404
  75. package/dist/skills/fluentcart-developer/references/database/query-builder.md +860 -860
  76. package/dist/skills/fluentcart-developer/references/database/readme.md +276 -276
  77. package/dist/skills/fluentcart-developer/references/database/schema.md +1002 -1002
  78. package/dist/skills/fluentcart-developer/references/engineering/adding-custom-pages-to-the-customer-dashboard.md +395 -395
  79. package/dist/skills/fluentcart-developer/references/engineering/index.md +4 -4
  80. package/dist/skills/fluentcart-developer/references/engineering.md +4 -4
  81. package/dist/skills/fluentcart-developer/references/getting-started.md +249 -249
  82. package/dist/skills/fluentcart-developer/references/guides/frontend.md +519 -519
  83. package/dist/skills/fluentcart-developer/references/guides/index.md +107 -107
  84. package/dist/skills/fluentcart-developer/references/guides/integrations.md +600 -600
  85. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/index.md +237 -237
  86. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/labels-and-tracking.md +481 -481
  87. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/live-rates.md +269 -269
  88. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/reference.md +223 -223
  89. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier/settings.md +370 -370
  90. package/dist/skills/fluentcart-developer/references/guides/shipping-carrier.md +237 -237
  91. package/dist/skills/fluentcart-developer/references/guides/subscriptions.md +217 -217
  92. package/dist/skills/fluentcart-developer/references/hooks/actions/admin-and-templates.md +1079 -1079
  93. package/dist/skills/fluentcart-developer/references/hooks/actions/cart-and-checkout.md +1795 -1795
  94. package/dist/skills/fluentcart-developer/references/hooks/actions/customers-and-users.md +327 -327
  95. package/dist/skills/fluentcart-developer/references/hooks/actions/licenses.md +829 -829
  96. package/dist/skills/fluentcart-developer/references/hooks/actions/modules.md +81 -81
  97. package/dist/skills/fluentcart-developer/references/hooks/actions/orders.md +757 -757
  98. package/dist/skills/fluentcart-developer/references/hooks/actions/payments-and-integrations.md +1163 -1163
  99. package/dist/skills/fluentcart-developer/references/hooks/actions/pro-modules.md +219 -219
  100. package/dist/skills/fluentcart-developer/references/hooks/actions/products-and-coupons.md +1019 -1019
  101. package/dist/skills/fluentcart-developer/references/hooks/actions/subscriptions.md +1290 -1290
  102. package/dist/skills/fluentcart-developer/references/hooks/actions.md +16 -16
  103. package/dist/skills/fluentcart-developer/references/hooks/deprecated.md +60 -60
  104. package/dist/skills/fluentcart-developer/references/hooks/filters/cart-and-checkout.md +2032 -2032
  105. package/dist/skills/fluentcart-developer/references/hooks/filters/customers-and-subscriptions.md +1746 -1746
  106. package/dist/skills/fluentcart-developer/references/hooks/filters/integrations-and-advanced.md +2439 -2439
  107. package/dist/skills/fluentcart-developer/references/hooks/filters/modules.md +464 -464
  108. package/dist/skills/fluentcart-developer/references/hooks/filters/orders-and-payments.md +2658 -2658
  109. package/dist/skills/fluentcart-developer/references/hooks/filters/pro-modules.md +502 -502
  110. package/dist/skills/fluentcart-developer/references/hooks/filters/products-and-pricing.md +1785 -1785
  111. package/dist/skills/fluentcart-developer/references/hooks/filters/settings-and-configuration.md +2966 -2966
  112. package/dist/skills/fluentcart-developer/references/hooks/filters.md +14 -14
  113. package/dist/skills/fluentcart-developer/references/hooks/index.md +35 -35
  114. package/dist/skills/fluentcart-developer/references/index.md +625 -625
  115. package/dist/skills/fluentcart-developer/references/modules/fee-system.md +427 -427
  116. package/dist/skills/fluentcart-developer/references/modules/ghost-product-selling.md +440 -440
  117. package/dist/skills/fluentcart-developer/references/modules/index.md +484 -484
  118. package/dist/skills/fluentcart-developer/references/modules/licensing.md +342 -342
  119. package/dist/skills/fluentcart-developer/references/modules/order-bump.md +433 -433
  120. package/dist/skills/fluentcart-developer/references/modules/payment-methods.md +129 -129
  121. package/dist/skills/fluentcart-developer/references/modules/refunds.md +170 -170
  122. package/dist/skills/fluentcart-developer/references/modules/shipping.md +846 -846
  123. package/dist/skills/fluentcart-developer/references/modules/storage.md +986 -986
  124. package/dist/skills/fluentcart-developer/references/modules/subscription-vendor-ids.md +186 -186
  125. package/dist/skills/fluentcart-developer/references/modules/subscriptions.md +678 -678
  126. package/dist/skills/fluentcart-developer/references/payment-methods-integration/index.md +164 -164
  127. package/dist/skills/fluentcart-developer/references/payment-methods-integration/paddle-example.md +1648 -1648
  128. package/dist/skills/fluentcart-developer/references/payment-methods-integration/payment/setting/fields.md +353 -353
  129. package/dist/skills/fluentcart-developer/references/payment-methods-integration/quick-implementation.md +1079 -1079
  130. package/dist/skills/fluentcart-developer/references/payment-methods-integration.md +164 -164
  131. package/dist/skills/fluentcart-developer/references/restapi/checkout.md +573 -573
  132. package/dist/skills/fluentcart-developer/references/restapi/coupons.md +958 -958
  133. package/dist/skills/fluentcart-developer/references/restapi/customer-profile.md +1423 -1423
  134. package/dist/skills/fluentcart-developer/references/restapi/customers.md +1103 -1103
  135. package/dist/skills/fluentcart-developer/references/restapi/dashboard.md +1083 -1083
  136. package/dist/skills/fluentcart-developer/references/restapi/data-export.md +132 -132
  137. package/dist/skills/fluentcart-developer/references/restapi/email-notifications.md +846 -846
  138. package/dist/skills/fluentcart-developer/references/restapi/files.md +313 -313
  139. package/dist/skills/fluentcart-developer/references/restapi/index.md +127 -127
  140. package/dist/skills/fluentcart-developer/references/restapi/integrations.md +1000 -1000
  141. package/dist/skills/fluentcart-developer/references/restapi/inventory.md +192 -192
  142. package/dist/skills/fluentcart-developer/references/restapi/labels-and-attributes.md +797 -797
  143. package/dist/skills/fluentcart-developer/references/restapi/licensing.md +1733 -1733
  144. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-available-shipping-methods.md +30 -30
  145. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-checkout-summary.md +28 -28
  146. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-country-info.md +29 -29
  147. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-order-info.md +28 -28
  148. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/get-shipping-methods-list-view.md +30 -30
  149. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/login.md +66 -66
  150. package/dist/skills/fluentcart-developer/references/restapi/operations/checkout/place-order.md +179 -179
  151. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/apply-coupon.md +83 -83
  152. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/cancel-coupon.md +87 -87
  153. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/check-product-eligibility.md +59 -59
  154. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/create-coupon.md +230 -230
  155. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/delete-coupon.md +29 -29
  156. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon-settings.md +20 -20
  157. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/get-coupon.md +27 -27
  158. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupon-codes.md +20 -20
  159. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/list-coupons.md +37 -37
  160. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/re-apply-coupons.md +75 -75
  161. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/store-coupon-settings.md +40 -40
  162. package/dist/skills/fluentcart-developer/references/restapi/operations/coupons/update-coupon.md +133 -133
  163. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-address-checkout.md +138 -138
  164. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/create-profile-address.md +119 -119
  165. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/dashboard-overview.md +22 -22
  166. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/delete-profile-address.md +46 -46
  167. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-order-details.md +30 -30
  168. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-portal-sections.md +29 -29
  169. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-profile-details.md +22 -22
  170. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-transaction-billing-address.md +30 -30
  171. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/get-upgrade-paths.md +31 -31
  172. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-downloads.md +29 -29
  173. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/list-orders.md +28 -28
  174. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/make-profile-address-primary.md +55 -55
  175. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/pause-subscription.md +29 -29
  176. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/resume-subscription.md +29 -29
  177. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/save-transaction-billing-address.md +92 -92
  178. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/select-address-for-checkout.md +32 -32
  179. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-address.md +115 -115
  180. package/dist/skills/fluentcart-developer/references/restapi/operations/customer-profile/update-profile-details.md +69 -69
  181. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/attach-user.md +50 -50
  182. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/bulk-actions.md +65 -65
  183. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-address.md +135 -135
  184. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/create-customer.md +108 -108
  185. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/delete-address.md +62 -62
  186. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/detach-user.md +28 -28
  187. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/find-customer-order.md +27 -27
  188. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-attachable-users.md +20 -20
  189. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-addresses.md +28 -28
  190. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-orders.md +37 -37
  191. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer-stats.md +27 -27
  192. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/get-customer.md +32 -32
  193. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/list-customers.md +37 -37
  194. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/recalculate-ltv.md +28 -28
  195. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/set-primary-address.md +72 -72
  196. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-additional-info.md +55 -55
  197. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-address.md +144 -144
  198. package/dist/skills/fluentcart-developer/references/restapi/operations/customers/update-customer.md +123 -123
  199. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/attach-note-to-order.md +49 -49
  200. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-all-pages.md +21 -21
  201. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/create-single-page.md +55 -55
  202. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/delete-activity.md +28 -28
  203. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-country-info.md +29 -29
  204. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-dashboard-stats.md +22 -22
  205. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-filter-options.md +31 -31
  206. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-data.md +20 -20
  207. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-onboarding-settings.md +20 -20
  208. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-print-templates.md +20 -20
  209. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-search-options.md +27 -27
  210. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/get-widgets.md +28 -28
  211. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/initialize-app.md +20 -20
  212. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-activities.md +33 -33
  213. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-attachments.md +21 -21
  214. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/list-countries.md +20 -20
  215. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/mark-activity-read.md +53 -53
  216. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/run-data-backfills.md +21 -21
  217. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-settings.md +54 -54
  218. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-onboarding-tax-settings.md +73 -73
  219. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/save-print-templates.md +64 -64
  220. package/dist/skills/fluentcart-developer/references/restapi/operations/dashboard/upload-attachment.md +42 -42
  221. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-customers-batch.md +129 -129
  222. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-licenses-batch.md +133 -133
  223. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-orders-batch.md +129 -129
  224. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/export-subscriptions-batch.md +129 -129
  225. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-customers-export-schema.md +21 -21
  226. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-licenses-export-schema.md +26 -26
  227. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-orders-export-schema.md +21 -21
  228. package/dist/skills/fluentcart-developer/references/restapi/operations/data-export/get-subscriptions-export-schema.md +21 -21
  229. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/enable-notification.md +57 -57
  230. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-digest-settings.md +22 -22
  231. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-notification.md +30 -30
  232. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-reminders.md +22 -22
  233. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-settings.md +22 -22
  234. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/get-shortcodes.md +22 -22
  235. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/list-notifications.md +20 -20
  236. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-default-template.md +66 -66
  237. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/preview-notification.md +50 -50
  238. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-digest-settings.md +101 -101
  239. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-reminders.md +162 -162
  240. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/save-settings.md +99 -99
  241. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-digest-test.md +47 -47
  242. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/send-manual-reminder.md +51 -51
  243. package/dist/skills/fluentcart-developer/references/restapi/operations/email-notification/update-notification.md +93 -93
  244. package/dist/skills/fluentcart-developer/references/restapi/operations/files/delete-file.md +31 -31
  245. package/dist/skills/fluentcart-developer/references/restapi/operations/files/get-bucket-list.md +28 -28
  246. package/dist/skills/fluentcart-developer/references/restapi/operations/files/list-files.md +30 -30
  247. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-editor-file.md +32 -32
  248. package/dist/skills/fluentcart-developer/references/restapi/operations/files/upload-file.md +34 -34
  249. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/chained-data-request.md +46 -46
  250. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/change-feed-status.md +51 -51
  251. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/delete-feed.md +27 -27
  252. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-dynamic-options.md +29 -29
  253. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-lists.md +27 -27
  254. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-feed-settings.md +27 -27
  255. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-feeds.md +20 -20
  256. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/get-global-settings.md +26 -26
  257. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/install-addon-plugin.md +49 -49
  258. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/list-addons.md +20 -20
  259. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/save-feed-settings.md +52 -52
  260. package/dist/skills/fluentcart-developer/references/restapi/operations/integration/set-global-settings.md +50 -50
  261. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/bulk-update-stock.md +94 -94
  262. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/export-inventory.md +81 -81
  263. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-adjustment-history.md +26 -26
  264. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/get-inventory-stats.md +21 -21
  265. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/list-inventory.md +33 -33
  266. package/dist/skills/fluentcart-developer/references/restapi/operations/inventory/update-stock.md +75 -75
  267. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-attribute-group.md +31 -31
  268. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-label.md +31 -31
  269. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/create-terms.md +90 -90
  270. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-group.md +28 -28
  271. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/delete-attribute-term.md +29 -29
  272. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-group.md +28 -28
  273. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/get-attribute-library.md +20 -20
  274. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-groups.md +32 -32
  275. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-attribute-terms.md +33 -33
  276. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/list-labels.md +20 -20
  277. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-groups.md +51 -51
  278. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/reorder-terms.md +56 -56
  279. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-group.md +37 -37
  280. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-attribute-term.md +39 -39
  281. package/dist/skills/fluentcart-developer/references/restapi/operations/labels-attributes/update-label-selections.md +32 -32
  282. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-plugin-license.md +41 -41
  283. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/activate-site-admin.md +60 -60
  284. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-plugin-license.md +18 -18
  285. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-admin.md +67 -67
  286. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/deactivate-site-customer.md +47 -47
  287. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/delete-license.md +24 -24
  288. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/extend-license-validity.md +47 -47
  289. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-license-details.md +25 -25
  290. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-customer-licenses-admin.md +26 -26
  291. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-activations.md +25 -25
  292. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-details.md +25 -25
  293. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-license-site.md +30 -30
  294. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-plugin-license-status.md +18 -18
  295. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/get-product-license-settings.md +24 -24
  296. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-customer-licenses.md +25 -25
  297. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-license-sites.md +33 -33
  298. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/list-licenses.md +38 -38
  299. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-activate-license.md +54 -54
  300. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-check-license.md +26 -26
  301. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-deactivate-license.md +46 -46
  302. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-download-license-package.md +23 -23
  303. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/public-get-license-version.md +26 -26
  304. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/regenerate-license-key.md +24 -24
  305. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/save-product-license-settings.md +193 -193
  306. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-activation-limit.md +53 -53
  307. package/dist/skills/fluentcart-developer/references/restapi/operations/licensing/update-license-status.md +52 -52
  308. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/create-order-bump.md +47 -47
  309. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/delete-order-bump.md +25 -25
  310. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/get-order-bump.md +25 -25
  311. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/list-order-bumps.md +29 -29
  312. package/dist/skills/fluentcart-developer/references/restapi/operations/order-bumps/update-order-bump.md +141 -141
  313. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/accept-dispute.md +47 -47
  314. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/bulk-actions.md +72 -72
  315. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-shipping.md +67 -67
  316. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/calculate-tax.md +98 -98
  317. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/change-customer.md +50 -50
  318. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/charge-now.md +29 -29
  319. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-and-change-customer.md +92 -92
  320. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-custom-order-item.md +68 -68
  321. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-order.md +351 -351
  322. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/create-renewal-now.md +29 -29
  323. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/delete-order.md +28 -28
  324. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/generate-missing-licenses.md +29 -29
  325. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order-transactions.md +27 -27
  326. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-order.md +27 -27
  327. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-renewal.md +28 -28
  328. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-shipping-methods.md +28 -28
  329. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/get-single-transaction.md +28 -28
  330. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-order-currencies.md +22 -22
  331. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-orders.md +42 -42
  332. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/list-renewals.md +28 -28
  333. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/mark-as-paid.md +61 -61
  334. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/price-order.md +135 -135
  335. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/refund-order.md +72 -72
  336. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/resend-renewal-invoice.md +29 -29
  337. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/skip-renewal.md +48 -48
  338. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-order-statuses.md +28 -28
  339. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/sync-pending-transaction.md +29 -29
  340. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address-id.md +60 -60
  341. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order-address.md +98 -98
  342. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-order.md +172 -172
  343. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-statuses.md +77 -77
  344. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-subscription-details.md +84 -84
  345. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/update-transaction-status.md +51 -51
  346. package/dist/skills/fluentcart-developer/references/restapi/operations/orders/void-renewal.md +30 -30
  347. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/create-pdf-template.md +42 -42
  348. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/delete-pdf-template.md +26 -26
  349. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/download-pdf-preview.md +44 -44
  350. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-factory-default-templates.md +19 -19
  351. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-status.md +21 -21
  352. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-pdf-template.md +26 -26
  353. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-saved-templates.md +21 -21
  354. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/get-seller-details.md +19 -19
  355. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/list-pdf-templates.md +19 -19
  356. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-pdf-template.md +53 -53
  357. package/dist/skills/fluentcart-developer/references/restapi/operations/pdf-templates/save-seller-details.md +97 -97
  358. package/dist/skills/fluentcart-developer/references/restapi/operations/products/add-product-terms.md +64 -64
  359. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-edit-fetch.md +30 -30
  360. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-insert-products.md +62 -62
  361. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-products.md +59 -59
  362. package/dist/skills/fluentcart-developer/references/restapi/operations/products/bulk-update-variants.md +83 -83
  363. package/dist/skills/fluentcart-developer/references/restapi/operations/products/change-integration-status.md +64 -64
  364. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-dummy-products.md +45 -45
  365. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-product.md +81 -81
  366. package/dist/skills/fluentcart-developer/references/restapi/operations/products/create-variation.md +181 -181
  367. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-downloadable-file.md +27 -27
  368. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product-integration.md +30 -30
  369. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-product.md +27 -27
  370. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-taxonomy-term.md +55 -55
  371. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-upgrade-path.md +27 -27
  372. package/dist/skills/fluentcart-developer/references/restapi/operations/products/delete-variation.md +27 -27
  373. package/dist/skills/fluentcart-developer/references/restapi/operations/products/do-bulk-action.md +56 -56
  374. package/dist/skills/fluentcart-developer/references/restapi/operations/products/duplicate-product.md +56 -56
  375. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-products-by-ids.md +26 -26
  376. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-taxonomy-terms.md +20 -20
  377. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-terms-by-parent.md +60 -60
  378. package/dist/skills/fluentcart-developer/references/restapi/operations/products/fetch-variations-by-ids.md +26 -26
  379. package/dist/skills/fluentcart-developer/references/restapi/operations/products/find-subscription-variants.md +26 -26
  380. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-bundle-info.md +27 -27
  381. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-downloadable-url.md +27 -27
  382. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-max-excerpt-word-count.md +20 -20
  383. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-pricing-widgets.md +27 -27
  384. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-feeds.md +29 -29
  385. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-integration-settings.md +31 -31
  386. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product-pricing.md +28 -28
  387. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-product.md +28 -28
  388. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-related-products.md +31 -31
  389. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-upgrade-settings.md +27 -27
  390. package/dist/skills/fluentcart-developer/references/restapi/operations/products/get-variation-upgrade-paths.md +28 -28
  391. package/dist/skills/fluentcart-developer/references/restapi/operations/products/group-bulk-update-variants.md +103 -103
  392. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-all-variants.md +26 -26
  393. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-product-variations.md +26 -26
  394. package/dist/skills/fluentcart-developer/references/restapi/operations/products/list-products.md +34 -34
  395. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-shipping-class.md +27 -27
  396. package/dist/skills/fluentcart-developer/references/restapi/operations/products/remove-tax-class.md +27 -27
  397. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-bundle-info.md +56 -56
  398. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-product-integration.md +62 -62
  399. package/dist/skills/fluentcart-developer/references/restapi/operations/products/save-upgrade-path.md +78 -78
  400. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-product-variant-options.md +29 -29
  401. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-products-by-name.md +28 -28
  402. package/dist/skills/fluentcart-developer/references/restapi/operations/products/search-variants-by-name.md +28 -28
  403. package/dist/skills/fluentcart-developer/references/restapi/operations/products/set-variation-media.md +74 -74
  404. package/dist/skills/fluentcart-developer/references/restapi/operations/products/suggest-sku.md +28 -28
  405. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-downloadable-files.md +134 -134
  406. package/dist/skills/fluentcart-developer/references/restapi/operations/products/sync-taxonomy-terms.md +61 -61
  407. package/dist/skills/fluentcart-developer/references/restapi/operations/products/toggle-product-tax-exemption.md +56 -56
  408. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-downloadable-file.md +98 -98
  409. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-inventory.md +56 -56
  410. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-long-desc-editor-mode.md +49 -49
  411. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-manage-stock.md +53 -53
  412. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-detail.md +58 -58
  413. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-product-pricing.md +225 -225
  414. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-shipping-class.md +49 -49
  415. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-tax-class.md +49 -49
  416. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-upgrade-path.md +78 -78
  417. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-option.md +79 -79
  418. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variant-tax-exemption.md +56 -56
  419. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation-pricing-table.md +49 -49
  420. package/dist/skills/fluentcart-developer/references/restapi/operations/products/update-variation.md +105 -105
  421. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/get-product-views.md +34 -34
  422. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/list-products.md +42 -42
  423. package/dist/skills/fluentcart-developer/references/restapi/operations/public-shop/search-products.md +30 -30
  424. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/channel-rules.md +24 -24
  425. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/country-heat-map.md +22 -22
  426. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupon-overview.md +37 -37
  427. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/coupons.md +36 -36
  428. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-insights.md +31 -31
  429. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-overview.md +36 -36
  430. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-repeat.md +35 -35
  431. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segment-customers.md +36 -36
  432. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-segments.md +30 -30
  433. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/customer-value.md +34 -34
  434. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/dashboard-stats.md +30 -30
  435. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/failed-orders.md +34 -34
  436. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-new-vs-returning-customer.md +34 -34
  437. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-by-day-and-hour.md +34 -34
  438. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-report-meta.md +29 -29
  439. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/fetch-top-sold-products.md +34 -34
  440. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/future-renewals.md +31 -31
  441. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/generate-retention-snapshots.md +24 -24
  442. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-overview.md +30 -30
  443. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-activities.md +26 -26
  444. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-recent-orders.md +20 -20
  445. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/get-revenue.md +37 -37
  446. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-at-risk.md +35 -35
  447. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments-variations.md +33 -33
  448. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/installments.md +33 -33
  449. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/item-count-distribution.md +34 -34
  450. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-chart.md +30 -30
  451. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-pie-chart.md +22 -22
  452. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/license-summary.md +22 -22
  453. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/locations.md +43 -43
  454. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-chart.md +37 -37
  455. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-completion-time.md +34 -34
  456. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-mix.md +34 -34
  457. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/order-value-distribution.md +34 -34
  458. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-disputes.md +38 -38
  459. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods-methods.md +36 -36
  460. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/payment-methods.md +37 -37
  461. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison-launch.md +33 -33
  462. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-comparison.md +40 -40
  463. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-detail.md +37 -37
  464. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/product-sales.md +37 -37
  465. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/refunds-overview.md +37 -37
  466. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/retention-snapshots-step.md +45 -45
  467. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sales-growth-chart.md +35 -35
  468. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/save-channel-rules.md +73 -73
  469. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/source-channels.md +37 -37
  470. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/sources.md +49 -49
  471. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-cohorts.md +33 -33
  472. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-health.md +30 -30
  473. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-rebuys.md +37 -37
  474. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-retention.md +34 -34
  475. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscription-variations.md +22 -22
  476. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/subscriptions-overview.md +37 -37
  477. package/dist/skills/fluentcart-developer/references/restapi/operations/reports/weeks-between-refund.md +34 -34
  478. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/assign-role.md +48 -48
  479. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/delete-role-assignment.md +47 -47
  480. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/get-role.md +25 -25
  481. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-managers.md +18 -18
  482. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/list-roles.md +18 -18
  483. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/search-users.md +25 -25
  484. package/dist/skills/fluentcart-developer/references/restapi/operations/roles-permissions/update-role.md +43 -43
  485. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/create-saved-view.md +106 -106
  486. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/delete-saved-view.md +26 -26
  487. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/list-saved-views.md +25 -25
  488. package/dist/skills/fluentcart-developer/references/restapi/operations/saved-views/update-saved-view.md +83 -83
  489. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-payment-addon.md +44 -44
  490. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/activate-plugin-addon.md +44 -44
  491. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/change-storage-driver-status.md +56 -56
  492. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/check-paypal-webhook.md +26 -26
  493. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/create-storage-bucket.md +63 -63
  494. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/disconnect-payment-method.md +55 -55
  495. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/exchange-paypal-seller-auth-token.md +62 -62
  496. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-active-storage-drivers.md +20 -20
  497. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-checkout-fields.md +22 -22
  498. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-email-shortcodes.md +20 -20
  499. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-config-snippets.md +26 -26
  500. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-mcp-status.md +20 -20
  501. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-module-settings.md +20 -20
  502. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-connection-info.md +26 -26
  503. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-payment-method-settings.md +26 -26
  504. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-permissions.md +22 -22
  505. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-plugin-addons.md +20 -20
  506. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-storage-driver-settings.md +27 -27
  507. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/get-store-settings.md +26 -26
  508. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-mcp-adapter.md +21 -21
  509. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-payment-addon.md +60 -60
  510. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/install-plugin-addon.md +64 -64
  511. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-payment-methods.md +20 -20
  512. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-all-storage-drivers.md +20 -20
  513. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/list-storage-buckets.md +67 -67
  514. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reorder-payment-methods.md +55 -55
  515. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/reset-storage-driver-settings.md +45 -45
  516. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-checkout-fields.md +133 -133
  517. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-confirmation-settings.md +68 -68
  518. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-module-settings.md +68 -68
  519. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-design.md +67 -67
  520. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-payment-method-settings.md +58 -58
  521. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-permissions.md +68 -68
  522. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-storage-driver-settings.md +62 -62
  523. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/save-store-settings.md +239 -239
  524. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/setup-paypal-webhook.md +48 -48
  525. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/toggle-mcp.md +40 -40
  526. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-storage-driver-connection.md +62 -62
  527. package/dist/skills/fluentcart-developer/references/restapi/operations/settings/verify-turnstile-keys.md +55 -55
  528. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-class.md +73 -73
  529. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-method.md +110 -110
  530. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/create-shipping-zone.md +56 -56
  531. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-class.md +29 -29
  532. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-method.md +29 -29
  533. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/delete-shipping-zone.md +29 -29
  534. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class-profile.md +30 -30
  535. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-class.md +29 -29
  536. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-packages.md +22 -22
  537. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-shipping-zone.md +27 -27
  538. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-countries.md +22 -22
  539. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/get-zone-states.md +28 -28
  540. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-classes.md +31 -31
  541. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/list-shipping-zones.md +31 -31
  542. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/save-shipping-packages.md +112 -112
  543. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-class.md +79 -79
  544. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-method.md +113 -113
  545. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-shipping-zone.md +62 -62
  546. package/dist/skills/fluentcart-developer/references/restapi/operations/shipping/update-zone-order.md +52 -52
  547. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-auto-renew.md +30 -30
  548. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/cancel-subscription.md +52 -52
  549. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/confirm-subscription-switch.md +70 -70
  550. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/fetch-subscription-remote.md +28 -28
  551. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/generate-early-payment-link.md +29 -29
  552. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-customer-subscription.md +27 -27
  553. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-or-create-plan.md +69 -69
  554. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-setup-intent-attempts.md +30 -30
  555. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/get-subscription.md +28 -28
  556. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/initiate-early-payment.md +31 -31
  557. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-customer-subscriptions.md +27 -27
  558. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/list-subscriptions.md +39 -39
  559. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/pause-subscription.md +28 -28
  560. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/reactivate-subscription.md +28 -28
  561. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/resume-subscription.md +28 -28
  562. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/switch-payment-method.md +70 -70
  563. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-payment-method.md +69 -69
  564. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/update-vendor-ids.md +56 -56
  565. package/dist/skills/fluentcart-developer/references/restapi/operations/subscriptions/verify-vendor-ids.md +56 -56
  566. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-class.md +51 -51
  567. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/create-tax-rate.md +117 -117
  568. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-product-override.md +27 -27
  569. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-shipping-tax-override.md +27 -27
  570. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-class.md +28 -28
  571. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/delete-tax-rate.md +27 -27
  572. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-id.md +27 -27
  573. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-country-tax-rates.md +28 -28
  574. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-eu-vat-product-overrides.md +20 -20
  575. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-oss-country-rates.md +20 -20
  576. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-preconfigured-tax-rates.md +20 -20
  577. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-product-overrides.md +27 -27
  578. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/get-tax-settings.md +20 -20
  579. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-all-tax-rates.md +20 -20
  580. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-classes.md +20 -20
  581. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/list-tax-records.md +37 -37
  582. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/mark-taxes-as-filed.md +58 -58
  583. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/reset-eu-vat-rates.md +21 -21
  584. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-configured-countries.md +57 -57
  585. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-country-tax-id.md +50 -50
  586. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-eu-vat-cross-border-settings.md +127 -127
  587. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-oss-country-rates.md +100 -100
  588. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-product-override.md +110 -110
  589. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-shipping-tax-override.md +52 -52
  590. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/save-tax-settings.md +166 -166
  591. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-country-status.md +54 -54
  592. package/dist/skills/fluentcart-developer/references/restapi/operations/tax/update-tax-rate.md +116 -116
  593. package/dist/skills/fluentcart-developer/references/restapi/order-bumps.md +433 -433
  594. package/dist/skills/fluentcart-developer/references/restapi/orders.md +1212 -1212
  595. package/dist/skills/fluentcart-developer/references/restapi/pdf-templates.md +212 -212
  596. package/dist/skills/fluentcart-developer/references/restapi/products.md +2485 -2485
  597. package/dist/skills/fluentcart-developer/references/restapi/public-shop.md +191 -191
  598. package/dist/skills/fluentcart-developer/references/restapi/reports.md +3773 -3773
  599. package/dist/skills/fluentcart-developer/references/restapi/roles.md +403 -403
  600. package/dist/skills/fluentcart-developer/references/restapi/saved-views.md +136 -136
  601. package/dist/skills/fluentcart-developer/references/restapi/settings.md +1423 -1423
  602. package/dist/skills/fluentcart-developer/references/restapi/shipping.md +905 -905
  603. package/dist/skills/fluentcart-developer/references/restapi/subscriptions.md +1169 -1169
  604. package/dist/skills/fluentcart-developer/references/restapi/tax.md +1551 -1551
  605. package/dist/skills/fluentcart-developer/references/restapi.md +127 -127
  606. package/dist/skills/fluentcart-developer/scripts/cli.js +1 -1
  607. package/dist/version.d.ts +1 -1
  608. package/dist/version.js +1 -1
  609. package/package.json +66 -65
@@ -22,1104 +22,1104 @@ function banner(appName, title, file, base, productId) {
22
22
  }
23
23
  export function nativeClientTemplate(platform, base, productId, appName) {
24
24
  if (platform === 'swift') {
25
- return `${banner(appName, 'Swift / iOS + macOS', 'LicenseClient.swift', base, productId)}
26
- import Foundation
27
- import Security
28
-
29
- struct LicenseState: Decodable {
30
- let status: String
31
- let entitlements: [Int]?
32
- let licenseToken: String?
33
- let errorType: String?
34
-
35
- enum CodingKeys: String, CodingKey {
36
- case status, entitlements
37
- case licenseToken = "license_token"
38
- case errorType = "error_type"
39
- }
40
-
41
- var isValid: Bool { return status == "valid" }
42
- }
43
-
44
- enum FastrLicense {
45
- static let store = "${base}"
46
- static let productId = ${productId}
47
-
48
- private static func post(_ verb: String, _ fields: [String: String]) -> [String: Any] {
49
- var request = URLRequest(url: URL(string: store + "?fluent-cart=" + verb)!)
50
- request.httpMethod = "POST"
51
- request.setValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
52
-
53
- var components = URLComponents()
54
- components.queryItems = fields.map { URLQueryItem(name: $0.key, value: $0.value) }
55
- request.httpBody = components.percentEncodedQuery?.data(using: .utf8)
56
-
57
- let semaphore = DispatchSemaphore(value: 0)
58
- var body: [String: Any] = [:]
59
-
60
- URLSession.shared.dataTask(with: request) { data, _, _ in
61
- if let data = data,
62
- let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
63
- body = json
64
- }
65
- semaphore.signal()
66
- }.resume()
67
-
68
- _ = semaphore.wait(timeout: .now() + 15)
69
- return body
70
- }
71
-
72
- private static func get(_ query: String) -> [String: Any] {
73
- guard let url = URL(string: store + "?fluent-cart=" + query) else { return [:] }
74
-
75
- let semaphore = DispatchSemaphore(value: 0)
76
- var body: [String: Any] = [:]
77
-
78
- URLSession.shared.dataTask(with: url) { data, _, _ in
79
- if let data = data,
80
- let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
81
- body = json
82
- }
83
- semaphore.signal()
84
- }.resume()
85
-
86
- _ = semaphore.wait(timeout: .now() + 15)
87
- return body
88
- }
89
-
90
- static func activate(key: String, instanceId: String, fingerprint: String, email: String) -> LicenseState? {
91
- let json = post("activate_license", [
92
- "item_id": String(productId),
93
- "license_key": key.trimmingCharacters(in: .whitespacesAndNewlines),
94
- "site_url": instanceId,
95
- "device_fingerprint": fingerprint,
96
- "device_name": ProcessInfo.processInfo.hostName,
97
- "device_type": "Desktop (Swift)",
98
- "os": ProcessInfo.processInfo.operatingSystemVersionString,
99
- "email": email,
100
- "server_version": Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "1.0.0"
101
- ])
102
-
103
- guard let data = try? JSONSerialization.data(withJSONObject: json) else { return nil }
104
- return try? JSONDecoder().decode(LicenseState.self, from: data)
105
- }
106
-
107
- static func check(key: String, instanceId: String, fingerprint: String) -> LicenseState? {
108
- let json = post("check_license", [
109
- "item_id": String(productId),
110
- "license_key": key,
111
- "site_url": instanceId,
112
- "device_fingerprint": fingerprint
113
- ])
114
-
115
- guard let data = try? JSONSerialization.data(withJSONObject: json) else { return nil }
116
- return try? JSONDecoder().decode(LicenseState.self, from: data)
117
- }
118
-
119
- static func deactivate(key: String, instanceId: String) {
120
- _ = post("deactivate_license", [
121
- "item_id": String(productId),
122
- "license_key": key,
123
- "site_url": instanceId
124
- ])
125
- }
126
-
127
- /// SecKey expects PKCS#1 for RSA. A PEM SubjectPublicKeyInfo carries a
128
- /// 24-byte header first, so strip it when present.
129
- static func verifyToken(_ token: String, publicKeyPem: String) -> [String: Any]? {
130
- let parts = token.split(separator: ".")
131
- guard parts.count == 3 else { return nil }
132
-
133
- let pem = publicKeyPem
134
- .replacingOccurrences(of: "-----BEGIN PUBLIC KEY-----", with: "")
135
- .replacingOccurrences(of: "-----END PUBLIC KEY-----", with: "")
136
- .components(separatedBy: .whitespacesAndNewlines).joined()
137
-
138
- guard var der = Data(base64Encoded: pem) else { return nil }
139
- if der.count > 24 { der = der.subdata(in: 24..<der.count) }
140
-
141
- let attributes: [String: Any] = [
142
- kSecAttrKeyType as String: kSecAttrKeyTypeRSA,
143
- kSecAttrKeyClass as String: kSecAttrKeyClassPublic
144
- ]
145
-
146
- guard let key = SecKeyCreateWithData(der as CFData, attributes as CFDictionary, nil),
147
- let signature = base64UrlDecode(String(parts[2])) else { return nil }
148
-
149
- let signed = Data((String(parts[0]) + "." + String(parts[1])).utf8)
150
-
151
- guard SecKeyVerifySignature(key, .rsaSignatureMessagePKCS1v15SHA256, signed as CFData, signature as CFData, nil),
152
- let payload = base64UrlDecode(String(parts[1])),
153
- let claims = try? JSONSerialization.jsonObject(with: payload) as? [String: Any] else { return nil }
154
-
155
- return claims
156
- }
157
-
158
- // Bind the token to THIS installation. verifyToken proves the store signed
159
- // it; it does not check expiry, this machine or this product. claims.fp is
160
- // a server-side HMAC that cannot be recomputed here, so claims.ins is the
161
- // binding a client is able to check.
162
- static func entitlement(
163
- _ token: String,
164
- publicKeyPem: String,
165
- installId: String?,
166
- productId: Int
167
- ) -> (claims: [String: Any]?, reason: String?) {
168
- guard let claims = verifyToken(token, publicKeyPem: publicKeyPem) else {
169
- return (nil, "invalid_or_expired")
170
- }
171
-
172
- if let exp = (claims["exp"] as? NSNumber)?.doubleValue, exp <= Date().timeIntervalSince1970 {
173
- return (nil, "invalid_or_expired")
174
- }
175
-
176
- if productId > 0, let prod = (claims["prod"] as? NSNumber)?.intValue, prod != productId {
177
- return (nil, "wrong_product")
178
- }
179
-
180
- if let installId = installId, !installId.isEmpty,
181
- let ins = claims["ins"] as? String, ins != installId {
182
- return (nil, "wrong_install")
183
- }
184
-
185
- return (claims, nil)
186
- }
187
-
188
- private static func base64UrlDecode(_ value: String) -> Data? {
189
- var base64 = value.replacingOccurrences(of: "-", with: "+").replacingOccurrences(of: "_", with: "/")
190
- base64 += String(repeating: "=", count: (4 - base64.count % 4) % 4)
191
- return Data(base64Encoded: base64)
192
- }
193
-
194
- static func latestRelease(key: String, current: String, platform: String = "any") -> [String: Any] {
195
- var components = URLComponents()
196
- components.queryItems = [
197
- URLQueryItem(name: "product_id", value: String(productId)),
198
- URLQueryItem(name: "platform", value: platform),
199
- URLQueryItem(name: "current_version", value: current),
200
- URLQueryItem(name: "license_key", value: key)
201
- ]
202
-
203
- return get("fastr_release_latest&" + (components.percentEncodedQuery ?? ""))
204
- }
205
-
206
- static func reportUsage(key: String, metric: String, quantity: Int, idempotencyKey: String) -> [String: Any] {
207
- post("fastr_usage_report", [
208
- "license_key": key,
209
- "metric": metric,
210
- "quantity": String(quantity),
211
- "idempotency_key": idempotencyKey
212
- ])
213
- }
214
- }
25
+ return `${banner(appName, 'Swift / iOS + macOS', 'LicenseClient.swift', base, productId)}
26
+ import Foundation
27
+ import Security
28
+
29
+ struct LicenseState: Decodable {
30
+ let status: String
31
+ let entitlements: [Int]?
32
+ let licenseToken: String?
33
+ let errorType: String?
34
+
35
+ enum CodingKeys: String, CodingKey {
36
+ case status, entitlements
37
+ case licenseToken = "license_token"
38
+ case errorType = "error_type"
39
+ }
40
+
41
+ var isValid: Bool { return status == "valid" }
42
+ }
43
+
44
+ enum FastrLicense {
45
+ static let store = "${base}"
46
+ static let productId = ${productId}
47
+
48
+ private static func post(_ verb: String, _ fields: [String: String]) -> [String: Any] {
49
+ var request = URLRequest(url: URL(string: store + "?fluent-cart=" + verb)!)
50
+ request.httpMethod = "POST"
51
+ request.setValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
52
+
53
+ var components = URLComponents()
54
+ components.queryItems = fields.map { URLQueryItem(name: $0.key, value: $0.value) }
55
+ request.httpBody = components.percentEncodedQuery?.data(using: .utf8)
56
+
57
+ let semaphore = DispatchSemaphore(value: 0)
58
+ var body: [String: Any] = [:]
59
+
60
+ URLSession.shared.dataTask(with: request) { data, _, _ in
61
+ if let data = data,
62
+ let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
63
+ body = json
64
+ }
65
+ semaphore.signal()
66
+ }.resume()
67
+
68
+ _ = semaphore.wait(timeout: .now() + 15)
69
+ return body
70
+ }
71
+
72
+ private static func get(_ query: String) -> [String: Any] {
73
+ guard let url = URL(string: store + "?fluent-cart=" + query) else { return [:] }
74
+
75
+ let semaphore = DispatchSemaphore(value: 0)
76
+ var body: [String: Any] = [:]
77
+
78
+ URLSession.shared.dataTask(with: url) { data, _, _ in
79
+ if let data = data,
80
+ let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
81
+ body = json
82
+ }
83
+ semaphore.signal()
84
+ }.resume()
85
+
86
+ _ = semaphore.wait(timeout: .now() + 15)
87
+ return body
88
+ }
89
+
90
+ static func activate(key: String, instanceId: String, fingerprint: String, email: String) -> LicenseState? {
91
+ let json = post("activate_license", [
92
+ "item_id": String(productId),
93
+ "license_key": key.trimmingCharacters(in: .whitespacesAndNewlines),
94
+ "site_url": instanceId,
95
+ "device_fingerprint": fingerprint,
96
+ "device_name": ProcessInfo.processInfo.hostName,
97
+ "device_type": "Desktop (Swift)",
98
+ "os": ProcessInfo.processInfo.operatingSystemVersionString,
99
+ "email": email,
100
+ "server_version": Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "1.0.0"
101
+ ])
102
+
103
+ guard let data = try? JSONSerialization.data(withJSONObject: json) else { return nil }
104
+ return try? JSONDecoder().decode(LicenseState.self, from: data)
105
+ }
106
+
107
+ static func check(key: String, instanceId: String, fingerprint: String) -> LicenseState? {
108
+ let json = post("check_license", [
109
+ "item_id": String(productId),
110
+ "license_key": key,
111
+ "site_url": instanceId,
112
+ "device_fingerprint": fingerprint
113
+ ])
114
+
115
+ guard let data = try? JSONSerialization.data(withJSONObject: json) else { return nil }
116
+ return try? JSONDecoder().decode(LicenseState.self, from: data)
117
+ }
118
+
119
+ static func deactivate(key: String, instanceId: String) {
120
+ _ = post("deactivate_license", [
121
+ "item_id": String(productId),
122
+ "license_key": key,
123
+ "site_url": instanceId
124
+ ])
125
+ }
126
+
127
+ /// SecKey expects PKCS#1 for RSA. A PEM SubjectPublicKeyInfo carries a
128
+ /// 24-byte header first, so strip it when present.
129
+ static func verifyToken(_ token: String, publicKeyPem: String) -> [String: Any]? {
130
+ let parts = token.split(separator: ".")
131
+ guard parts.count == 3 else { return nil }
132
+
133
+ let pem = publicKeyPem
134
+ .replacingOccurrences(of: "-----BEGIN PUBLIC KEY-----", with: "")
135
+ .replacingOccurrences(of: "-----END PUBLIC KEY-----", with: "")
136
+ .components(separatedBy: .whitespacesAndNewlines).joined()
137
+
138
+ guard var der = Data(base64Encoded: pem) else { return nil }
139
+ if der.count > 24 { der = der.subdata(in: 24..<der.count) }
140
+
141
+ let attributes: [String: Any] = [
142
+ kSecAttrKeyType as String: kSecAttrKeyTypeRSA,
143
+ kSecAttrKeyClass as String: kSecAttrKeyClassPublic
144
+ ]
145
+
146
+ guard let key = SecKeyCreateWithData(der as CFData, attributes as CFDictionary, nil),
147
+ let signature = base64UrlDecode(String(parts[2])) else { return nil }
148
+
149
+ let signed = Data((String(parts[0]) + "." + String(parts[1])).utf8)
150
+
151
+ guard SecKeyVerifySignature(key, .rsaSignatureMessagePKCS1v15SHA256, signed as CFData, signature as CFData, nil),
152
+ let payload = base64UrlDecode(String(parts[1])),
153
+ let claims = try? JSONSerialization.jsonObject(with: payload) as? [String: Any] else { return nil }
154
+
155
+ return claims
156
+ }
157
+
158
+ // Bind the token to THIS installation. verifyToken proves the store signed
159
+ // it; it does not check expiry, this machine or this product. claims.fp is
160
+ // a server-side HMAC that cannot be recomputed here, so claims.ins is the
161
+ // binding a client is able to check.
162
+ static func entitlement(
163
+ _ token: String,
164
+ publicKeyPem: String,
165
+ installId: String?,
166
+ productId: Int
167
+ ) -> (claims: [String: Any]?, reason: String?) {
168
+ guard let claims = verifyToken(token, publicKeyPem: publicKeyPem) else {
169
+ return (nil, "invalid_or_expired")
170
+ }
171
+
172
+ if let exp = (claims["exp"] as? NSNumber)?.doubleValue, exp <= Date().timeIntervalSince1970 {
173
+ return (nil, "invalid_or_expired")
174
+ }
175
+
176
+ if productId > 0, let prod = (claims["prod"] as? NSNumber)?.intValue, prod != productId {
177
+ return (nil, "wrong_product")
178
+ }
179
+
180
+ if let installId = installId, !installId.isEmpty,
181
+ let ins = claims["ins"] as? String, ins != installId {
182
+ return (nil, "wrong_install")
183
+ }
184
+
185
+ return (claims, nil)
186
+ }
187
+
188
+ private static func base64UrlDecode(_ value: String) -> Data? {
189
+ var base64 = value.replacingOccurrences(of: "-", with: "+").replacingOccurrences(of: "_", with: "/")
190
+ base64 += String(repeating: "=", count: (4 - base64.count % 4) % 4)
191
+ return Data(base64Encoded: base64)
192
+ }
193
+
194
+ static func latestRelease(key: String, current: String, platform: String = "any") -> [String: Any] {
195
+ var components = URLComponents()
196
+ components.queryItems = [
197
+ URLQueryItem(name: "product_id", value: String(productId)),
198
+ URLQueryItem(name: "platform", value: platform),
199
+ URLQueryItem(name: "current_version", value: current),
200
+ URLQueryItem(name: "license_key", value: key)
201
+ ]
202
+
203
+ return get("fastr_release_latest&" + (components.percentEncodedQuery ?? ""))
204
+ }
205
+
206
+ static func reportUsage(key: String, metric: String, quantity: Int, idempotencyKey: String) -> [String: Any] {
207
+ post("fastr_usage_report", [
208
+ "license_key": key,
209
+ "metric": metric,
210
+ "quantity": String(quantity),
211
+ "idempotency_key": idempotencyKey
212
+ ])
213
+ }
214
+ }
215
215
  `;
216
216
  }
217
217
  if (platform === 'unity_csharp') {
218
- return `${banner(appName, 'Unity / C#', 'FastrLicense.cs', base, productId)}
219
- // UNVERIFIED: this target is emitted but never compiled in CI, because it
220
- // needs the Unity editor. Signature and token binding are written to the same
221
- // contract as the other clients, but only by inspection. Test it in your own
222
- // project before you ship on it.
223
- using System;
224
- using System.Collections.Generic;
225
- using System.Security.Cryptography;
226
- using System.Text;
227
- using System.Text.Json;
228
- using UnityEngine;
229
- using UnityEngine.Networking;
230
-
231
- public static class FastrLicense
232
- {
233
- private const string Store = "${base}";
234
- private const int ProductId = ${productId};
235
-
236
- public sealed class State
237
- {
238
- public string Status = "";
239
- public string Token;
240
- public string ErrorType;
241
- public List<int> Entitlements = new List<int>();
242
- public bool IsValid { get { return Status == "valid"; } }
243
- }
244
-
245
- private static string Call(string verb, Dictionary<string, string> body)
246
- {
247
- var form = new List<string>();
248
- foreach (var pair in body) form.Add(Uri.EscapeDataString(pair.Key) + "=" + Uri.EscapeDataString(pair.Value));
249
-
250
- using (var request = new UnityWebRequest(Store + "?fluent-cart=" + verb, "POST"))
251
- {
252
- request.uploadHandler = new UploadHandlerRaw(Encoding.UTF8.GetBytes(string.Join("&", form)));
253
- request.downloadHandler = new DownloadHandlerBuffer();
254
- request.SetRequestHeader("Content-Type", "application/x-www-form-urlencoded");
255
- request.timeout = 15;
256
-
257
- var operation = request.SendWebRequest();
258
- while (!operation.isDone) { }
259
-
260
- return request.downloadHandler.text;
261
- }
262
- }
263
-
264
- private static string Get(string url)
265
- {
266
- using (var request = UnityWebRequest.Get(url))
267
- {
268
- request.timeout = 15;
269
- var operation = request.SendWebRequest();
270
- while (!operation.isDone) { }
271
- return request.downloadHandler.text;
272
- }
273
- }
274
-
275
- private static State Parse(string json)
276
- {
277
- var state = new State();
278
- if (string.IsNullOrEmpty(json)) return state;
279
-
280
- using (var document = JsonDocument.Parse(json))
281
- {
282
- var root = document.RootElement;
283
- if (root.TryGetProperty("status", out var status)) state.Status = status.GetString() ?? "";
284
- if (root.TryGetProperty("license_token", out var token)) state.Token = token.GetString();
285
- if (root.TryGetProperty("error_type", out var error)) state.ErrorType = error.GetString();
286
- if (root.TryGetProperty("entitlements", out var ents) && ents.ValueKind == JsonValueKind.Array)
287
- foreach (var id in ents.EnumerateArray()) state.Entitlements.Add(id.GetInt32());
288
- }
289
-
290
- return state;
291
- }
292
-
293
- public static State Activate(string key, string instanceId, string fingerprint, string email)
294
- {
295
- return Parse(Call("activate_license", new Dictionary<string, string>
296
- {
297
- { "item_id", ProductId.ToString() },
298
- { "license_key", key.Trim() },
299
- { "site_url", instanceId },
300
- { "device_fingerprint", fingerprint },
301
- { "device_name", SystemInfo.deviceName },
302
- { "device_type", "Game (Unity)" },
303
- { "os", SystemInfo.operatingSystem },
304
- { "email", email },
305
- { "server_version", Application.version }
306
- }));
307
- }
308
-
309
- public static State Check(string key, string instanceId, string fingerprint)
310
- {
311
- return Parse(Call("check_license", new Dictionary<string, string>
312
- {
313
- { "item_id", ProductId.ToString() },
314
- { "license_key", key },
315
- { "site_url", instanceId },
316
- { "device_fingerprint", fingerprint }
317
- }));
318
- }
319
-
320
- public static void Deactivate(string key, string instanceId)
321
- {
322
- Call("deactivate_license", new Dictionary<string, string>
323
- {
324
- { "item_id", ProductId.ToString() },
325
- { "license_key", key },
326
- { "site_url", instanceId }
327
- });
328
- }
329
-
330
- /// <summary>Needs .NET Standard 2.1 (Unity 2021.2+) for ImportSubjectPublicKeyInfo.</summary>
331
- public static bool VerifyToken(string token, string publicKeyPem, out Dictionary<string, object> claims)
332
- {
333
- claims = null;
334
-
335
- var parts = token.Split('.');
336
- if (parts.Length != 3) return false;
337
-
338
- var der = Convert.FromBase64String(publicKeyPem
339
- .Replace("-----BEGIN PUBLIC KEY-----", "")
340
- .Replace("-----END PUBLIC KEY-----", "")
341
- .Replace("\\n", "").Replace("\\r", "").Trim());
342
-
343
- using (var rsa = RSA.Create())
344
- {
345
- rsa.ImportSubjectPublicKeyInfo(der, out _);
346
-
347
- var signed = Encoding.UTF8.GetBytes(parts[0] + "." + parts[1]);
348
-
349
- if (!rsa.VerifyData(signed, Base64UrlDecode(parts[2]), HashAlgorithmName.SHA256, RSASignaturePadding.Pkcs1))
350
- return false;
351
- }
352
-
353
- claims = JsonSerializer.Deserialize<Dictionary<string, object>>(
354
- Encoding.UTF8.GetString(Base64UrlDecode(parts[1])));
355
-
356
- return claims != null;
357
- }
358
-
359
- /// <summary>
360
- /// Bind the token to this installation. VerifyToken proves the store signed
361
- /// it; it does not check expiry, this machine or this product. claims.fp is
362
- /// a server-side HMAC that cannot be recomputed here, so claims.ins is the
363
- /// binding a client is able to check.
364
- /// </summary>
365
- public static bool Entitlement(
366
- string token,
367
- string publicKeyPem,
368
- string installId,
369
- int productId,
370
- out Dictionary<string, object> claims,
371
- out string reason)
372
- {
373
- reason = "";
374
-
375
- if (!VerifyToken(token, publicKeyPem, out claims))
376
- {
377
- reason = "invalid_or_expired";
378
- return false;
379
- }
380
-
381
- if (!claims.ContainsKey("exp")
382
- || Convert.ToInt64(claims["exp"]) <= DateTimeOffset.UtcNow.ToUnixTimeSeconds())
383
- {
384
- reason = "invalid_or_expired";
385
- return false;
386
- }
387
-
388
- if (productId > 0
389
- && (!claims.ContainsKey("prod") || Convert.ToInt32(claims["prod"]) != productId))
390
- {
391
- reason = "wrong_product";
392
- return false;
393
- }
394
-
395
- if (!string.IsNullOrEmpty(installId)
396
- && claims.ContainsKey("ins")
397
- && Convert.ToString(claims["ins"]) != installId)
398
- {
399
- reason = "wrong_install";
400
- return false;
401
- }
402
-
403
- return true;
404
- }
405
-
406
- private static byte[] Base64UrlDecode(string value)
407
- {
408
- var padded = value.Replace('-', '+').Replace('_', '/');
409
- padded += new string('=', (4 - padded.Length % 4) % 4);
410
- return Convert.FromBase64String(padded);
411
- }
412
-
413
- public static string LatestRelease(string key, string currentVersion)
414
- {
415
- var url = Store + "?fluent-cart=fastr_release_latest"
416
- + "&product_id=" + ProductId
417
- + "&platform=any"
418
- + "&current_version=" + UnityWebRequest.EscapeURL(currentVersion)
419
- + "&license_key=" + UnityWebRequest.EscapeURL(key);
420
-
421
- return Get(url);
422
- }
423
-
424
- public static string ReportUsage(string key, string metric, int quantity, string idempotencyKey)
425
- {
426
- return Call("fastr_usage_report", new Dictionary<string, string>
427
- {
428
- { "license_key", key },
429
- { "metric", metric },
430
- { "quantity", quantity.ToString() },
431
- { "idempotency_key", idempotencyKey }
432
- });
433
- }
434
- }
218
+ return `${banner(appName, 'Unity / C#', 'FastrLicense.cs', base, productId)}
219
+ // UNVERIFIED: this target is emitted but never compiled in CI, because it
220
+ // needs the Unity editor. Signature and token binding are written to the same
221
+ // contract as the other clients, but only by inspection. Test it in your own
222
+ // project before you ship on it.
223
+ using System;
224
+ using System.Collections.Generic;
225
+ using System.Security.Cryptography;
226
+ using System.Text;
227
+ using System.Text.Json;
228
+ using UnityEngine;
229
+ using UnityEngine.Networking;
230
+
231
+ public static class FastrLicense
232
+ {
233
+ private const string Store = "${base}";
234
+ private const int ProductId = ${productId};
235
+
236
+ public sealed class State
237
+ {
238
+ public string Status = "";
239
+ public string Token;
240
+ public string ErrorType;
241
+ public List<int> Entitlements = new List<int>();
242
+ public bool IsValid { get { return Status == "valid"; } }
243
+ }
244
+
245
+ private static string Call(string verb, Dictionary<string, string> body)
246
+ {
247
+ var form = new List<string>();
248
+ foreach (var pair in body) form.Add(Uri.EscapeDataString(pair.Key) + "=" + Uri.EscapeDataString(pair.Value));
249
+
250
+ using (var request = new UnityWebRequest(Store + "?fluent-cart=" + verb, "POST"))
251
+ {
252
+ request.uploadHandler = new UploadHandlerRaw(Encoding.UTF8.GetBytes(string.Join("&", form)));
253
+ request.downloadHandler = new DownloadHandlerBuffer();
254
+ request.SetRequestHeader("Content-Type", "application/x-www-form-urlencoded");
255
+ request.timeout = 15;
256
+
257
+ var operation = request.SendWebRequest();
258
+ while (!operation.isDone) { }
259
+
260
+ return request.downloadHandler.text;
261
+ }
262
+ }
263
+
264
+ private static string Get(string url)
265
+ {
266
+ using (var request = UnityWebRequest.Get(url))
267
+ {
268
+ request.timeout = 15;
269
+ var operation = request.SendWebRequest();
270
+ while (!operation.isDone) { }
271
+ return request.downloadHandler.text;
272
+ }
273
+ }
274
+
275
+ private static State Parse(string json)
276
+ {
277
+ var state = new State();
278
+ if (string.IsNullOrEmpty(json)) return state;
279
+
280
+ using (var document = JsonDocument.Parse(json))
281
+ {
282
+ var root = document.RootElement;
283
+ if (root.TryGetProperty("status", out var status)) state.Status = status.GetString() ?? "";
284
+ if (root.TryGetProperty("license_token", out var token)) state.Token = token.GetString();
285
+ if (root.TryGetProperty("error_type", out var error)) state.ErrorType = error.GetString();
286
+ if (root.TryGetProperty("entitlements", out var ents) && ents.ValueKind == JsonValueKind.Array)
287
+ foreach (var id in ents.EnumerateArray()) state.Entitlements.Add(id.GetInt32());
288
+ }
289
+
290
+ return state;
291
+ }
292
+
293
+ public static State Activate(string key, string instanceId, string fingerprint, string email)
294
+ {
295
+ return Parse(Call("activate_license", new Dictionary<string, string>
296
+ {
297
+ { "item_id", ProductId.ToString() },
298
+ { "license_key", key.Trim() },
299
+ { "site_url", instanceId },
300
+ { "device_fingerprint", fingerprint },
301
+ { "device_name", SystemInfo.deviceName },
302
+ { "device_type", "Game (Unity)" },
303
+ { "os", SystemInfo.operatingSystem },
304
+ { "email", email },
305
+ { "server_version", Application.version }
306
+ }));
307
+ }
308
+
309
+ public static State Check(string key, string instanceId, string fingerprint)
310
+ {
311
+ return Parse(Call("check_license", new Dictionary<string, string>
312
+ {
313
+ { "item_id", ProductId.ToString() },
314
+ { "license_key", key },
315
+ { "site_url", instanceId },
316
+ { "device_fingerprint", fingerprint }
317
+ }));
318
+ }
319
+
320
+ public static void Deactivate(string key, string instanceId)
321
+ {
322
+ Call("deactivate_license", new Dictionary<string, string>
323
+ {
324
+ { "item_id", ProductId.ToString() },
325
+ { "license_key", key },
326
+ { "site_url", instanceId }
327
+ });
328
+ }
329
+
330
+ /// <summary>Needs .NET Standard 2.1 (Unity 2021.2+) for ImportSubjectPublicKeyInfo.</summary>
331
+ public static bool VerifyToken(string token, string publicKeyPem, out Dictionary<string, object> claims)
332
+ {
333
+ claims = null;
334
+
335
+ var parts = token.Split('.');
336
+ if (parts.Length != 3) return false;
337
+
338
+ var der = Convert.FromBase64String(publicKeyPem
339
+ .Replace("-----BEGIN PUBLIC KEY-----", "")
340
+ .Replace("-----END PUBLIC KEY-----", "")
341
+ .Replace("\\n", "").Replace("\\r", "").Trim());
342
+
343
+ using (var rsa = RSA.Create())
344
+ {
345
+ rsa.ImportSubjectPublicKeyInfo(der, out _);
346
+
347
+ var signed = Encoding.UTF8.GetBytes(parts[0] + "." + parts[1]);
348
+
349
+ if (!rsa.VerifyData(signed, Base64UrlDecode(parts[2]), HashAlgorithmName.SHA256, RSASignaturePadding.Pkcs1))
350
+ return false;
351
+ }
352
+
353
+ claims = JsonSerializer.Deserialize<Dictionary<string, object>>(
354
+ Encoding.UTF8.GetString(Base64UrlDecode(parts[1])));
355
+
356
+ return claims != null;
357
+ }
358
+
359
+ /// <summary>
360
+ /// Bind the token to this installation. VerifyToken proves the store signed
361
+ /// it; it does not check expiry, this machine or this product. claims.fp is
362
+ /// a server-side HMAC that cannot be recomputed here, so claims.ins is the
363
+ /// binding a client is able to check.
364
+ /// </summary>
365
+ public static bool Entitlement(
366
+ string token,
367
+ string publicKeyPem,
368
+ string installId,
369
+ int productId,
370
+ out Dictionary<string, object> claims,
371
+ out string reason)
372
+ {
373
+ reason = "";
374
+
375
+ if (!VerifyToken(token, publicKeyPem, out claims))
376
+ {
377
+ reason = "invalid_or_expired";
378
+ return false;
379
+ }
380
+
381
+ if (!claims.ContainsKey("exp")
382
+ || Convert.ToInt64(claims["exp"]) <= DateTimeOffset.UtcNow.ToUnixTimeSeconds())
383
+ {
384
+ reason = "invalid_or_expired";
385
+ return false;
386
+ }
387
+
388
+ if (productId > 0
389
+ && (!claims.ContainsKey("prod") || Convert.ToInt32(claims["prod"]) != productId))
390
+ {
391
+ reason = "wrong_product";
392
+ return false;
393
+ }
394
+
395
+ if (!string.IsNullOrEmpty(installId)
396
+ && claims.ContainsKey("ins")
397
+ && Convert.ToString(claims["ins"]) != installId)
398
+ {
399
+ reason = "wrong_install";
400
+ return false;
401
+ }
402
+
403
+ return true;
404
+ }
405
+
406
+ private static byte[] Base64UrlDecode(string value)
407
+ {
408
+ var padded = value.Replace('-', '+').Replace('_', '/');
409
+ padded += new string('=', (4 - padded.Length % 4) % 4);
410
+ return Convert.FromBase64String(padded);
411
+ }
412
+
413
+ public static string LatestRelease(string key, string currentVersion)
414
+ {
415
+ var url = Store + "?fluent-cart=fastr_release_latest"
416
+ + "&product_id=" + ProductId
417
+ + "&platform=any"
418
+ + "&current_version=" + UnityWebRequest.EscapeURL(currentVersion)
419
+ + "&license_key=" + UnityWebRequest.EscapeURL(key);
420
+
421
+ return Get(url);
422
+ }
423
+
424
+ public static string ReportUsage(string key, string metric, int quantity, string idempotencyKey)
425
+ {
426
+ return Call("fastr_usage_report", new Dictionary<string, string>
427
+ {
428
+ { "license_key", key },
429
+ { "metric", metric },
430
+ { "quantity", quantity.ToString() },
431
+ { "idempotency_key", idempotencyKey }
432
+ });
433
+ }
434
+ }
435
435
  `;
436
436
  }
437
437
  if (platform === 'java') {
438
- return `${banner(appName, 'Java / JVM', 'FastrLicense.java', base, productId)}
439
- import java.io.ByteArrayOutputStream;
440
- import java.io.InputStream;
441
- import java.io.OutputStream;
442
- import java.net.HttpURLConnection;
443
- import java.net.URL;
444
- import java.net.URLEncoder;
445
- import java.nio.charset.StandardCharsets;
446
- import java.security.KeyFactory;
447
- import java.security.PublicKey;
448
- import java.security.Signature;
449
- import java.security.spec.X509EncodedKeySpec;
450
- import java.util.Base64;
451
- import java.util.LinkedHashMap;
452
- import java.util.Map;
453
-
454
- public final class FastrLicense {
455
-
456
- public static final String STORE = "${base}";
457
- public static final int PRODUCT_ID = ${productId};
458
-
459
- public static final class State {
460
- public String status = "";
461
- public String token;
462
- public String errorType;
463
- public boolean isValid() { return "valid".equals(status); }
464
- }
465
-
466
- private static String post(String verb, Map<String, String> fields) throws Exception {
467
- StringBuilder form = new StringBuilder();
468
- for (Map.Entry<String, String> entry : fields.entrySet()) {
469
- if (form.length() > 0) form.append('&');
470
- form.append(URLEncoder.encode(entry.getKey(), "UTF-8"))
471
- .append('=')
472
- .append(URLEncoder.encode(entry.getValue(), "UTF-8"));
473
- }
474
-
475
- HttpURLConnection connection = (HttpURLConnection) new URL(STORE + "?fluent-cart=" + verb).openConnection();
476
- connection.setRequestMethod("POST");
477
- connection.setDoOutput(true);
478
- connection.setConnectTimeout(15000);
479
- connection.setReadTimeout(15000);
480
- connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
481
-
482
- try (OutputStream out = connection.getOutputStream()) {
483
- out.write(form.toString().getBytes(StandardCharsets.UTF_8));
484
- }
485
-
486
- return read(connection);
487
- }
488
-
489
- private static String read(HttpURLConnection connection) throws Exception {
490
- try (InputStream in = connection.getInputStream()) {
491
- ByteArrayOutputStream buffer = new ByteArrayOutputStream();
492
- byte[] chunk = new byte[8192];
493
- int count;
494
- while ((count = in.read(chunk)) != -1) buffer.write(chunk, 0, count);
495
- return buffer.toString("UTF-8");
496
- }
497
- }
498
-
499
- /** Minimal field reader; swap in Jackson or Gson in a real project. */
500
- private static String field(String json, String name) {
501
- int at = json.indexOf("\\"" + name + "\\"");
502
- if (at < 0) return null;
503
-
504
- int colon = json.indexOf(':', at);
505
- if (colon < 0) return null;
506
-
507
- int start = colon + 1;
508
- while (start < json.length() && Character.isWhitespace(json.charAt(start))) start++;
509
- if (start >= json.length()) return null;
510
-
511
- if (json.charAt(start) == '"') {
512
- int end = json.indexOf('"', start + 1);
513
- return end < 0 ? null : json.substring(start + 1, end);
514
- }
515
-
516
- int end = start;
517
- while (end < json.length() && ",}]".indexOf(json.charAt(end)) < 0) end++;
518
- return json.substring(start, end).trim();
519
- }
520
-
521
- private static State parse(String json) {
522
- State state = new State();
523
- String status = field(json, "status");
524
- if (status != null) state.status = status;
525
- state.token = field(json, "license_token");
526
- state.errorType = field(json, "error_type");
527
- return state;
528
- }
529
-
530
- public static State activate(String key, String instanceId, String fingerprint, String email) throws Exception {
531
- Map<String, String> fields = new LinkedHashMap<>();
532
- fields.put("item_id", String.valueOf(PRODUCT_ID));
533
- fields.put("license_key", key.trim());
534
- fields.put("site_url", instanceId);
535
- fields.put("device_fingerprint", fingerprint);
536
- fields.put("device_name", System.getenv().getOrDefault("COMPUTERNAME", "desktop"));
537
- fields.put("device_type", "Desktop (JVM)");
538
- fields.put("os", System.getProperty("os.name") + " " + System.getProperty("os.arch"));
539
- fields.put("email", email);
540
- fields.put("server_version", "1.0.0");
541
- return parse(post("activate_license", fields));
542
- }
543
-
544
- public static State check(String key, String instanceId, String fingerprint) throws Exception {
545
- Map<String, String> fields = new LinkedHashMap<>();
546
- fields.put("item_id", String.valueOf(PRODUCT_ID));
547
- fields.put("license_key", key);
548
- fields.put("site_url", instanceId);
549
- fields.put("device_fingerprint", fingerprint);
550
- return parse(post("check_license", fields));
551
- }
552
-
553
- public static void deactivate(String key, String instanceId) throws Exception {
554
- Map<String, String> fields = new LinkedHashMap<>();
555
- fields.put("item_id", String.valueOf(PRODUCT_ID));
556
- fields.put("license_key", key);
557
- fields.put("site_url", instanceId);
558
- post("deactivate_license", fields);
559
- }
560
-
561
- public static boolean verifyToken(String token, String publicKeyPem) throws Exception {
562
- String[] parts = token.split("\\\\.");
563
- if (parts.length != 3) return false;
564
-
565
- String pem = publicKeyPem
566
- .replace("-----BEGIN PUBLIC KEY-----", "")
567
- .replace("-----END PUBLIC KEY-----", "")
568
- .replaceAll("\\\\s", "");
569
-
570
- PublicKey key = KeyFactory.getInstance("RSA")
571
- .generatePublic(new X509EncodedKeySpec(Base64.getDecoder().decode(pem)));
572
-
573
- Signature verifier = Signature.getInstance("SHA256withRSA");
574
- verifier.initVerify(key);
575
- verifier.update((parts[0] + "." + parts[1]).getBytes(StandardCharsets.UTF_8));
576
-
577
- return verifier.verify(Base64.getUrlDecoder().decode(parts[2]));
578
- }
579
-
580
- // Bind the token to THIS installation. verifyToken proves the store signed
581
- // it and checks nothing else, so a copied token passes. claims.fp is a
582
- // server-side HMAC that cannot be recomputed here, so claims.ins - the
583
- // install id sent as site_url - is the binding a client can check.
584
- // Returns an empty string when entitled, otherwise the reason.
585
- public static String entitlement(String token, String publicKeyPem, String installId, int productId) throws Exception {
586
- if (!verifyToken(token, publicKeyPem)) return "invalid_or_expired";
587
-
588
- String[] parts = token.split("[.]");
589
- String payload = new String(Base64.getUrlDecoder().decode(parts[1]), StandardCharsets.UTF_8);
590
-
591
- String exp = claimValue(payload, "exp");
592
- if (exp != null && Long.parseLong(exp) <= System.currentTimeMillis() / 1000L) {
593
- return "invalid_or_expired";
594
- }
595
-
596
- String prod = claimValue(payload, "prod");
597
- if (productId > 0 && (prod == null || Integer.parseInt(prod) != productId)) {
598
- return "wrong_product";
599
- }
600
-
601
- String ins = claimValue(payload, "ins");
602
- if (installId != null && !installId.isEmpty() && ins != null && !ins.equals(installId)) {
603
- return "wrong_install";
604
- }
605
-
606
- return "";
607
- }
608
-
609
- // Reads a top-level claim without pulling in a JSON library: a quoted value
610
- // is returned as-is, a bare number as its digits. Good enough for the three
611
- // claims this checks, and it fails closed by returning null.
612
- private static String claimValue(String json, String name) {
613
- String needle = "\\"" + name + "\\":";
614
- int at = json.indexOf(needle);
615
- if (at < 0) return null;
616
-
617
- int start = at + needle.length();
618
- if (start >= json.length()) return null;
619
-
620
- if (json.charAt(start) == '"') {
621
- int end = json.indexOf('"', start + 1);
622
- return end < 0 ? null : json.substring(start + 1, end);
623
- }
624
-
625
- int end = start;
626
- while (end < json.length() && "-0123456789".indexOf(json.charAt(end)) >= 0) end++;
627
- return end == start ? null : json.substring(start, end);
628
- }
629
-
630
- public static String latestRelease(String key, String currentVersion, String platform) throws Exception {
631
- String url = STORE + "?fluent-cart=fastr_release_latest"
632
- + "&product_id=" + PRODUCT_ID
633
- + "&platform=" + URLEncoder.encode(platform, "UTF-8")
634
- + "&current_version=" + URLEncoder.encode(currentVersion, "UTF-8")
635
- + "&license_key=" + URLEncoder.encode(key, "UTF-8");
636
-
637
- HttpURLConnection connection = (HttpURLConnection) new URL(url).openConnection();
638
- connection.setConnectTimeout(15000);
639
- connection.setReadTimeout(15000);
640
-
641
- return read(connection);
642
- }
643
-
644
- public static String reportUsage(String key, String metric, int quantity, String idempotencyKey) throws Exception {
645
- Map<String, String> fields = new LinkedHashMap<>();
646
- fields.put("license_key", key);
647
- fields.put("metric", metric);
648
- fields.put("quantity", String.valueOf(quantity));
649
- fields.put("idempotency_key", idempotencyKey);
650
- return post("fastr_usage_report", fields);
651
- }
652
- }
438
+ return `${banner(appName, 'Java / JVM', 'FastrLicense.java', base, productId)}
439
+ import java.io.ByteArrayOutputStream;
440
+ import java.io.InputStream;
441
+ import java.io.OutputStream;
442
+ import java.net.HttpURLConnection;
443
+ import java.net.URL;
444
+ import java.net.URLEncoder;
445
+ import java.nio.charset.StandardCharsets;
446
+ import java.security.KeyFactory;
447
+ import java.security.PublicKey;
448
+ import java.security.Signature;
449
+ import java.security.spec.X509EncodedKeySpec;
450
+ import java.util.Base64;
451
+ import java.util.LinkedHashMap;
452
+ import java.util.Map;
453
+
454
+ public final class FastrLicense {
455
+
456
+ public static final String STORE = "${base}";
457
+ public static final int PRODUCT_ID = ${productId};
458
+
459
+ public static final class State {
460
+ public String status = "";
461
+ public String token;
462
+ public String errorType;
463
+ public boolean isValid() { return "valid".equals(status); }
464
+ }
465
+
466
+ private static String post(String verb, Map<String, String> fields) throws Exception {
467
+ StringBuilder form = new StringBuilder();
468
+ for (Map.Entry<String, String> entry : fields.entrySet()) {
469
+ if (form.length() > 0) form.append('&');
470
+ form.append(URLEncoder.encode(entry.getKey(), "UTF-8"))
471
+ .append('=')
472
+ .append(URLEncoder.encode(entry.getValue(), "UTF-8"));
473
+ }
474
+
475
+ HttpURLConnection connection = (HttpURLConnection) new URL(STORE + "?fluent-cart=" + verb).openConnection();
476
+ connection.setRequestMethod("POST");
477
+ connection.setDoOutput(true);
478
+ connection.setConnectTimeout(15000);
479
+ connection.setReadTimeout(15000);
480
+ connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
481
+
482
+ try (OutputStream out = connection.getOutputStream()) {
483
+ out.write(form.toString().getBytes(StandardCharsets.UTF_8));
484
+ }
485
+
486
+ return read(connection);
487
+ }
488
+
489
+ private static String read(HttpURLConnection connection) throws Exception {
490
+ try (InputStream in = connection.getInputStream()) {
491
+ ByteArrayOutputStream buffer = new ByteArrayOutputStream();
492
+ byte[] chunk = new byte[8192];
493
+ int count;
494
+ while ((count = in.read(chunk)) != -1) buffer.write(chunk, 0, count);
495
+ return buffer.toString("UTF-8");
496
+ }
497
+ }
498
+
499
+ /** Minimal field reader; swap in Jackson or Gson in a real project. */
500
+ private static String field(String json, String name) {
501
+ int at = json.indexOf("\\"" + name + "\\"");
502
+ if (at < 0) return null;
503
+
504
+ int colon = json.indexOf(':', at);
505
+ if (colon < 0) return null;
506
+
507
+ int start = colon + 1;
508
+ while (start < json.length() && Character.isWhitespace(json.charAt(start))) start++;
509
+ if (start >= json.length()) return null;
510
+
511
+ if (json.charAt(start) == '"') {
512
+ int end = json.indexOf('"', start + 1);
513
+ return end < 0 ? null : json.substring(start + 1, end);
514
+ }
515
+
516
+ int end = start;
517
+ while (end < json.length() && ",}]".indexOf(json.charAt(end)) < 0) end++;
518
+ return json.substring(start, end).trim();
519
+ }
520
+
521
+ private static State parse(String json) {
522
+ State state = new State();
523
+ String status = field(json, "status");
524
+ if (status != null) state.status = status;
525
+ state.token = field(json, "license_token");
526
+ state.errorType = field(json, "error_type");
527
+ return state;
528
+ }
529
+
530
+ public static State activate(String key, String instanceId, String fingerprint, String email) throws Exception {
531
+ Map<String, String> fields = new LinkedHashMap<>();
532
+ fields.put("item_id", String.valueOf(PRODUCT_ID));
533
+ fields.put("license_key", key.trim());
534
+ fields.put("site_url", instanceId);
535
+ fields.put("device_fingerprint", fingerprint);
536
+ fields.put("device_name", System.getenv().getOrDefault("COMPUTERNAME", "desktop"));
537
+ fields.put("device_type", "Desktop (JVM)");
538
+ fields.put("os", System.getProperty("os.name") + " " + System.getProperty("os.arch"));
539
+ fields.put("email", email);
540
+ fields.put("server_version", "1.0.0");
541
+ return parse(post("activate_license", fields));
542
+ }
543
+
544
+ public static State check(String key, String instanceId, String fingerprint) throws Exception {
545
+ Map<String, String> fields = new LinkedHashMap<>();
546
+ fields.put("item_id", String.valueOf(PRODUCT_ID));
547
+ fields.put("license_key", key);
548
+ fields.put("site_url", instanceId);
549
+ fields.put("device_fingerprint", fingerprint);
550
+ return parse(post("check_license", fields));
551
+ }
552
+
553
+ public static void deactivate(String key, String instanceId) throws Exception {
554
+ Map<String, String> fields = new LinkedHashMap<>();
555
+ fields.put("item_id", String.valueOf(PRODUCT_ID));
556
+ fields.put("license_key", key);
557
+ fields.put("site_url", instanceId);
558
+ post("deactivate_license", fields);
559
+ }
560
+
561
+ public static boolean verifyToken(String token, String publicKeyPem) throws Exception {
562
+ String[] parts = token.split("\\\\.");
563
+ if (parts.length != 3) return false;
564
+
565
+ String pem = publicKeyPem
566
+ .replace("-----BEGIN PUBLIC KEY-----", "")
567
+ .replace("-----END PUBLIC KEY-----", "")
568
+ .replaceAll("\\\\s", "");
569
+
570
+ PublicKey key = KeyFactory.getInstance("RSA")
571
+ .generatePublic(new X509EncodedKeySpec(Base64.getDecoder().decode(pem)));
572
+
573
+ Signature verifier = Signature.getInstance("SHA256withRSA");
574
+ verifier.initVerify(key);
575
+ verifier.update((parts[0] + "." + parts[1]).getBytes(StandardCharsets.UTF_8));
576
+
577
+ return verifier.verify(Base64.getUrlDecoder().decode(parts[2]));
578
+ }
579
+
580
+ // Bind the token to THIS installation. verifyToken proves the store signed
581
+ // it and checks nothing else, so a copied token passes. claims.fp is a
582
+ // server-side HMAC that cannot be recomputed here, so claims.ins - the
583
+ // install id sent as site_url - is the binding a client can check.
584
+ // Returns an empty string when entitled, otherwise the reason.
585
+ public static String entitlement(String token, String publicKeyPem, String installId, int productId) throws Exception {
586
+ if (!verifyToken(token, publicKeyPem)) return "invalid_or_expired";
587
+
588
+ String[] parts = token.split("[.]");
589
+ String payload = new String(Base64.getUrlDecoder().decode(parts[1]), StandardCharsets.UTF_8);
590
+
591
+ String exp = claimValue(payload, "exp");
592
+ if (exp != null && Long.parseLong(exp) <= System.currentTimeMillis() / 1000L) {
593
+ return "invalid_or_expired";
594
+ }
595
+
596
+ String prod = claimValue(payload, "prod");
597
+ if (productId > 0 && (prod == null || Integer.parseInt(prod) != productId)) {
598
+ return "wrong_product";
599
+ }
600
+
601
+ String ins = claimValue(payload, "ins");
602
+ if (installId != null && !installId.isEmpty() && ins != null && !ins.equals(installId)) {
603
+ return "wrong_install";
604
+ }
605
+
606
+ return "";
607
+ }
608
+
609
+ // Reads a top-level claim without pulling in a JSON library: a quoted value
610
+ // is returned as-is, a bare number as its digits. Good enough for the three
611
+ // claims this checks, and it fails closed by returning null.
612
+ private static String claimValue(String json, String name) {
613
+ String needle = "\\"" + name + "\\":";
614
+ int at = json.indexOf(needle);
615
+ if (at < 0) return null;
616
+
617
+ int start = at + needle.length();
618
+ if (start >= json.length()) return null;
619
+
620
+ if (json.charAt(start) == '"') {
621
+ int end = json.indexOf('"', start + 1);
622
+ return end < 0 ? null : json.substring(start + 1, end);
623
+ }
624
+
625
+ int end = start;
626
+ while (end < json.length() && "-0123456789".indexOf(json.charAt(end)) >= 0) end++;
627
+ return end == start ? null : json.substring(start, end);
628
+ }
629
+
630
+ public static String latestRelease(String key, String currentVersion, String platform) throws Exception {
631
+ String url = STORE + "?fluent-cart=fastr_release_latest"
632
+ + "&product_id=" + PRODUCT_ID
633
+ + "&platform=" + URLEncoder.encode(platform, "UTF-8")
634
+ + "&current_version=" + URLEncoder.encode(currentVersion, "UTF-8")
635
+ + "&license_key=" + URLEncoder.encode(key, "UTF-8");
636
+
637
+ HttpURLConnection connection = (HttpURLConnection) new URL(url).openConnection();
638
+ connection.setConnectTimeout(15000);
639
+ connection.setReadTimeout(15000);
640
+
641
+ return read(connection);
642
+ }
643
+
644
+ public static String reportUsage(String key, String metric, int quantity, String idempotencyKey) throws Exception {
645
+ Map<String, String> fields = new LinkedHashMap<>();
646
+ fields.put("license_key", key);
647
+ fields.put("metric", metric);
648
+ fields.put("quantity", String.valueOf(quantity));
649
+ fields.put("idempotency_key", idempotencyKey);
650
+ return post("fastr_usage_report", fields);
651
+ }
652
+ }
653
653
  `;
654
654
  }
655
655
  if (platform === 'php') {
656
- return `<?php
657
-
658
- declare(strict_types=1);
659
-
660
- ${banner(appName, 'PHP (no WordPress)', 'FastrLicense.php', base, productId)}
661
-
662
- final class FastrLicense
663
- {
664
- public const STORE = '${base}';
665
- public const PRODUCT_ID = ${productId};
666
-
667
- private static function post(string $verb, array $fields): array
668
- {
669
- $handle = curl_init(self::STORE . '?fluent-cart=' . $verb);
670
- curl_setopt_array($handle, [
671
- CURLOPT_POST => true,
672
- CURLOPT_POSTFIELDS => http_build_query($fields),
673
- CURLOPT_RETURNTRANSFER => true,
674
- CURLOPT_TIMEOUT => 15,
675
- ]);
676
-
677
- $body = curl_exec($handle);
678
- curl_close($handle);
679
-
680
- $json = is_string($body) ? json_decode($body, true) : null;
681
-
682
- return is_array($json) ? $json : [];
683
- }
684
-
685
- public static function activate(string $key, string $instanceId, string $fingerprint, string $email): array
686
- {
687
- return self::post('activate_license', [
688
- 'item_id' => (string) self::PRODUCT_ID,
689
- 'license_key' => trim($key),
690
- 'site_url' => $instanceId,
691
- 'device_fingerprint' => $fingerprint,
692
- 'device_name' => gethostname() ?: 'desktop',
693
- 'device_type' => 'CLI (PHP)',
694
- 'os' => PHP_OS_FAMILY,
695
- 'email' => $email,
696
- 'server_version' => '1.0.0',
697
- ]);
698
- }
699
-
700
- public static function check(string $key, string $instanceId, string $fingerprint): array
701
- {
702
- return self::post('check_license', [
703
- 'item_id' => (string) self::PRODUCT_ID,
704
- 'license_key' => $key,
705
- 'site_url' => $instanceId,
706
- 'device_fingerprint' => $fingerprint,
707
- ]);
708
- }
709
-
710
- public static function deactivate(string $key, string $instanceId): array
711
- {
712
- return self::post('deactivate_license', [
713
- 'item_id' => (string) self::PRODUCT_ID,
714
- 'license_key' => $key,
715
- 'site_url' => $instanceId,
716
- ]);
717
- }
718
-
719
- /** The signed offline licence; pass it to verifyToken(). */
720
- public static function token(array $state): ?string
721
- {
722
- return $state['license_token'] ?? null;
723
- }
724
-
725
- /** Valid only when status === 'valid'. key_mismatch arrives as 200 + success. */
726
- public static function isValid(array $state): bool
727
- {
728
- return ($state['status'] ?? '') === 'valid';
729
- }
730
-
731
- public static function verifyToken(string $token, string $publicKeyPem): ?array
732
- {
733
- $parts = explode('.', $token);
734
-
735
- if (count($parts) !== 3) {
736
- return null;
737
- }
738
-
739
- $signature = self::base64UrlDecode($parts[2]);
740
-
741
- if ($signature === null || openssl_verify($parts[0] . '.' . $parts[1], $signature, $publicKeyPem, OPENSSL_ALGO_SHA256) !== 1) {
742
- return null;
743
- }
744
-
745
- $payload = self::base64UrlDecode($parts[1]);
746
- $claims = $payload === null ? null : json_decode($payload, true);
747
-
748
- if (!is_array($claims)) {
749
- return null;
750
- }
751
-
752
- if (isset($claims['exp']) && (int) $claims['exp'] < time()) {
753
- return null;
754
- }
755
-
756
- return $claims;
757
- }
758
-
759
- /**
760
- * Bind the token to THIS installation.
761
- *
762
- * verifyToken proves the store signed it and that it has not expired. It
763
- * does not prove the token was issued for this machine or this product, so
764
- * a copied token passes. claims.fp is a server-side HMAC and cannot be
765
- * recomputed here, so claims.ins - the install id sent as site_url - is the
766
- * binding a client is able to check.
767
- *
768
- * @return array{ok:bool,reason?:string,claims?:array}
769
- */
770
- public static function entitlement(string $token, string $publicKeyPem, string $installId = '', int $productId = 0): array
771
- {
772
- $claims = self::verifyToken($token, $publicKeyPem);
773
-
774
- if ($claims === null) {
775
- return ['ok' => false, 'reason' => 'invalid_or_expired'];
776
- }
777
-
778
- if ($productId > 0 && (int) ($claims['prod'] ?? -1) !== $productId) {
779
- return ['ok' => false, 'reason' => 'wrong_product'];
780
- }
781
-
782
- if ($installId !== '' && isset($claims['ins']) && (string) $claims['ins'] !== $installId) {
783
- return ['ok' => false, 'reason' => 'wrong_install'];
784
- }
785
-
786
- return ['ok' => true, 'claims' => $claims];
787
- }
788
-
789
- public static function latestRelease(string $key, string $currentVersion, string $platform = 'any'): array
790
- {
791
- $query = http_build_query([
792
- 'product_id' => self::PRODUCT_ID,
793
- 'platform' => $platform,
794
- 'current_version' => $currentVersion,
795
- 'license_key' => $key,
796
- ]);
797
-
798
- $body = @file_get_contents(self::STORE . '?fluent-cart=fastr_release_latest&' . $query);
799
- $json = is_string($body) ? json_decode($body, true) : null;
800
-
801
- return is_array($json) ? $json : [];
802
- }
803
-
804
- public static function reportUsage(string $key, string $metric, int $quantity, string $idempotencyKey): array
805
- {
806
- return self::post('fastr_usage_report', [
807
- 'license_key' => $key,
808
- 'metric' => $metric,
809
- 'quantity' => (string) $quantity,
810
- 'idempotency_key' => $idempotencyKey,
811
- ]);
812
- }
813
-
814
- private static function base64UrlDecode(string $value): ?string
815
- {
816
- $padded = strtr($value, '-_', '+/');
817
- $padded .= str_repeat('=', (4 - strlen($padded) % 4) % 4);
818
-
819
- $decoded = base64_decode($padded, true);
820
-
821
- return $decoded === false ? null : $decoded;
822
- }
823
- }
656
+ return `<?php
657
+
658
+ declare(strict_types=1);
659
+
660
+ ${banner(appName, 'PHP (no WordPress)', 'FastrLicense.php', base, productId)}
661
+
662
+ final class FastrLicense
663
+ {
664
+ public const STORE = '${base}';
665
+ public const PRODUCT_ID = ${productId};
666
+
667
+ private static function post(string $verb, array $fields): array
668
+ {
669
+ $handle = curl_init(self::STORE . '?fluent-cart=' . $verb);
670
+ curl_setopt_array($handle, [
671
+ CURLOPT_POST => true,
672
+ CURLOPT_POSTFIELDS => http_build_query($fields),
673
+ CURLOPT_RETURNTRANSFER => true,
674
+ CURLOPT_TIMEOUT => 15,
675
+ ]);
676
+
677
+ $body = curl_exec($handle);
678
+ curl_close($handle);
679
+
680
+ $json = is_string($body) ? json_decode($body, true) : null;
681
+
682
+ return is_array($json) ? $json : [];
683
+ }
684
+
685
+ public static function activate(string $key, string $instanceId, string $fingerprint, string $email): array
686
+ {
687
+ return self::post('activate_license', [
688
+ 'item_id' => (string) self::PRODUCT_ID,
689
+ 'license_key' => trim($key),
690
+ 'site_url' => $instanceId,
691
+ 'device_fingerprint' => $fingerprint,
692
+ 'device_name' => gethostname() ?: 'desktop',
693
+ 'device_type' => 'CLI (PHP)',
694
+ 'os' => PHP_OS_FAMILY,
695
+ 'email' => $email,
696
+ 'server_version' => '1.0.0',
697
+ ]);
698
+ }
699
+
700
+ public static function check(string $key, string $instanceId, string $fingerprint): array
701
+ {
702
+ return self::post('check_license', [
703
+ 'item_id' => (string) self::PRODUCT_ID,
704
+ 'license_key' => $key,
705
+ 'site_url' => $instanceId,
706
+ 'device_fingerprint' => $fingerprint,
707
+ ]);
708
+ }
709
+
710
+ public static function deactivate(string $key, string $instanceId): array
711
+ {
712
+ return self::post('deactivate_license', [
713
+ 'item_id' => (string) self::PRODUCT_ID,
714
+ 'license_key' => $key,
715
+ 'site_url' => $instanceId,
716
+ ]);
717
+ }
718
+
719
+ /** The signed offline licence; pass it to verifyToken(). */
720
+ public static function token(array $state): ?string
721
+ {
722
+ return $state['license_token'] ?? null;
723
+ }
724
+
725
+ /** Valid only when status === 'valid'. key_mismatch arrives as 200 + success. */
726
+ public static function isValid(array $state): bool
727
+ {
728
+ return ($state['status'] ?? '') === 'valid';
729
+ }
730
+
731
+ public static function verifyToken(string $token, string $publicKeyPem): ?array
732
+ {
733
+ $parts = explode('.', $token);
734
+
735
+ if (count($parts) !== 3) {
736
+ return null;
737
+ }
738
+
739
+ $signature = self::base64UrlDecode($parts[2]);
740
+
741
+ if ($signature === null || openssl_verify($parts[0] . '.' . $parts[1], $signature, $publicKeyPem, OPENSSL_ALGO_SHA256) !== 1) {
742
+ return null;
743
+ }
744
+
745
+ $payload = self::base64UrlDecode($parts[1]);
746
+ $claims = $payload === null ? null : json_decode($payload, true);
747
+
748
+ if (!is_array($claims)) {
749
+ return null;
750
+ }
751
+
752
+ if (isset($claims['exp']) && (int) $claims['exp'] < time()) {
753
+ return null;
754
+ }
755
+
756
+ return $claims;
757
+ }
758
+
759
+ /**
760
+ * Bind the token to THIS installation.
761
+ *
762
+ * verifyToken proves the store signed it and that it has not expired. It
763
+ * does not prove the token was issued for this machine or this product, so
764
+ * a copied token passes. claims.fp is a server-side HMAC and cannot be
765
+ * recomputed here, so claims.ins - the install id sent as site_url - is the
766
+ * binding a client is able to check.
767
+ *
768
+ * @return array{ok:bool,reason?:string,claims?:array}
769
+ */
770
+ public static function entitlement(string $token, string $publicKeyPem, string $installId = '', int $productId = 0): array
771
+ {
772
+ $claims = self::verifyToken($token, $publicKeyPem);
773
+
774
+ if ($claims === null) {
775
+ return ['ok' => false, 'reason' => 'invalid_or_expired'];
776
+ }
777
+
778
+ if ($productId > 0 && (int) ($claims['prod'] ?? -1) !== $productId) {
779
+ return ['ok' => false, 'reason' => 'wrong_product'];
780
+ }
781
+
782
+ if ($installId !== '' && isset($claims['ins']) && (string) $claims['ins'] !== $installId) {
783
+ return ['ok' => false, 'reason' => 'wrong_install'];
784
+ }
785
+
786
+ return ['ok' => true, 'claims' => $claims];
787
+ }
788
+
789
+ public static function latestRelease(string $key, string $currentVersion, string $platform = 'any'): array
790
+ {
791
+ $query = http_build_query([
792
+ 'product_id' => self::PRODUCT_ID,
793
+ 'platform' => $platform,
794
+ 'current_version' => $currentVersion,
795
+ 'license_key' => $key,
796
+ ]);
797
+
798
+ $body = @file_get_contents(self::STORE . '?fluent-cart=fastr_release_latest&' . $query);
799
+ $json = is_string($body) ? json_decode($body, true) : null;
800
+
801
+ return is_array($json) ? $json : [];
802
+ }
803
+
804
+ public static function reportUsage(string $key, string $metric, int $quantity, string $idempotencyKey): array
805
+ {
806
+ return self::post('fastr_usage_report', [
807
+ 'license_key' => $key,
808
+ 'metric' => $metric,
809
+ 'quantity' => (string) $quantity,
810
+ 'idempotency_key' => $idempotencyKey,
811
+ ]);
812
+ }
813
+
814
+ private static function base64UrlDecode(string $value): ?string
815
+ {
816
+ $padded = strtr($value, '-_', '+/');
817
+ $padded .= str_repeat('=', (4 - strlen($padded) % 4) % 4);
818
+
819
+ $decoded = base64_decode($padded, true);
820
+
821
+ return $decoded === false ? null : $decoded;
822
+ }
823
+ }
824
824
  `;
825
825
  }
826
- return `${banner(appName, 'C (libcurl + OpenSSL)', 'fastr_license.c', base, productId)}
827
- #include <curl/curl.h>
828
- #include <openssl/bio.h>
829
- #include <openssl/evp.h>
830
- #include <openssl/pem.h>
831
- #include <stdio.h>
832
- #include <stdlib.h>
833
- #include <string.h>
834
-
835
- #define FASTR_STORE "${base}"
836
- #define FASTR_PRODUCT ${productId}
837
-
838
- /* The activate/check body carries "license_token"; hand it to
839
- * fastr_verify_token() so the app can run offline without a heartbeat. */
840
- struct buffer { char *data; size_t size; };
841
-
842
- static size_t on_body(void *chunk, size_t size, size_t count, void *user)
843
- {
844
- struct buffer *buffer = (struct buffer *) user;
845
- size_t total = size * count;
846
-
847
- char *grown = realloc(buffer->data, buffer->size + total + 1);
848
- if (grown == NULL) return 0;
849
-
850
- buffer->data = grown;
851
- memcpy(buffer->data + buffer->size, chunk, total);
852
- buffer->size += total;
853
- buffer->data[buffer->size] = '\\0';
854
-
855
- return total;
856
- }
857
-
858
- /* POST a form to ?fluent-cart=<verb>. Caller frees the returned buffer. */
859
- static char *fastr_post(const char *verb, const char *form)
860
- {
861
- CURL *curl = curl_easy_init();
862
- if (curl == NULL) return NULL;
863
-
864
- struct buffer response = { NULL, 0 };
865
- char url[512];
866
- snprintf(url, sizeof(url), "%s?fluent-cart=%s", FASTR_STORE, verb);
867
-
868
- curl_easy_setopt(curl, CURLOPT_URL, url);
869
- curl_easy_setopt(curl, CURLOPT_POSTFIELDS, form);
870
- curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, on_body);
871
- curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
872
- curl_easy_setopt(curl, CURLOPT_TIMEOUT, 15L);
873
-
874
- CURLcode result = curl_easy_perform(curl);
875
- curl_easy_cleanup(curl);
876
-
877
- if (result != CURLE_OK) { free(response.data); return NULL; }
878
-
879
- return response.data;
880
- }
881
-
882
- /* Valid only when the body carries "status":"valid". key_mismatch and
883
- * invalid_activation arrive as HTTP 200 with success=true. */
884
- static int fastr_status_is_valid(const char *json)
885
- {
886
- return json != NULL && strstr(json, "\\"status\\":\\"valid\\"") != NULL;
887
- }
888
-
889
- char *fastr_activate(const char *license_key, const char *instance_id,
890
- const char *fingerprint, const char *email)
891
- {
892
- char form[1024];
893
- snprintf(form, sizeof(form),
894
- "item_id=%d&license_key=%s&site_url=%s&device_fingerprint=%s"
895
- "&device_type=CLI%%20(C)&server_version=1.0.0&email=%s",
896
- FASTR_PRODUCT, license_key, instance_id, fingerprint, email);
897
-
898
- return fastr_post("activate_license", form);
899
- }
900
-
901
- char *fastr_check(const char *license_key, const char *instance_id, const char *fingerprint)
902
- {
903
- char form[512];
904
- snprintf(form, sizeof(form),
905
- "item_id=%d&license_key=%s&site_url=%s&device_fingerprint=%s",
906
- FASTR_PRODUCT, license_key, instance_id, fingerprint);
907
-
908
- return fastr_post("check_license", form);
909
- }
910
-
911
- char *fastr_deactivate(const char *license_key, const char *instance_id)
912
- {
913
- char form[512];
914
- snprintf(form, sizeof(form),
915
- "item_id=%d&license_key=%s&site_url=%s",
916
- FASTR_PRODUCT, license_key, instance_id);
917
-
918
- return fastr_post("deactivate_license", form);
919
- }
920
-
921
- char *fastr_report_usage(const char *license_key, const char *metric,
922
- int quantity, const char *idempotency_key)
923
- {
924
- char form[512];
925
- snprintf(form, sizeof(form),
926
- "license_key=%s&metric=%s&quantity=%d&idempotency_key=%s",
927
- license_key, metric, quantity, idempotency_key);
928
-
929
- return fastr_post("fastr_usage_report", form);
930
- }
931
-
932
- char *fastr_latest_release(const char *license_key, const char *current_version)
933
- {
934
- CURL *curl = curl_easy_init();
935
- if (curl == NULL) return NULL;
936
-
937
- struct buffer response = { NULL, 0 };
938
- char url[512];
939
- snprintf(url, sizeof(url),
940
- "%s?fluent-cart=fastr_release_latest&product_id=%d"
941
- "&platform=any&current_version=%s&license_key=%s",
942
- FASTR_STORE, FASTR_PRODUCT, current_version, license_key);
943
-
944
- curl_easy_setopt(curl, CURLOPT_URL, url);
945
- curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, on_body);
946
- curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
947
- curl_easy_setopt(curl, CURLOPT_TIMEOUT, 15L);
948
-
949
- CURLcode result = curl_easy_perform(curl);
950
- curl_easy_cleanup(curl);
951
-
952
- if (result != CURLE_OK) { free(response.data); return NULL; }
953
-
954
- return response.data;
955
- }
956
-
957
- /* RS256 verification. Returns 1 when the signature is good. */
958
- int fastr_verify_token(const char *token, const char *public_key_pem)
959
- {
960
- /* strdup allocates exactly strlen+1, and the base64 padding below is
961
- * strcat-ed onto a slice of this buffer, so it needs headroom. */
962
- size_t token_size = strlen(token) + 8;
963
- char *copy = (char *) malloc(token_size);
964
- if (copy == NULL) return 0;
965
- memcpy(copy, token, token_size > 1 ? strlen(token) + 1 : 1);
966
-
967
- char *header = strtok(copy, ".");
968
- char *payload = strtok(NULL, ".");
969
- char *signature_part = strtok(NULL, ".");
970
-
971
- if (header == NULL || payload == NULL || signature_part == NULL) { free(copy); return 0; }
972
-
973
- char signed_input[4096];
974
- snprintf(signed_input, sizeof(signed_input), "%s.%s", header, payload);
975
-
976
- BIO *bio = BIO_new_mem_buf(public_key_pem, -1);
977
- if (bio == NULL) { free(copy); return 0; }
978
-
979
- EVP_PKEY *key = PEM_read_bio_PUBKEY(bio, NULL, NULL, NULL);
980
- BIO_free(bio);
981
-
982
- if (key == NULL) { free(copy); return 0; }
983
-
984
- for (char *p = signature_part; *p; p++) {
985
- if (*p == '-') *p = '+';
986
- else if (*p == '_') *p = '/';
987
- }
988
-
989
- size_t signature_len = strlen(signature_part);
990
- size_t padding = (4 - signature_len % 4) % 4;
991
- for (size_t i = 0; i < padding; i++) strcat(signature_part, "=");
992
-
993
- unsigned char signature[1024];
994
- int decoded = EVP_DecodeBlock(signature, (unsigned char *) signature_part, (int) strlen(signature_part));
995
-
996
- if (decoded < 0) { EVP_PKEY_free(key); free(copy); return 0; }
997
-
998
- decoded -= (int) padding;
999
-
1000
- EVP_MD_CTX *ctx = EVP_MD_CTX_new();
1001
- int ok = 0;
1002
-
1003
- if (ctx != NULL &&
1004
- EVP_DigestVerifyInit(ctx, NULL, EVP_sha256(), NULL, key) == 1 &&
1005
- EVP_DigestVerifyUpdate(ctx, signed_input, strlen(signed_input)) == 1) {
1006
- ok = EVP_DigestVerifyFinal(ctx, signature, (size_t) decoded) == 1;
1007
- }
1008
-
1009
- if (ctx != NULL) EVP_MD_CTX_free(ctx);
1010
- EVP_PKEY_free(key);
1011
- free(copy);
1012
-
1013
- return ok;
1014
- }
1015
-
1016
- /* Reads a top-level claim from a decoded JWT payload: a quoted string or a
1017
- * bare integer. Returns 0 when the claim is absent. */
1018
- static int fastr_claim(const char *json, const char *name, char *out, size_t out_size)
1019
- {
1020
- if (json == NULL || name == NULL || out == NULL || out_size == 0) return 0;
1021
-
1022
- char needle[64];
1023
- int written = snprintf(needle, sizeof(needle), "\\"%s\\":", name);
1024
- if (written <= 0 || (size_t) written >= sizeof(needle)) return 0;
1025
-
1026
- const char *at = strstr(json, needle);
1027
- if (at == NULL) return 0;
1028
-
1029
- at += strlen(needle);
1030
-
1031
- size_t i = 0;
1032
-
1033
- if (*at == '"') {
1034
- ++at;
1035
- while (at[i] != '"' && at[i] != '\0' && i + 1 < out_size) {
1036
- out[i] = at[i];
1037
- ++i;
1038
- }
1039
- } else {
1040
- while ((at[i] == '-' || (at[i] >= '0' && at[i] <= '9')) && i + 1 < out_size) {
1041
- out[i] = at[i];
1042
- ++i;
1043
- }
1044
- }
1045
-
1046
- out[i] = '\0';
1047
-
1048
- return i > 0 ? 1 : 0;
1049
- }
1050
-
1051
- /* Returns NULL when the token entitles this install and product to run,
1052
- * otherwise a short reason.
1053
- *
1054
- * fastr_verify_token() proves the store signed the token and that it has not
1055
- * expired. It does not prove the token was issued for this machine or this
1056
- * product, so a token copied from another install passes it. claims.ins - the
1057
- * install id sent as site_url - is the binding a client can check. claims.fp is
1058
- * a server-side HMAC and cannot be recomputed here.
1059
- */
1060
- const char *fastr_entitlement(const char *token, const char *public_key_pem, const char *install_id, int product_id)
1061
- {
1062
- if (!fastr_verify_token(token, public_key_pem)) return "invalid_or_expired";
1063
-
1064
- size_t token_len = strlen(token);
1065
- char *copy = (char *) malloc(token_len + 8);
1066
-
1067
- if (copy == NULL) return "invalid_or_expired";
1068
-
1069
- memcpy(copy, token, token_len + 1);
1070
-
1071
- char *first = strchr(copy, '.');
1072
- if (first == NULL) { free(copy); return "invalid_or_expired"; }
1073
-
1074
- char *payload = first + 1;
1075
- char *second = strchr(payload, '.');
1076
-
1077
- if (second == NULL) { free(copy); return "invalid_or_expired"; }
1078
-
1079
- *second = '\0';
1080
-
1081
- for (char *p = payload; *p; ++p) {
1082
- if (*p == '-') *p = '+';
1083
- else if (*p == '_') *p = '/';
1084
- }
1085
-
1086
- size_t payload_len = strlen(payload);
1087
- size_t padding = (4 - payload_len % 4) % 4;
1088
-
1089
- for (size_t i = 0; i < padding; ++i) strcat(payload, "=");
1090
-
1091
- unsigned char decoded[8192];
1092
- int size = EVP_DecodeBlock(decoded, (unsigned char *) payload, (int) strlen(payload));
1093
-
1094
- free(copy);
1095
-
1096
- if (size <= 0) return "invalid_or_expired";
1097
-
1098
- size -= (int) padding;
1099
-
1100
- if (size <= 0 || (size_t) size >= sizeof(decoded)) return "invalid_or_expired";
1101
-
1102
- decoded[size] = '\0';
1103
-
1104
- const char *json = (const char *) decoded;
1105
- char claim[160];
1106
-
1107
- if (!fastr_claim(json, "exp", claim, sizeof(claim))) return "invalid_or_expired";
1108
- if (atoll(claim) <= 0 || atoll(claim) <= (long long) time(NULL)) return "invalid_or_expired";
1109
-
1110
- if (product_id > 0) {
1111
- if (!fastr_claim(json, "prod", claim, sizeof(claim))) return "wrong_product";
1112
- if (atoi(claim) != product_id) return "wrong_product";
1113
- }
1114
-
1115
- if (install_id != NULL && install_id[0] != '\0') {
1116
- if (fastr_claim(json, "ins", claim, sizeof(claim)) && strcmp(claim, install_id) != 0) {
1117
- return "wrong_install";
1118
- }
1119
- }
1120
-
1121
- return NULL;
1122
- }
826
+ return `${banner(appName, 'C (libcurl + OpenSSL)', 'fastr_license.c', base, productId)}
827
+ #include <curl/curl.h>
828
+ #include <openssl/bio.h>
829
+ #include <openssl/evp.h>
830
+ #include <openssl/pem.h>
831
+ #include <stdio.h>
832
+ #include <stdlib.h>
833
+ #include <string.h>
834
+
835
+ #define FASTR_STORE "${base}"
836
+ #define FASTR_PRODUCT ${productId}
837
+
838
+ /* The activate/check body carries "license_token"; hand it to
839
+ * fastr_verify_token() so the app can run offline without a heartbeat. */
840
+ struct buffer { char *data; size_t size; };
841
+
842
+ static size_t on_body(void *chunk, size_t size, size_t count, void *user)
843
+ {
844
+ struct buffer *buffer = (struct buffer *) user;
845
+ size_t total = size * count;
846
+
847
+ char *grown = realloc(buffer->data, buffer->size + total + 1);
848
+ if (grown == NULL) return 0;
849
+
850
+ buffer->data = grown;
851
+ memcpy(buffer->data + buffer->size, chunk, total);
852
+ buffer->size += total;
853
+ buffer->data[buffer->size] = '\\0';
854
+
855
+ return total;
856
+ }
857
+
858
+ /* POST a form to ?fluent-cart=<verb>. Caller frees the returned buffer. */
859
+ static char *fastr_post(const char *verb, const char *form)
860
+ {
861
+ CURL *curl = curl_easy_init();
862
+ if (curl == NULL) return NULL;
863
+
864
+ struct buffer response = { NULL, 0 };
865
+ char url[512];
866
+ snprintf(url, sizeof(url), "%s?fluent-cart=%s", FASTR_STORE, verb);
867
+
868
+ curl_easy_setopt(curl, CURLOPT_URL, url);
869
+ curl_easy_setopt(curl, CURLOPT_POSTFIELDS, form);
870
+ curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, on_body);
871
+ curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
872
+ curl_easy_setopt(curl, CURLOPT_TIMEOUT, 15L);
873
+
874
+ CURLcode result = curl_easy_perform(curl);
875
+ curl_easy_cleanup(curl);
876
+
877
+ if (result != CURLE_OK) { free(response.data); return NULL; }
878
+
879
+ return response.data;
880
+ }
881
+
882
+ /* Valid only when the body carries "status":"valid". key_mismatch and
883
+ * invalid_activation arrive as HTTP 200 with success=true. */
884
+ static int fastr_status_is_valid(const char *json)
885
+ {
886
+ return json != NULL && strstr(json, "\\"status\\":\\"valid\\"") != NULL;
887
+ }
888
+
889
+ char *fastr_activate(const char *license_key, const char *instance_id,
890
+ const char *fingerprint, const char *email)
891
+ {
892
+ char form[1024];
893
+ snprintf(form, sizeof(form),
894
+ "item_id=%d&license_key=%s&site_url=%s&device_fingerprint=%s"
895
+ "&device_type=CLI%%20(C)&server_version=1.0.0&email=%s",
896
+ FASTR_PRODUCT, license_key, instance_id, fingerprint, email);
897
+
898
+ return fastr_post("activate_license", form);
899
+ }
900
+
901
+ char *fastr_check(const char *license_key, const char *instance_id, const char *fingerprint)
902
+ {
903
+ char form[512];
904
+ snprintf(form, sizeof(form),
905
+ "item_id=%d&license_key=%s&site_url=%s&device_fingerprint=%s",
906
+ FASTR_PRODUCT, license_key, instance_id, fingerprint);
907
+
908
+ return fastr_post("check_license", form);
909
+ }
910
+
911
+ char *fastr_deactivate(const char *license_key, const char *instance_id)
912
+ {
913
+ char form[512];
914
+ snprintf(form, sizeof(form),
915
+ "item_id=%d&license_key=%s&site_url=%s",
916
+ FASTR_PRODUCT, license_key, instance_id);
917
+
918
+ return fastr_post("deactivate_license", form);
919
+ }
920
+
921
+ char *fastr_report_usage(const char *license_key, const char *metric,
922
+ int quantity, const char *idempotency_key)
923
+ {
924
+ char form[512];
925
+ snprintf(form, sizeof(form),
926
+ "license_key=%s&metric=%s&quantity=%d&idempotency_key=%s",
927
+ license_key, metric, quantity, idempotency_key);
928
+
929
+ return fastr_post("fastr_usage_report", form);
930
+ }
931
+
932
+ char *fastr_latest_release(const char *license_key, const char *current_version)
933
+ {
934
+ CURL *curl = curl_easy_init();
935
+ if (curl == NULL) return NULL;
936
+
937
+ struct buffer response = { NULL, 0 };
938
+ char url[512];
939
+ snprintf(url, sizeof(url),
940
+ "%s?fluent-cart=fastr_release_latest&product_id=%d"
941
+ "&platform=any&current_version=%s&license_key=%s",
942
+ FASTR_STORE, FASTR_PRODUCT, current_version, license_key);
943
+
944
+ curl_easy_setopt(curl, CURLOPT_URL, url);
945
+ curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, on_body);
946
+ curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
947
+ curl_easy_setopt(curl, CURLOPT_TIMEOUT, 15L);
948
+
949
+ CURLcode result = curl_easy_perform(curl);
950
+ curl_easy_cleanup(curl);
951
+
952
+ if (result != CURLE_OK) { free(response.data); return NULL; }
953
+
954
+ return response.data;
955
+ }
956
+
957
+ /* RS256 verification. Returns 1 when the signature is good. */
958
+ int fastr_verify_token(const char *token, const char *public_key_pem)
959
+ {
960
+ /* strdup allocates exactly strlen+1, and the base64 padding below is
961
+ * strcat-ed onto a slice of this buffer, so it needs headroom. */
962
+ size_t token_size = strlen(token) + 8;
963
+ char *copy = (char *) malloc(token_size);
964
+ if (copy == NULL) return 0;
965
+ memcpy(copy, token, token_size > 1 ? strlen(token) + 1 : 1);
966
+
967
+ char *header = strtok(copy, ".");
968
+ char *payload = strtok(NULL, ".");
969
+ char *signature_part = strtok(NULL, ".");
970
+
971
+ if (header == NULL || payload == NULL || signature_part == NULL) { free(copy); return 0; }
972
+
973
+ char signed_input[4096];
974
+ snprintf(signed_input, sizeof(signed_input), "%s.%s", header, payload);
975
+
976
+ BIO *bio = BIO_new_mem_buf(public_key_pem, -1);
977
+ if (bio == NULL) { free(copy); return 0; }
978
+
979
+ EVP_PKEY *key = PEM_read_bio_PUBKEY(bio, NULL, NULL, NULL);
980
+ BIO_free(bio);
981
+
982
+ if (key == NULL) { free(copy); return 0; }
983
+
984
+ for (char *p = signature_part; *p; p++) {
985
+ if (*p == '-') *p = '+';
986
+ else if (*p == '_') *p = '/';
987
+ }
988
+
989
+ size_t signature_len = strlen(signature_part);
990
+ size_t padding = (4 - signature_len % 4) % 4;
991
+ for (size_t i = 0; i < padding; i++) strcat(signature_part, "=");
992
+
993
+ unsigned char signature[1024];
994
+ int decoded = EVP_DecodeBlock(signature, (unsigned char *) signature_part, (int) strlen(signature_part));
995
+
996
+ if (decoded < 0) { EVP_PKEY_free(key); free(copy); return 0; }
997
+
998
+ decoded -= (int) padding;
999
+
1000
+ EVP_MD_CTX *ctx = EVP_MD_CTX_new();
1001
+ int ok = 0;
1002
+
1003
+ if (ctx != NULL &&
1004
+ EVP_DigestVerifyInit(ctx, NULL, EVP_sha256(), NULL, key) == 1 &&
1005
+ EVP_DigestVerifyUpdate(ctx, signed_input, strlen(signed_input)) == 1) {
1006
+ ok = EVP_DigestVerifyFinal(ctx, signature, (size_t) decoded) == 1;
1007
+ }
1008
+
1009
+ if (ctx != NULL) EVP_MD_CTX_free(ctx);
1010
+ EVP_PKEY_free(key);
1011
+ free(copy);
1012
+
1013
+ return ok;
1014
+ }
1015
+
1016
+ /* Reads a top-level claim from a decoded JWT payload: a quoted string or a
1017
+ * bare integer. Returns 0 when the claim is absent. */
1018
+ static int fastr_claim(const char *json, const char *name, char *out, size_t out_size)
1019
+ {
1020
+ if (json == NULL || name == NULL || out == NULL || out_size == 0) return 0;
1021
+
1022
+ char needle[64];
1023
+ int written = snprintf(needle, sizeof(needle), "\\"%s\\":", name);
1024
+ if (written <= 0 || (size_t) written >= sizeof(needle)) return 0;
1025
+
1026
+ const char *at = strstr(json, needle);
1027
+ if (at == NULL) return 0;
1028
+
1029
+ at += strlen(needle);
1030
+
1031
+ size_t i = 0;
1032
+
1033
+ if (*at == '"') {
1034
+ ++at;
1035
+ while (at[i] != '"' && at[i] != '\0' && i + 1 < out_size) {
1036
+ out[i] = at[i];
1037
+ ++i;
1038
+ }
1039
+ } else {
1040
+ while ((at[i] == '-' || (at[i] >= '0' && at[i] <= '9')) && i + 1 < out_size) {
1041
+ out[i] = at[i];
1042
+ ++i;
1043
+ }
1044
+ }
1045
+
1046
+ out[i] = '\0';
1047
+
1048
+ return i > 0 ? 1 : 0;
1049
+ }
1050
+
1051
+ /* Returns NULL when the token entitles this install and product to run,
1052
+ * otherwise a short reason.
1053
+ *
1054
+ * fastr_verify_token() proves the store signed the token and that it has not
1055
+ * expired. It does not prove the token was issued for this machine or this
1056
+ * product, so a token copied from another install passes it. claims.ins - the
1057
+ * install id sent as site_url - is the binding a client can check. claims.fp is
1058
+ * a server-side HMAC and cannot be recomputed here.
1059
+ */
1060
+ const char *fastr_entitlement(const char *token, const char *public_key_pem, const char *install_id, int product_id)
1061
+ {
1062
+ if (!fastr_verify_token(token, public_key_pem)) return "invalid_or_expired";
1063
+
1064
+ size_t token_len = strlen(token);
1065
+ char *copy = (char *) malloc(token_len + 8);
1066
+
1067
+ if (copy == NULL) return "invalid_or_expired";
1068
+
1069
+ memcpy(copy, token, token_len + 1);
1070
+
1071
+ char *first = strchr(copy, '.');
1072
+ if (first == NULL) { free(copy); return "invalid_or_expired"; }
1073
+
1074
+ char *payload = first + 1;
1075
+ char *second = strchr(payload, '.');
1076
+
1077
+ if (second == NULL) { free(copy); return "invalid_or_expired"; }
1078
+
1079
+ *second = '\0';
1080
+
1081
+ for (char *p = payload; *p; ++p) {
1082
+ if (*p == '-') *p = '+';
1083
+ else if (*p == '_') *p = '/';
1084
+ }
1085
+
1086
+ size_t payload_len = strlen(payload);
1087
+ size_t padding = (4 - payload_len % 4) % 4;
1088
+
1089
+ for (size_t i = 0; i < padding; ++i) strcat(payload, "=");
1090
+
1091
+ unsigned char decoded[8192];
1092
+ int size = EVP_DecodeBlock(decoded, (unsigned char *) payload, (int) strlen(payload));
1093
+
1094
+ free(copy);
1095
+
1096
+ if (size <= 0) return "invalid_or_expired";
1097
+
1098
+ size -= (int) padding;
1099
+
1100
+ if (size <= 0 || (size_t) size >= sizeof(decoded)) return "invalid_or_expired";
1101
+
1102
+ decoded[size] = '\0';
1103
+
1104
+ const char *json = (const char *) decoded;
1105
+ char claim[160];
1106
+
1107
+ if (!fastr_claim(json, "exp", claim, sizeof(claim))) return "invalid_or_expired";
1108
+ if (atoll(claim) <= 0 || atoll(claim) <= (long long) time(NULL)) return "invalid_or_expired";
1109
+
1110
+ if (product_id > 0) {
1111
+ if (!fastr_claim(json, "prod", claim, sizeof(claim))) return "wrong_product";
1112
+ if (atoi(claim) != product_id) return "wrong_product";
1113
+ }
1114
+
1115
+ if (install_id != NULL && install_id[0] != '\0') {
1116
+ if (fastr_claim(json, "ins", claim, sizeof(claim)) && strcmp(claim, install_id) != 0) {
1117
+ return "wrong_install";
1118
+ }
1119
+ }
1120
+
1121
+ return NULL;
1122
+ }
1123
1123
  `;
1124
1124
  }
1125
1125
  //# sourceMappingURL=templates-native.js.map