django-cfg 1.2.31__py3-none-any.whl → 1.3.3__py3-none-any.whl

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 (264) hide show
  1. django_cfg/__init__.py +1 -1
  2. django_cfg/apps/api/health/views.py +4 -2
  3. django_cfg/apps/knowbase/config/settings.py +16 -15
  4. django_cfg/apps/payments/README.md +326 -0
  5. django_cfg/apps/payments/admin/__init__.py +20 -10
  6. django_cfg/apps/payments/admin/api_keys_admin.py +521 -237
  7. django_cfg/apps/payments/admin/balance_admin.py +592 -297
  8. django_cfg/apps/payments/admin/currencies_admin.py +526 -222
  9. django_cfg/apps/payments/admin/filters.py +306 -199
  10. django_cfg/apps/payments/admin/payments_admin.py +465 -70
  11. django_cfg/apps/payments/admin/subscriptions_admin.py +578 -128
  12. django_cfg/apps/payments/admin_interface/__init__.py +18 -0
  13. django_cfg/apps/payments/admin_interface/templates/payments/base.html +162 -0
  14. django_cfg/apps/payments/admin_interface/templates/payments/components/dev_tool_card.html +38 -0
  15. django_cfg/apps/payments/admin_interface/templates/payments/components/loading_spinner.html +16 -0
  16. django_cfg/apps/payments/admin_interface/templates/payments/components/notification.html +27 -0
  17. django_cfg/apps/payments/admin_interface/templates/payments/components/provider_card.html +86 -0
  18. django_cfg/apps/payments/admin_interface/templates/payments/components/status_card.html +39 -0
  19. django_cfg/apps/payments/admin_interface/templates/payments/currency_converter.html +382 -0
  20. django_cfg/apps/payments/admin_interface/templates/payments/payment_dashboard.html +300 -0
  21. django_cfg/apps/payments/admin_interface/templates/payments/payment_form.html +303 -0
  22. django_cfg/apps/payments/admin_interface/templates/payments/payment_list.html +382 -0
  23. django_cfg/apps/payments/admin_interface/templates/payments/payment_status.html +500 -0
  24. django_cfg/apps/payments/admin_interface/templates/payments/webhook_dashboard.html +594 -0
  25. django_cfg/apps/payments/admin_interface/views/__init__.py +23 -0
  26. django_cfg/apps/payments/admin_interface/views/payment_views.py +259 -0
  27. django_cfg/apps/payments/admin_interface/views/webhook_dashboard.py +37 -0
  28. django_cfg/apps/payments/apps.py +34 -9
  29. django_cfg/apps/payments/config/__init__.py +28 -51
  30. django_cfg/apps/payments/config/constance/__init__.py +22 -0
  31. django_cfg/apps/payments/config/constance/config_service.py +123 -0
  32. django_cfg/apps/payments/config/constance/fields.py +69 -0
  33. django_cfg/apps/payments/config/constance/settings.py +160 -0
  34. django_cfg/apps/payments/config/django_cfg_integration.py +202 -0
  35. django_cfg/apps/payments/config/helpers.py +130 -0
  36. django_cfg/apps/payments/management/__init__.py +1 -3
  37. django_cfg/apps/payments/management/commands/__init__.py +1 -3
  38. django_cfg/apps/payments/management/commands/cleanup_expired_data.py +419 -0
  39. django_cfg/apps/payments/management/commands/currency_stats.py +297 -225
  40. django_cfg/apps/payments/management/commands/manage_currencies.py +303 -151
  41. django_cfg/apps/payments/management/commands/manage_providers.py +333 -160
  42. django_cfg/apps/payments/management/commands/process_pending_payments.py +357 -0
  43. django_cfg/apps/payments/management/commands/test_providers.py +434 -0
  44. django_cfg/apps/payments/middleware/__init__.py +3 -1
  45. django_cfg/apps/payments/middleware/api_access.py +329 -222
  46. django_cfg/apps/payments/middleware/rate_limiting.py +342 -152
  47. django_cfg/apps/payments/middleware/usage_tracking.py +249 -240
  48. django_cfg/apps/payments/migrations/0001_initial.py +708 -536
  49. django_cfg/apps/payments/models/__init__.py +13 -18
  50. django_cfg/apps/payments/models/api_keys.py +121 -43
  51. django_cfg/apps/payments/models/balance.py +153 -115
  52. django_cfg/apps/payments/models/base.py +68 -15
  53. django_cfg/apps/payments/models/currencies.py +172 -148
  54. django_cfg/apps/payments/models/managers/__init__.py +44 -0
  55. django_cfg/apps/payments/models/managers/api_key_managers.py +329 -0
  56. django_cfg/apps/payments/models/managers/balance_managers.py +599 -0
  57. django_cfg/apps/payments/models/managers/currency_managers.py +385 -0
  58. django_cfg/apps/payments/models/managers/payment_managers.py +511 -0
  59. django_cfg/apps/payments/models/managers/subscription_managers.py +641 -0
  60. django_cfg/apps/payments/models/payments.py +235 -285
  61. django_cfg/apps/payments/models/subscriptions.py +257 -177
  62. django_cfg/apps/payments/models/tariffs.py +147 -40
  63. django_cfg/apps/payments/services/__init__.py +209 -56
  64. django_cfg/apps/payments/services/cache/__init__.py +6 -6
  65. django_cfg/apps/payments/services/cache_service/__init__.py +143 -0
  66. django_cfg/apps/payments/services/cache_service/api_key_cache.py +37 -0
  67. django_cfg/apps/payments/services/{cache/base.py → cache_service/interfaces.py} +3 -1
  68. django_cfg/apps/payments/services/cache_service/keys.py +49 -0
  69. django_cfg/apps/payments/services/cache_service/rate_limit_cache.py +47 -0
  70. django_cfg/apps/payments/services/cache_service/simple_cache.py +101 -0
  71. django_cfg/apps/payments/services/core/__init__.py +10 -6
  72. django_cfg/apps/payments/services/core/balance_service.py +435 -360
  73. django_cfg/apps/payments/services/core/base.py +166 -0
  74. django_cfg/apps/payments/services/core/currency_service.py +478 -0
  75. django_cfg/apps/payments/services/core/payment_service.py +371 -465
  76. django_cfg/apps/payments/services/core/subscription_service.py +425 -481
  77. django_cfg/apps/payments/services/core/webhook_service.py +410 -0
  78. django_cfg/apps/payments/services/integrations/__init__.py +29 -0
  79. django_cfg/apps/payments/services/integrations/ngrok_service.py +47 -0
  80. django_cfg/apps/payments/services/integrations/providers_config.py +107 -0
  81. django_cfg/apps/payments/services/providers/__init__.py +9 -14
  82. django_cfg/apps/payments/services/providers/base.py +234 -174
  83. django_cfg/apps/payments/services/providers/nowpayments.py +478 -0
  84. django_cfg/apps/payments/services/providers/registry.py +367 -301
  85. django_cfg/apps/payments/services/types/__init__.py +78 -0
  86. django_cfg/apps/payments/services/types/data.py +177 -0
  87. django_cfg/apps/payments/services/types/requests.py +150 -0
  88. django_cfg/apps/payments/services/types/responses.py +156 -0
  89. django_cfg/apps/payments/services/types/webhooks.py +232 -0
  90. django_cfg/apps/payments/signals/__init__.py +33 -8
  91. django_cfg/apps/payments/signals/api_key_signals.py +210 -129
  92. django_cfg/apps/payments/signals/balance_signals.py +174 -0
  93. django_cfg/apps/payments/signals/payment_signals.py +128 -103
  94. django_cfg/apps/payments/signals/subscription_signals.py +194 -142
  95. django_cfg/apps/payments/static/payments/css/components.css +380 -0
  96. django_cfg/apps/payments/static/payments/css/dashboard.css +188 -0
  97. django_cfg/apps/payments/static/payments/js/components.js +545 -0
  98. django_cfg/apps/payments/static/payments/js/utils.js +412 -0
  99. django_cfg/apps/payments/templatetags/__init__.py +1 -1
  100. django_cfg/apps/payments/templatetags/payment_tags.py +466 -0
  101. django_cfg/apps/payments/urls.py +45 -48
  102. django_cfg/apps/payments/urls_admin.py +33 -42
  103. django_cfg/apps/payments/views/api/__init__.py +101 -0
  104. django_cfg/apps/payments/views/api/api_keys.py +387 -0
  105. django_cfg/apps/payments/views/api/balances.py +381 -0
  106. django_cfg/apps/payments/views/api/base.py +298 -0
  107. django_cfg/apps/payments/views/api/currencies.py +402 -0
  108. django_cfg/apps/payments/views/api/payments.py +415 -0
  109. django_cfg/apps/payments/views/api/subscriptions.py +475 -0
  110. django_cfg/apps/payments/views/api/webhooks.py +476 -0
  111. django_cfg/apps/payments/views/serializers/__init__.py +99 -0
  112. django_cfg/apps/payments/views/serializers/api_keys.py +424 -0
  113. django_cfg/apps/payments/views/serializers/balances.py +300 -0
  114. django_cfg/apps/payments/views/serializers/currencies.py +335 -0
  115. django_cfg/apps/payments/views/serializers/payments.py +387 -0
  116. django_cfg/apps/payments/views/serializers/subscriptions.py +429 -0
  117. django_cfg/apps/payments/views/serializers/webhooks.py +137 -0
  118. django_cfg/config.py +1 -1
  119. django_cfg/core/config.py +40 -4
  120. django_cfg/core/generation.py +25 -4
  121. django_cfg/core/integration/README.md +363 -0
  122. django_cfg/core/integration/__init__.py +47 -0
  123. django_cfg/core/integration/commands_collector.py +239 -0
  124. django_cfg/core/integration/display/__init__.py +15 -0
  125. django_cfg/core/integration/display/base.py +157 -0
  126. django_cfg/core/integration/display/ngrok.py +164 -0
  127. django_cfg/core/integration/display/startup.py +815 -0
  128. django_cfg/core/integration/url_integration.py +123 -0
  129. django_cfg/core/integration/version_checker.py +160 -0
  130. django_cfg/management/commands/auto_generate.py +4 -0
  131. django_cfg/management/commands/check_settings.py +6 -0
  132. django_cfg/management/commands/clear_constance.py +5 -2
  133. django_cfg/management/commands/create_token.py +6 -0
  134. django_cfg/management/commands/list_urls.py +6 -0
  135. django_cfg/management/commands/migrate_all.py +6 -0
  136. django_cfg/management/commands/migrator.py +3 -0
  137. django_cfg/management/commands/rundramatiq.py +6 -0
  138. django_cfg/management/commands/runserver_ngrok.py +51 -29
  139. django_cfg/management/commands/script.py +6 -0
  140. django_cfg/management/commands/show_config.py +12 -2
  141. django_cfg/management/commands/show_urls.py +4 -0
  142. django_cfg/management/commands/superuser.py +6 -0
  143. django_cfg/management/commands/task_clear.py +4 -1
  144. django_cfg/management/commands/task_status.py +3 -1
  145. django_cfg/management/commands/test_email.py +3 -0
  146. django_cfg/management/commands/test_telegram.py +6 -0
  147. django_cfg/management/commands/test_twilio.py +6 -0
  148. django_cfg/management/commands/tree.py +6 -0
  149. django_cfg/management/commands/validate_config.py +155 -149
  150. django_cfg/models/constance.py +31 -11
  151. django_cfg/models/payments.py +175 -492
  152. django_cfg/modules/django_logger.py +160 -146
  153. django_cfg/modules/django_unfold/dashboard.py +64 -16
  154. django_cfg/registry/core.py +1 -0
  155. django_cfg/template_archive/django_sample.zip +0 -0
  156. django_cfg/utils/smart_defaults.py +227 -570
  157. django_cfg/utils/toolkit.py +51 -11
  158. {django_cfg-1.2.31.dist-info → django_cfg-1.3.3.dist-info}/METADATA +4 -1
  159. {django_cfg-1.2.31.dist-info → django_cfg-1.3.3.dist-info}/RECORD +162 -185
  160. django_cfg/apps/payments/__init__.py +0 -8
  161. django_cfg/apps/payments/admin/tariffs_admin.py +0 -199
  162. django_cfg/apps/payments/config/module.py +0 -70
  163. django_cfg/apps/payments/config/providers.py +0 -105
  164. django_cfg/apps/payments/config/settings.py +0 -96
  165. django_cfg/apps/payments/config/utils.py +0 -52
  166. django_cfg/apps/payments/decorators.py +0 -291
  167. django_cfg/apps/payments/management/commands/README.md +0 -146
  168. django_cfg/apps/payments/managers/__init__.py +0 -23
  169. django_cfg/apps/payments/managers/api_key_manager.py +0 -35
  170. django_cfg/apps/payments/managers/balance_manager.py +0 -361
  171. django_cfg/apps/payments/managers/currency_manager.py +0 -306
  172. django_cfg/apps/payments/managers/payment_manager.py +0 -192
  173. django_cfg/apps/payments/managers/subscription_manager.py +0 -37
  174. django_cfg/apps/payments/managers/tariff_manager.py +0 -29
  175. django_cfg/apps/payments/migrations/0002_network_providercurrency_and_more.py +0 -241
  176. django_cfg/apps/payments/migrations/0003_add_usd_rate_cache.py +0 -30
  177. django_cfg/apps/payments/models/events.py +0 -73
  178. django_cfg/apps/payments/serializers/__init__.py +0 -57
  179. django_cfg/apps/payments/serializers/api_keys.py +0 -51
  180. django_cfg/apps/payments/serializers/balance.py +0 -59
  181. django_cfg/apps/payments/serializers/currencies.py +0 -63
  182. django_cfg/apps/payments/serializers/payments.py +0 -62
  183. django_cfg/apps/payments/serializers/subscriptions.py +0 -71
  184. django_cfg/apps/payments/serializers/tariffs.py +0 -56
  185. django_cfg/apps/payments/services/billing/__init__.py +0 -8
  186. django_cfg/apps/payments/services/cache/simple_cache.py +0 -135
  187. django_cfg/apps/payments/services/core/fallback_service.py +0 -432
  188. django_cfg/apps/payments/services/internal_types.py +0 -461
  189. django_cfg/apps/payments/services/middleware/__init__.py +0 -8
  190. django_cfg/apps/payments/services/monitoring/__init__.py +0 -22
  191. django_cfg/apps/payments/services/monitoring/api_schemas.py +0 -76
  192. django_cfg/apps/payments/services/monitoring/provider_health.py +0 -372
  193. django_cfg/apps/payments/services/providers/cryptapi/__init__.py +0 -4
  194. django_cfg/apps/payments/services/providers/cryptapi/config.py +0 -8
  195. django_cfg/apps/payments/services/providers/cryptapi/models.py +0 -192
  196. django_cfg/apps/payments/services/providers/cryptapi/provider.py +0 -439
  197. django_cfg/apps/payments/services/providers/cryptomus/__init__.py +0 -4
  198. django_cfg/apps/payments/services/providers/cryptomus/models.py +0 -176
  199. django_cfg/apps/payments/services/providers/cryptomus/provider.py +0 -429
  200. django_cfg/apps/payments/services/providers/cryptomus/provider_v2.py +0 -564
  201. django_cfg/apps/payments/services/providers/models/__init__.py +0 -34
  202. django_cfg/apps/payments/services/providers/models/currencies.py +0 -190
  203. django_cfg/apps/payments/services/providers/nowpayments/__init__.py +0 -4
  204. django_cfg/apps/payments/services/providers/nowpayments/models.py +0 -196
  205. django_cfg/apps/payments/services/providers/nowpayments/provider.py +0 -380
  206. django_cfg/apps/payments/services/providers/stripe/__init__.py +0 -4
  207. django_cfg/apps/payments/services/providers/stripe/models.py +0 -184
  208. django_cfg/apps/payments/services/providers/stripe/provider.py +0 -109
  209. django_cfg/apps/payments/services/security/__init__.py +0 -34
  210. django_cfg/apps/payments/services/security/error_handler.py +0 -635
  211. django_cfg/apps/payments/services/security/payment_notifications.py +0 -342
  212. django_cfg/apps/payments/services/security/webhook_validator.py +0 -474
  213. django_cfg/apps/payments/static/payments/css/payments.css +0 -340
  214. django_cfg/apps/payments/static/payments/js/notifications.js +0 -202
  215. django_cfg/apps/payments/static/payments/js/payment-utils.js +0 -318
  216. django_cfg/apps/payments/static/payments/js/theme.js +0 -86
  217. django_cfg/apps/payments/tasks/__init__.py +0 -12
  218. django_cfg/apps/payments/tasks/webhook_processing.py +0 -177
  219. django_cfg/apps/payments/templates/admin/payments/currency/change_list.html +0 -50
  220. django_cfg/apps/payments/templates/payments/base.html +0 -182
  221. django_cfg/apps/payments/templates/payments/components/payment_card.html +0 -201
  222. django_cfg/apps/payments/templates/payments/components/payment_qr_code.html +0 -109
  223. django_cfg/apps/payments/templates/payments/components/progress_bar.html +0 -43
  224. django_cfg/apps/payments/templates/payments/components/provider_stats.html +0 -40
  225. django_cfg/apps/payments/templates/payments/components/status_badge.html +0 -34
  226. django_cfg/apps/payments/templates/payments/components/status_overview.html +0 -148
  227. django_cfg/apps/payments/templates/payments/dashboard.html +0 -258
  228. django_cfg/apps/payments/templates/payments/dashboard_simple_test.html +0 -35
  229. django_cfg/apps/payments/templates/payments/payment_create.html +0 -579
  230. django_cfg/apps/payments/templates/payments/payment_detail.html +0 -373
  231. django_cfg/apps/payments/templates/payments/payment_list.html +0 -354
  232. django_cfg/apps/payments/templates/payments/stats.html +0 -261
  233. django_cfg/apps/payments/templates/payments/test.html +0 -213
  234. django_cfg/apps/payments/templatetags/payments_tags.py +0 -315
  235. django_cfg/apps/payments/utils/__init__.py +0 -43
  236. django_cfg/apps/payments/utils/billing_utils.py +0 -342
  237. django_cfg/apps/payments/utils/config_utils.py +0 -239
  238. django_cfg/apps/payments/utils/middleware_utils.py +0 -228
  239. django_cfg/apps/payments/utils/validation_utils.py +0 -94
  240. django_cfg/apps/payments/views/__init__.py +0 -63
  241. django_cfg/apps/payments/views/api_key_views.py +0 -164
  242. django_cfg/apps/payments/views/balance_views.py +0 -75
  243. django_cfg/apps/payments/views/currency_views.py +0 -122
  244. django_cfg/apps/payments/views/payment_views.py +0 -149
  245. django_cfg/apps/payments/views/subscription_views.py +0 -135
  246. django_cfg/apps/payments/views/tariff_views.py +0 -131
  247. django_cfg/apps/payments/views/templates/__init__.py +0 -25
  248. django_cfg/apps/payments/views/templates/ajax.py +0 -451
  249. django_cfg/apps/payments/views/templates/base.py +0 -212
  250. django_cfg/apps/payments/views/templates/dashboard.py +0 -60
  251. django_cfg/apps/payments/views/templates/payment_detail.py +0 -102
  252. django_cfg/apps/payments/views/templates/payment_management.py +0 -158
  253. django_cfg/apps/payments/views/templates/qr_code.py +0 -174
  254. django_cfg/apps/payments/views/templates/stats.py +0 -244
  255. django_cfg/apps/payments/views/templates/utils.py +0 -181
  256. django_cfg/apps/payments/views/webhook_views.py +0 -266
  257. django_cfg/apps/payments/viewsets.py +0 -66
  258. django_cfg/core/integration.py +0 -160
  259. django_cfg/template_archive/.gitignore +0 -1
  260. django_cfg/template_archive/__init__.py +0 -0
  261. django_cfg/urls.py +0 -33
  262. {django_cfg-1.2.31.dist-info → django_cfg-1.3.3.dist-info}/WHEEL +0 -0
  263. {django_cfg-1.2.31.dist-info → django_cfg-1.3.3.dist-info}/entry_points.txt +0 -0
  264. {django_cfg-1.2.31.dist-info → django_cfg-1.3.3.dist-info}/licenses/LICENSE +0 -0
