@guren/server 2.15.0 → 2.16.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.
- package/dist/{DocsViewerServiceProvider-qFCaeiUv.js → DocsViewerServiceProvider-D2cuVgtN.js} +7 -12
- package/dist/{Hash-C8aejmi8.js → Hash-D2DFd8xX.js} +7 -57
- package/dist/{HttpException-BkS3euNG.js → HttpException-BlQ2yEmT.js} +2 -79
- package/dist/{Job-BVT813DO.js → Job-DxQK8h3P.js} +24 -179
- package/dist/{McpServiceProvider-BawsYjgN.js → McpServiceProvider-nNcbCIQX.js} +11 -20
- package/dist/{Random-DbIJ22KQ.js → Random-S0OvCuR8.js} +9 -106
- package/dist/agent/AgentApprovalRequested.d.ts +11 -39
- package/dist/agent/approval.d.ts +76 -187
- package/dist/agent/audit-emitter.d.ts +16 -44
- package/dist/agent/audit.d.ts +20 -56
- package/dist/agent/derive.d.ts +32 -66
- package/dist/agent/dispatch.d.ts +38 -90
- package/dist/agent/events.d.ts +11 -19
- package/dist/agent/meta-tools.d.ts +18 -46
- package/dist/agent/public.d.ts +6 -25
- package/dist/agent/public.js +1 -1
- package/dist/agent/redact.d.ts +16 -38
- package/dist/agent/scopes.d.ts +23 -69
- package/dist/auth/AuthManager.d.ts +19 -40
- package/dist/auth/AuthenticatableModel.d.ts +2 -2
- package/dist/auth/SessionGuard.d.ts +0 -1
- package/dist/auth/TokenGuard.d.ts +6 -26
- package/dist/auth/api-token.d.ts +16 -148
- package/dist/auth/context.d.ts +5 -10
- package/dist/auth/email-verification.d.ts +29 -127
- package/dist/auth/index.js +1 -1
- package/dist/auth/oauth/index.d.ts +35 -57
- package/dist/auth/password/DefaultHasher.d.ts +5 -14
- package/dist/auth/password/PasswordHasher.d.ts +5 -13
- package/dist/auth/password/hash-format.d.ts +5 -13
- package/dist/auth/password-reset.d.ts +16 -42
- package/dist/auth/providers/ModelUserProvider.d.ts +3 -4
- package/dist/auth/providers/UserProvider.d.ts +4 -4
- package/dist/auth/signed-token.d.ts +18 -0
- package/dist/auth/types.d.ts +9 -32
- package/dist/auth/utils.d.ts +6 -27
- package/dist/{auth-DkYoAPVn.js → auth-CbdPH4Cd.js} +169 -502
- package/dist/authorization/Gate.d.ts +9 -145
- package/dist/authorization/Policy.d.ts +6 -53
- package/dist/authorization/index.js +1 -1
- package/dist/authorization/middleware.d.ts +16 -62
- package/dist/authorization/types.d.ts +8 -64
- package/dist/{authorization-CdfbCj8J.js → authorization-CdEWZZw3.js} +44 -309
- package/dist/broadcasting/BroadcastManager.d.ts +29 -149
- package/dist/broadcasting/channels/Channel.d.ts +1 -19
- package/dist/broadcasting/channels/PresenceChannel.d.ts +1 -55
- package/dist/broadcasting/channels/PrivateChannel.d.ts +1 -23
- package/dist/broadcasting/drivers/MemoryDriver.d.ts +18 -70
- package/dist/broadcasting/drivers/RedisDriver.d.ts +3 -80
- package/dist/broadcasting/drivers/index.d.ts +1 -1
- package/dist/broadcasting/index.d.ts +1 -1
- package/dist/broadcasting/index.js +1 -1
- package/dist/broadcasting/types.d.ts +7 -88
- package/dist/{broadcasting-BwodCA4q.js → broadcasting-B5RzB0A2.js} +87 -414
- package/dist/cache/CacheManager.d.ts +8 -62
- package/dist/cache/TaggedCache.d.ts +2 -35
- package/dist/cache/index.js +1 -1
- package/dist/cache/stores/FileStore.d.ts +2 -36
- package/dist/cache/stores/MemoryStore.d.ts +2 -26
- package/dist/cache/stores/RedisStore.d.ts +1 -29
- package/dist/cache/types.d.ts +21 -128
- package/dist/{cache-BYnZf2FR.js → cache-BOOIr324.js} +19 -198
- package/dist/client-C4TEr_Dd.js +9 -0
- package/dist/console/Command.d.ts +17 -126
- package/dist/console/ConsoleKernel.d.ts +2 -74
- package/dist/console/Input.d.ts +5 -113
- package/dist/console/Output.d.ts +3 -99
- package/dist/console/types.d.ts +3 -33
- package/dist/container/Container.d.ts +12 -103
- package/dist/container/ServiceProvider.d.ts +17 -61
- package/dist/container/bindings.d.ts +5 -26
- package/dist/container/defineModule.d.ts +16 -54
- package/dist/container/definePlugin.d.ts +12 -45
- package/dist/container/types.d.ts +2 -34
- package/dist/context-CXk_umpT.js +21 -0
- package/dist/database/Factory.d.ts +4 -57
- package/dist/database/Seeder.d.ts +8 -46
- package/dist/database/SeederRunner.d.ts +3 -33
- package/dist/database/types.d.ts +3 -24
- package/dist/discovery/AutoDiscovery.d.ts +10 -82
- package/dist/{dispatch-erOS9epZ.js → dispatch-BAwzftws.js} +32 -79
- package/dist/docs-viewer/DocsViewerServiceProvider.d.ts +2 -5
- package/dist/docs-viewer/endpoint.d.ts +5 -11
- package/dist/encryption/Encrypter.d.ts +5 -71
- package/dist/encryption/Hash.d.ts +7 -57
- package/dist/encryption/Random.d.ts +6 -99
- package/dist/encryption/index.js +3 -3
- package/dist/encryption/types.d.ts +10 -72
- package/dist/{encryption-D99Vmls3.js → encryption-uwP3Di4D.js} +9 -78
- package/dist/{endpoint-D6GIqOpe.js → endpoint-BXipU2Jj.js} +6 -12
- package/dist/endpoint-Dsw3Acvq.js +26 -0
- package/dist/errors/ExceptionHandler.d.ts +3 -90
- package/dist/errors/HttpException.d.ts +2 -79
- package/dist/errors/debug-page.d.ts +3 -17
- package/dist/errors/error-page.d.ts +1 -0
- package/dist/errors/exceptions/AuthenticationException.d.ts +2 -24
- package/dist/errors/exceptions/AuthorizationException.d.ts +1 -24
- package/dist/errors/exceptions/MethodNotAllowedException.d.ts +1 -23
- package/dist/errors/exceptions/NotFoundHttpException.d.ts +1 -27
- package/dist/errors/exceptions/ValidationException.d.ts +2 -43
- package/dist/errors/types.d.ts +1 -25
- package/dist/{errors-BgeOl_DC.js → errors-JpkcCjjn.js} +3 -41
- package/dist/events/Event.d.ts +1 -28
- package/dist/events/EventManager.d.ts +5 -107
- package/dist/events/Listener.d.ts +7 -55
- package/dist/events/builtin.d.ts +0 -24
- package/dist/events/index.js +1 -1
- package/dist/events/types.d.ts +4 -22
- package/dist/{events-aIH_bWRx.js → events-DOmAHDeP.js} +11 -191
- package/dist/facades/index.d.ts +2 -14
- package/dist/health/HealthCheck.d.ts +0 -24
- package/dist/health/HealthManager.d.ts +0 -36
- package/dist/health/checks/CacheCheck.d.ts +2 -17
- package/dist/health/checks/CustomCheck.d.ts +0 -9
- package/dist/health/checks/DatabaseCheck.d.ts +2 -17
- package/dist/health/checks/MemoryCheck.d.ts +3 -12
- package/dist/health/checks/RedisCheck.d.ts +1 -13
- package/dist/health/checks/StorageCheck.d.ts +2 -17
- package/dist/health/index.js +1 -1
- package/dist/health/types.d.ts +4 -24
- package/dist/{health-VWdWXRwh.js → health-DQSvUplL.js} +1 -76
- package/dist/hot-disposables-B5BXqaIH.js +167 -0
- package/dist/hot-reload/hot-disposables.d.ts +22 -74
- package/dist/hot-reload/testing.d.ts +4 -9
- package/dist/http/Application.d.ts +62 -208
- package/dist/http/FormRequest.d.ts +4 -55
- package/dist/http/dev-assets.d.ts +13 -31
- package/dist/http/dev-banner.d.ts +2 -5
- package/dist/http/inertia-assets.d.ts +3 -6
- package/dist/http/middleware/capabilities.d.ts +27 -50
- package/dist/http/middleware/cors.d.ts +4 -29
- package/dist/http/middleware/csp.d.ts +2 -25
- package/dist/http/middleware/csrf.d.ts +20 -95
- package/dist/http/middleware/detect-locale.d.ts +7 -27
- package/dist/http/middleware/force-https.d.ts +6 -24
- package/dist/http/middleware/host-authorization.d.ts +2 -12
- package/dist/http/middleware/loopback-guard.d.ts +15 -33
- package/dist/http/middleware/rate-limit.d.ts +29 -126
- package/dist/http/middleware/redirect-safety.d.ts +2 -20
- package/dist/http/middleware/request-id.d.ts +1 -14
- package/dist/http/middleware/request-logging.d.ts +2 -13
- package/dist/http/middleware/response-headers.d.ts +5 -13
- package/dist/http/middleware/security-headers.d.ts +2 -16
- package/dist/http/middleware/session.d.ts +15 -34
- package/dist/http/middleware/validation-errors-cookie.d.ts +7 -18
- package/dist/http/middleware/validation.d.ts +8 -63
- package/dist/http/public-assets.d.ts +11 -7
- package/dist/http/request.d.ts +32 -118
- package/dist/http/resources/CursorPaginator.d.ts +5 -64
- package/dist/http/resources/Paginator.d.ts +7 -84
- package/dist/http/resources/Resource.d.ts +9 -65
- package/dist/http/resources/ResourceCollection.d.ts +5 -39
- package/dist/http/resources/types.d.ts +10 -30
- package/dist/http/static-documents.d.ts +10 -20
- package/dist/http/validation/Validator.d.ts +25 -85
- package/dist/http/validation/rules.d.ts +48 -147
- package/dist/http/validation/types.d.ts +16 -61
- package/dist/http/vite-assets.d.ts +5 -28
- package/dist/http/vite-dev-server.d.ts +6 -9
- package/dist/http/vite-manifest.d.ts +19 -33
- package/dist/i18n/I18nManager.d.ts +12 -78
- package/dist/i18n/Translator.d.ts +3 -54
- package/dist/i18n/index.js +1 -1
- package/dist/i18n/loaders/JsonLoader.d.ts +4 -31
- package/dist/i18n/loaders/MemoryLoader.d.ts +1 -21
- package/dist/i18n/pluralization.d.ts +4 -13
- package/dist/i18n/types.d.ts +17 -69
- package/dist/{i18n-mcWi7LCd.js → i18n-Cg1aajRP.js} +31 -225
- package/dist/index.d.ts +2 -1
- package/dist/index.js +714 -3011
- package/dist/internal/agent-preflight.d.ts +9 -21
- package/dist/internal/request.d.ts +6 -19
- package/dist/internal/request.js +1 -1
- package/dist/internal/route-path.d.ts +9 -21
- package/dist/internal/route-path.js +9 -21
- package/dist/internal/zod-compat.d.ts +55 -122
- package/dist/internal/zod-compat.js +39 -70
- package/dist/internal/zod-json-schema.d.ts +18 -54
- package/dist/internal/zod-json-schema.js +46 -123
- package/dist/jsx-runtime.d.ts +3 -8
- package/dist/lambda/index.d.ts +17 -79
- package/dist/lambda/index.js +11 -59
- package/dist/logging/LogManager.d.ts +1 -51
- package/dist/logging/Logger.d.ts +8 -47
- package/dist/logging/channels/ConsoleChannel.d.ts +1 -3
- package/dist/logging/channels/DailyFileChannel.d.ts +1 -3
- package/dist/logging/channels/FileChannel.d.ts +1 -3
- package/dist/logging/daily-file-path.d.ts +7 -16
- package/dist/logging/index.js +1 -1
- package/dist/logging/types.d.ts +13 -45
- package/dist/{logging-B-kngi3q.js → logging-zOY1XCtq.js} +52 -141
- package/dist/{loopback-guard-D0Kc7-xc.js → loopback-guard-DT9gHF0F.js} +41 -92
- package/dist/mail/Mail.d.ts +10 -106
- package/dist/mail/MailManager.d.ts +2 -60
- package/dist/mail/index.js +1 -1
- package/dist/mail/transports/LogTransport.d.ts +1 -4
- package/dist/mail/transports/MemoryTransport.d.ts +1 -63
- package/dist/mail/transports/ResendTransport.d.ts +1 -23
- package/dist/mail/transports/SmtpTransport.d.ts +1 -31
- package/dist/mail/types.d.ts +28 -150
- package/dist/{mail-DfEfSQEr.js → mail-76DWy9lj.js} +31 -289
- package/dist/mcp/McpServiceProvider.d.ts +4 -10
- package/dist/mcp/create-mcp-server.d.ts +25 -57
- package/dist/mcp/endpoint.d.ts +12 -36
- package/dist/mcp/index.js +1 -1
- package/dist/mvc/Controller.d.ts +46 -227
- package/dist/mvc/Router.d.ts +50 -129
- package/dist/mvc/inertia/InertiaEngine.d.ts +18 -48
- package/dist/mvc/inertia/shared.d.ts +6 -19
- package/dist/mvc/mount-route.d.ts +2 -6
- package/dist/mvc/view.d.ts +1 -2
- package/dist/notifications/Notification.d.ts +8 -75
- package/dist/notifications/NotificationManager.d.ts +15 -88
- package/dist/notifications/channels/DatabaseChannel.d.ts +1 -41
- package/dist/notifications/channels/MailChannel.d.ts +2 -31
- package/dist/notifications/channels/MemoryChannel.d.ts +2 -62
- package/dist/notifications/channels/SlackChannel.d.ts +3 -48
- package/dist/notifications/index.js +1 -1
- package/dist/notifications/notifiable-type.d.ts +3 -6
- package/dist/notifications/registry.d.ts +8 -27
- package/dist/notifications/types.d.ts +16 -53
- package/dist/{notifications-BGqmUNZ8.js → notifications-okWFs9ly.js} +37 -335
- package/dist/providers/AuthServiceProvider.d.ts +1 -3
- package/dist/providers/AuthorizationServiceProvider.d.ts +2 -3
- package/dist/providers/BroadcastServiceProvider.d.ts +1 -3
- package/dist/providers/CacheServiceProvider.d.ts +1 -3
- package/dist/providers/EncryptionServiceProvider.d.ts +1 -3
- package/dist/providers/ErrorServiceProvider.d.ts +1 -4
- package/dist/providers/EventServiceProvider.d.ts +1 -3
- package/dist/providers/HealthServiceProvider.d.ts +1 -3
- package/dist/providers/I18nServiceProvider.d.ts +6 -10
- package/dist/providers/InertiaServiceProvider.d.ts +1 -4
- package/dist/providers/LogServiceProvider.d.ts +1 -3
- package/dist/providers/MailServiceProvider.d.ts +1 -3
- package/dist/providers/NotificationServiceProvider.d.ts +1 -3
- package/dist/providers/OAuthServiceProvider.d.ts +1 -3
- package/dist/providers/QueueServiceProvider.d.ts +1 -3
- package/dist/providers/SchedulingServiceProvider.d.ts +1 -3
- package/dist/providers/StorageServiceProvider.d.ts +1 -3
- package/dist/queue/FailedJobReporter.d.ts +1 -24
- package/dist/queue/Job.d.ts +12 -99
- package/dist/queue/QueueManager.d.ts +6 -57
- package/dist/queue/Worker.d.ts +4 -65
- package/dist/queue/drivers/MemoryDriver.d.ts +3 -44
- package/dist/queue/drivers/RedisDriver.d.ts +7 -65
- package/dist/queue/drivers/SqsDriver.d.ts +6 -57
- package/dist/queue/drivers/SyncDriver.d.ts +10 -13
- package/dist/queue/index.js +2 -2
- package/dist/queue/types.d.ts +10 -92
- package/dist/{queue-CXrRK85G.js → queue-CcXCjuJI.js} +32 -260
- package/dist/redis/RedisApiTokenStore.d.ts +4 -56
- package/dist/redis/RedisEmailVerificationStore.d.ts +4 -37
- package/dist/redis/RedisOAuthStateStore.d.ts +2 -10
- package/dist/redis/RedisPasswordResetStore.d.ts +4 -37
- package/dist/redis/RedisRateLimitStore.d.ts +16 -49
- package/dist/redis/RedisSessionStore.d.ts +3 -44
- package/dist/redis/client.d.ts +2 -32
- package/dist/redis/index.js +47 -232
- package/dist/redis/redis-values.d.ts +6 -12
- package/dist/redis/scan-keys.d.ts +1 -4
- package/dist/request-CLOYytGP.js +68 -0
- package/dist/runtime/index.d.ts +2 -0
- package/dist/runtime/index.js +50 -92
- package/dist/scheduling/CronParser.d.ts +0 -29
- package/dist/scheduling/Schedule.d.ts +1 -153
- package/dist/scheduling/ScheduledTask.d.ts +0 -31
- package/dist/scheduling/Scheduler.d.ts +0 -70
- package/dist/scheduling/index.js +1 -1
- package/dist/scheduling/types.d.ts +4 -65
- package/dist/{scheduling-CPiEdtQd.js → scheduling-C6tcOtUl.js} +2 -287
- package/dist/storage/StorageManager.d.ts +0 -48
- package/dist/storage/drivers/LocalDriver.d.ts +1 -25
- package/dist/storage/drivers/MemoryDriver.d.ts +5 -35
- package/dist/storage/drivers/S3Driver.d.ts +6 -36
- package/dist/storage/drivers/s3-acl.d.ts +5 -10
- package/dist/storage/index.js +1 -1
- package/dist/storage/types.d.ts +27 -265
- package/dist/{storage-TLD9t0Q2.js → storage-BB59f07j.js} +17 -157
- package/dist/support/contained-path.d.ts +10 -20
- package/dist/support/error-polyfill.d.ts +4 -6
- package/dist/support/expiry.d.ts +17 -33
- package/dist/support/expiry.js +17 -33
- package/dist/support/import-map.d.ts +3 -7
- package/dist/support/inertia-defaults.d.ts +5 -10
- package/dist/support/redirect-target.d.ts +4 -6
- package/dist/support/stack-frames.d.ts +11 -50
- package/dist/support/trim-slashes.d.ts +4 -7
- package/dist/support/warn-once.d.ts +2 -6
- package/dist/{trim-slashes-ZJ_VsY5s.js → trim-slashes-BLY9hKAa.js} +4 -7
- package/dist/{vite-manifest-w_RSOvQW.js → vite-manifest-CTQp-SOo.js} +34 -58
- package/package.json +2 -2
- package/dist/client-Dd7vLcqp.js +0 -27
- package/dist/context-DoD0c7J_.js +0 -26
- package/dist/endpoint-D-20PiHY.js +0 -46
- package/dist/hot-disposables-WsTX2ySN.js +0 -281
- package/dist/request-CVQwpu2J.js +0 -129
|
@@ -1,26 +1,6 @@
|
|
|
1
1
|
import type { LogConfig, LogChannelFactory } from './types.js';
|
|
2
2
|
import { Logger } from './Logger.js';
|
|
3
|
-
/**
|
|
4
|
-
* Log manager for managing multiple logging channels.
|
|
5
|
-
*
|
|
6
|
-
* @example
|
|
7
|
-
* ```ts
|
|
8
|
-
* const log = new LogManager({
|
|
9
|
-
* default: 'stack',
|
|
10
|
-
* channels: {
|
|
11
|
-
* console: { driver: 'console', level: 'debug' },
|
|
12
|
-
* file: { driver: 'daily', path: './storage/logs/app.log', days: 14 },
|
|
13
|
-
* stack: { driver: 'stack', channels: ['console', 'file'] },
|
|
14
|
-
* }
|
|
15
|
-
* })
|
|
16
|
-
*
|
|
17
|
-
* log.info('User logged in', { userId: user.id })
|
|
18
|
-
* log.error('Payment failed', { orderId, error: error.message })
|
|
19
|
-
*
|
|
20
|
-
* const requestLog = log.withContext({ requestId: ctx.requestId })
|
|
21
|
-
* requestLog.info('Processing request')
|
|
22
|
-
* ```
|
|
23
|
-
*/
|
|
3
|
+
/** Log manager for managing multiple logging channels. */
|
|
24
4
|
export declare class LogManager {
|
|
25
5
|
private readonly config;
|
|
26
6
|
private readonly channelFactories;
|
|
@@ -30,22 +10,10 @@ export declare class LogManager {
|
|
|
30
10
|
constructor(config: LogConfig);
|
|
31
11
|
private registerDefaultDrivers;
|
|
32
12
|
private createStackChannel;
|
|
33
|
-
/**
|
|
34
|
-
* Register a custom channel driver.
|
|
35
|
-
*/
|
|
36
13
|
registerDriver(name: string, factory: LogChannelFactory): void;
|
|
37
|
-
/**
|
|
38
|
-
* Get a logger for a specific channel.
|
|
39
|
-
*/
|
|
40
14
|
channel(name?: string): Logger;
|
|
41
|
-
/**
|
|
42
|
-
* Get a logger that writes to multiple channels.
|
|
43
|
-
*/
|
|
44
15
|
stack(channelNames: string[]): Logger;
|
|
45
16
|
private resolveChannel;
|
|
46
|
-
/**
|
|
47
|
-
* Create a logger with additional context using the default channel.
|
|
48
|
-
*/
|
|
49
17
|
withContext(context: Record<string, unknown>): Logger;
|
|
50
18
|
emergency(message: string, context?: Record<string, unknown>): void;
|
|
51
19
|
alert(message: string, context?: Record<string, unknown>): void;
|
|
@@ -56,28 +24,10 @@ export declare class LogManager {
|
|
|
56
24
|
notice(message: string, context?: Record<string, unknown>): void;
|
|
57
25
|
info(message: string, context?: Record<string, unknown>): void;
|
|
58
26
|
debug(message: string, context?: Record<string, unknown>): void;
|
|
59
|
-
/**
|
|
60
|
-
* Close all channel instances.
|
|
61
|
-
*/
|
|
62
27
|
close(): Promise<void>;
|
|
63
|
-
/**
|
|
64
|
-
* Get the default channel name.
|
|
65
|
-
*/
|
|
66
28
|
getDefaultChannel(): string;
|
|
67
|
-
/**
|
|
68
|
-
* Get available channel names.
|
|
69
|
-
*/
|
|
70
29
|
getChannelNames(): string[];
|
|
71
30
|
}
|
|
72
|
-
/**
|
|
73
|
-
* Create a log manager instance.
|
|
74
|
-
*/
|
|
75
31
|
export declare function createLogManager(config: LogConfig): LogManager;
|
|
76
|
-
/**
|
|
77
|
-
* Set the global log manager instance.
|
|
78
|
-
*/
|
|
79
32
|
export declare function setLogManager(manager: LogManager): void;
|
|
80
|
-
/**
|
|
81
|
-
* Get the global log manager instance.
|
|
82
|
-
*/
|
|
83
33
|
export declare function getLogManager(): LogManager;
|
package/dist/logging/Logger.d.ts
CHANGED
|
@@ -1,76 +1,37 @@
|
|
|
1
1
|
import type { LogChannel, LogLevel, LogContext } from './types.js';
|
|
2
2
|
export interface LoggerOptions {
|
|
3
|
-
/**
|
|
4
|
-
* Keys whose values should be replaced with the replacement string.
|
|
5
|
-
* Matching is case-insensitive and recursive.
|
|
6
|
-
*/
|
|
3
|
+
/** Keys to redact. Matching is case-insensitive and recursive. */
|
|
7
4
|
filterKeys?: string[];
|
|
8
5
|
/** Replacement string for filtered values. Default: '[FILTERED]' */
|
|
9
6
|
replacement?: string;
|
|
10
7
|
}
|
|
11
|
-
/**
|
|
12
|
-
* Recursively replace values of sensitive keys in a log context object.
|
|
13
|
-
*/
|
|
8
|
+
/** Recursively replace values of sensitive keys in a log context object. */
|
|
14
9
|
export declare function filterSensitiveData(data: Record<string, unknown>, filterKeys: string[], replacement?: string): Record<string, unknown>;
|
|
15
10
|
/**
|
|
16
|
-
*
|
|
11
|
+
* Whether a channel's `log()` handed back something to wait on. A duck-typed
|
|
12
|
+
* check rather than `instanceof Promise`: a promise created in another realm
|
|
13
|
+
* (a `node:vm` context, a worker's module graph) satisfies the channel
|
|
14
|
+
* contract and would otherwise slip past the reporter as an unhandled rejection.
|
|
17
15
|
*/
|
|
16
|
+
export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
|
|
17
|
+
/** Logger instance for writing log entries. */
|
|
18
18
|
export declare class Logger {
|
|
19
19
|
private readonly channels;
|
|
20
20
|
private readonly baseContext;
|
|
21
21
|
private readonly filterKeys;
|
|
22
22
|
private readonly replacement;
|
|
23
23
|
constructor(channels: LogChannel[], context?: LogContext, options?: LoggerOptions);
|
|
24
|
-
/**
|
|
25
|
-
* Log at emergency level (system is unusable).
|
|
26
|
-
*/
|
|
27
24
|
emergency(message: string, context?: LogContext): void;
|
|
28
|
-
/**
|
|
29
|
-
* Log at alert level (action must be taken immediately).
|
|
30
|
-
*/
|
|
31
25
|
alert(message: string, context?: LogContext): void;
|
|
32
|
-
/**
|
|
33
|
-
* Log at critical level (critical conditions).
|
|
34
|
-
*/
|
|
35
26
|
critical(message: string, context?: LogContext): void;
|
|
36
|
-
/**
|
|
37
|
-
* Log at error level (error conditions).
|
|
38
|
-
*/
|
|
39
27
|
error(message: string, context?: LogContext): void;
|
|
40
|
-
/**
|
|
41
|
-
* Log at warning level (warning conditions).
|
|
42
|
-
*/
|
|
43
28
|
warning(message: string, context?: LogContext): void;
|
|
44
|
-
/**
|
|
45
|
-
* Alias for warning().
|
|
46
|
-
*/
|
|
47
29
|
warn(message: string, context?: LogContext): void;
|
|
48
|
-
/**
|
|
49
|
-
* Log at notice level (normal but significant conditions).
|
|
50
|
-
*/
|
|
51
30
|
notice(message: string, context?: LogContext): void;
|
|
52
|
-
/**
|
|
53
|
-
* Log at info level (informational messages).
|
|
54
|
-
*/
|
|
55
31
|
info(message: string, context?: LogContext): void;
|
|
56
|
-
/**
|
|
57
|
-
* Log at debug level (debug-level messages).
|
|
58
|
-
*/
|
|
59
32
|
debug(message: string, context?: LogContext): void;
|
|
60
|
-
/**
|
|
61
|
-
* Log a message at the specified level.
|
|
62
|
-
*/
|
|
63
33
|
log(level: LogLevel, message: string, context?: LogContext): void;
|
|
64
|
-
/**
|
|
65
|
-
* Create a new logger with additional context.
|
|
66
|
-
*/
|
|
67
34
|
withContext(context: LogContext): Logger;
|
|
68
|
-
/**
|
|
69
|
-
* Create a child logger with additional context (alias for withContext).
|
|
70
|
-
*/
|
|
71
35
|
child(context: LogContext): Logger;
|
|
72
|
-
/**
|
|
73
|
-
* Close all channels.
|
|
74
|
-
*/
|
|
75
36
|
close(): Promise<void>;
|
|
76
37
|
}
|
|
@@ -1,7 +1,5 @@
|
|
|
1
1
|
import type { LogChannel, LogEntry, DailyFileChannelConfig } from '../types.js';
|
|
2
|
-
/**
|
|
3
|
-
* Daily rotating file log channel.
|
|
4
|
-
*/
|
|
2
|
+
/** Daily rotating file log channel. */
|
|
5
3
|
export declare class DailyFileChannel implements LogChannel {
|
|
6
4
|
private readonly config;
|
|
7
5
|
private readonly minLevel;
|
|
@@ -1,24 +1,15 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The `YYYY-MM-DD` stamp a file rotated at `date` carries.
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* instant for every process appending to the same directory — a fleet split
|
|
6
|
-
* across time zones would otherwise write two different files for one day and
|
|
7
|
-
* roll over at as many moments as it has zones.
|
|
2
|
+
* The `YYYY-MM-DD` stamp a file rotated at `date` carries. UTC, because the
|
|
3
|
+
* rotation boundary must be the same instant for every process appending to one
|
|
4
|
+
* directory — a fleet across time zones would write two files for one day.
|
|
8
5
|
*/
|
|
9
6
|
export declare function dailyFileDateStamp(date: Date): string;
|
|
10
7
|
/** The dated file a base path rotates to on `date`. */
|
|
11
8
|
export declare function dailyFilePath(basePath: string, date: Date): string;
|
|
12
9
|
/**
|
|
13
|
-
* The date stamp of `fileName` if it is one of `basePath`'s dated files,
|
|
14
|
-
* `null`
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
* directory does not need to know the shape it is matching. The base path's
|
|
18
|
-
* own name and extension are escaped before they enter the pattern: a log
|
|
19
|
-
* called `app.v1.log` parses to the name `app.v1`, whose dots would otherwise
|
|
20
|
-
* match any character and let a *different* app's files into another's
|
|
21
|
-
* rotation set — which, for the cleanup that consumes this, means deleting
|
|
22
|
-
* them.
|
|
10
|
+
* The date stamp of `fileName` if it is one of `basePath`'s dated files, else
|
|
11
|
+
* `null` — the inverse of {@link dailyFilePath}. The base name and extension
|
|
12
|
+
* are escaped first: `app.v1.log` would otherwise match another app's files
|
|
13
|
+
* into this rotation set, which for the cleanup consuming it means deleting them.
|
|
23
14
|
*/
|
|
24
15
|
export declare function matchDailyFileDate(basePath: string, fileName: string): string | null;
|
package/dist/logging/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as DailyFileChannel, c as matchDailyFileDate, d as Logger, f as filterSensitiveData, i as setLogManager, l as FileChannel, n as createLogManager, o as dailyFileDateStamp, p as LOG_LEVEL_PRIORITY, r as getLogManager, s as dailyFilePath, t as LogManager, u as ConsoleChannel } from "../logging-
|
|
1
|
+
import { a as DailyFileChannel, c as matchDailyFileDate, d as Logger, f as filterSensitiveData, i as setLogManager, l as FileChannel, n as createLogManager, o as dailyFileDateStamp, p as LOG_LEVEL_PRIORITY, r as getLogManager, s as dailyFilePath, t as LogManager, u as ConsoleChannel } from "../logging-zOY1XCtq.js";
|
|
2
2
|
export { ConsoleChannel, DailyFileChannel, FileChannel, LOG_LEVEL_PRIORITY, LogManager, Logger, createLogManager, dailyFileDateStamp, dailyFilePath, filterSensitiveData, getLogManager, matchDailyFileDate, setLogManager };
|
package/dist/logging/types.d.ts
CHANGED
|
@@ -1,85 +1,55 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Log level types (RFC 5424 severity levels).
|
|
3
|
-
*/
|
|
1
|
+
/** Log level types (RFC 5424 severity levels). */
|
|
4
2
|
export type LogLevel = 'emergency' | 'alert' | 'critical' | 'error' | 'warning' | 'notice' | 'info' | 'debug';
|
|
5
|
-
/**
|
|
6
|
-
* Log level priority (lower = more severe).
|
|
7
|
-
*/
|
|
3
|
+
/** Log level priority (lower = more severe). */
|
|
8
4
|
export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
|
|
9
|
-
/**
|
|
10
|
-
* Log context (additional data attached to log entries).
|
|
11
|
-
*/
|
|
5
|
+
/** Log context (additional data attached to log entries). */
|
|
12
6
|
export type LogContext = Record<string, unknown>;
|
|
13
|
-
/**
|
|
14
|
-
* Log entry structure.
|
|
15
|
-
*/
|
|
7
|
+
/** Log entry structure. */
|
|
16
8
|
export interface LogEntry {
|
|
17
9
|
level: LogLevel;
|
|
18
10
|
message: string;
|
|
19
11
|
context: LogContext;
|
|
20
12
|
timestamp: Date;
|
|
21
13
|
}
|
|
22
|
-
/**
|
|
23
|
-
* Log channel interface.
|
|
24
|
-
*/
|
|
14
|
+
/** Log channel interface. */
|
|
25
15
|
export interface LogChannel {
|
|
26
|
-
/**
|
|
27
|
-
* Write a log entry.
|
|
28
|
-
*/
|
|
29
16
|
log(entry: LogEntry): void | Promise<void>;
|
|
30
|
-
/**
|
|
31
|
-
* Close the channel (cleanup resources).
|
|
32
|
-
*/
|
|
33
17
|
close?(): void | Promise<void>;
|
|
34
18
|
}
|
|
35
|
-
/**
|
|
36
|
-
* Log channel factory.
|
|
37
|
-
*/
|
|
19
|
+
/** Log channel factory. */
|
|
38
20
|
export type LogChannelFactory = (config: LogChannelConfig) => LogChannel;
|
|
39
|
-
/**
|
|
40
|
-
* Base channel configuration.
|
|
41
|
-
*/
|
|
21
|
+
/** Base channel configuration. */
|
|
42
22
|
export interface LogChannelConfig {
|
|
43
23
|
driver: string;
|
|
44
24
|
level?: LogLevel;
|
|
45
25
|
[key: string]: unknown;
|
|
46
26
|
}
|
|
47
|
-
/**
|
|
48
|
-
* Console channel configuration.
|
|
49
|
-
*/
|
|
27
|
+
/** Console channel configuration. */
|
|
50
28
|
export interface ConsoleChannelConfig extends LogChannelConfig {
|
|
51
29
|
driver: 'console';
|
|
52
30
|
colors?: boolean;
|
|
53
31
|
timestamps?: boolean;
|
|
54
32
|
format?: 'text' | 'json';
|
|
55
33
|
}
|
|
56
|
-
/**
|
|
57
|
-
* File channel configuration.
|
|
58
|
-
*/
|
|
34
|
+
/** File channel configuration. */
|
|
59
35
|
export interface FileChannelConfig extends LogChannelConfig {
|
|
60
36
|
driver: 'file';
|
|
61
37
|
path: string;
|
|
62
38
|
format?: 'text' | 'json';
|
|
63
39
|
}
|
|
64
|
-
/**
|
|
65
|
-
* Daily file channel configuration.
|
|
66
|
-
*/
|
|
40
|
+
/** Daily file channel configuration. */
|
|
67
41
|
export interface DailyFileChannelConfig extends LogChannelConfig {
|
|
68
42
|
driver: 'daily';
|
|
69
43
|
path: string;
|
|
70
44
|
days?: number;
|
|
71
45
|
format?: 'text' | 'json';
|
|
72
46
|
}
|
|
73
|
-
/**
|
|
74
|
-
* Stack channel configuration.
|
|
75
|
-
*/
|
|
47
|
+
/** Stack channel configuration. */
|
|
76
48
|
export interface StackChannelConfig extends LogChannelConfig {
|
|
77
49
|
driver: 'stack';
|
|
78
50
|
channels: string[];
|
|
79
51
|
}
|
|
80
|
-
/**
|
|
81
|
-
* Log manager configuration.
|
|
82
|
-
*/
|
|
52
|
+
/** Log manager configuration. */
|
|
83
53
|
export interface LogConfig {
|
|
84
54
|
default: string;
|
|
85
55
|
channels: Record<string, LogChannelConfig>;
|
|
@@ -88,9 +58,7 @@ export interface LogConfig {
|
|
|
88
58
|
/** Replacement string for filtered values. Default: '[FILTERED]' */
|
|
89
59
|
filterReplacement?: string;
|
|
90
60
|
}
|
|
91
|
-
/**
|
|
92
|
-
* Log formatter.
|
|
93
|
-
*/
|
|
61
|
+
/** Log formatter. */
|
|
94
62
|
export interface LogFormatter {
|
|
95
63
|
format(entry: LogEntry): string;
|
|
96
64
|
}
|