django-cfg 1.2.31__py3-none-any.whl → 1.3.1__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 (256) 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/manage_currencies.py +303 -151
  39. django_cfg/apps/payments/management/commands/manage_providers.py +333 -160
  40. django_cfg/apps/payments/middleware/__init__.py +3 -1
  41. django_cfg/apps/payments/middleware/api_access.py +329 -222
  42. django_cfg/apps/payments/middleware/rate_limiting.py +342 -152
  43. django_cfg/apps/payments/middleware/usage_tracking.py +249 -240
  44. django_cfg/apps/payments/migrations/0001_initial.py +708 -536
  45. django_cfg/apps/payments/models/__init__.py +13 -18
  46. django_cfg/apps/payments/models/api_keys.py +121 -43
  47. django_cfg/apps/payments/models/balance.py +150 -115
  48. django_cfg/apps/payments/models/base.py +68 -15
  49. django_cfg/apps/payments/models/currencies.py +172 -148
  50. django_cfg/apps/payments/models/managers/__init__.py +44 -0
  51. django_cfg/apps/payments/models/managers/api_key_managers.py +329 -0
  52. django_cfg/apps/payments/models/managers/balance_managers.py +599 -0
  53. django_cfg/apps/payments/models/managers/currency_managers.py +385 -0
  54. django_cfg/apps/payments/models/managers/payment_managers.py +511 -0
  55. django_cfg/apps/payments/models/managers/subscription_managers.py +641 -0
  56. django_cfg/apps/payments/models/payments.py +235 -285
  57. django_cfg/apps/payments/models/subscriptions.py +257 -177
  58. django_cfg/apps/payments/models/tariffs.py +147 -40
  59. django_cfg/apps/payments/services/__init__.py +209 -56
  60. django_cfg/apps/payments/services/cache/__init__.py +6 -6
  61. django_cfg/apps/payments/services/cache/{simple_cache.py → cache_service.py} +112 -12
  62. django_cfg/apps/payments/services/core/__init__.py +10 -6
  63. django_cfg/apps/payments/services/core/balance_service.py +435 -360
  64. django_cfg/apps/payments/services/core/base.py +166 -0
  65. django_cfg/apps/payments/services/core/currency_service.py +478 -0
  66. django_cfg/apps/payments/services/core/payment_service.py +346 -467
  67. django_cfg/apps/payments/services/core/subscription_service.py +425 -481
  68. django_cfg/apps/payments/services/core/webhook_service.py +410 -0
  69. django_cfg/apps/payments/services/integrations/__init__.py +29 -0
  70. django_cfg/apps/payments/services/integrations/ngrok_service.py +47 -0
  71. django_cfg/apps/payments/services/integrations/providers_config.py +107 -0
  72. django_cfg/apps/payments/services/providers/__init__.py +9 -14
  73. django_cfg/apps/payments/services/providers/base.py +234 -174
  74. django_cfg/apps/payments/services/providers/nowpayments.py +478 -0
  75. django_cfg/apps/payments/services/providers/registry.py +367 -301
  76. django_cfg/apps/payments/services/types/__init__.py +78 -0
  77. django_cfg/apps/payments/services/types/data.py +177 -0
  78. django_cfg/apps/payments/services/types/requests.py +150 -0
  79. django_cfg/apps/payments/services/types/responses.py +156 -0
  80. django_cfg/apps/payments/services/types/webhooks.py +232 -0
  81. django_cfg/apps/payments/signals/__init__.py +33 -8
  82. django_cfg/apps/payments/signals/api_key_signals.py +210 -129
  83. django_cfg/apps/payments/signals/balance_signals.py +174 -0
  84. django_cfg/apps/payments/signals/payment_signals.py +128 -103
  85. django_cfg/apps/payments/signals/subscription_signals.py +194 -142
  86. django_cfg/apps/payments/static/payments/css/components.css +380 -0
  87. django_cfg/apps/payments/static/payments/css/dashboard.css +188 -0
  88. django_cfg/apps/payments/static/payments/js/components.js +545 -0
  89. django_cfg/apps/payments/static/payments/js/utils.js +412 -0
  90. django_cfg/apps/payments/templatetags/__init__.py +1 -1
  91. django_cfg/apps/payments/templatetags/payment_tags.py +466 -0
  92. django_cfg/apps/payments/urls.py +45 -48
  93. django_cfg/apps/payments/urls_admin.py +33 -42
  94. django_cfg/apps/payments/views/api/__init__.py +101 -0
  95. django_cfg/apps/payments/views/api/api_keys.py +387 -0
  96. django_cfg/apps/payments/views/api/balances.py +381 -0
  97. django_cfg/apps/payments/views/api/base.py +298 -0
  98. django_cfg/apps/payments/views/api/currencies.py +402 -0
  99. django_cfg/apps/payments/views/api/payments.py +415 -0
  100. django_cfg/apps/payments/views/api/subscriptions.py +475 -0
  101. django_cfg/apps/payments/views/api/webhooks.py +476 -0
  102. django_cfg/apps/payments/views/serializers/__init__.py +99 -0
  103. django_cfg/apps/payments/views/serializers/api_keys.py +424 -0
  104. django_cfg/apps/payments/views/serializers/balances.py +300 -0
  105. django_cfg/apps/payments/views/serializers/currencies.py +335 -0
  106. django_cfg/apps/payments/views/serializers/payments.py +387 -0
  107. django_cfg/apps/payments/views/serializers/subscriptions.py +429 -0
  108. django_cfg/apps/payments/views/serializers/webhooks.py +137 -0
  109. django_cfg/config.py +1 -1
  110. django_cfg/core/config.py +40 -4
  111. django_cfg/core/generation.py +25 -4
  112. django_cfg/core/integration/README.md +363 -0
  113. django_cfg/core/integration/__init__.py +47 -0
  114. django_cfg/core/integration/commands_collector.py +239 -0
  115. django_cfg/core/integration/display/__init__.py +15 -0
  116. django_cfg/core/integration/display/base.py +157 -0
  117. django_cfg/core/integration/display/ngrok.py +164 -0
  118. django_cfg/core/integration/display/startup.py +815 -0
  119. django_cfg/core/integration/url_integration.py +123 -0
  120. django_cfg/core/integration/version_checker.py +160 -0
  121. django_cfg/management/commands/auto_generate.py +4 -0
  122. django_cfg/management/commands/check_settings.py +6 -0
  123. django_cfg/management/commands/clear_constance.py +5 -2
  124. django_cfg/management/commands/create_token.py +6 -0
  125. django_cfg/management/commands/list_urls.py +6 -0
  126. django_cfg/management/commands/migrate_all.py +6 -0
  127. django_cfg/management/commands/migrator.py +3 -0
  128. django_cfg/management/commands/rundramatiq.py +6 -0
  129. django_cfg/management/commands/runserver_ngrok.py +51 -29
  130. django_cfg/management/commands/script.py +6 -0
  131. django_cfg/management/commands/show_config.py +12 -2
  132. django_cfg/management/commands/show_urls.py +4 -0
  133. django_cfg/management/commands/superuser.py +6 -0
  134. django_cfg/management/commands/task_clear.py +4 -1
  135. django_cfg/management/commands/task_status.py +3 -1
  136. django_cfg/management/commands/test_email.py +3 -0
  137. django_cfg/management/commands/test_telegram.py +6 -0
  138. django_cfg/management/commands/test_twilio.py +6 -0
  139. django_cfg/management/commands/tree.py +6 -0
  140. django_cfg/management/commands/validate_config.py +155 -149
  141. django_cfg/models/constance.py +31 -11
  142. django_cfg/models/payments.py +175 -492
  143. django_cfg/modules/django_logger.py +160 -146
  144. django_cfg/modules/django_unfold/dashboard.py +64 -16
  145. django_cfg/registry/core.py +1 -0
  146. django_cfg/template_archive/django_sample.zip +0 -0
  147. django_cfg/utils/smart_defaults.py +222 -571
  148. django_cfg/utils/toolkit.py +51 -11
  149. {django_cfg-1.2.31.dist-info → django_cfg-1.3.1.dist-info}/METADATA +4 -1
  150. {django_cfg-1.2.31.dist-info → django_cfg-1.3.1.dist-info}/RECORD +153 -185
  151. django_cfg/apps/payments/__init__.py +0 -8
  152. django_cfg/apps/payments/admin/tariffs_admin.py +0 -199
  153. django_cfg/apps/payments/config/module.py +0 -70
  154. django_cfg/apps/payments/config/providers.py +0 -105
  155. django_cfg/apps/payments/config/settings.py +0 -96
  156. django_cfg/apps/payments/config/utils.py +0 -52
  157. django_cfg/apps/payments/decorators.py +0 -291
  158. django_cfg/apps/payments/management/commands/README.md +0 -146
  159. django_cfg/apps/payments/management/commands/currency_stats.py +0 -304
  160. django_cfg/apps/payments/managers/__init__.py +0 -23
  161. django_cfg/apps/payments/managers/api_key_manager.py +0 -35
  162. django_cfg/apps/payments/managers/balance_manager.py +0 -361
  163. django_cfg/apps/payments/managers/currency_manager.py +0 -306
  164. django_cfg/apps/payments/managers/payment_manager.py +0 -192
  165. django_cfg/apps/payments/managers/subscription_manager.py +0 -37
  166. django_cfg/apps/payments/managers/tariff_manager.py +0 -29
  167. django_cfg/apps/payments/migrations/0002_network_providercurrency_and_more.py +0 -241
  168. django_cfg/apps/payments/migrations/0003_add_usd_rate_cache.py +0 -30
  169. django_cfg/apps/payments/models/events.py +0 -73
  170. django_cfg/apps/payments/serializers/__init__.py +0 -57
  171. django_cfg/apps/payments/serializers/api_keys.py +0 -51
  172. django_cfg/apps/payments/serializers/balance.py +0 -59
  173. django_cfg/apps/payments/serializers/currencies.py +0 -63
  174. django_cfg/apps/payments/serializers/payments.py +0 -62
  175. django_cfg/apps/payments/serializers/subscriptions.py +0 -71
  176. django_cfg/apps/payments/serializers/tariffs.py +0 -56
  177. django_cfg/apps/payments/services/billing/__init__.py +0 -8
  178. django_cfg/apps/payments/services/cache/base.py +0 -30
  179. django_cfg/apps/payments/services/core/fallback_service.py +0 -432
  180. django_cfg/apps/payments/services/internal_types.py +0 -461
  181. django_cfg/apps/payments/services/middleware/__init__.py +0 -8
  182. django_cfg/apps/payments/services/monitoring/__init__.py +0 -22
  183. django_cfg/apps/payments/services/monitoring/api_schemas.py +0 -76
  184. django_cfg/apps/payments/services/monitoring/provider_health.py +0 -372
  185. django_cfg/apps/payments/services/providers/cryptapi/__init__.py +0 -4
  186. django_cfg/apps/payments/services/providers/cryptapi/config.py +0 -8
  187. django_cfg/apps/payments/services/providers/cryptapi/models.py +0 -192
  188. django_cfg/apps/payments/services/providers/cryptapi/provider.py +0 -439
  189. django_cfg/apps/payments/services/providers/cryptomus/__init__.py +0 -4
  190. django_cfg/apps/payments/services/providers/cryptomus/models.py +0 -176
  191. django_cfg/apps/payments/services/providers/cryptomus/provider.py +0 -429
  192. django_cfg/apps/payments/services/providers/cryptomus/provider_v2.py +0 -564
  193. django_cfg/apps/payments/services/providers/models/__init__.py +0 -34
  194. django_cfg/apps/payments/services/providers/models/currencies.py +0 -190
  195. django_cfg/apps/payments/services/providers/nowpayments/__init__.py +0 -4
  196. django_cfg/apps/payments/services/providers/nowpayments/models.py +0 -196
  197. django_cfg/apps/payments/services/providers/nowpayments/provider.py +0 -380
  198. django_cfg/apps/payments/services/providers/stripe/__init__.py +0 -4
  199. django_cfg/apps/payments/services/providers/stripe/models.py +0 -184
  200. django_cfg/apps/payments/services/providers/stripe/provider.py +0 -109
  201. django_cfg/apps/payments/services/security/__init__.py +0 -34
  202. django_cfg/apps/payments/services/security/error_handler.py +0 -635
  203. django_cfg/apps/payments/services/security/payment_notifications.py +0 -342
  204. django_cfg/apps/payments/services/security/webhook_validator.py +0 -474
  205. django_cfg/apps/payments/static/payments/css/payments.css +0 -340
  206. django_cfg/apps/payments/static/payments/js/notifications.js +0 -202
  207. django_cfg/apps/payments/static/payments/js/payment-utils.js +0 -318
  208. django_cfg/apps/payments/static/payments/js/theme.js +0 -86
  209. django_cfg/apps/payments/tasks/__init__.py +0 -12
  210. django_cfg/apps/payments/tasks/webhook_processing.py +0 -177
  211. django_cfg/apps/payments/templates/admin/payments/currency/change_list.html +0 -50
  212. django_cfg/apps/payments/templates/payments/base.html +0 -182
  213. django_cfg/apps/payments/templates/payments/components/payment_card.html +0 -201
  214. django_cfg/apps/payments/templates/payments/components/payment_qr_code.html +0 -109
  215. django_cfg/apps/payments/templates/payments/components/progress_bar.html +0 -43
  216. django_cfg/apps/payments/templates/payments/components/provider_stats.html +0 -40
  217. django_cfg/apps/payments/templates/payments/components/status_badge.html +0 -34
  218. django_cfg/apps/payments/templates/payments/components/status_overview.html +0 -148
  219. django_cfg/apps/payments/templates/payments/dashboard.html +0 -258
  220. django_cfg/apps/payments/templates/payments/dashboard_simple_test.html +0 -35
  221. django_cfg/apps/payments/templates/payments/payment_create.html +0 -579
  222. django_cfg/apps/payments/templates/payments/payment_detail.html +0 -373
  223. django_cfg/apps/payments/templates/payments/payment_list.html +0 -354
  224. django_cfg/apps/payments/templates/payments/stats.html +0 -261
  225. django_cfg/apps/payments/templates/payments/test.html +0 -213
  226. django_cfg/apps/payments/templatetags/payments_tags.py +0 -315
  227. django_cfg/apps/payments/utils/__init__.py +0 -43
  228. django_cfg/apps/payments/utils/billing_utils.py +0 -342
  229. django_cfg/apps/payments/utils/config_utils.py +0 -239
  230. django_cfg/apps/payments/utils/middleware_utils.py +0 -228
  231. django_cfg/apps/payments/utils/validation_utils.py +0 -94
  232. django_cfg/apps/payments/views/__init__.py +0 -63
  233. django_cfg/apps/payments/views/api_key_views.py +0 -164
  234. django_cfg/apps/payments/views/balance_views.py +0 -75
  235. django_cfg/apps/payments/views/currency_views.py +0 -122
  236. django_cfg/apps/payments/views/payment_views.py +0 -149
  237. django_cfg/apps/payments/views/subscription_views.py +0 -135
  238. django_cfg/apps/payments/views/tariff_views.py +0 -131
  239. django_cfg/apps/payments/views/templates/__init__.py +0 -25
  240. django_cfg/apps/payments/views/templates/ajax.py +0 -451
  241. django_cfg/apps/payments/views/templates/base.py +0 -212
  242. django_cfg/apps/payments/views/templates/dashboard.py +0 -60
  243. django_cfg/apps/payments/views/templates/payment_detail.py +0 -102
  244. django_cfg/apps/payments/views/templates/payment_management.py +0 -158
  245. django_cfg/apps/payments/views/templates/qr_code.py +0 -174
  246. django_cfg/apps/payments/views/templates/stats.py +0 -244
  247. django_cfg/apps/payments/views/templates/utils.py +0 -181
  248. django_cfg/apps/payments/views/webhook_views.py +0 -266
  249. django_cfg/apps/payments/viewsets.py +0 -66
  250. django_cfg/core/integration.py +0 -160
  251. django_cfg/template_archive/.gitignore +0 -1
  252. django_cfg/template_archive/__init__.py +0 -0
  253. django_cfg/urls.py +0 -33
  254. {django_cfg-1.2.31.dist-info → django_cfg-1.3.1.dist-info}/WHEEL +0 -0
  255. {django_cfg-1.2.31.dist-info → django_cfg-1.3.1.dist-info}/entry_points.txt +0 -0
  256. {django_cfg-1.2.31.dist-info → django_cfg-1.3.1.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