@@ -0,0 +1,412 @@
1
+ /**
2
+ * Universal Payment System v2.0 - Utility Functions
3
+ *
4
+ * Global utilities for the payment system interface.
5
+ */
6
+
7
+ // Global PaymentSystem namespace
8
+ window.PaymentSystem = window.PaymentSystem || {};
9
+
10
+ /**
11
+ * Utility functions
12
+ */
13
+ PaymentSystem.Utils = {
14
+ /**
15
+ * Copy text to clipboard with Material Icons feedback
16
+ * @param {string} text - Text to copy
17
+ * @param {string} successMessage - Success message to show
18
+ */
19
+ copyToClipboard: function(text, successMessage = 'Copied to clipboard!') {
20
+ if (navigator.clipboard && window.isSecureContext) {
21
+ navigator.clipboard.writeText(text).then(() => {
22
+ this.showNotification(successMessage, 'success', 'content_copy');
23
+ }).catch(() => {
24
+ this.fallbackCopyToClipboard(text, successMessage);
25
+ });
26
+ } else {
27
+ this.fallbackCopyToClipboard(text, successMessage);
28
+ }
29
+ },
30
+
31
+ /**
32
+ * Fallback copy method for older browsers
33
+ * @param {string} text - Text to copy
34
+ * @param {string} successMessage - Success message to show
35
+ */
36
+ fallbackCopyToClipboard: function(text, successMessage) {
37
+ const textArea = document.createElement('textarea');
38
+ textArea.value = text;
39
+ textArea.style.position = 'fixed';
40
+ textArea.style.left = '-999999px';
41
+ textArea.style.top = '-999999px';
42
+ document.body.appendChild(textArea);
43
+ textArea.focus();
44
+ textArea.select();
45
+
46
+ try {
47
+ document.execCommand('copy');
48
+ this.showNotification(successMessage, 'success', 'content_copy');
49
+ } catch (err) {
50
+ this.showNotification('Failed to copy to clipboard', 'error', 'error');
51
+ }
52
+
53
+ document.body.removeChild(textArea);
54
+ },
55
+
56
+ /**
57
+ * Show notification with Material Icons
58
+ * @param {string} message - Notification message
59
+ * @param {string} type - Notification type (success, error, warning, info)
60
+ * @param {string} icon - Material icon name
61
+ * @param {number} duration - Duration in milliseconds
62
+ */
63
+ showNotification: function(message, type = 'info', icon = null, duration = 5000) {
64
+ // Remove existing notifications of the same type
65
+ const existingNotifications = document.querySelectorAll(`.notification.${type}`);
66
+ existingNotifications.forEach(notification => {
67
+ notification.remove();
68
+ });
69
+
70
+ const notification = document.createElement('div');
71
+ notification.className = `notification ${type} slide-in`;
72
+
73
+ // Default icons for each type
74
+ const defaultIcons = {
75
+ success: 'check_circle',
76
+ error: 'error',
77
+ warning: 'warning',
78
+ info: 'info'
79
+ };
80
+
81
+ const iconName = icon || defaultIcons[type] || 'info';
82
+
83
+ notification.innerHTML = `
84
+ <span class="material-icons-outlined">${iconName}</span>
85
+ <span class="flex-1">${message}</span>
86
+ <button class="close-btn" onclick="this.parentElement.remove()">
87
+ <span class="material-icons-outlined">close</span>
88
+ </button>
89
+ `;
90
+
91
+ document.body.appendChild(notification);
92
+
93
+ // Auto-remove after duration
94
+ setTimeout(() => {
95
+ if (notification.parentElement) {
96
+ notification.classList.remove('slide-in');
97
+ notification.classList.add('slide-out');
98
+ setTimeout(() => {
99
+ notification.remove();
100
+ }, 300);
101
+ }
102
+ }, duration);
103
+ },
104
+
105
+ /**
106
+ * Format currency with proper locale
107
+ * @param {number} amount - Amount to format
108
+ * @param {string} currency - Currency code
109
+ * @param {string} locale - Locale for formatting
110
+ * @returns {string} Formatted currency string
111
+ */
112
+ formatCurrency: function(amount, currency = 'USD', locale = 'en-US') {
113
+ try {
114
+ return new Intl.NumberFormat(locale, {
115
+ style: 'currency',
116
+ currency: currency,
117
+ minimumFractionDigits: currency === 'USD' ? 2 : 8
118
+ }).format(amount);
119
+ } catch (error) {
120
+ return `${amount} ${currency}`;
121
+ }
122
+ },
123
+
124
+ /**
125
+ * Format date with relative time
126
+ * @param {string|Date} dateString - Date to format
127
+ * @param {boolean} relative - Whether to show relative time
128
+ * @returns {string} Formatted date string
129
+ */
130
+ formatDate: function(dateString, relative = false) {
131
+ const date = new Date(dateString);
132
+
133
+ if (relative) {
134
+ const now = new Date();
135
+ const diffInSeconds = Math.floor((now - date) / 1000);
136
+
137
+ if (diffInSeconds < 60) return 'Just now';
138
+ if (diffInSeconds < 3600) return `${Math.floor(diffInSeconds / 60)} minutes ago`;
139
+ if (diffInSeconds < 86400) return `${Math.floor(diffInSeconds / 3600)} hours ago`;
140
+ if (diffInSeconds < 2592000) return `${Math.floor(diffInSeconds / 86400)} days ago`;
141
+ }
142
+
143
+ return date.toLocaleString();
144
+ },
145
+
146
+ /**
147
+ * Debounce function calls
148
+ * @param {Function} func - Function to debounce
149
+ * @param {number} wait - Wait time in milliseconds
150
+ * @param {boolean} immediate - Whether to execute immediately
151
+ * @returns {Function} Debounced function
152
+ */
153
+ debounce: function(func, wait, immediate = false) {
154
+ let timeout;
155
+ return function executedFunction(...args) {
156
+ const later = () => {
157
+ timeout = null;
158
+ if (!immediate) func.apply(this, args);
159
+ };
160
+ const callNow = immediate && !timeout;
161
+ clearTimeout(timeout);
162
+ timeout = setTimeout(later, wait);
163
+ if (callNow) func.apply(this, args);
164
+ };
165
+ },
166
+
167
+ /**
168
+ * Throttle function calls
169
+ * @param {Function} func - Function to throttle
170
+ * @param {number} limit - Time limit in milliseconds
171
+ * @returns {Function} Throttled function
172
+ */
173
+ throttle: function(func, limit) {
174
+ let inThrottle;
175
+ return function(...args) {
176
+ if (!inThrottle) {
177
+ func.apply(this, args);
178
+ inThrottle = true;
179
+ setTimeout(() => inThrottle = false, limit);
180
+ }
181
+ };
182
+ },
183
+
184
+ /**
185
+ * Generate random ID
186
+ * @param {number} length - Length of ID
187
+ * @returns {string} Random ID
188
+ */
189
+ generateId: function(length = 8) {
190
+ return Math.random().toString(36).substring(2, length + 2);
191
+ },
192
+
193
+ /**
194
+ * Validate email address
195
+ * @param {string} email - Email to validate
196
+ * @returns {boolean} Whether email is valid
197
+ */
198
+ isValidEmail: function(email) {
199
+ const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
200
+ return emailRegex.test(email);
201
+ },
202
+
203
+ /**
204
+ * Validate URL
205
+ * @param {string} url - URL to validate
206
+ * @returns {boolean} Whether URL is valid
207
+ */
208
+ isValidUrl: function(url) {
209
+ try {
210
+ new URL(url);
211
+ return true;
212
+ } catch {
213
+ return false;
214
+ }
215
+ },
216
+
217
+ /**
218
+ * Get status badge class
219
+ * @param {string} status - Status value
220
+ * @returns {string} CSS class for status badge
221
+ */
222
+ getStatusBadgeClass: function(status) {
223
+ const statusMap = {
224
+ 'completed': 'success',
225
+ 'success': 'success',
226
+ 'active': 'success',
227
+ 'failed': 'error',
228
+ 'error': 'error',
229
+ 'cancelled': 'error',
230
+ 'pending': 'warning',
231
+ 'processing': 'info',
232
+ 'inactive': 'error'
233
+ };
234
+
235
+ return `status-badge ${statusMap[status.toLowerCase()] || 'info'}`;
236
+ },
237
+
238
+ /**
239
+ * Get Material Icon for status
240
+ * @param {string} status - Status value
241
+ * @returns {string} Material icon name
242
+ */
243
+ getStatusIcon: function(status) {
244
+ const iconMap = {
245
+ 'completed': 'check_circle',
246
+ 'success': 'check_circle',
247
+ 'active': 'check_circle',
248
+ 'failed': 'error',
249
+ 'error': 'error',
250
+ 'cancelled': 'cancel',
251
+ 'pending': 'schedule',
252
+ 'processing': 'sync',
253
+ 'inactive': 'radio_button_unchecked'
254
+ };
255
+
256
+ return iconMap[status.toLowerCase()] || 'help';
257
+ },
258
+
259
+ /**
260
+ * Format file size
261
+ * @param {number} bytes - File size in bytes
262
+ * @returns {string} Formatted file size
263
+ */
264
+ formatFileSize: function(bytes) {
265
+ if (bytes === 0) return '0 Bytes';
266
+
267
+ const k = 1024;
268
+ const sizes = ['Bytes', 'KB', 'MB', 'GB'];
269
+ const i = Math.floor(Math.log(bytes) / Math.log(k));
270
+
271
+ return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
272
+ },
273
+
274
+ /**
275
+ * Scroll to element smoothly
276
+ * @param {string|Element} element - Element or selector
277
+ * @param {number} offset - Offset from top
278
+ */
279
+ scrollToElement: function(element, offset = 0) {
280
+ const target = typeof element === 'string' ? document.querySelector(element) : element;
281
+ if (target) {
282
+ const targetPosition = target.offsetTop - offset;
283
+ window.scrollTo({
284
+ top: targetPosition,
285
+ behavior: 'smooth'
286
+ });
287
+ }
288
+ },
289
+
290
+ /**
291
+ * Check if element is in viewport
292
+ * @param {Element} element - Element to check
293
+ * @returns {boolean} Whether element is in viewport
294
+ */
295
+ isInViewport: function(element) {
296
+ const rect = element.getBoundingClientRect();
297
+ return (
298
+ rect.top >= 0 &&
299
+ rect.left >= 0 &&
300
+ rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
301
+ rect.right <= (window.innerWidth || document.documentElement.clientWidth)
302
+ );
303
+ }
304
+ };
305
+
306
+ /**
307
+ * Auto-refresh functionality
308
+ */
309
+ PaymentSystem.AutoRefresh = {
310
+ interval: null,
311
+
312
+ /**
313
+ * Setup auto-refresh for elements with data-auto-refresh attribute
314
+ * @param {number} intervalMs - Refresh interval in milliseconds
315
+ */
316
+ setup: function(intervalMs = 30000) {
317
+ if (document.querySelector('[data-auto-refresh]')) {
318
+ this.interval = setInterval(() => {
319
+ this.refresh();
320
+ }, intervalMs);
321
+ }
322
+ },
323
+
324
+ /**
325
+ * Refresh the page or specific elements
326
+ */
327
+ refresh: function() {
328
+ const elements = document.querySelectorAll('[data-auto-refresh]');
329
+ if (elements.length > 0) {
330
+ elements.forEach(element => {
331
+ const refreshType = element.getAttribute('data-auto-refresh');
332
+ if (refreshType === 'page') {
333
+ location.reload();
334
+ } else if (refreshType === 'ajax' && element.hasAttribute('data-refresh-url')) {
335
+ this.refreshElement(element);
336
+ }
337
+ });
338
+ }
339
+ },
340
+
341
+ /**
342
+ * Refresh specific element via AJAX
343
+ * @param {Element} element - Element to refresh
344
+ */
345
+ refreshElement: function(element) {
346
+ const url = element.getAttribute('data-refresh-url');
347
+ if (url) {
348
+ fetch(url)
349
+ .then(response => response.text())
350
+ .then(html => {
351
+ element.innerHTML = html;
352
+ })
353
+ .catch(error => {
354
+ console.error('Auto-refresh failed:', error);
355
+ });
356
+ }
357
+ },
358
+
359
+ /**
360
+ * Stop auto-refresh
361
+ */
362
+ stop: function() {
363
+ if (this.interval) {
364
+ clearInterval(this.interval);
365
+ this.interval = null;
366
+ }
367
+ }
368
+ };
369
+
370
+ /**
371
+ * Initialize utilities on page load
372
+ */
373
+ document.addEventListener('DOMContentLoaded', function() {
374
+ // Setup auto-refresh if enabled
375
+ PaymentSystem.AutoRefresh.setup();
376
+
377
+ // Add global keyboard shortcuts
378
+ document.addEventListener('keydown', function(e) {
379
+ // Ctrl/Cmd + K for search (if search exists)
380
+ if ((e.ctrlKey || e.metaKey) && e.key === 'k') {
381
+ const searchInput = document.querySelector('[data-search]');
382
+ if (searchInput) {
383
+ e.preventDefault();
384
+ searchInput.focus();
385
+ }
386
+ }
387
+
388
+ // Escape to close modals
389
+ if (e.key === 'Escape') {
390
+ const modals = document.querySelectorAll('.modal-overlay');
391
+ modals.forEach(modal => {
392
+ if (modal.style.display !== 'none') {
393
+ modal.style.display = 'none';
394
+ }
395
+ });
396
+ }
397
+ });
398
+
399
+ // Add click-to-copy functionality for elements with data-copy attribute
400
+ document.addEventListener('click', function(e) {
401
+ const copyElement = e.target.closest('[data-copy]');
402
+ if (copyElement) {
403
+ const textToCopy = copyElement.getAttribute('data-copy') || copyElement.textContent;
404
+ PaymentSystem.Utils.copyToClipboard(textToCopy);
405
+ }
406
+ });
407
+ });
408
+
409
+ // Export for module systems
410
+ if (typeof module !== 'undefined' && module.exports) {
411
+ module.exports = PaymentSystem;
412
+ }
@@ -1 +1 @@
1
- # Template tags package for payments app
1
+ # Template tags package