django-cfg 1.2.29__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 (258) 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 -9
  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 +600 -108
  9. django_cfg/apps/payments/admin/filters.py +306 -199
  10. django_cfg/apps/payments/admin/payments_admin.py +470 -64
  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 +381 -0
  39. django_cfg/apps/payments/management/commands/manage_providers.py +408 -0
  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 +343 -163
  43. django_cfg/apps/payments/middleware/usage_tracking.py +250 -238
  44. django_cfg/apps/payments/migrations/0001_initial.py +708 -536
  45. django_cfg/apps/payments/models/__init__.py +16 -20
  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 +207 -67
  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 -284
  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 +344 -468
  67. django_cfg/apps/payments/services/core/subscription_service.py +425 -484
  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 +232 -71
  74. django_cfg/apps/payments/services/providers/nowpayments.py +404 -219
  75. django_cfg/apps/payments/services/providers/registry.py +429 -80
  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 +211 -130
  83. django_cfg/apps/payments/signals/balance_signals.py +174 -0
  84. django_cfg/apps/payments/signals/payment_signals.py +129 -98
  85. django_cfg/apps/payments/signals/subscription_signals.py +195 -143
  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 +46 -47
  93. django_cfg/apps/payments/urls_admin.py +49 -0
  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/apps/tasks/urls.py +0 -2
  110. django_cfg/apps/tasks/urls_admin.py +14 -0
  111. django_cfg/apps/urls.py +4 -4
  112. django_cfg/config.py +1 -1
  113. django_cfg/core/config.py +75 -4
  114. django_cfg/core/generation.py +25 -4
  115. django_cfg/core/integration/README.md +363 -0
  116. django_cfg/core/integration/__init__.py +47 -0
  117. django_cfg/core/integration/commands_collector.py +239 -0
  118. django_cfg/core/integration/display/__init__.py +15 -0
  119. django_cfg/core/integration/display/base.py +157 -0
  120. django_cfg/core/integration/display/ngrok.py +164 -0
  121. django_cfg/core/integration/display/startup.py +815 -0
  122. django_cfg/core/integration/url_integration.py +123 -0
  123. django_cfg/core/integration/version_checker.py +160 -0
  124. django_cfg/management/commands/auto_generate.py +4 -0
  125. django_cfg/management/commands/check_settings.py +6 -0
  126. django_cfg/management/commands/clear_constance.py +5 -2
  127. django_cfg/management/commands/create_token.py +6 -0
  128. django_cfg/management/commands/list_urls.py +6 -0
  129. django_cfg/management/commands/migrate_all.py +6 -0
  130. django_cfg/management/commands/migrator.py +3 -0
  131. django_cfg/management/commands/rundramatiq.py +6 -0
  132. django_cfg/management/commands/runserver_ngrok.py +51 -29
  133. django_cfg/management/commands/script.py +6 -0
  134. django_cfg/management/commands/show_config.py +12 -2
  135. django_cfg/management/commands/show_urls.py +4 -0
  136. django_cfg/management/commands/superuser.py +6 -0
  137. django_cfg/management/commands/task_clear.py +4 -1
  138. django_cfg/management/commands/task_status.py +3 -1
  139. django_cfg/management/commands/test_email.py +3 -0
  140. django_cfg/management/commands/test_telegram.py +6 -0
  141. django_cfg/management/commands/test_twilio.py +6 -0
  142. django_cfg/management/commands/tree.py +6 -0
  143. django_cfg/management/commands/validate_config.py +155 -149
  144. django_cfg/models/constance.py +31 -11
  145. django_cfg/models/payments.py +175 -498
  146. django_cfg/modules/django_currency/__init__.py +16 -11
  147. django_cfg/modules/django_currency/clients/__init__.py +4 -4
  148. django_cfg/modules/django_currency/clients/coinpaprika_client.py +289 -0
  149. django_cfg/modules/django_currency/clients/yahoo_client.py +157 -0
  150. django_cfg/modules/django_currency/core/__init__.py +1 -7
  151. django_cfg/modules/django_currency/core/converter.py +18 -23
  152. django_cfg/modules/django_currency/core/models.py +122 -11
  153. django_cfg/modules/django_currency/database/__init__.py +4 -4
  154. django_cfg/modules/django_currency/database/database_loader.py +190 -309
  155. django_cfg/modules/django_logger.py +160 -146
  156. django_cfg/modules/django_unfold/dashboard.py +65 -12
  157. django_cfg/registry/core.py +1 -0
  158. django_cfg/template_archive/django_sample.zip +0 -0
  159. django_cfg/templates/admin/components/action_grid.html +9 -9
  160. django_cfg/templates/admin/components/metric_card.html +5 -5
  161. django_cfg/templates/admin/components/status_badge.html +2 -2
  162. django_cfg/templates/admin/layouts/dashboard_with_tabs.html +152 -24
  163. django_cfg/templates/admin/snippets/components/quick_actions.html +3 -3
  164. django_cfg/templates/admin/snippets/components/system_health.html +1 -1
  165. django_cfg/templates/admin/snippets/tabs/overview_tab.html +49 -52
  166. django_cfg/utils/smart_defaults.py +222 -571
  167. django_cfg/utils/toolkit.py +51 -11
  168. {django_cfg-1.2.29.dist-info → django_cfg-1.3.1.dist-info}/METADATA +5 -4
  169. {django_cfg-1.2.29.dist-info → django_cfg-1.3.1.dist-info}/RECORD +172 -182
  170. django_cfg/apps/payments/__init__.py +0 -8
  171. django_cfg/apps/payments/admin/tariffs_admin.py +0 -199
  172. django_cfg/apps/payments/config/module.py +0 -70
  173. django_cfg/apps/payments/config/providers.py +0 -105
  174. django_cfg/apps/payments/config/settings.py +0 -96
  175. django_cfg/apps/payments/config/utils.py +0 -52
  176. django_cfg/apps/payments/decorators.py +0 -291
  177. django_cfg/apps/payments/management/commands/README.md +0 -178
  178. django_cfg/apps/payments/management/commands/currency_stats.py +0 -323
  179. django_cfg/apps/payments/management/commands/populate_currencies.py +0 -246
  180. django_cfg/apps/payments/management/commands/update_currencies.py +0 -336
  181. django_cfg/apps/payments/managers/__init__.py +0 -22
  182. django_cfg/apps/payments/managers/api_key_manager.py +0 -35
  183. django_cfg/apps/payments/managers/balance_manager.py +0 -361
  184. django_cfg/apps/payments/managers/currency_manager.py +0 -83
  185. django_cfg/apps/payments/managers/payment_manager.py +0 -44
  186. django_cfg/apps/payments/managers/subscription_manager.py +0 -37
  187. django_cfg/apps/payments/managers/tariff_manager.py +0 -29
  188. django_cfg/apps/payments/models/events.py +0 -73
  189. django_cfg/apps/payments/serializers/__init__.py +0 -56
  190. django_cfg/apps/payments/serializers/api_keys.py +0 -51
  191. django_cfg/apps/payments/serializers/balance.py +0 -59
  192. django_cfg/apps/payments/serializers/currencies.py +0 -55
  193. django_cfg/apps/payments/serializers/payments.py +0 -62
  194. django_cfg/apps/payments/serializers/subscriptions.py +0 -71
  195. django_cfg/apps/payments/serializers/tariffs.py +0 -56
  196. django_cfg/apps/payments/services/billing/__init__.py +0 -8
  197. django_cfg/apps/payments/services/cache/base.py +0 -30
  198. django_cfg/apps/payments/services/core/fallback_service.py +0 -432
  199. django_cfg/apps/payments/services/internal_types.py +0 -297
  200. django_cfg/apps/payments/services/middleware/__init__.py +0 -8
  201. django_cfg/apps/payments/services/monitoring/__init__.py +0 -22
  202. django_cfg/apps/payments/services/monitoring/api_schemas.py +0 -222
  203. django_cfg/apps/payments/services/monitoring/provider_health.py +0 -372
  204. django_cfg/apps/payments/services/providers/cryptapi.py +0 -273
  205. django_cfg/apps/payments/services/providers/cryptomus.py +0 -311
  206. django_cfg/apps/payments/services/security/__init__.py +0 -34
  207. django_cfg/apps/payments/services/security/error_handler.py +0 -637
  208. django_cfg/apps/payments/services/security/payment_notifications.py +0 -342
  209. django_cfg/apps/payments/services/security/webhook_validator.py +0 -475
  210. django_cfg/apps/payments/services/validators/__init__.py +0 -8
  211. django_cfg/apps/payments/static/payments/css/payments.css +0 -340
  212. django_cfg/apps/payments/static/payments/js/notifications.js +0 -202
  213. django_cfg/apps/payments/static/payments/js/payment-utils.js +0 -318
  214. django_cfg/apps/payments/static/payments/js/theme.js +0 -86
  215. django_cfg/apps/payments/tasks/__init__.py +0 -12
  216. django_cfg/apps/payments/tasks/webhook_processing.py +0 -177
  217. django_cfg/apps/payments/templates/payments/base.html +0 -182
  218. django_cfg/apps/payments/templates/payments/components/payment_card.html +0 -201
  219. django_cfg/apps/payments/templates/payments/components/payment_qr_code.html +0 -109
  220. django_cfg/apps/payments/templates/payments/components/progress_bar.html +0 -36
  221. django_cfg/apps/payments/templates/payments/components/provider_stats.html +0 -40
  222. django_cfg/apps/payments/templates/payments/components/status_badge.html +0 -27
  223. django_cfg/apps/payments/templates/payments/components/status_overview.html +0 -144
  224. django_cfg/apps/payments/templates/payments/dashboard.html +0 -346
  225. django_cfg/apps/payments/templatetags/payments_tags.py +0 -315
  226. django_cfg/apps/payments/urls_templates.py +0 -52
  227. django_cfg/apps/payments/utils/__init__.py +0 -45
  228. django_cfg/apps/payments/utils/billing_utils.py +0 -342
  229. django_cfg/apps/payments/utils/config_utils.py +0 -245
  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 -62
  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 -111
  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 -312
  241. django_cfg/apps/payments/views/templates/base.py +0 -204
  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 -164
  245. django_cfg/apps/payments/views/templates/qr_code.py +0 -174
  246. django_cfg/apps/payments/views/templates/stats.py +0 -240
  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 -65
  250. django_cfg/core/integration.py +0 -160
  251. django_cfg/modules/django_currency/clients/coingecko_client.py +0 -257
  252. django_cfg/modules/django_currency/clients/yfinance_client.py +0 -246
  253. django_cfg/template_archive/.gitignore +0 -1
  254. django_cfg/template_archive/__init__.py +0 -0
  255. django_cfg/urls.py +0 -33
  256. {django_cfg-1.2.29.dist-info → django_cfg-1.3.1.dist-info}/WHEEL +0 -0
  257. {django_cfg-1.2.29.dist-info → django_cfg-1.3.1.dist-info}/entry_points.txt +0 -0
  258. {django_cfg-1.2.29.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