@gravito/radiance 1.0.4 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/README.md +30 -7
  2. package/dist/core/src/Application.d.ts +256 -0
  3. package/dist/core/src/CommandKernel.d.ts +33 -0
  4. package/dist/core/src/ConfigManager.d.ts +65 -0
  5. package/dist/core/src/Container/RequestScopeManager.d.ts +62 -0
  6. package/dist/core/src/Container/RequestScopeMetrics.d.ts +144 -0
  7. package/dist/core/src/Container.d.ts +153 -0
  8. package/dist/core/src/ErrorHandler.d.ts +66 -0
  9. package/dist/core/src/Event.d.ts +5 -0
  10. package/dist/core/src/EventManager.d.ts +123 -0
  11. package/dist/core/src/GlobalErrorHandlers.d.ts +47 -0
  12. package/dist/core/src/GravitoServer.d.ts +28 -0
  13. package/dist/core/src/HookManager.d.ts +435 -0
  14. package/dist/core/src/Listener.d.ts +4 -0
  15. package/dist/core/src/Logger.d.ts +20 -0
  16. package/dist/core/src/PlanetCore.d.ts +408 -0
  17. package/dist/core/src/RequestContext.d.ts +97 -0
  18. package/dist/core/src/Route.d.ts +36 -0
  19. package/dist/core/src/Router.d.ts +270 -0
  20. package/dist/core/src/ServiceProvider.d.ts +178 -0
  21. package/dist/core/src/adapters/GravitoEngineAdapter.d.ts +27 -0
  22. package/dist/core/src/adapters/bun/BunContext.d.ts +54 -0
  23. package/dist/core/src/adapters/bun/BunNativeAdapter.d.ts +66 -0
  24. package/dist/core/src/adapters/bun/BunRequest.d.ts +31 -0
  25. package/dist/core/src/adapters/bun/BunWebSocketHandler.d.ts +48 -0
  26. package/dist/core/src/adapters/bun/RadixNode.d.ts +19 -0
  27. package/dist/core/src/adapters/bun/RadixRouter.d.ts +32 -0
  28. package/dist/core/src/adapters/bun/index.d.ts +7 -0
  29. package/dist/core/src/adapters/bun/types.d.ts +20 -0
  30. package/dist/core/src/adapters/types.d.ts +235 -0
  31. package/dist/core/src/binary/BinaryUtils.d.ts +105 -0
  32. package/dist/core/src/binary/index.d.ts +5 -0
  33. package/dist/core/src/cli/queue-commands.d.ts +6 -0
  34. package/dist/core/src/compat/async-local-storage.d.ts +7 -0
  35. package/dist/core/src/compat/crypto.d.ts +6 -0
  36. package/dist/core/src/engine/AOTRouter.d.ts +139 -0
  37. package/dist/core/src/engine/FastContext.d.ts +141 -0
  38. package/dist/core/src/engine/Gravito.d.ts +131 -0
  39. package/dist/core/src/engine/MinimalContext.d.ts +102 -0
  40. package/dist/core/src/engine/analyzer.d.ts +113 -0
  41. package/dist/core/src/engine/constants.d.ts +23 -0
  42. package/dist/core/src/engine/index.d.ts +26 -0
  43. package/dist/core/src/engine/path.d.ts +26 -0
  44. package/dist/core/src/engine/pool.d.ts +83 -0
  45. package/dist/core/src/engine/types.d.ts +149 -0
  46. package/dist/core/src/error-handling/RequestScopeErrorContext.d.ts +126 -0
  47. package/dist/core/src/events/BackpressureManager.d.ts +215 -0
  48. package/dist/core/src/events/CircuitBreaker.d.ts +241 -0
  49. package/dist/core/src/events/DeadLetterQueue.d.ts +219 -0
  50. package/dist/core/src/events/EventBackend.d.ts +12 -0
  51. package/dist/core/src/events/EventOptions.d.ts +204 -0
  52. package/dist/core/src/events/EventPriorityQueue.d.ts +63 -0
  53. package/dist/core/src/events/FlowControlStrategy.d.ts +109 -0
  54. package/dist/core/src/events/IdempotencyCache.d.ts +60 -0
  55. package/dist/core/src/events/MessageQueueBridge.d.ts +184 -0
  56. package/dist/core/src/events/PriorityEscalationManager.d.ts +82 -0
  57. package/dist/core/src/events/RetryScheduler.d.ts +104 -0
  58. package/dist/core/src/events/WorkerPool.d.ts +98 -0
  59. package/dist/core/src/events/WorkerPoolConfig.d.ts +153 -0
  60. package/dist/core/src/events/WorkerPoolMetrics.d.ts +65 -0
  61. package/dist/core/src/events/aggregation/AggregationWindow.d.ts +77 -0
  62. package/dist/core/src/events/aggregation/DeduplicationManager.d.ts +135 -0
  63. package/dist/core/src/events/aggregation/EventAggregationManager.d.ts +108 -0
  64. package/dist/core/src/events/aggregation/EventBatcher.d.ts +99 -0
  65. package/dist/core/src/events/aggregation/types.d.ts +117 -0
  66. package/dist/core/src/events/index.d.ts +26 -0
  67. package/dist/core/src/events/observability/EventMetrics.d.ts +132 -0
  68. package/dist/core/src/events/observability/EventTracer.d.ts +68 -0
  69. package/dist/core/src/events/observability/EventTracing.d.ts +161 -0
  70. package/dist/core/src/events/observability/OTelEventMetrics.d.ts +332 -0
  71. package/dist/core/src/events/observability/ObservableHookManager.d.ts +108 -0
  72. package/dist/core/src/events/observability/StreamWorkerMetrics.d.ts +76 -0
  73. package/dist/core/src/events/observability/index.d.ts +24 -0
  74. package/dist/core/src/events/observability/metrics-types.d.ts +16 -0
  75. package/dist/core/src/events/queue-core.d.ts +77 -0
  76. package/dist/core/src/events/task-executor.d.ts +51 -0
  77. package/dist/core/src/events/types.d.ts +134 -0
  78. package/dist/core/src/exceptions/AuthException.d.ts +10 -0
  79. package/dist/core/src/exceptions/AuthenticationException.d.ts +8 -0
  80. package/dist/core/src/exceptions/AuthorizationException.d.ts +8 -0
  81. package/dist/core/src/exceptions/CacheException.d.ts +9 -0
  82. package/dist/core/src/exceptions/CircularDependencyException.d.ts +10 -0
  83. package/dist/core/src/exceptions/ConfigurationException.d.ts +9 -0
  84. package/dist/core/src/exceptions/DatabaseException.d.ts +9 -0
  85. package/dist/core/src/exceptions/DomainException.d.ts +9 -0
  86. package/dist/core/src/exceptions/GravitoException.d.ts +23 -0
  87. package/dist/core/src/exceptions/HttpException.d.ts +9 -0
  88. package/dist/core/src/exceptions/InfrastructureException.d.ts +17 -0
  89. package/dist/core/src/exceptions/ModelNotFoundException.d.ts +10 -0
  90. package/dist/core/src/exceptions/QueueException.d.ts +9 -0
  91. package/dist/core/src/exceptions/StorageException.d.ts +9 -0
  92. package/dist/core/src/exceptions/StreamException.d.ts +9 -0
  93. package/dist/core/src/exceptions/SystemException.d.ts +9 -0
  94. package/dist/core/src/exceptions/ValidationException.d.ts +22 -0
  95. package/dist/core/src/exceptions/index.d.ts +17 -0
  96. package/dist/core/src/ffi/NativeAccelerator.d.ts +62 -0
  97. package/dist/core/src/ffi/NativeHasher.d.ts +139 -0
  98. package/dist/core/src/ffi/cbor-fallback.d.ts +96 -0
  99. package/dist/core/src/ffi/hash-fallback.d.ts +33 -0
  100. package/dist/core/src/ffi/index.d.ts +10 -0
  101. package/dist/core/src/ffi/types.d.ts +135 -0
  102. package/dist/core/src/health/HealthProvider.d.ts +67 -0
  103. package/dist/core/src/helpers/Arr.d.ts +19 -0
  104. package/dist/core/src/helpers/Str.d.ts +38 -0
  105. package/dist/core/src/helpers/data.d.ts +25 -0
  106. package/dist/core/src/helpers/errors.d.ts +34 -0
  107. package/dist/core/src/helpers/response.d.ts +41 -0
  108. package/dist/core/src/helpers.d.ts +338 -0
  109. package/dist/core/src/hooks/ActionManager.d.ts +132 -0
  110. package/dist/core/src/hooks/AsyncDetector.d.ts +84 -0
  111. package/dist/core/src/hooks/FilterManager.d.ts +71 -0
  112. package/dist/core/src/hooks/MigrationWarner.d.ts +24 -0
  113. package/dist/core/src/hooks/dlq-operations.d.ts +60 -0
  114. package/dist/core/src/hooks/types.d.ts +107 -0
  115. package/dist/core/src/http/CookieJar.d.ts +51 -0
  116. package/dist/core/src/http/cookie.d.ts +29 -0
  117. package/dist/core/src/http/types.d.ts +395 -0
  118. package/dist/core/src/index.d.ts +565 -0
  119. package/dist/core/src/observability/QueueDashboard.d.ts +136 -0
  120. package/dist/core/src/observability/contracts.d.ts +137 -0
  121. package/dist/core/src/reliability/DeadLetterQueueManager.d.ts +349 -0
  122. package/dist/core/src/reliability/RetryPolicy.d.ts +217 -0
  123. package/dist/core/src/reliability/index.d.ts +6 -0
  124. package/dist/core/src/router/ControllerDispatcher.d.ts +12 -0
  125. package/dist/core/src/router/RequestValidator.d.ts +20 -0
  126. package/dist/core/src/runtime/adapter-bun.d.ts +12 -0
  127. package/dist/core/src/runtime/adapter-deno.d.ts +12 -0
  128. package/dist/core/src/runtime/adapter-node.d.ts +12 -0
  129. package/dist/core/src/runtime/adapter-unknown.d.ts +13 -0
  130. package/dist/core/src/runtime/archive.d.ts +17 -0
  131. package/dist/core/src/runtime/compression.d.ts +21 -0
  132. package/dist/core/src/runtime/deep-equals.d.ts +56 -0
  133. package/dist/core/src/runtime/detection.d.ts +22 -0
  134. package/dist/core/src/runtime/escape.d.ts +34 -0
  135. package/dist/core/src/runtime/index.d.ts +44 -0
  136. package/dist/core/src/runtime/markdown.d.ts +44 -0
  137. package/dist/core/src/runtime/types.d.ts +436 -0
  138. package/dist/core/src/runtime-helpers.d.ts +67 -0
  139. package/dist/core/src/runtime.d.ts +11 -0
  140. package/dist/core/src/security/Encrypter.d.ts +33 -0
  141. package/dist/core/src/security/Hasher.d.ts +29 -0
  142. package/dist/core/src/testing/HttpTester.d.ts +40 -0
  143. package/dist/core/src/testing/TestResponse.d.ts +78 -0
  144. package/dist/core/src/testing/index.d.ts +2 -0
  145. package/dist/core/src/transpiler-utils.d.ts +170 -0
  146. package/dist/core/src/types/events.d.ts +94 -0
  147. package/dist/index.js +3 -294
  148. package/dist/index.js.map +3 -10
  149. package/dist/radiance/src/BroadcastManager.d.ts +124 -0
  150. package/dist/radiance/src/OrbitRadiance.d.ts +98 -0
  151. package/dist/radiance/src/channels/Channel.d.ts +86 -0
  152. package/dist/radiance/src/drivers/AblyDriver.d.ts +73 -0
  153. package/dist/radiance/src/drivers/BroadcastDriver.d.ts +50 -0
  154. package/dist/radiance/src/drivers/PusherDriver.d.ts +95 -0
  155. package/dist/radiance/src/drivers/RedisDriver.d.ts +83 -0
  156. package/dist/radiance/src/drivers/WebSocketDriver.d.ts +89 -0
  157. package/dist/radiance/src/errors/RadianceError.d.ts +29 -0
  158. package/dist/radiance/src/errors/codes.d.ts +18 -0
  159. package/dist/radiance/src/index.d.ts +42 -0
  160. package/package.json +4 -2
@@ -0,0 +1,29 @@
1
+ /**
2
+ * @fileoverview Radiance error types
3
+ *
4
+ * @module @gravito/radiance/errors
5
+ */
6
+ import { InfrastructureException, type InfrastructureExceptionOptions } from '@gravito/core';
7
+ import type { RadianceErrorCode } from './codes';
8
+ /**
9
+ * Base error class for Radiance module.
10
+ *
11
+ * Provides structured error handling with error codes and messages.
12
+ * Extends InfrastructureException for unified error handling across Gravito.
13
+ *
14
+ * @example
15
+ * ```typescript
16
+ * throw new RadianceError('radiance.broadcast_failed', 'Failed to broadcast via Pusher')
17
+ * ```
18
+ * @public
19
+ */
20
+ export declare class RadianceError extends InfrastructureException {
21
+ /**
22
+ * Creates a new RadianceError instance.
23
+ *
24
+ * @param code - The error code.
25
+ * @param message - The error message.
26
+ * @param options - Optional infrastructure exception options.
27
+ */
28
+ constructor(code: RadianceErrorCode, message: string, options?: InfrastructureExceptionOptions);
29
+ }
@@ -0,0 +1,18 @@
1
+ /**
2
+ * @fileoverview Radiance error codes
3
+ *
4
+ * Namespaced error codes for the Radiance broadcasting module.
5
+ *
6
+ * @module @gravito/radiance/errors
7
+ */
8
+ /**
9
+ * Error codes for Radiance module operations.
10
+ * Follows dot-separated namespace convention.
11
+ */
12
+ export declare const RadianceErrorCodes: {
13
+ readonly BROADCAST_FAILED: "radiance.broadcast_failed";
14
+ readonly UNSUPPORTED_DRIVER: "radiance.unsupported_driver";
15
+ readonly CONNECTION_ERROR: "radiance.connection_error";
16
+ readonly INVALID_CONFIG: "radiance.invalid_config";
17
+ };
18
+ export type RadianceErrorCode = (typeof RadianceErrorCodes)[keyof typeof RadianceErrorCodes];
@@ -0,0 +1,42 @@
1
+ /**
2
+ * @gravito/radiance
3
+ *
4
+ * A lightweight, high-performance broadcasting library for the Gravito framework.
5
+ * It provides a unified API for broadcasting events across different drivers
6
+ * (Pusher, Ably, Redis, WebSocket) with zero runtime overhead for unused drivers.
7
+ *
8
+ * @module
9
+ * @example
10
+ * ```typescript
11
+ * // Quick setup with PlanetCore
12
+ * import { PlanetCore } from '@gravito/core';
13
+ * import { OrbitRadiance } from '@gravito/radiance';
14
+ *
15
+ * const core = await PlanetCore.boot({
16
+ * orbits: [
17
+ * OrbitRadiance.configure({
18
+ * driver: 'redis',
19
+ * config: { url: 'redis://localhost:6379' }
20
+ * })
21
+ * ]
22
+ * });
23
+ * ```
24
+ */
25
+ export type { ChannelAuthorizationCallback } from './BroadcastManager';
26
+ export { BroadcastManager } from './BroadcastManager';
27
+ export { RadianceError } from './errors/RadianceError';
28
+ export { RadianceErrorCodes } from './errors/codes';
29
+ export type { RadianceErrorCode } from './errors/codes';
30
+ export type { Channel } from './channels/Channel';
31
+ export { PresenceChannel, PrivateChannel, PublicChannel, } from './channels/Channel';
32
+ export type { AblyDriverConfig } from './drivers/AblyDriver';
33
+ export { AblyDriver } from './drivers/AblyDriver';
34
+ export type { BroadcastDriver } from './drivers/BroadcastDriver';
35
+ export type { PusherDriverConfig } from './drivers/PusherDriver';
36
+ export { PusherDriver } from './drivers/PusherDriver';
37
+ export type { RedisDriverConfig } from './drivers/RedisDriver';
38
+ export { RedisDriver } from './drivers/RedisDriver';
39
+ export type { WebSocketDriverConfig } from './drivers/WebSocketDriver';
40
+ export { WebSocketDriver } from './drivers/WebSocketDriver';
41
+ export type { OrbitRadianceOptions } from './OrbitRadiance';
42
+ export { OrbitRadiance } from './OrbitRadiance';
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "@gravito/radiance",
3
- "version": "1.0.4",
3
+ "sideEffects": false,
4
+ "version": "2.0.0",
4
5
  "publishConfig": {
5
6
  "access": "public"
6
7
  },
@@ -23,6 +24,7 @@
23
24
  ],
24
25
  "scripts": {
25
26
  "build": "bun run build.ts",
27
+ "build:dts": "bun run build.ts --dts-only",
26
28
  "test": "bun test --timeout=10000",
27
29
  "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
28
30
  "test:coverage": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
@@ -43,7 +45,7 @@
43
45
  "author": "Carl Lee <carllee0520@gmail.com>",
44
46
  "license": "MIT",
45
47
  "dependencies": {
46
- "@gravito/core": "^1.6.1"
48
+ "@gravito/core": "^2.0.6"
47
49
  },
48
50
  "devDependencies": {
49
51
  "bun-types": "latest",